Props

Name	Type	Default	Description
config	PowerSearchConfig	required	Fields, operators, and the value each operator expects.
filters	PowerSearchFilter[]	-	Current filters. When passed, the parent owns them and listens for updates.
label	string	Search	Accessible name of the input.
isLabelHidden	boolean	true	Hides the label visually and keeps it available to assistive tech. Omitted means hidden; false shows it. labelHidden is the older name. When both are set, this one wins.
placeholder	string	Search…	Placeholder while there are no filters.
autofocus	boolean	false	Focus the input after mount.
hasClear	boolean	true	Shows clear all once a filter exists. The older clearable name works too.
readOnly	boolean	false	Blocks adding, editing, and removing.
disabled	boolean	false	Turns the whole search off.
disabledMessage	string	-	Why it is off. With disabled, the message shows in a tooltip on hover or keyboard focus and the input stays focusable with aria-disabled. The older disabledReason name works too.
status	'default' | 'success' | 'warning' | 'error'	default	Validation status.
statusMessage	string	-	Status text.
statusVariant	'attached' | 'detached'	attached	Places the message against the field, or with a gap.
maxTokenLength	number	40	How many characters of a value a token shows.
maxSearchResults	number	10	Ranked field results for a non-empty query. An empty query browses up to 1,000 fields.
maxOperatorMenuItems	number	10	Suggestions in string and entity value editors. It does not cap the field menu or enum menus.
menuWidth	number	-	Exact pixel width of the field menu. It does not size the value editor.
popoverSaveButtonLabel	string	Apply	Label of the save button in the filter editor popover. The older saveLabel name works too.
timezoneID	string	-	Time zone used when a date is shown, such as America/New_York. The older timeZone name works too.
overflow	'none' | 'unfocused-inline' | 'unfocused-layer'	none	Wrap tokens, collapse them on blur, or expand them in a layer.
resultCount	number | string	-	Match count. A number is formatted with the result plural. A string is shown as given.
size	'sm' | 'md' | 'lg'	md	Size of the input and the tokens.
components	PowerSearchComponents	-	Replace the token or the editor for one value type.
containerClass	string	-	Added to the field shell, the layer that holds the label and the status message. It does not land on the bordered box or the native input.
containerStyle	StyleValue	-	Inline style for the field shell. Same landing as containerClass.
controlClass	string	-	Added to the bordered box. A class on the component lands there too, not on the native input.
controlStyle	StyleValue	-	Inline style for the bordered box. A style on the component lands there too.

Events

Name	Payload	Description
update:filters	the next filters	Filters changed. Use it with the two-way binding.
change	filters, change type, index	The type is add, edit, or remove. The index is the filter that changed.
focus	focus event	Focus entered the input.
blur	focus event	Focus left the input.

Slots

The icon sits before the tokens. endContent (also accepted as end) sits before the clear button and is the place for another action. The token and editor slots win over a component registered for a value type.

The component also exposes focus and blur methods, so a button outside the field can send the cursor back.

Field definitions

createPowerSearchConfig accepts string, number, boolean, date, enum, enum list, and string list. Strings can contain, start with, end with, or equal a value. Numbers compare magnitude. Dates can be before, after, or between. A boolean does not ask for another value.

A hand-written config can also use time, a relative date, an entity list, a custom editor, and nested filters. A custom editor needs a way to read the value back as text.