# Input

The single line text control: a pill on the tray fill that lifts onto the surface when focused.

Tier: Free

## Installation

```bash
npx shadcn add @fetaui/input
```

## Usage

```tsx
import { Input } from '@/components/fetaui/input'

export function Example() {
  return <Input type="email" autoComplete="email" placeholder="you@example.com" />
}
```

## API

| Prop | Type | Default |
|---|---|---|
| size | sm, md, lg | md |
| invalid | boolean | false |
| leading | ReactNode |  |
| copyable | boolean | false |
| strength | 0 to 4 |  |
| animated | boolean | true |

## When to use

- For short single line values like names, emails, links and search.

## When not to use

- For anything longer than a sentence: use Textarea.
- For a visible label and help text, wrap it in Field.

## Accessibility

- A native input. Use the right type and autocomplete.
- Reveal and copy are labelled buttons.
- Required uses aria-required.

## Motion

- Focus lifts the pill to the surface in 120 ms.
- Copy turns to a check and back after 2 s.
- The strength meter fills as you type. Invalid never shakes.
- With reduced motion, the meter jumps and the check swaps.