# XWUIInputText

XWUIInputText Component Text input with various types and states.

## Basic Usage

Standard text input with label and placeholder.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Standard text input with label and placeholder.
```

## Variants

Outlined, filled, and underlined input variants.

```example
file: examples/Variants.ts
html: examples/Variants.html
title: Variants
description: Outlined, filled, and underlined input variants.
```

## Sizes

sm, md, and lg text inputs.

```example
file: examples/Sizes.ts
html: examples/Sizes.html
title: Sizes
description: sm, md, and lg text inputs.
```

## States

Disabled, read-only, and error states.

```example
file: examples/States.ts
html: examples/States.html
title: States
description: Disabled, read-only, and error states.
```

## Live Validation

Validate on blur with `setError(true, message)` and clear the error automatically once the value becomes valid while typing - the standard pattern for not nagging users mid-entry.

```example
file: examples/Validation.ts
html: examples/Validation.html
title: Live Validation
description: Email field that validates on blur with error and helper text.
```

## Password Reveal

Set `type: "password"` to get the built-in eye / eye-off toggle, which reveals the value without clearing it. Here it is paired with a live strength hint.

```example
file: examples/PasswordReveal.ts
html: examples/PasswordReveal.html
title: Password Reveal
description: Password field with a show/hide toggle and strength hint.
```

## Character Counter

Cap input with `maxLength` and show a live "used / max" counter that warns as the limit approaches.

```example
file: examples/CharacterCounter.ts
html: examples/CharacterCounter.html
title: Character Counter
description: maxLength input with a live character count.
```

## Debounced Search

A `type: "search"` input with a leading icon and clear button that debounces keystrokes before filtering a live results list.

```example
file: examples/SearchDebounced.ts
html: examples/SearchDebounced.html
title: Debounced Search
description: Search input that debounces and shows matching results.
```

```api
```