{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "vintage-meter",
  "title": "Vintage Meter",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "VU analógico com balística de ponteiro.",
  "registryDependencies": [
    "@visant/vintage-theme",
    "utils"
  ],
  "files": [
    {
      "path": "registry/vintage/ui/vintage-meter.tsx",
      "content": "\"use client\";\n\nimport { useRef, useEffect, useState, useCallback } from \"react\";\nimport { cn } from \"@/lib/utils\";\n\ninterface VintageMeterProps {\n  label?: string;\n  /** Controlado. Sem ele o medidor guarda o próprio nível. */\n  value?: number;\n  /** Nível inicial quando o medidor é não-controlado. */\n  defaultValue?: number;\n  min?: number;\n  max?: number;\n  /**\n   * Chamado a cada mudança vinda do usuário (arraste, roda, teclado).\n   *\n   * No modo controlado ele é obrigatório para a peça aceitar entrada: sem\n   * `onChange` não há para onde escrever, e um arraste que não move o ponteiro\n   * é pior do que um medidor assumidamente passivo.\n   */\n  onChange?: (value: number) => void;\n  /** Desliga a entrada do usuário e devolve o VU de vitrine, só leitura. */\n  readOnly?: boolean;\n  className?: string;\n}\n\n/** Ângulo do ponteiro, em graus a partir da vertical. */\nconst ARCO = 90;\n\nexport function VintageMeter({\n  label = \"LEVEL\",\n  value,\n  defaultValue = 0,\n  min = 0,\n  max = 10,\n  onChange,\n  readOnly = false,\n  className,\n}: VintageMeterProps) {\n  const controlado = value !== undefined;\n  const [interno, setInterno] = useState(value ?? defaultValue);\n  const nivel = value ?? interno;\n\n  // No controlado sem `onChange` não existe entrada possível — ver a prop.\n  const interativo = !readOnly && (!controlado || Boolean(onChange));\n\n  const faceRef = useRef<HTMLDivElement>(null);\n  const needleRef = useRef<SVGGElement>(null);\n  const peakRef = useRef<SVGLineElement>(null);\n  const targetRef = useRef(nivel);\n  const currentRef = useRef(nivel);\n  const peakRefVal = useRef(nivel);\n  const peakHold = useRef(0);\n  const rafRef = useRef<number>(0);\n\n  targetRef.current = nivel;\n\n  useEffect(() => {\n    let running = true;\n    function animate() {\n      if (!running) return;\n      const diff = targetRef.current - currentRef.current;\n      // Ataque rápido, queda lenta: é a balística de um VU de verdade.\n      const speed = diff > 0 ? 0.25 : 0.08;\n      currentRef.current += diff * speed;\n\n      const normalized = (currentRef.current - min) / (max - min);\n      const rotation = -ARCO / 2 + normalized * ARCO;\n\n      if (needleRef.current) {\n        needleRef.current.setAttribute(\n          \"transform\",\n          `rotate(${rotation} 70 65)`\n        );\n      }\n\n      // Retentor de pico: sobe na hora, segura ~1s e desce devagar. É o que\n      // deixa o transiente visível depois que a agulha já voltou.\n      const agora = performance.now();\n      if (currentRef.current > peakRefVal.current) {\n        peakRefVal.current = currentRef.current;\n        peakHold.current = agora;\n      } else if (agora - peakHold.current > 900) {\n        peakRefVal.current -= (max - min) * 0.004;\n        if (peakRefVal.current < currentRef.current) {\n          peakRefVal.current = currentRef.current;\n        }\n      }\n      if (peakRef.current) {\n        const pn = (peakRefVal.current - min) / (max - min);\n        peakRef.current.setAttribute(\n          \"transform\",\n          `rotate(${-ARCO / 2 + pn * ARCO} 70 65)`\n        );\n      }\n\n      rafRef.current = requestAnimationFrame(animate);\n    }\n    animate();\n    return () => {\n      running = false;\n      cancelAnimationFrame(rafRef.current);\n    };\n  }, [min, max]);\n\n  const emitir = useCallback(\n    (v: number) => {\n      const clamped = Math.max(min, Math.min(max, v));\n      if (!controlado) setInterno(clamped);\n      onChange?.(clamped);\n    },\n    [controlado, min, max, onChange]\n  );\n\n  /**\n   * O arraste é angular, não horizontal: o dedo empurra a agulha em volta do\n   * eixo dela. Qualquer ponto da face serve, porque o que conta é a direção do\n   * cursor em relação ao pivô — o mesmo gesto de encostar o dedo no ponteiro.\n   */\n  const doPonteiro = useCallback(\n    (clientX: number, clientY: number) => {\n      const r = faceRef.current?.getBoundingClientRect();\n      if (!r) return;\n      // O pivô mora em (70,65) de um viewBox 140×70 — daí as frações.\n      const px = r.left + r.width * 0.5;\n      const py = r.top + r.height * (65 / 70);\n      const theta = (Math.atan2(py - clientY, clientX - px) * 180) / Math.PI;\n      const n = (135 - theta) / ARCO;\n      emitir(min + Math.max(0, Math.min(1, n)) * (max - min));\n    },\n    [emitir, min, max]\n  );\n\n  const [dragging, setDragging] = useState(false);\n\n  const onPointerDown = (e: React.PointerEvent<HTMLDivElement>) => {\n    if (!interativo) return;\n    if (e.pointerType === \"mouse\" && e.button !== 0) return;\n    e.preventDefault();\n    e.currentTarget.setPointerCapture(e.pointerId);\n    setDragging(true);\n    doPonteiro(e.clientX, e.clientY);\n  };\n\n  const onPointerMove = (e: React.PointerEvent<HTMLDivElement>) => {\n    if (dragging) doPonteiro(e.clientX, e.clientY);\n  };\n\n  const endDrag = (e: React.PointerEvent<HTMLDivElement>) => {\n    if (e.currentTarget.hasPointerCapture(e.pointerId)) {\n      e.currentTarget.releasePointerCapture(e.pointerId);\n    }\n    setDragging(false);\n  };\n\n  const onKeyDown = (e: React.KeyboardEvent) => {\n    if (!interativo) return;\n    const passo = (max - min) * (e.shiftKey ? 0.01 : 0.05);\n    if (e.key === \"ArrowUp\" || e.key === \"ArrowRight\") emitir(nivel + passo);\n    else if (e.key === \"ArrowDown\" || e.key === \"ArrowLeft\") emitir(nivel - passo);\n    else if (e.key === \"Home\") emitir(min);\n    else if (e.key === \"End\") emitir(max);\n    else return;\n    e.preventDefault();\n  };\n\n  const normalized = (nivel - min) / (max - min);\n  const isClipping = normalized > 0.85;\n\n  return (\n    <div\n      className={cn(\n        \"relative flex w-[180px] h-[140px] flex-col gap-2 rounded-[var(--r-control,10px)] p-2.5\",\n        className\n      )}\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      {/*\n        A janela do VU: mostrador de papel creme iluminado por trás, atrás de um\n        vidro. É o objeto que todo mundo reconhece como \"medidor analógico\"; o\n        arco arco-íris sobre fundo preto que havia aqui era gráfico de painel\n        web, não instrumento.\n      */}\n      <div\n        className=\"relative flex-1 overflow-hidden rounded-[6px]\"\n        style={{\n          background:\n            \"radial-gradient(130% 120% at 50% 100%, var(--vintage-face-hi) 0%, var(--vintage-face-mid) 50%, var(--vintage-face-lo) 100%)\",\n          boxShadow:\n            \"var(--vintage-well-shadow)\",\n        }}\n      >\n        <div\n          ref={faceRef}\n          className={cn(\n            // `touch-pan-y`: a agulha anda de lado, e em pé a página continua rolando.\n            \"absolute bottom-0 left-1/2 -translate-x-1/2 w-[150px] h-[75px] rounded-[4px] outline-none\",\n            \"focus-visible:[box-shadow:var(--focus,0_0_0_2px_var(--vintage-value))]\",\n            interativo && \"touch-pan-y cursor-grab active:cursor-grabbing\"\n          )}\n          role={interativo ? \"slider\" : undefined}\n          tabIndex={interativo ? 0 : undefined}\n          aria-label={interativo ? label : undefined}\n          aria-valuemin={interativo ? min : undefined}\n          aria-valuemax={interativo ? max : undefined}\n          aria-valuenow={interativo ? Number(nivel.toFixed(2)) : undefined}\n          onPointerDown={onPointerDown}\n          onPointerMove={onPointerMove}\n          onPointerUp={endDrag}\n          onPointerCancel={endDrag}\n          onKeyDown={onKeyDown}\n        >\n          <svg viewBox=\"0 0 140 70\" className=\"w-full h-full overflow-visible\">\n            {/* Escala impressa: tinta escura, zona vermelha no último quarto. */}\n            <path d={arco(0, 0.75, 52)} fill=\"none\" stroke={TINTA} strokeWidth=\"1\" />\n            <path\n              d={arco(0.75, 1, 52)}\n              fill=\"none\"\n              stroke=\"var(--vintage-meter-red)\"\n              strokeWidth=\"3.5\"\n            />\n\n            {Array.from({ length: 11 }, (_, i) => {\n              const n = i / 10;\n              const isMajor = i % 5 === 0;\n              const [x1, y1] = polar(n, 52);\n              const [x2, y2] = polar(n, isMajor ? 44 : 47);\n              return (\n                <line\n                  key={i}\n                  x1={x1}\n                  y1={y1}\n                  x2={x2}\n                  y2={y2}\n                  stroke={n > 0.75 ? \"var(--vintage-meter-red)\" : TINTA}\n                  strokeWidth={isMajor ? \"1.4\" : \"0.8\"}\n                />\n              );\n            })}\n\n            {[0, 5, 10].map((num) => {\n              const [x, y] = polar(num / 10, 37);\n              return (\n                <text\n                  key={num}\n                  x={x}\n                  y={y + 2.5}\n                  textAnchor=\"middle\"\n                  fill={num === 10 ? \"var(--vintage-meter-red)\" : TINTA}\n                  fontSize=\"7\"\n                  fontWeight=\"600\"\n                  fontFamily=\"var(--font-vintage-mono)\"\n                >\n                  {num}\n                </text>\n              );\n            })}\n\n            <text\n              x=\"70\"\n              y=\"50\"\n              textAnchor=\"middle\"\n              fill={TINTA}\n              fontSize=\"8\"\n              fontWeight=\"700\"\n              letterSpacing=\"1.5\"\n              fontFamily=\"var(--font-vintage-mono)\"\n            >\n              VU\n            </text>\n\n            {/* Retentor de pico: traço curto na ponta do arco. */}\n            <line\n              ref={peakRef}\n              x1=\"70\"\n              y1=\"20\"\n              x2=\"70\"\n              y2=\"13\"\n              stroke=\"var(--vintage-meter-red)\"\n              strokeWidth=\"1.5\"\n              strokeLinecap=\"round\"\n              opacity=\"0.7\"\n              transform=\"rotate(-45 70 65)\"\n            />\n\n            {/* Ponteiro, animado por ref e não por estado do React. A sombra\n                deslocada é o milímetro entre o ponteiro e o papel. */}\n            <g ref={needleRef} transform=\"rotate(-45 70 65)\">\n              <line\n                x1=\"70.7\"\n                y1=\"66\"\n                x2=\"70.7\"\n                y2=\"15\"\n                stroke=\"rgba(0,0,0,0.25)\"\n                strokeWidth=\"1.6\"\n                strokeLinecap=\"round\"\n              />\n              <line\n                x1=\"70\"\n                y1=\"65\"\n                x2=\"70\"\n                y2=\"14\"\n                stroke={TINTA}\n                strokeWidth=\"1.2\"\n                strokeLinecap=\"round\"\n              />\n            </g>\n            {/* Tampa do pivô, presa ao vidro: não gira. */}\n            <circle cx=\"70\" cy=\"68\" r=\"7\" fill=\"var(--vintage-surface-2)\" />\n            <circle\n              cx=\"70\"\n              cy=\"68\"\n              r=\"7\"\n              fill=\"none\"\n              stroke=\"rgba(255,255,255,0.12)\"\n              strokeWidth=\"0.6\"\n            />\n          </svg>\n        </div>\n\n        {/* O vidro: reflexo da luz de cima, cortado em diagonal. */}\n        <div\n          aria-hidden\n          className=\"pointer-events-none absolute inset-0\"\n          style={{\n            background:\n              \"linear-gradient(168deg, rgba(255,255,255,0.22) 0%, rgba(255,255,255,0.06) 38%, transparent 39%)\",\n          }}\n        />\n      </div>\n\n      <div className=\"flex items-center justify-between font-vintage-mono leading-none\">\n        <span\n          className=\"text-[10px] font-semibold uppercase tracking-[0.18em]\"\n          style={{\n            color: \"var(--vintage-text-muted)\",\n            textShadow: \"var(--vintage-engrave)\",\n          }}\n        >\n          {label}\n        </span>\n        <span className=\"flex items-center gap-1.5\">\n          <span\n            className=\"text-[11px] tabular-nums\"\n            style={{ color: isClipping ? \"var(--vintage-meter-red)\" : \"var(--vintage-value)\" }}\n          >\n            {nivel.toFixed(1)}\n          </span>\n          {/* Lâmpada de pico: acende no vermelho, sem piscar. */}\n          <span\n            aria-hidden\n            className=\"h-1.5 w-1.5 rounded-full\"\n            style={{\n              background: isClipping ? \"var(--vintage-meter-red)\" : \"var(--vintage-surface-1)\",\n              boxShadow: isClipping\n                ? \"0 0 6px var(--vintage-meter-red), 0 0 0 1px var(--vintage-edge)\"\n                : \"inset 0 1px 1px rgba(0,0,0,0.8), 0 0 0 1px var(--vintage-edge)\",\n              transition: \"background var(--dur-fast,160ms) var(--ease-out,ease)\",\n            }}\n          />\n        </span>\n      </div>\n    </div>\n  );\n}\n\n/** Tinta da serigrafia do mostrador: papel creme leva tinta escura nos dois temas. */\nconst TINTA = \"var(--vintage-face-ink)\";\n\n/** Ponto da escala `n` (0…1) a `r` do pivô (70,65), no arco de ±45°. */\nfunction polar(n: number, r: number): [number, number] {\n  const rad = ((-45 + n * 90) * Math.PI) / 180;\n  return [70 + Math.sin(rad) * r, 65 - Math.cos(rad) * r];\n}\n\nfunction arco(de: number, ate: number, r: number) {\n  const [x1, y1] = polar(de, r);\n  const [x2, y2] = polar(ate, r);\n  return `M ${x1.toFixed(2)} ${y1.toFixed(2)} A ${r} ${r} 0 0 1 ${x2.toFixed(2)} ${y2.toFixed(2)}`;\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Mostrar nível de sinal ao vivo com ponteiro de VU num painel de áudio",
      "evite": "Métrica de dashboard ou cota: gauge; número com régua e evidência, measure-bar"
    }
  },
  "categories": [
    "conteudo",
    "audio",
    "medidor"
  ],
  "type": "registry:ui"
}