klun-ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,50 @@ All notable changes to **klun-ui** are documented here. The format follows
5
5
  [Semantic Versioning](https://semver.org/) (pre-1.0: minor/patch bumps may carry
6
6
  small breaking changes).
7
7
 
8
+ ## [0.6.0] — 2026-10-06
9
+
10
+ KDS 设计标准升级。**含破坏性变更**——完整迁移指引见 `docs/design-standards/MIGRATION.md`。
11
+
12
+ ### Breaking
13
+ - **移除 `FormInstance.registerRules`** —— 请改用 `<FormItem rules={…} />`。
14
+ 依据:源码中已标 `@deprecated`,且**已登记消费者零使用**。
15
+ - **移除 `DrawerProps.side`** —— 请改用 `placement`(支持 `top`/`right`/`bottom`/`left`,比 `side` 更宽)。
16
+ - **覆盖层 `align` 默认值由物理改为逻辑**(`Popover`/`Dropdown`/`SelectMenu`/`DatePicker`/
17
+ `DateRangePicker`/`DateTimePicker`):默认 `"start"`。**LTR 行为不变**,RTL 下改为贴内联起始边(修复锚错边)。
18
+ 需要原有物理行为时显式传 `align="left"` / `align="right"`。
19
+
20
+ ### Added
21
+ - **按下态反馈**:Button / IconButton / CopyButton 新增 `translateY(1px)`。
22
+ - **RTL 逻辑属性**:RangeSlider 镜像、Tree 层级缩进、Notification 关闭按钮、Chip 内边距、
23
+ CodeViewer 浮动按钮、覆盖层对齐。
24
+ - **密度跟随**:`Result`/`EmptyState`/`Collapse`/`Accordion`/`Sidebar`/`Chip`/`Message`/`Banner`/
25
+ `Notification`/`Timeline`/`CodeViewer`/`DiffViewer`/`Kanban`/`RichEditor` 在 `density="compact"` 下
26
+ 跟随缩放(此前保持桌面留白)。
27
+ - **长文案健壮性**:`Alert`/`Banner`/`Notification`/`Message`/`Tabs`/`StepIndicator`/`Timeline`/
28
+ `ChartLegend`/`DiffViewer` 在超长文本下折行或可滚动(此前溢出或被静默裁掉)。
29
+ - **代码块横向滚动**:`CodeViewer` / `DiffViewer` 的长行可横向滚动查看,不再被裁掉。
30
+
31
+ ### Fixed
32
+ - **`CodeViewer` / `LogViewer` 的 `--dark` 变体在暗色主题下白底白字**(对比度 **1.0**,代码不可见)。
33
+ 根因:背景用了会随主题翻转的 `--klun-bg-strong-950`,而文字是写死的白色。
34
+ 改用主题恒定的 `--klun-static-static-black`(**浅色下同值,浅色观感不变**)。
35
+ - **焦点环**由「2px 白 + 2px 主色」收窄为单层 2px,且补上 `RichEditor` 编辑区缺失的焦点样式。
36
+ - **`prefers-reduced-motion`**:5 个文件 6 个动画补齐降级。
37
+ - 约 35 个组件的次要文字加深,达到对比度要求。
38
+ - 暗色皮肤覆写此前**未真正生效**,已修复。
39
+
40
+ ### Changed
41
+ - **控件尺寸**:默认档 32/36/40/48、紧凑档 28/32/36/40;圆角 6/6/8/10;正文 14/20。
42
+ - **`kk` 皮肤**控制高度由「全部 32px」改为**五档** 20/24/28/32/36(默认档仍 32px,常规观感不变)。
43
+
44
+ ### Known issues(**已知未修,待设计决策**)
45
+ - **按钮文字对比度**:12 种样式(3 变体 × 4 外观)里 **8 种**在多数主题组合下低于 4.5:1
46
+ (`neutral` 四种全部达标)。
47
+ - **Badge 强调色对比度**:`filled` 外观 **5/6 色相**不达标,`orange-filled`/`yellow-filled` **全组合不达标**。
48
+ 根因:`filled` 对所有色相统一用白字,而黄/橙是浅色相(对照 `lighter` 外观**已按色相**配深色文字)。
49
+ 修法需**加深强调色**或**按色相配文字色**,两者都改变品牌观感,故本版未改。
50
+ - 读屏实际朗读、真机触摸、forced-colors、200% 文字与 320px 重排**未验证**。
51
+
8
52
  ## [0.5.0] — 2026-09-29
9
53
 
10
54
  ### Added
package/README.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # klun-ui
2
2
 
3
+ ## Klun Design Standard
4
+
5
+ KDS `1.0.0-draft.1` is a proposed design, component, interaction and quality standard. It does not mean the current library already complies; adoption and implementation require the documented review and migration process.
6
+
7
+ The standard lives in the repository at `docs/design-standards/` (start with `README.md`, full text in `COMPLETE.md`, upgrade work packages in `UPGRADE-PLAN.md`). It is **not** included in the published npm tarball — `package.json` `files` ships only `dist`, `README.md`, `CHANGELOG.md` and `LICENSE`. Whether the KDS should be published (and how, given `docs/design-standards/references/` contains large HTML snapshots) is tracked as U23 in the upgrade plan.
8
+
3
9
  [![npm version](https://img.shields.io/npm/v/klun-ui)](https://www.npmjs.com/package/klun-ui)
4
10
  [![license](https://img.shields.io/npm/l/klun-ui)](./LICENSE)
5
11
  [![types included](https://img.shields.io/npm/types/klun-ui)](https://www.npmjs.com/package/klun-ui)