{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "turbulence-field",
  "title": "Turbulence Field",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Ruído animado em SVG para dar vida a uma superfície parada.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/turbulence-field.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Névoa procedural para estados de espera — SVG `feTurbulence` puro.\n *\n * A alternativa óbvia (shader/WebGL) morre no caso real: uma grade de 12 tiles\n * gerando ao mesmo tempo estoura o limite de contextos WebGL do browser e os\n * primeiros tiles apagam. Isto é filtro SVG animado pelo compositor — escala\n * para qualquer número de instâncias e não gasta um frame de JS.\n *\n * A cor vem de `currentColor`, então herda o token da marca sem hex próprio.\n *\n * `baseFrequency` animada em 14s: devagar o bastante para ler como fluido, não\n * como ruído de TV. Encurtar isso é a tentação errada.\n *\n * `prefers-reduced-motion`: congela a turbulência (a textura fica, o movimento sai).\n *\n * ── Os três botões do campo ────────────────────────────────────────────────\n *\n * `intensity` (quanto se vê), `scale` (o tamanho do grão) e `speed` (quanto\n * demora um ciclo) são as únicas variáveis que mudam o CARÁTER da névoa, e é por\n * isso que são props em vez de números fixos: com a mesma peça e três valores\n * dá pra ir de névoa larga de fundo de marca a grão fechado de papel impresso.\n * `octaves` fica fora — subir de 2 multiplica o custo do filtro por passada sem\n * mudar a leitura em opacidade baixa.\n */\nexport function TurbulenceField({\n  intensity = 0.18,\n  scale = 1,\n  speed = 14,\n  className,\n}: {\n  /** Alpha total da névoa (0–1). Sutil — acima de ~0.3 come o conteúdo. */\n  intensity?: number;\n  /**\n   * Multiplicador do grão. `<1` abre a névoa (manchas largas, fundo de marca);\n   * `>1` fecha (grão de papel).\n   */\n  scale?: number;\n  /** Segundos de um ciclo. Abaixo de ~6s começa a ler como ruído de TV. */\n  speed?: number;\n  className?: string;\n}) {\n  // id único por instância: dois filtros com o mesmo id no DOM e um apaga o outro.\n  const filterId = `turb-${React.useId().replace(/[^a-zA-Z0-9]/g, \"\")}`;\n  const [reduced, setReduced] = React.useState(false);\n\n  React.useEffect(() => {\n    if (typeof window === \"undefined\" || !window.matchMedia) return;\n    const mq = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    const onChange = () => setReduced(mq.matches);\n    onChange();\n    mq.addEventListener?.(\"change\", onChange);\n    return () => mq.removeEventListener?.(\"change\", onChange);\n  }, []);\n\n  // O par base é o que foi calibrado no olho; `scale` mexe nos dois juntos pra\n  // não deformar o grão numa direção só.\n  const fx = (0.011 * scale).toFixed(4);\n  const fy = (0.014 * scale).toFixed(4);\n  const fx2 = (0.016 * scale).toFixed(4);\n  const fy2 = (0.02 * scale).toFixed(4);\n  const base = `${fx} ${fy}`;\n\n  return (\n    <svg\n      aria-hidden=\"true\"\n      className={cn(\n        // `text-[var(--brand,…)]` e não `text-brand`: `brand` não é cor do tema\n        // do Tailwind (não existe `--color-brand`), então a classe curta não\n        // gerava regra nenhuma e o campo caía no `currentColor` herdado —\n        // névoa cinza numa peça que se anuncia como cor da marca.\n        \"pointer-events-none absolute inset-0 h-full w-full text-[var(--brand,currentColor)]\",\n        className,\n      )}\n      style={{ opacity: intensity }}\n      preserveAspectRatio=\"xMidYMid slice\"\n    >\n      <filter id={filterId} x=\"0\" y=\"0\" width=\"100%\" height=\"100%\">\n        <feTurbulence\n          type=\"fractalNoise\"\n          baseFrequency={base}\n          numOctaves={2}\n          seed={7}\n          stitchTiles=\"stitch\"\n          result=\"noise\"\n        >\n          {!reduced && (\n            <animate\n              // `key` força o SMIL a reiniciar quando o preset muda: sem isso o\n              // Chrome mantém a animação antiga rodando com os valores velhos.\n              key={`${base}-${speed}`}\n              attributeName=\"baseFrequency\"\n              dur={`${speed}s`}\n              values={`${fx} ${fy};${fx2} ${fy2};${fx} ${fy}`}\n              calcMode=\"spline\"\n              keyTimes=\"0;0.5;1\"\n              keySplines=\"0.4 0 0.2 1;0.4 0 0.2 1\"\n              repeatCount=\"indefinite\"\n            />\n          )}\n        </feTurbulence>\n        {/* tinge o ruído com currentColor, usando o alpha do ruído como máscara */}\n        <feFlood floodColor=\"currentColor\" result=\"tint\" />\n        <feComposite in=\"tint\" in2=\"noise\" operator=\"in\" />\n      </filter>\n      <rect width=\"100%\" height=\"100%\" filter={`url(#${filterId})`} />\n    </svg>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Fundo de névoa leve em tile de espera, inclusive vários na mesma grade, sem WebGL",
      "evite": "Fundo de hero que reage ao ponteiro: spring-dots ou um shader-*; malha parada, grid-dots"
    }
  },
  "categories": [
    "efeitos",
    "ruido",
    "svg"
  ],
  "type": "registry:ui"
}