Ordo UI

CHANGELOG

@mox-hub/ui 版本变更记录(changesets 生成)

0.2.0-beta.2

Minor Changes

  • #32 09fe46b Thanks @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> 内)。
  • #33 1ebc40a Thanks @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 d068e0b Thanks @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。
  • #6 75513cf Thanks @mox-hub! - 统一交互与视觉细节:全局细线滚动条(6px 可见、无箭头、透明轨道)、焦点环统一 2px/50、动作 hover 统一 bg-muted、disabled 统一 50、状态胶囊统一 rounded-full、卡片操作区贴右下、Markdown 表格圆角外壳、长文本截断与触控目标补齐;combobox / watch-deck 恢复可见细滚动条。

    Breaking

    • Button / Badge 移除 link variant,文本链接改用新增的 TextLink(@mox-hub/ui/components/text-link)。
    • CardFooter / SheetFooter / DrawerFooter 默认右对齐;需要左对齐的元数据 footer 请显式 justify-start。

Patch Changes

  • #9 ebd38ba Thanks @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、Sidebar current/aria-current、Stepper 纯展示 panel 省略悬空 label、TreeView 条件 aria-selected 与折叠焦点恢复、常驻 Toast 关闭钮与 closeLabel;SelectField 补必填校验文档(RHF rules.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 收口。

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-grid token;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-visible outline、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 下使用逻辑属性定位。
  • 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,图标轨模式下自动居中并显示名称。
    • 新增 sidebar i18n 目录(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 边界)。