UI blocks

UI Caret

A blinking text caret — a controlled vertical bar, or a pure motion atom that blinks deterministically from useCurrentFrame.

UI Caret preview, rendered with Remotion.

Source

components/kuchi/type-caret.tsx
"use client";
import type { CSSProperties } from "react";
import { useCurrentFrame, useVideoConfig } from "remotion";
export interface CaretProps {
color?: string;
width?: number;
height?: number;
radius?: number;
opacity?: number;
blink?: boolean;
blinkPerSecond?: number;
speed?: number;
marginLeft?: number;
className?: string;
style?: CSSProperties;
}
export function caretBlinkOpacity(
frame: number,
opts: { fps: number; blinkPerSecond: number; speed: number },
): number {
const cycles = opts.blinkPerSecond <= 0 ? 1 : opts.blinkPerSecond;
const halfPeriod = opts.fps / cycles / 2;
if (halfPeriod <= 0) return 1;
return Math.floor((frame * opts.speed) / halfPeriod) % 2 === 0 ? 1 : 0;
}
export function Caret({
color = "currentColor",
width = 2,
height = 18,
radius = 1,
opacity,
blink = false,
blinkPerSecond = 1,
speed = 1,
marginLeft = 0,
className,
style,
}: CaretProps) {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const resolvedOpacity =
opacity !== undefined
? opacity
: blink
? caretBlinkOpacity(frame, { fps, blinkPerSecond, speed })
: 1;
return (
<span
className={className}
style={{
display: "inline-block",
flexShrink: 0,
width,
height,
borderRadius: radius,
background: color,
opacity: resolvedOpacity,
marginLeft,
...style,
}}
/>
);
}