{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "highlight",
  "title": "Highlight",
  "description": "An animated highlight component that tracks elements with smooth spring animations.",
  "dependencies": [
    "motion"
  ],
  "registryDependencies": [],
  "files": [
    {
      "path": "registry/primitives/effects/highlight/index.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { AnimatePresence, Transition, motion } from \"motion/react\";\n\nimport { cn } from \"@/lib/utils\";\n\ntype HighlightMode = \"children\" | \"parent\";\n\ntype Bounds = {\n  top: number;\n  left: number;\n  width: number;\n  height: number;\n};\n\ntype HighlightContextType<T extends string> = {\n  mode: HighlightMode;\n  activeValue: T | null;\n  setActiveValue: (value: T | null) => void;\n  setBounds: (bounds: DOMRect) => void;\n  clearBounds: () => void;\n  id: string;\n  hover: boolean;\n  className?: string;\n  activeClassName?: string;\n  setActiveClassName: (className: string) => void;\n  transition?: Transition;\n  disabled?: boolean;\n  enabled?: boolean;\n  exitDelay?: number;\n  forceUpdateBounds?: boolean;\n};\n\nconst HighlightContext = React.createContext<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  HighlightContextType<any> | undefined\n>(undefined);\n\nfunction useHighlight<T extends string>(): HighlightContextType<T> {\n  const context = React.useContext(HighlightContext);\n  if (!context) {\n    throw new Error(\"useHighlight must be used within a HighlightProvider\");\n  }\n  return context as unknown as HighlightContextType<T>;\n}\n\ntype BaseHighlightProps<T extends string> = {\n  mode?: HighlightMode;\n  value?: T | null;\n  defaultValue?: T | null;\n  onValueChange?: (value: T | null) => void;\n  className?: string;\n  transition?: Transition;\n  hover?: boolean;\n  disabled?: boolean;\n  enabled?: boolean;\n  exitDelay?: number;\n};\n\ntype ParentModeHighlightProps = {\n  boundsOffset?: Partial<Bounds>;\n  containerClassName?: string;\n  forceUpdateBounds?: boolean;\n};\n\ntype ControlledParentModeHighlightProps<T extends string> =\n  BaseHighlightProps<T> &\n    ParentModeHighlightProps & {\n      mode: \"parent\";\n      controlledItems: true;\n      children: React.ReactNode;\n    };\n\ntype ControlledChildrenModeHighlightProps<T extends string> =\n  BaseHighlightProps<T> & {\n    mode?: \"children\" | undefined;\n    controlledItems: true;\n    children: React.ReactNode;\n  };\n\ntype UncontrolledParentModeHighlightProps<T extends string> =\n  BaseHighlightProps<T> &\n    ParentModeHighlightProps & {\n      mode: \"parent\";\n      controlledItems?: false;\n      itemsClassName?: string;\n      children: React.ReactElement | React.ReactElement[];\n    };\n\ntype UncontrolledChildrenModeHighlightProps<T extends string> =\n  BaseHighlightProps<T> & {\n    mode?: \"children\";\n    controlledItems?: false;\n    itemsClassName?: string;\n    children: React.ReactElement | React.ReactElement[];\n  };\n\ntype HighlightProps<T extends string> = React.ComponentProps<\"div\"> &\n  (\n    | ControlledParentModeHighlightProps<T>\n    | ControlledChildrenModeHighlightProps<T>\n    | UncontrolledParentModeHighlightProps<T>\n    | UncontrolledChildrenModeHighlightProps<T>\n  );\n\nfunction Highlight<T extends string>({ ref, ...props }: HighlightProps<T>) {\n  const {\n    children,\n    value,\n    defaultValue,\n    onValueChange,\n    className,\n    transition = { type: \"spring\", stiffness: 1250, damping: 40, mass: 0.5 },\n    hover = false,\n    enabled = true,\n    controlledItems,\n    disabled = false,\n    exitDelay = 0.2,\n    mode = \"children\",\n  } = props;\n  const {\n    boundsOffset = { top: 0, left: 0, width: 0, height: 0 },\n    containerClassName,\n    forceUpdateBounds,\n  } = props as ParentModeHighlightProps;\n  const { itemsClassName } = props as {\n    itemsClassName?: string;\n  };\n\n  const localRef = React.useRef<HTMLDivElement>(null);\n  React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement);\n\n  const [activeValue, setActiveValue] = React.useState<T | null>(\n    value ?? defaultValue ?? null,\n  );\n  const [boundsState, setBoundsState] = React.useState<Bounds | null>(null);\n  const [activeClassNameState, setActiveClassNameState] =\n    React.useState<string>(\"\");\n\n  function safeSetActiveValue(id: T | null) {\n    setActiveValue((prev) => {\n      if (prev !== id) onValueChange?.(id as T);\n      return prev === id ? prev : id;\n    });\n  }\n\n  function safeSetBounds(bounds: DOMRect) {\n    if (!localRef.current) return;\n\n    const containerRect = localRef.current.getBoundingClientRect();\n    const newBounds: Bounds = {\n      top: bounds.top - containerRect.top + (boundsOffset.top ?? 0),\n      left: bounds.left - containerRect.left + (boundsOffset.left ?? 0),\n      width: bounds.width + (boundsOffset.width ?? 0),\n      height: bounds.height + (boundsOffset.height ?? 0),\n    };\n\n    setBoundsState((prev) => {\n      if (\n        prev &&\n        prev.top === newBounds.top &&\n        prev.left === newBounds.left &&\n        prev.width === newBounds.width &&\n        prev.height === newBounds.height\n      ) {\n        return prev;\n      }\n      return newBounds;\n    });\n  }\n\n  function clearBounds() {\n    setBoundsState((prev) => (prev === null ? prev : null));\n  }\n\n  React.useEffect(() => {\n    if (value !== undefined) setActiveValue(value);\n    else if (defaultValue !== undefined) setActiveValue(defaultValue);\n  }, [value, defaultValue]);\n\n  const id = React.useId();\n\n  React.useEffect(() => {\n    if (mode !== \"parent\") return;\n    const container = localRef.current;\n    if (!container) return;\n\n    const onScroll = () => {\n      if (!activeValue) return;\n      const activeEl = container.querySelector<HTMLElement>(\n        `[data-value=\"${activeValue}\"][data-highlight=\"true\"]`,\n      );\n      if (activeEl) safeSetBounds(activeEl.getBoundingClientRect());\n    };\n\n    container.addEventListener(\"scroll\", onScroll, { passive: true });\n    return () => container.removeEventListener(\"scroll\", onScroll);\n  });\n\n  function render(children: React.ReactNode) {\n    if (mode === \"parent\") {\n      return (\n        <div\n          ref={localRef}\n          data-slot=\"motion-highlight-container\"\n          className={cn(\"relative\", containerClassName)}\n        >\n          <AnimatePresence initial={false}>\n            {boundsState && (\n              <motion.div\n                data-slot=\"motion-highlight\"\n                animate={{\n                  top: boundsState.top,\n                  left: boundsState.left,\n                  width: boundsState.width,\n                  height: boundsState.height,\n                  opacity: 1,\n                }}\n                initial={{\n                  top: boundsState.top,\n                  left: boundsState.left,\n                  width: boundsState.width,\n                  height: boundsState.height,\n                  opacity: 0,\n                }}\n                exit={{\n                  opacity: 0,\n                  transition: {\n                    ...transition,\n                    delay: (transition?.delay ?? 0) + (exitDelay ?? 0),\n                  },\n                }}\n                transition={transition}\n                className={cn(\n                  \"absolute bg-muted z-0\",\n                  className,\n                  activeClassNameState,\n                )}\n              />\n            )}\n          </AnimatePresence>\n          {children}\n        </div>\n      );\n    }\n\n    return children;\n  }\n\n  return (\n    <HighlightContext.Provider\n      value={{\n        mode,\n        activeValue,\n        setActiveValue: safeSetActiveValue,\n        id,\n        hover,\n        className,\n        transition,\n        disabled,\n        enabled,\n        exitDelay,\n        setBounds: safeSetBounds,\n        clearBounds,\n        activeClassName: activeClassNameState,\n        setActiveClassName: setActiveClassNameState,\n        forceUpdateBounds,\n      }}\n    >\n      {enabled\n        ? controlledItems\n          ? render(children)\n          : render(\n              React.Children.map(children, (child, index) =>\n                React.isValidElement(child) ? (\n                  <HighlightItem key={index} className={itemsClassName}>\n                    {child}\n                  </HighlightItem>\n                ) : (\n                  child\n                ),\n              ),\n            )\n        : children}\n    </HighlightContext.Provider>\n  );\n}\n\nfunction getNonOverridingDataAttributes(\n  element: React.ReactElement,\n  dataAttributes: Record<string, unknown>,\n): Record<string, unknown> {\n  return Object.keys(dataAttributes).reduce<Record<string, unknown>>(\n    (acc, key) => {\n      if ((element.props as Record<string, unknown>)[key] === undefined) {\n        acc[key] = dataAttributes[key];\n      }\n      return acc;\n    },\n    {},\n  );\n}\n\nfunction assignRef<T>(ref: React.Ref<T> | undefined, node: T | null) {\n  if (!ref) return;\n  if (typeof ref === \"function\") {\n    ref(node);\n    return;\n  }\n  (ref as React.RefObject<T | null>).current = node;\n}\n\nfunction useComposedRefs<T>(\n  childRef: React.Ref<T> | undefined,\n  localRef: React.Ref<T> | undefined,\n  forwardedRef: React.Ref<T> | undefined,\n): React.RefCallback<T> {\n  return React.useCallback(\n    (node) => {\n      assignRef(childRef, node);\n      assignRef(localRef, node);\n      assignRef(forwardedRef, node);\n    },\n    [childRef, localRef, forwardedRef],\n  );\n}\n\ntype ExtendedChildProps = React.ComponentProps<\"div\"> & {\n  id?: string;\n  ref?: React.Ref<HTMLElement>;\n  \"data-active\"?: string;\n  \"data-value\"?: string;\n  \"data-disabled\"?: boolean;\n  \"data-highlight\"?: boolean;\n  \"data-slot\"?: string;\n};\n\ntype HighlightItemProps = React.ComponentProps<\"div\"> & {\n  children: React.ReactNode;\n  id?: string;\n  value?: string;\n  className?: string;\n  transition?: Transition;\n  activeClassName?: string;\n  disabled?: boolean;\n  exitDelay?: number;\n  asChild?: boolean;\n  forceUpdateBounds?: boolean;\n};\n\nfunction HighlightItem({\n  ref,\n  children,\n  id,\n  value,\n  className,\n  transition,\n  disabled = false,\n  activeClassName,\n  exitDelay,\n  asChild = false,\n  forceUpdateBounds,\n  ...props\n}: HighlightItemProps) {\n  const itemId = React.useId();\n  const {\n    activeValue,\n    setActiveValue,\n    mode,\n    setBounds,\n    clearBounds,\n    hover,\n    enabled,\n    className: contextClassName,\n    transition: contextTransition,\n    id: contextId,\n    disabled: contextDisabled,\n    exitDelay: contextExitDelay,\n    forceUpdateBounds: contextForceUpdateBounds,\n    setActiveClassName,\n  } = useHighlight();\n\n  const isValidChild = React.isValidElement<ExtendedChildProps>(children);\n  const element = isValidChild ? children : null;\n  const childValue =\n    id ??\n    value ??\n    element?.props?.[\"data-value\"] ??\n    element?.props?.id ??\n    itemId;\n  const isActive = activeValue === childValue;\n  const isDisabled = disabled === undefined ? contextDisabled : disabled;\n  const itemTransition = transition ?? contextTransition;\n\n  const localRef = React.useRef<HTMLDivElement>(null);\n  React.useImperativeHandle(ref, () => localRef.current as HTMLDivElement);\n  const childRef = element?.props.ref;\n  const composedRef = useComposedRefs<HTMLElement>(\n    childRef,\n    localRef as React.RefObject<HTMLElement | null>,\n    ref as React.Ref<HTMLElement>,\n  );\n\n  React.useEffect(() => {\n    if (mode !== \"parent\") return;\n    let rafId: number;\n    let previousBounds: Bounds | null = null;\n    const shouldUpdateBounds =\n      forceUpdateBounds === true ||\n      (contextForceUpdateBounds && forceUpdateBounds !== false);\n\n    const updateBounds = () => {\n      if (!localRef.current) return;\n\n      const bounds = localRef.current.getBoundingClientRect();\n\n      if (shouldUpdateBounds) {\n        if (\n          previousBounds &&\n          previousBounds.top === bounds.top &&\n          previousBounds.left === bounds.left &&\n          previousBounds.width === bounds.width &&\n          previousBounds.height === bounds.height\n        ) {\n          rafId = requestAnimationFrame(updateBounds);\n          return;\n        }\n        previousBounds = bounds;\n        rafId = requestAnimationFrame(updateBounds);\n      }\n\n      setBounds(bounds);\n    };\n\n    if (isActive) {\n      updateBounds();\n      setActiveClassName(activeClassName ?? \"\");\n    } else if (!activeValue) clearBounds();\n\n    if (shouldUpdateBounds) return () => cancelAnimationFrame(rafId);\n  }, [\n    mode,\n    isActive,\n    activeValue,\n    setBounds,\n    clearBounds,\n    activeClassName,\n    setActiveClassName,\n    forceUpdateBounds,\n    contextForceUpdateBounds,\n  ]);\n\n  if (!isValidChild || !element) return children;\n\n  const dataAttributes = {\n    \"data-active\": isActive ? \"true\" : \"false\",\n    \"aria-selected\": isActive,\n    \"data-disabled\": isDisabled,\n    \"data-value\": childValue,\n    \"data-highlight\": true,\n  };\n\n  const commonHandlers = hover\n    ? {\n        onMouseEnter: (e: React.MouseEvent<HTMLDivElement>) => {\n          setActiveValue(childValue);\n          element.props.onMouseEnter?.(e);\n        },\n        onMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => {\n          setActiveValue(null);\n          element.props.onMouseLeave?.(e);\n        },\n      }\n    : {\n        onClick: (e: React.MouseEvent<HTMLDivElement>) => {\n          setActiveValue(childValue);\n          element.props.onClick?.(e);\n        },\n      };\n\n  if (asChild) {\n    const { ref: _childRef, ...childProps } =\n      element.props as ExtendedChildProps;\n\n    if (mode === \"children\") {\n      return React.createElement(\n        element.type,\n        {\n          ...childProps,\n          key: childValue,\n          ref: composedRef,\n          className: cn(\"relative\", element.props.className),\n          ...getNonOverridingDataAttributes(element, {\n            ...dataAttributes,\n            \"data-slot\": \"motion-highlight-item-container\",\n          }),\n          ...commonHandlers,\n          ...props,\n        },\n        <>\n          <AnimatePresence initial={false}>\n            {isActive && !isDisabled && (\n              <motion.div\n                layoutId={`transition-background-${contextId}`}\n                data-slot=\"motion-highlight\"\n                className={cn(\n                  \"absolute inset-0 bg-muted z-0\",\n                  contextClassName,\n                  activeClassName,\n                )}\n                transition={itemTransition}\n                initial={{ opacity: 0 }}\n                animate={{ opacity: 1 }}\n                exit={{\n                  opacity: 0,\n                  transition: {\n                    ...itemTransition,\n                    delay:\n                      (itemTransition?.delay ?? 0) +\n                      (exitDelay ?? contextExitDelay ?? 0),\n                  },\n                }}\n                {...dataAttributes}\n              />\n            )}\n          </AnimatePresence>\n\n          <div\n            data-slot=\"motion-highlight-item\"\n            className={cn(\"relative z-1\", className)}\n            {...dataAttributes}\n          >\n            {children}\n          </div>\n        </>,\n      );\n    }\n\n    return React.createElement(element.type, {\n      ...childProps,\n      ref: composedRef,\n      ...getNonOverridingDataAttributes(element, {\n        ...dataAttributes,\n        \"data-slot\": \"motion-highlight-item\",\n      }),\n      ...commonHandlers,\n    });\n  }\n\n  return enabled ? (\n    <div\n      key={childValue}\n      ref={localRef}\n      data-slot=\"motion-highlight-item-container\"\n      className={cn(mode === \"children\" && \"relative\", className)}\n      {...dataAttributes}\n      {...props}\n      {...commonHandlers}\n    >\n      {mode === \"children\" && (\n        <AnimatePresence initial={false}>\n          {isActive && !isDisabled && (\n            <motion.div\n              layoutId={`transition-background-${contextId}`}\n              data-slot=\"motion-highlight\"\n              className={cn(\n                \"absolute inset-0 bg-muted z-0\",\n                contextClassName,\n                activeClassName,\n              )}\n              transition={itemTransition}\n              initial={{ opacity: 0 }}\n              animate={{ opacity: 1 }}\n              exit={{\n                opacity: 0,\n                transition: {\n                  ...itemTransition,\n                  delay:\n                    (itemTransition?.delay ?? 0) +\n                    (exitDelay ?? contextExitDelay ?? 0),\n                },\n              }}\n              {...dataAttributes}\n            />\n          )}\n        </AnimatePresence>\n      )}\n\n      {React.cloneElement(element, {\n        className: cn(\"relative z-1\", element.props.className),\n        ...getNonOverridingDataAttributes(element, {\n          ...dataAttributes,\n          \"data-slot\": \"motion-highlight-item\",\n        }),\n      })}\n    </div>\n  ) : (\n    children\n  );\n}\n\nexport {\n  Highlight,\n  HighlightItem,\n  useHighlight,\n  type HighlightProps,\n  type HighlightItemProps,\n};\n",
      "type": "registry:ui",
      "target": "components/unlumen-ui/primitives/effects/highlight.tsx"
    }
  ],
  "type": "registry:ui"
}