{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "vintage-command-palette",
  "title": "Vintage Command Palette",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Paleta de comandos no vocabulário do painel.",
  "registryDependencies": [
    "@visant/vintage-theme",
    "utils"
  ],
  "files": [
    {
      "path": "registry/vintage/ui/vintage-command-palette.tsx",
      "content": "\"use client\";\n\nimport { useState, useEffect, useRef, useCallback } from \"react\";\nimport { cn } from \"@/lib/utils\";\n\nexport interface CommandItem {\n  id: string;\n  label: string;\n  icon?: string;\n  group?: string;\n  active?: boolean;\n  description?: string;\n}\n\nexport interface CommandGroup {\n  label: string;\n  ids: string[];\n}\n\n/**\n * VintageCommandPalette — a paleta de comandos no vocabulário do painel.\n *\n * O que estava quebrado, e por quê (\"mt pequeno e não dá pra clicar\"):\n *\n * 1. **A linha era um `<div onClick>`.** Div não recebe foco, não responde a\n *    Enter, não aparece pro leitor de tela e não tem estado pressionado. A\n *    navegação por seta existia, mas quem tentasse chegar na lista pelo Tab\n *    caía direto no fim do documento. Agora cada linha é `<button>` dentro de um\n *    `listbox`, com `aria-selected` seguindo a seta.\n * 2. **A linha tinha ~40px de altura.** O piso de alvo de toque é 44. Quarenta\n *    px é o tamanho em que o dedo erra a linha vizinha — e errar comando é pior\n *    do que não achar.\n * 3. **O painel tinha 480px CRAVADOS.** Num celular de 390 ele sangrava 45px de\n *    cada lado: metade do rótulo e o selo de ON/OFF ficavam fora da tela. Agora\n *    é `min(480px, 100vw - 2rem)`.\n * 4. **A seta andava mas a lista não.** Descer além da dobra selecionava um item\n *    invisível. O item selecionado agora se traz pra vista.\n *\n * O `backdrop-blur` fica: isto é diálogo modal, que é a exceção da regra.\n */\ninterface VintageCommandPaletteProps {\n  items: CommandItem[];\n  groups?: CommandGroup[];\n  onSelect: (id: string) => void;\n  onClose: () => void;\n  placeholder?: string;\n  /**\n   * Monta dentro do pai posicionado em vez de `fixed` na janela.\n   *\n   * Existe porque a paleta também é útil embutida — num painel de bancada, num\n   * card de ferramenta — e porque `fixed inset-0` só tem um lugar possível na\n   * página: em cima de tudo. Embutida, ela não rouba o foco por padrão nem\n   * escurece a página inteira. O pai precisa ter `position: relative`.\n   */\n  inline?: boolean;\n  /** Foco no campo ao montar. Padrão: sim em modal, não embutida. */\n  autoFocus?: boolean;\n  className?: string;\n}\n\nexport function VintageCommandPalette({\n  items,\n  groups,\n  onSelect,\n  onClose,\n  placeholder = \"Search...\",\n  inline = false,\n  autoFocus,\n  className,\n}: VintageCommandPaletteProps) {\n  const [query, setQuery] = useState(\"\");\n  const [selectedIndex, setSelectedIndex] = useState(0);\n  const inputRef = useRef<HTMLInputElement>(null);\n\n  // Embutida não puxa o foco: a paleta pode estar num painel que a pessoa nem\n  // olhou ainda, e roubar o cursor de quem está digitando em outro lugar é o\n  // tipo de gentileza que vira sabotagem.\n  const focar = autoFocus ?? !inline;\n  useEffect(() => {\n    if (focar) inputRef.current?.focus();\n  }, [focar]);\n\n  useEffect(() => {\n    const handler = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") onClose();\n    };\n    document.addEventListener(\"keydown\", handler);\n    return () => document.removeEventListener(\"keydown\", handler);\n  }, [onClose]);\n\n  const q = query.toLowerCase();\n  const filtered = items.filter(\n    (item) =>\n      item.label.toLowerCase().includes(q) ||\n      item.icon?.includes(q) ||\n      item.description?.toLowerCase().includes(q)\n  );\n\n  const handleSelect = useCallback(\n    (id: string) => {\n      onSelect(id);\n      onClose();\n    },\n    [onSelect, onClose]\n  );\n\n  const handleKeyDown = (e: React.KeyboardEvent) => {\n    if (e.key === \"ArrowDown\") {\n      e.preventDefault();\n      setSelectedIndex((i) => Math.min(i + 1, filtered.length - 1));\n    } else if (e.key === \"ArrowUp\") {\n      e.preventDefault();\n      setSelectedIndex((i) => Math.max(i - 1, 0));\n    } else if (e.key === \"Enter\" && filtered[selectedIndex]) {\n      handleSelect(filtered[selectedIndex].id);\n    }\n  };\n\n  useEffect(() => {\n    setSelectedIndex(0);\n  }, [query]);\n\n  const renderItems = (list: CommandItem[]) =>\n    list.map((item) => {\n      const globalIndex = filtered.indexOf(item);\n      const selecionado = globalIndex === selectedIndex;\n      return (\n        <button\n          key={item.id}\n          id={`vcp-${item.id}`}\n          type=\"button\"\n          role=\"option\"\n          aria-selected={selecionado}\n          // Fora do Tab de propósito: quem manda na lista é a seta, e o foco\n          // fica no campo de busca. Botão tabulável aqui tiraria o foco do\n          // input e a seta pararia de funcionar no meio da navegação.\n          tabIndex={-1}\n          // A linha selecionada se traz pra vista: sem isto a seta descia além\n          // da dobra e a pessoa escolhia um comando que não estava na tela.\n          ref={(el) => {\n            if (el && selecionado) el.scrollIntoView({ block: \"nearest\" });\n          }}\n          onClick={() => handleSelect(item.id)}\n          className={cn(\n            // `min-h-11` = 44px, o piso de alvo de toque. Antes eram ~40px de\n            // `py-2.5`, que é onde o dedo acerta a linha de cima.\n            \"flex w-full min-h-11 items-center gap-3 rounded-lg px-3 py-2.5 text-left\",\n            \"cursor-pointer transition-colors\",\n            \"[transition-duration:var(--dur-fast,160ms)]\",\n            selecionado\n              ? \"bg-[var(--vintage-surface-3)]\"\n              : \"hover:bg-[var(--vintage-surface-2)]\",\n            item.active && \"bg-[var(--vintage-accent)]/10\"\n          )}\n        >\n          {item.icon && (\n            <span className=\"text-lg w-7 text-center shrink-0\">\n              {item.icon}\n            </span>\n          )}\n          <span\n            className={cn(\n              \"flex-1 text-sm\",\n              item.active\n                ? \"text-[var(--vintage-value)] font-semibold\"\n                : \"text-[var(--vintage-text-muted)]\"\n            )}\n          >\n            {item.label}\n          </span>\n          {item.active !== undefined && (\n            <span\n              className={cn(\n                \"text-xs font-bold uppercase tracking-wider px-2 py-0.5 rounded\",\n                item.active\n                  ? \"bg-[var(--vintage-meter-green)]/15 text-[var(--vintage-meter-green)]\"\n                  : \"bg-[var(--vintage-surface-3)] text-[var(--vintage-text-dim)]\"\n              )}\n            >\n              {item.active ? \"ON\" : \"OFF\"}\n            </span>\n          )}\n        </button>\n      );\n    });\n\n  return (\n    <div\n      className={cn(\n        \"flex items-start justify-center\",\n        inline\n          ? \"absolute inset-0 z-10 p-3\"\n          : // `10vh` de topo num celular deitado é quase toda a tela; o piso de\n            // 2rem é o que mantém a paleta acima da dobra em qualquer altura.\n            \"fixed inset-0 z-[9999] px-4 pb-4 pt-[max(2rem,10vh)]\",\n        className\n      )}\n      style={{\n        // Token, não `rgba` cru: o véu tem de escurecer o painel da casa, e o\n        // painel muda de tom por tema.\n        background: \"color-mix(in srgb, var(--vintage-surface-1) 82%, transparent)\",\n        // Exceção declarada à regra do backdrop-blur: isto é diálogo modal, que\n        // é justamente onde o desfoque paga o próprio custo de composição.\n        backdropFilter: \"blur(8px)\",\n      }}\n      onMouseDown={onClose}\n    >\n      <div\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label=\"Paleta de comandos\"\n        onMouseDown={(e) => e.stopPropagation()}\n        // Largura natural de 480, teto na tela: era `w-[480px]` cravado e num\n        // celular de 390 o painel sangrava 45px de cada lado.\n        className={cn(\n          \"flex w-[min(480px,100%)] flex-col overflow-hidden rounded-2xl border border-[var(--vintage-border)]\",\n          // Embutida, o teto é o pai; modal, é a janela. `70vh` dentro de um\n          // card de 300px devolveria um diálogo mais alto que o próprio card.\n          inline ? \"max-h-full\" : \"max-h-[70vh]\"\n        )}\n        style={{\n          background:\n            \"linear-gradient(160deg, var(--vintage-surface-2), var(--vintage-surface-1))\",\n          boxShadow:\n            \"0 40px 120px color-mix(in srgb, var(--vintage-surface-1) 90%, transparent), 0 0 0 1px color-mix(in srgb, var(--vintage-label) 8%, transparent)\",\n        }}\n      >\n        {/* Search */}\n        <div className=\"flex items-center gap-3 px-4 py-3.5 border-b border-[var(--vintage-border)]\">\n          <svg\n            className=\"w-5 h-5 text-[var(--vintage-text-dim)] shrink-0\"\n            fill=\"none\"\n            viewBox=\"0 0 24 24\"\n            stroke=\"currentColor\"\n            strokeWidth={2}\n          >\n            <circle cx=\"11\" cy=\"11\" r=\"8\" />\n            <path d=\"m21 21-4.35-4.35\" />\n          </svg>\n          <input\n            ref={inputRef}\n            value={query}\n            onChange={(e) => setQuery(e.target.value)}\n            onKeyDown={handleKeyDown}\n            placeholder={placeholder}\n            role=\"combobox\"\n            aria-expanded\n            aria-controls=\"vcp-lista\"\n            aria-activedescendant={filtered[selectedIndex] ? `vcp-${filtered[selectedIndex].id}` : undefined}\n            className=\"flex-1 bg-transparent border-none outline-none text-[var(--vintage-label)] text-base\"\n            style={{ fontFamily: \"var(--font-vintage-body)\" }}\n          />\n          <kbd className=\"text-xs text-[var(--vintage-text-dim)] bg-[var(--vintage-surface-3)] px-1.5 py-0.5 rounded border border-[var(--vintage-border)]\">\n            ESC\n          </kbd>\n        </div>\n\n        {/* Items */}\n        <div\n          id=\"vcp-lista\"\n          role=\"listbox\"\n          aria-label=\"Comandos\"\n          className=\"overflow-y-auto flex-1 min-h-0 p-2\"\n        >\n          {filtered.length === 0 && (\n            <div className=\"py-8 text-center text-sm text-[var(--vintage-text-dim)]\">\n              No results found\n            </div>\n          )}\n\n          {!q && groups\n            ? groups.map((group) => {\n                const groupItems = group.ids\n                  .map((id) => filtered.find((item) => item.id === id))\n                  .filter(Boolean) as CommandItem[];\n                if (groupItems.length === 0) return null;\n                return (\n                  <div key={group.label} role=\"group\" aria-label={group.label}>\n                    <div\n                      className=\"px-3 pt-3 pb-1 text-[10px] font-bold uppercase tracking-[0.12em] text-[var(--vintage-text-dim)]\"\n                      style={{ fontFamily: \"var(--font-vintage-mono)\" }}\n                    >\n                      {group.label}\n                    </div>\n                    {renderItems(groupItems)}\n                  </div>\n                );\n              })\n            : renderItems(filtered)}\n        </div>\n\n        {/* Footer */}\n        <div className=\"px-4 py-2 border-t border-[var(--vintage-border)] flex gap-4 flex-wrap\">\n          {[\n            [\"↑↓\", \"navigate\"],\n            [\"↵\", \"select\"],\n            [\"ESC\", \"close\"],\n          ].map(([key, label]) => (\n            <span\n              key={key}\n              className=\"text-[10px] text-[var(--vintage-text-dim)]\"\n            >\n              <kbd className=\"bg-[var(--vintage-surface-3)] border border-[var(--vintage-border)] rounded px-1 mr-1\">\n                {key}\n              </kbd>\n              {label}\n            </span>\n          ))}\n        </div>\n      </div>\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Paleta de comandos por teclado dentro de app no kit vintage, como lista de efeitos ou presets",
      "evite": "App de produto comum: use o command menu do tema; só buscar no cabeçalho, expanding-search"
    }
  },
  "categories": [
    "controles",
    "comando",
    "teclado"
  ],
  "type": "registry:ui"
}