# Password Documentation

## Installation

```bash
jsrepo add ui/password
```

## Components

### Root

The root container for the password input suite.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|
| ref | HTMLDivElement | null | false | true | A reference to the root div element. |
| hidden | boolean | true | false | true | Whether the password is hidden (masked). |
| minScore | 0 | 1 | 2 | 3 | 4 | 3 | false | false | The minimum acceptable score for a password (0-4). |
| children | Snippet | - | false | false | Slot content for the password root (e.g., input, strength meter, etc). |

### Input

The password input field.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|
| ref | HTMLInputElement | null | false | true | A reference to the input element. |
| value | string | - | false | true | The value of the password input. |
| children | Snippet | - | false | false | Slot content for the input (e.g., icons, buttons). |

### ToggleVisibility

A button to toggle password visibility.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|


### Copy

A button to copy the password value to the clipboard.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|


### Strength

A meter that visually indicates password strength.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|
| strength | ZxcvbnResult | - | false | true | The zxcvbn result object for password strength. |