{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "line-reveal",
  "title": "Line Reveal",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "O título que sobe de dentro do próprio corte de linha: mede a quebra depois da fonte carregar, re-quebra ao redimensionar, e o esconderijo é aplicado por JS pra página nunca sumir sem script.",
  "dependencies": [
    "gsap"
  ],
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/line-reveal.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport gsap from \"gsap\";\nimport { ScrollTrigger } from \"gsap/ScrollTrigger\";\nimport { SplitText } from \"gsap/SplitText\";\n\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Line Reveal — o título que sobe de dentro do próprio corte de linha.\n *\n * ── Por que existe, tendo três vizinhos ────────────────────────────────────\n *\n * A casa já tem entrada de dobra em três lugares, e nenhum resolve ESTE caso:\n *\n * · `@visant/fold-motion` (variant `mask`) mascara o BLOCO inteiro com\n *   `clip-path` — o título aparece de baixo pra cima como um só objeto. Bonito,\n *   mas não é revelação por linha: quatro linhas entram grudadas.\n * · `@visant/motion-layer` (`data-reveal=\"lines\"`) faz a máscara por linha, só\n *   que exige que VOCÊ já tenha quebrado o texto em elementos filhos. Serve pra\n *   Shopify, onde o Liquid escreve `<span>` por linha na mão. Num React em que\n *   a copy vem de CMS e a quebra depende da largura, isso é impossível.\n * · `@visant/glitch-chars` é textura, não entrada.\n *\n * O que falta é o caro: **descobrir onde a linha quebra** — e isso só o\n * navegador sabe, depois do layout, depois da fonte carregar. É o trabalho do\n * `SplitText`, plugin oficial do GSAP e livre desde a 3.13. Escrever um\n * medidor de linha à mão (`Range.getClientRects()` + agrupar por `top`) é o\n * clássico \"duas tardes pra empatar com uma lib madura\": não faz.\n *\n * ── As quatro armadilhas, todas pagas em campo ─────────────────────────────\n *\n * 1. **Quebrar antes da fonte carregar quebra no lugar errado.** Com a fonte\n *    de fallback, \"estratégia\" cabe na linha 2; com a Syncopate carregada, não\n *    cabe — e as máscaras ficam desalinhadas do texto pra sempre, porque o\n *    split já congelou. Por isso o efeito espera `document.fonts.ready` ANTES\n *    de medir. É a diferença entre funcionar na sua máquina (fonte em cache) e\n *    quebrar no primeiro acesso do cliente.\n * 2. **O esconderijo é aplicado por JS, nunca por CSS estático.** Se o CSS\n *    nascesse com `opacity: 0`, um erro de hidratação, um bloqueio de script ou\n *    um crawler deixariam o título invisível pra sempre. Aqui o texto nasce\n *    legível e só some no mesmo quadro em que o trigger é criado. Regra herdada\n *    do `fold-motion`, e é a que impede a página de sumir.\n * 3. **`overflow: hidden` na linha decepa descendente.** A caixa da linha é\n *    exatamente o `line-height`; o \"g\" e o \"ç\" vazam por baixo. A máscara ganha\n *    folga (`paddingBottom` + `marginBottom` negativa) — assim o corte é o topo,\n *    que é o que a animação usa, e a barriga da letra fica inteira.\n * 4. **Redimensionar re-quebra a linha.** Sem `autoSplit`, girar o telefone\n *    deixa as máscaras de uma medida e o texto de outra. O plugin refaz o split\n *    e o `onSplit` reconstrói a timeline — por isso a animação vive DENTRO do\n *    callback, e não fora dele.\n *\n * ── Acessibilidade ─────────────────────────────────────────────────────────\n *\n * `aria: true` faz o SplitText marcar os pedaços com `aria-hidden` e devolver a\n * frase inteira no `aria-label` do container: o leitor de tela ouve a frase, não\n * quatro fragmentos. E `revert()` no unmount devolve o DOM original — sem isso,\n * copiar o título colava um texto cheio de quebras invisíveis.\n *\n * Sob `prefers-reduced-motion` não há split nenhum: o texto simplesmente está\n * lá. Movimento é o que se corta; o desfecho (o título legível) não.\n *\n * ── Duração ────────────────────────────────────────────────────────────────\n *\n * 0.9s passa o teto de 300ms da casa de propósito: o teto governa CONTROLE\n * respondendo a clique. Isto é entrada de dobra na rolagem — pode ser longa e\n * deliberada, igual ao `count-up`.\n *\n * ── As quatro revelações, e as que ficaram de fora ─────────────────────────\n *\n * A peça nasceu com uma só (`mask`), e uma revelação de título não é uma —\n * são poucas e conhecidas. As que entram:\n *\n * | `variant` | o que faz | quando |\n * |---|---|---|\n * | `mask` | a linha sobe de dentro do próprio corte | título de dobra, o padrão |\n * | `blur` | desfoca e assenta, com 14px de subida | copy longa, onde a máscara pesa |\n * | `curtain` | limpa a linha da esquerda pra direita | eyebrow, rótulo, linha curta |\n * | `rise` | sobe sem máscara, com fade | quando o corte não pode existir (item com sombra ou descendente vazando) |\n *\n * E as que **não** entram, porque o report pediu isso por escrito: nada de\n * `back`/`elastic` (o texto volta atrás e a leitura para), nada de escala (o\n * título muda de tamanho no meio da entrada e o layout parece instável), nada\n * de rotação. Todos os eases são `out` ou `inOut` — a linha chega e fica.\n *\n * A troca de variante troca ease e propriedade animada, e mais nada: a medida\n * da quebra, a espera pela fonte e o `autoSplit` são os mesmos nos quatro.\n */\n\ngsap.registerPlugin(ScrollTrigger, SplitText);\n\nexport interface LineRevealProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** O texto. Pode conter `<em>`, `<br>`, link — o split preserva a marcação. */\n  children: React.ReactNode;\n  /** Elemento renderizado. Título de dobra é `h2`; topo de página é `h1`. */\n  as?: \"h1\" | \"h2\" | \"h3\" | \"p\" | \"div\";\n  /**\n   * O que se quebra. `lines` é a revelação de título; `words` serve a frases\n   * curtas onde a linha inteira subindo parece pesada demais.\n   */\n  split?: \"lines\" | \"words\";\n  /** Atraso entre linhas, em segundos. Teto embutido: nunca passa de 0.4s no total. */\n  stagger?: number;\n  /** Onde na tela o gatilho arma. `top 88%` = a dobra entrou um oitavo. */\n  start?: string;\n  /**\n   * Anima na montagem, sem esperar a rolagem. Para o herói do topo, que já está\n   * visível quando a página abre — ali um ScrollTrigger nunca dispararia bem.\n   */\n  immediate?: boolean;\n  /** Repete a cada passagem. Padrão é uma vez só: entrada que repete vira enfeite. */\n  repeat?: boolean;\n  /** Qual revelação. Ver a tabela no cabeçalho. */\n  variant?: LineRevealVariant;\n}\n\nexport type LineRevealVariant = \"mask\" | \"blur\" | \"curtain\" | \"rise\";\n\nconst MAX_STAGGER_TOTAL = 0.4;\n\n/**\n * A receita de cada variante: só o par de estados e o ease.\n *\n * Ficam num mapa e não num `if` espalhado porque é assim que se vê, de um\n * olhar, que nenhuma delas tem `back`, `elastic` ou escala — a regra que o\n * report pediu e a que é fácil de furar quando a quinta variante chegar.\n *\n * `mask` é a única que precisa da máscara do plugin: as outras três animam\n * propriedade que o corte da linha atrapalharia (o desfoque vazaria pela\n * borda, o `clip-path` já é o próprio corte).\n */\n// Título entrando no scroll: marketing, acima do teto de UI de propósito.\nconst LONGO = { mask: 0.9, blur: 0.75, curtain: 0.8, rise: 0.7 } as const;\n\nconst RECEITAS: Record<\n  LineRevealVariant,\n  { de: gsap.TweenVars; para: gsap.TweenVars; mascara: boolean }\n> = {\n  mask: {\n    de: { yPercent: 108 },\n    para: { yPercent: 0, duration: LONGO.mask, ease: \"power3.out\" },\n    mascara: true,\n  },\n  blur: {\n    de: { autoAlpha: 0, y: 14, filter: \"blur(10px)\" },\n    para: { autoAlpha: 1, y: 0, filter: \"blur(0px)\", duration: LONGO.blur, ease: \"power2.out\" },\n    mascara: false,\n  },\n  curtain: {\n    de: { clipPath: \"inset(0 100% 0 0)\" },\n    // `inOut` porque a cortina TEM as duas pontas conhecidas e atravessa a\n    // linha inteira — mesmo critério do `@visant/photo-compare`.\n    para: { clipPath: \"inset(0 0% 0 0)\", duration: LONGO.curtain, ease: \"power2.inOut\" },\n    mascara: false,\n  },\n  rise: {\n    de: { autoAlpha: 0, y: 22 },\n    para: { autoAlpha: 1, y: 0, duration: LONGO.rise, ease: \"power3.out\" },\n    mascara: false,\n  },\n};\n\nexport function LineReveal({\n  children,\n  as: Tag = \"h2\",\n  split = \"lines\",\n  stagger = 0.07,\n  start = \"top 88%\",\n  immediate = false,\n  repeat = false,\n  variant = \"mask\",\n  className,\n  ...props\n}: LineRevealProps) {\n  const ref = React.useRef<HTMLDivElement>(null);\n\n  React.useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    if (window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches) return;\n\n    let ctx: gsap.Context | undefined;\n    let split_: SplitText | undefined;\n    let cancelled = false;\n\n    // A fonte primeiro, o corte depois. Ver armadilha 1.\n    document.fonts.ready.then(() => {\n      if (cancelled) return;\n\n      const receita = RECEITAS[variant];\n\n      ctx = gsap.context(() => {\n        split_ = SplitText.create(el, {\n          type: split,\n          // A máscara é criada pelo próprio plugin, com a folga de descendente\n          // já resolvida — é para isso que serve `mask`, e é melhor que um\n          // wrapper nosso porque acompanha o re-split do `autoSplit`.\n          mask: receita.mascara ? split : undefined,\n          linesClass: \"line-reveal-line\",\n          wordsClass: \"line-reveal-word\",\n          autoSplit: true,\n          aria: \"auto\",\n          onSplit(self) {\n            const parts = split === \"lines\" ? self.lines : self.words;\n            if (!parts.length) return;\n\n            // O teto do atraso acumulado: passou de ~400ms a cascata vira\n            // desfile. Num título de 6 linhas o passo se aperta sozinho.\n            const amount = Math.min(parts.length * stagger, MAX_STAGGER_TOTAL);\n\n            return gsap.fromTo(parts, receita.de, {\n              ...receita.para,\n              stagger: { each: stagger, amount },\n              scrollTrigger: immediate\n                ? undefined\n                : { trigger: el, start, once: !repeat, toggleActions: \"play none none reverse\" },\n            });\n          },\n        });\n      }, el);\n    });\n\n    return () => {\n      cancelled = true;\n      // Ordem importa: matar a timeline antes de desfazer o split, senão o GSAP\n      // segue animando nós que já saíram do documento.\n      ctx?.revert();\n      split_?.revert();\n    };\n  }, [split, stagger, start, immediate, repeat, variant]);\n\n  return (\n    <Tag\n      ref={ref as React.Ref<never>}\n      className={cn(\n        \"text-balance [font-family:var(--font-display,inherit)]\",\n        \"text-[var(--foreground)]\",\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </Tag>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "css": {
    "@layer components": {
      ".line-reveal-line, .line-reveal-word": {
        "will-change": "transform"
      }
    }
  },
  "meta": {
    "uso": {
      "quando": "Título de hero ou dobra que sobe linha por linha de dentro do próprio corte",
      "evite": "Texto saindo do desfoque por palavra: mist-text; rótulo curto trocando, text-morph"
    }
  },
  "categories": [
    "texto",
    "titulo",
    "reveal",
    "linha",
    "split",
    "gsap",
    "heroi",
    "tipografia"
  ],
  "type": "registry:ui"
}