# Voice Recorder

Gravador de voz de bolso feito com o Device Kit: REC que trava, timecode, onda e encoder.

- Nome no registry: `voice-recorder`
- Tipo: componente
- Dependências npm: lucide-react, motion
- Demo: https://ui.visantlabs.com/c/voice-recorder
- Categorias: controles, audio, gravador, voz, nota, aparelho, transcricao

## Quando usar

- Use quando: Gravar, pausar e ouvir notas de voz curtas, com a transcrição ao lado
- Evite quando: Nota de voz em chat: voice-note; editor de áudio com corte

## Instalar

```bash
npx shadcn@latest add @visant/voice-recorder
```

## Usar

```tsx
<VoiceRecorder />
```

## API

### VoiceRecorder

- `state: "idle" | "recording" | "paused" | "saving" | "transcribing" | "playing" | "error"`
- `battery?: number = "null"` — Bateria de 0 a 1. Sem ela, o ícone não aparece.
- `className?: string`
- `error?: string = "null"` — A mensagem do erro, em português, pronta para mostrar.
- `formatDate?: (d: Date) => string = "(d: Date) =>
  `${d.toLocaleDateString("pt-BR", { day: "numeric", month: "short" })}, ${d.toLocaleTimeString("pt-BR", { hour: "2-digit", minute: "2-digit" })}`"` — Data da nota na lista. Padrão: "11 nov., 14:02".
- `getLevel?: () => number` — O mesmo nível, puxado a cada quadro. Tem preferência sobre `level`.
- `level?: number` — Nível do microfone (ou do que toca), de 0 a 1.
- `listSize?: number = 6` — Quantas notas a lista mostra de uma vez.
- `notes?: RecorderNote[] = []`
- `onDiscard?: () => void` — Descartar a gravação em curso (Esc).
- `onOpen?: (id: string) => void` — Abrir a nota (a transcrição inteira, o player).
- `onPause?: () => void`
- `onPlay?: (id: string) => void`
- `onRecord?: () => void` — Gravar, ou retomar a pausa.
- `onSelect?: (id: string) => void`
- `onStop?: () => void` — Parar a gravação ou o que toca.
- `onVolumeChange?: (v: number) => void`
- `selectedId?: string = "null"`
- `timeMs?: number = 0` — Tempo corrido da gravação, ou a posição do que toca, em ms.
- `volume?: number = 0.8` — Volume de 0 a 1.
