Files
hyperframes/docs/catalog/components/dart-cursor.mdx
T
Ular Kimsanov a06fdfe26e docs(catalog): put each item page's title, description and Docs text in the server HTML (#6711)
* docs(catalog): put each item page's title, description and Docs text in the server HTML

Mintlify renders snippet components in the browser only, so everything inside
CatalogDetail (title, standfirst, the Docs tab) was missing from the HTML search
engines read: 448 catalog pages served Googlebot no body text. The generator now
writes the H1 and standfirst as page markup above the component and the Docs tab
as page markup after it, shown with that tab (docs/custom.css). The component no
longer draws its own title. Pages patched structurally only; registry drift on 14
pages is left for a regeneration of its own.

* docs(catalog): keep the title's top spacing the component gave it

* fix(docs): catalog titles and descriptions keep markdown markers literal

MDX reads text inside the static <h1> and <p> as inline markdown, so @_blue_sweater_
rendered as italic blue_sweater. mdxText now writes backslash, backtick, * _ [ ] ~ as
character references too, with a unit test; the four affected pages are re-escaped.
2026-10-30 15:48:25 +00:00

448 lines
18 KiB
Plaintext

---
title: "Dart Cursor"
description: "A bold outlined arrowhead that dives in from camera depth, flies nose-first with motion blur along its path, squashes on two clicks, and whips out of frame."
mode: "frame"
---
import { CatalogDetail, CatalogSlot } from "/snippets/catalog-detail.jsx";
import { InstallCommand } from "/snippets/install-command.jsx";
<div className="hf-ve-static-head not-prose">
<h1>Dart Cursor</h1>
<p>A bold outlined arrowhead that dives in from camera depth, flies nose-first with motion blur along its path, squashes on two clicks, and whips out of frame.</p>
</div>
<CatalogDetail
previewSrc="/public/catalog/components/dart-cursor.json"
compositionId="dart-cursor"
compositionSrc="compositions/components/dart-cursor.html"
title="Dart Cursor"
variables={[{"id":"tone","type":"enum","role":"style","label":"Tone","default":"dark","options":[{"value":"dark","label":"Dark body, white outline"},{"value":"light","label":"Light body, dark outline"}]},{"id":"target_x","type":"number","role":"layout","label":"First click X","default":34,"min":5,"max":95,"step":1,"unit":"%"},{"id":"target_y","type":"number","role":"layout","label":"First click Y","default":58,"min":5,"max":95,"step":1,"unit":"%"},{"id":"target2_x","type":"number","role":"layout","label":"Second click X","default":64,"min":5,"max":95,"step":1,"unit":"%"},{"id":"target2_y","type":"number","role":"layout","label":"Second click Y","default":46,"min":5,"max":95,"step":1,"unit":"%"},{"id":"enter_from","type":"enum","role":"timing","label":"Enter from","default":"right","options":[{"value":"right","label":"Right"},{"value":"left","label":"Left"},{"value":"top","label":"Top"},{"value":"bottom","label":"Bottom"}]},{"id":"exit_to","type":"enum","role":"timing","label":"Exit to","default":"right","options":[{"value":"right","label":"Right"},{"value":"left","label":"Left"},{"value":"top","label":"Top"},{"value":"bottom","label":"Bottom"}]},{"id":"blur","type":"number","role":"style","label":"Motion blur","default":1,"min":0,"max":1.5,"step":0.1}]}
meta={{"category":"Cursors","badge":"Stable","codeLines":357}}
attribution={{"path":"registry/components/dart-cursor","tags":["cursor","motion-primitive","pointer","click","motion-blur","depth"]}}
hasCode
rawUrl="https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/components/dart-cursor/dart-cursor.html"
>
<CatalogSlot slot="code">
```html dart-cursor.html
<!doctype html>
<!--
Dart Cursor (actor primitive), mountable sub-composition
concept: a bold outlined arrowhead that dives in from camera depth, flies nose-first
like a dart (it turns to face where it travels and relaxes upright when it parks),
smears with motion blur along its path, squashes on each click, and whips out.
mount contract: loaded by a host through data-composition-src; only <template> is
cloned. #root fills the host clip (inset:0). See demo.html.
variables:
tone (dark|light) dark body with a white outline, or the reverse
target_x, target_y (% of host box) where the tip lands for the first click
target2_x, target2_y (%) where it lands for the second click
enter_from, exit_to (left|right|top|bottom) the edge it arrives from and leaves by
blur (0 to 1.5) motion-blur strength, 0 turns it off
envelope (default 3.6s): entry 0-0.6s, click 0.7s, move 1.0-1.55s, click 1.7s,
hold, exit in the last 0.55s. Shorter durations compress every beat evenly.
-->
<html
lang="en"
data-composition-id="dart-cursor"
data-composition-duration="3.6"
data-composition-variables='[
{ "id": "tone", "type": "enum", "role": "style", "label": "Tone", "default": "dark", "options": [ { "value": "dark", "label": "Dark body, white outline" }, { "value": "light", "label": "Light body, dark outline" } ] },
{ "id": "target_x", "type": "number", "role": "layout", "label": "First click X", "default": 34, "min": 5, "max": 95, "step": 1, "unit": "%" },
{ "id": "target_y", "type": "number", "role": "layout", "label": "First click Y", "default": 58, "min": 5, "max": 95, "step": 1, "unit": "%" },
{ "id": "target2_x", "type": "number", "role": "layout", "label": "Second click X", "default": 64, "min": 5, "max": 95, "step": 1, "unit": "%" },
{ "id": "target2_y", "type": "number", "role": "layout", "label": "Second click Y", "default": 46, "min": 5, "max": 95, "step": 1, "unit": "%" },
{ "id": "enter_from", "type": "enum", "role": "timing", "label": "Enter from", "default": "right", "options": [ { "value": "right", "label": "Right" }, { "value": "left", "label": "Left" }, { "value": "top", "label": "Top" }, { "value": "bottom", "label": "Bottom" } ] },
{ "id": "exit_to", "type": "enum", "role": "timing", "label": "Exit to", "default": "right", "options": [ { "value": "right", "label": "Right" }, { "value": "left", "label": "Left" }, { "value": "top", "label": "Top" }, { "value": "bottom", "label": "Bottom" } ] },
{ "id": "blur", "type": "number", "role": "style", "label": "Motion blur", "default": 1, "min": 0, "max": 1.5, "step": 0.1 }
]'
>
<head>
<meta charset="UTF-8" />
<title>Dart Cursor</title>
</head>
<body>
<template>
<style>
#root {
position: absolute;
inset: 0;
overflow: hidden;
isolation: isolate;
pointer-events: none;
}
.dc-cursor {
position: absolute;
left: 0;
top: 0;
width: 0;
height: 0;
will-change: transform, filter;
}
/* The tip sits at the svg origin, so the wrapper's translate places the tip. */
.dc-svg {
position: absolute;
left: -120px;
top: -120px;
width: 240px;
height: 240px;
overflow: visible;
}
.dc-outline {
stroke-width: 22;
stroke-linejoin: round;
}
.dc-body {
stroke-width: 3;
stroke-linejoin: round;
}
.dc-cursor[data-tone="dark"] .dc-outline {
fill: #ffffff;
stroke: #ffffff;
}
.dc-cursor[data-tone="dark"] .dc-body {
fill: #0b0b0c;
stroke: #0b0b0c;
}
.dc-cursor[data-tone="light"] .dc-outline {
fill: #111113;
stroke: #111113;
}
.dc-cursor[data-tone="light"] .dc-body {
fill: #ffffff;
stroke: #ffffff;
}
</style>
<div id="root" data-composition-id="dart-cursor" data-duration="3.6">
<div class="dc-cursor" id="dc-cursor" data-tone="dark" aria-hidden="true">
<svg class="dc-svg" viewBox="-120 -120 240 240" aria-hidden="true">
<defs>
<filter
id="dc-smear"
x="-100%"
y="-100%"
width="300%"
height="300%"
color-interpolation-filters="sRGB"
>
<feGaussianBlur id="dc-smear-fe" stdDeviation="0 0" />
</filter>
</defs>
<g id="dc-spin">
<g id="dc-heading" filter="url(#dc-smear)">
<g id="dc-unheading">
<g id="dc-shape">
<polygon
class="dc-outline"
points="-5,1 -14,82 -11,83 6,64 20,58 34,57 53,62 49,52 0,0"
/>
<polygon
class="dc-body"
points="-5,1 -14,82 -11,83 6,64 20,58 34,57 53,62 49,52 0,0"
/>
</g>
</g>
</g>
</g>
</svg>
</div>
</div>
<script>
(function () {
"use strict";
var html = document.documentElement;
var root = document.getElementById("root");
var cursor = document.getElementById("dc-cursor");
var svg = cursor.querySelector(".dc-svg");
var spin = document.getElementById("dc-spin");
var heading = document.getElementById("dc-heading");
var unheading = document.getElementById("dc-unheading");
var shape = document.getElementById("dc-shape");
var smear = document.getElementById("dc-smear-fe");
var DEFAULTS = {};
try {
JSON.parse(html.getAttribute("data-composition-variables") || "[]").forEach(
function (variable) {
DEFAULTS[variable.id] = variable.default;
},
);
} catch (error) {
/* malformed declaration falls back to the inline defaults below */
}
var scopedVariables = {};
try {
if (window.__hyperframes && typeof window.__hyperframes.getVariables === "function") {
scopedVariables = window.__hyperframes.getVariables() || {};
}
} catch (error) {
/* no scoped variables API in this context */
}
var vars = Object.assign({}, DEFAULTS, window.__hfVariables || {}, scopedVariables);
function num(value, fallback, lo, hi) {
var n = Number(value);
if (!isFinite(n)) n = fallback;
return Math.max(lo, Math.min(hi, n));
}
function side(value, fallback) {
return ["left", "right", "top", "bottom"].indexOf(value) >= 0 ? value : fallback;
}
// Hardcoded: the compositor rewrites the wrapper's attributes on mount.
var compositionId = "dart-cursor";
var duration = Math.max(
0.001,
parseFloat(
root.dataset.duration || html.getAttribute("data-composition-duration") || "3.6",
),
);
var tone = vars.tone === "light" ? "light" : "dark";
var blurAmount = num(vars.blur, 1, 0, 1.5);
var W = root.clientWidth || 1920;
var H = root.clientHeight || 1080;
var unit = W / 1920;
// The glyph is 105 units tall with its outline: 80 px at 1920 wide.
var PX_PER_SVG_UNIT = (80 / 105) * unit;
function stagePoint(xPercent, yPercent) {
return { x: (xPercent / 100) * W, y: (yPercent / 100) * H };
}
var A = stagePoint(num(vars.target_x, 34, 0, 100), num(vars.target_y, 58, 0, 100));
var B = stagePoint(num(vars.target2_x, 64, 0, 100), num(vars.target2_y, 46, 0, 100));
function offStage(edge, near) {
if (edge === "left") return { x: -0.14 * W, y: near.y - 0.18 * H };
if (edge === "top") return { x: near.x + 0.16 * W, y: -0.2 * H };
if (edge === "bottom") return { x: near.x - 0.12 * W, y: 1.22 * H };
return { x: 1.14 * W, y: near.y - 0.22 * H };
}
var START = offStage(side(vars.enter_from, "right"), A);
var END = offStage(side(vars.exit_to, "right"), B);
// Beats at the default 3.6s; a shorter composition compresses them evenly.
var FIXED_TAIL = 0.55 + 0.35;
var squeeze = Math.min(1, duration / (1.7 + FIXED_TAIL));
var T_LAND1 = 0.6 * squeeze;
var T_CLICK1 = 0.7 * squeeze;
var T_MOVE = 1.0 * squeeze;
var T_LAND2 = 1.55 * squeeze;
var T_CLICK2 = 1.7 * squeeze;
var T_EXIT = Math.max(T_CLICK2 + 0.3 * squeeze, duration - 0.55 * squeeze);
function clamp01(u) {
return u < 0 ? 0 : u > 1 ? 1 : u;
}
function smooth(u) {
u = clamp01(u);
return u * u * (3 - 2 * u);
}
var easeOut = gsap.parseEase("power3.out");
var easeInOut = gsap.parseEase("power2.inOut");
var easeIn = gsap.parseEase("power3.in");
// A quadratic arc bent to one side of the chord.
function arc(p0, p1, bend, u) {
var cx = (p0.x + p1.x) / 2 - (p1.y - p0.y) * bend;
var cy = (p0.y + p1.y) / 2 + (p1.x - p0.x) * bend;
var v = 1 - u;
return {
x: v * v * p0.x + 2 * v * u * cx + u * u * p1.x,
y: v * v * p0.y + 2 * v * u * cy + u * u * p1.y,
};
}
function positionAt(t) {
if (t <= T_LAND1) return arc(START, A, 0.22, easeOut(clamp01(t / T_LAND1)));
if (t <= T_MOVE) return A;
if (t <= T_LAND2) {
return arc(A, B, -0.18, easeInOut(clamp01((t - T_MOVE) / (T_LAND2 - T_MOVE))));
}
if (t <= T_EXIT) return B;
return arc(B, END, 0.12, easeIn(clamp01((t - T_EXIT) / (duration - T_EXIT))));
}
function keyed(keys, u) {
if (u <= keys[0][0]) return keys[0][1];
for (var i = 1; i < keys.length; i++) {
if (u <= keys[i][0]) {
var a = keys[i - 1];
var b = keys[i];
return a[1] + (b[1] - a[1]) * smooth((u - a[0]) / (b[0] - a[0]));
}
}
return keys[keys.length - 1][1];
}
var DIVE = [
[0, 1.3],
[0.4, 1.8],
[0.78, 1.06],
[1, 1],
];
function press(t, at) {
var down = 0.08 * squeeze;
var up = 0.2 * squeeze;
if (t < at) return 0;
if (t < at + down) return 0.2 * gsap.parseEase("power2.in")((t - at) / down);
return 0.2 - 0.1 * gsap.parseEase("power2.out")(clamp01((t - at - down) / up));
}
// Depth is scale: above 1 is lifted toward camera, below 1 is pressed into the screen.
function depthAt(t) {
if (t <= T_LAND1) return keyed(DIVE, t / T_LAND1);
if (t <= T_MOVE) return 1 - press(t, T_CLICK1);
if (t <= T_LAND2) {
var u = (t - T_MOVE) / (T_LAND2 - T_MOVE);
return 0.9 + 0.1 * smooth(u / 0.3) + 0.07 * Math.sin(Math.PI * u);
}
return 1 - press(t, T_CLICK2);
}
// Local-frame nose angle of the arrowhead (tip minus the shape's centroid).
var NOSE_DEG = -106;
var H_STEP = 1 / 120;
function wrap(deg) {
return ((((deg + 180) % 360) + 360) % 360) - 180;
}
function render(t) {
var p = positionAt(t);
var before = positionAt(Math.max(0, t - H_STEP));
var after = positionAt(Math.min(duration, t + H_STEP));
var vx = (after.x - before.x) / (2 * H_STEP);
var vy = (after.y - before.y) / (2 * H_STEP);
var speed = Math.hypot(vx, vy) / unit;
var travelDeg = (Math.atan2(vy, vx) * 180) / Math.PI;
var steer = smooth((speed - 150) / 950);
var rotation = steer * wrap(travelDeg - NOSE_DEG);
var depth = depthAt(t);
var exiting = t > T_EXIT;
var perFrame = speed / 60;
var smearUnits =
blurAmount * Math.min(exiting ? 36 : 12, (exiting ? 0.28 : 0.16) * perFrame);
var lift = Math.max(0, depth - 0.9);
cursor.style.transform = "translate(" + p.x.toFixed(2) + "px," + p.y.toFixed(2) + "px)";
svg.style.filter =
"drop-shadow(0 " +
(3 + 22 * lift).toFixed(1) +
"px " +
(4 + 26 * lift).toFixed(1) +
"px rgba(0,0,0," +
(0.34 - 0.12 * Math.min(1, lift)).toFixed(3) +
"))";
spin.setAttribute(
"transform",
"rotate(" +
rotation.toFixed(2) +
") scale(" +
(depth * PX_PER_SVG_UNIT).toFixed(4) +
")",
);
// The blur's x axis is turned onto the travel direction, then the shape turned back.
var local = wrap(travelDeg - rotation);
heading.setAttribute("transform", "rotate(" + local.toFixed(2) + ")");
unheading.setAttribute("transform", "rotate(" + (-local).toFixed(2) + ")");
smear.setAttribute("stdDeviation", smearUnits.toFixed(3) + " 0");
cursor.style.opacity = t >= duration ? "0" : "1";
}
cursor.setAttribute("data-tone", tone);
shape.setAttribute("transform", "scale(1.09 1)");
var clock = { t: 0 };
var tl = gsap.timeline({ paused: true });
tl.to(
clock,
{
t: duration,
duration: duration,
ease: "none",
onUpdate: function () {
render(clock.t);
},
},
0,
);
render(0);
tl.seek(0);
window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
})();
</script>
</template>
</body>
</html>
```
</CatalogSlot>
<CatalogSlot slot="install">
<InstallCommand command="npx hyperframes add dart-cursor" item="dart-cursor" />
That writes one file: `compositions/components/dart-cursor.html`.
</CatalogSlot>
</CatalogDetail>
<div data-static-slot="docs" className="prose prose-gray dark:prose-invert">
## Paste it into your composition
Open `compositions/components/dart-cursor.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 |
| --- | --- | --- | --- |
| `tone` | `dark` | `dark`, `light` | |
| `target_x` | `34` | 5% to 95%, step 1% | |
| `target_y` | `58` | 5% to 95%, step 1% | |
| `target2_x` | `64` | 5% to 95%, step 1% | |
| `target2_y` | `46` | 5% to 95%, step 1% | |
| `enter_from` | `right` | `right`, `left`, `top`, `bottom` | |
| `exit_to` | `right` | `right`, `left`, `top`, `bottom` | |
| `blur` | `1` | 0 to 1.5, step 0.1 | |
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="dart-cursor"
data-composition-src="compositions/components/dart-cursor.html"
data-variable-values='{"tone":"dark","target_x":34,"target_y":58,"target2_x":64,"target2_y":46,"enter_from":"right","exit_to":"right","blur":1}'
></div>
```
{/* hf:generated-footer */}
Tagged `cursor` `motion-primitive` `pointer` `click` `motion-blur` `depth`.
## Related topics
- [Browse the complete Catalog](/catalog)
- [Add assets and Catalog items in the browser editor](/studio/assets-and-blocks)
- [Put blocks together into one video](/concepts/compositions)
</div>