{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "search-field",
  "title": "Search Field",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Campo de busca com debounce que não se limpa sozinho: negocia o texto local com o valor de fora por referência acordada.",
  "dependencies": [
    "react"
  ],
  "registryDependencies": [
    "utils",
    "@visant/use-debounce"
  ],
  "files": [
    {
      "path": "registry/visant/ui/search-field.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { cn } from \"@/lib/utils\";\nimport { useDebounce } from \"@/hooks/use-debounce\";\n\n/**\n * SearchField — campo de busca controlado, com debounce e botão de limpar.\n *\n * Parece um `<input>` com ícone. O que justifica ser um componente é a\n * **negociação entre o texto local e o valor de fora**, que é onde essa peça\n * quebra em toda base de código, sempre do mesmo jeito.\n *\n * ── O bug que este arquivo existe para não repetir ──────────────────────────\n * O campo precisa de estado local (para responder à tecla no mesmo quadro) e de\n * `value` externo (para o botão \"Limpar\" e os presets de filtro funcionarem). A\n * versão ingênua sincroniza comparando `value` com o estado local:\n *\n *     if (value !== searchValue) setSearchValue(value);   // ← não faça isto\n *\n * No commit em que o debounce fecha, o pai **ainda tem o valor antigo** (`\"\"`) e o\n * local já tem \"arbolt\". A condição dá verdadeira e o campo se limpa no mesmo\n * instante em que manda a busca para cima. Aí o `value` novo chega, é readotado,\n * debounça, limpa de novo: a tabela filtra e desfiltra em loop, e o texto pisca\n * fora do campo. Foi exatamente isso que quebrou uma tela de demandas em produção.\n *\n * A saída é `agreedValue`: o último valor em que campo e pai **concordaram** — o\n * que este emitiu para cima, ou o que ele adotou de lá. É a única referência que\n * decide quem manda, e a ordem dos dois efeitos importa:\n *\n * 1. **adotar de fora** vem primeiro. No commit em que o debounce fecha, ele vê o\n *    par acordado e não faz nada;\n * 2. **emitir para cima** vem depois e move a referência.\n *\n * Inverta os dois e o loop volta.\n *\n * ── Fora isso ───────────────────────────────────────────────────────────────\n * - `onChange` entra por ref: trocar a identidade da função (o caso comum, com\n *   uma arrow inline no consumidor) não pode reprogramar o debounce.\n * - O botão de limpar só existe quando há texto — e tem nome acessível, porque\n *   um `×` sozinho se anuncia como \"botão\".\n * - Sem `fetch`, sem i18n: o `placeholder` é prop.\n */\n\nexport interface SearchFieldProps\n  extends Omit<React.InputHTMLAttributes<HTMLInputElement>, \"value\" | \"onChange\"> {\n  value: string;\n  onChange: (value: string) => void;\n  placeholder?: string;\n  /** Milissegundos até o valor \"fechar\" e subir. `0` emite a cada tecla. */\n  delay?: number;\n  clearLabel?: string;\n}\n\nexport function SearchField({\n  value,\n  onChange,\n  placeholder = \"Buscar...\",\n  delay = 300,\n  clearLabel = \"Limpar busca\",\n  className,\n  ...props\n}: SearchFieldProps) {\n  const [text, setText] = React.useState(value);\n  const debounced = useDebounce(text, delay);\n\n  const onChangeRef = React.useRef(onChange);\n  React.useEffect(() => {\n    onChangeRef.current = onChange;\n  }, [onChange]);\n\n  /** O último valor em que este campo e o pai concordaram. Ver o bloco acima. */\n  const agreedValue = React.useRef(value);\n\n  // 1. Adotar o que veio de FORA (botão \"Limpar\", preset, URL). Precisa vir antes.\n  React.useEffect(() => {\n    if (value === agreedValue.current) return;\n    agreedValue.current = value;\n    setText(value);\n  }, [value]);\n\n  // 2. Emitir o que fechou aqui. É este que move a referência.\n  React.useEffect(() => {\n    if (debounced === agreedValue.current) return;\n    agreedValue.current = debounced;\n    onChangeRef.current(debounced);\n  }, [debounced]);\n\n  return (\n    /*\n     * Dois níveis de propósito. A raiz cresce no eixo do pai (`flex-1`); quem\n     * posiciona a lupa e o `×` é o invólucro de dentro, que tem a altura exata do\n     * campo. Com os dois papéis na mesma div, numa COLUNA o `flex-1` esticava a\n     * raiz na vertical e o `top-1/2` derrubava a lupa para baixo do campo.\n     */\n    <div className={cn(\"min-w-[200px] flex-1\", className)}>\n      <div className=\"relative\">\n        <svg\n          aria-hidden=\"true\"\n          viewBox=\"0 0 16 16\"\n          fill=\"none\"\n          stroke=\"currentColor\"\n          strokeWidth=\"1.5\"\n          className=\"pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-[var(--muted-foreground)]\"\n        >\n          <circle cx=\"7\" cy=\"7\" r=\"4.5\" />\n          <path d=\"M10.5 10.5L14 14\" strokeLinecap=\"round\" />\n        </svg>\n\n        <input\n          type=\"search\"\n          value={text}\n          placeholder={placeholder}\n          onChange={(event) => setText(event.target.value)}\n          className={cn(\n            \"h-[var(--control-h,2.25rem)] pointer-coarse:h-11 w-full\",\n            \"rounded-[var(--r-control,0.5rem)] border border-[var(--input,var(--border))]\",\n            \"bg-[var(--background)] pl-9 pr-9 text-sm text-[var(--foreground)]\",\n            \"placeholder:text-[var(--muted-foreground)]\",\n            \"outline-none focus-visible:border-[color-mix(in_oklab,var(--ring)_60%,var(--foreground))] focus-visible:[box-shadow:0_0_0_1px_color-mix(in_oklab,var(--ring)_30%,transparent)]\",\n            \"transition-[border-color,box-shadow]\",\n            \"[transition-duration:var(--dur-fast,160ms)]\",\n            \"[transition-timing-function:var(--ease-out)]\",\n            // O × nativo do type=search duplicaria o nosso, e não é estilizável.\n            \"[&::-webkit-search-cancel-button]:appearance-none\",\n          )}\n          {...props}\n        />\n\n        {text ? (\n          <button\n            type=\"button\"\n            aria-label={clearLabel}\n            onClick={() => setText(\"\")}\n            className={cn(\n              \"absolute right-1.5 top-1/2 flex h-6 w-6 -translate-y-1/2 items-center justify-center pointer-coarse:after:absolute pointer-coarse:after:-inset-2.5\",\n              \"rounded-[var(--r-control,0.375rem)] text-[var(--muted-foreground)]\",\n              \"hover:text-[var(--foreground)] focus-visible:bg-[var(--muted)]\",\n              \"outline-none focus-visible:[box-shadow:0_0_0_1px_color-mix(in_oklab,var(--ring)_60%,var(--foreground))]\",\n              // Aparece sem saltar: o × nasce com a primeira tecla, bem debaixo do olho.\n              \"transition-[color,background-color,opacity] [transition-duration:var(--dur-fast,160ms)]\",\n              \"[transition-timing-function:var(--ease-out)] starting:opacity-0\",\n            )}\n          >\n            <svg\n              aria-hidden=\"true\"\n              viewBox=\"0 0 12 12\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              strokeWidth=\"1.75\"\n              strokeLinecap=\"round\"\n              className=\"h-3 w-3\"\n            >\n              <path d=\"M2 2l8 8M10 2l-8 8\" />\n            </svg>\n          </button>\n        ) : null}\n      </div>\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "categories": [
    "controles",
    "busca",
    "debounce",
    "formulario"
  ],
  "type": "registry:ui"
}