# Command Search

Busca ⌘K que não sabe buscar nem navegar: onSearch entra por prop, e resposta fora de ordem não repovoa a lista.

- Nome no registry: `command-search`
- Tipo: componente
- Dependências npm: cmdk, react
- Demo: https://ui.visantlabs.com/c/command-search
- Categorias: controles, busca, comando, teclado

## Instalar

```bash
npx shadcn@latest add @visant/command-search
```

## Usar

```tsx
<CommandSearch />
```

## API

### CommandSearch

- `onSearch: (query: string, signal: AbortSignal) => Promise<CommandSearchResult[]>`
- `onSelect: (result: CommandSearchResult) => void`
- `className?: string`
- `compact?: boolean = false` — Só o ícone, sem rótulo nem atalho. Para barras estreitas e sidebar recolhida.
- `delay?: number = 300`
- `emptyLabel?: string = "Nenhum resultado encontrado."`
- `errorLabel?: string = "Não foi possível buscar agora."`
- `inline?: boolean = false` — O painel direto na página, sem gatilho nem diálogo. Para tela de busca e vitrine.
- `minChars?: number = 2`
- `placeholder?: string = "O que você está procurando?"`
- `quickLinks?: CommandSearchResult[] = []` — Mostrados com a busca vazia — o "acesso rápido".
- `quickLinksLabel?: string = "Acesso rápido"`
- `resultsLabel?: string = "Resultados"`
- `shortcut?: string = "k"` — Tecla do atalho global, combinada com ⌘/Ctrl. `null` desliga o atalho e deixa só o clique no gatilho.
- `triggerLabel?: string = "Buscar"`