core/dev.kindling.core.components.ui.combobox

Package-level declarations

Types

ComboboxState

@Stable

class ComboboxState

State holder created by rememberComboboxState and passed down to all Combobox slot composables.

KComboboxGroup

data class KComboboxGroup(val key: String, val label: String)

A labelled group header rendered above its items.

KComboboxItem

data class KComboboxItem(val value: String, val label: String, val group: String? = null)

A single selectable item in a Combobox.

Functions

Combobox

@Composable

fun Combobox(modifier: Modifier = Modifier, content: @Composable BoxScope.() -> Unit)

Shadcn/ui-style Combobox root — mirrors Combobox (Base UI primitive).

ComboboxChip

@Composable

fun ComboboxChip(state: ComboboxState, item: KComboboxItem, modifier: Modifier = Modifier, showRemove: Boolean = true)

Individual chip rendered inside ComboboxChips for each selected item.

ComboboxChips

@Composable

fun ComboboxChips(modifier: Modifier = Modifier, content: @Composable RowScope.() -> Unit)

Chip container shown inside the trigger area for multiple-selection mode.

ComboboxChipsInput

@Composable

fun ComboboxChipsInput(state: ComboboxState, modifier: Modifier = Modifier, placeholder: String = "Search…", enabled: Boolean = true)

Inline search input rendered alongside chips inside ComboboxChips.

ComboboxCollection

@Composable

fun ComboboxCollection(state: ComboboxState, items: List<KComboboxItem>, modifier: Modifier = Modifier, groups: List<KComboboxGroup> = emptyList(), customItem: @Composable RowScope.(KComboboxItem) -> Unit? = null)

Renders all items as ComboboxItems, filtered by 'state.query'.

ComboboxContent

@Composable

fun ComboboxContent(state: ComboboxState, modifier: Modifier = Modifier, maxHeight: Dp = 240.dp, content: @Composable ColumnScope.() -> Unit)

The dropdown panel — mirrors ComboboxContent (Positioner + Popup).

ComboboxEmpty

@Composable

fun ComboboxEmpty(modifier: Modifier = Modifier, content: @Composable () -> Unit)

Empty-state slot shown when no items match the query.

ComboboxGroup

@Composable

fun ComboboxGroup(modifier: Modifier = Modifier, content: @Composable ColumnScope.() -> Unit)

Groups items under a labelled section.

ComboboxInput

@Composable

fun ComboboxInput(state: ComboboxState, modifier: Modifier = Modifier, placeholder: String = "Search…", showTrigger: Boolean = true, showClear: Boolean = false, enabled: Boolean = true, isError: Boolean = false)

Search-field trigger — mirrors ComboboxInput.

ComboboxItem

@Composable

fun ComboboxItem(state: ComboboxState, item: KComboboxItem, modifier: Modifier = Modifier, content: @Composable RowScope.() -> Unit? = null)

A single selectable row inside ComboboxList.

ComboboxLabel

@Composable

fun ComboboxLabel(modifier: Modifier = Modifier, content: @Composable () -> Unit)

Group label — mirrors ComboboxLabel (GroupLabel).

ComboboxList

@Composable

fun ComboboxList(modifier: Modifier = Modifier, content: @Composable ColumnScope.() -> Unit)

Scrollable list container inside ComboboxContent.

ComboboxSeparator

@Composable

fun ComboboxSeparator(modifier: Modifier = Modifier)

Thin horizontal rule between groups.

ComboboxTrigger

@Composable

fun ComboboxTrigger(state: ComboboxState, modifier: Modifier = Modifier, enabled: Boolean = true, isError: Boolean = false, content: @Composable RowScope.() -> Unit = { ComboboxValue(state = state) Spacer(Modifier.weight(1f)) Icon( imageVector = if (state.expanded) Icons.Default.KeyboardArrowUp else Icons.Default.KeyboardArrowDown, contentDescription = null, modifier = Modifier.size(16.dp), tint = MaterialTheme.colorScheme.onSurfaceVariant ) })

Button-style trigger that opens/closes the dropdown.

ComboboxValue

@Composable

fun ComboboxValue(modifier: Modifier = Modifier, state: ComboboxState, placeholder: String = "Select…")

Renders the current selected label (or placeholder if nothing selected).

rememberComboboxState

@Composable

fun rememberComboboxState(selected: KComboboxItem? = null, onSelect: (KComboboxItem?) -> Unit = {}, multiple: Boolean = false, selectedMultiple: List<KComboboxItem> = emptyList(), onSelectMultiple: (List<KComboboxItem>) -> Unit = {}): ComboboxState

Creates and remembers a ComboboxState.

useComboboxAnchor

@Composable

fun useComboboxAnchor(): MutableState<Any?>