{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "vintage-parametric-eq",
  "title": "Vintage Parametric EQ",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "O EQ paramétrico: cada banda é um sino, e a curva grossa é a soma em dB. Arraste um ponto, roda muda o Q, e o BYPASS achata sem perder os valores.",
  "registryDependencies": [
    "@visant/vintage-theme",
    "utils"
  ],
  "files": [
    {
      "path": "registry/vintage/ui/vintage-parametric-eq.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * VintageParametricEQ — a curva, ao lado do banco de faders (não no lugar dele).\n *\n * ── Por que são DUAS peças, e não uma que substituiu a outra ───────────────\n *\n * Esta nasceu como reescrita do `vintage-eq`, respondendo ao \"ficou redundante\".\n * O diagnóstico continua valendo — banco de faders é seis números soltos e EQ é\n * **uma curva**, onde o ganho de cada banda vaza pras vizinhas —, mas a\n * conclusão estava errada por dois motivos:\n *\n * 1. **Trocar a API de um item publicado quebra quem instalou.** O `vintage-eq`\n *    entrega `labels`/`values`/`title`; esta peça entrega `bands`. Quem rodou\n *    `add @visant/vintage-eq` receberia, na atualização, um componente que não\n *    aceita nenhuma das props que ele passa.\n * 2. **O gráfico e o paramétrico não são a mesma ferramenta.** O de faders é o\n *    EQ de quem ouve — mexe onde dói, sem nomear frequência. O paramétrico é o\n *    de quem mistura — banda, ganho e Q. Os dois existem no mundo real lado a\n *    lado, e é por isso que os dois existem aqui.\n *\n * `vintage-eq` continua sendo o banco de faders, intacto. Esta é peça nova.\n *\n * Então aqui:\n *\n * - **Eixo x logarítmico**, 20 Hz a 20 kHz. Grave ocupa metade da tela como\n *   ocupa metade da audição; linear espremeria tudo que importa em 5% da régua.\n * - **Cada banda é um sino** (filtro peaking RBJ, o biquad de verdade), e a\n *   curva grossa é a **soma em dB** dos sinos. Somar dB é o que uma cascata de\n *   peaking realmente faz, então a curva desenhada é a resposta, não uma\n *   ilustração dela.\n * - **Pouca tinta no gráfico.** Grade só no plano de 0 dB e três marcas de\n *   frequência no rodapé; o sino de uma banda só aparece quando ela está na\n *   mão (hover, foco ou arrasto). Linha que não responde a nada é ruído.\n * - **A curva veste a marca.** Traço, área e punhos usam `--brand` (borda e\n *   fundo, nunca texto); o painel continua sendo o do kit vintage. A leitura\n *   em texto fica na tinta do painel, que é onde o contraste está garantido.\n * - **O punho anda nos dois eixos**: vertical é ganho, horizontal é a\n *   frequência central, presa entre as vizinhas. Roda do mouse aperta ou abre o\n *   Q, e é aí que o sino fica agulha ou fica montanha.\n * - **BYPASS achata a curva** e apaga a cor, sem perder os valores. É a\n *   comparação A/B, que é pra que serve um EQ.\n *\n * Mudança de contrato, dita em voz alta: `values`/`onChange` falavam em 0…10\n * (posição do fader). Agora falam em **dB**, −12 a +12, com 0 no plano. Quem\n * instalou a versão anterior precisa reler os números; guardar a escala antiga\n * seria guardar a mentira de que aquilo era um EQ.\n */\n\nexport interface EqBand {\n  id: string;\n  /** Nome curto da banda. É o que a pessoa fala, não o que o filtro calcula. */\n  label: string;\n  /** Frequência central em Hz. */\n  freq: number;\n  /** Ganho em dB. Zero é plano. */\n  gain: number;\n  /** Fator de qualidade. Alto = agulha estreita, baixo = montanha larga. */\n  q: number;\n}\n\nconst BANDAS_PADRAO: EqBand[] = [\n  { id: \"low\", label: \"LOW\", freq: 60, gain: 3.5, q: 0.8 },\n  { id: \"lowmid\", label: \"LOW-MID\", freq: 250, gain: -2.5, q: 1.1 },\n  { id: \"mid\", label: \"MID\", freq: 900, gain: 1.5, q: 1.4 },\n  { id: \"highmid\", label: \"HIGH-MID\", freq: 3200, gain: -1.5, q: 1.6 },\n  { id: \"air\", label: \"AIR\", freq: 11000, gain: 4, q: 0.7 },\n];\n\ninterface VintageEQProps {\n  bands?: EqBand[];\n  title?: string;\n  /** Teto do eixo em dB. A régua vai de −range a +range. */\n  range?: number;\n  /** Cor da curva e dos punhos. Padrão: a marca selecionada. Só traço e fundo. */\n  accent?: string;\n  onChange?: (bands: EqBand[]) => void;\n  /** Largura natural do painel da curva. */\n  width?: number;\n  height?: number;\n  className?: string;\n}\n\nconst F_MIN = 20;\nconst F_MAX = 20000;\nconst DECADAS = Math.log(F_MAX / F_MIN);\n\n/** Rótulos da régua de frequência. Só os que a pessoa usa pra se orientar. */\nconst MARCAS = [\n  { f: 100, t: \"100\" },\n  { f: 1000, t: \"1k\" },\n  { f: 10000, t: \"10k\" },\n];\n\nexport function VintageParametricEQ({\n  bands: bandasIniciais,\n  title = \"PARAMETRIC EQ\",\n  range = 12,\n  accent = \"var(--brand)\",\n  onChange,\n  width = 520,\n  height = 220,\n  className,\n}: VintageEQProps) {\n  const [bandas, setBandas] = React.useState<EqBand[]>(\n    () => bandasIniciais ?? BANDAS_PADRAO\n  );\n  const [ativa, setAtiva] = React.useState<string | null>(null);\n  const [bypass, setBypass] = React.useState(false);\n  const arrastando = React.useRef<string | null>(null);\n  const svgRef = React.useRef<SVGSVGElement>(null);\n\n  const padY = 14;\n  const meio = height / 2;\n\n  const fParaX = React.useCallback(\n    (f: number) => (Math.log(f / F_MIN) / DECADAS) * width,\n    [width]\n  );\n  const xParaF = React.useCallback(\n    (x: number) => F_MIN * Math.exp((x / width) * DECADAS),\n    [width]\n  );\n  const dbParaY = React.useCallback(\n    (db: number) => meio - (db / range) * (meio - padY),\n    [meio, range, padY]\n  );\n  const yParaDb = React.useCallback(\n    (y: number) => ((meio - y) / (meio - padY)) * range,\n    [meio, range, padY]\n  );\n\n  /*\n   * A soma é desenhada a cada 2 px de largura e o sino da banda em foco a cada\n   * 4: o arrasto redesenha tudo a cada movimento, e 5 biquads por ponto é\n   * conta de nada.\n   */\n  const somaDb = React.useCallback(\n    (f: number) => {\n      if (bypass) return 0;\n      let s = 0;\n      for (const b of bandas) s += sinoDb(f, b);\n      return Math.max(-range, Math.min(range, s));\n    },\n    [bandas, bypass, range]\n  );\n\n  const caminho = React.useMemo(() => {\n    const passos = Math.round(width / 2);\n    let d = \"\";\n    for (let i = 0; i <= passos; i++) {\n      const x = (i / passos) * width;\n      const y = dbParaY(somaDb(xParaF(x)));\n      d += `${i === 0 ? \"M\" : \"L\"}${x.toFixed(1)},${y.toFixed(1)}`;\n    }\n    return d;\n  }, [width, dbParaY, somaDb, xParaF]);\n\n  /*\n   * O próximo estado sai do ref, FORA do updater do `setBandas`.\n   *\n   * O `onChange` do pai morava dentro do updater, e updater é chamado pelo\n   * React durante o render (e duas vezes em modo estrito): o pai ganhava um\n   * `setState` no meio do render do EQ — o aviso \"Cannot update a component\n   * while rendering a different component\" na vitrine, e um `onChange` em dobro\n   * em desenvolvimento.\n   */\n  const bandasRef = React.useRef(bandas);\n  bandasRef.current = bandas;\n  const atualizar = (id: string, muda: Partial<EqBand>) => {\n    // Sem som aqui, de propósito: o arrasto anda nos dois eixos ao mesmo\n    // tempo, e um estalo por passo virava matraca contínua sob a mão.\n    const prox = bandasRef.current.map((b) => (b.id === id ? { ...b, ...muda } : b));\n    bandasRef.current = prox;\n    setBandas(prox);\n    onChange?.(prox);\n  };\n\n  const doPonteiro = (e: React.PointerEvent) => {\n    const id = arrastando.current;\n    const r = svgRef.current?.getBoundingClientRect();\n    if (!id || !r) return;\n    // A vitrine escala o palco com transform: o retângulo da tela vem escalado\n    // e o desenho não. Divide pela escala antes de virar Hz e dB.\n    const kx = r.width ? width / r.width : 1;\n    const ky = r.height ? height / r.height : 1;\n    const x = Math.max(0, Math.min(width, (e.clientX - r.left) * kx));\n    const y = Math.max(0, Math.min(height, (e.clientY - r.top) * ky));\n\n    const i = bandas.findIndex((b) => b.id === id);\n    // A banda não passa por cima da vizinha: curvas cruzadas viram um desenho\n    // que ninguém consegue ler nem desfazer.\n    const piso = i > 0 ? bandas[i - 1].freq * 1.15 : F_MIN;\n    const teto = i < bandas.length - 1 ? bandas[i + 1].freq / 1.15 : F_MAX;\n\n    atualizar(id, {\n      gain: Math.max(-range, Math.min(range, Math.round(yParaDb(y) * 10) / 10)),\n      freq: Math.round(Math.max(piso, Math.min(teto, xParaF(x)))),\n    });\n  };\n\n  const focada = bandas.find((b) => b.id === (ativa ?? arrastando.current));\n\n  return (\n    <div\n      className={cn(\n        \"inline-block rounded-[var(--r-control,10px)] p-4\",\n        className\n      )}\n      style={{\n        width: width + 32,\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      {/* Cabeçalho: nome, leitura da banda em foco e o A/B. */}\n      <div className=\"mb-3 flex items-center justify-between gap-3\">\n        <span\n          className=\"text-[10px] font-semibold uppercase tracking-[0.18em]\"\n          style={{\n            color: \"var(--vintage-text-muted)\",\n            fontFamily: \"var(--font-vintage-mono, monospace)\",\n            textShadow: \"var(--vintage-engrave)\",\n          }}\n        >\n          {title}\n        </span>\n\n        <span\n          className=\"flex-1 truncate text-right text-[11px] tabular-nums\"\n          style={{\n            color: focada ? \"var(--vintage-label)\" : \"var(--vintage-text-muted)\",\n            fontFamily: \"var(--font-vintage-mono, monospace)\",\n          }}\n        >\n          {focada\n            ? `${focada.label} · ${formatarHz(focada.freq)} · ${focada.gain > 0 ? \"+\" : \"\"}${focada.gain.toFixed(1)} dB · Q ${focada.q.toFixed(2)}`\n            : \"arraste um ponto · roda = Q\"}\n        </span>\n\n        <button\n          type=\"button\"\n          onClick={() => setBypass((v) => !v)}\n          aria-pressed={bypass}\n          className=\"group relative flex shrink-0 items-center gap-1.5 rounded-[4px] px-2 py-1 pointer-coarse:after:absolute pointer-coarse:after:inset-x-0 pointer-coarse:after:-inset-y-4 text-[10px] font-semibold uppercase tracking-[0.14em] outline-none\"\n          style={{\n            fontFamily: \"var(--font-vintage-mono, monospace)\",\n            color: bypass ? \"var(--vintage-label)\" : \"var(--vintage-text-muted)\",\n            // Tecla de painel: afunda quando travada, em vez de virar um\n            // bloco amarelo, que é chip de web e não botão de rack.\n            background: bypass\n              ? \"linear-gradient(180deg, var(--vintage-surface-2), var(--vintage-surface-3))\"\n              : \"linear-gradient(180deg, var(--vintage-surface-4), var(--vintage-surface-3))\",\n            boxShadow: bypass\n              ? \"inset 0 1px 3px rgba(0,0,0,0.7), 0 0 0 1px var(--vintage-edge)\"\n              : \"inset 0 1px 0 rgba(255,255,255,0.12), 0 0 0 1px var(--vintage-edge), 0 2px 3px rgba(0,0,0,0.5)\",\n            transition:\n              \"color var(--dur-fast,160ms) var(--ease-out,ease), box-shadow var(--dur-press,120ms) var(--ease-out,ease)\",\n          }}\n        >\n          <span\n            aria-hidden\n            className=\"pointer-events-none absolute -inset-px rounded-[inherit] group-focus-visible:[box-shadow:var(--focus,0_0_0_2px_var(--vintage-value))]\"\n          />\n          <span\n            aria-hidden\n            className=\"h-1.5 w-1.5 rounded-full\"\n            style={{\n              background: bypass ? \"var(--vintage-light)\" : \"var(--vintage-surface-1)\",\n              boxShadow: bypass\n                ? \"0 0 6px var(--vintage-light)\"\n                : \"inset 0 1px 1px rgba(0,0,0,0.8)\",\n            }}\n          />\n          BYPASS\n        </button>\n      </div>\n\n      <svg\n        ref={svgRef}\n        width={width}\n        height={height}\n        className=\"block touch-none select-none rounded-[6px]\"\n        style={{\n          // Janela rebaixada na chapa: a mesma do osciloscópio e do XY.\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          cursor: arrastando.current ? \"grabbing\" : \"default\",\n        }}\n        onPointerMove={(e) => {\n          if (arrastando.current) doPonteiro(e);\n        }}\n        onPointerUp={() => {\n          arrastando.current = null;\n        }}\n        onPointerLeave={() => {\n          arrastando.current = null;\n        }}\n      >\n        {/* Grade mínima: só o plano de 0 dB, que é a referência de tudo, e os\n            extremos da régua escritos no canto, sem linha. */}\n        <line\n          x1={0}\n          x2={width}\n          y1={dbParaY(0)}\n          y2={dbParaY(0)}\n          stroke=\"var(--vintage-border)\"\n          strokeWidth={1}\n          opacity={0.8}\n        />\n        {[range, -range].map((db) => (\n          <text\n            key={db}\n            x={4}\n            y={db > 0 ? dbParaY(db) + 9 : dbParaY(db) - 2}\n            fontSize={9}\n            fill=\"var(--vintage-text-muted)\"\n            fontFamily=\"var(--font-vintage-mono, monospace)\"\n          >\n            {db > 0 ? `+${db}` : db}\n          </text>\n        ))}\n\n        {/* Frequência: marca curta no rodapé, não linha cruzando a curva. */}\n        {MARCAS.map((m) => (\n          <g key={m.f}>\n            <line\n              x1={fParaX(m.f)}\n              x2={fParaX(m.f)}\n              y1={height - 4}\n              y2={height}\n              stroke=\"var(--vintage-border)\"\n              strokeWidth={1}\n            />\n            <text\n              x={fParaX(m.f) + 3}\n              y={height - 5}\n              fontSize={9}\n              fill=\"var(--vintage-text-muted)\"\n              fontFamily=\"var(--font-vintage-mono, monospace)\"\n            >\n              {m.t}\n            </text>\n          </g>\n        ))}\n\n        {/* O sino só da banda na mão: mostra de quem é aquela corcova da soma\n            sem encher o gráfico de cinco linhas paradas. */}\n        {!bypass && focada && (\n          <path\n            d={caminhoDoSino(focada, width, dbParaY, xParaF)}\n            fill=\"none\"\n            stroke={accent}\n            strokeWidth={1}\n            strokeDasharray=\"3 3\"\n            opacity={0.55}\n          />\n        )}\n\n        {/* A curva. Área preenchida até o plano, porque o que se lê num EQ é o\n            desvio em relação ao zero, não a linha solta no ar. */}\n        <path\n          d={`${caminho}L${width},${dbParaY(0)}L0,${dbParaY(0)}Z`}\n          fill={bypass ? \"var(--vintage-text-dim)\" : accent}\n          opacity={bypass ? 0.05 : 0.12}\n        />\n        <path\n          d={caminho}\n          fill=\"none\"\n          stroke={bypass ? \"var(--vintage-text-muted)\" : accent}\n          strokeWidth={2}\n          strokeLinejoin=\"round\"\n          strokeLinecap=\"round\"\n          style={{ transition: \"stroke var(--dur-fast,160ms) var(--ease-out, ease)\" }}\n        />\n\n        {/* Punhos */}\n        {bandas.map((b) => {\n          const x = fParaX(b.freq);\n          const y = dbParaY(bypass ? 0 : b.gain);\n          const emFoco = ativa === b.id || arrastando.current === b.id;\n          return (\n            <g\n              key={b.id}\n              // Ponto de EQ é um valor contínuo com mínimo e máximo — `slider` é\n              // o papel certo, e o ganho é o número que o leitor de tela anuncia.\n              // A frequência entra no rótulo porque é o que nomeia a banda.\n              tabIndex={0}\n              role=\"slider\"\n              aria-label={`${b.label}, ${formatarHz(b.freq)}`}\n              aria-valuemin={-range}\n              aria-valuemax={range}\n              aria-valuenow={b.gain}\n              aria-valuetext={`${b.gain > 0 ? \"+\" : \"\"}${b.gain.toFixed(1)} decibéis em ${formatarHz(b.freq)}`}\n              className=\"outline-none [&:focus-visible>circle:nth-of-type(2)]:stroke-[var(--vintage-label)]\"\n              style={{ cursor: \"grab\" }}\n              onFocus={() => setAtiva(b.id)}\n              onBlur={() => setAtiva(null)}\n              onKeyDown={(e) => {\n                const passo = e.shiftKey ? 0.1 : 1;\n                if (e.key === \"ArrowUp\" || e.key === \"ArrowDown\") {\n                  e.preventDefault();\n                  const d = e.key === \"ArrowUp\" ? passo : -passo;\n                  atualizar(b.id, {\n                    gain: Math.max(-range, Math.min(range, +(b.gain + d).toFixed(1))),\n                  });\n                } else if (e.key === \"ArrowLeft\" || e.key === \"ArrowRight\") {\n                  e.preventDefault();\n                  const fator = e.key === \"ArrowRight\" ? 1.06 : 1 / 1.06;\n                  const i = bandas.findIndex((x) => x.id === b.id);\n                  const piso = i > 0 ? bandas[i - 1].freq * 1.15 : F_MIN;\n                  const teto = i < bandas.length - 1 ? bandas[i + 1].freq / 1.15 : F_MAX;\n                  atualizar(b.id, {\n                    freq: Math.round(Math.max(piso, Math.min(teto, b.freq * fator))),\n                  });\n                } else if (e.key === \"Home\") {\n                  e.preventDefault();\n                  atualizar(b.id, { gain: 0, q: 1 });\n                }\n              }}\n              onPointerDown={(e) => {\n                arrastando.current = b.id;\n                setAtiva(b.id);\n                (e.currentTarget.ownerSVGElement as SVGSVGElement | null)?.setPointerCapture?.(\n                  e.pointerId\n                );\n              }}\n              onPointerEnter={() => setAtiva(b.id)}\n              onPointerLeave={() => {\n                if (!arrastando.current) setAtiva(null);\n              }}\n              onWheel={(e) => {\n                // Roda aperta o Q. É o gesto que todo EQ de tela usa, e é o que\n                // separa \"levantar grave\" de \"tirar aquele apito de 3 kHz\".\n                const dir = e.deltaY < 0 ? 1 : -1;\n                atualizar(b.id, {\n                  q: Math.max(0.3, Math.min(8, +(b.q + dir * 0.15).toFixed(2))),\n                });\n              }}\n              onDoubleClick={() => atualizar(b.id, { gain: 0, q: 1 })}\n            >\n              {/* Alvo generoso invisível: o círculo desenhado tem 7px de raio,\n                  o dedo recebe 22. */}\n              <circle cx={x} cy={y} r={22} fill=\"transparent\" />\n              {emFoco && !bypass && (\n                <line\n                  x1={x}\n                  x2={x}\n                  y1={y}\n                  y2={dbParaY(0)}\n                  stroke={accent}\n                  strokeWidth={1}\n                  opacity={0.5}\n                />\n              )}\n              <circle\n                cx={x}\n                cy={y}\n                r={emFoco ? 8 : 6}\n                fill=\"var(--vintage-surface-1)\"\n                stroke={bypass ? \"var(--vintage-text-muted)\" : accent}\n                strokeWidth={2}\n                style={{ transition: \"r 120ms var(--ease-out, ease)\" }}\n              />\n              <text\n                x={x}\n                y={y - 14}\n                fontSize={9}\n                textAnchor=\"middle\"\n                fill={emFoco ? \"var(--vintage-label)\" : \"var(--vintage-text-muted)\"}\n                fontFamily=\"var(--font-vintage-mono, monospace)\"\n                style={{ pointerEvents: \"none\" }}\n              >\n                {b.label}\n              </text>\n            </g>\n          );\n        })}\n      </svg>\n    </div>\n  );\n}\n\n/** Taxa de amostragem de referência pra desenhar a resposta dos biquads. */\nconst FS = 48000;\n\n/**\n * Ganho em dB de um peaking RBJ (Audio EQ Cookbook) na frequência `f`.\n *\n * É a fórmula exata do biquad, não uma gaussiana parecida: a largura sai do Q\n * do jeito que a mesa de som calcula, e a soma das bandas bate com o que um\n * `BiquadFilterNode` do tipo `peaking` toca.\n */\nfunction sinoDb(f: number, b: EqBand) {\n  if (b.gain === 0) return 0;\n  const A = Math.pow(10, b.gain / 40);\n  const w0 = (2 * Math.PI * Math.min(b.freq, FS / 2 - 1)) / FS;\n  const alpha = Math.sin(w0) / (2 * Math.max(0.1, b.q));\n  const c = Math.cos(w0);\n  const b0 = 1 + alpha * A;\n  const b1 = -2 * c;\n  const b2 = 1 - alpha * A;\n  const a0 = 1 + alpha / A;\n  const a1 = -2 * c;\n  const a2 = 1 - alpha / A;\n  // |H(e^jw)|² pelos cossenos de w e 2w.\n  const w = (2 * Math.PI * f) / FS;\n  const cw = Math.cos(w);\n  const c2w = Math.cos(2 * w);\n  const num = b0 * b0 + b1 * b1 + b2 * b2 + 2 * (b0 * b1 + b1 * b2) * cw + 2 * b0 * b2 * c2w;\n  const den = a0 * a0 + a1 * a1 + a2 * a2 + 2 * (a0 * a1 + a1 * a2) * cw + 2 * a0 * a2 * c2w;\n  return 10 * Math.log10(num / den);\n}\n\nfunction caminhoDoSino(\n  b: EqBand,\n  width: number,\n  dbParaY: (db: number) => number,\n  xParaF: (x: number) => number\n) {\n  const passos = Math.round(width / 4);\n  let d = \"\";\n  for (let i = 0; i <= passos; i++) {\n    const x = (i / passos) * width;\n    d += `${i === 0 ? \"M\" : \"L\"}${x.toFixed(1)},${dbParaY(sinoDb(xParaF(x), b)).toFixed(1)}`;\n  }\n  return d;\n}\n\nfunction formatarHz(f: number) {\n  return f >= 1000 ? `${(f / 1000).toFixed(f >= 10000 ? 1 : 2)} kHz` : `${Math.round(f)} Hz`;\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Editar curva de EQ com bandas móveis, Q na roda e bypass, em DAW ou plugin web",
      "evite": "Ajuste simples de graves e agudos em bandas fixas: vintage-eq resolve com menos curva de aprendizado"
    }
  },
  "categories": [
    "controles",
    "audio",
    "eq",
    "curva",
    "parametrico",
    "filtro"
  ],
  "type": "registry:ui"
}