v0.9.2
0.9.2 - 2026-07-08
⚠️ Breaking Changes
- shared,docs: 移除
media组件分类并将原组件重新归类,修正 7 个误分类组件,重构中英文文档 sidebar 为元数据驱动自动生成。消费 registry JSON 中category === 'media'的外部代码需要迁移 (fca8ab9)
✨ Features
- cli: 扩展 CLI 组件 management,diff/update/remove 全面沿用安装清单来源,并支持在
list中展示组件安装来源与检查更新、更新可用性提示等 (6e1f2bc, fa93917, fd251be, 3c03207, 516a2a3, 8bca38c, b4d9160) - cli: 在本地安装清单中记录组件详细元数据,并添加 CLI 运行时错误恢复建议引导 (2e3a57e, 46f7286, 6debec9)
- registry: 实现编译期依赖去重与循环依赖校验,并支持构建期输出依赖图与组件分类元数据 (678e705, 0226663, dedba66, 4dbddac)
- registry: 增加组件生命周期状态管理与自动校验,防止打包时引用未知组件或跨组件非法导入 (cd7d390, 6be7eff, 4152e46)
- registry: 引入注册表构建清单生成与校验机制,同时支持输出发布版本和 SHA-256 完整性哈希元数据 (c8b4eed, a4035d2, c7c2520, adf0c20)
- shared: 新增
sidebarGroup/kind/docsHidden/docsSlug元数据字段,支持 docs sidebar 自动生成、组件/区块路由前缀区分与别名 (fca8ab9, 10a3d3c) - docs: 支持根据
COMPONENT_REGISTRY动态生成文档侧边栏,并增加 validateSidebarCoverage 校验,确保文档与注册表强一致 (fca8ab9)
♻️ Code Refactoring
- cli: 重构 CLI 构建架构为双入口(CLI 命令行 & 公共 API 服务),新增
src/api.ts暴露全部服务模块,并解耦并抽离出初始化、安装、写入、差异比对、卸载等独立服务 (c2aa807, 50d89a9, 8e833ae, ab1ed17, d6129c9, 05509b7, 409ddf4) - ui: 清理老旧与废弃组件代码,移除 legacy 公开分发入口;将 EmptyState 替换为 Result 空状态实现,UploadCard 重构为复用 Upload,GlitchButton 转发至 Button,CarouselEnhanced 转发至 Carousel 核心组件 (4a7c246, d0517fe, a2cf070, 251b942, 3db365e, 615a768)
- ui: 统一及归拢多选与交互逻辑,重构 Cascader / TreeSelect / DatePicker 系列组件的清除与确认面板操作;收束 SearchWidget / Transfer 组件状态与浮层样式令牌 (32cef0f, 9698608, b6465e4, 1dab740, 7638eb6, 46e93c4, 23de46c, c1aae32)
- registry: 重构并优化组件依赖与文件映射逻辑,引入 TypeScript AST 分析导入依赖;将组件文件映射移动至共享包,消除硬编码映射 (c072fc9, eb46d48, 3304703, e5a53ba, 6503fcd)
🐛 Bug Fixes
- ui: 修复 P0 级浏览器兼容性降级问题(如 Image、InfiniteScroll、Audio 及函数式弹窗的 body guard 访问限制);补充组件主入口导出(Calendar、Carousel、CodeBlock 等) (93b4d67, faef356, a2129d1, 8337712)
- cli: 修复 Tailwind 配置中对已废弃的 brutalism 插件导入提醒;修复辅助包安装、Vite CSS 路径识别与事务回滚失败等问题 (3d373db, fed8143)
- registry: 修正 DataTable 筛选条件合并兼容缺陷,同步收口 legacy 组件合并状态,补齐清除组合式函数(useClearable)与 Button 的元数据映射 (9e012d1, 475790e, 1640634)
📝 Documentation
- docs: 补充完整组件的中文描述文本以替换原有占位信息,移除区块文档中的冗余列表项 (2ac4292, 54bd2e7)
- docs: 区分本地 CLI 开发运行环境与仓库工作流,明确 DatePicker API 语义,更新组件合并治理与技术债收敛报告 (495b6cc, e4c6c9a, c9578ac, a556170)
- ui: 明确日期解析 API 规范、子路径白名单和主题 fallback 处理细节 (706a205, f810fd9, 6f55b15)