# XWUIInputMultiSelect

XWUIInputMultiSelect Component Multi-select dropdown (enhancement to XWUIInputSelect) Wraps XWUIInputSelect with multiple mode enabled.

## Presentation modes

Two presentations, chosen by `config.inline`:

- **Legacy (default)** - selected items render as chips above a trigger that
  opens a checkbox dropdown.
- **Inline (`inline: true`, alias `mentionStyle`)** - a single mention-style
  field: you type inside the control, get a filtered suggestion dropdown inline,
  and each selection becomes a removable chip token (built from
  `XWUIDisplayChip`).

In inline mode, `allowCustom` (inverse alias `exclusive`) picks the entry policy:

- **Exclusive / limited (default, `allowCustom: false`)** - a strict
  multi-select; only values in `options` can be added, no free text.
- **Free / creatable (`allowCustom: true`)** - also add arbitrary entries
  (tag-like, à la `XWUIInputTags`).

Keyboard: type to filter · ↑/↓ to move · Enter/Tab to accept · comma to add a
custom entry (creatable) · Backspace on an empty field removes the last token.

## Basic Usage

XWUIInputMultiSelect Component Multi-select dropdown (enhancement to XWUIInputSelect) Wraps XWUIInputSelect with multiple mode enabled.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: XWUIInputMultiSelect Component Multi-select dropdown (enhancement to XWUIInputSelect) Wraps XWUIInputSelect with multiple mode enabled.
```

## Inline Tokens (mention-style)

Type inside the field, pick from inline suggestions, get removable chip tokens.
`allowCustom` switches between exclusive (default) and creatable entries.

```example
file: examples/InlineTokens.ts
html: examples/InlineTokens.html
title: Inline Tokens
description: Mention-style token input with exclusive (default) and creatable modes.
```

## Sizes

All size options.

```example
file: examples/Sizes.ts
html: examples/Sizes.html
title: Sizes
description: All size options.
```

## With Data

Populated with realistic sample data.

```example
file: examples/WithData.ts
html: examples/WithData.html
title: With Data
description: Populated with realistic sample data.
```

## Real-World

InputMultiSelect in a realistic application context.

```example
file: examples/RealWorld.ts
html: examples/RealWorld.html
title: Real-World
description: InputMultiSelect in a realistic application context.
```

```api
```