规范包-CHANGELOG.md 2.4 KB

CHANGELOG

本规范包(组件库版)的版本与变更记录。升级前先看本文件确认变更内容。

v1.1(2026-09-01)组件底座升级(实战增强回写)

  • ui-kit 桌面组件 73 → 74:新增 ui-year-month-picker(年月选择,业务项目自建后回写底座;值契约 YYYY-MM/YYYY/至今/空)。
  • 浮层面板 fixed 化(v1.10 实战改造回写):新增 theme/floating-panel.ts(FloatingPanelController)+ theme/floating-position.ts(定位纯函数,零依赖,含单测);select/autocomplete/cascader/date-picker/dropdown/time-picker/popover/tooltip/popconfirm/data-table 十个组件面板改为 fixed + FloatingPanelController 定位,解决「面板在滚动容器/overflow-hidden 卡片内被裁剪」;components 统一经 ../../theme 引用,自包含、无外部依赖。
  • 组件增强:modal 新增 busy(忙碌禁止关闭,遮罩/Esc/X 全部失效,X 变 spinner);button 新增 pill 胶囊形状;accordion content 支持 string | TemplateRef + titleClass;tag-input 新增 changed 输出;upload 新增 compact/simulate;upload-avatar 新增 changeFile 输出。
  • barrel 补齐:ToastService/ToastItem/ToastType 从 components/index.ts 命名导出。
  • 官方底座同步:官方仓库与 ui-kit 底座逐字一致(唯一可构建/可验证宿主,showcase 登记 year-month-picker 与「浮层防裁剪」演示,pnpm test/pnpm start 验证)。
  • 规范同步:18-UI设计规范(组件数 74+56,浮层 fixed 模式,删除确认用 ui-modal);15-经验教训(浮层裁剪教训);ui-kit/README(浮层定位模式章节);移动端 56 个不变。

v1.0(2026-08-21)首发

  • 本版从 企业交付版 v1.0(2026-08-19)+ 2026-08-20 官方组件底座融合基线派生,定位为组件库版(包内自带组件库)。
  • 新增 ui-kit/:官方组件库最小可复用集——桌面 73 + 移动 56 个 Angular 组件(src/app/ui 整目录)、styles.css(语义 token/明暗/6 主题色/z-index 十级)、styles.scss(动画)、tailwind.config.js(token→工具类映射)、postcss.config.json;附带 ui-kit/README使用说明.md(复制步骤/依赖清单/非自包含连带说明)。
  • rules/18-UI设计规范.md 更新:底座路径改为包内 ui-kit/、组件数修正 73+56、引用 ui-kit/README使用说明.md。
  • rules/04 / rules/06 同步:去除底座绝对路径引用,底座指向包内 ui-kit。
  • 目录结构审计+补充:README 目录地图、新增 ui-kit/ 目录、组件数字修正(桌面 73 + 移动 56)。