# 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)。