| options | ComboboxOption[] | [] | The array of predefined option items. Each item must contain a value and label. |
| value | string | - | The controlled value of the selected item. |
| defaultValue | string | '' | The initial value of the selected item. |
| onValueChange | (value: string) => void | - | Callback fired when a new item value is selected. |
| placeholder | string | 'Select option...' | Trigger button label display when no value is chosen. |
| searchPlaceholder | string | 'Search...' | The placeholder text inside the input search field. |
| emptyText | string | 'No option found.' | Label displayed when searching matches no predefined items. |
| variant | 'default' | 'glass' | 'retro' | 'glow' | 'default' | The design system theme to apply to the trigger and content frame. |