{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "magnetic-cta",
  "title": "Magnetic CTA",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "O botão principal que vem buscar o ponteiro: campo de atração com medida lida uma vez, rótulo com inércia própria e volta com mola. No toque e sob reduced-motion é um botão comum.",
  "dependencies": [
    "@radix-ui/react-slot"
  ],
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/magnetic-cta.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { Slot } from \"@radix-ui/react-slot\";\n\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Magnetic CTA — o botão principal que vem buscar o ponteiro.\n *\n * O registry já tinha o `repulsive-hover`, que é o gesto oposto: o elemento\n * FOGE do cursor. Foge serve pra hero decorativo. O botão que fecha a venda\n * precisa do contrário — ele atrai, e a atração é o que faz o clique parecer\n * inevitável. Por isso são dois itens e não um com `direction=\"away\"`: as regras\n * de acessibilidade são opostas. Um elemento que foge nunca pode ser a ação\n * principal; um que atrai só pode ser a ação principal.\n *\n * ── O campo é geometria, e não um elemento que recebe ponteiro ─────────────\n *\n * A primeira versão desenhava o campo como um `<span>` com `padding: 84px` e\n * `margin: -84px` — a área de escuta crescia sem mexer no layout, e o\n * `pointerenter`/`pointerleave` do próprio span era o gatilho. Elegante, e\n * errado: um span com padding continua sendo caixa de clique. Dois CTAs lado a\n * lado com 32px de vão têm halos de 84px que se cruzam, e o halo do primeiro\n * cobre o segundo botão. Na demo da vitrine dava pra ver: o botão da direita\n * simplesmente não recebia o hover.\n *\n * Agora o campo é `pointer-events: none` — ele existe só pra reservar espaço\n * visual — e a conta de distância acontece contra um retângulo em memória. Foi\n * o que devolveu o botão vizinho.\n *\n * ── Um listener pra página inteira, não um por botão ──────────────────────\n *\n * Com o campo fora do jogo, alguém precisa saber onde o ponteiro está antes de\n * ele chegar no botão — e isso só o documento sabe. O `repulsive-hover` resolve\n * com um `mousemove` no `window` POR PEÇA: cinco peças na página, cinco\n * handlers, cinco contas por varredura do mouse.\n *\n * Aqui existe **um** listener no documento pra todas as instâncias, com um\n * `requestAnimationFrame` só. Cada peça inscrita paga quatro comparações\n * numéricas contra o retângulo em cache; quem está longe sai na primeira. É a\n * diferença entre custo por PEÇA e custo por PÁGINA.\n *\n * ── As outras decisões que valem mais que o código ────────────────────────\n *\n * 1. **A medida é lida uma vez por aproximação, não por frame.**\n *    `getBoundingClientRect()` a cada `pointermove` força layout 120 vezes por\n *    segundo pra ler um retângulo que não mudou. Lê ao entrar no campo e\n *    reinvalida no `scroll` e no `resize` — as duas únicas coisas que movem o\n *    botão enquanto o ponteiro se aproxima.\n *\n * 2. **O rótulo anda MENOS que o botão.** É o detalhe que separa \"botão que\n *    escorrega\" de \"objeto com massa\": a casca vai a 100% do puxão e o texto\n *    fica `labelLag` pra trás, então existe paralaxe dentro da peça. Sem isso o\n *    conjunto desliza inteiro e lê como bug de posicionamento.\n *\n * 3. **A volta tem overshoot; a ida não.** Indo, a peça persegue o ponteiro e\n *    qualquer overshoot vira tremor. Voltando, ela passa do ponto e assenta —\n *    é o que dá a sensação de mola solta. Por isso o `data-magnet=\"rest\"` troca\n *    a curva, e não só a duração.\n *\n * 4. **Teclado não move nada.** Ímã é gesto de ponteiro. O foco desenha o anel\n *    de `--focus` no lugar exato onde o botão está parado — se ele se deslocasse\n *    no `:focus`, o anel apontaria pra um alvo que o dedo não vai encontrar.\n *    O ímã só liga em `(hover: hover) and (pointer: fine)`; no toque, e sob\n *    `prefers-reduced-motion`, isto é um `<button>` comum. Esse é o caminho sem\n *    movimento, e ele é o padrão, não a exceção.\n *\n * Nenhuma cor mora aqui: `--brand` e `--brand-foreground` pintam, então o mesmo\n * botão sai lime numa marca e âmbar noutra sem fork.\n */\n\n/* --- o barramento de ponteiro, um pra página inteira ---------------------- */\n\ntype Assinante = (x: number, y: number) => void;\n\nconst assinantes = new Set<Assinante>();\nlet quadro = 0;\nlet ligado = false;\n\nfunction aoMover(e: PointerEvent) {\n  if (quadro) return;\n  quadro = requestAnimationFrame(() => {\n    quadro = 0;\n    for (const f of assinantes) f(e.clientX, e.clientY);\n  });\n}\n\nfunction assinar(f: Assinante) {\n  assinantes.add(f);\n  if (!ligado) {\n    // `passive`: a peça nunca chama `preventDefault`, e sem a dica o navegador\n    // precisa esperar o handler antes de decidir a rolagem.\n    document.addEventListener(\"pointermove\", aoMover, { passive: true });\n    ligado = true;\n  }\n  return () => {\n    assinantes.delete(f);\n    if (assinantes.size === 0 && ligado) {\n      document.removeEventListener(\"pointermove\", aoMover);\n      cancelAnimationFrame(quadro);\n      quadro = 0;\n      ligado = false;\n    }\n  };\n}\n\n/* --- a peça --------------------------------------------------------------- */\n\nexport interface MagneticCtaProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /**\n   * Renderiza no elemento filho em vez de um `<button>`. Use pra `<a>`, `<Link>`\n   * do Next, ou o botão do design system do cliente.\n   */\n  asChild?: boolean;\n  /**\n   * Raio do campo magnético em px, medido a partir da borda do botão. É o quanto\n   * ANTES de chegar o ponteiro começa a puxar. Abaixo de ~48px o efeito só\n   * acontece depois que o cursor já está em cima, e aí não serve pra nada.\n   */\n  field?: number;\n  /** Deslocamento máximo do botão, em px. Acima de ~14 vira escorregão. */\n  pull?: number;\n  /** Quanto o rótulo fica pra trás do botão. `0` cola o texto na casca. */\n  labelLag?: number;\n  /** Brilho que segue o ponteiro sobre a superfície. Desligue em fundo claro chapado. */\n  sheen?: boolean;\n  /** Sem `--brand`: superfície de contorno, pro CTA secundário da mesma dobra. */\n  variant?: \"solid\" | \"outline\";\n}\n\nexport function MagneticCta({\n  asChild = false,\n  field = 84,\n  pull = 10,\n  labelLag = 0.35,\n  sheen = true,\n  variant = \"solid\",\n  className,\n  children,\n  disabled,\n  type,\n  ...props\n}: MagneticCtaProps) {\n  const fieldRef = React.useRef<HTMLSpanElement>(null);\n  const buttonRef = React.useRef<HTMLElement | null>(null);\n\n  const Comp = asChild ? Slot : \"button\";\n\n  const brilho =\n    sheen && variant === \"solid\" ? (\n      <span aria-hidden=\"true\" className=\"magnet-sheen pointer-events-none absolute inset-0 -z-10\" />\n    ) : null;\n  const rotulo = (filhos: React.ReactNode) => (\n    <span className=\"magnet-label inline-flex items-center gap-2\">{filhos}</span>\n  );\n  // Slot exige UM filho. Com asChild o brilho e o rótulo entram DENTRO do\n  // elemento do consumidor (o <a>), em vez de irmãos dele: senão o Slot recebe\n  // dois filhos e quebra, ou fatia o rótulo como se fosse o link.\n  const content =\n    asChild && React.isValidElement<{ children?: React.ReactNode }>(children)\n      ? React.cloneElement(children, undefined, brilho, rotulo(children.props.children))\n      : (\n          <>\n            {brilho}\n            {rotulo(children)}\n          </>\n        );\n\n  React.useEffect(() => {\n    const host = fieldRef.current;\n    if (!host || disabled) return;\n\n    // Duas perguntas, uma resposta: se qualquer uma falha, a peça é um botão.\n    // `pointer: fine` exclui o toque (onde não existe hover) e a TV.\n    const fine = window.matchMedia(\"(hover: hover) and (pointer: fine)\");\n    const still = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    if (!fine.matches || still.matches) return;\n\n    let rect: DOMRect | null = null;\n    let dentro = false;\n\n    const alvo = () => (buttonRef.current ?? host.firstElementChild) as HTMLElement | null;\n    const medir = () => (rect = alvo()?.getBoundingClientRect() ?? null);\n\n    // O `scroll` invalida a medida em vez de recalcular: quem vai precisar dela\n    // é a próxima aproximação, e ela pode nunca vir (a pessoa rolou e foi\n    // embora). Medir ali seria pagar layout por um valor que ninguém lê.\n    const invalidar = () => {\n      rect = null;\n    };\n\n    const soltar = () => {\n      dentro = false;\n      host.dataset.magnet = \"rest\";\n      host.style.setProperty(\"--mx\", \"0px\");\n      host.style.setProperty(\"--my\", \"0px\");\n    };\n\n    const cancelar = assinar((x, y) => {\n      if (!rect) medir();\n      if (!rect) return;\n\n      // O portão barato: quatro comparações. Quem está longe do botão sai aqui,\n      // e é por isso que um listener global não custa nada mesmo com dez CTAs.\n      const perto =\n        x >= rect.left - field &&\n        x <= rect.right + field &&\n        y >= rect.top - field &&\n        y <= rect.bottom + field;\n\n      if (!perto) {\n        if (dentro) soltar();\n        return;\n      }\n\n      if (!dentro) {\n        dentro = true;\n        medir();\n        host.dataset.magnet = \"hold\";\n      }\n\n      const cx = rect!.left + rect!.width / 2;\n      const cy = rect!.top + rect!.height / 2;\n\n      // Normaliza por meia-caixa MAIS o campo: assim a força é 0 na borda do\n      // campo e 1 no centro do botão, independente do tamanho do botão. Um\n      // divisor fixo faria o CTA largo puxar menos que o estreito.\n      const clamp = (v: number) => Math.max(-1, Math.min(1, v));\n      const nx = clamp((x - cx) / (rect!.width / 2 + field));\n      const ny = clamp((y - cy) / (rect!.height / 2 + field));\n\n      host.style.setProperty(\"--mx\", `${nx * pull}px`);\n      host.style.setProperty(\"--my\", `${ny * pull}px`);\n\n      // O brilho é a posição do ponteiro DENTRO do botão, em %, e passa de\n      // 0–100 enquanto o cursor ainda está no campo. É o certo: o brilho entra\n      // pela beirada antes de o dedo chegar.\n      if (sheen) {\n        host.style.setProperty(\"--sx\", `${((x - rect!.left) / rect!.width) * 100}%`);\n        host.style.setProperty(\"--sy\", `${((y - rect!.top) / rect!.height) * 100}%`);\n      }\n    });\n\n    window.addEventListener(\"scroll\", invalidar, { passive: true });\n    window.addEventListener(\"resize\", invalidar);\n    // Sai a aba, sai o ímã: sem isto o botão fica torto esperando um ponteiro\n    // que voltou noutro lugar da tela.\n    document.addEventListener(\"pointerleave\", soltar);\n\n    return () => {\n      cancelar();\n      soltar();\n      window.removeEventListener(\"scroll\", invalidar);\n      window.removeEventListener(\"resize\", invalidar);\n      document.removeEventListener(\"pointerleave\", soltar);\n    };\n  }, [field, pull, sheen, disabled]);\n\n  return (\n    <span\n      ref={fieldRef}\n      data-magnet=\"rest\"\n      // `padding` positivo com `margin` negativa do mesmo tamanho: a peça\n      // reserva o halo sem empurrar o vizinho no layout. E `pointer-events:\n      // none` no campo com `auto` no botão — ver a nota sobre halos que se\n      // cruzam. O campo é geometria; quem recebe ponteiro é o botão.\n      className=\"magnet-field pointer-events-none relative isolate inline-flex\"\n      style={\n        { padding: field, margin: -field, \"--lag\": labelLag } as React.CSSProperties\n      }\n    >\n      <Comp\n        ref={buttonRef as React.Ref<HTMLButtonElement>}\n        // Sem isto, um CTA dentro de `<form>` vira `type=\"submit\"` por padrão do\n        // HTML e envia o formulário no primeiro clique. É o defeito que só\n        // aparece no cliente que colocou o botão dentro de um form.\n        type={asChild ? type : (type ?? \"button\")}\n        disabled={disabled}\n        data-variant={variant}\n        className={cn(\n          \"magnet-body group/magnet pointer-events-auto relative isolate inline-flex select-none items-center justify-center gap-2 overflow-hidden pointer-coarse:min-h-11\",\n          \"h-[var(--control-h,2.75rem)] rounded-[var(--r-pill,9999px)] px-6\",\n          \"text-[length:var(--text-corpo,0.9375rem)] font-medium tracking-[-0.01em]\",\n          \"outline-none focus-visible:[box-shadow:var(--focus)]\",\n          \"[transform:translate3d(var(--mx,0px),var(--my,0px),0)]\",\n          \"active:scale-[0.97] active:[transition-duration:var(--dur-press,90ms)]\",\n          \"disabled:pointer-events-none disabled:opacity-50\",\n          variant === \"solid\"\n            ? \"bg-[var(--brand,var(--foreground))] text-[var(--brand-foreground,var(--background))]\"\n            : \"border border-border bg-transparent text-foreground\",\n          className,\n        )}\n        {...props}\n      >\n        {content}\n      </Comp>\n    </span>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "css": {
    ".magnet-body": {
      "transition": "transform var(--dur-base, 240ms) var(--ease-out, cubic-bezier(0.22, 0.61, 0.36, 1)), scale var(--dur-fast, 140ms) var(--ease-out, cubic-bezier(0.22, 0.61, 0.36, 1)), background-color var(--dur-fast, 140ms) linear"
    },
    ".magnet-field[data-magnet=hold] .magnet-body": {
      "will-change": "transform"
    },
    ".magnet-field[data-magnet=rest] .magnet-body, .magnet-field[data-magnet=rest] .magnet-label": {
      "transition-duration": "620ms",
      "transition-timing-function": "cubic-bezier(0.22, 1.35, 0.36, 1)"
    },
    ".magnet-label": {
      "transform": "translate3d(calc(var(--mx, 0px) * var(--lag, 0.35) * -1), calc(var(--my, 0px) * var(--lag, 0.35) * -1), 0)",
      "transition": "transform var(--dur-base, 240ms) var(--ease-out, cubic-bezier(0.22, 0.61, 0.36, 1))"
    },
    ".magnet-sheen": {
      "background": "radial-gradient(130px 130px at var(--sx, 50%) var(--sy, 50%), color-mix(in oklab, var(--brand-foreground, var(--background)) 24%, transparent), transparent 72%)",
      "opacity": "0",
      "transition": "opacity var(--dur-base, 240ms) var(--ease-out, cubic-bezier(0.22, 0.61, 0.36, 1))"
    },
    ".magnet-field[data-magnet=hold] .magnet-sheen": {
      "opacity": "1"
    },
    "@media (prefers-reduced-motion: reduce)": {
      ".magnet-body, .magnet-label": {
        "transform": "none",
        "transition": "none"
      },
      ".magnet-sheen": {
        "display": "none"
      }
    },
    ".magnet-field[data-magnet=rest] .magnet-sheen": {
      "transition-duration": "var(--dur-fast, 140ms)"
    }
  },
  "meta": {
    "uso": {
      "quando": "Botão principal de landing que vem buscar o ponteiro, numa dobra de conversão com espaço em volta",
      "evite": "Botão em formulário ou lista densa: botão do tema; bloco completo de conversão, cta-surface"
    }
  },
  "categories": [
    "controles",
    "cta",
    "botao",
    "ima",
    "hover",
    "conversao"
  ],
  "type": "registry:ui"
}