Skip to content

Commit 0945de8

Browse files
feat(registry): text-match-cut (#4288)
* feat(registry): add text-match-cut — one text becomes another mid-move on a single 85 % curve Video primitive reversed from an After Effects tutorial (Editing Snapped, "The Match Cut Technique Every After Effects User Needs"), measured per frame at 60 fps. Both texts ride one keyframe pair, cubic-bezier(.85, 0, .15, 1) over 2 s, and hard-swap at the speed peak (1.0 s). A `mode` variable picks the property that carries the cut: scale down (the tutorial), scale up, tracking in, or a same-direction slide in four directions. Optional cyan-to-blue gradient sweep on its own 87 % curve, navy or transparent background. * chore(registry): integrate text-match-cut with current main --------- Co-authored-by: Jake Moran <[email protected]>
1 parent 8d2b6e7 commit 0945de8

11 files changed

Lines changed: 967 additions & 5 deletions

File tree

‎docs/catalog/components/text-match-cut.mdx‎

Lines changed: 407 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/docs.json‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -304,7 +304,7 @@
304304
},
305305
{
306306
"group": "Text & captions",
307-
"tag": "72",
307+
"tag": "73",
308308
"expanded": false,
309309
"pages": [
310310
{
@@ -333,7 +333,7 @@
333333
},
334334
{
335335
"group": "Typography & Text",
336-
"tag": "43",
336+
"tag": "44",
337337
"expanded": false,
338338
"pages": [
339339
"catalog/components/blur-out-up",
@@ -369,6 +369,7 @@
369369
"catalog/components/soft-blur-in",
370370
"catalog/blocks/split-flap-board",
371371
"catalog/components/strikethrough-replace",
372+
"catalog/components/text-match-cut",
372373
"catalog/components/text-shimmer",
373374
"catalog/components/ticker-takeover",
374375
"catalog/components/titlecard-calm",

‎docs/public/catalog-index.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4593,6 +4593,22 @@
45934593
"href": "/catalog/components/testimonial-proof-card",
45944594
"preview": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/testimonial-proof-card.png"
45954595
},
4596+
{
4597+
"name": "text-match-cut",
4598+
"type": "component",
4599+
"title": "Text Match Cut",
4600+
"description": "One line of text becomes another mid-move: both ride a single 85 % easy-ease curve and hard-swap at the speed peak, as scale, tracking, or a same-direction slide.",
4601+
"tags": [
4602+
"motion-primitive",
4603+
"transition",
4604+
"typography",
4605+
"match-cut",
4606+
"hard-cut",
4607+
"continuity"
4608+
],
4609+
"href": "/catalog/components/text-match-cut",
4610+
"preview": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/text-match-cut.png"
4611+
},
45964612
{
45974613
"name": "text-shimmer",
45984614
"type": "component",

‎docs/public/catalog/components/text-match-cut.json‎

Lines changed: 1 addition & 0 deletions
Large diffs are not rendered by default.

‎docs/snippets/catalog-gallery-data.mdx‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.
1.5 KB
Binary file not shown.

‎registry/catalog-artifact/local-vectors.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"model": "bge-small-en-v1.5",
33
"modelRevision": "ea104dacec62c0de699686887e3f920caeb4f3e3",
44
"dimensions": 384,
5-
"revision": "b3b64e9c13284851d47cd4551533b841d8eb51f025ec040babd312bb207aed02",
5+
"revision": "01f77564cabdcd54733e8251051a721b644be2096c1aba9d62f392c7d66d277e",
66
"names": [
77
"ai-chat-reveal",
88
"animated-bar-chart",
@@ -313,6 +313,7 @@
313313
"terminal-simulator",
314314
"testimonial-card",
315315
"testimonial-proof-card",
316+
"text-match-cut",
316317
"text-shimmer",
317318
"text-stagger",
318319
"text-state-swap",
Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
<!doctype html>
2+
<!--
3+
text-match-cut demo. Four mounts of text-match-cut.html in a 2×2 grid, each
4+
with a different mode, so one render shows the cut carried by scale, tracking,
5+
and two slide directions. Non-default copy proves the variables flow through
6+
the mount; every tile hard-cuts on the same frame (1.0 s).
7+
-->
8+
<html lang="en">
9+
<head>
10+
<meta charset="UTF-8" />
11+
<meta name="viewport" content="width=1920, height=1080" />
12+
<title>Text Match Cut Demo</title>
13+
<style>
14+
* {
15+
margin: 0;
16+
padding: 0;
17+
box-sizing: border-box;
18+
}
19+
20+
html,
21+
body {
22+
width: 1920px;
23+
height: 1080px;
24+
overflow: hidden;
25+
background: #262626;
26+
}
27+
28+
#root {
29+
position: relative;
30+
width: 1920px;
31+
height: 1080px;
32+
overflow: hidden;
33+
background: #262626;
34+
}
35+
36+
.mount {
37+
position: absolute;
38+
width: 912px;
39+
height: 513px;
40+
container-type: size;
41+
overflow: hidden;
42+
border-radius: 8px;
43+
}
44+
45+
.q0 {
46+
left: 24px;
47+
top: 18px;
48+
}
49+
.q1 {
50+
left: 984px;
51+
top: 18px;
52+
}
53+
.q2 {
54+
left: 24px;
55+
top: 549px;
56+
}
57+
.q3 {
58+
left: 984px;
59+
top: 549px;
60+
}
61+
</style>
62+
</head>
63+
<body>
64+
<div
65+
id="root"
66+
data-composition-id="text-match-cut-demo"
67+
data-start="0"
68+
data-width="1920"
69+
data-height="1080"
70+
data-duration="3"
71+
data-fps="30"
72+
>
73+
<div
74+
id="tmc-mount-0"
75+
class="mount q0 clip"
76+
data-composition-id="text-match-cut"
77+
data-composition-src="./text-match-cut.html"
78+
data-variable-values='{"mode":"scale-down","text_a":"Ship the update","text_b":"Watch it land"}'
79+
data-start="0"
80+
data-duration="3"
81+
data-track-index="0"
82+
data-width="912"
83+
data-height="513"
84+
></div>
85+
<div
86+
id="tmc-mount-1"
87+
class="mount q1 clip"
88+
data-composition-id="text-match-cut"
89+
data-composition-src="./text-match-cut.html"
90+
data-variable-values='{"mode":"scale-up","text_a":"Ship the update","text_b":"Watch it land"}'
91+
data-start="0"
92+
data-duration="3"
93+
data-track-index="1"
94+
data-width="912"
95+
data-height="513"
96+
></div>
97+
<div
98+
id="tmc-mount-2"
99+
class="mount q2 clip"
100+
data-composition-id="text-match-cut"
101+
data-composition-src="./text-match-cut.html"
102+
data-variable-values='{"mode":"tracking-in","text_a":"Ship the update","text_b":"Watch it land"}'
103+
data-start="0"
104+
data-duration="3"
105+
data-track-index="2"
106+
data-width="912"
107+
data-height="513"
108+
></div>
109+
<div
110+
id="tmc-mount-3"
111+
class="mount q3 clip"
112+
data-composition-id="text-match-cut"
113+
data-composition-src="./text-match-cut.html"
114+
data-variable-values='{"mode":"slide-left","text_a":"Ship the update","text_b":"Watch it land"}'
115+
data-start="0"
116+
data-duration="3"
117+
data-track-index="3"
118+
data-width="912"
119+
data-height="513"
120+
></div>
121+
</div>
122+
123+
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
124+
<script>
125+
window.__timelines = window.__timelines || {};
126+
window.__timelines["text-match-cut-demo"] = gsap.timeline({ paused: true });
127+
</script>
128+
</body>
129+
</html>
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
{
2+
"$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
3+
"name": "text-match-cut",
4+
"type": "hyperframes:component",
5+
"title": "Text Match Cut",
6+
"description": "One line of text becomes another mid-move: both ride a single 85 % easy-ease curve and hard-swap at the speed peak, as scale, tracking, or a same-direction slide.",
7+
"tags": ["motion-primitive", "transition", "typography", "match-cut", "hard-cut", "continuity"],
8+
"jobs": ["connect"],
9+
"family": "transitions",
10+
"profile": "transition",
11+
"evidence": "Editing Snapped, The Match Cut Technique Every After Effects User Needs — text workflow measured per frame at 60 fps",
12+
"syncPoints": [{ "id": "hard-cut", "phase": "in", "offset": 1.0 }],
13+
"files": [
14+
{
15+
"path": "text-match-cut.html",
16+
"target": "compositions/components/text-match-cut.html",
17+
"type": "hyperframes:snippet"
18+
}
19+
],
20+
"variables": [
21+
{
22+
"id": "text_a",
23+
"type": "string",
24+
"role": "content",
25+
"label": "Outgoing text",
26+
"description": "The line on screen before the cut.",
27+
"default": "Basic Interface Behavior"
28+
},
29+
{
30+
"id": "text_b",
31+
"type": "string",
32+
"role": "content",
33+
"label": "Incoming text",
34+
"description": "The line that continues the move after the cut.",
35+
"default": "Thoughtful Experience Design"
36+
},
37+
{
38+
"id": "mode",
39+
"type": "enum",
40+
"role": "style",
41+
"label": "Move",
42+
"description": "Which property carries the cut. Both texts ride the same curve.",
43+
"default": "scale-down",
44+
"options": [
45+
{ "value": "scale-down", "label": "Scale down (tutorial)" },
46+
{ "value": "scale-up", "label": "Scale up" },
47+
{ "value": "tracking-in", "label": "Tracking in" },
48+
{ "value": "slide-left", "label": "Slide left" },
49+
{ "value": "slide-right", "label": "Slide right" },
50+
{ "value": "slide-up", "label": "Slide up" },
51+
{ "value": "slide-down", "label": "Slide down" }
52+
]
53+
},
54+
{
55+
"id": "sweep",
56+
"type": "enum",
57+
"role": "style",
58+
"label": "Gradient sweep",
59+
"description": "Cyan-to-blue bar sweeping through the glyphs around the cut.",
60+
"default": "on",
61+
"options": [
62+
{ "value": "on", "label": "On" },
63+
{ "value": "off", "label": "Off" }
64+
]
65+
},
66+
{
67+
"id": "background",
68+
"type": "enum",
69+
"role": "style",
70+
"label": "Background",
71+
"description": "The tutorial navy glow, or transparent so the host shows through.",
72+
"default": "navy",
73+
"options": [
74+
{ "value": "navy", "label": "Navy glow" },
75+
{ "value": "transparent", "label": "Transparent" }
76+
]
77+
}
78+
]
79+
}

0 commit comments

Comments
 (0)