CHANGELOG
@mox-hub/ui 版本变更记录(changesets 生成)
0.2.0-beta.2
Minor Changes
-
#32
09fe46bThanks @mox-hub! - dogfood 分组 C(Overlays / Misc):- Dialog:
DialogContent新增size="xl"(sm:max-w-6xl,1152px),PDF 预览与宽表格不再需要用className覆盖max-w。 - Tabs:
TabsList新增size="sm"紧凑档,372px 容器内可容纳 6 个line变体 Tab,键盘/焦点行为不变。 - Toast:
ToastProvider新增offset(number=px,string 原样,可传env(safe-area-inset-*))与container(Portal 挂载容器),用于避开底部状态栏/画布控件。 - patterns:新增
GraphNode画布节点骨架(不依赖 React Flow),统一 hover / selected / final 三态与 density / disabled 样式。
Breaking
DefinitionRow的sortable默认值从true改为false:只读信息行不再渲染拖拽手柄;需要排序的实体显式传sortable(仍须置于<Sortable>内)。
- Dialog:
-
#33
1ebc40aThanks @mox-hub! - dogfood 分组 A(Shell / Navigation)收口:@mox-hub/patterns新增AppShell应用壳母版:sidebar/header/content/aside槽位,内建SidebarProvider(配置经providerProps透传),顶栏 sticky,contentScroll支持content/page/none。Sidebar配置归属收口:collapsible/variant/side在类型上只属于SidebarProvider(Sidebar侧声明为never,JSDoc 指向 Provider),开发环境误传时打印告警;文档新增「配置位置(先读)」。RightSidebar新增窄屏overlay模式:<lg提供内建浮动入口 + Sheet 浮层(遮罩/焦点管理),桌面行为不变;支持overlayOpen/defaultOverlayOpen/onOverlayOpenChange受控。PageShell新增scroll="page" | "content" | "none"(默认none,不改变既有布局),明确整页滚动/内容区自滚动/不注入滚动的职责。SidebarMenuButton新增badge/trailing行尾槽:数字/字符串自动套计数胶囊,折叠为图标轨时自动隐藏;长标题截断保持。- 文档新增「页面骨架导入路径」页,明确
@mox-hub/ui原子层与@mox-hub/patterns模式层的导入边界。
以上均为向后兼容的新增能力,无破坏性 API 变更。
-
#31
d068e0bThanks @mox-hub! - dogfood 分组 B(Tokens / Badge):- Badge 新增
success/warning/info语义档,走accent-*-soft底色与配套前景,浅色 / 暗色 / 高对比度自动适配,正文对比度 ≥ 4.5:1。 - 新增
accent-{blue,green,yellow,red,purple,orange}-soft与-soft-foreground语义软底对,覆盖浅色、暗色与高对比度;@mox-hub/ui/tokens导出infoSoft/successSoft/warningSoft及配套前景。 - 修正 Badge 构建产物返回类型:
dist/components/badge.d.ts不再返回null,改为JSX.Element。
- Badge 新增
-
#6
75513cfThanks @mox-hub! - 统一交互与视觉细节:全局细线滚动条(6px 可见、无箭头、透明轨道)、焦点环统一 2px/50、动作 hover 统一bg-muted、disabled 统一 50、状态胶囊统一rounded-full、卡片操作区贴右下、Markdown 表格圆角外壳、长文本截断与触控目标补齐;combobox / watch-deck 恢复可见细滚动条。Breaking
- Button / Badge 移除
linkvariant,文本链接改用新增的TextLink(@mox-hub/ui/components/text-link)。 CardFooter/SheetFooter/DrawerFooter默认右对齐;需要左对齐的元数据 footer 请显式justify-start。
- Button / Badge 移除
Patch Changes
-
#9
ebd38baThanks @mox-hub! - 组件精修(批次 1–13):统一交互态与动效时长、修正 currentColor 描边与禁用透明度、补齐键盘/ARIA/焦点边界,覆盖 Button、Input、Select、Dialog、Menu、DataTable、TreeView、Stepper、Sidebar、Toast 等 69 个可视件;不含破坏性 API 变更。A1 追加:Alert/Spinner/Sidebar/DataTable/SegmentedControl/ScrollArea 对比度收口,以及 Dialog/Sheet/Drawer/DataTable/TreeView/DetailSection/DefinitionRow/Toast/Slider 在 coarse pointer 下的 44px 命中区。
A2 追加:SegmentedControl
ariaLabel、FormControl 条件aria-describedby、Sidebarcurrent/aria-current、Stepper 纯展示 panel 省略悬空 label、TreeView 条件aria-selected与折叠焦点恢复、常驻 Toast 关闭钮与closeLabel;SelectField 补必填校验文档(RHFrules.required)。仍待裁决项见docs/组件精修/PLAN.md§5。
0.2.0-beta.1
Minor Changes
- 新增
AvatarStack(头像堆叠 + presence,复用AvatarGroup原语)与TreeView(role=tree/treeitem、roving tabindex、方向键/Home/End、受控/非受控展开)。 SelectContent把aria-label/aria-labelledby同步到 base-ui 的 listbox, 修复getByRole('listbox', { name })与读屏拿不到名称的问题。
0.2.0-beta.0
Minor Changes
-
0.2.0 beta:AI 组件三平面补齐与文档顶层 AI 分类。
- patterns 新增 13 个 AI 组件:
streaming-markdown、code-block、prompt-composer、message-actions、reasoning-block、thinking-loader、branch-picker、edit-composer、citation-list/CitationMarker、trace-waterfall、task-plan、approval-gates、artifact-panel。 assistant-message-list新增stickToBottom、renderActions、renderReasoning、renderPending;assistant-tool-card新增toolPartPhase七态归一。- 文档站新增顶层 AI 分类(
/docs/ai),跨包汇总 47 个 AI 组件为五个场景分组。 - 包含 P2 批次 1–4 与 Phase 3 的浮层、卡片、表格、表单、RTL、i18n、可访问性与 registry 收口。
- patterns 新增 13 个 AI 组件:
Patch Changes
-
修复高对比度行为规则的作用域:从
:root[data-contrast="high"]放宽到任意[data-contrast="high"]子树,使主题编辑器预览等嵌套容器也能获得 3px 焦点环、2px 控件边框与 disabled 可读性。 -
收尾:
ErrorBoundary/PageErrorFallback/AssistantToolCard等剩余 patterns 组件接入I18nProvider目录;ui 目录新增definitionRow/detailSection,日期/数字/百分比/货币统一走useFormatters;修复CentralWatchDial的 SSR 浮点坐标 hydration 漂移。文档站组件索引改为自适应预览舞台,支持逐组件画布宽度与裁切/完整展示策略。
0.1.0-alpha.4
Minor Changes
-
P2-1:通用图表壳提升到
@mox-hub/ui/components/chart。- 新增
ChartContainer/ChartTooltip/ChartTooltipContent/ChartLegend/ChartLegendContent/ChartStyle,recharts 设为 ui 的 optional peer,仅 chart 子路径引入。 - 新增
--chart-6..8与--chart-grid(明暗两套),chartColors扩展到 8 档并导出chartGrid。 - 图表网格线改用
chart-gridtoken;Tooltip 数值与图例数字标签按当前 locale 走useFormatters().number;图例新增valueFormatter。 - patterns
chart.tsx改为 re-export shim,旧导入@mox-hub/patterns/components/chart不变;根 barrel 仍不静态引入 recharts。
- 新增
-
P2-C:高对比度、forced-colors 与 en-XA 伪语言。
- 新增
theme/contrast.json→styles/themes/contrast.css生成链;data-contrast="high"覆盖全部语义 token,文本 ≥ 4.5:1、边框/焦点/图表 ≥ 3:1。 - 高对比度行为层:3px
:focus-visibleoutline、2px 控件边框、disabled 透明度 0.7。 @media (forced-colors: active)保留按钮/输入/复选框/开关边界、Highlight 焦点环与选中态。- i18n 新增
en-XA伪语言与createPseudoCatalog/pseudoLocalize/pseudoLocalizeString导出;I18nProvider locale="en-XA"文案至少加长 30%。 - 视觉矩阵新增伪语言与高对比度用例;Docs 新增可访问性页面。
- 新增
-
P2-B:registry.json、theme schema 与静态分发。
- 新增
registry.json生成器:从registry.ts输出组件条目(files / dependencies / registryDependencies / variants / status / docs),ui 与 patterns 各自生成;lint:registry-json对账。 - 新增
theme.schema.json生成器:从ThemeConfig字面量联合类型与 i18n 目录生成 JSON Schema;lint:theme-schema对账。 - 包内新增
@mox-hub/ui/registry.json、@mox-hub/ui/theme.schema.json、@mox-hub/patterns/registry.json子路径导出。 - 文档站新增
/r/registry.json、/r/patterns.json、/r/theme.schema.json、/r/themes/{default,baseColor,brand}.json;/r/themes/*.json通过 rewrite 提供。 - Foundations 新增 Registry & Theme JSON 文档页;llms.txt 增加机器可读分发入口。
- 新增
-
P2-1:新增
navigation-menu顶部导航菜单。- 基于 Base UI Navigation Menu 封装
NavigationMenu/List/Item/Trigger/Content/Link/Viewport。 - 内置 Portal / Positioner / Popup / Viewport,内容切换时按 popup 宽高变量做尺寸过渡,消费方不需要手动装配浮层。
- 支持 hover / focus / 键盘打开、Escape 关闭、焦点归还;
active链接写入data-active。 - 触发器自带 ChevronDown 旋转图标,RTL 下使用逻辑属性定位。
- 基于 Base UI Navigation Menu 封装
-
P2-1:新增
sidebar应用侧栏。- 新增
SidebarProvider/Sidebar/SidebarInset/SidebarTrigger/SidebarRail与分组、菜单、子菜单、骨架等完整组合件。 - 支持
offcanvas/icon/none三种折叠形态,start/end逻辑方向(RTL 自动镜像),sidebar/floating/inset三种视觉变体。 - 移动端自动切换为 Sheet;支持 Ctrl/Cmd+B,输入框/文本域内不劫持;展开状态可持久化到 localStorage 或 cookie。
SidebarMenuButton支持tooltip,图标轨模式下自动居中并显示名称。- 新增
sidebari18n 目录(zh-CN / en-US);dialog / sheet 的关闭按钮改用common.close,不再硬编码英文。
- 新增
0.1.0-alpha.3
Minor Changes
-
P0 统一主题与 i18n 控制面:
- 新增
@mox-hub/ui/theme:ThemeConfig/defineTheme/ThemeProvider/useTheme/ThemeScript/ baseColor 预设 / ordo 品牌预设。 - 新增
@mox-hub/ui/i18n:I18nProvider/useT/useMessages/useFormatters,内置 zh-CN / en-US 目录。 - 新增
@mox-hub/ui/tokens:颜色、图表、圆角、层级、动效、间距的 JS 视图。 - 圆角收敛为
--radius单根,默认视觉逐值不变;补color-scheme/ scrollbar / reduced-motion。 - patterns 16 个 labels + 5 个 translate + 全部硬编码交互/无障碍文案接入 Provider(station-card / central-watch-dial / watch-deck / sample-tag / sub-page-toolbar)。
pagination内置文案接入 zh-CN / en-US 目录。- RTL 逻辑属性审计:
ms/me/ps/pe、start/end、text-start/end、rounded-s/e、border-s/e;方向图标rtl:-scale-x-100;新增lint:rtl护栏覆盖 ui + patterns。 - Base UI peer 下限升至
^1.9.0(DirectionProvider)。 - 默认 zh-CN 文案与默认视觉保持不变;不包 Provider 行为不变。
- 新增
-
P1 语义完整性与护栏:
- 新增
text-heading-1..6/text-body/text-label/text-caption排印层级,默认值与旧 Tailwind 档逐值等价。 - 新增
--spacing-control-xs/sm/md/lg;data-density的 compact / comfortable / spacious 三档正式生效;Button / Input / Select 共用控件高度;Input 新增controlSize(不占用原生size)。 - 新增
--color-scrim,弹窗/抽屉/命令面板/Sheet 遮罩从bg-black迁移。 - 新增
lint:token-lifecycle;--interactive-*、--text-md标记 0.3.0 移除。 --motion-*统一为--transition-*/--ease-*别名;prefers-reduced-motion全局覆盖;transition-all收敛并由lint:spacing封禁。- patterns 接入 palette / tokens / spacing / undefined / duplicate / icons 六项护栏。
- registry 新增
variantAxes,组件页自动生成变体表;cva 组件强制登记。 - 新增 Playwright 视觉矩阵测试台(12 组核心组合)。
默认视觉保持不变;P1 的视觉变化仅在显式设置
density/font.heading/motion时发生。 - 新增
0.1.0-alpha.2
Minor Changes
- per-file 产物 + 类型泄漏依赖转 peer + raw 子路径修正:①tsup 全组件 glob 入口,
./components/<name>子路径指向真实模块文件(根 barrel 冲突裁决不再泄漏 per-file 语义);②react-hook-form/@tanstack/react-table/@dnd-kit×3/react-day-picker/date-fns/lucide-react 转 peerDependencies(类型进公共 API 面的依赖必须与消费方单实例);③raw 件子路径修正为./components/raw/<name>(此前误剥 raw 段)。
0.1.0-alpha.1
Minor Changes
- 新增 per-component 子路径 exports(
@mox-hub/ui/components/<name>×73):ordo 主仓转发层按旧 per-file 引用语义逐一接线的前提;子路径映射同一双格式产物,tree-shake 等价。
0.1.0-alpha.0
Minor Changes
- 首次发布(M1 迁移批一~批四 + M3 构建):raw/ui 两层 80 组件 + D4 升层 7 件,theme.css 主题真相源,registry 治理分册(73 条),i18n 去耦 5 件,双格式产物(ESM+CJS+dts,整包 use client 边界)。