51: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"] 52: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"] 53: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"] 54:T4201,'use client'; import * as React from 'react'; import { AnimatePresence, Transition, motion } from 'motion/react'; import { cn } from '@/lib/utils'; type HighlightMode = 'children' | 'parent'; type Bounds = { top: number; left: number; width: number; height: number; }; 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; }; 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 = { type: 'spring', stiffness: 350, damping: 35 }, hover = false, click = true, enabled = true, controlledItems, disabled = false, exitDelay = 200, mode = 'children', } = props; const Tag = Component as React.ElementType; const localRef = React.useRef(null); React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement); const [activeValue, setActiveValue] = React.useState( value ?? defaultValue ?? null, ); const [boundsState, setBoundsState] = React.useState(null); const [activeClassNameState, setActiveClassNameState] = React.useState(''); const safeSetActiveValue = React.useCallback( (id: string | null) => { setActiveValue((prev) => (prev === id ? prev : id)); if (id !== activeValue) onValueChange?.(id); }, [activeValue, onValueChange], ); const safeSetBounds = React.useCallback( (bounds: DOMRect) => { if (!localRef.current) return; const boundsOffset = (props as ParentModeHighlightProps) ?.boundsOffset ?? { top: 0, left: 0, width: 0, height: 0, }; const containerRect = localRef.current.getBoundingClientRect(); const newBounds: Bounds = { top: bounds.top - containerRect.top + (boundsOffset.top ?? 0), left: bounds.left - containerRect.left + (boundsOffset.left ?? 0), width: bounds.width + (boundsOffset.width ?? 0), height: bounds.height + (boundsOffset.height ?? 0), }; setBoundsState((prev) => { if ( prev && prev.top === newBounds.top && prev.left === newBounds.left && prev.width === newBounds.width && prev.height === newBounds.height ) { return prev; } return newBounds; }); }, [props], ); const clearBounds = React.useCallback(() => { setBoundsState((prev) => (prev === null ? prev : null)); }, []); 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) safeSetBounds(activeEl.getBoundingClientRect()); }; container.addEventListener('scroll', onScroll, { passive: true }); return () => container.removeEventListener('scroll', onScroll); }, [mode, activeValue, safeSetBounds]); const render = React.useCallback( (children: React.ReactNode) => { if (mode === 'parent') { return ( {boundsState && ( )} {children} ); } return children; }, [ mode, Tag, props, boundsState, transition, exitDelay, style, className, activeClassNameState, ], ); return ( {enabled ? controlledItems ? render(children) : render( React.Children.map(children, (child, index) => ( {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.ReactElement; 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, clearBounds, hover, click, enabled, className: contextClassName, style: contextStyle, transition: contextTransition, id: contextId, disabled: contextDisabled, exitDelay: contextExitDelay, forceUpdateBounds: contextForceUpdateBounds, setActiveClassName, } = useHighlight(); const Component = as ?? 'div'; const Tag = Component as React.ElementType; const element = children as React.ReactElement; 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); 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 ?? ''); } else if (!activeValue) clearBounds(); if (shouldUpdateBounds) return () => cancelAnimationFrame(rafId); }, [ mode, isActive, activeValue, setBounds, clearBounds, activeClassName, setActiveClassName, forceUpdateBounds, contextForceUpdateBounds, ]); if (!React.isValidElement(children)) 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); }, 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: localRef, className: cn('relative', element.props.className), ...getNonOverridingDataAttributes(element, { ...dataAttributes, 'data-slot': 'motion-highlight-item-container', }), ...commonHandlers, ...props, }, <> {isActive && !isDisabled && ( )} {children} , ); } return React.cloneElement(element, { ref: localRef, ...getNonOverridingDataAttributes(element, { ...dataAttributes, 'data-slot': 'motion-highlight-item', }), ...commonHandlers, }); } return enabled ? ( {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, }; 4d:["$","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"}]]}]}]]}],["$","$L51",null,{"registryDependencies":[]}]]}],["$","$L52",null,{"sourceUrl":"https://www.odysseyui.com/r/primitives-effects-highlight.json","proxyUrl":"https://shadcnregistry.com/r/odysseyui/primitives-effects-highlight","itemId":"@odysseyui/primitives-effects-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"}],["$","$L53",null,{"files":[{"path":"registry/primitives/effects/highlight/index.tsx","content":"$54","type":"registry:ui","target":"components/odysseyui/primitives/effects/highlight.tsx"}]}]]}],"$L55"]}]

Highlight

Installation

Files

components

Styles