# Device Kit

Aparelho y2k industrial em peças: carcaça de alumínio, LCD na luz da marca, LED, encoder e chave.

- Nome no registry: `device-kit`
- Tipo: componente
- Dependências npm: nenhuma
- Demo: https://ui.visantlabs.com/c/device-kit
- Categorias: controles, aparelho, hardware, led, encoder, knob, switch, lcd, rack

## Quando usar

- Use quando: Controle cujo gesto físico é a função: gravar, girar, acender, ligar
- Evite quando: Lista, tabela, formulário e navegação; switch comum: liquid-toggle

## Instalar

```bash
npx shadcn@latest add @visant/device-kit
```

## Usar

```tsx
<DeviceShell />
```

## API

### DeviceScrew

Parafuso de fenda, para as orelhas de uma unidade de rack. Decorativo.

- `className?: string`

### DeviceShell

- `size?: "sm" | "md" | "lg" = "md"`

### DeviceLcd

- `lit?: boolean = true` — Backlight aceso. Padrão: aceso.
- `screenClassName?: string` — Classe da tela (o vidro), para altura e respiro.
- `size?: "sm" | "md" = "md"`

### DeviceReadout

O número do display, em algarismos tabulares para não pular enquanto corre.

- `glow?: boolean = false` — Brilho da tinta: o número está vivo (gravando, tocando).
- `size?: "sm" | "md" | "lg" = "lg"` — `lg` é o timecode do gravador (38px); `sm` cabe numa unidade de rack.

### DeviceSegments

Medidor em segmentos de LCD (volume, nível).

- `value: number` — De 0 a 1.
- `className?: string`
- `count?: number = 10` — Quantos segmentos. Padrão: 10.
- `label?: string` — Com rótulo, vira um `meter` acessível; sem, é só desenho (o valor já está dito em outro lugar).

### DeviceProgress

Barra de progresso em segmentos, na tinta do LCD.

- `label: string` — Nome da barra para leitor de tela.
- `value: number` — De 0 a 1. Sem valor, a barra fica vazia.
- `className?: string`
- `segments?: number = 24`
- `valueText?: string` — O que o leitor de tela diz, se a porcentagem não basta ("3 de 12").

### DeviceLed

- `className?: string`
- `label?: string`
- `size?: "sm" | "md" | "lg" | "xs" = "sm"` — `xs` 6px, `sm` 10px, `md` 14px, `lg` 26px (o LED do REC).
- `state?: "off" | "on" | "breathe" | "blink" | "error" = "off"`
- `title?: string`
- `tone?: "red" | "brand" = "brand"`

### DeviceKey

- `pressed?: boolean` — Travado afundado. Vira `aria-pressed`; sem valor, a tecla não é de alternar.
- `pressing?: boolean = false` — Afundado por um instante (o atalho de teclado acionou a tecla).
- `shape?: "ring" | "square" = "square"`
- `size?: "sm" | "md" | "lg" = "md"`

### DeviceSwitch

- `checked: boolean`
- `busy?: boolean = false` — Em trânsito: a chave fica onde foi posta e não aceita outro toque.
- `onCheckedChange?: (checked: boolean) => void`
- `size?: "sm" | "md" = "md"`

### DeviceEncoder

- `label: string`
- `className?: string`
- `disabled?: boolean = false`
- `max?: number = 100`
- `min?: number = 0`
- `onDetent?: (d: 1 | -1) => void`
- `onValueChange?: (v: number) => void`
- `orientation?: "horizontal" | "vertical" = "vertical"`
- `position?: number`
- `size?: "sm" | "md" | "lg" = "md"`
- `step?: number = 1`
- `style?: CSSProperties`
- `value?: number`
- `valueText?: string`
- `variant?: "wheel" | "knob" = "wheel"`
