| chip | Snippet<[tag, remove]> | — | | Custom chip renderer; committing applies it, and the dialog edits its prefix text. |
| chipClass | string | ((tag: string) => string)? | — | | Chip classes; a string applies to all, a function overrides per tag (wins over the palette) and owns the whole class string, shape included. |
| clearLabel | string? | 'Clear tags' | | Accessible name for the clear button. |
| clearPlacement | 'auto' | 'inside' | 'outside' | 'auto' | | Inside overlays the box edge; outside sits after it; auto renders inside with the tags. |
| clearable | boolean | false | | Appends a cross button that resets the tags to the default value. |
| defaultValue | string[]? | — | | Baseline the clear button compares against; the cross hides while the tags match it; the eye applies the list. |
| disabled | boolean | false | | Disables the input. |
| id | string? | — | | Native input id. |
| option | Snippet<[tag]> | — | | Custom suggestion renderer; committing applies it, and the dialog edits its prefix text. |
| options | string[]? | — | | Suggestions offered while typing; the eye applies the list. |
| palette | readonly string[]? | built-in | | Per-tag colour classes; replaces the built-in palette. |
| placeholder | string? | — | | Placeholder text. |
| ratios | TagInputRatioOverrides? | — | | Partial override of the tag-row ratios (font, paddings, gap, and the inner input's vertical padding and caret-line width) plus the shared text-field clear cross (its trimmed button, reserved slot, and gutter); the line box follows the font and the clear inset follows padX. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers are icon-scale pixels interpolated between the steps. |
| value | string[]? | — | | Selected tags; the eye applies the list (hiding the readout while off). |
| chipStyle | (tag: string) => string | undefined | — | — | Inline style per tag for the chip; the caller owns the colour treatment. |
| onChange | (next: string[]) => void | — | — | Called with the new tag list. |
| onClear | () => void | onChange(default) | — | Clear handler; resets to the default value when omitted. |
| onQueryChange | (query: string) => void | — | — | Called on every keystroke; supply externally filtered options. |
| optionDotStyle | (tag: string) => string | undefined | — | — | Inline style for the dot before the option label; the dot itself is the component’s. |