UI 组件库 — 索引

com.hualuo.compose.ui —— 一套 Compose 组件与主题。它是独立发布的 AAR（hualuo-compose-ui，当前 1.3.0-SNAPSHOT），和工具库分开发版。

组件都是可选的，按页面需要挑。Colors / Defaults 类不用先记，用到哪个组件时再看它那一节。

分组

分组	组件
骨架与分组	页面骨架 TopTitleScaffold · 折叠大标题 CollapsingTitleScaffold · 分组 SectionRow / SectionItem · 底部导航 BottomNavBar
按钮与动作	按钮 Button / ActionImageButton · 收藏 FavoriteIconButton · 回顶 ScrollToTopButton · 下拉菜单 DropdownMenu
标签与输入	标签 PillLabel / PillLabelsRow · 胶囊导航 PillTab / PillTabsRow · 输入框 TextField / TextArea
列表	列表项 ListItem · 下拉刷新 PullToRefresh · 分隔线 HorizontalDivider
反馈与状态	提示条 Alert · 轻提示 PopupPrompt · 加载指示器 LoadingIndicator · 状态页 LoadingState / ErrorState / EmptyHint · 弹窗 AlertDialog · 底部弹层 BottomSheet
主题与工具	主题 HuaLuoTheme · 形状 AppShapes · 字阶 Typography / NumberStyles · 过度滚动 overScroll* · 图标 Phosphor

这些页怎么读

每个组件页都是同一个顺序：

小节	里面是什么
基本用法	能直接抄走的代码
参数	参数表（含类型与默认值），以及配套的枚举 / 配色类
要点	容易踩的坑、不要做的事、参数之间的优先级
说明	为什么这么设计、视觉规格、和 M3 基线的差异

「要点」和「说明」里的判断都是刻意的，别按 M3 文档「纠正」回来 —— 每一条都写了理由。

说明

组件库是通用的：它不依赖任何业务模型，也不读任何设置仓库。颜色、字阶、形状、动效全部通过 MaterialTheme 取，所以换一套 ColorScheme 就能整体换肤。
主题入口见主题。 整套界面必须包在它里面 —— 否则 MaterialTheme.colorScheme 会退回 M3 默认值，颜色全错。
包名是 com.hualuo.compose.ui.*，和工具库是两个独立的 AAR，别以为在同一个包里。
图标集内置在库内（见图标），不需要额外依赖，也不需要往 res/drawable 里塞 SVG。
过度滚动效果由主题通过 LocalOverscrollFactory 全局注入，普通滚动容器默认就有，见过度滚动。
轻提示的渲染容器也由主题挂好（PopupPrompt() 在 HuaLuoTheme 内部），所以 PopupPrompt.success(…) 在任何位置都能直接调，见轻提示。