Astryx

Astryx 发布 v0.5.1（@astryxdesign/* 全包同版本）。core 新增 Card 变体可主题扩展（CardVariantMap 接口）、Toast 自定义 renderContent 布局与触控/手写笔滑动关闭、CheckboxInput/Switch/TextArea 稳定主题目标、Avatar 非圆形 shape、DateInput 原生日期选择器控制（nativePicker）、CLI 新增 table-filter 页面模板与无障碍说明渲染等；并修复 Button/Card elevation 主题落点、RTL 安全区、表头截断 tooltip 重复、多个 WCAG AA 对比度与无障碍问题，Vite 构建按级联层分包使主题覆盖在生产构建生效。

Astryx 发布 v0.5.0（@astryxdesign/* 全包同版本）。core 将 Stepper/Step 从 Lab 升级到 Core 稳定包（水平/垂直布局、步骤推进连接线动画），Banner 折叠轴收敛为单一 collapsible 配置并移除 defaultIsExpanded（提供 astryx upgrade codemod 迁移），Overlays 统一共享关闭栈（单次 Escape 只关闭一层），DateTimeInput 新增 timeOptionInterval 预设时间下拉，parseMarkdown 新增可选 sourceRanges 源码区间，useTableSelection 新增 hasRowHighlight，TabList 新增 WAI-ARIA tabs 模式与窄带滚动；CLI 新增 astryx theme targets 主题目标枚举。另有 Table/Calendar/Chat 等多项无障碍与对比度修复。

Astryx 发布 v0.4.7（@astryxdesign/* 全包同版本）。core 修复 BottomSheet 关闭动画：非模态弹层在 iOS 26 Safari 地址栏下用自己的表面着色、点击拖拽手势提升为需 8px 位移才触发、退出改用加速曲线约 50ms 内离屏、遮罩以 linear 随弹层退出、BottomSheetSwitcher 切换流同样处理；useListFocus 仅在传入 onEscape 时才消费 Escape 键，否则交由外层焦点陷阱/原生 popover 处理（AvatarGroup、TabList 等无 onEscape 组件行为变化）；TabList 选中项改用 aria-current="true" 表示当前项而非当前页。获贡献者 @cixzhang、@imdreamrunner。

Astryx 发布 v0.4.6（@astryxdesign/* 全包同版本）。core 的 DateInput 新增针对触屏的滚轮日期选择面板（pointer: coarse 底部弹层、44px触控目标、月/年滚轮）；Tooltip/HoverCard 新增 touchTrigger 触控打开开关；MediaTheme 新增 mode=auto/off 自适应并接入 Toast；导出 useLocale/useCollator；Section/Stack/Center 新增四边 padding 轴 props。CLI 支持集成贡献参考文档主题（replaces/extends），新增五个 dashboard 页面模板，并修复多组件 WCAG 2.5.8 触控目标、主题与 codemod 等多项问题。

Astryx 发布 v0.4.5（@astryxdesign/* 全包同版本）。BottomSheet 新增 snapPoints 让宿主决定拖拽停靠点，区分可滑走的 peek 与工作区（此前所有 sheet 内置 14%/50%/92% 三个停靠点，行为改动有意且非破坏）；组件内置翻译由 en/fr-FR 扩展至 28 个新 locale（共 30 个语言文件，Crowdin 每晚刷新）；DateRangeInput/Calendar 新增 maxRangeSpan 与 minRangeSpan 约束选择范围；FormLayout 新增 defaultOptionality 表单级默认必/选填；新增 astryx-input-clear-button 主题目标。修复 iOS Safari BottomSheet 上拉展开手势、StatusDot 各变体几何形状（WCAG 2.1 SC 1.4.1）、Markdown 标题锚点、Table 展开箭头 RTL 镜像等。

Astryx 发布 v0.4.4（@astryxdesign/* 全包同版本）。BottomSheet 与 BottomSheetSwitcher 从 Lab 升级至 Core 稳定包；CLI 新增 astryx template --cdn 无构建步骤 CDN 起步页、theme build 支持一次编译多个主题文件；defineTheme 的 color.accent 支持 [light, dark] 二元组。修复 BottomSheet 手势/视口跟随、IME 组合输入误触、屏阅读器本地化、Switch 隐藏标签间距，并移除无法兼容 React 19 的 UMD bundle。

Astryx 发布 v0.4.3（@astryxdesign/* 全包同版本）。core 新增按用户可见整字符计数的字符串工具并用于 TextArea 计数/PowerSearch token 截断/Table 表头/Avatar 首字母；ComplexSelector 支持 ghost 触发器、前导图标、popup 对齐与命令式 handleRef；useContainerReveal 新增悬停意图控制。修复 Banner 焦点/ARIA/主题、主题 extends 继承链丢失、Markdown 解析器安全加固、TreeList variant 主题轴等，多主题修复 /built ESM/SSR 入口。

Astryx 发布 v0.4.2（@astryxdesign/* 全包同版本）。@astryxdesign/core 新增 ChatMessageBubble 的 width prop（可与 ghost 变体组合对齐消息列）、AvatarGroup overflow 主题 size 轴、astryx theme template 命令（生成带注释的空白主题模板并受机器校验，init --features theme 也调用）；CLI theme build 新增字体加载校验。修复 Avatar 主题落点、context-menu 主题半径/padding 映射失效、useFocusTrap 焦点逃逸、Heading type 主题告警、浮层继承 body 字号、Slider 拇指越界、WCAG 2.5.8 触控目标等多项无障碍与主题问题；theme-butter/chocolate/gothic/stone 修复 --radius-none 被错误覆盖。

Astryx 发布 v0.4.1（@astryxdesign/* 全包同版本）。键盘焦点环改为主题 token 驱动，focus-outline 系列 CSS 变量系统级统一（含 drift 偏移修正）；12 个组件移除 'use client' 指令，可在 React Server Component 中渲染（新增 serverSafeComponents 守卫测试）；Selector/MultiSelector 新增 indicatorPosition 逻辑方向定位。修复 TimeInput 无障碍播报与 i18n、CommandPalette 关闭时丢弃在途搜索、FileInput/DropdownMenuRadioGroup 样式合成、popup 主题 target 落点、TableRow className/style、selector 搜索面板重排等；CLI 修复 theme build 对 state override keys 的误告警。

Astryx 发布 v0.4.0：DropdownMenu 模式对齐新增 DropdownMenuDivider 与 destructive variant；useTableRowExpansion 重构为 detail-panel 插件并新增 useTableTreeData/TreeState；新增 useClipboard hook 与 useLayer offset；NumberInput/TextInput 等新增 isReadOnly；新增多种可主题化 target 与 themeable indicators；修复多处无障碍与 RTL。CLI 新增 migrate 到 tree 的 codemod 与自文档化 .doc.mjs 层；build 修复 ESM 下 node:fs 动态导入问题。带 astryx upgrade codemod 迁移破坏性变更。

Astryx 发布 v0.3.0：破坏性变更包括 DropdownMenuRadioGroup 必填 label、创作接口迁移至 @astryxdesign/cli/authoring 并移除 core 的 create* 工厂（astryx upgrade codemod 自动迁移）。新增 Carousel 循环滚动与 handleRef、ComplexSelector、Dialog 逻辑 start/end 定位、Pagination 可编辑页码 input 变体、ProgressBar marks 目标线、Timestamp 可复制 hover card 与 relative_short 格式、useContainerReveal hook、Markdown/Table/Text 主题扩展与 SSR 主题解析；完成 RTL 物理→逻辑属性迁移与多项 WCAG 修复；CLI 统一人类可读输出 formatter 并做路径安全加固。

Astryx v0.2.0：少量破坏性变更（TabList 移除 orientation prop；CLI JSON 类型重构），新增 Avatar 可交互形态与 AvatarGroup roving Tab、DropdownMenu 子菜单、12 个 bordered inputs 的 statusVariant tooltip/detached、useDirection RTL 方向 API 与多阶段物理→逻辑 CSS 迁移、Switch sm/md size、Table rowIndexStart/rowCount、Timestamp tooltipEntries、Token 模块增强、TreeList 主题变量与 variant。修复 WCAG 1.3.1/1.3.2/1.4.1/2.4.7/4.1.2/4.1.3、FileInput 嵌套交互 a11y 违规、Slider 浮点误差；CLI blog/init/theme build/upgrade 命令脚本化到 ./api barrel 并重组为分形 leaf shape。

Astryx 发布 v0.1.9 全补丁版本（无破坏性变更，无需 codemod）：Avatar 新增 tooltip prop；BreadcrumbItem 新增 menu 菜单触发器；Calendar/CommandPalette/TreeList 新增多个 defineTheme 主题目标；ChatComposer 公开 useChatComposerContext() 使自定义输入成为一等公民，ChatComposerInput 新增 onKeyDown 接缝并修复 IME 组合期间 Enter 误提交；DateInput 新增 format prop 与 Timestamp 格式对齐；Card/Button/Banner 等表面新增 elevation prop；OverflowList 新增 maxVisibleItems/maxRows；Table 树新增表头展开/折叠全部控制并新增 useTableRowStatus 行状态插件；CLI 的 build/swizzle/layout/validate 命令获得完整 API 覆盖并支持 --json 输出；另含大量无障碍与

Astryx 发布 v0.1.8：Avatar/AvatarGroup 尺寸刻度改用 xsm/sm/md/lg/xl（破坏性变更，附 upgrade codemod）；DropdownMenu/ContextMenu 新增 CheckboxItem 与 RadioGroup 可选中项；Table 新增树形数据插件（useTableTreeState/useTableTreeData）；Icon 新增 label 无障碍属性并改用 rem 尺寸；Outline 获得键盘导航与滚动作用域 props；CLI 的 init --features agents 默认生成 AGENTS.md，init 支持非交互运行，upgrade 每次都会同步托管的 agent-docs 区块。

Meta 正式开源内部运行八年、覆盖 13000+ 应用的 React 与 StyleX 设计系统 Astryx，采用 MIT 许可，提供 150+ 无障碍组件、七种主题、暗色模式、模板及 Agent 就绪 CLI，要求 React 19+。

Astryx 发布 v0.1.7：全部组件支持国际化（InternationalizationProvider + useTranslator），覆盖 PowerSearch、Dialog、Calendar、Chat 等全套组件；Button 新增 width prop；Table 插件 render-prop 接口 styles 字段更名为 xstyle（破坏性变更，提供 codemod）；新增 i18n ESLint 规则；CLI 新增文档创作 API 与多个修复。