Astryx

Astryx 发布 v0.7.0（全包同版本，npx upgrade --apply 升级）。core：DropdownMenu 新增 header/footer 插槽与子菜单行透传属性；BottomSheet 默认内容 padding 并入共享层 Escape 关闭栈；Toast 视口移入 Dialog 保持可点击；Lightbox 切图即重置缩放；16 个字段类组件样式接口重构为 container*/control*；间距 token 改 rem，四主题手机字号升到 16px；Markdown transform 在列表/引用文档不再误走 fallback。CLI：theme add 改导入已构建主题、theme eject 复制源码；upgrade 新增 migrate-field-input-styling codemod；移除 layout 命令组与 ASTRYX_* 变量；无效输入与私有主题变量改为报错退出。

Astryx 发布 v0.6.8 补丁版（非预发布）。core 新增 Table 列宽拖拽手柄（指针入表头即显示、触屏键盘可达、可与 sticky 列组合）；DropdownMenuItem 支持向宿主行透传属性与事件处理并保留内置 role/焦点/菜单行为；Markdown 新增可选 markdownSourceLinesPlugin 源行元数据插件。修复 AppShell 跨移动端导航断点保留内容与输入焦点、Calendar/DateRangeInput/DateTimeInput 受控空区间与清空状态、触控长按打开的 DropdownMenu 抬指不关闭、行间拖拽误触原生链接拖拽、Kbd 达 WCAG AA 对比度、层叠容器内 Stepper 连接线继承、语义 Markdown 围栏仍走插件渲染。CLI integration verify 接受 replaces(0.6.4)/keywords(0.6.6) 已发布最低版本，主题指引改指向调色板生成器。

Astryx 发布 v0.6.7（@astryxdesign/* 全包同版本，npx astryx upgrade --apply 升级）。core 新增 Item 触摸滑动操作（swipeActions/swipeBehavior）、Drawer 容器化 padding 内容区、MultiSelector 选项次级操作（role=grid）、useTableRowExpansion 新增 panelVariant 与整行点击展开并修复斑马纹计数；Markdown 修复缩进表格、未闭合代码块与流式列表合并；BottomSheet 恢复捏合缩放。CLI 新增 theme add --import 包托管主题、theme build 输出 .css.d.ts、集成组件可替换 Core 组件，新增 model comparison 与 table-collapsible 模板；八个主题包新增 /fonts.css 导出。

Astryx 发布 v0.6.6（@astryxdesign/* 全包同版本，可 npx astryx upgrade --apply 升级）。core 新增首方 Markdown heading-links 插件（生成防碰撞标题锚点与可复制标题链接）及 MarkdownPluginNodeRenderer 插件节点渲染器；Markdown 解析大幅对齐 CommonMark（字符引用解码、反斜杠转义、链接括号配对、标题与代码围栏缩进识别），深层嵌套与未闭合链接解析优化至线性时间，可抵御恶意消息导致的渲染卡死；DropdownMenu 支持挂载到任意控件（trigger 渲染）并让菜单项支持 href 真实链接，新增 macOS 式触控按压与移动端子菜单钻入；MultiSelector 新增 hasCreate 无匹配建项与 renderTrigger 外部控件挂载；CLI 新增 astryx docs --depth/--detail 分级文档阅读、integration add theme --from 主题 fork，模板支持 keywords 元数据并参与页面构建起笔排序。

Astryx 发布 v0.6.4（@astryxdesign/* 全包同版本，非预发布，可 npx astryx upgrade --apply 升级）。core 新增 Timer 计时组件、DateInput/DateTimeInput/TimeInput 的 presentation 选择器表面属性（废弃 nativePicker 并提供迁移 codemod）、List edgeCompensation、Markdown 首方 soft-breaks 插件、Table 批量操作包装；DialogHeader 标题支持 ReactNode。修复 ChatLayout 滚动按钮 WCAG 2.4.7 键盘焦点、CodeBlock 自定义 tokenizer 崩溃、StyleX 简写样式丢失等。CLI 重构 docs 为树形分级阅读与按节搜索，新增 Tree Table 等页面模板、集成模板 replaces 前置支持及大量符号链接路径穿越安全修复。

Astryx 发布 v0.6.3（全包同版本，非预发布，npx astryx upgrade --apply）。core 新增 Canvas Editor 页面模板（分层画板、可调图层面板、实时文字/图片控制、缩放、文档标签、固定主题画布）；Markdown 新增原生类型化 frontmatter、核心插件协议（createMarkdownPlugin，parser/Outline 同序插件）、有限 Remark 兼容适配器、语义代码块变换及不可变源码装饰/文本变换助手，插件流水线开销从约 3.3x 降至约 20%；ChatComposerDrawer 新增 collapsedSummary 插槽，多控件新增按压反馈。修复 BottomSheet/Table 过度滚动与键盘可达、iOS Safari Spinner 抖动（改描边动画）、触摸端 16px 字号误伤 Android 等无障碍问题。

Astryx 发布 v0.6.2（全包同版本，非预发布，可 npx astryx upgrade --apply 升级）。core：Markdown 新增可选数学公式渲染器 components.math，解析 $…$ 行内与 $$…$$ 块级公式，默认关闭、代码与未匹配分隔符保持原样；DialogHeader、DateRangeInput、Slider、FileInput 图标新增主题目标，Spinner 新增 --spinner-arc-fraction 变量；ChatTypingIndicator 与 Spinner 无障碍文案改走翻译目录本地化。CLI：astryx init --agent 新增面向 Muse Code 的 muse 预设（AGENTS.md），支持按主题族构建单组带 key 产物；修复 doctor 误判 NODE_PATH 环境 peer 依赖（遍历项目自身 node_modules 并兼容 Yarn PnP）、.doc.mjs 加载崩溃、含连字符主题名生成非法 JS 标识符、不支持硬链接文件系统暂存写入等问题。

Astryx 发布 v0.6.1（@astryxdesign/* 全包同版本，非预发布，可用 npx astryx upgrade --apply 升级）。core 新增 ScrollableArea/useScrollableArea 无障碍逻辑轴滚动组件（显式 overscroll 策略、仅内容溢出时键盘可达），移除主题本地 token 前缀要求；修复 BaseTypeahead 窄布局无障碍、TextInput 在中日韩 IME 组词提交时误触 onEnter、Field 输入框层叠压过 AppShell sticky 头部、清除按钮焦点恢复导致页面跳动等问题。CLI 可自动加载仅在 dependencies 声明而无需 astryx.config 登记的集成（doctor 新增 implicit-integrations 行），gap 报告改为可组合多 handler 扇出，新增 astryx integration add 与 integration pack --check 集成编写/打包校验，支持集成贡献源主题及 ShadCN 复制组合的升级收据与三方安全对账。

Astryx 发布 v0.6.0（@astryxdesign/* 全包同版本，含破坏性变更，需先跑 npx astryx upgrade --apply）。defineTheme 新增有序环境适配：可按视口宽度断点、指针精度、对比度与动效偏好做 token/组件改写；AppShell 移动导航断点支持 xl/2xl。停止输出 .primary/.sm/.checked 等裸 class，统一改用 data-* 属性选择器（codemod 可迁移 CSS），并移除多项废弃 API。新增 Banner banner-frame 主题目标、Collapsible chevronPosition、Heading 字重覆盖、TextInput/TextArea autoComplete；CLI 新增 OKLCH 调色板生成器、集成清单托管 agent 指引、doctor integration 检查及实验性 shadcn Registry 兼容指南；withAstryx() 现拒绝 Turbopack 配置。

Astryx 发布 v0.5.4（core 包族统一版本）。修复 DropdownMenu 在受控菜单以已展开状态挂载时的焦点保持，聚焦触发器上按 ArrowDown 可直接进入已打开的菜单而无需先关后开；修复 DropdownMenuRadioGroup 在文档站属性预览中不可选的问题。CLI 集成保留 block showcase 元数据，使各包可自带文档站预览，Charts 纳入柱状图示例；Stepper 文档同步导出的 context 接口。官方警告 v0.5.3 改变了 StepperContextValue / useStepperContext 形态，v0.5.4 未修复该兼容破坏，直接调用该 hook 的使用者建议留在 v0.5.2。

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 与多个修复。