Kinetic Morph Text
Letters lift, rotate, and softly reshape into editable phrases with sampled outline trails.
Source
components/kuchi/kinetic-morph-text.tsx
1"use client";23import { useId, useLayoutEffect, useMemo, useState } from "react";4import { Easing, useCurrentFrame, useVideoConfig } from "remotion";56export interface KineticMorphTextProps {7 /** One phrase per line, or separate phrases with |. */8 text?: string;9 fontSize?: number;10 fontWeight?: number;11 color?: string;12 backgroundColor?: string;13 /** Flight radius in composition pixels. */14 spread?: number;15 /** Maximum letter rotation in degrees. */16 rotation?: number;17 /** Strength of the soft silhouette blend, from 0 to 1. */18 morph?: number;19 /** Opacity of the sampled outline echoes, from 0 to 1. */20 trails?: number;21 transitionFrames?: number;22 holdFrames?: number;23 loop?: boolean;24 speed?: number;25 className?: string;26}2728export const kineticMorphTextDefaultText =29 "Hello | Make it move | Shape what's next";3031const FONT_FAMILY = "Arial, Helvetica, sans-serif";32const TRANSITION = 54;33const HOLD = 42;34const clamp = (value: number) => Math.min(1, Math.max(0, value));35const finite = (value: number, fallback: number) =>36 Number.isFinite(value) ? value : fallback;37const ease = Easing.bezier(0.65, 0, 0.25, 1);38const smooth = (value: number) => {39 const p = clamp(value);40 return p * p * (3 - 2 * p);41};42const mix = (a: number, b: number, p: number) => a + (b - a) * p;43const noise = (index: number) => {44 const value = Math.sin(index * 127.1 + 311.7) * 43758.5453;45 return value - Math.floor(value);46};4748export function parseKineticMorphText(text: string): string[] {49 return text50 .split(/[|\n\r]+/)51 .map((phrase) => phrase.trim().replace(/\s+/g, " "))52 .filter(Boolean);53}5455/** Includes the last readable hold. Timing values are authored at 30 fps. */56export function getKineticMorphTextDuration({57 text = kineticMorphTextDefaultText,58 transitionFrames = TRANSITION,59 holdFrames = HOLD,60 speed = 1,61}: Pick<62 KineticMorphTextProps,63 "text" | "transitionFrames" | "holdFrames" | "speed" | "loop"64> = {}): number {65 const count = parseKineticMorphText(text).length;66 const transition = Math.max(1, finite(transitionFrames, TRANSITION));67 const hold = Math.max(0, finite(holdFrames, HOLD));68 const rate = Math.max(0.01, finite(speed, 1));69 // Both modes use one transition + hold per phrase. Loop mode starts with70 // a readable first phrase and spends its last transition returning to it.71 const frames = count * (transition + hold);72 return Math.max(1, Math.ceil(frames / rate));73}7475/** Last moving frame at defaults; the demo adds a final 42-frame hold. */76export const kineticMorphTextLength = 246;7778export interface KineticMorphGlyph {79 character: string;80 x: number;81}8283export interface KineticMorphPair {84 from?: KineticMorphGlyph;85 to?: KineticMorphGlyph;86}8788/** Reserve identical graphemes before pairing remaining replacements. */89export function matchKineticMorphGlyphs(90 from: KineticMorphGlyph[],91 to: KineticMorphGlyph[],92): KineticMorphPair[] {93 const unused = new Set(from.map((_, index) => index));94 const matches = to.map((target) => {95 let closest = -1;96 let distance = Number.POSITIVE_INFINITY;97 for (const index of unused) {98 const source = from[index];99 if (source.character !== target.character) continue;100 const travel = Math.abs(source.x - target.x);101 if (travel < distance) {102 closest = index;103 distance = travel;104 }105 }106 if (closest !== -1) unused.delete(closest);107 return closest;108 });109 const remaining = [...unused];110 const pairs: KineticMorphPair[] = to.map((target, index) => {111 const source = matches[index] === -1 ? remaining.shift() : matches[index];112 return {113 from: source === undefined ? undefined : from[source],114 to: target,115 };116 });117 for (const index of remaining) pairs.push({ from: from[index] });118 return pairs;119}120121export function getKineticMorphTimeline(122 frame: number,123 count: number,124 transitionFrames = TRANSITION,125 holdFrames = HOLD,126 loop = false,127) {128 const transition = Math.max(1, finite(transitionFrames, TRANSITION));129 const hold = Math.max(0, finite(holdFrames, HOLD));130 const time = Math.max(0, finite(frame, 0));131 if (count === 0) return { from: -1, to: -1, progress: 1 };132 if (!loop && time < transition) {133 return { from: -1, to: 0, progress: time / transition };134 }135 const cursor = loop ? time : time - transition;136 const cycle = transition + hold;137 const index = Math.floor(cursor / cycle);138 if ((!loop && index >= count - 1) || (loop && count === 1)) {139 return { from: count - 1, to: count - 1, progress: 1 };140 }141 return {142 from: index % count,143 to: (index + 1) % count,144 progress: clamp(((cursor % cycle) - hold) / transition),145 };146}147148interface PoseOptions {149 spread: number;150 rotation: number;151 morph: number;152}153154export function getKineticMorphPose(155 pair: KineticMorphPair,156 index: number,157 count: number,158 progress: number,159 { spread, rotation, morph }: PoseOptions,160) {161 // A bounded stagger keeps long phrases within the same transition window.162 const delay = noise(index + 3) * 0.12;163 const p = clamp((progress - delay) / (1 - delay));164 const travel = ease(p);165 const motion = Math.sin(Math.PI * travel);166 const angle = (index / Math.max(count, 1)) * Math.PI * 2 - Math.PI / 2;167 const orbitX = Math.cos(angle) * spread * (0.7 + noise(index) * 0.4);168 const orbitY = Math.sin(angle) * spread * 0.72 - spread * 0.25;169 const fromX = pair.from?.x ?? orbitX * 1.2;170 const toX = pair.to?.x ?? orbitX * 1.2;171 const fromY = pair.from ? 0 : orbitY + spread * 0.65;172 const toY = pair.to ? 0 : orbitY - spread * 0.6;173 const x = mix(fromX, toX, travel) + orbitX * motion;174 const y = mix(fromY, toY, travel) + orbitY * motion;175 const turn = (noise(index + 9) * 2 - 1) * rotation;176 const rotate = pair.from177 ? pair.to178 ? turn * motion179 : turn * travel180 : turn * (1 - travel);181 const replacement = Boolean(182 pair.from && pair.to && pair.from.character !== pair.to.character,183 );184 const blend = replacement ? smooth((p - 0.36) / 0.28) : 0;185 const melt = replacement ? Math.sin(Math.PI * blend) * morph : 0;186 const opacity = pair.from187 ? pair.to188 ? 1189 : 1 - smooth((p - 0.35) / 0.5)190 : smooth(p / 0.36);191 return {192 x,193 y,194 rotate,195 scaleX: 1 - melt * 0.52 + motion * 0.08,196 scaleY: 1 + melt * 0.42 - motion * 0.06,197 blend,198 melt,199 opacity,200 motion,201 };202}203204interface Layout {205 key: string;206 phrases: KineticMorphGlyph[][];207 size: number;208 baseline: number;209}210211function useGlyphLayout(212 text: string,213 size: number,214 weight: number,215 width: number,216) {217 const [layout, setLayout] = useState<Layout | null>(null);218 const key = JSON.stringify([text, size, weight, width]);219220 useLayoutEffect(() => {221 const context = document.createElement("canvas").getContext("2d");222 if (!context) return;223 const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });224 const phrases = parseKineticMorphText(text).map((phrase) =>225 Array.from(segmenter.segment(phrase), ({ segment }) => segment),226 );227 context.font = `${weight} ${size}px ${FONT_FAMILY}`;228 context.fontKerning = "none";229 const advances = phrases.map((phrase) =>230 phrase.map((character) => context.measureText(character).width),231 );232 const widths = advances.map((row) =>233 row.reduce((sum, value) => sum + value, 0),234 );235 const fit = Math.min(1, (width * 0.82) / Math.max(1, ...widths));236 const metrics = context.measureText("Hg");237 setLayout({238 key,239 size: size * fit,240 baseline:241 ((metrics.actualBoundingBoxAscent - metrics.actualBoundingBoxDescent) /242 2) *243 fit,244 phrases: phrases.map((phrase, row) => {245 let cursor = (-widths[row] * fit) / 2;246 return phrase.flatMap((character, column) => {247 const advance = advances[row][column] * fit;248 const x = cursor + advance / 2;249 cursor += advance;250 return character.trim() ? [{ character, x }] : [];251 });252 }),253 });254 }, [key, text, size, weight, width]);255256 return layout?.key === key ? layout : null;257}258259function MorphGlyph({260 pair,261 index,262 count,263 progress,264 options,265 size,266 baseline,267 color,268 trails,269 transitionFrames,270}: {271 pair: KineticMorphPair;272 index: number;273 count: number;274 progress: number;275 options: PoseOptions;276 size: number;277 baseline: number;278 color: string;279 trails: number;280 transitionFrames: number;281}) {282 const filterId = useId().replace(/:/g, "");283 const pose = getKineticMorphPose(pair, index, count, progress, options);284 const transform = (value: typeof pose) =>285 `translate(${value.x} ${value.y}) rotate(${value.rotate}) scale(${value.scaleX} ${value.scaleY})`;286 const replacement =287 pair.from && pair.to && pair.from.character !== pair.to.character;288 const character = pair.from?.character ?? pair.to?.character;289290 return (291 <g>292 {trails > 0 && pose.motion > 0.001293 ? [3, 2, 1].map((sample) => {294 const echo = getKineticMorphPose(295 pair,296 index,297 count,298 Math.max(0, progress - (sample * 1.5) / transitionFrames),299 options,300 );301 return (302 <text303 key={sample}304 transform={transform(echo)}305 y={baseline}306 fill="none"307 stroke={color}308 strokeWidth={Math.max(0.7, size * 0.009)}309 opacity={echo.opacity * pose.motion * trails * (1 - sample / 4)}310 >311 {replacement && echo.blend > 0.5312 ? pair.to?.character313 : character}314 </text>315 );316 })317 : null}318 {replacement && pose.melt > 0.001 ? (319 <defs>320 <filter321 id={filterId}322 x="-70%"323 y="-70%"324 width="240%"325 height="240%"326 colorInterpolationFilters="sRGB"327 >328 <feGaussianBlur stdDeviation={pose.melt * size * 0.045} />329 <feColorMatrix330 type="matrix"331 values="1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 12 -4"332 />333 </filter>334 </defs>335 ) : null}336 <g transform={transform(pose)} opacity={pose.opacity}>337 <g338 filter={339 replacement && pose.melt > 0.001 ? `url(#${filterId})` : undefined340 }341 fill={color}342 >343 <text y={baseline} opacity={replacement ? 1 - pose.blend : 1}>344 {character}345 </text>346 {replacement ? (347 <text y={baseline} opacity={pose.blend}>348 {pair.to?.character}349 </text>350 ) : null}351 </g>352 </g>353 </g>354 );355}356357export function KineticMorphText({358 text = kineticMorphTextDefaultText,359 fontSize = 100,360 fontWeight = 600,361 color = "#b4f4d9",362 backgroundColor = "#a800b7",363 spread = 180,364 rotation = 110,365 morph = 0.75,366 trails = 0.45,367 transitionFrames = TRANSITION,368 holdFrames = HOLD,369 loop = false,370 speed = 1,371 className,372}: KineticMorphTextProps) {373 const currentFrame = useCurrentFrame();374 const { width, height, fps } = useVideoConfig();375 const frame = currentFrame * (30 / fps) * Math.max(0, finite(speed, 1));376 const size = Math.min(height * 0.28, Math.max(1, finite(fontSize, 100)));377 const weight = Math.min(900, Math.max(100, finite(Number(fontWeight), 600)));378 const layout = useGlyphLayout(text, size, weight, width);379 const transition = Math.max(1, finite(transitionFrames, TRANSITION));380 const timeline = getKineticMorphTimeline(381 frame,382 layout?.phrases.length ?? 0,383 transition,384 holdFrames,385 loop,386 );387 const pairs = useMemo(388 () =>389 matchKineticMorphGlyphs(390 layout?.phrases[timeline.from] ?? [],391 layout?.phrases[timeline.to] ?? [],392 ),393 [layout, timeline.from, timeline.to],394 );395 const options = {396 spread: Math.min(397 width * 0.24,398 height * 0.32,399 Math.max(0, finite(spread, 180)),400 ),401 rotation: Math.max(0, finite(rotation, 110)),402 morph: clamp(finite(morph, 0.75)),403 };404405 return (406 <div407 className={className}408 style={{409 position: "absolute",410 inset: 0,411 backgroundColor,412 overflow: "hidden",413 }}414 >415 <svg416 width="100%"417 height="100%"418 viewBox={`0 0 ${width} ${height}`}419 role="img"420 aria-label={parseKineticMorphText(text).join(". ")}421 style={{422 display: "block",423 fontFamily: FONT_FAMILY,424 fontSize: layout?.size ?? size,425 fontWeight: weight,426 fontKerning: "none",427 }}428 >429 <g430 transform={`translate(${width / 2} ${height / 2})`}431 textAnchor="middle"432 >433 {layout434 ? pairs.map((pair, index) => (435 <MorphGlyph436 key={`${timeline.from}:${timeline.to}:${index}`}437 pair={pair}438 index={index}439 count={pairs.length}440 progress={timeline.progress}441 options={options}442 size={layout.size}443 baseline={layout.baseline}444 color={color}445 trails={clamp(finite(trails, 0.45))}446 transitionFrames={transition}447 />448 ))449 : null}450 </g>451 </svg>452 </div>453 );454}









