klun-ui 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,77 @@ All notable changes to **klun-ui** are documented here. The format follows
 [Semantic Versioning](https://semver.org/) (pre-1.0: minor/patch bumps may carry
 small breaking changes).
 
+## [0.7.0] — 2026-10-08
+
+尺寸标准落地（第 62 批）：把「每个组件多大」从文档搬进机制，并统一**字段族的几何与配色**。
+
+> **含观感变更**：控件/字段的圆角与高度、部分字号与图标尺寸、kk 皮肤下的几何。
+> 需要改代码的迁移见 `docs/design-standards/MIGRATION.md` §1.4；本轮**没有移除任何公开 API**。
+
+### Added
+
+- **`SIZE_CONTRACTS`（`src/components/config/size.ts`）——每个组件尺寸的唯一来源。**
+  登记 47 个组件的档位、默认值、全局档位映射，以及不跟随全局时的理由。
+- **`useScaleSize()` / `useDensity()` / `resolveSize()` / `tierOf()`** 及
+  `SizeType` / `GlobalSize` / `SizeContract*` 类型，从包入口导出。
+- **逐组件尺寸规格（137 份 + 索引）** → 仓库内 `docs/design-standards/components/`；
+  格式对齐 Ant Design 的「主题变量（Design Token）」：尺寸表 / 组件 Token / 默认几何 /
+  图标 / 全局档位跟随 / 与 KDS 的差异。由 `scripts/kds-size-spec.mjs` 生成并校验。
+- **全局尺寸 Token 文档**与 **Storybook 规格页**（`KDS/Size specs`：全局 Token / 按组件查阅 / 索引）。
+- 新 token：**图标阶梯 `--klun-icon-size-{xs,sm,md,lg}`（16/16/18/20）**、非控件图标档
+  （micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72）、
+  **代码字号 `--klun-code-size`（13/20）**、**热区 `--klun-hit-area-min|touch`（24/44）**、
+  间距补齐 `--klun-space-20|64`。
+- 新门禁（均纳入 `kds-verify`）：`kds-size-contract`（+ 自测）、`kds-size-spec`、
+  `kds-geometry-ratchet`（字面几何只降不升）、`kds-field-family-check`、
+  `kds-baseline-provenance`（以**渲染源指纹**判定：组件/token 一变就必须重采基线，
+  改版本号或文档只提示）。
+- 测量流程脚本化：`kds-capture-probe.mjs`（11 个故事/组合的采集探针）+
+  `kds-measure-baseline.mjs`（合并片段、重写出处、记录渲染源指纹）；
+  基线可直接被 `kds-measure-diff.mjs <capture.json>` 对比检测漂移。
+
+### Changed
+
+- **全局 `ConfigProvider size` 现在覆盖全部有离散档位的组件**：此前 Badge、StatusBadge、
+  Toggle、CopyButton、ChartLegend、ContentLabel、KeyIcon、Money、StatusDot、Item、
+  GaugeBar、RangeSlider 等忽略全局尺寸（全库仅 25/137 生效）。
+- **密度收敛为单通道**：`<html data-density="compact">` 与 `<ConfigProvider density="compact">`
+  语义一致；`Table` 改用 `useDensity()`（此前只写属性时表格不跟随）。
+- **皮肤不再改几何**：kk 原本在 `[data-mode="kk"]` 里重定义整条控件高度与圆角，
+  使 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px。现在几何只由显式轴决定：
+  控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+- **字段族统一**（同一 size 档必须长得一样）：Cascader / SelectMenu / TimePicker /
+  InputGroup / RichEditor 的 medium 圆角 10px → **8px**；**CounterInput** 档位
+  32/36/40 → **36/40/48**（圆角 8/10/10 → 6/8/10）；**CronEditor** 默认档 32/10 → **40/8**；
+  TimePicker / InputGroup 的横向内边距改用字段 token。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`
+  （表单层统一，工具条里的组件保持固有宽度）。
+- **覆盖层/字段圆角对齐 KDS 档位**：Textarea 8/10/12/12 → **6/6/8/10**。
+- **SelectMenu / Cascader 的触发器圆角**、**InputGroup 组圆角**随档位对齐（10 → 6/8/10）。
+- **547 处字面几何改用语义 token**（`gap`/`padding`/`margin` → `var(--klun-space-N)`，
+  101 个文件）。**值等价**：仅当字面值与 token 完全相等时替换，且无主题/消费方覆盖这些 token，
+  因此任何皮肤与密度下渲染不变。
+- 字号全部 token 化（144 处字面 `font-size` → 0）：文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯；其中 **9 处 13px 文本收敛到 12px 辅助档**、**代码块 12px → 13px**（KDS §1.3）。
+
+### Fixed
+
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**、
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24）；
+  compact 同步下调一档；**热区保持 24px 不缩**（新增 `--klun-hit-area-min`）。
+- **文本按钮与输入框的图标**此前写死 20px（xsmall 档 32px 控件也配 20px 图标），
+  现按档位 **16/16/18/20**，与图标按钮一致；顺手把 15→14、17→18、26→28 三个魔法数收进档位。
+- **日期/时间/范围选择器触发器**不再复用 readonly 弱底，改用新增 `.klun-input--trigger`
+  保持字段表面（暗色实测 rgb(38,38,38) → rgb(23,23,23)）。
+- **`InputGroup` 内嵌完整 `<Input>` 时不再出现「框中框」**（组内控件透明、无圆角、无描边）。
+- **`kds-inventory` 的 `rootClass` 口径修正**：旧正则把 `var(--klun-*)` 与 `@keyframes` 名
+  当成类名（基线里 Divider 的 rootClass 曾是 `klun-stroke-soft-200`），该字段的契约保护此前失效。
+- **测量基线重新采集**：2026-10-07 · 库 0.6.0 · commit `5d4c3d8`（原基线停留在 0.5.0）。
+  重测后控件边界在四条组合下统一（light/metronic 3.16:1 → **5.411:1**），
+  状态环补到四条组合；未测项 9 → 8（补测 Table 的 Provider 密度继承）。
+- `ConfigProvider` 的 `useOverlayScope` 系列此前漏导出，现补进 barrel。
+
+
 ## [0.6.0] — 2026-10-06
 
 KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs/design-standards/MIGRATION.md`。
@@ -28,6 +99,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
   `ChartLegend`/`DiffViewer` 在超长文本下折行或可滚动（此前溢出或被静默裁掉）。
 - **代码块横向滚动**：`CodeViewer` / `DiffViewer` 的长行可横向滚动查看，不再被裁掉。
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`CodeViewer` / `LogViewer` 的 `--dark` 变体在暗色主题下白底白字**（对比度 **1.0**，代码不可见）。
   根因：背景用了会随主题翻转的 `--klun-bg-strong-950`，而文字是写死的白色。
@@ -610,6 +718,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
   `ConfigProvider`, and the templates section covers all eight templates plus
   the `klun-ui/charts` subpath.
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **Developer scripts are cross-platform again.** `scripts/gen-barrel.mjs`
   and `scripts/jsx-to-tsx.mjs` resolved the repo root from a hardcoded
@@ -619,6 +764,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.23] — 2026-07-16
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **Dark theme — soft dividers were invisible.** In dark mode the token
   `--klun-stroke-soft-200` resolved to `--klun-800`, the **same value as the page
@@ -711,6 +893,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.18] — 2026-06-29
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`Popover` panel no longer gets clipped by scrolling/`overflow:hidden` ancestors.**
   Same treatment as the select family in 0.1.17: the panel now renders in a
@@ -725,6 +944,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.17] — 2026-06-28
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **Select dropdowns no longer get clipped by scrolling/`overflow:hidden` ancestors.**
   The custom select family (`Select`, `CompactSelect`, `CompactSelectForInput`,
@@ -791,6 +1047,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.9] — 2026-06-21
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`Popconfirm` bubble is no longer clipped by scroll containers.** The bubble
   rendered as an `absolute` child of the trigger, so when the trigger sat inside
@@ -802,6 +1095,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.8] — 2026-06-21
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **Metronic + dark mode: text/icons on strong surfaces are now readable.**
   The `metronic` skin mapped `--klun-bg-strong-950` to `grey-900` (which flips
@@ -816,6 +1146,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.7] — 2026-06-21
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`Popconfirm` content is always left-aligned.** The bubble rendered inline,
   so a Popconfirm placed inside a right-aligned container (e.g. a table action
@@ -824,6 +1191,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.6] — 2026-06-21
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`Modal` / `Drawer` mask is now clearly visible in both themes.** The
   backdrop uses a theme-independent scrim (`rgba(0,0,0,0.45)` + `blur(3px)`,
@@ -852,6 +1256,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.4] — 2026-06-21
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`Modal`** no longer draws the footer divider when there's no body (e.g.
   confirmation dialogs), so the actions sit cleanly under the heading instead of
@@ -859,6 +1300,43 @@ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs
 
 ## [0.1.3] — 2026-06-20
 
+- **Storybook 里的规格页**：`KDS/Size specs`（全局 Token / 按组件查阅 137 份规格 / 索引）。
+
+### Changed（续 3）
+- **皮肤不再改几何**（行为变更）：kk 原本在 `[data-mode="kk"]` 里顺带重定义整条控件高度与圆角，
+  导致 `size="medium"` 在 kk 下是 32px、默认皮肤下是 40px——`size` 跨皮肤失效。
+  现在几何只由显式轴决定：控件尺度走新增的 **`density="kk"`**，直角走 **`radius="square"`**。
+  **迁移**：`<ConfigProvider accent="kk">` → `<ConfigProvider accent="kk" density="kk" radius="square">`
+  可复现原观感；不加密度/圆角则使用标准尺度（推荐）。
+- **Textarea 档位圆角收敛**到控件档位 6/6/8/10（原 8/10/12/12），与同档 Input/Select 一致。
+
+### Added（续）
+- **测量基线重新采集流程脚本化**：`scripts/kds-capture-probe.mjs`（11 个故事/组合的探针）、
+  `scripts/kds-measure-baseline.mjs`（合并 + 重写出处）。基线更新为
+  **2026-10-07 / 0.6.0 / 5d4c3d8**；出处门禁升级为 MUST（库版本一变必须重采）。
+
+### Fixed（续 3）
+- **字段族一致性**（同档字段必须长得一样）：
+  · Cascader / SelectMenu / TimePicker / InputGroup / RichEditor 的 medium 档圆角 10px → **8px**；
+  · **CounterInput** 档位纠正（small/medium/large 由 32/36/40 改为 **36/40/48**，圆角 8/10/10 → 6/8/10）；
+    **CronEditor** 默认档 32/10 → **40/8**，并补齐 small/large；
+  · `InputGroup` 内嵌完整 `<Input>` 时不再出现"框中框"（组内控件透明、无圆角、无描边）；
+  · 日期/时间/范围选择器触发器新增 `.klun-input--trigger`：不再复用 readonly 弱底，
+    与同排 Input 底色一致（暗色实测 rgb(38,38,38) → rgb(23,23,23)）；
+  · TimePicker / InputGroup 的横向内边距改用字段 token（`--klun-field-px-*`）。
+- **表单里字段等宽**：`.klun-form-item__control > <字段族> { width: 100% }`（表单层统一，
+  工具条里的组件保持固有宽度）。
+
+### Fixed（续 2）
+- **144 处 `font-size` 字面量全部 token 化**（文本走字阶、代码走 `--klun-code-size`、
+  图标走图标阶梯）。其中 9 处 13px 文本收敛到 12px 辅助档，代码块 12px → 13px（KDS §1.3 目标）。
+- **Checkbox / Radio / Switch 迁到 KDS §1.5 目标**：可见 box / 圆点 **16/18/20**，
+  Switch 轨道 **28×16 / 32×18 / 40×22**（原 18/20/24、16/20/24、32×18/36×20/44×24，每档大一级）；
+  compact 同步下调一档。新增 `--klun-hit-area-min`(24px) / `--klun-hit-area-touch`(44px)，
+  **热区不随可见尺寸缩小**（实测仍为 24px）。
+- 图标阶梯补齐非控件档位（micro 12 / inline 14 / feature 22 / display 28 / hero 64 / hero-lg 72），
+  并把 15px→14、17px→18、26px→28 三个魔法数收敛到档位。
+
 ### Fixed
 - **`TimePicker`** dropdowns now flip above the trigger when there isn't enough
   room below the viewport (e.g. when the picker sits low inside a