# Prompt Composer

Campo de agente: texto que cresce, anexos com prévia, ferramentas e Enviar/Parar.

- Nome no registry: `prompt-composer`
- Tipo: componente
- Dependências npm: lucide-react
- Demo: https://ui.visantlabs.com/c/prompt-composer
- Categorias: controles, chat, agente, ia, prompt, anexo

## Quando usar

- Use quando: Campo de chat ou agente de IA, com anexos, ferramentas e parar
- Evite quando: Texto comum de formulário: textarea; comando curto: command-search

## Instalar

```bash
npx shadcn@latest add @visant/prompt-composer
```

## Usar

```tsx
<PromptComposer />
```

## API

### PromptComposer

- `onSubmit: () => void`
- `onValueChange: (value: string) => void`
- `value: string`
- `accept?: string = "image/*,video/*,audio/*"` — `accept` do seletor de arquivo.
- `aside?: any` — Slot livre entre as ferramentas e o enviar (créditos, modelo).
- `attachLabel?: string = "Anexar arquivo"`
- `attachments?: PromptAttachment[] = []`
- `autoFocus?: boolean`
- `canSubmit?: boolean` — Regra própria para enviar. Padrão: texto ou anexo, e nada em andamento.
- `className?: string`
- `disabled?: boolean = false`
- `label?: string = "Mensagem"` — Nome acessível da área de texto.
- `maxRows?: number = 8`
- `minRows?: number = 2`
- `onAttachFiles?: (files: File[]) => void` — Com isto aparece o clipe, e colar imagem vira anexo.
- `onRemoveAttachment?: (id: string) => void`
- `onStop?: () => void` — Interrompe a resposta. Com `status="streaming"`, Enviar vira Parar.
- `placeholder?: string = "Escreva uma mensagem"`
- `removeLabel?: (attachment: PromptAttachment) => string = "(a) => `Tirar ${a.label}`"`
- `status?: "ready" | "submitted" | "streaming" = "ready"` — `submitted`: mandado, sem resposta ainda. `streaming`: a resposta está correndo.
- `stopLabel?: string = "Parar"`
- `submitLabel?: string = "Enviar"`
- `tools?: PromptTool[] = []` — Ferramentas da esquerda: falar, rabiscar, comentar no tempo.
