{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "hover-card",
  "title": "Hover card",
  "description": "A link that previews its destination (Base UI Preview Card): the underline draws along its keyline during the open delay; the card is a control frame of cells (media, title, code, facts on seams) one gutter from the link. Supplementary content only.",
  "dependencies": [
    "@base-ui/react@1.9.0"
  ],
  "registryDependencies": [
    "@keyline-ui/keyline",
    "utils",
    "@keyline-ui/keyline-scope",
    "@keyline-ui/keyline-render"
  ],
  "files": [
    {
      "path": "src/registry/keyline/ui/hover-card.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { PreviewCard as PreviewCardPrimitive } from \"@base-ui/react/preview-card\";\nimport { mergeProps } from \"@base-ui/react/merge-props\";\nimport { useRender } from \"@base-ui/react/use-render\";\n\nimport { cn } from \"@/lib/utils\";\nimport { scopeProps, useKeylineScope } from \"../lib/keyline-scope\";\nimport { resolveClassName, resolveStyle, type PartProps } from \"../lib/keyline-render\";\n\n/* Root is Base UI's PreviewCard.Root: controlled or uncontrolled `open`, `onOpenChange`, `actionsRef`,\n   `handle` (one card for many triggers) and the payload render function all pass through untouched. */\nconst HoverCardRoot = PreviewCardPrimitive.Root;\nconst HoverCard = HoverCardRoot;\n/** A handle shares one card between many triggers (a column of names): `PreviewCard.createHandle()` in Base UI. */\nconst createHoverCardHandle = PreviewCardPrimitive.createHandle;\n\n/*\n * The trigger is a link whose underline is a keyline: 1px at rest, and while the open delay runs a 2px ink keyline\n * draws over it from the reading start, timed to the delay (linear, so its position IS the time left). Leaving early\n * retracts it quickly. Open, it stays drawn. Reduced motion: no drawing (--kl-hc-draw is 0%), it appears with the card.\n */\nconst trigger = cn(\n  \"cursor-pointer box-decoration-clone pb-0.5 font-(--kl-weight-strong) text-inherit no-underline\",\n  \"bg-[linear-gradient(currentColor,currentColor),linear-gradient(var(--kl-ink-3),var(--kl-ink-3))] bg-no-repeat\",\n  \"[background-position:0_100%,0_100%] kl-rtl:[background-position:100%_100%,100%_100%]\",\n  \"[background-size:0%_2px,100%_1px] transition-[background-size] duration-(--kl-t-fold) ease-(--kl-ease-in)\",\n  \"hover:duration-[var(--kl-hc-delay,600ms)] hover:ease-linear hover:not-data-popup-open:[background-size:var(--kl-hc-draw,100%)_2px,100%_1px]\",\n  \"focus-visible:duration-[var(--kl-hc-delay,600ms)] focus-visible:ease-linear focus-visible:not-data-popup-open:[background-size:var(--kl-hc-draw,100%)_2px,100%_1px]\",\n  \"data-popup-open:[background-size:100%_2px,100%_1px] data-popup-open:transition-none\",\n  \"motion-reduce:transition-none motion-reduce:[--kl-hc-draw:0%]\",\n  \"in-data-[kl-motion=reduce]:transition-none in-data-[kl-motion=reduce]:[--kl-hc-draw:0%]\",\n  \"focus-visible:outline-(length:--kl-ring) focus-visible:outline-offset-2 focus-visible:outline-kl-focus focus-visible:outline-solid\",\n  \"forced-colors:bg-none forced-colors:underline\",\n);\n\n/**\n * The link being previewed. It stays an ordinary link: a press goes to `href` (the place with everything\n * the card shows), keyboard focus also opens the card, and on touch the card never opens. While the open\n * delay runs, its underline draws along the keyline from the reading start, so the wait reads as \"a preview\n * is coming\", not as lag; leaving early retracts it. Open, the underline is a full ink 2px keyline.\n */\nfunction HoverCardTrigger({\n  className,\n  delay = 600,\n  closeDelay = 300,\n  style,\n  ...props\n}: PreviewCardPrimitive.Trigger.Props): React.ReactElement {\n  return (\n    <PreviewCardPrimitive.Trigger\n      delay={delay}\n      closeDelay={closeDelay}\n      className={resolveClassName(trigger, className)}\n      style={resolveStyle({ \"--kl-hc-delay\": `${delay}ms` } as React.CSSProperties, style)}\n      {...props}\n      data-slot=\"hover-card-trigger\"\n    />\n  );\n}\n\n/*\n * THE CARD: a control frame (2px, the control cut) with rows of cells on seams, and the size container of its facts.\n * ENTRY: where the cut is a corner shape (Chromium) the card unfolds from the edge that faces the link (clip-path,\n * the Unfold behaviour). Elsewhere clip-path IS the cut, so the card fades instead; a clip-path transition there would\n * erase the corner. A closing card ignores the pointer.\n */\nconst card = cn(\n  \"kl-ctl @container flex max-h-(--available-height) w-[min(320px,calc(100vw-24px))] flex-col overflow-auto\",\n  \"bg-kl-cell font-(family-name:--kl-font) text-(length:--kl-text-body) text-kl-ink outline-0\",\n  \"[&>*+*]:border-t-(length:--kl-k1) [&>*+*]:border-t-kl-seam\",\n  \"transition-opacity duration-(--kl-t-unfold) ease-linear\",\n  \"data-ending-style:pointer-events-none data-ending-style:duration-(--kl-t-fold)\",\n  \"not-supports-[corner-start-start-shape:bevel]:data-starting-style:opacity-0\",\n  \"not-supports-[corner-start-start-shape:bevel]:data-ending-style:opacity-0\",\n  \"supports-[corner-start-start-shape:bevel]:transition-[clip-path] supports-[corner-start-start-shape:bevel]:[clip-path:inset(-4px)]\",\n  \"supports-[corner-start-start-shape:bevel]:ease-(--kl-ease-out) supports-[corner-start-start-shape:bevel]:data-ending-style:ease-(--kl-ease-in)\",\n  \"supports-[corner-start-start-shape:bevel]:[&:is([data-starting-style],[data-ending-style])[data-side=bottom]]:[clip-path:inset(0_0_100%_0)]\",\n  \"supports-[corner-start-start-shape:bevel]:[&:is([data-starting-style],[data-ending-style])[data-side=top]]:[clip-path:inset(100%_0_0_0)]\",\n  \"supports-[corner-start-start-shape:bevel]:[&:is([data-starting-style],[data-ending-style]):is([data-side=right],[data-side=inline-end])]:[clip-path:inset(0_100%_0_0)]\",\n  \"supports-[corner-start-start-shape:bevel]:[&:is([data-starting-style],[data-ending-style]):is([data-side=left],[data-side=inline-start])]:[clip-path:inset(0_0_0_100%)]\",\n);\n\ntype PositionerProps = PreviewCardPrimitive.Positioner.Props;\n\ntype HoverCardPopupProps = PreviewCardPrimitive.Popup.Props &\n  Pick<PositionerProps, \"anchor\" | \"side\" | \"align\" | \"sideOffset\" | \"alignOffset\" | \"collisionPadding\"> & {\n    /** Where the portal renders (defaults to <body>). */\n    container?: PreviewCardPrimitive.Portal.Props[\"container\"];\n    /** Props for Base UI's PreviewCard.Portal. */\n    portalProps?: Omit<PreviewCardPrimitive.Portal.Props, \"container\" | \"children\">;\n  };\n\n/**\n * The preview: Base UI's Portal, Positioner and Popup in one part, with the positioner's placement props lifted. A\n * control frame one gutter from the link (a card about a word in running text is not docked to it; a frame cannot\n * share an edge with an underline). It unfolds from the side that faces the link, carries the configuration of the\n * place it is written, and lifts to the overlay surface. Supplementary only: Base UI keeps it out of the keyboard and\n * screen-reader order, so put nothing in it that isn't also at the link's destination, and no controls.\n */\nfunction HoverCardPopup({\n  anchor,\n  side = \"bottom\",\n  align = \"start\",\n  sideOffset = 8,\n  alignOffset,\n  collisionPadding = 12,\n  container,\n  portalProps,\n  className,\n  ...props\n}: HoverCardPopupProps): React.ReactElement {\n  const [marker, scope, probe] = useKeylineScope(false, container);\n  return (\n    <>\n      {marker}\n      <PreviewCardPrimitive.Portal container={container} {...portalProps}>\n        {probe}\n        <PreviewCardPrimitive.Positioner\n          anchor={anchor}\n          side={side}\n          align={align}\n          sideOffset={sideOffset}\n          alignOffset={alignOffset}\n          collisionPadding={collisionPadding}\n          {...scopeProps(scope, { className: \"kl-positioner\" })}\n        >\n          <PreviewCardPrimitive.Popup\n            className={resolveClassName(card, className)}\n            {...props}\n            data-slot=\"hover-card-popup\"\n          />\n        </PreviewCardPrimitive.Positioner>\n      </PreviewCardPrimitive.Portal>\n    </>\n  );\n}\n\ntype PartState = Record<string, never>;\nconst PART_STATE: PartState = {};\n\ntype HoverCardHeaderProps = Omit<PartProps<\"div\", PartState>, \"title\"> & {\n  /** A square leading cell: an Avatar with layout=\"cell\", a logo, a 16px glyph or a code. */\n  media?: React.ReactNode;\n  title: React.ReactNode;\n  /** One line under the title in the UI voice: a role, a place. */\n  description?: React.ReactNode;\n  /** A trailing cell in the Code voice: the record's ID, a handle. */\n  code?: React.ReactNode;\n};\n\n/** The card's top row of cells: media · title and description · code. Long titles wrap; the code cell keeps its width. */\nfunction HoverCardHeader({\n  media,\n  title,\n  description,\n  code,\n  render,\n  className,\n  style,\n  ...props\n}: HoverCardHeaderProps): React.ReactElement {\n  const own = {\n    \"data-slot\": \"hover-card-header\",\n    className: resolveClassName(\n      cn(\n        \"kl-cells min-h-14 flex-none [&>:not(:first-child)]:border-s-kl-seam\",\n        // the cut takes the corner: the first cell steps clear of it (like Popover's header); a media cell widens instead\n        \"[&>:first-child:not([data-slot=hover-card-media])]:ms-[calc(var(--kl-c,0px)*0.35)]\",\n      ),\n      className,\n    )(PART_STATE),\n    style: resolveStyle(undefined, style)(PART_STATE),\n    children: (\n      <>\n        {media != null ? (\n          <span\n            data-slot=\"hover-card-media\"\n            className={cn(\n              \"box-border grid min-h-14 w-[calc(56px+var(--kl-c,0px)*0.35)] flex-none place-items-center ps-[calc(var(--kl-c,0px)*0.35)]\",\n              \"font-(family-name:--kl-font-mono) text-(length:--kl-text-label)/none font-(--kl-weight-strong) text-kl-ink-2 not-italic normal-nums\",\n            )}\n          >\n            {media}\n          </span>\n        ) : null}\n        <span className=\"grid min-w-0 flex-[1_1_auto] content-center gap-0.5 px-(--kl-inset) py-2\">\n          <span\n            data-slot=\"hover-card-title\"\n            className=\"text-(length:--kl-text-lead)/[1.25] font-(--kl-weight-strong) wrap-anywhere\"\n          >\n            {title}\n          </span>\n          {description != null ? (\n            <span\n              data-slot=\"hover-card-description\"\n              className=\"text-(length:--kl-text-label)/[1.3] wrap-anywhere text-kl-ink-2\"\n            >\n              {description}\n            </span>\n          ) : null}\n        </span>\n        {code != null ? (\n          <span data-slot=\"hover-card-code\" className=\"kl-code grid flex-none place-items-center px-2.5\">\n            {code}\n          </span>\n        ) : null}\n      </>\n    ),\n  };\n  return useRender({ defaultTagName: \"div\", render, state: PART_STATE, props: mergeProps<\"div\">(props, own) });\n}\n\ntype HoverCardFactsProps = Omit<PartProps<\"dl\", PartState>, \"children\"> & {\n  /** [term, value] pairs, two to a row on shared seams; an odd last fact spans the row. */\n  facts: ReadonlyArray<readonly [React.ReactNode, React.ReactNode]>;\n};\n\n/** Key facts as a grid of cells (a description list): the term small, the value in the UI voice. A narrow card\n * (long words in a small viewport) sets them in one column. */\nfunction HoverCardFacts({ facts, render, className, style, ...props }: HoverCardFactsProps): React.ReactElement {\n  const own = {\n    \"data-slot\": \"hover-card-facts\",\n    className: resolveClassName(\n      \"m-0 grid grid-cols-[repeat(2,minmax(0,1fr))] [@container_(max-width:240px)]:grid-cols-[minmax(0,1fr)]\",\n      className,\n    )(PART_STATE),\n    style: resolveStyle(undefined, style)(PART_STATE),\n    children: facts.map(([k, v], i) => (\n      <div\n        key={i}\n        data-slot=\"hover-card-fact\"\n        className={cn(\n          \"grid min-w-0 content-start gap-0.5 px-(--kl-inset) py-2\",\n          \"even:border-s-(length:--kl-k1) even:border-s-kl-seam nth-[n+3]:border-t-(length:--kl-k1) nth-[n+3]:border-t-kl-seam\",\n          \"last:odd:col-span-full\",\n        )}\n      >\n        <dt className=\"text-(length:--kl-text-meta) text-kl-ink-2\">{k}</dt>\n        <dd className=\"m-0 font-(--kl-weight-strong) wrap-anywhere tabular-nums\">{v}</dd>\n      </div>\n    )),\n  };\n  return useRender({ defaultTagName: \"dl\", render, state: PART_STATE, props: mergeProps<\"dl\">(props, own) });\n}\n\n/** Free content (a sentence, a Status, a Meter) in its own cell row. */\nfunction HoverCardBody({ render, className, style, ...props }: PartProps<\"div\", PartState>): React.ReactElement {\n  const own = {\n    \"data-slot\": \"hover-card-body\",\n    className: resolveClassName(\n      \"px-(--kl-inset) py-2.5 text-(length:--kl-text-label)/[1.45] text-kl-ink-2\",\n      className,\n    )(PART_STATE),\n    style: resolveStyle(undefined, style)(PART_STATE),\n  };\n  return useRender({ defaultTagName: \"div\", render, state: PART_STATE, props: mergeProps<\"div\">(props, own) });\n}\n\nexport {\n  HoverCard,\n  HoverCardRoot,\n  HoverCardTrigger,\n  HoverCardPopup,\n  HoverCardHeader,\n  HoverCardFacts,\n  HoverCardBody,\n  createHoverCardHandle,\n};\n",
      "type": "registry:ui",
      "target": "components/keyline/ui/hover-card.tsx"
    }
  ],
  "type": "registry:ui"
}