# TagsInput Documentation

## Installation

```bash
jsrepo add tags-input
```

## Components

### TagsInput

The root tags input component. Allows entry and validation of multiple tags.

#### Props

| Prop | Type | Default Value | Required | Bindable | Description |
|------|------|--------------|----------|----------|-------------|
| value | string[] | [] | false | true | The current list of tags. |
| validate | (val: string, tags: string[]) => string | undefined | defaultValidate | false | false | A function to validate and transform a tag before it is added. Return the transformed tag or undefined to reject. |
| onValueChange | (tags: string[]) => void | - | false | false | A function called when the value changes |
| suggestions | string[] | - | false | false | A list of autocomplete suggestions to display. |
| filterSuggestions | (inputValue: string, suggestions: string[]) => string[] | - | false | false | A custom filter function for suggestions. Defaults to case-insensitive contains. |
| restrictToSuggestions | boolean | false | false | false | When true, only values from the suggestions list can be added. |