{
  "schemaVersion": 1,
  "target": "react",
  "name": "hover-card",
  "version": "0.1.0",
  "category": "overlays",
  "title": "Hover Card",
  "description": "A rich preview of a person, repository, or link that opens on hover and keyboard focus, built on Base UI Preview Card.",
  "tags": [
    "overlay",
    "preview",
    "popover",
    "profile",
    "base-ui"
  ],
  "requires": {
    "projectTypes": [
      "next",
      "vite-react"
    ],
    "styling": "tailwind-v4"
  },
  "npmDependencies": {
    "@base-ui/react": "^1.9.0"
  },
  "registryDependencies": [],
  "docsPath": "/components/hover-card",
  "props": [
    {
      "name": "HoverCard open / defaultOpen / onOpenChange",
      "type": "boolean / boolean / (open, details) => void",
      "description": "Root state. Leave open unset for an uncontrolled card."
    },
    {
      "name": "HoverCardTrigger href",
      "type": "string",
      "description": "The link the card previews. It must still work for people who never see the card."
    },
    {
      "name": "HoverCardTrigger delay / closeDelay",
      "type": "number",
      "default": "600 / 300",
      "description": "Milliseconds before opening and before closing."
    },
    {
      "name": "HoverCardContent side / align",
      "type": "Side / \"start\" | \"center\" | \"end\"",
      "default": "\"bottom\" / \"center\"",
      "description": "Placement against the link. Flips when there is not enough room."
    },
    {
      "name": "HoverCardContent sideOffset / alignOffset",
      "type": "number",
      "default": "8 / 0",
      "description": "Gap from the link and shift along its edge, in pixels."
    },
    {
      "name": "HoverCardHeader / HoverCardMeta",
      "type": "ComponentProps<\"div\">",
      "description": "Layout helpers: an avatar and name row, and a footer row of small facts under a divider."
    }
  ],
  "accessibility": [
    "The trigger is a real link (<a href>), so the destination is reachable without the card.",
    "The card opens on hover and on keyboard focus of the link, and closes on Escape, blur, or when the pointer leaves both the link and the card.",
    "The pointer can travel from the link into the card without it closing, so links inside the card can be clicked.",
    "The card is supplementary: nothing in it should be the only way to reach information or an action.",
    "It grows from the link in 160ms and fades out in 110ms; with reduced motion the transitions are removed."
  ],
  "states": [
    "closed",
    "open"
  ],
  "files": [
    {
      "path": "ui/hover-card.tsx",
      "content": "\"use client\";\n\nimport { PreviewCard as BasePreviewCard } from \"@base-ui/react/preview-card\";\nimport type { ComponentProps } from \"react\";\n\ntype ClassName<State> = string | ((state: State) => string | undefined) | undefined;\n\nfunction cx(...classes: (string | false | null | undefined)[]) {\n  return classes.filter(Boolean).join(\" \");\n}\n\n/** Prepends base classes while keeping Base UI's state-function form of className working. */\nfunction withBase<State>(base: string, className: ClassName<State>) {\n  return typeof className === \"function\" ? (state: State) => cx(base, className(state)) : cx(base, className);\n}\n\n/** Groups the hover card parts and holds its open state. Pass `open`/`onOpenChange` to control it. */\nexport const HoverCard = BasePreviewCard.Root;\n\n/**\n * The link that shows the card on hover and on keyboard focus. Renders an `<a>`, so give it an\n * `href`: the card is a preview, and the link must still work for people who never see it.\n * `delay` (default 600ms) and `closeDelay` (default 300ms) tune how eagerly it opens and closes.\n */\nexport function HoverCardTrigger({ className, ...props }: BasePreviewCard.Trigger.Props) {\n  return (\n    <BasePreviewCard.Trigger\n      className={withBase(\n        cx(\n          \"rounded-sm font-medium text-zinc-950 underline decoration-zinc-950/25 underline-offset-[3px]\",\n          \"transition-[text-decoration-color] duration-150 ease-out motion-reduce:transition-none\",\n          \"hover:decoration-zinc-950/60 data-[popup-open]:decoration-zinc-950/60\",\n          \"dark:text-white dark:decoration-white/30 dark:hover:decoration-white/70 dark:data-[popup-open]:decoration-white/70\",\n          \"focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-sky-500\",\n        ),\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\ntype PositionerProps = BasePreviewCard.Positioner.Props;\n\nexport interface HoverCardContentProps extends BasePreviewCard.Popup.Props {\n  /** Side of the trigger to place the card on. Flips when there is not enough room. */\n  side?: PositionerProps[\"side\"];\n  /** Alignment against the trigger on the chosen side. */\n  align?: PositionerProps[\"align\"];\n  /** Gap between the trigger and the card, in pixels. */\n  sideOffset?: PositionerProps[\"sideOffset\"];\n  /** Shift along the trigger edge, in pixels. */\n  alignOffset?: PositionerProps[\"alignOffset\"];\n  /** Classes for the positioner wrapper, for example to change the z-index. */\n  positionerClassName?: string;\n  /** Element to portal into. Defaults to `document.body`. */\n  container?: BasePreviewCard.Portal.Props[\"container\"];\n}\n\n/**\n * The floating card, rendered in a portal and positioned against the trigger. The pointer can\n * travel from the link into the card without closing it, so links inside the card are reachable.\n */\nexport function HoverCardContent({\n  side = \"bottom\",\n  align = \"center\",\n  sideOffset = 8,\n  alignOffset = 0,\n  positionerClassName,\n  container,\n  className,\n  ...props\n}: HoverCardContentProps) {\n  return (\n    <BasePreviewCard.Portal container={container}>\n      <BasePreviewCard.Positioner\n        side={side}\n        align={align}\n        sideOffset={sideOffset}\n        alignOffset={alignOffset}\n        className={cx(\"z-50\", positionerClassName)}\n      >\n        <BasePreviewCard.Popup\n          className={withBase(\n            cx(\n              \"w-80 max-w-(--available-width) origin-(--transform-origin) rounded-xl p-4 text-sm\",\n              \"border border-zinc-950/10 bg-white text-zinc-950 shadow-[0_12px_32px_-8px_rgb(0_0_0/0.18)]\",\n              \"dark:border-white/15 dark:bg-black dark:text-white dark:shadow-[0_16px_48px_-12px_rgb(0_0_0/1),inset_0_1px_0_rgb(255_255_255/0.08)]\",\n              \"outline-none\",\n              // Enter: 160ms from 96% at the trigger, plus a 4px drift toward its side. Exit: 110ms fade.\n              \"transition-[opacity,scale,translate] duration-160 ease-[cubic-bezier(0.23,1,0.32,1)] motion-reduce:transition-none\",\n              \"data-[starting-style]:opacity-0 motion-safe:data-[starting-style]:scale-96\",\n              \"motion-safe:data-[side=bottom]:data-[starting-style]:-translate-y-1 motion-safe:data-[side=top]:data-[starting-style]:translate-y-1\",\n              \"motion-safe:data-[side=left]:data-[starting-style]:translate-x-1 motion-safe:data-[side=right]:data-[starting-style]:-translate-x-1\",\n              \"data-[ending-style]:opacity-0 data-[ending-style]:duration-110 data-[ending-style]:ease-out motion-safe:data-[ending-style]:scale-98\",\n            ),\n            className,\n          )}\n          {...props}\n        />\n      </BasePreviewCard.Positioner>\n    </BasePreviewCard.Portal>\n  );\n}\n\n/** The top row of a card: an avatar or mark next to a name and a secondary line. */\nexport function HoverCardHeader({ className, ...props }: ComponentProps<\"div\">) {\n  return <div className={cx(\"flex items-start gap-3\", className)} {...props} />;\n}\n\n/** A row of small facts at the bottom of a card, set off by a divider. */\nexport function HoverCardMeta({ className, ...props }: ComponentProps<\"div\">) {\n  return (\n    <div\n      className={cx(\n        \"-mx-4 mt-4 -mb-4 flex flex-wrap items-center gap-x-4 gap-y-1 border-t border-zinc-950/[0.07] px-4 py-3 text-xs text-zinc-500\",\n        \"dark:border-white/[0.08] [&_svg]:size-3.5 [&_svg]:shrink-0\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n"
    }
  ],
  "example": {
    "content": "import { HoverCard, HoverCardContent, HoverCardHeader, HoverCardMeta, HoverCardTrigger } from \"@/components/shaken/ui/hover-card\";\n\nconst icon = { \"aria-hidden\": true, viewBox: \"0 0 16 16\", fill: \"none\" } as const;\nconst stroke = { stroke: \"currentColor\", strokeWidth: 1.5, strokeLinecap: \"round\", strokeLinejoin: \"round\" } as const;\n\nexport default function HoverCardExample() {\n  return (\n    <p className=\"max-w-md text-center text-sm leading-7 text-zinc-600 dark:text-zinc-400\">\n      Rate limits per plan were reviewed by{\" \"}\n      <HoverCard>\n        <HoverCardTrigger href=\"#mira-okafor\">Mira Okafor</HoverCardTrigger>\n        <HoverCardContent>\n          <HoverCardHeader>\n            <span\n              aria-hidden=\"true\"\n              className=\"flex size-10 shrink-0 items-center justify-center rounded-full border border-zinc-950/10 text-sm font-medium text-zinc-700 dark:border-white/15 dark:text-zinc-300\"\n            >\n              MO\n            </span>\n            <div className=\"grid min-w-0 gap-0.5\">\n              <span className=\"font-semibold\">Mira Okafor</span>\n              <span className=\"text-xs text-zinc-500\">Staff engineer, Platform</span>\n            </div>\n          </HoverCardHeader>\n          <p className=\"mt-3 leading-relaxed text-zinc-600 dark:text-zinc-400\">\n            Owns the API gateway and billing limits. Usually reviews within a few hours, Lagos time.\n          </p>\n          <HoverCardMeta>\n            <span className=\"inline-flex items-center gap-1.5\">\n              <span aria-hidden=\"true\" className=\"size-1.5 rounded-full bg-emerald-500\" />\n              Available\n            </span>\n            <span className=\"font-mono tabular-nums\">38 reviews this month</span>\n          </HoverCardMeta>\n        </HoverCardContent>\n      </HoverCard>{\" \"}\n      and merged into{\" \"}\n      <HoverCard>\n        <HoverCardTrigger href=\"#agent-runtime\" className=\"font-mono text-[13px]\">\n          shaken/agent-runtime\n        </HoverCardTrigger>\n        <HoverCardContent align=\"start\">\n          <HoverCardHeader>\n            <span\n              aria-hidden=\"true\"\n              className=\"flex size-10 shrink-0 items-center justify-center rounded-lg border border-zinc-950/10 text-zinc-600 dark:border-white/15 dark:text-zinc-400\"\n            >\n              <svg {...icon} className=\"size-4\">\n                <path d=\"M3.5 2.5h7.25a1.75 1.75 0 0 1 1.75 1.75v9.25H5.25A1.75 1.75 0 0 1 3.5 11.75v-9.25Z\" {...stroke} />\n                <path d=\"M3.5 11.75A1.75 1.75 0 0 1 5.25 10h7.25\" {...stroke} />\n              </svg>\n            </span>\n            <div className=\"grid min-w-0 gap-0.5\">\n              <span className=\"truncate font-mono text-[13px] font-medium\">shaken/agent-runtime</span>\n              <span className=\"text-xs text-zinc-500\">Private repository</span>\n            </div>\n          </HoverCardHeader>\n          <p className=\"mt-3 leading-relaxed text-zinc-600 dark:text-zinc-400\">\n            Runs agent plans step by step, with approvals, retries, and a replayable trace.\n          </p>\n          <HoverCardMeta>\n            <span>TypeScript</span>\n            <span className=\"inline-flex items-center gap-1 font-mono tabular-nums\">\n              <svg {...icon}>\n                <path d=\"M8 2.25l1.7 3.6 3.8.5-2.8 2.65.7 3.85L8 11.05l-3.4 1.8.7-3.85L2.5 6.35l3.8-.5L8 2.25Z\" {...stroke} />\n              </svg>\n              1,284\n            </span>\n            <span>Updated 2 hours ago</span>\n          </HoverCardMeta>\n        </HoverCardContent>\n      </HoverCard>\n      .\n    </p>\n  );\n}\n"
  }
}
