Jenga/io.github.joelkanyi.jenga.component.state

Package-level declarations

JengaEmptyState and JengaErrorState.

Types

JengaStateColors

@Immutable

class JengaStateColors(val title: Color, val description: Color)

Resolved colors for the empty/error state blocks. Override via JengaStateDefaults.colors.

JengaStateDefaults

object JengaStateDefaults

Defaults for JengaEmptyState and JengaErrorState. Each one follows the theme's JengaStateStyle.

JengaStateStyle

@Immutable

class JengaStateStyle(val titleStyle: TextStyle? = null, val descriptionStyle: TextStyle? = null, val contentPadding: PaddingValues? = null, val spacing: Dp? = null, val actionSpacing: Dp? = null, val actionSize: JengaButtonSize? = null, val colors: JengaStateColors? = null)

Theme-wide style for every JengaEmptyState and JengaErrorState, set through io.github.joelkanyi.jenga.theme.JengaComponentStyles.state. A null value keeps Jenga's default; arguments passed to a call still win.

Functions

JengaEmptyState

@Composable

fun JengaEmptyState(title: String, modifier: Modifier = Modifier, description: String? = null, icon: @Composable () -> Unit? = null, actionLabel: String? = null, onAction: () -> Unit? = null, actionVariant: JengaButtonVariant = JengaButtonVariant.Outline, colors: JengaStateColors = JengaStateDefaults.colors(), titleStyle: TextStyle = JengaStateDefaults.titleStyle, descriptionStyle: TextStyle = JengaStateDefaults.descriptionStyle, contentPadding: PaddingValues = JengaStateDefaults.contentPadding, spacing: Dp = JengaStateDefaults.spacing, actionSpacing: Dp = JengaTheme.components.state?.actionSpacing ?: spacing, actionSize: JengaButtonSize = JengaStateDefaults.actionSize)

A centered empty-state placeholder: optional icon, title, message, and action.

JengaErrorState

@Composable

fun JengaErrorState(title: String, modifier: Modifier = Modifier, description: String? = null, icon: @Composable () -> Unit? = null, actionLabel: String? = null, onAction: () -> Unit? = null, actionVariant: JengaButtonVariant = JengaButtonVariant.Primary, colors: JengaStateColors = JengaStateDefaults.colors(), titleStyle: TextStyle = JengaStateDefaults.titleStyle, descriptionStyle: TextStyle = JengaStateDefaults.descriptionStyle, contentPadding: PaddingValues = JengaStateDefaults.contentPadding, spacing: Dp = JengaStateDefaults.spacing, actionSpacing: Dp = JengaTheme.components.state?.actionSpacing ?: spacing, actionSize: JengaButtonSize = JengaStateDefaults.actionSize)

A centered error-state placeholder with a retry-style action.