{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "vintage-xy-pad",
  "title": "Vintage XY Pad",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Campo de dois eixos para controlar dois parâmetros num gesto só.",
  "registryDependencies": [
    "@visant/vintage-theme",
    "utils",
    "@visant/sfx-bus"
  ],
  "files": [
    {
      "path": "registry/vintage/ui/vintage-xy-pad.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"@/lib/utils\";\nimport { playSfx } from \"@/lib/sfx-bus\";\n\n/**\n * VintageXYPad — dois parâmetros num gesto só.\n *\n * O que estava errado (\"faz alterar algo\"): a peça já emitia `onChange`, mas\n * ninguém do lado de fora escutava, então na vitrine ela era um ponto que\n * andava dentro de uma caixa. O conserto de verdade é a cena — o pad ligado a\n * um tubo que muda de desenho — mas três defeitos eram do componente:\n *\n * 1. **Sem teclado.** O gesto era o único jeito de mexer. Um controle de dois\n *    eixos que só obedece ao ponteiro exclui quem navega por Tab, e o dado é\n *    contínuo: seta anda 2%, com Shift anda 10%.\n * 2. **Sem captura de ponteiro.** Os ouvintes iam no `window`; arrastar pra\n *    fora, soltar em cima de outro card e voltar deixava o pad \"colado\" no\n *    cursor. `setPointerCapture` entrega o gesto ao alvo e devolve no `up`.\n * 3. **Rótulo em `--vintage-text-dim`.** Sobre o painel escuro isso dá 2,8:1,\n *    abaixo do piso de 3:1 — e é justamente o número que a pessoa quer ler\n *    enquanto arrasta. Passou a `--vintage-text-muted` (5,4:1).\n *\n * O rastro curto do cursor não é enfeite: num pad sem rastro, movimento rápido\n * some entre um quadro e outro, e a mão perde a noção do caminho que fez.\n */\ninterface VintageXYPadProps {\n  size?: number;\n  value?: { x: number; y: number };\n  onChange?: (x: number, y: number) => void;\n  labelX?: string;\n  labelY?: string;\n  color?: string;\n  className?: string;\n}\n\nconst PASSOS_RASTRO = 12;\n\nexport function VintageXYPad({\n  size = 160,\n  value,\n  onChange,\n  labelX = \"X\",\n  labelY = \"Y\",\n  color = \"var(--vintage-light)\",\n  className,\n}: VintageXYPadProps) {\n  const ref = React.useRef<HTMLDivElement>(null);\n  const [pos, setPos] = React.useState(value ?? { x: 0.5, y: 0.5 });\n  const [rastro, setRastro] = React.useState<{ x: number; y: number }[]>([]);\n  const arrastando = React.useRef(false);\n  const celulaRef = React.useRef<number | null>(null);\n\n  const atual = value ?? pos;\n\n  const aplicar = React.useCallback(\n    (x: number, y: number) => {\n      const cx = Math.max(0, Math.min(1, x));\n      const cy = Math.max(0, Math.min(1, y));\n      // Estalo por célula de uma grade 8×8: a mão sente onde está sem olhar.\n      const celula = Math.min(7, Math.floor(cx * 8)) * 8 + Math.min(7, Math.floor(cy * 8));\n      if (celulaRef.current !== null && celula !== celulaRef.current) playSfx(\"detent\");\n      celulaRef.current = celula;\n      if (!value) setPos({ x: cx, y: cy });\n      setRastro((p) => [...p, { x: cx, y: cy }].slice(-PASSOS_RASTRO));\n      onChange?.(cx, cy);\n    },\n    [onChange, value]\n  );\n\n  const doPonteiro = React.useCallback(\n    (e: React.PointerEvent) => {\n      const r = ref.current?.getBoundingClientRect();\n      if (!r) return;\n      aplicar((e.clientX - r.left) / r.width, 1 - (e.clientY - r.top) / r.height);\n    },\n    [aplicar]\n  );\n\n  const soltar = () => {\n    arrastando.current = false;\n    setRastro([]);\n  };\n\n  const porTecla = (e: React.KeyboardEvent) => {\n    const passo = e.shiftKey ? 0.1 : 0.02;\n    const mapa: Record<string, [number, number]> = {\n      ArrowLeft: [-passo, 0],\n      ArrowRight: [passo, 0],\n      ArrowUp: [0, passo],\n      ArrowDown: [0, -passo],\n    };\n    const d = mapa[e.key];\n    if (d) {\n      e.preventDefault();\n      aplicar(atual.x + d[0], atual.y + d[1]);\n      return;\n    }\n    if (e.key === \"Home\") {\n      e.preventDefault();\n      aplicar(0.5, 0.5);\n    }\n  };\n\n  const leitura = `${labelX} ${(atual.x * 100).toFixed(0)}%, ${labelY} ${(atual.y * 100).toFixed(0)}%`;\n\n  return (\n    <div\n      className={cn(\"inline-flex flex-col gap-2 rounded-[var(--r-control,10px)] p-2.5\", className)}\n      style={{\n        // O painel do kit: chapa escura, luz de cima, sombra que fecha embaixo.\n        background: \"linear-gradient(180deg, var(--vintage-surface-3), var(--vintage-surface-2))\",\n        border: \"1px solid var(--vintage-surface-1)\",\n        boxShadow:\n          \"var(--vintage-panel-shadow)\",\n      }}\n    >\n      <div\n        ref={ref}\n        tabIndex={0}\n        role=\"group\"\n        aria-label={`Campo de dois eixos: ${labelX} e ${labelY}. Setas movem, Shift acelera, Home centraliza.`}\n        className={cn(\n          \"group relative rounded-[6px] cursor-crosshair touch-none outline-none overflow-hidden\"\n        )}\n        style={{\n          width: size,\n          height: size,\n          // Janela rebaixada, a mesma do osciloscópio e do EQ.\n          background:\n            \"radial-gradient(ellipse at 50% 40%, var(--vintage-surface-2), var(--vintage-surface-1))\",\n          boxShadow:\n            \"var(--vintage-well-shadow)\",\n        }}\n        onPointerDown={(e) => {\n          if (e.pointerType === \"mouse\" && e.button !== 0) return;\n          /*\n           * Três defeitos do arrasto, todos daqui:\n           * - sem `preventDefault` o navegador começava uma seleção de texto\n           *   junto, e o gesto pintava de azul o que o cursor cruzava;\n           * - `focus()` sem `preventScroll` rolava a página pra mostrar o\n           *   campo inteiro, e o pad fugia de baixo do dedo no meio do gesto;\n           * - o rastro ficava na tela depois de soltar, como gesto travado.\n           */\n          e.preventDefault();\n          arrastando.current = true;\n          celulaRef.current = null;\n          setRastro([]);\n          e.currentTarget.setPointerCapture?.(e.pointerId);\n          e.currentTarget.focus({ preventScroll: true });\n          doPonteiro(e);\n        }}\n        onPointerMove={(e) => {\n          if (arrastando.current) doPonteiro(e);\n        }}\n        onPointerUp={soltar}\n        onPointerCancel={soltar}\n        onLostPointerCapture={soltar}\n        onKeyDown={porTecla}\n      >\n        <svg\n          className=\"absolute inset-0 h-full w-full pointer-events-none\"\n          viewBox={`0 0 ${size} ${size}`}\n        >\n          {[0.25, 0.5, 0.75].map((t) => (\n            <g key={t}>\n              <line\n                x1={t * size}\n                y1={0}\n                x2={t * size}\n                y2={size}\n                stroke=\"var(--vintage-text-muted)\"\n                strokeWidth={0.5}\n                opacity={t === 0.5 ? 0.4 : 0.15}\n              />\n              <line\n                x1={0}\n                y1={t * size}\n                x2={size}\n                y2={t * size}\n                stroke=\"var(--vintage-text-muted)\"\n                strokeWidth={0.5}\n                opacity={t === 0.5 ? 0.4 : 0.15}\n              />\n            </g>\n          ))}\n\n          {/* Rastro: o caminho recente da mão, apagando. */}\n          {rastro.length > 1 && (\n            <polyline\n              points={rastro\n                .map((p) => `${p.x * size},${(1 - p.y) * size}`)\n                .join(\" \")}\n              fill=\"none\"\n              stroke={color}\n              strokeWidth={1.5}\n              strokeLinecap=\"round\"\n              opacity={0.35}\n            />\n          )}\n        </svg>\n\n        <div\n          className=\"absolute pointer-events-none\"\n          style={{\n            left: `${atual.x * 100}%`,\n            top: 0,\n            bottom: 0,\n            width: 1,\n            background: color,\n            opacity: 0.3,\n          }}\n        />\n        <div\n          className=\"absolute pointer-events-none\"\n          style={{\n            top: `${(1 - atual.y) * 100}%`,\n            left: 0,\n            right: 0,\n            height: 1,\n            background: color,\n            opacity: 0.3,\n          }}\n        />\n\n        <div\n          className=\"absolute rounded-full pointer-events-none -translate-x-1/2 -translate-y-1/2\"\n          style={{\n            left: `${atual.x * 100}%`,\n            top: `${(1 - atual.y) * 100}%`,\n            width: 10,\n            height: 10,\n            background: `radial-gradient(circle at 50% 35%, color-mix(in srgb, ${color} 40%, white) 0%, ${color} 55%)`,\n            boxShadow: `0 0 8px ${color}, 0 0 18px color-mix(in srgb, ${color} 40%, transparent)`,\n          }}\n        />\n        <div\n          className=\"absolute rounded-full pointer-events-none -translate-x-1/2 -translate-y-1/2\"\n          style={{\n            left: `${atual.x * 100}%`,\n            top: `${(1 - atual.y) * 100}%`,\n            width: 20,\n            height: 20,\n            border: `1px solid color-mix(in srgb, ${color} 45%, transparent)`,\n          }}\n        />\n        {/* Foco num filho: a janela tem `overflow-hidden` e sombra inline. */}\n        <div\n          aria-hidden\n          className=\"pointer-events-none absolute inset-0 rounded-[6px] group-focus-visible:[box-shadow:inset_0_0_0_2px_var(--vintage-value)]\"\n        />\n      </div>\n\n      <div\n        className=\"flex justify-between\"\n        style={{ width: size }}\n        aria-live=\"polite\"\n        aria-atomic=\"true\"\n      >\n        <span className=\"sr-only\">{leitura}</span>\n        {[\n          [labelX, atual.x],\n          [labelY, atual.y],\n        ].map(([rotulo, v]) => (\n          <span\n            key={String(rotulo)}\n            aria-hidden\n            className=\"whitespace-nowrap text-[9px] font-semibold uppercase tracking-[0.08em] tabular-nums\"\n            style={{\n              color: \"var(--vintage-text-muted)\",\n              fontFamily: \"var(--font-vintage-mono, monospace)\",\n              textShadow: \"var(--vintage-engrave)\",\n            }}\n          >\n            {rotulo}: {((v as number) * 100).toFixed(0)}%\n          </span>\n        ))}\n      </div>\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Controlar dois parâmetros juntos num gesto só, como filtro e ressonância, em app de áudio",
      "evite": "Um parâmetro só: vintage-knob ou vintage-slider"
    }
  },
  "categories": [
    "controles",
    "audio",
    "gesto"
  ],
  "type": "registry:ui"
}