# 瑚琏 Hulian (`@hulianui/ui`) > 颜值 + 好用的 React 设计系统(Base UI + Tailwind v4 + Motion) · 353 个组件 · v0.5.0 AI agent 索引。完整逐组件用法见 [llms-full.txt](./llms-full.txt)(自包含)或各组件源码旁 `.md`。 安装 `npm i @hulianui/ui`,统一从根 barrel 导入:`import { X } from "@hulianui/ui"`。 铁律:业务里 100% 用库组件,禁止 style=/局部 CSS 覆盖;缺组件回库加。 ## 布局 layout(14) - [AdminLayout](https://github.com/hulianui/hulian/blob/master/packages/ui/src/admin-layout/admin-layout.md): 中后台骨架 · 侧栏(品牌+NavMenu可折叠) + 顶栏(折叠/面包屑/扩展区) + 多页签导航(开/切/关·关闭其他/全部·受控接路由或菜单点击自动维护) + 内容区(复用 NavMenu/ScrollArea/… - [AspectRatio](https://github.com/hulianui/hulian/blob/master/packages/ui/src/aspect-ratio/aspect-ratio.md): 比例容器 · CSS aspect-ratio 锁宽高比 + 图片/视频自动铺满(零依赖·RSC) - [Container](https://github.com/hulianui/hulian/blob/master/packages/ui/src/container/container.md): 内容容器 · 限制最大宽度(sm/md/lg/xl/full) + 居中 + 左右安全内距 + as 多态(收口全站 mx-auto max-w-Nxl px-6 样板·零依赖·RSC) - [Divider](https://github.com/hulianui/hulian/blob/master/packages/ui/src/divider/divider.md): 带文字分隔 · orientation 左/中/右 + dashed/plain + 行内垂直(纯皮肤·零依赖·RSC·与 Separator 互补) - [FitScreen](https://github.com/hulianui/hulian/blob/master/packages/ui/src/fit-screen/fit-screen.md): 大屏适配 · 固定设计尺寸(默认 1920×1080)等比缩放铺满父容器并居中 + fit/cover/stretch 三模式(纯函数 computeFit 可测·ResizeObserver 监听·SSR 安全·数据… - [Grid](https://github.com/hulianui/hulian/blob/master/packages/ui/src/grid/grid.md): 栅格布局 · grid 原语 cols/gap + GridItem 跨列跨行(零依赖·RSC) - [Layout](https://github.com/hulianui/hulian/blob/master/packages/ui/src/layout/layout.md): 整页布局 · 复合 Header/Sider/Content/Footer + Sider 可折叠(受控/断点/trigger) + 宽度过渡(零依赖·尽量 RSC·复用 ScrollArea) - [Masonry](https://github.com/hulianui/hulian/blob/master/packages/ui/src/masonry/masonry.md): 瀑布流布局 · 确定性 round-robin 分列(item[i]→第 i%列·SSR 安全·顺序稳定·非 CSS columns 抖动) + 响应式列数(base/sm/md/lg·首帧 base 防 hydrat… - [Resizable](https://github.com/hulianui/hulian/blob/master/packages/ui/src/resizable/resizable.md): 拖拽分栏 · 复合 PanelGroup/Panel/Handle + 横竖向 + min/max + 键盘微调(零依赖·role=separator) - [ScrollArea](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-area/scroll-area.md): 滚动区 · Base UI 自定义细滚动条 + 竖/横/双向 - [Separator](https://github.com/hulianui/hulian/blob/master/packages/ui/src/separator/separator.md): 分隔线 · Base UI role=separator + 横/竖几何 - [Spacer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/spacer/spacer.md): 间距 · x/y × 0.25rem 布局留白 + aria-hidden + RSC - [Stack](https://github.com/hulianui/hulian/blob/master/packages/ui/src/stack/stack.md): 弹性布局 · flex 原语 direction/gap/align/justify/wrap + as 多态(零依赖·RSC) - [Viewport](https://github.com/hulianui/hulian/blob/master/packages/ui/src/viewport/viewport.md): 响应式容器 · container-type 容器查询上下文 + web/平板/手机 预设宽度(可 width 覆盖) + 可选设备切换器(dogfood Segmented) · 内部组件用 @md/@5xl 等容器… ## 排版 typography(33) - [AnimatedGradientText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/animated-gradient-text/animated-gradient-text.md): 渐变文字 · 行内 chart 渐变流动 + RSC · typography/text · #animated - [AnimatedShinyText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/animated-shiny-text/animated-shiny-text.md): 高光文字 · 横扫高光 + 徽标气质 + RSC · typography/text · #animated - [ASCIIText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/ascii-text/ascii-text.md): 把文字渲染成 ASCII 字符画 · canvas2d 逐像素亮度采样映射字符 + 正弦波动位移 + 鼠标驱动 hue-rotate 色相(零依赖去 three.js·token·reduced-motion) · t… - [AuroraText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/aurora-text/aurora-text.md): 极光文字 · bg-clip 流动渐变 + chart token + RSC · typography/text · #animated - [BlurText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/blur-text/blur-text.md): 模糊解析 · 各词从模糊+位移解析到清晰 + 滚入视口触发(motion · top/bottom 方向 · aria-label 整段 · reduced-motion 直呈清晰) · typography/text… - [CircularText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/circular-text/circular-text.md): 环形文字 · 每字按等分角排到圆周 + 整体匀速自转 + 悬停调速(加速/减速/暂停/抓狂 · 颜色继承 currentColor · reduced-motion 静态) · typography/text · #a… - [Code](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code/code.md): 行内代码 · 等宽皮肤 + tone(default/primary/danger) + RSC - [CodeBlock](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-block/code-block.md): 代码块 · 多行
 + 一键复制(剪贴板+反馈) + 可选语言标签
- [CodeDiff](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-diff/code-diff.md): 代码对比 · 零依赖行级 LCS diff(纯函数 diffLines 可测) + unified 单栏/split 双栏 + 增绿删红行底色 + 双行号槽 + filename 头条与 +/− 摘要 · agent …
- [CurvedLoop](https://github.com/hulianui/hulian/blob/master/packages/ui/src/curved-loop/curved-loop.md): 沿二次贝塞尔曲线无缝循环滚动的弧形跑马灯文字 · SVG textPath + rAF 续滚 + 可拖拽拨动(零依赖·token/currentColor·reduced-motion) · typography/te…
- [DecryptedText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/decrypted-text/decrypted-text.md): 乱码解码 · 字符翻滚后逐位解码到明文 + view/hover 触发(随机仅客户端 effect 避 hydration mismatch · 等宽 tabular-nums 防抖 · aria-label 明文) …
- [FallingText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/falling-text/falling-text.md): 文字按词散落物理特效 · 触发后逐词受重力下落/撞墙反弹堆叠 + 指针拖拽抛掷(零依赖 RAF 自写二维刚体·token·reduced-motion) · typography/text · #animated
- [FuzzyText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/fuzzy-text/fuzzy-text.md): 信号噪点模糊标题 · canvas2d 逐行/逐列随机错位扫描 + 悬停增强抖动(零依赖·token·reduced-motion 退静态帧) · typography/text · #animated
- [GlitchText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/glitch-text/glitch-text.md): 故障撕裂 · 双伪元素 RGB 错位 + clip-path 切片抖动(纯 CSS 零依赖 RSC · 撕裂色吃 chart token · enableOnHover 门控 · motion-reduce 退普通文本…
- [Heading](https://github.com/hulianui/hulian/blob/master/packages/ui/src/heading/heading.md): 标题 · 1-6 级语义标签 + size/weight + as 多态(纯皮肤·零依赖·RSC)
- [Kbd](https://github.com/hulianui/hulian/blob/master/packages/ui/src/kbd/kbd.md): 按键 ·  等宽皮肤 + 组合键并排 + RSC
- [Markdown](https://github.com/hulianui/hulian/blob/master/packages/ui/src/markdown/markdown.md): 只读 Markdown 渲染 · 零依赖块级解析(标题/代码块/列表/引用/行内粗斜码链) · 套 Prose 排版 + 围栏代码块委托 CodeBlock · 区别 MarkdownEditor 可编辑 · RSC …
- [Prose](https://github.com/hulianui/hulian/blob/master/packages/ui/src/prose/prose.md): 排版容器 · 富文本/markdown 后代选择器统一吃语义 token(纯皮肤·零依赖·RSC)
- [ScrambledText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scrambled-text/scrambled-text.md): 指针靠近文字逐字翻滚乱码再收敛的悬停文字特效 · 半径内越近翻滚越久 + 可自定字符集/速度(零依赖 RAF·reduced-motion) · typography/text · #animated
- [ScrollFloat](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-float/scroll-float.md): 滚动浮现标题:随容器滚过视口逐字符从「下沉 + 纵向拉伸横向压扁 + 透明」拔起到正常 · useScroll 绑进度 + 每字符 useTransform 派生 opacity/y/scaleX/scaleY(去 g…
- [ScrollReveal](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-reveal/scroll-reveal.md): 滚动显影 · 整段随容器滚过视口逐词 opacity+blur 解析(motion useScroll/useTransform · 每词独立进度区间 · reduced-motion 直呈可读) · typograp…
- [ScrollVelocity](https://github.com/hulianui/hulian/blob/master/packages/ui/src/scroll-velocity/scroll-velocity.md): 滚动速度跑马灯文字 · 多行交替方向视差 + 随页面滚动加速/变向、静止匀速漂移(motion 速度值驱动·零额外依赖·reduced-motion 冻结自走帧保留 DOM) · typography/text · #…
- [Shuffle](https://github.com/hulianui/hulian/blob/master/packages/ui/src/shuffle/shuffle.md): 逐字「洗牌解密」文本动画 · 字位先滚乱码再按方向顺序锁定真字 + 视口/悬停/循环触发(零依赖 rAF·reduced-motion 直落终态·token 着色) · typography/text · #anima…
- [Snippet](https://github.com/hulianui/hulian/blob/master/packages/ui/src/snippet/snippet.md): 代码片段 · 命令提示符 + 一键复制(剪贴板+反馈)
- [SparklesText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/sparkles-text/sparkles-text.md): 星闪文字 · 随机小星脉冲(客户端生成) + token · typography/text · #animated
- [SplitText](https://github.com/hulianui/hulian/blob/master/packages/ui/src/split-text/split-text.md): 切字进场 · 文本切字/词 + 滚入视口逐段错峰位移淡入(motion · useInView 触发一次 · aria-label 整段读屏友好 · reduced-motion 直呈终态) · typography/…
- [Text](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text/text.md): 文本 · size/tone/weight + 单行省略/多行截断 + as 多态(纯皮肤·零依赖·RSC)
- [TextCursor](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text-cursor/text-cursor.md): 光标拖尾文字特效组件 · 在容器内移动光标时沿轨迹按间距落下一串字形并随机微浮动淡出回收(沿方向旋转 / emoji / 自定义间距上限)(零依赖·motion 运行时·reduced-motion 去浮动) · ty…
- [TextPressure](https://github.com/hulianui/hulian/blob/master/packages/ui/src/text-pressure/text-pressure.md): 逐字符"压感"标题 · 字形随鼠标距离实时插值字重/宽度/倾斜 + 透明度(零依赖 RAF·token 配色·reduced-motion·系统字体兜底) · typography/text · #animated
- [TrueFocus](https://github.com/hulianui/hulian/blob/master/packages/ui/src/true-focus/true-focus.md): 真实焦点 · 句中一词清晰余词模糊 + 焦点循环移动 + 四角框跟随(测量 rect 定位 · 角框吃 chart token · manualMode 悬停聚焦 · reduced-motion 全清晰) · typ…
- [TypingAnimation](https://github.com/hulianui/hulian/blob/master/packages/ui/src/typing-animation/typing-animation.md): 打字机 · 逐字 + 闪烁光标 + 进入视口触发 · typography/text · #animated
- [VariableProximity](https://github.com/hulianui/hulian/blob/master/packages/ui/src/variable-proximity/variable-proximity.md): 鼠标邻近驱动的逐字可变字体文本 · 按距离插值 font-variation-settings(wght/opsz 等轴)+ linear/exponential/gaussian 三档衰减(零依赖 RAF · red…
- [WordRotate](https://github.com/hulianui/hulian/blob/master/packages/ui/src/word-rotate/word-rotate.md): 轮换词 · motion 进出场 + reduced-motion · typography/text · #animated

## 表单 forms(49)
- [Button](https://github.com/hulianui/hulian/blob/master/packages/ui/src/button/button.md): 按钮 · CVA 变体 + press 动效
- [ButtonGroup](https://github.com/hulianui/hulian/blob/master/packages/ui/src/button-group/button-group.md): 按钮组 · 把若干 Button 连排成一体(抹内侧圆角/合并相邻边框/hover 项抬层) 或分离编组 + 横竖向 · 工具栏分段/拆分按钮/步进器(纯布局壳·不接管子按钮变体)
- [Calendar](https://github.com/hulianui/hulian/blob/master/packages/ui/src/_mui/calendar.md): 日历 · MUI X 桥(DateCalendar) + 对外 ISO 字符串受控 + 瑚琏 token
- [Cascader](https://github.com/hulianui/hulian/blob/master/packages/ui/src/cascader/cascader.md): 级联选择 · 触发器 + Popover 横向逐级面板列 + 路径数组受控 + click/hover 展开 + changeOnSelect · 复用树引擎核
- [Checkbox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/checkbox/checkbox.md): 复选框 · 三态(含半选) + Base UI
- [CheckboxGroup](https://github.com/hulianui/hulian/blob/master/packages/ui/src/checkbox-group/checkbox-group.md): 复选组 · Base UI 值数组协调 + 复用瑚琏 Checkbox
- [Choicebox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/choicebox/choicebox.md): 卡片选择 · 复合 ChoiceboxGroup/Choicebox(标题/描述/图标卡片) · 单选(radio)/多选(checkbox)对称 + 受控非受控 + 网格列数 · 隐藏原生 input 承载键盘与 a…
- [ColorPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/colorpicker/colorpicker.md): 颜色选择 · react-colorful 内核 + HEX/RGB/HSL 多格式输出与切换器(零依赖派生) + 瑚琏 token 皮肤
- [ColorSwatchPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/color-swatch-picker/color-swatch-picker.md): 预设色块单选 · base-ui RadioGroup 换皮(方向键 a11y) + 选中 ring + mix-blend 勾(零依赖)
- [Combobox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/combobox/combobox.md): 自动补全 · 触发按钮 + 弹层内搜索(图4 范式),亦支持内联输入;浮层锚到字段等宽
- [CountrySelect](https://github.com/hulianui/hulian/blob/master/packages/ui/src/country-select/country-select.md): 国家/地区选择 · 内置 250 国(旗+中英文名+区号) + 单/多选 chips + 中英文/码/区号搜索 · dogfood Combobox(新增多选)
- [DatePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/_mui/date-picker.md): 日期选择 · MUI X 桥(输入+弹层日历) + ISO 受控 + min/max
- [DateRangePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/date-range-picker/date-range-picker.md): 日期区间 · 自研零依赖双月范围日历(避开 MUI Pro 收费) + Popover 引擎 + 快捷预设/min-max/disabledDate · ISO 数组受控
- [DateTimePicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/_mui/date-time-picker.md): 日期时间选择 · MUI X 桥(年月日+时钟一体弹层) + ISO 受控 + 步进/秒
- [ElasticSlider](https://github.com/hulianui/hulian/blob/master/packages/ui/src/elastic-slider/elastic-slider.md): 橡皮筋音量滑块 · 拖到两端轨道横拉纵压 + 图标回弹位移 + hover 整体放大、松手 spring 弹回(motion·零新依赖·reduced-motion) · forms/basic · #animated
- [EmojiPicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/emoji-picker/emoji-picker.md): 表情选择器 · 内联 emoji 数据集(7 分类·中英关键词) + 关键词搜索 + 分类页签 + 最近使用(受控/内部) · 搜索框 dogfood Input · onSelect 回传 emoji(零依赖·聊天/…
- [Field](https://github.com/hulianui/hulian/blob/master/packages/ui/src/field/field.md): 字段包装 · label/help/error a11y 串联
- [Form](https://github.com/hulianui/hulian/blob/master/packages/ui/src/form/form.md): 表单容器 · Base UI 结构化提交 + errors 按 name + 与 Field 协同
- [ImageCropper](https://github.com/hulianui/hulian/blob/master/packages/ui/src/image-cropper/image-cropper.md): 图片裁剪 · 固定比例框(默认证件照 5:7) + 触屏双指捏合/拖拽对位 + 缩放滑杆 + canvas 出 Blob(尺寸/质量/字节上限可配·react-easy-crop MIT)
- [Input](https://github.com/hulianui/hulian/blob/master/packages/ui/src/input/input.md): 输入框 · Base UI Field + 前后缀 + invalid
- [InputOTP](https://github.com/hulianui/hulian/blob/master/packages/ui/src/input-otp/input-otp.md): 验证码输入 · 分段自动跳格/退格回退/整段粘贴(零依赖)
- [Listbox](https://github.com/hulianui/hulian/blob/master/packages/ui/src/listbox/listbox.md): 可选列表 · WAI-ARIA roving tabindex + 单/多/纯动作 + typeahead(零依赖)
- [LoginForm](https://github.com/hulianui/hulian/blob/master/packages/ui/src/login-form/login-form.md): 登录模板 · 自管 useForm(账号/密码必填+记住我) + 提交 loading + logo/footer 插槽(复用 Field/Input/Checkbox/Button·文案接 i18n)
- [MarkdownEditor](https://github.com/hulianui/hulian/blob/master/packages/ui/src/markdown-editor/markdown-editor.md): Markdown 编辑器 · WYSIWYG 罩 TipTap + 值进出 markdown 字符串 + 隐藏 input 桥 Field + 标准集工具栏
- [Mentions](https://github.com/hulianui/hulian/blob/master/packages/ui/src/mentions/mentions.md): @提及输入 · 复用 Textarea 皮肤 + 触发符唤起候选(镜像 div 测光标像素坐标) + aria-activedescendant 虚拟焦点(零依赖)
- [ModalForm / DrawerForm](https://github.com/hulianui/hulian/blob/master/packages/ui/src/form-dialog/form-dialog.md): 弹窗/抽屉表单 · 列表页新增/编辑编排件(复用 Dialog/Drawer + useForm + Button footer) · 提交前自动 validate · async onFinish 成功关闭/失败保持…
- [NumberField](https://github.com/hulianui/hulian/blob/master/packages/ui/src/number-field/number-field.md): 数字步进 · Base UI ±按钮 + 键盘步进 + min/max
- [ProForm](https://github.com/hulianui/hulian/blob/master/packages/ui/src/pro-form/pro-form.md): 内联表单编排 · useForm + 自动 footer(提交/重置) + async onFinish loading + 自定义 footer(ModalForm 的内联姊妹件·文案接 i18n)
- [PulsatingButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/pulsating-button/pulsating-button.md): 脉冲按钮 · 外扩光环(box-shadow) + RSC · forms/button · #animated
- [Radio](https://github.com/hulianui/hulian/blob/master/packages/ui/src/radio/radio.md): 单选 · RadioGroup 单选组 + 键盘方向键
- [RainbowButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/rainbow-button/rainbow-button.md): 彩虹按钮 · chart 流光底 + 模糊光晕 + RSC · forms/button · #animated
- [Rating](https://github.com/hulianui/hulian/blob/master/packages/ui/src/_mui/rating.md): 评分 · MUI 桥(emotion theme 读瑚琏 token) + 受控星级
- [RegionCascader](https://github.com/hulianui/hulian/blob/master/packages/ui/src/region-cascader/region-cascader.md): 中国省市区级联 · 内置全量行政区划(国家统计局口径·3级) + 浮层搜索直达 + onChange 同回码与名 · dogfood Cascader
- [RippleButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/ripple-button/ripple-button.md): 波纹按钮 · 点击落点扩散(Material) + reduced-motion · forms/button · #animated
- [SearchForm](https://github.com/hulianui/hulian/blob/master/packages/ui/src/search-form/search-form.md): 查询筛选表单 · 中后台列表页顶部条件区 · fields 配置 + 固定列栅格 + 一行折叠 + 查询/重置(dogfood Grid/Field/Input/Select/Button·零依赖)
- [SecretField](https://github.com/hulianui/hulian/blob/master/packages/ui/src/secret-field/secret-field.md): 密钥掩码字段 · sk-abc…wxyz 掩码(full/prefix-suffix) + 眼睛 toggle 显形 + 一键复制原值(同 Snippet idiom·1.5s 反馈) + 尾部动作槽(重置/吊销) +…
- [Segmented](https://github.com/hulianui/hulian/blob/master/packages/ui/src/segmented/segmented.md): 分段控制器 · 自研 radio 语义(方向键漫游) + active-tab CSS 变量滑块(零依赖)
- [Select](https://github.com/hulianui/hulian/blob/master/packages/ui/src/select/select.md): 下拉选择 · Base UI overlay 单选 + items 自动 label
- [ShimmerButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/shimmer-button/shimmer-button.md): 微光按钮 · 边缘游走火花(conic) + token + RSC · forms/button · #animated
- [Slider](https://github.com/hulianui/hulian/blob/master/packages/ui/src/slider/slider.md): 滑块 · Base UI 单值/range + 键盘步进
- [SocialButton](https://github.com/hulianui/hulian/blob/master/packages/ui/src/social-button/social-button.md): 第三方登录按钮 · 微信/支付宝/QQ/微博 + GitHub/Google/Apple/X 品牌 logo(内联 simple-icons·零依赖) + outline/solid 变体 + 纯 logo 方钮 + …
- [StepsForm](https://github.com/hulianui/hulian/blob/master/packages/ui/src/steps-form/steps-form.md): 分步表单 · 复用 Steps 指示器 + 上一步/下一步/提交导航 + onStepValidate 逐步校验 + 跨步保值(消费者 useForm 持有·文案接 i18n)
- [Switch](https://github.com/hulianui/hulian/blob/master/packages/ui/src/switch/switch.md): 开关 · Base UI 受控 + ARIA
- [Textarea](https://github.com/hulianui/hulian/blob/master/packages/ui/src/textarea/textarea.md): 多行输入 · 自适应高度
- [TimeField](https://github.com/hulianui/hulian/blob/master/packages/ui/src/_mui/time-field.md): 时间输入 · MUI X 桥(分段编辑 HH:mm 24h) + ISO 受控
- [Toggle](https://github.com/hulianui/hulian/blob/master/packages/ui/src/toggle/toggle.md): 切换按钮 · Base UI pressed 态 + ToggleGroup 单/多选
- [Transfer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/transfer/transfer.md): 穿梭框 · 左右双 listbox 面板 + 移动按钮(选中/全部) + 可选搜索 + 空态(零依赖·复用 Listbox/Empty)
- [TreeSelect](https://github.com/hulianui/hulian/blob/master/packages/ui/src/tree-select/tree-select.md): 树选择器 · 触发器 + Popover 浮层内嵌 Tree + 单选/多选(checkable)对称 + 树内搜索 · 复用树引擎核
- [Upload](https://github.com/hulianui/hulian/blob/master/packages/ui/src/upload/upload.md): 文件上传 · 拖拽落区/按钮形态 + accept/maxSize 校验 + 受控文件列表(状态/进度),零依赖自研只发 onSelect

## 数据展示 data-display(81)
- [AnimatedList](https://github.com/hulianui/hulian/blob/master/packages/ui/src/animated-list/animated-list.md): 动效列表 · 子项逐个淡入上移入场(motion + 进入视口) · data-display/collection · #animated
- [Avatar](https://github.com/hulianui/hulian/blob/master/packages/ui/src/avatar/avatar.md): 头像 · Base UI 图片+fallback
- [AvatarCircles](https://github.com/hulianui/hulian/blob/master/packages/ui/src/avatar-circles/avatar-circles.md): 堆叠头像组 · 重叠 + ring + +N 计数(扩 Avatar·RSC)
- [Badge](https://github.com/hulianui/hulian/blob/master/packages/ui/src/badge/badge.md): 计数角标 · count/max 溢出 + dot + 自定义内容 + 包裹叠加(四角/offset)
- [BentoGrid](https://github.com/hulianui/hulian/blob/master/packages/ui/src/bento-grid/bento-grid.md): 错落栅格 · BentoGrid/BentoCard 复合 + 跨列跨行 + hover CTA(纯 CSS·RSC)
- [Book3D](https://github.com/hulianui/hulian/blob/master/packages/ui/src/book-3d/book-3d.md): 3D 立体书 · CSS 3D transform 透视书体(前封/书脊/页块/后封) + 渐变或图封面 + 封面标题副标 + 角标缎带 + hover 翻正(纯 transform·GPU 合成·reduced-mo…
- [BounceCards](https://github.com/hulianui/hulian/blob/master/packages/ui/src/bounce-cards/bounce-cards.md): 一叠卡片扇形铺开的入场弹跳组件 · 逐张 scale 0 弹性弹入 + hover 推挤让位(零依赖去 gsap·motion 弹簧·reduced-motion) · data-display/collection …
- [Card](https://github.com/hulianui/hulian/blob/master/packages/ui/src/card/card.md): 卡片 · Header/Body/Footer 插槽
- [CardSwap](https://github.com/hulianui/hulian/blob/master/packages/ui/src/card-swap/card-swap.md): 3D 透视卡片自动洗牌组件 · 最前卡下坠 → 其余递进 → 绕回队尾循环 + 复合 CardSwap.Card 默认皮肤(去 gsap·motion useAnimate·reduced-motion) · data…
- [Carousel](https://github.com/hulianui/hulian/blob/master/packages/ui/src/carousel/carousel.md): 轮播 · 自研零依赖 scroll-snap + 箭头/圆点/autoplay/loop + 拖拽/键盘(reduced-motion)
- [Chart](https://github.com/hulianui/hulian/blob/master/packages/ui/src/chart/chart.md): 图表 · recharts 直裹 + chart token 皮肤(Area/Bar)
- [Chip](https://github.com/hulianui/hulian/blob/master/packages/ui/src/chip/chip.md): 标签 · 可移除(onClose×) + dot + tone×variant(区别 Badge 计数)
- [ChromaGrid](https://github.com/hulianui/hulian/blob/master/packages/ui/src/chroma-grid/chroma-grid.md): 光标聚光揭示的卡片墙 · 整片灰度暗化、光标圈内透出全彩 + 单卡 hover 径向高光(弹性跟随·reduced-motion) · data-display/collection · #animated
- [CircularGallery](https://github.com/hulianui/hulian/blob/master/packages/ui/src/circular-gallery/circular-gallery.md): ogl 弧形图片画廊 · 卡片沿圆弧弯曲倾斜排开 + 滚轮/拖拽惯性平移首尾无缝循环(ogl·圆角SDF·token化标题·reduced-motion 降级静态轨道) · data-display/collectio…
- [CodeReviewThread](https://github.com/hulianui/hulian/blob/master/packages/ui/src/code-review-thread/code-review-thread.md): 代码审查评论线程 · severity 左边色条(四级语气) + AI/人类作者 + 内嵌建议修改 diff 可采纳 + 回复/标记已解决·误报 + 折叠 · 嵌 code-diff annotations 槽或独立用…
- [Comment](https://github.com/hulianui/hulian/blob/master/packages/ui/src/comment/comment.md): 评论 · 嵌套回复缩进 + 可选连接线 + 操作区 + comment/log 类型(复用 Avatar/Link·RSC)
- [Coupon](https://github.com/hulianui/hulian/blob/master/packages/ui/src/coupon/coupon.md): 优惠券 · 撕票造型(中缝虚线+上下半圆穿孔·纯CSS) + 满减/折扣/包邮三类 + 可领/已领/已用/过期四态 + 选券高亮(电商标配·只消费 token)
- [CreditCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/credit-card/credit-card.md): 银行卡展示 · 卡号前缀识别品牌(visa/mastercard/amex/银联/jcb/discover) + 分组格式化/打码(纯函数可测) + token 渐变卡面 + 芯片/品牌字标 + 正反面(磁条/CVC)…
- [Danmaku](https://github.com/hulianui/hulian/blob/master/packages/ui/src/danmaku/danmaku.md): 弹幕引擎 · 轨道分配防重叠(等速模型·第二条入场后发车永不追尾) · scroll 滚动/top 顶部/bottom 底部三模式 + 轨道数/速度/密度(low/normal/high)/占屏比/透明度/暂停 + p…
- [DecayCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/decay-card/decay-card.md): 鼠标驱动的「湍流溶解」图片卡 · SVG feTurbulence+feDisplacementMap 随鼠标速度融化图像 + 带阻尼的视差倾斜平移(零依赖去 gsap·RAF 缓动·reduced-motion) ·…
- [DeployStatus](https://github.com/hulianui/hulian/blob/master/packages/ui/src/deploy-status/deploy-status.md): 部署/构建生命周期态 · 排队/构建中(转圈)/已上线/失败/已取消/已跳过 六态(→success/danger/primary/neutral 软填充) · badge 徽标/dot 圆点(building 脉冲)…
- [Descriptions](https://github.com/hulianui/hulian/blob/master/packages/ui/src/descriptions/descriptions.md): 描述列表 · 详情页键值对 + horizontal/vertical + bordered + span 跨列(纯皮肤·RSC)
- [DiffStat](https://github.com/hulianui/hulian/blob/master/packages/ui/src/diff-stat/diff-stat.md): 改动统计条 · +N −M 绿红格子条按比例填充(纯函数 splitBlocks 可测) + A/M/D/R 状态徽标 · 代码审查/PR 列表刚需·零依赖·RSC
- [DocumentSheet](https://github.com/hulianui/hulian/blob/master/packages/ui/src/document-sheet/document-sheet.md): 单据纸张 · A4 居中纸面(白底/暗色近黑纸·shadow·210mm 宽) + 打印态隔离(工具栏/阴影/外边距 print:hidden·data-document-sheet 钩子) + 内置打印按钮(onPr…
- [DomeGallery](https://github.com/hulianui/hulian/blob/master/packages/ui/src/dome-gallery/dome-gallery.md): 球面图库:图片瓦片贴在 CSS 3D 半球内壁,拖拽旋转浏览、点击放大查看 · 原生 PointerEvents 自搓拖拽+RAF 惯性 + motion 灯箱(零依赖·token·reduced-motion) · …
- [Dot](https://github.com/hulianui/hulian/blob/master/packages/ui/src/dot/dot.md): 状态圆点 · 5 语气状态色 + sm/md/lg + 呼吸 pulse(在线/进行中) + a11y label(role=status)(Tag/Chip 内嵌点的独立原语·纯CSS·RSC)
- [EditableTable](https://github.com/hulianui/hulian/blob/master/packages/ui/src/editable-table/editable-table.md): 行内编辑表格 · 行级编辑(草稿副本/保存校验/取消还原) + 自定义编辑器(editor 逃生舱) + 增删行 + 列对齐/宽度(企业录入场景·文案接 i18n)
- [Empty](https://github.com/hulianui/hulian/blob/master/packages/ui/src/empty/empty.md): 空状态 · 图标+标题+描述+操作槽 + 内置空箱图标 + sm/md(零依赖·RSC)
- [FileTree](https://github.com/hulianui/hulian/blob/master/packages/ui/src/file-tree/file-tree.md): 文件树 · 递归 nodes(file/folder) + 文件夹展开折叠(defaultExpanded) + 改动状态角标 A/M/D/U/R 着色(纯函数 statusMeta 可测·git status 语义)…
- [Flow](https://github.com/hulianui/hulian/blob/master/packages/ui/src/flow/flow.md): 节点画布编排器 · 零依赖原生 Pointer Events + SVG 贝塞尔连线 · 拖节点/拖桩连线/平移缩放/适配视图 + 受控 nodes/edges(onNodesChange/onConnect/删点删线…
- [FlyingPosters](https://github.com/hulianui/hulian/blob/master/packages/ui/src/flying-posters/flying-posters.md): WebGL 海报飞行长廊 · 一列海报随滚轮/拖拽无限循环上下飞过,顶点着色器按 distortion 翻折"飞起"·离屏循环复用 + 透视相机景深(ogl·懒加载·StrictMode 安全·reduced-moti…
- [Folder](https://github.com/hulianui/hulian/blob/master/packages/ui/src/folder/folder.md): 点击展开的 3D 文件夹 · 三层纸张扇形铺开 + 展开后磁吸跟随鼠标(零依赖纯 CSS transform·token 派生·reduced-motion) · data-display/collection · #…
- [Funnel](https://github.com/hulianui/hulian/blob/master/packages/ui/src/funnel/funnel.md): 漏斗图 · 阶段宽度按 value 比例 + 级间转化率徽标(本级/上一级) · 纵/横双向 + per-stage tone + renderStage 自定义 · computeFunnel 纯函数(不除零)带单测…
- [Gantt](https://github.com/hulianui/hulian/blob/master/packages/ui/src/gantt/gantt.md): 甘特图(只读) · 项目排期可视化 · 左固定列(按 group 分组小标题) + 右时间轴(day/week/month 刻度) · CSS grid + 百分比定位条形 + progress 深色填充层 + tod…
- [GitCommit](https://github.com/hulianui/hulian/blob/master/packages/ui/src/git-commit/git-commit.md): git 提交引用 · 分支 chip(GitBranch) + 短哈希等宽(纯函数 shortSha 可测·可定制位数/href 跳链) + 提交信息单行截断 + 作者头像槽 · inline 单行/stacked 两…
- [Heatmap](https://github.com/hulianui/hulian/blob/master/packages/ui/src/heatmap/heatmap.md): 热力图 · 网格色阶映射(value→bucket→primary 透明度档·纯函数 buildMatrix/bucketize 可测) + 行列标签 + 原生 hover 提示 + 点击下钻 · 代码热点/贡献活动/…
- [Image](https://github.com/hulianui/hulian/blob/master/packages/ui/src/image/image.md): 图片 · 加载淡入 + 失败回退/占位 + isZoomed hover 放大 + radius
- [ImageViewer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/image-viewer/image-viewer.md): 图片查看器 · 全屏 Lightbox(portal+锁滚复用 dialog) · 受控 index 翻页(箭头/← →/序号) + 滚轮指针锚定缩放/双击 1x↔2x/拖拽平移(切图重置) + 底部缩略图条 + ro…
- [InfiniteMenu](https://github.com/hulianui/hulian/blob/master/packages/ui/src/infinite-menu/infinite-menu.md): 可拖拽旋转的菜单球,菜单项围绕球面分布、正对镜头者贴靠为激活项并显覆盖层标题/描述+动作箭头 · 松手惯性衰减 + 自动自旋(零依赖 CSS-3D/RAF·reduced-motion) · data-display/…
- [InfiniteScroll](https://github.com/hulianui/hulian/blob/master/packages/ui/src/infinite-scroll/infinite-scroll.md): 无限滚动 · IntersectionObserver 底部哨兵 + 自动定位可滚祖先作 root + 加载锁防重入 + hasMore 完结态(零依赖·分页加载)
- [JsonViewer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/json-viewer/json-viewer.md): 折叠 JSON 树(只读) · 递归零依赖 + 语法着色(key/string/number/bool/null) + 行级展开折叠 + 折叠态 {…} N keys/[…] N items + depth<阈值初始展…
- [Kanban](https://github.com/hulianui/hulian/blob/master/packages/ui/src/kanban/kanban.md): 看板 · @dnd-kit headless 多容器 + 跨列/列内拖拽 + 键盘可拖 + 列头统计槽 + 空列占位 · 受控 onMove(消费者改业务字段) · 商机看板/任务流转旗舰
- [List](https://github.com/hulianui/hulian/blob/master/packages/ui/src/list/list.md): 数据列表 · 复合 List/ListItem/ListItem.Meta + actions/size/bordered/split/grid + 空态/分页/加载更多(零依赖·复用 Empty/Pagination…
- [LiveChat](https://github.com/hulianui/hulian/blob/master/packages/ui/src/live-chat/live-chat.md): 直播公屏 · 高频自动滚消息流 + message/enter(进场)/gift(送礼)/follow(关注)/system(系统)五类型默认皮肤 + 等级牌/身份徽标 + 置顶区 + 上滚查看历史时浮出「N 条新消息…
- [LivePlayer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/live-player/live-player.md): 直播播放器壳 · 自带极简 muted/loop/autoPlay video(非 VOD scrubber chrome·与 Video 互补) 或 surface 自定义画面 + LIVE 呼吸徽标(ping 红点…
- [LiveProductCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/live-product-card/live-product-card.md): 小黄车讲解卡 · 序号链接角标 + 现价/划线原价 + 讲解中脉冲徽标 + 库存/已售 + 秒杀限量角标 + 抢购按钮插槽 + row 列表行/card 网格卡两布局(直播带货标配·只消费 token·区别通用 Car…
- [LogoLoop](https://github.com/hulianui/hulian/blob/master/packages/ui/src/logo-loop/logo-loop.md): 无缝无限滚动的 logo 跑马灯 · RAF 速度低通平滑 + 序列复制无缝回卷 · 横纵四向/悬停变速暂停/单项放大/两端渐隐(零依赖·token·reduced-motion) · data-display/col…
- [LogViewer](https://github.com/hulianui/hulian/blob/master/packages/ui/src/log-viewer/log-viewer.md): 日志查看器 · 数据驱动行 lines(level/message/timestamp/source) + info/warn/error/debug/success 级别着色(纯函数 levelClass 可测) +…
- [MagicBento](https://github.com/hulianui/hulian/blob/master/packages/ui/src/magic-bento/magic-bento.md): 魔法便当卡片网格 · 光标跟随径向聚光 + 描边光呼吸 + 可选 3D 倾斜(零依赖·token·reduced-motion) · data-display/collection · #animated
- [MagicCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/magic-card/magic-card.md): 魔法卡片 · 鼠标跟随径向高光(motion) + surface token · data-display/collection · #animated
- [Marquee](https://github.com/hulianui/hulian/blob/master/packages/ui/src/marquee/marquee.md): 跑马灯 · 纯 CSS 无缝循环 + hover 暂停 + 方向 · data-display/collection · #animated
- [Meter](https://github.com/hulianui/hulian/blob/master/packages/ui/src/meter/meter.md): 度量条 · Base UI role=meter(静态量占比,区别 Progress)
- [NumberTicker](https://github.com/hulianui/hulian/blob/master/packages/ui/src/number-ticker/number-ticker.md): 数字滚动 · 进入视口 tween 到目标值 + reduced-motion · data-display/stat · #animated
- [PixelCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/pixel-card/pixel-card.md): canvas2d 像素卡片 · 悬停/聚焦时像素自中心波纹生长+闪烁、离开收缩消散 · 4 变体/可定制 gap·speed·colors(零依赖 RAF·token 配色·reduced-motion 静止) · d…
- [PricingTable](https://github.com/hulianui/hulian/blob/master/packages/ui/src/pricing-table/pricing-table.md): 定价对比矩阵 · 行列转置(列=被比项/模型·行=属性/价目) + 列高亮描边 + 角标(推荐/最佳性价比) + 表头吸顶 + 窄屏横滚(复用 ScrollArea·区别 Table 行=记录·模型市场定价对照刚需)
- [ProfileCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/profile-card/profile-card.md): 指针倾斜 + 全息炫彩名片卡 · RAF 阻尼弹簧驱动 3D 旋转/光晕(零依赖)+ chart token 全息渐变 + 无头像落首字母占位(reduced-motion 静态降级) · data-display/c…
- [ProTable](https://github.com/hulianui/hulian/blob/master/packages/ui/src/pro-table/pro-table.md): 高级表格 · 列表页编排层(复用 Table/SearchForm/Pagination) · 查询区 + 工具栏(密度/列设置/刷新/全屏) + 行选择 + 集成分页(企业中后台列表页旗舰)
- [QRCode](https://github.com/hulianui/hulian/blob/master/packages/ui/src/qrcode/qrcode.md): 二维码 · 编码内核 qrcode-generator + 瑚琏自渲 SVG(暗块合 path/crispEdges) + currentColor 吃主题 + UTF-8 中文 + 纠错级别 + 中心 logo(可 …
- [QueueLane](https://github.com/hulianui/hulian/blob/master/packages/ui/src/queue-lane/queue-lane.md): 优先级泳道队列板 · 横向泳道 + 道头聚合队列指标(深度/平均等待/吞吐) · 只读队列监视器(区别 Kanban 拖拽工作流·FIFO+aging) + maxVisible 折叠「还有 N 条」 + onItem…
- [ReflectiveCard](https://github.com/hulianui/hulian/blob/master/packages/ui/src/reflective-card/reflective-card.md): 金属反光证件卡 · 对角高光横扫 + 磨砂噪点 + 渐变发丝边框(纯 CSS 零依赖·token·RSC 安全·reduced-motion),内容可插槽化 · data-display/collection · #a…
- [RelativeTime](https://github.com/hulianui/hulian/blob/master/packages/ui/src/relative-time/relative-time.md): 相对时间 · 时间戳→「3分钟前/昨天/2个月后」+ 自动 tick 刷新(可设间隔/受控基准) + 中英 locale · 纯函数 formatRelative/formatAbsolute 可测 ·