{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "radix-tooltip",
  "title": "Radix Tooltip",
  "description": "An accessible tooltip built on Radix UI with spring-based keyframe scale and translation animations powered by Motion.",
  "dependencies": ["radix-ui", "motion"],
  "registryDependencies": ["utils", "@soralabs/hooks-use-controlled-state"],
  "files": [
    {
      "path": "registry/ui/radix/tooltip/index.tsx",
      "content": "\"use client\";\n\nimport { useControlledState } from \"@/hooks/use-controlled-state\";\nimport { cn } from \"@/lib/utils\";\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport type { Transition } from \"motion/react\";\nimport { Direction, Tooltip as TooltipPrimitive } from \"radix-ui\";\nimport { createContext, useContext, useMemo, useState } from \"react\";\nimport type { ComponentProps } from \"react\";\n\ntype TooltipSide =\n  | \"top\"\n  | \"right\"\n  | \"bottom\"\n  | \"left\"\n  | \"inline-start\"\n  | \"inline-end\";\n\ninterface TooltipContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  setSide: (side: TooltipSide) => void;\n  side: TooltipSide;\n}\n\nconst TooltipContext = createContext<TooltipContextValue | null>(null);\n\nfunction useTooltipContext() {\n  return useContext(TooltipContext);\n}\n\nconst defaultSpringTransition: Transition = {\n  visualDuration: 0.3,\n  type: \"spring\",\n  bounce: 0.6,\n};\n\ninterface TooltipProviderProps extends ComponentProps<\n  typeof TooltipPrimitive.Provider\n> {\n  /**\n   * Delay in milliseconds before showing tooltips.\n   * Alias to delayDuration.\n   * @default 300\n   */\n  delay?: number;\n}\n\n/**\n * Provides shared delay and grouping settings for tooltips.\n */\nfunction TooltipProvider({\n  delay = 300,\n  delayDuration,\n  ...props\n}: TooltipProviderProps) {\n  return (\n    <TooltipPrimitive.Provider\n      data-slot=\"tooltip-provider\"\n      delayDuration={delayDuration ?? delay}\n      {...props}\n    />\n  );\n}\n\ntype TooltipProps = ComponentProps<typeof TooltipPrimitive.Root>;\n\n/**\n * Root container for the Tooltip component powered by Radix UI and Motion.\n */\nfunction Tooltip({\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  children,\n  ...props\n}: TooltipProps) {\n  const [open, setOpen] = useControlledState({\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n    value: controlledOpen,\n  });\n  const [side, setSide] = useState<TooltipSide>(\"top\");\n\n  const contextValue = useMemo(\n    () => ({\n      open: Boolean(open),\n      setOpen,\n      side,\n      setSide,\n    }),\n    [open, setOpen, side]\n  );\n\n  return (\n    <TooltipContext.Provider value={contextValue}>\n      <TooltipPrimitive.Root\n        data-slot=\"tooltip\"\n        onOpenChange={(nextOpen) => {\n          setOpen(nextOpen);\n        }}\n        open={open}\n        {...props}\n      >\n        {children}\n      </TooltipPrimitive.Root>\n    </TooltipContext.Provider>\n  );\n}\n\ntype TooltipTriggerProps = ComponentProps<typeof TooltipPrimitive.Trigger>;\n\n/**\n * Interactive element that activates the tooltip on hover or keyboard focus.\n */\nfunction TooltipTrigger({ asChild = false, ...props }: TooltipTriggerProps) {\n  return (\n    <TooltipPrimitive.Trigger\n      asChild={asChild}\n      data-slot=\"tooltip-trigger\"\n      {...props}\n    />\n  );\n}\n\ninterface TooltipContentProps extends Omit<\n  ComponentProps<typeof TooltipPrimitive.Content>,\n  \"side\"\n> {\n  /**\n   * Floating side position relative to trigger.\n   * Supports logical inline-start and inline-end for native RTL.\n   * @default \"top\"\n   */\n  side?: TooltipSide;\n  /**\n   * Custom spring transition config for the entrance and exit animation.\n   * @default { visualDuration: 0.3, type: \"spring\", bounce: 0.6 }\n   */\n  transition?: Transition;\n}\n\n/**\n * The floating popup content container animated via Motion spring physics.\n */\nfunction TooltipContent({\n  className,\n  side = \"top\",\n  sideOffset = 4,\n  align = \"center\",\n  alignOffset = 0,\n  children,\n  asChild: _asChild,\n  style,\n  transition = defaultSpringTransition,\n  ...props\n}: TooltipContentProps) {\n  const context = useTooltipContext();\n  const direction = Direction.useDirection();\n  const shouldReduceMotion = useReducedMotion();\n  const isOpen = context?.open ?? true;\n\n  if (context && context.side !== side) {\n    context.setSide(side);\n  }\n\n  const resolvedSide = useMemo(() => {\n    if (side === \"inline-start\") {\n      return direction === \"rtl\" ? \"right\" : \"left\";\n    }\n    if (side === \"inline-end\") {\n      return direction === \"rtl\" ? \"left\" : \"right\";\n    }\n    return side;\n  }, [side, direction]);\n\n  const offset = useMemo(() => {\n    switch (resolvedSide) {\n      case \"bottom\": {\n        return { x: 0, y: -8 };\n      }\n      case \"left\": {\n        return { x: 8, y: 0 };\n      }\n      case \"right\": {\n        return { x: -8, y: 0 };\n      }\n      default: {\n        return { x: 0, y: 8 };\n      }\n    }\n  }, [resolvedSide]);\n\n  const initialMotion = shouldReduceMotion\n    ? { opacity: 0 }\n    : { opacity: 0, scale: 0.8, x: offset.x, y: offset.y };\n\n  const animateMotion = shouldReduceMotion\n    ? { opacity: 1 }\n    : { opacity: 1, scale: 1, x: 0, y: 0 };\n\n  const exitMotion = shouldReduceMotion\n    ? { opacity: 0 }\n    : { opacity: 0, scale: 0.8, x: offset.x, y: offset.y };\n\n  return (\n    <AnimatePresence>\n      {isOpen && (\n        <TooltipPrimitive.Portal forceMount>\n          <TooltipPrimitive.Content\n            align={align}\n            alignOffset={alignOffset}\n            asChild\n            className={cn(\n              \"bg-foreground text-background z-50 inline-flex w-fit max-w-xs items-center gap-1.5 rounded-md px-3 py-1.5 text-xs shadow-md outline-none has-data-[slot=kbd]:pr-1.5 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm\",\n              className\n            )}\n            data-slot=\"tooltip-content\"\n            forceMount\n            side={resolvedSide}\n            sideOffset={sideOffset}\n            {...props}\n          >\n            <motion.div\n              animate={animateMotion}\n              exit={{\n                ...exitMotion,\n                transition: shouldReduceMotion\n                  ? { duration: 0.1 }\n                  : { duration: 0.15, ease: \"easeIn\" },\n              }}\n              initial={initialMotion}\n              style={{\n                transformOrigin:\n                  \"var(--radix-tooltip-content-transform-origin, var(--transform-origin))\",\n                willChange: \"transform, opacity\",\n                backfaceVisibility: \"hidden\",\n                WebkitFontSmoothing: \"subpixel-antialiased\",\n                ...style,\n              }}\n              transition={shouldReduceMotion ? { duration: 0.1 } : transition}\n            >\n              {children}\n            </motion.div>\n          </TooltipPrimitive.Content>\n        </TooltipPrimitive.Portal>\n      )}\n    </AnimatePresence>\n  );\n}\n\ntype TooltipArrowProps = ComponentProps<typeof TooltipPrimitive.Arrow>;\n\n/**\n * Optional arrow pointing towards the tooltip trigger.\n */\nfunction TooltipArrow({ className, ...props }: TooltipArrowProps) {\n  return (\n    <TooltipPrimitive.Arrow\n      className={cn(\"fill-foreground z-50\", className)}\n      data-slot=\"tooltip-arrow\"\n      {...props}\n    />\n  );\n}\n\nconst { DirectionProvider } = Direction;\n\nexport type {\n  TooltipArrowProps,\n  TooltipContentProps,\n  TooltipProps,\n  TooltipProviderProps,\n  TooltipSide,\n  TooltipTriggerProps,\n};\nexport {\n  DirectionProvider,\n  defaultSpringTransition,\n  Tooltip,\n  Tooltip as RadixTooltip,\n  Tooltip as default,\n  TooltipArrow,\n  TooltipContent,\n  TooltipProvider,\n  TooltipTrigger,\n  useTooltipContext,\n};\n",
      "type": "registry:ui",
      "target": "components/sora-ui/radix/tooltip.tsx"
    }
  ],
  "meta": {
    "agentMetadata": {
      "intent": "Provide contextual hint or shortcut explanation when hovering or focusing an interactive element.",
      "role": "tooltip",
      "a11yConstraints": [
        "Render accessible name/description without trapping keyboard focus.",
        "Dismiss cleanly on Escape without activating underlying element."
      ],
      "motionEngine": "Motion spring scale, directional translation offset, and presence transition.",
      "compositionRules": [
        "Wrap interactive elements with TooltipTrigger using asChild or semantic button."
      ],
      "compositionRecipes": [
        "Compose with radix/button for icon-only action button descriptions."
      ]
    }
  },
  "type": "registry:ui"
}
