fun Checkbox(modifier: Modifier = Modifier, checked: Boolean, onCheckedChange: (Boolean) -> Unit = {}, disabled: Boolean = false, size: Dp = 22.dp, type: CheckboxType = CheckboxType.SQUARE, activeColor: Color = MaterialTheme.colorScheme.primary, inactiveColor: Color = AppColor.Neutral.tips, disabledColor: Color = AppColor.Neutral.hint)

复选框支持方形和圆形两种外观，选中时显示对勾图标，可独立控制禁用状态及各阶段颜色

CheckButton

@Composable

fun CheckButton(text: String, checked: Boolean, onCheckedChange: (Boolean) -> Unit, mode: CheckButtonMode = CheckButtonMode.Clip, disabled: Boolean = false, activeColor: Color = mode.activeColor, inactiveColor: Color = mode.inactiveColor)

单个选择按钮根据 mode 呈现两种外观：

CheckButtonGroup

@Composable

fun CheckButtonGroup(modifier: Modifier = Modifier, items: Set<String>, checked: String, onCheckedChange: (String) -> Unit, mode: CheckButtonMode = CheckButtonMode.Clip, disabled: Set<String> = setOf(), activeColor: Color = mode.activeColor, inactiveColor: Color = mode.inactiveColor)

单选选择按钮组对多选版本的封装，每次只能选中一个选项，点击已选中项或未选中项均会更新选中值

@Composable

fun CheckButtonGroup(modifier: Modifier = Modifier, items: Set<String>, checked: Set<String>, onCheckedChange: (Set<String>) -> Unit, mode: CheckButtonMode = CheckButtonMode.Clip, disabled: Set<String> = setOf(), activeColor: Color = mode.activeColor, inactiveColor: Color = mode.inactiveColor)

多选选择按钮组使用 FlowRow 自动换行排列所有选项，支持同时选中多个

DatePicker

@Composable

fun DatePicker(value: Long, onValueChange: (Long) -> Unit, start: Long = 0, endInclude: Long = kotlin.time.Clock.System.now().toEpochMilliseconds(), textStyle: TextStyle = AppText.Normal.Title.default, mode: DatePickerMode = DatePickerMode.YMD, itemText: (Int, String) -> String = { _, item -> item })

日期选择器基于 MultiPicker 实现的日期滚轮选择组件，根据 mode 自动计算并显示对应的年/月/日列自动处理各列之间的联动（如月份变化时重新计算当月天数），并将选中结果限制在 [start, endInclude] 范围内

Field

@Composable

fun Field(modifier: Modifier = Modifier, value: String, onValueChange: (String) -> Unit, label: String, placeholder: String = "", type: KeyboardType = KeyboardType.Text, readonly: Boolean = false, disabled: Boolean = false, canClear: Boolean = false, required: Boolean = false, border: Boolean = true, autoSize: Boolean = false, error: String = "", labelWidth: Dp = 100.dp, labelAlign: FieldLabelAlign = FieldLabelAlign.LEFT, leftIconResource: DrawableResource? = null, leftIconTint: Color = AppColor.Neutral.title, maxLines: Int = Int.MAX_VALUE, minLines: Int = 1, onSizeChange: (IntSize, IntSize) -> Unit = { _, _ -> })

表单输入框包含左侧标签区和右侧输入内容区，支持只读、禁用、密码、清除、错误提示等常用场景当 type 为 KeyboardType.Password 或 KeyboardType.NumberPassword 时，自动显示密码可见性切换图标

MultiPicker

@Composable

fun <T> MultiPicker(items: List<Set<T>>, itemText: (Int, T) -> String = { _, item -> item.toString() }, textStyle: TextStyle = AppText.Normal.Title.default, selectedItems: List<T> = items.map { it.first() }, onValueChange: (List<T>) -> Unit = {})

多列滚轮选择器将多个 Picker 横向等宽排列，每列独立滚动，共同构成多维度的选择结果

Picker

@Composable

fun <T> Picker(items: Set<T>, itemText: (T) -> String = { it.toString() }, textStyle: TextStyle = AppText.Normal.Title.default, selectedItem: T = items.first(), onValueChange: (T) -> Unit = {})

单列滚轮选择器以 LazyColumn 实现可滚动选项列表，固定显示 5 行，中间高亮行为当前选中项滚动结束后自动吸附到最近选项（Snap 效果），并回调选中变更

PreviewCheckbox

@Preview

@Composable

fun PreviewCheckbox()

PreviewCheckButton

@Preview

@Composable

fun PreviewCheckButton()

PreviewCheckButtonGroup

@Preview

@Composable

fun PreviewCheckButtonGroup()

PreviewDatePickerModes

@Preview

@Composable

fun PreviewDatePickerModes()

PreviewDatePickerYM

@Preview

@Composable

fun PreviewDatePickerYM()

PreviewDatePickerYMD

@Preview

@Composable

fun PreviewDatePickerYMD()

PreviewField

@Preview

@Composable

fun PreviewField()

PreviewFieldLabelAlign

@Preview

@Composable

fun PreviewFieldLabelAlign()

PreviewFieldPassword

@Preview

@Composable

fun PreviewFieldPassword()

PreviewMultiPicker

@Preview

@Composable

fun PreviewMultiPicker()

fun PreviewPicker()

fun PreviewRadioCell()

fun PreviewSearch()

fun PreviewStepper()

PreviewStepperDefault

@Preview

@Composable

fun PreviewStepperDefault()

PreviewStepperRound

@Preview

@Composable

fun PreviewStepperRound()

fun PreviewSwitch()

fun PreviewTimePicker()

PreviewTimePickerHM

@Preview

@Composable

fun PreviewTimePickerHM()

RadioCell

@Composable

fun RadioCell(modifier: Modifier = Modifier, label: String, selected: Boolean, disabled: Boolean = false, border: Boolean = true, onClick: () -> Unit = {})

单选单元格以列表行形式展示单选项，右侧显示 RadioButton，标题居左

@Composable

fun Search(value: String, onValueChange: (String) -> Unit = {}, label: String = "", placeholder: String = "请输入搜索关键词", align: TextAlign = TextAlign.Start, disabled: Boolean = false, loading: Boolean = false, shape: RoundedCornerShape = AppShape.RC.v6, backgroundColor: Color = AppColor.Neutral.card, actionText: String = "取消", actionTextStyle: TextStyle = AppText.Normal.Title.default, onClickAction: () -> Unit? = null)

搜索输入框包含左侧搜索图标（或自定义标签）、输入框、可选清除按钮及可选右侧动作按钮获得焦点且有内容时自动显示清除按钮；loading 为 true 时显示进度指示器并隐藏清除按钮

Stepper

@Composable

fun Stepper(value: Int, onValueChange: (Int) -> Unit, min: Int = 0, max: Int = Int.MAX_VALUE, step: Int = 1, disabled: Boolean = false, canInput: Boolean = true, inputWidth: Dp = 45.dp, buttonSize: Dp = 32.dp, style: StepperStyle = StepperStyle.Default)

步进器

StepperDefault

@Composable

fun StepperDefault(value: Int, onValueChange: (Int) -> Unit, min: Int = 0, max: Int = Int.MAX_VALUE, step: Int = 1, disabled: Boolean = false, canInput: Boolean = true, inputWidth: Dp = 45.dp, buttonSize: Dp = 32.dp)

默认样式步进器

StepperRound

@Composable

fun StepperRound(value: Int, onValueChange: (Int) -> Unit, min: Int = 0, max: Int = Int.MAX_VALUE, step: Int = 1, disabled: Boolean = false, canInput: Boolean = true, inputWidth: Dp = 45.dp, buttonSize: Dp = 32.dp)

圆角样式步进器

Switch

@Composable

fun Switch(modifier: Modifier = Modifier, checked: Boolean, onCheckedChange: (Boolean) -> Unit, disabled: Boolean = false, loading: Boolean = false, activeColor: Color = AppColor.Main.primary, inactiveColor: Color = AppColor.Neutral.line, iconResource: DrawableResource? = null, size: Dp = 32.dp)

Switch 开关

TimePicker

@Composable

fun TimePicker(value: Int = 0, onValueChange: (Int, List<Int>) -> Unit, start: Int = 0, endInclude: Int = 86399, textStyle: TextStyle = AppText.Normal.Title.default, mode: TimePickerMode = TimePickerMode.HMS, itemText: (Int, String) -> String = { _, item -> item })

时间选择器基于 MultiPicker 实现的时间滚轮选择组件，根据 mode 显示时/分/秒列各列之间自动联动（如小时变化时重新计算可选分钟范围），选中结果裁剪至 [start, endInclude] 范围