# Changelog

所有显著改动按 [SemVer](https://semver.org/) 记录于此。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。

## [Unreleased]

## [1.2.0] - 2026-09-10

### Added — 设计契约与工程化
- B1 契约第一批：15 个输入类组件补齐契约 JSON（autocomplete / cascader / transfer / rate / slider / segmented / radiocard / checkboxcard / switchgroup / numberrangeinput / codeinput / passwordinput / phoneinput / colorpicker / mention），契约化覆盖 6 → 21/79
- C4 静态薄壳：`site/components/<slug>.html` × 79（每组件独立可爬 URL：title + meta description + canonical + 刷新跳转），`sitemap.xml`（80 URL，部署后回填 `$SiteUrlBase`）
- C3 headless 回归：79 个测试页全量执行 812 条断言（当前通过率 75.1%，失败项即改进 backlog），产出 `tests/report.json`；CI runner `tools/run-regression.mjs`（Playwright，含 JUnit XML 输出）
- 首页 Hero 显示「测试通过率」（读取 tests/report.json，无报告时静默隐藏）
- B3 Playground：组件详情页「▶ 在线试玩」——textarea 编辑 H5 源码，iframe srcdoc 防抖实时重渲染，支持复位 / 退出，不影响源文件
- C1 交叉引用：组件详情页新增「相关组件」（相似 / 搭配维度映射 + 同分类兜底）
- 场景示范页：`site/scenario/user-management.html`（筛选表单 + 数据表格 + 分页 + 新建弹窗 + 消息反馈，视觉全部来自令牌与 components.css），首页 Hero 加入口
- 部署物料：根 `README.md`、Pages 入口 `index.html` 重定向、`.github/workflows/deploy-pages.yml`、`.gitignore`

### Fixed
- 测试页断言协议落地：`tests/_runtime.js` 运行期自动标注快照节点 `data-assert`（多级结构启发式：.row → .demo → .demo-block → 首层；此前 79 页实际无断言节点，PLAN v1.1 声称与实现不符）
- `site/data.js` / `site/data.json` 去除 UTF-8 BOM（PS5.1 `Set-Content` 默认带 BOM，严格 JSON 解析器如 node require 直接解析失败）
- 断言可见性判定放宽（`getClientRects` 兜底），减少隐藏变体误报

## [1.1.1] - 2026-09-08

### Added — 竞品对齐改造（第一批，依据《竞品网站检查报告》与《现状问题分析与改造清单》）
- For Agents 页（`#/agents`）：AI / Agent 消费入口——机器可读资源清单、data.json 数据形状、消费示例、使用规则
- `site/llms.txt`：LLM 入口清单，指向 data.json、契约 JSON、令牌文件与测试页
- 站内更新日志页（`#/changelog`）：`build-site.ps1` 解析本文件注入 `data.js`，站点展示与仓库同源
- 主题预设库：主题定制器内置 6 套品牌色预设（科技蓝 / 青碧 / 极夜紫 / 暖橙 / 绯红 / 松石绿），一键切换后仍可微调
- 组件详情页新增「API 源码提炼」徽章，区分契约化组件（6 核心）与源码提炼组件（69 扩展）

### Fixed — 文档与实现不符
- 搜索增强补票：Ctrl+K 弹窗补齐分类 chip 过滤、命中关键词 `<mark>` 高亮、子序列模糊回退（PLAN v1.1 曾声称交付但代码缺失）；搜索结果行补写 `data-slug` 修复搜索日志点击目标为空的问题

### Changed
- 暗色模式令牌映射补全：`html.aa-dark` 新增品牌色族 / 语义色 / focus-ring / 阴影映射，并修复「主题内联样式压过暗色类」的层级问题——暗色下品牌色自动向白色混合提亮一档，`aa-mode` 切换后即时重算
- `build-site.ps1`：`meta.version` 不再硬编码，改为从 CHANGELOG.md 最新版本号自动同步

## [1.1.0] - 2026-09-07

### Added — 文档体系补齐
- `PLAN.md`：完整组件文档体系规划与路线图，含 5 大模块、3 版本路线、验收标准
- `CHANGELOG.md`：本文档
- `CONTRIBUTING.md`：贡献指南（如何新增组件 / 修契约 / 加测试）
- `TESTING.md`：测试矩阵、断言协议、回归流程
- `tests/<slug>.html` × 79：每个组件独立测试页（HTML+CSS+原生 JS 零依赖）
- `tests/index.html`：测试总览页（按类目聚合 + 通过率 + 失败项）
- `run-tests.ps1`：批量构建测试目录脚本

### Added — 日志系统
- `site/logger.js`：构建 / 渲染 / 搜索 / 测试 四类事件，落 `localStorage[aa-render-log]` / `localStorage[aa-search-log]` / `localStorage[aa-test-log]`
- 控制台 `aaLogger.export()` 导出 JSON
- 测试页内置 `data-assert` + `data-status`，便于 Playwright / Selenium 回归

### Added — 搜索增强
- Ctrl+K 弹窗内新增分类 chips 过滤（general / navigation / input / display / feedback / system）
- 命中关键词 `<mark>` 高亮
- 模糊容错：去空格 + 子串匹配 + 大小写不敏感
- 搜索日志：query / 命中数 / 首个命中 slug / 耗时

### Added — 文档骨架
- 顶栏工具新增「测试」「日志」入口（HAMBURGER 之后）
- 组件详情页新增「测试页」链接
- 首页 hero stats 加入「测试页 79」一项

### Changed
- `site/app.js` 改为引用 `site/logger.js`，原搜索行为保留
- 扩展组件契约新增「doNotInvent / unknowns」字段自动从 spec 文本提取

### Fixed
- 主题定制器焦点环 rgba 计算 bug：hex 转 rgba 不再被截断为 6 位
- 类别切换时滚动条保持原位（避免视觉跳动）

## [1.0.0] - 2026-09-06

### Added
- 79 个组件实现（H5 / React / Vue 2 / Vue 3 四端）
- 设计令牌：`colors_and_type.css` / `css.json` / `components.css`
- 6 个核心组件契约 JSON
- `components/index.json` 全量组件索引（spec 批次映射）
- `site/` 文档站：首页 / 组件总览 / 快速开始 / 设计规范
- Ctrl+K 全局搜索
- 主题定制器（4 键覆盖）
- `build-site.ps1` 构建脚本

### Notes
- 数据生成产物：`site/data.js`（自动生成，请勿手动编辑）

---

## 标签说明

- `Added`：新功能
- `Changed`：现有功能变更
- `Deprecated`：即将移除
- `Removed`：已移除
- `Fixed`：缺陷修复
- `Security`：安全相关

## 版本约定

- 主版本号：不兼容的 API 变更
- 次版本号：向后兼容的功能新增
- 修订号：向后兼容的问题修复