# XWUIPersonPicker

A multi-select assignee picker whose trigger button shows the chosen people and opens a searchable popover (filtering the `data.people` list by name, role or email) to add or remove selections. It is driven by `data.people` (each `XWUIPerson`: `id`, `name`, optional `role`/`email`/`avatar`) and `data.selected` (an array of ids), and is tuned through conf_comp: `trigger` (`stack` avatar pile vs `chips` removable row), `multi`, `maxSelected`, `size` (`xs`-`lg`), `placeholder`, `readOnly` and `emptyText`. It composes `XWUIDisplayPersonChip` for the trigger and option rows and emits selection changes via `onChange(people)`.

## Basic Usage

A single-field assignee picker over three HR employees with a custom `placeholder` of "Assign employee", using the default multi-select stack trigger.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Assignee picker over three employees with a custom placeholder and default stack trigger.
```

## Avatar Stack

Pre-selects four people with `trigger: "stack"` and `size: "sm"`, collapsing them into an overlapping avatar stack (a "+N" badge appears beyond four selected).

```example
file: examples/AvatarStack.ts
html: examples/AvatarStack.html
title: Avatar Stack
description: Four pre-selected people rendered as a small overlapping avatar stack.
```

## Multi Assignees

Caps selection at three with `maxSelected: 3` and `trigger: "chips"`, rendering the two pre-selected people from a 12-person list as removable chips.

```example
file: examples/MultiAssignees.ts
html: examples/MultiAssignees.html
title: Multi Assignees
description: Chip-style multi-assignee picker capped at three selections from a twelve-person list.
```

```api
```