50:I[707087,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"RegistryDependencies"] 51:I[512940,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"Installation"] 52:I[314491,["/_next/static/immutable/chunks/2985g-hklwiee.js","/_next/static/immutable/chunks/0qkc3dps_9x_i.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3thksmxn95rly.js","/_next/static/immutable/chunks/15bpbjna9-vr3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/0agonoz1szsjm.js","/_next/static/immutable/chunks/1ynd3dcge2kn1.js","/_next/static/immutable/chunks/0krdn-21gkgjt.js","/_next/static/immutable/chunks/0n9w9riw96l80.js","/_next/static/immutable/chunks/0w75qangey2ys.js","/_next/static/immutable/chunks/1tge7vcvsb70s.js","/_next/static/immutable/chunks/35ju_ac0ysz07.js"],"FilesView"] 53:T51b9,"use client"; import * as React from "react"; import { AnimatePresence, animate, motion, type Transition, useMotionValue, } from "motion/react"; import { cn } from "@/lib/utils"; type HighlightMode = "children" | "parent"; type Bounds = { top: number; left: number; width: number; height: number; }; const DEFAULT_TRANSITION: Transition = { type: "spring", stiffness: 1250, damping: 40, mass: 0.5, }; const MAX_AXIS_SPEED = 1800; const MAX_STRETCH = 0.28; const MAX_SQUASH = 0.2; const STRETCH_TRANSITION = { type: "spring" as const, damping: 22, stiffness: 700, }; const SETTLE_TRANSITION = { type: "spring" as const, damping: 24, stiffness: 460, }; const STRETCH_DURATION = 110; const DEFAULT_BOUNDS_OFFSET: Bounds = { top: 0, left: 0, width: 0, height: 0, }; type HighlightContextType = { as?: keyof HTMLElementTagNameMap; mode: HighlightMode; activeValue: T | null; setActiveValue: (value: T | null) => void; setBounds: (bounds: DOMRect) => void; clearBounds: () => void; id: string; hover: boolean; click: boolean; className?: string; style?: React.CSSProperties; activeClassName?: string; setActiveClassName: (className: string) => void; transition?: Transition; disabled?: boolean; enabled?: boolean; exitDelay?: number; forceUpdateBounds?: boolean; scaleX?: unknown; scaleY?: unknown; }; const HighlightContext = React.createContext< // eslint-disable-next-line @typescript-eslint/no-explicit-any HighlightContextType | undefined >(undefined); function useHighlight(): HighlightContextType { const context = React.useContext(HighlightContext); if (!context) { throw new Error("useHighlight must be used within a HighlightProvider"); } return context as unknown as HighlightContextType; } type BaseHighlightProps = { as?: T; ref?: React.Ref; mode?: HighlightMode; value?: string | null; defaultValue?: string | null; onValueChange?: (value: string | null) => void; className?: string; style?: React.CSSProperties; transition?: Transition; hover?: boolean; click?: boolean; disabled?: boolean; enabled?: boolean; exitDelay?: number; }; type ParentModeHighlightProps = { boundsOffset?: Partial; containerClassName?: string; forceUpdateBounds?: boolean; }; type ControlledParentModeHighlightProps = BaseHighlightProps & ParentModeHighlightProps & { mode: "parent"; controlledItems: true; children: React.ReactNode; }; type ControlledChildrenModeHighlightProps = BaseHighlightProps & { mode?: "children" | undefined; controlledItems: true; children: React.ReactNode; }; type UncontrolledParentModeHighlightProps = BaseHighlightProps & ParentModeHighlightProps & { mode: "parent"; controlledItems?: false; itemsClassName?: string; children: React.ReactElement | React.ReactElement[]; }; type UncontrolledChildrenModeHighlightProps< T extends React.ElementType = "div", > = BaseHighlightProps & { mode?: "children"; controlledItems?: false; itemsClassName?: string; children: React.ReactElement | React.ReactElement[]; }; type HighlightProps = | ControlledParentModeHighlightProps | ControlledChildrenModeHighlightProps | UncontrolledParentModeHighlightProps | UncontrolledChildrenModeHighlightProps; function Highlight({ ref, ...props }: HighlightProps) { const { as: Component = "div", children, value, defaultValue, onValueChange, className, style, transition = DEFAULT_TRANSITION, hover = false, click = true, enabled = true, controlledItems, disabled = false, exitDelay = 200, mode = "children", } = props; const localRef = React.useRef(null); React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement); const propsBoundsOffset = (props as ParentModeHighlightProps)?.boundsOffset; const boundsOffset = propsBoundsOffset ?? DEFAULT_BOUNDS_OFFSET; const boundsOffsetTop = boundsOffset.top ?? 0; const boundsOffsetLeft = boundsOffset.left ?? 0; const boundsOffsetWidth = boundsOffset.width ?? 0; const boundsOffsetHeight = boundsOffset.height ?? 0; const boundsOffsetRef = React.useRef({ top: boundsOffsetTop, left: boundsOffsetLeft, width: boundsOffsetWidth, height: boundsOffsetHeight, }); React.useEffect(() => { boundsOffsetRef.current = { top: boundsOffsetTop, left: boundsOffsetLeft, width: boundsOffsetWidth, height: boundsOffsetHeight, }; }, [ boundsOffsetTop, boundsOffsetLeft, boundsOffsetWidth, boundsOffsetHeight, ]); const [activeValue, setActiveValue] = React.useState( value ?? defaultValue ?? null, ); const [boundsState, setBoundsState] = React.useState(null); const [activeClassNameState, setActiveClassNameState] = React.useState(""); const scaleX = useMotionValue(1); const scaleY = useMotionValue(1); const lastBoundsRef = React.useRef<{ bounds: Bounds; timestamp: number; } | null>(null); const stretchRunRef = React.useRef(0); const triggerStretch = React.useCallback( (nextBounds: Bounds) => { const timestamp = performance.now(); const previous = lastBoundsRef.current; lastBoundsRef.current = { bounds: nextBounds, timestamp }; if (!previous) return; const elapsed = Math.max(timestamp - previous.timestamp, 16); const horizontal = Math.min( (Math.abs(nextBounds.left - previous.bounds.left) / elapsed / MAX_AXIS_SPEED) * 1000, 1, ); const vertical = Math.min( (Math.abs(nextBounds.top - previous.bounds.top) / elapsed / MAX_AXIS_SPEED) * 1000, 1, ); if (horizontal === 0 && vertical === 0) return; const nextScaleX = Math.max( 1 - MAX_SQUASH, Math.min( 1 + MAX_STRETCH, 1 + horizontal * MAX_STRETCH - vertical * MAX_SQUASH, ), ); const nextScaleY = Math.max( 1 - MAX_SQUASH, Math.min( 1 + MAX_STRETCH, 1 + vertical * MAX_STRETCH - horizontal * MAX_SQUASH, ), ); const run = ++stretchRunRef.current; animate(scaleX, nextScaleX, STRETCH_TRANSITION); animate(scaleY, nextScaleY, STRETCH_TRANSITION); window.setTimeout(() => { if (stretchRunRef.current !== run) return; animate(scaleX, 1, SETTLE_TRANSITION); animate(scaleY, 1, SETTLE_TRANSITION); }, STRETCH_DURATION); }, [scaleX, scaleY], ); const safeSetActiveValue = (id: string | null) => { setActiveValue((prev) => { if (prev !== id) { onValueChange?.(id); return id; } return prev; }); }; const safeSetBoundsRef = React.useRef< ((bounds: DOMRect) => void) | undefined >(undefined); React.useEffect(() => { safeSetBoundsRef.current = (bounds: DOMRect) => { if (!localRef.current) return; const containerRect = localRef.current.getBoundingClientRect(); const offset = boundsOffsetRef.current; const newBounds: Bounds = { top: bounds.top - containerRect.top + offset.top, left: bounds.left - containerRect.left + offset.left, width: bounds.width + offset.width, height: bounds.height + offset.height, }; triggerStretch(newBounds); setBoundsState((prev) => { if ( prev && prev.top === newBounds.top && prev.left === newBounds.left && prev.width === newBounds.width && prev.height === newBounds.height ) { return prev; } return newBounds; }); }; }); const safeSetBounds = (bounds: DOMRect) => { safeSetBoundsRef.current?.(bounds); }; const clearBounds = React.useCallback(() => { lastBoundsRef.current = null; stretchRunRef.current += 1; animate(scaleX, 1, SETTLE_TRANSITION); animate(scaleY, 1, SETTLE_TRANSITION); setBoundsState((prev) => (prev === null ? prev : null)); }, [scaleX, scaleY]); React.useEffect(() => { if (value !== undefined) setActiveValue(value); else if (defaultValue !== undefined) setActiveValue(defaultValue); }, [value, defaultValue]); const id = React.useId(); React.useEffect(() => { if (mode !== "parent") return; const container = localRef.current; if (!container) return; const onScroll = () => { if (!activeValue) return; const activeEl = container.querySelector( `[data-value="${activeValue}"][data-highlight="true"]`, ); if (activeEl) safeSetBoundsRef.current?.(activeEl.getBoundingClientRect()); }; container.addEventListener("scroll", onScroll, { passive: true }); return () => container.removeEventListener("scroll", onScroll); }, [mode, activeValue]); const render = (children: React.ReactNode) => { if (mode === "parent") { return React.createElement( Component as React.ElementType, { ref: localRef, "data-slot": "motion-highlight-container", style: { position: "relative", zIndex: 1 }, className: (props as ParentModeHighlightProps)?.containerClassName, ...(hover && { onMouseLeave: () => { safeSetActiveValue(null); clearBounds(); }, }), }, <> {boundsState && ( )} {children} , ); } return children; }; return ( {enabled ? controlledItems ? render(children) : render( React.Children.map(children, (child, index) => React.isValidElement(child) ? ( {child} ) : ( child ), ), ) : children} ); } function getNonOverridingDataAttributes( element: React.ReactElement, dataAttributes: Record, ): Record { return Object.keys(dataAttributes).reduce>( (acc, key) => { if ((element.props as Record)[key] === undefined) { acc[key] = dataAttributes[key]; } return acc; }, {}, ); } type ExtendedChildProps = React.ComponentProps<"div"> & { id?: string; ref?: React.Ref; "data-active"?: string; "data-value"?: string; "data-disabled"?: boolean; "data-highlight"?: boolean; "data-slot"?: string; }; type HighlightItemProps = React.ComponentProps & { as?: T; children: React.ReactNode; id?: string; value?: string; className?: string; style?: React.CSSProperties; transition?: Transition; activeClassName?: string; disabled?: boolean; exitDelay?: number; asChild?: boolean; forceUpdateBounds?: boolean; }; function HighlightItem({ ref, as, children, id, value, className, style, transition, disabled = false, activeClassName, exitDelay, asChild = false, forceUpdateBounds, ...props }: HighlightItemProps) { const itemId = React.useId(); const { activeValue, setActiveValue, mode, setBounds, hover, click, enabled, className: contextClassName, style: contextStyle, transition: contextTransition, id: contextId, disabled: contextDisabled, exitDelay: contextExitDelay, forceUpdateBounds: contextForceUpdateBounds, setActiveClassName, scaleX, scaleY, } = useHighlight(); const Component = (as ?? "div") as React.ElementType; const isValidChild = React.isValidElement(children); const element = isValidChild ? children : null; const childValue = id ?? value ?? element?.props?.["data-value"] ?? element?.props?.id ?? itemId; const isActive = activeValue === childValue; const isDisabled = disabled === undefined ? contextDisabled : disabled; const itemTransition = transition ?? contextTransition; const localRef = React.useRef(null); React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement); const refCallback = React.useCallback((node: HTMLElement | null) => { localRef.current = node as HTMLDivElement; }, []); React.useEffect(() => { if (mode !== "parent") return; let rafId: number; let previousBounds: Bounds | null = null; const shouldUpdateBounds = forceUpdateBounds === true || (contextForceUpdateBounds && forceUpdateBounds !== false); const updateBounds = () => { if (!localRef.current) return; const bounds = localRef.current.getBoundingClientRect(); if (shouldUpdateBounds) { if ( previousBounds && previousBounds.top === bounds.top && previousBounds.left === bounds.left && previousBounds.width === bounds.width && previousBounds.height === bounds.height ) { rafId = requestAnimationFrame(updateBounds); return; } previousBounds = bounds; rafId = requestAnimationFrame(updateBounds); } setBounds(bounds); }; if (isActive) { updateBounds(); setActiveClassName(activeClassName ?? ""); } if (shouldUpdateBounds) return () => cancelAnimationFrame(rafId); }, [ mode, isActive, activeValue, setBounds, activeClassName, setActiveClassName, forceUpdateBounds, contextForceUpdateBounds, ]); if (!isValidChild || !element) return children; const dataAttributes = { "data-active": isActive ? "true" : "false", "aria-selected": isActive, "data-disabled": isDisabled, "data-value": childValue, "data-highlight": true, }; const commonHandlers = hover ? { onMouseEnter: (e: React.MouseEvent) => { setActiveValue(childValue); element.props.onMouseEnter?.(e); }, ...(mode !== "parent" && { onMouseLeave: (e: React.MouseEvent) => { setActiveValue(null); element.props.onMouseLeave?.(e); }, }), } : click ? { onClick: (e: React.MouseEvent) => { setActiveValue(childValue); element.props.onClick?.(e); }, } : {}; if (asChild) { if (mode === "children") { return React.cloneElement( element, { key: childValue, ref: refCallback, className: cn("relative", element.props.className), ...getNonOverridingDataAttributes(element, { ...dataAttributes, "data-slot": "motion-highlight-item-container", }), ...commonHandlers, ...props, }, <> {isActive && !isDisabled && ( )} {React.createElement( Component, { "data-slot": "motion-highlight-item", style: { position: "relative", zIndex: 1 }, className, ...dataAttributes, }, children, )} , ); } return React.cloneElement(element, { ref: refCallback, ...getNonOverridingDataAttributes(element, { ...dataAttributes, "data-slot": "motion-highlight-item", }), ...commonHandlers, }); } return enabled ? React.createElement( Component, { key: childValue, ref: localRef, "data-slot": "motion-highlight-item-container", className: cn(mode === "children" && "relative", className), ...dataAttributes, ...props, ...commonHandlers, }, <> {mode === "children" && ( {isActive && !isDisabled && ( )} )} {React.cloneElement(element, { style: { position: "relative", zIndex: 1 }, className: element.props.className, ...getNonOverridingDataAttributes(element, { ...dataAttributes, "data-slot": "motion-highlight-item", }), })} , ) : children; } export { Highlight, HighlightItem, useHighlight, type HighlightProps, type HighlightItemProps, }; 4c:["$","div",null,{"className":"flex flex-col gap-12","children":[["$","div",null,{"className":"pt-10 flex flex-col gap-4","children":[["$","ul",null,{"className":"flex gap-2 flex-wrap","children":[["$","li","motion",{"children":["$","a",null,{"href":"https://www.npmjs.com/package/motion","target":"_blank","rel":"noopener noreferrer","className":"rounded-md border p-2 text-sm flex items-center gap-1 ","children":[["$","svg",null,{"viewBox":"0 0 24 24","className":"size-3","children":["$","path",null,{"d":"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","fill":"currentColor"}]}],["$","span",null,{"className":"text-xs font-medium","children":"motion"}]]}]}]]}],["$","$L50",null,{"registryDependencies":[]}]]}],["$","$L51",null,{"sourceUrl":"https://ui.unlumen.com/r/primitives-effects-velocity-highlight.json","proxyUrl":"https://shadcnregistry.com/r/unlumen-ui/primitives-effects-velocity-highlight","itemId":"@unlumen-ui/primitives-effects-velocity-highlight"}],["$","section",null,{"className":"flex flex-col gap-4","id":"files","children":[["$","h2",null,{"className":"text-lg md:text-2xl font-bold font-mono","children":"Files"}],["$","$L52",null,{"files":[{"path":"registry/primitives/effects/velocity-highlight/index.tsx","content":"$53","type":"registry:ui","target":"components/unlumen-ui/primitives/effects/velocity-highlight.tsx"}]}]]}],"$L54"]}]

Velocity Highlight

Installation

Files

components

Styles