{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "kbd",
  "title": "Kbd",
  "description": "Keyboard keys and combos in flat, raised 3D, outline, glass, neo and solid styles. Keycaps depress when the real keys are pressed, Mod maps to ⌘ or Ctrl, and onTrigger turns any combo or G-then-T sequence into a working hotkey.",
  "dependencies": [],
  "registryDependencies": [
    "https://goodui.dev/r/goodui-motion.json",
    "https://goodui.dev/r/locale.json"
  ],
  "files": [
    {
      "path": "registry/components/core/kbd.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { cn } from \"@/lib/utils\"\nimport { useLabels } from \"@/lib/goodui-locale\"\nimport { GooduiTokens } from \"@/lib/goodui-motion\"\n\n/*\n * Keyboard keys, independent layers: every axis combines with every other.\n *   variant    flat, raised (3D), outline, glass, neo, solid      tone     accent color\n *   size       xs → lg                                            shape    square, rounded, pill\n *   separator  plus, none, then                                   font     sans or mono\n *   animation  none · press (the keycap depresses when the real key goes down) · glow\n * Give it keys={[\"Mod\", \"K\"]} or keys=\"Mod+K\". \"Mod\" is ⌘ on Mac and Ctrl elsewhere.\n * onTrigger turns it into a hotkey: it fires when the whole combo is pressed.\n */\n\nexport type KbdVariant = \"flat\" | \"raised\" | \"outline\" | \"glass\" | \"neo\" | \"solid\"\nexport type KbdTone = \"primary\" | \"neutral\" | \"success\" | \"warning\" | \"danger\" | \"info\"\nexport type KbdSize = \"xs\" | \"sm\" | \"md\" | \"lg\"\nexport type KbdShape = \"square\" | \"rounded\" | \"pill\"\nexport type KbdSeparator = \"plus\" | \"none\" | \"then\"\nexport type KbdAnimation = \"none\" | \"press\" | \"glow\"\n\nexport type KbdProps = Omit<React.ComponentProps<\"kbd\">, \"children\"> & {\n  /** Keys of the combo: [\"Mod\", \"Shift\", \"P\"] or \"Mod+Shift+P\". */\n  keys?: string[] | string\n  /** Single key content, used when `keys` is not set. */\n  children?: React.ReactNode\n  /** Keycap style: flat, raised 3D (default), outline, glass, neo or solid. */\n  variant?: KbdVariant\n  /** Keycap accent color; neutral (default) keeps it gray. */\n  tone?: KbdTone\n  size?: KbdSize\n  shape?: KbdShape\n  /** Between keys: plus (a combo), none, or then (a sequence; onTrigger then waits for the keys in order). */\n  separator?: KbdSeparator\n  /** Keycap font; mono uses --font-mono. */\n  font?: \"sans\" | \"mono\"\n  /** Show ⌘ ⇧ ⌥ ↵ ⌫ arrows instead of words. */\n  symbols?: boolean\n  /** press depresses a keycap while its real key is held; glow adds a tone glow. none adds no key listeners. */\n  animation?: KbdAnimation\n  /** Fires when every key of the combo is down (or, with separator=\"then\", when the sequence is typed). */\n  onTrigger?: (e: KeyboardEvent) => void\n  /** Prevent the browser default when onTrigger fires (e.g. Ctrl+K focusing the address bar). */\n  preventDefault?: boolean\n  /** Fire in text fields too. By default combos without Mod/Ctrl/Cmd/Alt are ignored while typing. */\n  allowInInputs?: boolean\n  /** Text for built-in controls and screen readers; pass translations here. */\n  labels?: Partial<KbdLabels>\n}\n\nexport type KbdLabels = {\n  /** Separator text when separator=\"then\". */\n  then: string\n  /** Screen-reader name of a special key, given its English name (\"Command\", \"Up arrow\", \"Escape\"…). */\n  keyName: (name: string) => string\n}\nconst DEFAULT_LABELS: KbdLabels = { then: \"then\", keyName: (name) => name }\n\nconst CSS = `\n.pc-kbd{--pc-c:var(--primary);--pc-fg:var(--primary-foreground)}\n.pc-kbd[data-tone=neutral]{--pc-c:var(--foreground);--pc-fg:var(--background)}\n.pc-kbd[data-tone=success]{--pc-c:oklch(0.53 0.13 155);--pc-fg:#fff}\n.pc-kbd[data-tone=warning]{--pc-c:oklch(0.75 0.16 70);--pc-fg:oklch(0.25 0.05 70)}\n.pc-kbd[data-tone=danger]{--pc-c:oklch(0.56 0.21 27);--pc-fg:#fff}\n.pc-kbd[data-tone=info]{--pc-c:oklch(0.55 0.17 250);--pc-fg:#fff}\n.dark .pc-kbd[data-tone=success]{--pc-c:oklch(0.7 0.16 155);--pc-fg:oklch(0.2 0.05 155)}\n.dark .pc-kbd[data-tone=danger]{--pc-c:oklch(0.68 0.2 25);--pc-fg:oklch(0.2 0.05 25)}\n.dark .pc-kbd[data-tone=info]{--pc-c:oklch(0.7 0.15 245);--pc-fg:oklch(0.2 0.05 245)}\n.pc-kbd{--pc-tint:color-mix(in oklab,var(--pc-c) 14%,transparent);--pc-ink:color-mix(in oklab,var(--pc-c) 82%,var(--foreground))}\n.pc-kbd[data-tone=warning]{--pc-ink:color-mix(in oklab,var(--pc-c) 62%,var(--foreground))}\n.pc-kbd[data-tone=neutral]{--pc-ink:var(--foreground)}\n\n.pc-kbd-key{position:relative;font-family:inherit;color:var(--pc-ink);line-height:1;transition:transform 100ms var(--pc-ease-out),box-shadow 100ms var(--pc-ease-out),background-color 150ms ease,border-color 150ms ease}\n.pc-kbd[data-tone=neutral] .pc-kbd-key{color:color-mix(in oklab,var(--foreground) 80%,var(--muted-foreground))}\n.pc-kbd[data-font=mono] .pc-kbd-key{font-family:var(--font-mono,ui-monospace,SFMono-Regular,Menlo,Consolas,monospace)}\n.pc-kbd[data-variant=flat] .pc-kbd-key{background:color-mix(in oklab,var(--pc-c) 9%,var(--muted))}\n.pc-kbd[data-variant=flat][data-tone=neutral] .pc-kbd-key{background:var(--muted)}\n.pc-kbd[data-variant=flat] .pc-kbd-key[data-pressed]{background:color-mix(in oklab,var(--pc-c) 22%,var(--muted));transform:scale(.92)}\n/* A real keycap: lit from above, a 2px skirt below, and the key travels the full 2px into it. */\n.pc-kbd[data-variant=raised] .pc-kbd-key{--pc-rimlit:rgb(255 255 255/.9);--pc-edge:color-mix(in oklab,var(--pc-c) 16%,color-mix(in oklab,var(--foreground) 16%,var(--background)));--pc-skirt:color-mix(in oklab,var(--pc-edge) 86%,var(--foreground));background:linear-gradient(to bottom,var(--background),color-mix(in oklab,var(--pc-c) 4%,var(--muted)));border:1px solid var(--pc-edge);box-shadow:inset 0 1px var(--pc-rimlit),0 2px 0 var(--pc-skirt),0 3px 5px -1px hsl(var(--pc-sh)/.2);transform:translateY(-1px)}\n.dark .pc-kbd[data-variant=raised] .pc-kbd-key{--pc-rimlit:rgb(255 255 255/.16);--pc-edge:rgb(0 0 0/.7);--pc-skirt:oklch(0.12 0 0);background:linear-gradient(to bottom,oklch(0.33 0 0),oklch(0.25 0 0));box-shadow:inset 0 1px var(--pc-rimlit),0 2px 0 var(--pc-skirt),0 4px 6px -1px rgb(0 0 0/.5)}\n.pc-kbd[data-variant=raised] .pc-kbd-key:is([data-pressed],:active){transform:translateY(1px);box-shadow:inset 0 1px var(--pc-rimlit),0 0 0 var(--pc-skirt),0 0 1px hsl(var(--pc-sh)/.2)}\n.dark .pc-kbd[data-variant=raised] .pc-kbd-key:is([data-pressed],:active){box-shadow:inset 0 1px var(--pc-rimlit),0 0 0 var(--pc-skirt),0 0 1px rgb(0 0 0/.5)}\n.pc-kbd[data-variant=outline] .pc-kbd-key{border:1px solid color-mix(in oklab,var(--pc-c) 30%,var(--border));background:transparent}\n.pc-kbd[data-variant=outline][data-tone=neutral] .pc-kbd-key{border-color:var(--border)}\n.pc-kbd[data-variant=outline] .pc-kbd-key[data-pressed]{background:var(--pc-tint);transform:scale(.92)}\n.pc-kbd[data-variant=glass] .pc-kbd-key{color:var(--foreground);background:color-mix(in oklab,var(--background) 45%,transparent);border:1px solid color-mix(in oklab,var(--foreground) 14%,transparent);-webkit-backdrop-filter:blur(12px) saturate(1.6);backdrop-filter:blur(12px) saturate(1.6);box-shadow:inset 0 1px 0 color-mix(in oklab,white 45%,transparent),0 2px 6px -2px rgb(0 0 0/.15)}\n.pc-kbd[data-variant=glass] .pc-kbd-key[data-pressed]{transform:scale(.92);background:color-mix(in oklab,var(--background) 65%,transparent)}\n.pc-kbd[data-variant=neo] .pc-kbd-key{color:var(--foreground);background:color-mix(in oklab,var(--pc-c) 16%,var(--background));border:1.5px solid var(--foreground);box-shadow:2px 2px 0 var(--foreground)}\n.pc-kbd[data-variant=neo][data-tone=neutral] .pc-kbd-key{background:var(--background)}\n.pc-kbd[data-variant=neo] .pc-kbd-key[data-pressed]{transform:translate(2px,2px);box-shadow:0 0 0 var(--foreground)}\n.pc-kbd[data-variant=solid] .pc-kbd-key{color:var(--pc-fg);background-color:var(--pc-c);background-image:var(--pc-sheen);box-shadow:inset 0 1px var(--pc-edge-t),0 2px 0 color-mix(in oklab,var(--pc-c) 55%,black),0 3px 5px -1px hsl(var(--pc-sh)/.25);transform:translateY(-1px)}\n.pc-kbd[data-variant=solid] .pc-kbd-key:is([data-pressed],:active){transform:translateY(1px);box-shadow:inset 0 1px var(--pc-edge-t),0 0 0 color-mix(in oklab,var(--pc-c) 55%,black)}\n.pc-kbd[data-anim=glow] .pc-kbd-key[data-pressed]{box-shadow:0 0 0 3px color-mix(in oklab,var(--pc-c) 30%,transparent),0 0 18px -2px color-mix(in oklab,var(--pc-c) 70%,transparent)}\n.pc-kbd[data-anim=none] .pc-kbd-key{transition:none}\n.pc-kbd-sep{color:var(--muted-foreground);font-size:.85em}\n@media (prefers-reduced-motion:reduce){\n  .pc-kbd-key{transition:background-color .15s!important}\n  .pc-kbd .pc-kbd-key:is([data-pressed],:active){transform:none}\n}\n`\n\nconst SIZES: Record<KbdSize, string> = {\n  xs: \"h-5 min-w-5 px-1 text-[10px] rounded-[4px]\",\n  sm: \"h-6 min-w-6 px-1.5 text-[11px] rounded-[5px]\",\n  md: \"h-7 min-w-7 px-2 text-xs rounded-md\",\n  lg: \"h-9 min-w-9 px-2.5 text-sm rounded-lg\",\n}\nconst GAPS: Record<KbdSize, string> = { xs: \"gap-0.5\", sm: \"gap-1\", md: \"gap-1\", lg: \"gap-1.5\" }\n\n// [symbol, word, aria name]\nconst NAMED: Record<string, [string, string, string]> = {\n  cmd: [\"⌘\", \"Cmd\", \"Command\"],\n  command: [\"⌘\", \"Cmd\", \"Command\"],\n  meta: [\"⌘\", \"Cmd\", \"Command\"],\n  win: [\"⊞\", \"Win\", \"Windows\"],\n  ctrl: [\"Ctrl\", \"Ctrl\", \"Control\"],\n  control: [\"Ctrl\", \"Ctrl\", \"Control\"],\n  shift: [\"⇧\", \"Shift\", \"Shift\"],\n  alt: [\"⌥\", \"Alt\", \"Alt\"],\n  option: [\"⌥\", \"Option\", \"Option\"],\n  opt: [\"⌥\", \"Option\", \"Option\"],\n  enter: [\"↵\", \"Enter\", \"Enter\"],\n  return: [\"↵\", \"Return\", \"Return\"],\n  backspace: [\"⌫\", \"Backspace\", \"Backspace\"],\n  delete: [\"⌦\", \"Del\", \"Delete\"],\n  del: [\"⌦\", \"Del\", \"Delete\"],\n  esc: [\"Esc\", \"Esc\", \"Escape\"],\n  escape: [\"Esc\", \"Esc\", \"Escape\"],\n  tab: [\"⇥\", \"Tab\", \"Tab\"],\n  space: [\"Space\", \"Space\", \"Space\"],\n  up: [\"↑\", \"Up\", \"Up arrow\"],\n  down: [\"↓\", \"Down\", \"Down arrow\"],\n  left: [\"←\", \"Left\", \"Left arrow\"],\n  right: [\"→\", \"Right\", \"Right arrow\"],\n  arrowup: [\"↑\", \"Up\", \"Up arrow\"],\n  arrowdown: [\"↓\", \"Down\", \"Down arrow\"],\n  arrowleft: [\"←\", \"Left\", \"Left arrow\"],\n  arrowright: [\"→\", \"Right\", \"Right arrow\"],\n  pageup: [\"PgUp\", \"PgUp\", \"Page up\"],\n  pagedown: [\"PgDn\", \"PgDn\", \"Page down\"],\n  capslock: [\"⇪\", \"Caps\", \"Caps lock\"],\n}\nconst EVENT_KEY: Record<string, string> = {\n  cmd: \"Meta\",\n  command: \"Meta\",\n  meta: \"Meta\",\n  win: \"Meta\",\n  ctrl: \"Control\",\n  control: \"Control\",\n  shift: \"Shift\",\n  alt: \"Alt\",\n  option: \"Alt\",\n  opt: \"Alt\",\n  enter: \"Enter\",\n  return: \"Enter\",\n  backspace: \"Backspace\",\n  delete: \"Delete\",\n  del: \"Delete\",\n  esc: \"Escape\",\n  escape: \"Escape\",\n  tab: \"Tab\",\n  space: \" \",\n  up: \"ArrowUp\",\n  down: \"ArrowDown\",\n  left: \"ArrowLeft\",\n  right: \"ArrowRight\",\n  pageup: \"PageUp\",\n  pagedown: \"PageDown\",\n  capslock: \"CapsLock\",\n}\nconst MODIFIERS = new Set([\"Meta\", \"Control\", \"Shift\", \"Alt\"])\n\nfunction toKeys(keys: KbdProps[\"keys\"]): string[] {\n  if (!keys) return []\n  if (Array.isArray(keys)) return keys\n  // \"Mod+K\", \"Mod + K\", and \"Ctrl++\" (the plus key) all work.\n  return keys\n    .split(/\\s*\\+\\s*(?=.)/)\n    .map((k) => k.trim() || \"+\")\n    .filter(Boolean)\n}\n\nfunction label(key: string, mac: boolean, symbols: boolean): [string, string] {\n  const k = key.toLowerCase()\n  const n = NAMED[k]\n  if (k === \"mod\") return mac ? (symbols ? [\"⌘\", \"Command\"] : [\"Cmd\", \"Command\"]) : [\"Ctrl\", \"Control\"]\n  if ((k === \"ctrl\" || k === \"control\") && mac && symbols) return [\"⌃\", \"Control\"]\n  if ((k === \"alt\" || k === \"option\" || k === \"opt\") && !mac) return [\"Alt\", \"Alt\"]\n  if (n && (k === \"shift\" || k === \"enter\" || k === \"return\" || k === \"backspace\" || k === \"tab\") && !symbols) return [n[1], n[2]]\n  if (n) return [symbols ? n[0] : n[1], n[2]]\n  return [key.length === 1 ? key.toUpperCase() : key, key]\n}\n\nfunction matches(key: string, e: KeyboardEvent, mac: boolean) {\n  const k = key.toLowerCase()\n  const want = k === \"mod\" ? (mac ? \"Meta\" : \"Control\") : EVENT_KEY[k]\n  if (want) return e.key === want\n  if (e.key.toLowerCase() === k) return true\n  // Shifted / layout-dependent characters: fall back to the physical key.\n  return e.code.toLowerCase() === \"key\" + k || e.code.toLowerCase() === \"digit\" + k\n}\n\nexport function Kbd({\n  keys,\n  children,\n  variant = \"raised\",\n  tone = \"neutral\",\n  size = \"sm\",\n  shape = \"rounded\",\n  separator = \"plus\",\n  font = \"sans\",\n  symbols = true,\n  animation = \"press\",\n  onTrigger,\n  preventDefault = true,\n  allowInInputs = false,\n  labels,\n  className,\n  ...props\n}: KbdProps) {\n  const l = useLabels(\"kbd\", DEFAULT_LABELS, labels)\n  const list = React.useMemo(() => toKeys(keys), [keys])\n  const items: string[] = list.length ? list : typeof children === \"string\" ? [children] : []\n  const [mac, setMac] = React.useState(false)\n  const [pressed, setPressed] = React.useState<boolean[]>([])\n  const trigger = React.useRef(onTrigger)\n  React.useEffect(() => {\n    trigger.current = onTrigger\n  })\n\n  React.useEffect(() => {\n    const nav = navigator as Navigator & { userAgentData?: { platform?: string } }\n    setMac(/mac|iphone|ipad|ipod/i.test(nav.userAgentData?.platform || nav.platform || nav.userAgent))\n  }, [])\n\n  const listen = animation !== \"none\" || !!onTrigger\n  const seq = separator === \"then\"\n  const itemsKey = items.join(\"\\u0000\")\n  React.useEffect(() => {\n    if (!listen || !itemsKey) return\n    const ks = itemsKey.split(\"\\u0000\")\n    const down = new Array(ks.length).fill(false)\n    const sync = () => setPressed([...down])\n    // \"then\" combos are sequences (G then D): each key must follow the previous within 1.2s.\n    let step = 0\n    let stepAt = 0\n    const sequence = (e: KeyboardEvent) => {\n      if (MODIFIERS.has(e.key) || e.repeat) return\n      if (e.timeStamp - stepAt > 1200) step = 0\n      step = matches(ks[step]!, e, mac) ? step + 1 : matches(ks[0]!, e, mac) ? 1 : 0\n      stepAt = e.timeStamp\n      if (step === ks.length) {\n        step = 0\n        if (trigger.current) {\n          if (preventDefault) e.preventDefault()\n          trigger.current(e)\n        }\n      }\n    }\n    const chorded = ks.some((k) => /^(mod|cmd|command|meta|ctrl|control|alt|option|opt|win)$/i.test(k))\n    const typing = (e: KeyboardEvent) => {\n      const t = e.target as HTMLElement | null\n      return !!t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName))\n    }\n    const onDown = (e: KeyboardEvent) => {\n      if (!allowInInputs && !chorded && typing(e)) return\n      if (seq) sequence(e)\n      let hit = false\n      ks.forEach((k, i) => {\n        if (matches(k, e, mac)) {\n          down[i] = true\n          hit = true\n        }\n      })\n      if (!hit) return\n      sync()\n      if (!seq && trigger.current && down.every(Boolean) && !e.repeat) {\n        if (preventDefault) e.preventDefault()\n        trigger.current(e)\n      }\n    }\n    const onUp = (e: KeyboardEvent) => {\n      // On macOS, keyup of other keys is swallowed while ⌘ is held, so releasing a modifier releases everything.\n      if (MODIFIERS.has(e.key)) down.fill(false)\n      else ks.forEach((k, i) => matches(k, e, mac) && (down[i] = false))\n      sync()\n    }\n    const reset = () => {\n      down.fill(false)\n      sync()\n    }\n    window.addEventListener(\"keydown\", onDown)\n    window.addEventListener(\"keyup\", onUp)\n    window.addEventListener(\"blur\", reset)\n    return () => {\n      window.removeEventListener(\"keydown\", onDown)\n      window.removeEventListener(\"keyup\", onUp)\n      window.removeEventListener(\"blur\", reset)\n    }\n  }, [listen, itemsKey, mac, preventDefault, seq, allowInInputs])\n\n  const cap = (content: React.ReactNode, i: number, name?: string) => (\n    <kbd\n      key={i}\n      data-slot=\"key\"\n      data-pressed={animation !== \"none\" && pressed[i] ? \"\" : undefined}\n      className={cn(\"pc-kbd-key inline-flex select-none items-center justify-center font-medium whitespace-nowrap\", SIZES[size], shape === \"square\" && \"rounded-none\", shape === \"pill\" && \"rounded-full px-[0.6em]\")}\n    >\n      {name ? (\n        <>\n          <span aria-hidden=\"true\">{content}</span>\n          <span className=\"sr-only\">{name}</span>\n        </>\n      ) : (\n        content\n      )}\n    </kbd>\n  )\n\n  return (\n    <>\n      <GooduiTokens />\n      <style href=\"pc-kbd\" precedence=\"default\">\n        {CSS}\n      </style>\n      <kbd\n        data-slot=\"kbd\"\n        data-variant={variant}\n        data-tone={tone}\n        data-font={font}\n        data-anim={animation}\n        className={cn(\"pc-kbd inline-flex items-center align-middle font-sans\", GAPS[size], className)}\n        {...props}\n      >\n        {items.length\n          ? items.map((k, i) => {\n              const [text, name] = label(k, mac, symbols)\n              return (\n                <React.Fragment key={i}>\n                  {i > 0 && separator !== \"none\" && (\n                    <span className=\"pc-kbd-sep px-px\" aria-hidden=\"true\">\n                      {separator === \"then\" ? l.then : \"+\"}\n                    </span>\n                  )}\n                  {cap(/^[⌘⌃⇧⌥↵⌫⌦⇥⇪↑↓←→⊞]$/.test(text) ? <span className=\"text-[1.25em] leading-none\">{text}</span> : text, i, text !== name ? l.keyName(name) : undefined)}\n                </React.Fragment>\n              )\n            })\n          : cap(children, 0)}\n      </kbd>\n    </>\n  )\n}\n",
      "type": "registry:component",
      "target": "components/goodui/kbd.tsx"
    }
  ],
  "categories": [
    "components",
    "core"
  ],
  "type": "registry:component"
}