{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sticky-filterbar",
  "title": "Sticky Filterbar",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Barra de filtro que gruda abaixo do cabeçalho sem medir altura na mão e sem pular no scroll.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/sticky-filterbar.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * StickyFilterbar — barra de filtro que gruda e condensa.\n *\n * Colhida de um concept de e-commerce. É utilidade antes de ser efeito: com a\n * barra alta grudada, sobra menos grade na tela — e a grade é o que o comprador\n * veio ver. Cada pixel da barra é um pixel a menos de produto.\n *\n * ── O gotcha que custou caro ────────────────────────────────────────────────\n * A altura do cabeçalho **não pode ser chutada**. Ela muda com o viewport: no\n * O concept mediu 123px no desktop e **163px a 390px**, porque a busca\n * desce de linha. Um número fixo no CSS deixa a barra escondida atrás do header\n * em um dos dois casos.\n *\n * Por isso o componente MEDE o header e publica em `--header-h`, com\n * `ResizeObserver` e `document.fonts.ready` — a altura muda de novo quando a\n * fonte carrega.\n *\n * As linhas marcadas `collapsible` somem quando a barra está grudada. Mantenha\n * ali o que é refinamento e deixe fora o que é o filtro principal: o usuário\n * precisa continuar enxergando o eixo pelo qual está navegando.\n *\n * ── O que faltava (por que parecia barata) ──────────────────────────────────\n * A barra grudava e não CONTAVA nada. Grudada e solta eram quase o mesmo\n * desenho — uma sombra de 0.5 de opacidade que ninguém vê — então o momento em\n * que ela passa a flutuar sobre a lista simplesmente não aparecia. E o que ela\n * governa (a grade que rola por baixo) não tinha leitura nenhuma: a pessoa\n * filtra, rola, e perde a noção de onde está na lista que acabou de filtrar.\n *\n * Duas coisas entram, as duas de graça em pixel:\n *\n * 1. **O estado grudado é visível**: o respiro vertical fecha e a sombra ganha\n *    peso de verdade. Grudar é um evento; evento tem desenho.\n * 2. **Um fio de progresso no pé da barra**, mostrando quanto da região que ela\n *    governa já passou. Só aparece grudada — solta, a régua seria ruído.\n *\n * ── O que este componente NÃO faz (de propósito) ────────────────────────────\n * O fio é escrito direto no DOM por `ref`, dentro do mesmo listener de scroll\n * que já existia, e só como `transform`. Nada de `setState` por quadro de\n * rolagem, e principalmente nada que mude a ALTURA de coisa alguma: este item\n * já foi a origem de um loop de `ResizeObserver` que inchava a página para\n * sempre (o caso está escrito em `src/styles/tailwind.css` da vitrine). A\n * regra que ficou é medir uma coisa só, o cabeçalho, e escrever só em\n * `--header-h`. `transform` não entra em layout, então não realimenta o\n * observador.\n *\n * O colapso das linhas `collapsible` não anima altura: animar altura para\n * disfarçar é exatamente o tipo de coisa que reabre o loop acima. A micro\n * transição é só de opacidade e de um deslize de 4px (`translate`, fora do\n * layout): a linha apaga, e só no fim o `display: none` entra\n * (`transition-behavior: allow-discrete`). Na volta ela nasce apagada\n * (`@starting-style`) e acende. A altura troca uma vez, seca, como antes.\n */\n\nexport interface StickyFilterbarProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Seletor do cabeçalho grudado a medir. */\n  headerSelector?: string;\n  /**\n   * Desliga o fio de progresso. Aditivo: ligado por padrão, e some sozinho\n   * quando a região governada não rola o bastante para haver progresso.\n   */\n  hideProgress?: boolean;\n  children: React.ReactNode;\n}\n\nexport function StickyFilterbar({\n  headerSelector = \"header\",\n  hideProgress = false,\n  children,\n  className,\n  ...props\n}: StickyFilterbarProps) {\n  const ref = React.useRef<HTMLDivElement>(null);\n  const fio = React.useRef<HTMLSpanElement>(null);\n  const [condensed, setCondensed] = React.useState(false);\n\n  // Mede o header e publica a altura real como custom property.\n  React.useEffect(() => {\n    const header = document.querySelector<HTMLElement>(headerSelector);\n    if (!header) return;\n\n    const apply = () => {\n      const h = Math.round(header.getBoundingClientRect().height);\n      document.documentElement.style.setProperty(\"--header-h\", `${h}px`);\n    };\n\n    apply();\n    const ro = new ResizeObserver(apply);\n    ro.observe(header);\n    // A altura muda quando a fonte troca de fallback para a real.\n    document.fonts?.ready.then(apply).catch(() => {});\n    return () => ro.disconnect();\n  }, [headerSelector]);\n\n  /**\n   * Condensa exatamente onde encosta — não num número solto, que produziria uma\n   * piscada no meio do scroll.\n   *\n   * A linha onde a barra encosta era lida como `--header-h` puro, o que só vale\n   * quando quem rola é a PÁGINA. Dentro de um contêiner com rolagem própria\n   * (uma demo, um painel, um modal com lista) a barra grudava de verdade — o\n   * CSS faz isso sozinho — e o componente nunca percebia: nem condensava, nem\n   * media progresso. Agora a linha sai de onde ela realmente está: o `top`\n   * computado da própria barra (o browser já resolveu o `var()` ali) somado ao\n   * topo do contêiner que rola. Sem contêiner, o topo é 0 e a conta é\n   * idêntica à antiga — o comportamento na página não muda.\n   */\n  React.useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n\n    /** O ancestral que realmente rola, ou `null` quando é a página. */\n    const rolante = (): HTMLElement | null => {\n      for (let p = el.parentElement; p && p !== document.body; p = p.parentElement) {\n        const oy = getComputedStyle(p).overflowY;\n        if ((oy === \"auto\" || oy === \"scroll\") && p.scrollHeight > p.clientHeight) return p;\n      }\n      return null;\n    };\n\n    const onScroll = () => {\n      const box = el.getBoundingClientRect();\n      const caixa = rolante();\n      const topo = caixa ? caixa.getBoundingClientRect().top : 0;\n      const grude = topo + (parseFloat(getComputedStyle(el).top) || 0);\n      // Encostar no topo não basta: uma barra que já nasce colada embaixo do\n      // cabeçalho estaria \"grudada\" com a rolagem em zero, e condensaria antes\n      // de a pessoa mexer, escondendo a linha secundária de cara.\n      const rolou = (caixa ? caixa.scrollTop : window.scrollY) > 0;\n      setCondensed(rolou && box.top <= grude + 1);\n\n      // Quanto da região governada já passou. A região é o pai da barra: é\n      // dentro dele que a barra gruda, então é ele que a barra \"cobre\".\n      //\n      // Dois casos, e confundir os dois deixa o fio parado:\n      //\n      // • Quando o pai É o contêiner que rola, o retângulo dele não sai do\n      //   lugar — quem anda é o conteúdo por dentro. Aí a medida é `scrollTop`\n      //   sobre o percurso rolável.\n      // • Quando quem rola é a página, o pai sobe junto com a rolagem. Aí a\n      //   medida é a distância que a barra grudada ganhou do topo da região.\n      //\n      // Escrito direto no nó, sem estado: um `setState` por quadro de rolagem\n      // renderizaria a barra inteira dezenas de vezes por segundo.\n      const linha = fio.current;\n      const regiao = el.parentElement;\n      if (!linha || !regiao) return;\n\n      let percurso: number;\n      let andado: number;\n      if (regiao === caixa) {\n        percurso = regiao.scrollHeight - regiao.clientHeight;\n        andado = regiao.scrollTop;\n      } else {\n        const r = regiao.getBoundingClientRect();\n        percurso = r.height - box.height;\n        andado = box.top - r.top;\n      }\n      const p = percurso > 8 ? Math.min(1, Math.max(0, andado / percurso)) : 0;\n      linha.style.transform = `scaleX(${p})`;\n    };\n\n    onScroll();\n    // `capture` no documento, e não `scroll` na window: evento de rolagem não\n    // borbulha, então um contêiner interno que rola nunca chegaria na window —\n    // era esse o motivo de a barra ficar muda fora da rolagem de página.\n    document.addEventListener(\"scroll\", onScroll, { passive: true, capture: true });\n    window.addEventListener(\"resize\", onScroll, { passive: true });\n    return () => {\n      document.removeEventListener(\"scroll\", onScroll, { capture: true });\n      window.removeEventListener(\"resize\", onScroll);\n    };\n  }, []);\n\n  return (\n    <div\n      ref={ref}\n      data-condensed={condensed || undefined}\n      className={cn(\n        \"sticky z-30 border-b border-[var(--border)] bg-[var(--background)]\",\n        \"[top:var(--header-h,0px)]\",\n        // Só cor e sombra transicionam. `transform` do fio fica de fora porque\n        // ele acompanha a rolagem — transição ali viraria atraso.\n        \"transition-[box-shadow,border-color] [transition-duration:var(--dur-base,200ms)] [transition-timing-function:var(--ease-out,ease)]\",\n        // Grudada, a barra deixa de ser parte do fluxo e passa a flutuar sobre\n        // a lista. A sombra antiga era transparente demais para dizer isso — e\n        // a cor crua `rgb(0 0 0/.5)` também não era token de casa nenhuma.\n        condensed\n          ? \"[box-shadow:0_10px_20px_-16px_color-mix(in_oklab,var(--foreground)_60%,transparent)]\"\n          : \"[box-shadow:0_0_0_0_transparent]\",\n        // Grudada o respiro fecha: cada pixel da barra é um pixel a menos de\n        // produto na tela.\n        \"[&[data-condensed]_[data-collapsible]]:hidden [&[data-condensed]_[data-collapsible]]:-translate-y-1 [&[data-condensed]_[data-collapsible]]:opacity-0\",\n        \"[&[data-condensed]_[data-filter-row]]:py-2\",\n        className,\n      )}\n      {...props}\n    >\n      {children}\n\n      {/*\n       * O fio. Fora do fluxo e `pointer-events-none`: ele não pode empurrar\n       * layout nem roubar clique de chip nenhum. `origin-left` + `scaleX` para\n       * o percurso ser `transform` puro.\n       */}\n      {hideProgress ? null : (\n        <span\n          ref={fio}\n          aria-hidden=\"true\"\n          className={cn(\n            \"pointer-events-none absolute inset-x-0 bottom-[-1px] h-[2px] origin-left bg-[var(--brand)]\",\n            \"transition-opacity [transition-duration:var(--dur-fast,160ms)] [transition-timing-function:var(--ease-out,ease)]\",\n            condensed ? \"opacity-100\" : \"opacity-0\",\n          )}\n          style={{ transform: \"scaleX(0)\" }}\n        />\n      )}\n    </div>\n  );\n}\n\n/**\n * Uma linha da barra. `collapsible` some quando grudada — use nas facetas\n * secundárias, nunca no eixo principal.\n */\nexport function FilterRow({\n  label,\n  collapsible = false,\n  children,\n  className,\n  ...props\n}: React.HTMLAttributes<HTMLDivElement> & { label?: string; collapsible?: boolean }) {\n  return (\n    <div\n      data-filter-row=\"\"\n      {...(collapsible ? { \"data-collapsible\": \"\" } : {})}\n      // O `py` é o que a barra grudada fecha (regra em StickyFilterbar). Sem o\n      // marcador `data-filter-row` a barra não tinha como alcançar a linha, e\n      // grudar não mudava altura nenhuma.\n      // Sem transição no `py` de propósito: animar padding é animar layout, e\n      // aqui isso significaria recalcular a altura da barra a cada quadro de\n      // rolagem — o vizinho exato do defeito que já inchou esta página. Troca\n      // seca, e durante o scroll ninguém lê a troca como corte.\n      className={cn(\n        \"flex items-center gap-4 py-3\",\n        // Só a linha que some ganha transição, e só de opacidade e deslize.\n        collapsible &&\n          \"transition-[opacity,translate,display] transition-discrete [transition-duration:var(--dur-fast,160ms)] [transition-timing-function:var(--ease-out,ease)] starting:-translate-y-1 starting:opacity-0\",\n        className,\n      )}\n      {...props}\n    >\n      {label ? (\n        <p className=\"w-14 shrink-0 text-[12px] font-bold uppercase tracking-[0.1em] text-[var(--muted-foreground)]\">\n          {label}\n        </p>\n      ) : null}\n      {/* `flex-1`: sem ele um `ml-auto` dentro da linha (a contagem do\n          resultado, um \"limpar\") não tem pra onde empurrar e cai pra baixo. */}\n      <div className=\"flex min-w-0 flex-1 flex-wrap items-center gap-2.5\">{children}</div>\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Barra de filtros que gruda sob o cabeçalho numa listagem longa de loja ou catálogo",
      "evite": "Navegação principal do app: side-nav; poucos filtros no topo de página curta, chip sem grudar"
    }
  },
  "categories": [
    "controles",
    "filtro",
    "scroll"
  ],
  "type": "registry:ui"
}