@w-run/wdesign-ui 0.0.0-stage → 1.1.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.
Files changed (214) hide show
  1. package/README.md +255 -2
  2. package/dist/index.d.ts +1013 -0
  3. package/dist/parts/WdAffix.js +159 -0
  4. package/dist/parts/WdAiMessage.js +277 -0
  5. package/dist/parts/WdAlert.js +92 -0
  6. package/dist/parts/WdAnchor.js +159 -0
  7. package/dist/parts/WdAudioPlayer.js +1024 -0
  8. package/dist/parts/WdAvatar.js +6 -0
  9. package/dist/parts/WdAvatarGroup.js +46 -0
  10. package/dist/parts/WdBacktop.js +120 -0
  11. package/dist/parts/WdBadge.js +61 -0
  12. package/dist/parts/WdBento.js +40 -0
  13. package/dist/parts/WdBentoItem.js +43 -0
  14. package/dist/parts/WdBottomSheet.js +263 -0
  15. package/dist/parts/WdBreadcrumb.js +64 -0
  16. package/dist/parts/WdButton.js +94 -0
  17. package/dist/parts/WdCalendar.js +11 -0
  18. package/dist/parts/WdCard.js +113 -0
  19. package/dist/parts/WdCarousel.js +365 -0
  20. package/dist/parts/WdCascader.js +386 -0
  21. package/dist/parts/WdCheckbox.js +81 -0
  22. package/dist/parts/WdCollapse.js +135 -0
  23. package/dist/parts/WdColorPicker.js +592 -0
  24. package/dist/parts/WdCommand.js +357 -0
  25. package/dist/parts/WdContainer.js +37 -0
  26. package/dist/parts/WdCountdown.js +163 -0
  27. package/dist/parts/WdDanmaku.js +6 -0
  28. package/dist/parts/WdDatePicker.js +169 -0
  29. package/dist/parts/WdDateTimePicker.js +162 -0
  30. package/dist/parts/WdDescriptions.js +146 -0
  31. package/dist/parts/WdDivider.js +64 -0
  32. package/dist/parts/WdDrawer.js +176 -0
  33. package/dist/parts/WdDropdown.js +140 -0
  34. package/dist/parts/WdEmpty.js +79 -0
  35. package/dist/parts/WdExplorer.js +336 -0
  36. package/dist/parts/WdFileList.js +177 -0
  37. package/dist/parts/WdForm.js +111 -0
  38. package/dist/parts/WdFormItem.js +156 -0
  39. package/dist/parts/WdGrid.js +40 -0
  40. package/dist/parts/WdGroup.js +68 -0
  41. package/dist/parts/WdImagePreview.js +274 -0
  42. package/dist/parts/WdInput.js +10 -0
  43. package/dist/parts/WdInputNumber.js +253 -0
  44. package/dist/parts/WdListItem.js +60 -0
  45. package/dist/parts/WdLoading.js +128 -0
  46. package/dist/parts/WdMarkdown.js +172 -0
  47. package/dist/parts/WdMarquee.js +80 -0
  48. package/dist/parts/WdMasonry.js +40 -0
  49. package/dist/parts/WdMediaCard.js +302 -0
  50. package/dist/parts/WdMentions.js +277 -0
  51. package/dist/parts/WdModal.js +149 -0
  52. package/dist/parts/WdNav.js +311 -0
  53. package/dist/parts/WdNotification.js +112 -0
  54. package/dist/parts/WdOtp.js +107 -0
  55. package/dist/parts/WdPagination.js +252 -0
  56. package/dist/parts/WdPopconfirm.js +214 -0
  57. package/dist/parts/WdPopover.js +203 -0
  58. package/dist/parts/WdPostItem.js +84 -0
  59. package/dist/parts/WdProgress.js +48 -0
  60. package/dist/parts/WdProgressRing.js +101 -0
  61. package/dist/parts/WdPullRefresh.js +167 -0
  62. package/dist/parts/WdQRCode.js +1909 -0
  63. package/dist/parts/WdRadioGroup.js +95 -0
  64. package/dist/parts/WdRate.js +128 -0
  65. package/dist/parts/WdResult.js +86 -0
  66. package/dist/parts/WdScrollbar.js +186 -0
  67. package/dist/parts/WdSegmented.js +11 -0
  68. package/dist/parts/WdSelect.js +465 -0
  69. package/dist/parts/WdSkeleton.js +69 -0
  70. package/dist/parts/WdSlider.js +100 -0
  71. package/dist/parts/WdSortableList.js +291 -0
  72. package/dist/parts/WdSpace.js +46 -0
  73. package/dist/parts/WdSparkline.js +148 -0
  74. package/dist/parts/WdSpinner.js +6 -0
  75. package/dist/parts/WdSplitter.js +183 -0
  76. package/dist/parts/WdStatBar.js +202 -0
  77. package/dist/parts/WdStatistic.js +131 -0
  78. package/dist/parts/WdSteps.js +110 -0
  79. package/dist/parts/WdSwitch.js +63 -0
  80. package/dist/parts/WdTabBar.js +84 -0
  81. package/dist/parts/WdTable.js +589 -0
  82. package/dist/parts/WdTabs.js +219 -0
  83. package/dist/parts/WdTag.js +6 -0
  84. package/dist/parts/WdTagInput.js +181 -0
  85. package/dist/parts/WdTimePicker.js +12 -0
  86. package/dist/parts/WdTimeline.js +145 -0
  87. package/dist/parts/WdTooltip.js +108 -0
  88. package/dist/parts/WdTour.js +264 -0
  89. package/dist/parts/WdTransfer.js +446 -0
  90. package/dist/parts/WdTree.js +322 -0
  91. package/dist/parts/WdUpload.js +309 -0
  92. package/dist/parts/WdVideoPlayer.js +1006 -0
  93. package/dist/parts/WdVirtualList.js +169 -0
  94. package/dist/parts/WdWatermark.js +150 -0
  95. package/dist/parts/chunk-3LVE72ZK.js +361 -0
  96. package/dist/parts/chunk-5HYOQ52I.js +101 -0
  97. package/dist/parts/chunk-7M3MUL3B.js +275 -0
  98. package/dist/parts/chunk-AOTJ63HN.js +15 -0
  99. package/dist/parts/chunk-AXEF2U2A.js +41 -0
  100. package/dist/parts/chunk-CY3QOSFP.js +645 -0
  101. package/dist/parts/chunk-G7NN4A6J.js +40 -0
  102. package/dist/parts/chunk-HAKYCUAR.js +9 -0
  103. package/dist/parts/chunk-JDE4AHBR.js +160 -0
  104. package/dist/parts/chunk-LT3NTWIT.js +117 -0
  105. package/dist/parts/chunk-OGHYFT7B.js +387 -0
  106. package/dist/parts/chunk-Q34U2HES.js +261 -0
  107. package/dist/parts/chunk-RLSVPJHM.js +10 -0
  108. package/dist/parts/chunk-U2CDKD2T.js +30 -0
  109. package/dist/parts/chunk-UYUNYHZD.js +40 -0
  110. package/dist/parts/chunk-VUJL2HGD.js +23 -0
  111. package/dist/parts/chunk-WCFG5KNT.js +51 -0
  112. package/dist/parts/chunk-WDDAALPI.js +42 -0
  113. package/dist/parts/chunk-WFXLDBP2.js +149 -0
  114. package/dist/style/affix.css +566 -0
  115. package/dist/style/ai-msg.css +746 -0
  116. package/dist/style/alert.css +636 -0
  117. package/dist/style/anchor.css +630 -0
  118. package/dist/style/audio.css +1954 -0
  119. package/dist/style/avatar.css +651 -0
  120. package/dist/style/backtop.css +625 -0
  121. package/dist/style/badge.css +632 -0
  122. package/dist/style/bento.css +763 -0
  123. package/dist/style/bottom-sheet.css +776 -0
  124. package/dist/style/breadcrumb.css +629 -0
  125. package/dist/style/button.css +829 -0
  126. package/dist/style/calendar.css +1512 -0
  127. package/dist/style/card.css +748 -0
  128. package/dist/style/carousel.css +670 -0
  129. package/dist/style/cascader.css +862 -0
  130. package/dist/style/checkbox.css +706 -0
  131. package/dist/style/chevron.css +575 -0
  132. package/dist/style/collapse.css +648 -0
  133. package/dist/style/colorpicker.css +876 -0
  134. package/dist/style/command.css +760 -0
  135. package/dist/style/container.css +550 -0
  136. package/dist/style/countdown.css +722 -0
  137. package/dist/style/danmaku.css +644 -0
  138. package/dist/style/datepicker.css +683 -0
  139. package/dist/style/datetime-picker.css +714 -0
  140. package/dist/style/descriptions.css +712 -0
  141. package/dist/style/divider.css +604 -0
  142. package/dist/style/dot.css +585 -0
  143. package/dist/style/drawer.css +743 -0
  144. package/dist/style/dropdown.css +645 -0
  145. package/dist/style/empty.css +657 -0
  146. package/dist/style/explorer.css +944 -0
  147. package/dist/style/file-list.css +664 -0
  148. package/dist/style/flip.css +600 -0
  149. package/dist/style/form.css +638 -0
  150. package/dist/style/grid.css +618 -0
  151. package/dist/style/group.css +1022 -0
  152. package/dist/style/icon-btn.css +641 -0
  153. package/dist/style/image-preview.css +725 -0
  154. package/dist/style/input-number.css +680 -0
  155. package/dist/style/input.css +682 -0
  156. package/dist/style/list.css +630 -0
  157. package/dist/style/loading.css +667 -0
  158. package/dist/style/markdown.css +884 -0
  159. package/dist/style/marquee.css +678 -0
  160. package/dist/style/masonry.css +614 -0
  161. package/dist/style/media-card.css +1229 -0
  162. package/dist/style/mentions.css +690 -0
  163. package/dist/style/modal.css +775 -0
  164. package/dist/style/nav.css +1046 -0
  165. package/dist/style/notification.css +601 -0
  166. package/dist/style/otp.css +699 -0
  167. package/dist/style/pagination.css +680 -0
  168. package/dist/style/popconfirm.css +645 -0
  169. package/dist/style/popover.css +740 -0
  170. package/dist/style/post-item.css +676 -0
  171. package/dist/style/progress-ring.css +640 -0
  172. package/dist/style/progress.css +576 -0
  173. package/dist/style/pull-refresh.css +637 -0
  174. package/dist/style/qrcode.css +613 -0
  175. package/dist/style/radio.css +705 -0
  176. package/dist/style/rate.css +637 -0
  177. package/dist/style/result.css +597 -0
  178. package/dist/style/scroll-reveal.css +613 -0
  179. package/dist/style/scrollbar.css +644 -0
  180. package/dist/style/segmented-picker.css +679 -0
  181. package/dist/style/segmented.css +894 -0
  182. package/dist/style/select.css +937 -0
  183. package/dist/style/skeleton.css +590 -0
  184. package/dist/style/slider.css +642 -0
  185. package/dist/style/sortable.css +714 -0
  186. package/dist/style/space.css +568 -0
  187. package/dist/style/sparkline.css +606 -0
  188. package/dist/style/spinner.css +586 -0
  189. package/dist/style/splitter.css +711 -0
  190. package/dist/style/stat-bar.css +767 -0
  191. package/dist/style/statistic.css +589 -0
  192. package/dist/style/steps.css +724 -0
  193. package/dist/style/switch.css +676 -0
  194. package/dist/style/tab-bar.css +647 -0
  195. package/dist/style/table.css +1229 -0
  196. package/dist/style/tabs.css +756 -0
  197. package/dist/style/tag-input.css +710 -0
  198. package/dist/style/tag.css +682 -0
  199. package/dist/style/time-picker.css +749 -0
  200. package/dist/style/timeline.css +1082 -0
  201. package/dist/style/toast.css +598 -0
  202. package/dist/style/tooltip.css +604 -0
  203. package/dist/style/tour.css +683 -0
  204. package/dist/style/transfer.css +858 -0
  205. package/dist/style/tree.css +786 -0
  206. package/dist/style/typography.css +947 -0
  207. package/dist/style/upload.css +758 -0
  208. package/dist/style/vlist.css +591 -0
  209. package/dist/style/vplayer.css +1588 -0
  210. package/dist/style/watermark.css +570 -0
  211. package/dist/wdesign-ui.css +21093 -0
  212. package/dist/wdesign-ui.esm.js +20265 -0
  213. package/package.json +134 -4
  214. package/tokens.json +385 -0
@@ -0,0 +1,1022 @@
1
+ @charset "UTF-8";
2
+ /*
3
+ * 三级说明文字(次要说明、占位、图标)。
4
+ *
5
+ * 2026-11 由 #7F8895 压深到 #6A7380:
6
+ * 白底 #7F8895 只有 3.59:1,不达 WCAG AA 正文所需的 4.5:1;
7
+ * 而 ink-3 大量用在「正常可读」的说明文字上(时间戳、统计标签、cursor 等),
8
+ * 不是纯装饰。压深后白底 4.80:1、field 底 4.36:1,两处都过 4.5 或贴线。
9
+ * 注意:**禁用态是 WCAG 明确豁免的**,不需要为禁用文字单独调色。
10
+ */
11
+ /*
12
+ * 浅色墨阶的**分工**(第 56 轮实测后明确):
13
+ *
14
+ * ink-2 说明文字 三底最低 4.65:1 ← 文字下限就在这
15
+ * ink-3 三级说明/占位 三底最低 4.65:1 ← 文字可以再往下用到的最后一档
16
+ * ink-4 **只做装饰** 描边、分隔、滚动条、disabled —— **不承载文字**
17
+ * ink-5 更弱的装饰 几乎不可见的分割线
18
+ *
19
+ * 为什么 ink-4 不硬拉到达标:三档灰要在"都 ≥4.5"的前提下还保持可见层级,
20
+ * 空间根本不够(ink-2 已经是 4.65,再往下压就挤在一起了)。
21
+ * 与其让三档糊成一片,不如**明确 ink-4 不是文字色**。
22
+ *
23
+ * 这条规则已写进 docs/COMPONENT-SELECTION.md 的可访问性一节。
24
+ */
25
+ /*
26
+ * 头像淡彩色板(6 组)。
27
+ *
28
+ * 全灰头像等于没有信息:列表里 10 个人长得一模一样,也不像"人"。
29
+ * 用低饱和淡彩底 + 同色相深字,按名字 hash 稳定分配 —— 同一个人永远同一个颜色。
30
+ * 彩度压得很低(L≈95%),保证不抢内容、深浅主题都不刺眼。
31
+ */
32
+ /* 锚点面(--wd-dark)在深色主题下翻转为浅色 → 其上配套色需同步翻转 */
33
+ /*
34
+ * 深色墨阶重排(第 56 轮实测)。
35
+ *
36
+ * 原值 ink-2 #9C9CA6 / ink-3 #8C8C96 / ink-4 #5A5A64 —— 后两档在 field #2A2A2E 上
37
+ * 分别只有 4.29:1 和 2.10:1,而它们都会被当**文字**用(占位符、时间戳、序号)。
38
+ *
39
+ * 重排后保证三件事:
40
+ * 1. 亮度严格递减:ink-2 > ink-3 > ink-4(层级不能反)
41
+ * 2. 每一档在最暗的 field 上也 ≥4.5:1
42
+ * 3. 相邻档仍有可见差(约 1.15~1.3:1 的跨度),不会糊成一片
43
+ */
44
+ /*
45
+ * 深色下 ink-4 会被当成**文字**用(时间戳、次级说明),不是纯装饰。
46
+ * 原值 #5A5A64 在 bg #121214 上只有 2.75:1、在 card #1C1C1E 上 2.50:1 ——
47
+ * 远低于 4.5:1。这轮实测五个场景页,深色下几乎每个页面都有这一档不达标。
48
+ *
49
+ * 取 #9494A0:bg 6.24:1 / card 5.67:1 / field 4.77:1,三种底色全部通过。
50
+ * 再亮就接近 ink-3(#8C8C96) 了,层级会糊;这个值刚好把"弱但可读"钉住。
51
+ */
52
+ /*
53
+ * 毛玻璃面(压在图片 / 视频上的胶囊、标签)。
54
+ * 半透明深底 + backdrop-blur + 一道细亮边,白字就能压在任何亮度的照片上。
55
+ * 不支持 backdrop-filter 的浏览器靠 @supports 兜底成更实的底色。
56
+ */
57
+ /*
58
+ * 细边(hairline)。
59
+ * 深色下卡面(#1C1C1E)与页底(#131316)只差 3% 亮度,仅靠阴影几乎看不出边界;
60
+ * 一道 8% 白边比加重阴影更干净 —— 阴影会让整页发灰。
61
+ * 浅色主题保持透明,不改变现有观感。
62
+ */
63
+ /*
64
+ * 固定深色画布:媒体画面底(视频 / 图片 / 弹幕层)。
65
+ *
66
+ * ⚠️ 为什么必须单独一个令牌:
67
+ * 本系统所有"面"令牌(ink / dark / selected-bg …)都会随主题翻转。
68
+ * 但媒体画布上压的是**视频画面本身**,它的深浅与主题无关 ——
69
+ * 浅色主题下是深色画面,深色主题下**仍然是深色画面**。
70
+ * 之前弹幕页拿 --wd-dark 当画布底,深色主题下它翻成了 #F0F0F0,
71
+ * 白字弹幕直接消失(实测对比度 1.14:1)。这个令牌两个主题都恒为深色。
72
+ */
73
+ /*
74
+ * danger 用**深红**,和主题红(#D62839)分开。
75
+ * 主题红是"品牌/主要行动/话题";失败、已封禁这类真正的危险态要更沉,
76
+ * 否则页面上"主按钮"和"错误标签"是一个颜色,读起来就乱了。
77
+ */
78
+ /*
79
+ * 聚焦环用**品牌红**(红在本库是恒定的 #D62839,不随主题翻转)。
80
+ *
81
+ * 关键不是颜色而是"形状 + 呼吸":
82
+ * · 必须**紧贴胶囊边缘**(box-shadow 走 border-box,圆角自动跟随),
83
+ * 中间不能留白,否则看起来像"外面套了个矩形框 + 里面还有个胶囊"
84
+ * · 聚焦时缓慢呼吸(`wd-focus-breathe`),告诉用户"焦点在这里"
85
+ * 之前 8% 的透明度太虚,看起来像一层粉雾;提到 16~22% 才是一圈清楚的环。
86
+ */
87
+ /*
88
+ * 为什么必须收口:之前全站有 56 处裸写 line-height,用了 15 种值
89
+ * (1.7 / 1.65 / 1.6 / 1.55 / 1.5 / 1.4 / 1.35 / 1.3 / 1.15 / 1.2 / 1.75 / 1.68…)。
90
+ * 每一处单看都"差不多",但正文、说明、标签混在一起时,
91
+ * 行与行的呼吸节奏全是碎的 —— 这是"看起来不够精致"的结构性来源之一。
92
+ *
93
+ * 只保留四档,按**用途**分而不是按数值分:
94
+ * tight → 大标题 / 展示字(字越大,行高越要收,否则行间空洞)
95
+ * snug → 区块标题 / 卡片标题 / 按钮文字
96
+ * normal → 正文(C 端阅读舒适区 1.5~1.7)
97
+ * loose → 小字多行说明(字号越小,越需要大行高才不糊成一片)
98
+ */
99
+ /**
100
+ * display 专用行高。
101
+ *
102
+ * 40px 以上的字,1.15 仍然太松 —— 实测落地页 64px 标题在 1.15 下
103
+ * 两行之间空得像断成两段话。大字的行间应该由字形自身(字面、字重)
104
+ * 撑开,而不是靠行高,所以单独给一档 1.06。
105
+ *
106
+ * 只给 display 用;heading 及以下继续用 tight。
107
+ */
108
+ /**
109
+ * 页面内容最大宽度。
110
+ *
111
+ * 之前三个场景页各写一套(1320 / 1240 / 1100),同一个库里
112
+ * 三种页宽并存 —— 复制到新页面时根本不知道该抄哪个。
113
+ *
114
+ * 按**信息密度**分三档,而不是按像素分:
115
+ * wide → 面板 / 表格 / 看板:要横向排得下多列
116
+ * base → 常规内容页 / 工具页:一屏两栏刚好
117
+ * narrow → 落地页 / 长文:一行不要把眼睛拉太远
118
+ */
119
+ /**
120
+ * 正文最佳行长(measure)。
121
+ *
122
+ * 用 em 而不是 ch:ch 是「0」的宽度,中文字宽约等于 1em。
123
+ * 实测本库字体栈下 1ch = 0.61em —— 用 ch 表达中文行长会算错约 40%。
124
+ * 27em ≈ 27 个汉字/行,落在中文 20–35 字的舒适区间
125
+ * (实测落地页 27em 时排 28 字/行、备忘台 28em 时排 27 字/行)。
126
+ */
127
+ /**
128
+ * 统计数字专用字号。
129
+ *
130
+ * 为什么不复用正文的 6 档字阶:那是**文本层级**(xs/caption/body/lg/
131
+ * heading/display),表达「这段文字有多重要」。
132
+ * 统计数字表达的是「这个值有多大」,两者不是一个维度 ——
133
+ * 硬套 display(44-64) 会把统计条撑破,套 heading(22) 又不够醒目。
134
+ *
135
+ * 所以单独一组,只给数字用。这也是这轮横向复查发现的:
136
+ * WdStatBar 里散落着 20/26/34/22 四个裸值,谁也不认识谁。
137
+ */
138
+ /**
139
+ * 时长与缓动。
140
+ *
141
+ * 五个场景页里曾经散落着 160/180/200/240/260/420ms 六种时长、
142
+ * 三种缓动写法 —— 每页单看都对,五页并排就显得不是一套东西。
143
+ *
144
+ * 只保留三档,按**信息量**分:
145
+ * fast → 颜色 / 透明度这类「即时反馈」(悬停、聚焦)
146
+ * base → 位移 / 尺寸这类「有过程的变化」(展开、滑块)
147
+ * slow → 需要人看清过程的大变化(进度环填充、大面板展开)
148
+ */
149
+ /*
150
+ * ⚠️ 第 22 轮清理:这里原本还定义了 fast(160ms) 和 slow(420ms),
151
+ * 但它们**从来没有生效过** —— SCSS 的 !default 是「先定义者胜」,
152
+ * 而本文件第 97 行起已经定义过 fast(.12s) 和 slow(.24s)。
153
+ *
154
+ * 危害不是「值不对」(用的确实是前面那套),而是:
155
+ * 读代码的人看到这里会以为 fast 是 160ms,改完发现毫无变化。
156
+ * 两套时长体系并存,谁生效全靠「哪段在前面」,这对维护者极不友好。
157
+ *
158
+ * 只保留 base(220ms) —— 它是唯一只定义一次、真正生效的那个。
159
+ * 但注意:**没有任何组件在用 --wd-dur-base**(0 处引用),
160
+ * 它是给消费方留的扩展档,不是内部在用的。
161
+ */
162
+ /*
163
+ * ⚠️ 第 22 轮清理:这里原本又定义了一次 $wd-ease,
164
+ * 但它是**死的** —— 本文件第 99 行已经定义过(cubic-bezier(.25,.8,.35,1)),
165
+ * !default 先定义者胜,这一份从未被读取。
166
+ *
167
+ * 更要命的是这段注释写着「动效统一用它」,
168
+ * 照着改的人会以为这里才是标准值,改完毫无变化。
169
+ *
170
+ * 实际生效的缓动族在 99-107 行:ease / ease-spring / ease-out /
171
+ * ease-spring-soft / ease-smooth / ease-sharp。
172
+ */
173
+ /**
174
+ * 刘海 / 灵动岛 / Home 指示条。
175
+ *
176
+ * 之前全库搜不到一个 safe-area —— 桌面预览看不出来,
177
+ * 但在真机上:底部标签栏会被 Home 指示条压住,
178
+ * 全屏状态下顶部内容会钻进刘海。
179
+ *
180
+ * 用 env() 取值,在不支持的浏览器和桌面下自动回落 0。
181
+ * 注意 env() 不能写在 SCSS 变量里做算术,所以这里直接给完整表达式。
182
+ */
183
+ /*
184
+ * 左右安全区 —— **只有横屏才会用到**。
185
+ *
186
+ * 竖屏时刘海在顶部、Home 指示条在底部,左右为 0;
187
+ * 一旦横屏(看视频、玩游戏、表格横向滚动),刘海跑到左边或右边,
188
+ * 贴近边缘的内容会被吃掉一块。此时 top/bottom 归 0,left/right 才有值。
189
+ *
190
+ * 所以四个方向都要有,不能只做上下 —— 只做上下等于默认「永远不会横屏」。
191
+ */
192
+ /*
193
+ * ⚠️ 2026-11 字阶收敛:ui 由 15 → 16。
194
+ * 15 夹在 14(caption) 和 16(body) 之间,比值只有 1.07 —— 三档挤成一团,
195
+ * 实际页面上"这是正文还是控件文字"根本分不出来。
196
+ * 合并进 16 后,一页减少一档,层级反而更清楚;文字也略大,符合 C 端阅读偏好。
197
+ */
198
+ /*
199
+ * ⚠️ 已废弃(第 61 轮):数值与 $wd-fs-sm / $wd-fs-ui / $wd-fs-lg 完全相同。
200
+ *
201
+ * 为什么留着:它们是 !default,外部项目可能覆盖过;直接删会造成
202
+ * 「升级后字号突然变了」这种最难查的回归。所以保留定义、停止新增使用。
203
+ *
204
+ * 为什么当初成了问题:按钮一直读这套,别的 67 个样式文件读 --wd-fs-*。
205
+ * 结果改 --wd-fs-* 时按钮不跟着变 —— 同一个意思两个名字,改一处另一处不动。
206
+ * 现在按钮已统一到 --wd-fs-*,全库零消费。新代码请用 --wd-fs-*。
207
+ * 由 tools/check-font-size-alias.py 守着,禁止回潮。
208
+ */
209
+ /*
210
+ * 字重阶梯(可变字重字体,Mona Sans 支持 200~900 连续取值)。
211
+ *
212
+ * 为什么不用 400/500/600/700 这套整数档:
213
+ * toC 界面的层级感靠"字重的细微差"堆出来,400→700 之间只有三档,
214
+ * 标题和正文的对比只能靠字号硬拉,容易显得"标题很粗、正文很虚"。
215
+ * 这里给 450 / 560 / 650 / 780 四个主力档,正好卡在视觉可分、又不跳的区间。
216
+ */
217
+ /*
218
+ * 依据两家参考站实测重定:
219
+ * 鸿蒙官网(中文) 大标题 48/400、次级 24/400、正文 16/400/行高 1.5 —— 几乎全 400,
220
+ * 层级全靠字号 + 字距 + 颜色
221
+ * 安卓 / Material 正文 400、按钮与标签 500、强调 700
222
+ * 共同点:**字重克制、靠字号拉层级**。之前那套 450/560/650/780/840 整体偏粗,
223
+ * 中文尤其容易"糊成一块黑"。
224
+ * 所以整体降一档,只给首屏留一个 780:
225
+ */
226
+ /**
227
+ * 首屏大标题专用。
228
+ *
229
+ * ⚠️ 当前值与 bold **完全相同(700)** —— 它是**语义别名**,不是独立档位。
230
+ * 原值 780,2026-11 中文尺度校准发现中文在 780 下"糊成一块黑",与 bold 合并。
231
+ *
232
+ * 保留这个名字的理由:调用方写 --wd-fw-black 表达的是"这是首屏大标题",
233
+ * 而不是"我要 700 这个数值"。以后若单独调整首屏字重,只需改这里一处。
234
+ *
235
+ * 与字号里的 caption / label / sm(都是 14px)是同一套做法:
236
+ * **同名同值是刻意的,成对不同值才是事故。**
237
+ */
238
+ /*
239
+ * 标题阶梯:与正文拉开明确倍数。
240
+ *
241
+ * ⚠️ 这里不再罗列具体数值 —— 以前写成
242
+ * display 40~56 / title 28 / heading 18 / body 14.5 / label 12.5 / xs 11.5
243
+ * 结果 B-15 那轮把整条阶梯放大后,注释全对不上(实际已是 44~64 / 32 / 22 / 16 / 13 / 12),
244
+ * 而注释没人会去校验,就一直错着。
245
+ * 数值以紧随其后的 $wd-fs-* 定义为准,改的时候只改那里。
246
+ * 之前页面标题 30~40、卡片标题 15,跟正文 13.5 只差 1.1 倍,整页没有主次。
247
+ *
248
+ * ⚠️ 2026-10-24 修复:这组值此前在文件上方被**重复定义过一次**,
249
+ * 而 SCSS 变量的 `!default` 是"先定义者胜"—— 上面那份 56px / 15.5px
250
+ * 一直生效,下面的 clamp / 14.5px 从未被读取过。
251
+ * 后果:页面标题写死 56px(窄屏溢出)、正文比设计稿大 1px。
252
+ * 这属于 AGENTS.md 明令禁止的"静默失效",由 check-tokens 巡检发现。
253
+ */
254
+ /*
255
+ * ⚠️ 当前**零引用**(组件与 demo 都没用),保留是为了外部使用者不被打断。
256
+ * 按字阶比例算,32 与 heading 22 的比值是 1.45,跳得过大 ——
257
+ * 真要再加一档区块标题,建议用 26~28(对 heading 约 1.2~1.27),
258
+ * 而不是直接启用这个 32。要清理的话先确认没有外部项目依赖。
259
+ */
260
+ /*
261
+ * ⚠️ 2026-11 字阶收敛:label 由 13 → 14,与 caption 合并。
262
+ * 13 和 14 差 1.077,肉眼分不出主次,但会让整页多出一档字号。
263
+ * 两档语义本来就重叠(都是"次级说明"),合并成 14 更清楚,小字也更易读。
264
+ */
265
+ /*
266
+ * 极小档 —— 徽标与角标里的字。
267
+ *
268
+ * 为什么单独开两档而不是继续往下细分:角标只有 16~19px 高,
269
+ * 字号必须比正文小两档以上才不会撑破胶囊;但也不能无限细分,
270
+ * 档位一多,"哪个是哪个"就没人记得住,最后又是一堆裸值。
271
+ * 两档收口:micro(10.5,徽标)+ nano(9.5,超小角标 / 剧集角标)。
272
+ */
273
+ /*
274
+ * ⚠️ 2026-11 字阶收敛:micro(11) 与 nano(10) 都并入 12(与 xs 同值)。
275
+ *
276
+ * 原来 10 / 11 / 12 三档相邻比值只有 1.100 / 1.091 —— 在超小字号区
277
+ * 差 1px 肉眼根本分不出,却让一页白白多出两档。
278
+ *
279
+ * 为什么往**上**并而不是往下:
280
+ * 10px 在移动端已经属于"需要凑近看"的尺寸,与 C 端阅读舒适的方向相反。
281
+ * 合并到 12 既减少档位,又让角标更清楚。
282
+ *
283
+ * 实测约束:badge 容器是 22px 高、文字 line-height:1 且已占满 22px,
284
+ * 12px 仍能容纳(12 < 22),但**不能再往上**了。
285
+ * 若以后要放大角标文字,必须同时调 .wd-badge 的 height,否则溢出。
286
+ */
287
+ /*
288
+ * 选中态分两档 —— 用途不同,不能共用一个值:
289
+ *
290
+ * · 强选中(selected):侧栏项、分段控件、列表项、树节点。
291
+ * 用**反相实心**(浅色主题=近黑底白字,深色主题=近白底黑字)。
292
+ * 这是全站唯一的"当前位置"标记,必须一眼看到;浅灰底在深色主题下
293
+ * 会和 hover 糊成一片(用户原话:「暗色模式很多选中态是灰白色很差」)。
294
+ * · 弱选中(selected-row):表格行、日历区间。整行大面积上色,
295
+ * 必须克制,比 hover 深一档即可,不能刷成黑底。
296
+ */
297
+ /*
298
+ * 层叠阶梯 —— 跨组件的浮层顺序**只能**由这一组决定。
299
+ *
300
+ * 之前 57 处 z-index 全是裸数字(50/1000/1200/1300/9999 混用),
301
+ * 最直接的后果是 **Toast 写 1200、Modal 写 1300**:对话框一开,
302
+ * 提示就被压在下面 —— 用户看不到"保存成功",只看到对话框。
303
+ * 层级不是装饰,是可用性,所以给它一组带语义的令牌,每档留 100 的插入余量。
304
+ */
305
+ /*
306
+ * 控件轮廓(勾选框、单选、开关关闭态、表格勾选圈)。
307
+ *
308
+ * --wd-field 是最浅的一档填充(白底上≈1.1:1),拿它画控件边界等于没画:
309
+ * 未勾选的圆圈在截图里几乎看不见,开关的"关"看起来像禁用。
310
+ * WCAG 对非文本 UI 组件要求 3:1,这里正好落在 3.4:1(白底)——
311
+ * 够清楚,又不至于像 --wd-ink-2 那样把每个小圆点都变成"重色块"。
312
+ */
313
+ /*
314
+ * 二次确认要**高于它所在的那个对话框** —— 表格行里的 Popconfirm
315
+ * 放进 Dialog 之后,1100 会被 1300 的遮罩连同对话框一起盖住,点了像没反应。
316
+ */
317
+ :root {
318
+ --wd-red: #D62839;
319
+ --wd-red-hover: #BC2332;
320
+ --wd-red-active: #A21E2B;
321
+ --wd-red-soft: #E05B68;
322
+ --wd-red-text: #BC2332;
323
+ --wd-tint-1: #FDF2F3;
324
+ --wd-tint-2: #FBEAEB;
325
+ --wd-tint-3: #F8DDDF;
326
+ --wd-tint-4: #F3BEC4;
327
+ --wd-ink: #191B1F;
328
+ --wd-ink-2: #636A73;
329
+ --wd-ink-3: #616A77;
330
+ --wd-ink-4: #CDD2D7;
331
+ --wd-ink-5: #E3E6EA;
332
+ --wd-bg: #F3F4F7;
333
+ --wd-card: #FFFFFF;
334
+ --wd-dark: #1C1C1C;
335
+ --wd-dark-2: #2F2F2F;
336
+ --wd-dark-text: #FFFFFF;
337
+ /* 锚点面令牌族:仅用于「深色锚点面」之上的内容,会随锚点面一起翻转。
338
+ 固定深色面(代码块、图片浮层)继续用 --wd-on-dark* 系列。 */
339
+ --wd-dark-text-2: rgba(255, 255, 255, 0.62);
340
+ --wd-dark-track: rgba(255, 255, 255, 0.14);
341
+ --wd-red-on-dark: #E05B68;
342
+ --wd-dark-hover: #2F2F2F;
343
+ --wd-dark-active: #3A3A3A;
344
+ --wd-success: #2FA57C;
345
+ --wd-warning: #E8A33D;
346
+ --wd-success-soft: #E8F6F0;
347
+ --wd-warning-soft: #FCF4E8;
348
+ --wd-success-ink: #247D5E;
349
+ --wd-warning-ink: #9C6412;
350
+ --wd-field: #E9EDF1;
351
+ --wd-dur: 0.18s;
352
+ --wd-dur-slow: 0.24s;
353
+ --wd-dur-fast: 0.12s;
354
+ --wd-dur-theme: 0.3s;
355
+ /* 浮层(popover)动效:比 dur-fast 长一档,位移也明显——
356
+ 0.12s/4px 在真机上几乎无法感知(曾因此被报「弹出层毫无动效」) */
357
+ --wd-dur-pop: .2s;
358
+ --wd-dur-pop-out: .14s;
359
+ --wd-dur-reveal: 0.45s;
360
+ --wd-ease-smooth: cubic-bezier(0.4, 0, 0.2, 1);
361
+ --wd-ease-sharp: cubic-bezier(0.6, 0, 0.8, 0.2);
362
+ --wd-ease-spring-soft: cubic-bezier(0.34, 1.3, 0.64, 1);
363
+ --wd-ease: cubic-bezier(0.25, 0.8, 0.35, 1);
364
+ --wd-ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
365
+ --wd-ease-out: cubic-bezier(0.16, 1, 0.3, 1);
366
+ /* 错峰入场(.wd-stagger)的两个可调参数 —— 见 _animations.scss */
367
+ --wd-stagger-gap: 55ms;
368
+ --wd-stagger-rise: 8px;
369
+ --wd-mask: rgba(28, 28, 28, 0.42);
370
+ --wd-toast-bg: rgba(255, 255, 255, 0.78);
371
+ --wd-field-hover: #E3E7EC;
372
+ --wd-dark-3: #3A3A3A;
373
+ --wd-ring-soft: rgba(25, 27, 31, 0.12);
374
+ --wd-underline: rgba(25, 27, 31, 0.4);
375
+ --wd-shadow-sm: 0 4px 12px rgba(25, 27, 31, 0.06);
376
+ --wd-shadow-pop: 0 12px 28px rgba(25, 27, 31, 0.14);
377
+ --wd-shadow-lg: 0 24px 60px rgba(25, 27, 31, 0.2);
378
+ --wd-shadow-knob: 0 2px 8px rgba(25, 27, 31, 0.22);
379
+ --wd-shadow-accent: 0 8px 20px rgba(214, 40, 57, 0.28);
380
+ /* 媒体画布:视频/图片/弹幕的画面底。**不随主题翻转**,两主题都是深色 */
381
+ --wd-canvas: #191B1F;
382
+ --wd-on-dark: rgba(255, 255, 255, 0.62);
383
+ --wd-on-dark-2: rgba(255, 255, 255, 0.8);
384
+ --wd-on-dark-3: rgba(255, 255, 255, 0.14);
385
+ --wd-on-dark-text: #EDEFF2;
386
+ --wd-mark-bg: rgba(214, 40, 57, 0.14);
387
+ --wd-link-underline: rgba(214, 40, 57, 0.35);
388
+ --wd-hairline: transparent;
389
+ --wd-control-line: #848C96;
390
+ --wd-z-sticky: 900;
391
+ --wd-z-float: 1000;
392
+ --wd-z-popover: 1200;
393
+ --wd-z-modal: 1300;
394
+ --wd-z-confirm: 1350;
395
+ --wd-z-toast: 1400;
396
+ --wd-z-drag: 1500;
397
+ --wd-glass-bg: rgba(20, 20, 22, 0.42);
398
+ --wd-glass-border: rgba(255, 255, 255, 0.18);
399
+ --wd-glass-blur: 12px;
400
+ --wd-danger: #A3162A;
401
+ --wd-focus-ring-faint: rgba(214, 40, 57, 0.55);
402
+ --wd-focus-ring: rgba(214, 40, 57, 0.78);
403
+ --wd-focus-ring-soft: rgb(214, 40, 57);
404
+ --wd-focus-ring-gap: #ffffff;
405
+ --wd-radius-xs: 8px;
406
+ --wd-radius-sm: 12px;
407
+ --wd-radius-md: 16px;
408
+ --wd-radius-lg: 24px;
409
+ --wd-radius-xl: 32px;
410
+ --wd-radius-pill: 999px;
411
+ --wd-shadow: 0 2px 10px rgba(25, 27, 31, 0.04);
412
+ --wd-shadow-hover: 0 10px 26px rgba(25, 27, 31, 0.07);
413
+ --wd-font-family: Mona Sans, Source Han Sans SC, PingFang SC, -apple-system, BlinkMacSystemFont, Inter, sans-serif;
414
+ --wd-font-mono: Monaspace Neon, Source Han Sans Mono-ish, ui-monospace, SF Mono, Menlo, Consolas, monospace;
415
+ /* 滚动揭示的错峰延时:由消费方按元素逐个覆盖(--wd-reveal-delay: .1s) */
416
+ --wd-reveal-delay: 0s;
417
+ --wd-img-filter: none;
418
+ --wd-img-filter-invert: invert(1) hue-rotate(180deg);
419
+ --wd-logo-filter: none;
420
+ --wd-logo-opacity: 1;
421
+ --wd-fs-lg: 18px;
422
+ --wd-fs-ui-lg: 16px;
423
+ --wd-fs-ui: 16px;
424
+ --wd-fs-caption: 14px;
425
+ --wd-fs-sm: 14px;
426
+ --wd-size-sm: 36px;
427
+ --wd-size-md: 46px;
428
+ --wd-size-lg: 56px;
429
+ --wd-padding-sm: 10px 20px;
430
+ --wd-padding-md: 13px 24px;
431
+ --wd-padding-lg: 16px 32px;
432
+ --wd-font-size-sm: 14px;
433
+ --wd-font-size-md: 16px;
434
+ --wd-font-size-lg: 18px;
435
+ --wd-fw-regular: 400;
436
+ --wd-fw-medium: 500;
437
+ --wd-fw-semibold: 600;
438
+ --wd-fw-bold: 700;
439
+ --wd-fw-black: 700;
440
+ --wd-fs-display: clamp(44px, 3.6vw, 64px);
441
+ --wd-fs-title: 32px;
442
+ --wd-fs-heading: 22px;
443
+ --wd-fs-body: 16px;
444
+ --wd-fs-label: 14px;
445
+ --wd-fs-xs: 12px;
446
+ --wd-fs-micro: 12px;
447
+ --wd-fs-nano: 12px;
448
+ /* 行高:四档,按用途分(大标题收紧、小字放宽) */
449
+ --wd-lh-tight: 1.15;
450
+ --wd-lh-snug: 1.35;
451
+ --wd-lh-normal: 1.6;
452
+ --wd-lh-loose: 1.75;
453
+ /* display 专用:40px 以上的字靠字形本身撑行间,不靠行高 */
454
+ --wd-lh-display: 1.06;
455
+ /* 版面宽度:按信息密度分档,不按像素 */
456
+ --wd-page-wide: 1320px;
457
+ --wd-page-base: 1240px;
458
+ --wd-page-narrow: 1100px;
459
+ /* 正文最佳行长:27em ≈ 27 汉字,中文舒适区 */
460
+ --wd-measure: 27em;
461
+ /* 大数字专用字号:与文本字阶是两个维度,不要混用 */
462
+ --wd-fs-figure-sm: 20px;
463
+ --wd-fs-figure: 26px;
464
+ --wd-fs-figure-lg: 34px;
465
+ /*
466
+ * ⚠️ 第 23 轮清理:这里原本又导出一次 dur-fast / dur-slow / ease,
467
+ * 和第 48-56 行重复。CSS 变量后定义会覆盖前面的值,虽然值一样没坏,
468
+ * 但**同一变量出现两次**会让读代码的人看不出哪个才是准的,
469
+ * 也让「改一处」变成「得记得改两处」。
470
+ *
471
+ * 只保留 --wd-dur-base —— 它在 48-56 行没有导出过,是这一块独有的。
472
+ * 其余三档统一去 48-56 行看。
473
+ */
474
+ --wd-dur-base: 220ms;
475
+ /* 移动端安全区:桌面与不支持的浏览器回落 0 */
476
+ --wd-safe-bottom: env(safe-area-inset-bottom, 0px);
477
+ --wd-safe-top: env(safe-area-inset-top, 0px);
478
+ --wd-safe-left: env(safe-area-inset-left, 0px);
479
+ --wd-safe-right: env(safe-area-inset-right, 0px);
480
+ /* --wd-danger 已在第 96 行导出,这里不重复 */
481
+ --wd-danger-soft: #F8E7EA;
482
+ --wd-danger-ink: #8C1122;
483
+ --wd-avatar-1-soft: #E7EEFC;
484
+ --wd-avatar-1-ink: #1D4ED8;
485
+ --wd-avatar-2-soft: #E4F5EC;
486
+ --wd-avatar-2-ink: #17734F;
487
+ --wd-avatar-3-soft: #FBF0DF;
488
+ --wd-avatar-3-ink: #8A5A12;
489
+ --wd-avatar-4-soft: #FBEBF1;
490
+ --wd-avatar-4-ink: #A3325C;
491
+ --wd-avatar-5-soft: #EEEBFB;
492
+ --wd-avatar-5-ink: #4C3BB0;
493
+ --wd-avatar-6-soft: #E3F2F7;
494
+ --wd-avatar-6-ink: #166A80;
495
+ --wd-selected-bg: #191B1F;
496
+ --wd-selected-ink: #FFFFFF;
497
+ --wd-selected-row: #E4E9F0;
498
+ --wd-space-1: 4px;
499
+ --wd-space-2: 8px;
500
+ /* 表格纵向内边距:给 density 档位留的覆盖点(第 159 轮) */
501
+ --wd-table-pad-y: 13px;
502
+ --wd-table-pad-y-lg: 14px;
503
+ --wd-space-3: 12px;
504
+ --wd-space-4: 16px;
505
+ --wd-space-5: 20px;
506
+ --wd-space-6: 24px;
507
+ --wd-space-7: 28px;
508
+ --wd-space-8: 32px;
509
+ --wd-space-10: 40px;
510
+ --wd-space-12: 48px;
511
+ --wd-space-16: 64px;
512
+ --wd-rainbow-red: #D62839;
513
+ --wd-rainbow-orange: #E2632E;
514
+ --wd-rainbow-amber: #D9962B;
515
+ --wd-rainbow-lime: #7FB03A;
516
+ --wd-rainbow-green: #0DBC79;
517
+ --wd-rainbow-teal: #0FA3A0;
518
+ --wd-rainbow-blue: #3B7FD4;
519
+ --wd-rainbow-indigo: #5A63C4;
520
+ --wd-rainbow-violet: #8B55C0;
521
+ --wd-rainbow-pink: #C94E9B;
522
+ --wd-rainbow-red-soft: #FBEAEC;
523
+ --wd-rainbow-orange-soft: #FCEEE6;
524
+ --wd-rainbow-amber-soft: #FAF3E3;
525
+ --wd-rainbow-lime-soft: #F1F6E7;
526
+ --wd-rainbow-green-soft: #E4F8F0;
527
+ --wd-rainbow-teal-soft: #E3F5F5;
528
+ --wd-rainbow-blue-soft: #EAF2FB;
529
+ --wd-rainbow-indigo-soft: #ECEDF9;
530
+ --wd-rainbow-violet-soft: #F3ECF9;
531
+ --wd-rainbow-pink-soft: #FAEAF3;
532
+ --wd-rainbow-red-ink: #A81D2C;
533
+ --wd-rainbow-orange-ink: #A8461A;
534
+ --wd-rainbow-amber-ink: #8A5D14;
535
+ --wd-rainbow-lime-ink: #4E6F1B;
536
+ --wd-rainbow-green-ink: #06704A;
537
+ --wd-rainbow-teal-ink: #0A6462;
538
+ --wd-rainbow-blue-ink: #1F5490;
539
+ --wd-rainbow-indigo-ink: #38418C;
540
+ --wd-rainbow-violet-ink: #613A88;
541
+ --wd-rainbow-pink-ink: #91376C;
542
+ }
543
+
544
+ .wd-group {
545
+ display: inline-flex;
546
+ align-items: stretch;
547
+ min-width: 0;
548
+ vertical-align: middle;
549
+ /* ⚠️ 不能 overflow:hidden —— 会裁掉子项的 focus ring */
550
+ }
551
+
552
+ .wd-group--block {
553
+ display: flex;
554
+ width: 100%;
555
+ }
556
+
557
+ .wd-group--col {
558
+ flex-direction: column;
559
+ align-items: stretch;
560
+ }
561
+
562
+ /* ---------------- 尺寸 ---------------- */
563
+ .wd-group--sm {
564
+ --wd-group-h: 32px;
565
+ --wd-group-pad: 10px;
566
+ --wd-group-fs: 12.5px;
567
+ }
568
+
569
+ .wd-group--md {
570
+ --wd-group-h: 40px;
571
+ --wd-group-pad: 14px;
572
+ --wd-group-fs: 13px;
573
+ }
574
+
575
+ .wd-group--lg {
576
+ --wd-group-h: 48px;
577
+ --wd-group-pad: 18px;
578
+ --wd-group-fs: 14px;
579
+ }
580
+
581
+ /* ---------------- 子项基础 ---------------- */
582
+ .wd-group__item {
583
+ flex: 0 0 auto;
584
+ min-width: 0;
585
+ display: inline-flex;
586
+ align-items: center;
587
+ justify-content: center;
588
+ gap: 6px;
589
+ min-height: var(--wd-group-h);
590
+ font-size: var(--wd-group-fs);
591
+ }
592
+
593
+ .wd-group--equal .wd-group__item {
594
+ flex: 1 1 0;
595
+ }
596
+
597
+ /* 让输入类子项能撑开 */
598
+ .wd-group--block .wd-group__item {
599
+ flex: 1 1 0;
600
+ }
601
+
602
+ /* ---------------- 子项「缴械」:去掉自带外框 ---------------- */
603
+ /*
604
+ * 组合容器统一提供背景与边框,子项必须变成「透明内容块」。
605
+ * 覆盖范围要够宽 —— 任何自带底色/边框/圆角的组件放进来都要被压平,
606
+ * 否则会出现「胶囊里套小胶囊」。
607
+ */
608
+ /*
609
+ * 「缴械」的边界要精确:
610
+ * 要去掉的是**容器级外框**(边框、阴影、外层圆角、块状底色)
611
+ * 要保留的是**组件语义色**(primary 按钮的红底、danger 的危险色)
612
+ *
613
+ * 第一版把 background 一刀切成 transparent,结果 primary 按钮
614
+ * 变成一片空白 —— 按钮还在,但看不出是按钮。
615
+ */
616
+ .wd-group--seamless > .wd-group__item {
617
+ border-radius: 0;
618
+ min-height: var(--wd-group-h);
619
+ }
620
+
621
+ /* 输入类 / 选择器:这些的底色就是"外框",要压平 */
622
+ .wd-group--seamless > .wd-group__item > .wd-input,
623
+ .wd-group--seamless > .wd-group__item > .wd-select {
624
+ background-color: transparent;
625
+ border: 0;
626
+ box-shadow: none;
627
+ border-radius: 0;
628
+ min-height: var(--wd-group-h);
629
+ }
630
+
631
+ /* 按钮:只去外框与圆角,保留 variant 决定的底色 */
632
+ .wd-group--seamless > .wd-group__item > .wd-btn {
633
+ border: 0;
634
+ box-shadow: none;
635
+ border-radius: 0;
636
+ min-height: var(--wd-group-h);
637
+ }
638
+
639
+ /* 输入类:内边距统一,文字左对齐(居中会怪) */
640
+ .wd-group--seamless > .wd-group__item > .wd-input,
641
+ .wd-group--seamless > .wd-group__item > .wd-select {
642
+ justify-content: flex-start;
643
+ padding-left: var(--wd-group-pad);
644
+ padding-right: var(--wd-group-pad);
645
+ width: 100%;
646
+ }
647
+
648
+ .wd-group--seamless > .wd-group__item > .wd-input > input {
649
+ flex: 1 1 auto;
650
+ min-width: 0;
651
+ }
652
+
653
+ /* 按钮类:保留可点区域,去掉自身圆角与外框 */
654
+ .wd-group--seamless > .wd-group__item > .wd-btn {
655
+ border-radius: 0;
656
+ height: 100%;
657
+ padding: 0 var(--wd-group-pad);
658
+ }
659
+
660
+ /* ---------------- 变体:胶囊 ---------------- */
661
+ /*
662
+ * 胶囊:浅底 + 全圆角,无边框。
663
+ * ⚠️ 之前留了 `border: 1px solid transparent` 想复用 joined 的逻辑,
664
+ * 但透明边框仍然占 1px 盒模型空间、也不符合无边框语言。
665
+ */
666
+ .wd-group--capsule {
667
+ background: var(--wd-field);
668
+ border-radius: var(--wd-radius-pill);
669
+ }
670
+
671
+ /*
672
+ * ⚠️ 圆角必须同时压到**内层控件**。
673
+ * 只给 .wd-group__item 设圆角没用 —— 真正有背景的是里面的 .wd-btn,
674
+ * 它的直角会盖住父级圆角,表现为「按钮右端被切平」。
675
+ */
676
+ /*
677
+ * 圆角覆盖要同时命中两种结构:
678
+ * A) <div class="item"><button class="wd-btn"> ← 控件在内部
679
+ * B) <button class="wd-btn item"> ← 控件本身就是 item
680
+ * B 更常见(按钮直接作为插槽子节点),第一版漏了它,
681
+ * 表现为「最后一个按钮右端被切平」。
682
+ */
683
+ /* 横向专用:用 :not(--col) 排除纵向,避免与纵向规则互相覆盖 */
684
+ .wd-group--row.wd-group--capsule > .wd-group__item--first,
685
+ .wd-group--row.wd-group--capsule > .wd-group__item--first > * {
686
+ border-radius: var(--wd-radius-pill) 0 0 var(--wd-radius-pill) !important;
687
+ }
688
+
689
+ .wd-group--row.wd-group--capsule > .wd-group__item--last,
690
+ .wd-group--row.wd-group--capsule > .wd-group__item--last > * {
691
+ border-radius: 0 var(--wd-radius-pill) var(--wd-radius-pill) 0 !important;
692
+ }
693
+
694
+ .wd-group--capsule > .wd-group__item--only,
695
+ .wd-group--capsule > .wd-group__item--only > * {
696
+ border-radius: var(--wd-radius-pill) !important;
697
+ }
698
+
699
+ /*
700
+ * 纵向胶囊。
701
+ *
702
+ * 横向胶囊的圆角是"整条高度的一半"(pill),
703
+ * 纵向时这个语义反过来:上端只圆上面两角、下端只圆下面两角,
704
+ * 且半径应等于**容器宽度的一半**才能形成真正的胶囊端头。
705
+ * 这里用 50% 而不是 pill 令牌 —— 令牌是固定 px,纵向会算错。
706
+ */
707
+ /*
708
+ * ⚠️ 不能用 overflow:hidden 做端头圆角 —— 会裁掉子项的 focus ring
709
+ * (这是本库已记录过的坑)。
710
+ * 改用「按容器宽度算半径」:纵向胶囊的端头半径 = 宽度的一半。
711
+ * 容器宽度由 CSS 变量传入,组件那边不用改。
712
+ */
713
+ .wd-group--capsule.wd-group--col > .wd-group__item,
714
+ .wd-group--capsule.wd-group--col > .wd-group__item > * {
715
+ border-radius: 0 !important;
716
+ }
717
+
718
+ /* 上端:只圆上面两角;下同 */
719
+ .wd-group--capsule.wd-group--col > .wd-group__item--first,
720
+ .wd-group--capsule.wd-group--col > .wd-group__item--first > * {
721
+ border-radius: 50vw 50vw 0 0 !important;
722
+ }
723
+
724
+ .wd-group--capsule.wd-group--col > .wd-group__item--last,
725
+ .wd-group--capsule.wd-group--col > .wd-group__item--last > * {
726
+ border-radius: 0 0 50vw 50vw !important;
727
+ }
728
+
729
+ /*
730
+ * 纵向末项是实心按钮(primary)时,圆角要跟随按钮自身的背景块。
731
+ * 之前只给 .wd-group__item 设了,按钮内部还有一层背景色块
732
+ * 会把圆角盖掉,看起来像"下缘被切平"。
733
+ */
734
+ /*
735
+ * 纵向末项若自身是实心按钮:圆角要作用在按钮自身背景上。
736
+ * 之前只写了 `> .wd-btn`(子元素),漏掉了「自己就是按钮」的情况。
737
+ */
738
+ .wd-group--capsule.wd-group--col > .wd-group__item--last.wd-btn,
739
+ .wd-group--capsule.wd-group--col > .wd-group__item--last > .wd-btn {
740
+ border-radius: 0 0 50vw 50vw !important;
741
+ }
742
+
743
+ /* 首个若自身是按钮也一样 */
744
+ .wd-group--capsule.wd-group--col > .wd-group__item--first.wd-btn,
745
+ .wd-group--capsule.wd-group--col > .wd-group__item--first > .wd-btn {
746
+ border-radius: 50vw 50vw 0 0 !important;
747
+ }
748
+
749
+ /* 纵向 joined:普通圆角即可 */
750
+ /*
751
+ * 纵向 joined 的圆角。
752
+ * ⚠️ 必须同时覆盖「自身是按钮」的情况 —— 按钮直接做插槽子节点时,
753
+ * `> *` 选不中它自己。
754
+ */
755
+ .wd-group--col > .wd-group__item,
756
+ .wd-group--col > .wd-group__item > * {
757
+ border-radius: 0 !important;
758
+ }
759
+
760
+ /*
761
+ * 纵向的端头圆角用 --wd-radius-md,**不用 pill**。
762
+ *
763
+ * 原因:pill(999px)在纵向时会把首项顶边做成半圆拱、末项底边做成半圆拱 ——
764
+ * 视觉上像两个胶囊叠在一起,非常怪。胶囊的语义是"横向的胶囊形",
765
+ * 只在横向(row)成立;纵向应该退回常规圆角。
766
+ */
767
+ .wd-group--col > .wd-group__item--first,
768
+ .wd-group--col > .wd-group__item--first > * {
769
+ border-radius: var(--wd-radius-md) var(--wd-radius-md) 0 0 !important;
770
+ }
771
+
772
+ .wd-group--col > .wd-group__item--last,
773
+ .wd-group--col > .wd-group__item--last > * {
774
+ border-radius: 0 0 var(--wd-radius-md) var(--wd-radius-md) !important;
775
+ }
776
+
777
+ /* 只有 capsule 才用 pill 端头 */
778
+ .wd-group--capsule.wd-group--col > .wd-group__item--first,
779
+ .wd-group--capsule.wd-group--col > .wd-group__item--first > * {
780
+ border-radius: 50vw 50vw 0 0 !important;
781
+ }
782
+
783
+ .wd-group--capsule.wd-group--col > .wd-group__item--last,
784
+ .wd-group--capsule.wd-group--col > .wd-group__item--last > * {
785
+ border-radius: 0 0 50vw 50vw !important;
786
+ }
787
+
788
+ /* 胶囊内的按钮:hover 时整块变浅,不单独做胶囊 */
789
+ /*
790
+ * 胶囊内的按钮:
791
+ * ghost / tint 这类浅底变体在组合里会显得"脏"(同一容器里两种底色),
792
+ * 统一改为透明 + 悬停才浮起。
793
+ * primary 等实心变体保留自身底色(它是强调,不该被压平)。
794
+ */
795
+ /*
796
+ * ⚠️ 子控件可能「自身就是 .wd-group__item」(按钮直接做插槽子节点),
797
+ * 也可能是它的子元素。两种都要命中,否则规则形同虚设。
798
+ */
799
+ /*
800
+ * 去掉子按钮的底色时**必须用 background-color**,不能用 background 简写。
801
+ *
802
+ * ⚠️ 踩坑记录:写 `background: transparent` 会被编译成 `background: none`,
803
+ * 而简写里的 `none` 只重置 background-image,**不清除 background-color** ——
804
+ * 于是 .wd-btn--tint 的粉色依然生效,规则看起来"完全没起作用"。
805
+ * 这个问题很难查,因为选择器匹配、!important 都是对的。
806
+ */
807
+ /*
808
+ * 压制子按钮的浅色底。
809
+ *
810
+ * ⚠️ 踩坑记录(很值得记):
811
+ * 这条规则加了 !important 也"不生效" —— 实测计算值一直是粉色。
812
+ * 排查很久后发现根本原因**不在选择器**,而是:
813
+ * .wd-btn 上有 `transition: background 0.12s`,在动画时钟停摆的环境
814
+ * (后台标签页 / 无头渲染)里 transition 永远停在起始值,
815
+ * `getAnimations()` 显示 background-color 一直处于 running 状态,
816
+ * 于是 computed style 恒为旧值 —— 看起来就像"样式没生效"。
817
+ *
818
+ * 修法:**背景色不做 transition**。这类"压制"性质的样式切换,
819
+ * 本来也不需要动画。
820
+ */
821
+ .wd-group--capsule > .wd-group__item.wd-btn--tint,
822
+ .wd-group--capsule > .wd-group__item.wd-btn--ghost,
823
+ .wd-group--capsule > .wd-group__item > .wd-btn--tint,
824
+ .wd-group--capsule > .wd-group__item > .wd-btn--ghost {
825
+ background-color: transparent !important;
826
+ /* 关键:切断 transition,否则背景色会卡在旧值(时钟停摆时永远不完成) */
827
+ transition: none !important;
828
+ }
829
+
830
+ @media (hover: hover) {
831
+ .wd-group--capsule > .wd-group__item.wd-btn--tint:hover:not(:disabled), .wd-group--capsule > .wd-group__item.wd-btn--ghost:hover:not(:disabled), .wd-group--capsule > .wd-group__item > .wd-btn--tint:hover:not(:disabled), .wd-group--capsule > .wd-group__item > .wd-btn--ghost:hover:not(:disabled) {
832
+ background-color: rgba(0, 0, 0, 0.05) !important;
833
+ transition: none !important;
834
+ }
835
+ }
836
+ /* ---------------- 变体:拼合 ---------------- */
837
+ /*
838
+ * joined:外缘圆角、内部直角拼接。
839
+ *
840
+ * ⚠️ 容器**不设背景**。
841
+ * 之前给 joined 容器铺 --wd-card 白底 + 阴影,结果:
842
+ * · 子项本身也是白底(按钮/输入框),两层白叠着看不出区分
843
+ * · 圆角处容器白底从子项缝隙里透出来 → 出现"白边"
844
+ * 无边框语言里,拼合的分段靠**子项自身的底色**区分即可,
845
+ * 容器只是几何容器,不该有可见的填充。
846
+ */
847
+ .wd-group--joined {
848
+ background: transparent;
849
+ border-radius: var(--wd-radius-md);
850
+ }
851
+
852
+ .wd-group--row.wd-group--joined > .wd-group__item--first,
853
+ .wd-group--row.wd-group--joined > .wd-group__item--first > * {
854
+ border-radius: var(--wd-radius-pill) 0 0 var(--wd-radius-pill) !important;
855
+ }
856
+
857
+ .wd-group--row.wd-group--joined > .wd-group__item--last,
858
+ .wd-group--row.wd-group--joined > .wd-group__item--last > * {
859
+ border-radius: 0 var(--wd-radius-pill) var(--wd-radius-pill) 0 !important;
860
+ }
861
+
862
+ .wd-group--row.wd-group--joined > .wd-group__item--only,
863
+ .wd-group--row.wd-group--joined > .wd-group__item--only > * {
864
+ border-radius: var(--wd-radius-pill) !important;
865
+ }
866
+
867
+ /* 纵向退回常规圆角(pill 在纵向会变成半圆拱) */
868
+ .wd-group--joined.wd-group--col > .wd-group__item--first {
869
+ border-radius: var(--wd-radius-md) var(--wd-radius-md) 0 0;
870
+ }
871
+
872
+ .wd-group--joined.wd-group--col > .wd-group__item--last {
873
+ border-radius: 0 0 var(--wd-radius-md) var(--wd-radius-md);
874
+ }
875
+
876
+ /*
877
+ * 分段之间**不画任何分隔线**。
878
+ *
879
+ * 设计语言是「无边框 · 色块分层」,分隔靠**底色差 + 留白 + 外缘圆角**表达。
880
+ * 曾经用 ::before 画 1px 线(横 40% / 纵 40px),问题在于:
881
+ * · 灰线在白底上永远是"多出来的东西",纵向时像一条莫名其妙的竖杠
882
+ * · 线宽在不同缩放下会取整成 2px,比背景还显眼
883
+ * · 每个 variant × direction 都要单独调位置,容易漏
884
+ * 去掉后拼合仍然成立 —— 圆角 + 相邻底色已经足够暗示分段。
885
+ */
886
+ /* ---------------- 变体:内嵌 ---------------- */
887
+ /*
888
+ * 容器是「底色凹槽」,子项浮在上面。
889
+ * 适合:搜索框、分段切换、小工具条。
890
+ */
891
+ /*
892
+ * inset:凹槽底 + 子项浮起。
893
+ *
894
+ * ⚠️ 之前和 joined 几乎看不出区别(都是浅底 + 圆角)。
895
+ * 差异要在「内距 + 子项自身底色」上做出来:
896
+ * inset = 容器是深一档的凹槽,子项选中时有白底浮起
897
+ * joined = 容器与子项同色,只靠外缘圆角和分隔线拼合
898
+ */
899
+ .wd-group--inset {
900
+ background: var(--wd-field);
901
+ border-radius: var(--wd-radius-md);
902
+ padding: 4px;
903
+ gap: 3px;
904
+ box-shadow: none;
905
+ }
906
+
907
+ /* inset 的子项默认透明,悬停/选中才有底色(浮起感) */
908
+ .wd-group--inset > .wd-group__item {
909
+ border-radius: var(--wd-radius-xs) !important;
910
+ transition: background var(--wd-dur-fast) var(--wd-ease-smooth), box-shadow var(--wd-dur-fast) var(--wd-ease-smooth);
911
+ }
912
+
913
+ @media (hover: hover) {
914
+ .wd-group--inset > .wd-group__item:hover {
915
+ background-color: var(--wd-field-hover);
916
+ }
917
+ }
918
+ .wd-group--inset > .wd-group__item > .wd-btn--primary {
919
+ background-color: var(--wd-card);
920
+ box-shadow: var(--wd-shadow-sm);
921
+ }
922
+
923
+ .wd-group--inset > .wd-group__item {
924
+ border-radius: var(--wd-radius-xs);
925
+ transition: background var(--wd-dur-fast) var(--wd-ease-smooth);
926
+ }
927
+
928
+ @media (hover: hover) {
929
+ .wd-group--inset > .wd-group__item:hover {
930
+ background: var(--wd-field-hover);
931
+ }
932
+ }
933
+ /* inset 靠间距区分,不画分隔线 */
934
+ /* 纵向:每一项都要撑满宽度,否则会各自缩成一团 */
935
+ .wd-group--col > .wd-group__item {
936
+ width: 100%;
937
+ }
938
+
939
+ .wd-group--col > .wd-group__item > .wd-btn,
940
+ .wd-group--col > .wd-group__item > .wd-input {
941
+ width: 100%;
942
+ }
943
+
944
+ /* ---------------- 焦点与禁用 ---------------- */
945
+ /*
946
+ * 焦点环**只在 group 容器上画一次**。
947
+ *
948
+ * ⚠️ 曾经的重叠问题:
949
+ * 1. `.wd-input:focus-within` 给自己加了 4px 环
950
+ * 2. `.wd-group:focus-within` 又给容器加了一圈
951
+ * 3. 上面那条 `.wd-group__item:focus-within` 再叠一层 outline
952
+ * 三层环同色但半径不同,叠起来就是截图里那种"粗重、边缘不齐"的框。
953
+ *
954
+ * 规则:**组内所有子控件一律放弃自己的焦点环**,
955
+ * 由 group 统一表达"这里有焦点"。这也符合"一个整体只有一个边界"的语义。
956
+ */
957
+ /* 组内子控件统统缴械:不管它是 input、select、button 还是自定义控件 */
958
+ .wd-group .wd-input:focus-within,
959
+ .wd-group .wd-select:focus-within,
960
+ .wd-group .wd-btn:focus-visible,
961
+ .wd-group .wd-cascader:focus-within,
962
+ .wd-group .wd-datepicker:focus-within,
963
+ .wd-group .wd-colorpicker:focus-visible,
964
+ .wd-group [class*=__item]:focus-within,
965
+ .wd-group [class*=__item]:focus-visible {
966
+ box-shadow: none !important;
967
+ outline: none !important;
968
+ }
969
+
970
+ /*
971
+ * 焦点项提升层级:否则后一项的背景会盖住前一项的边。
972
+ * 注意这里**不画任何环**,只提层级 —— 环由 group 负责。
973
+ */
974
+ .wd-group__item:focus-within {
975
+ position: relative;
976
+ z-index: 2;
977
+ }
978
+
979
+ .wd-group--disabled {
980
+ opacity: 0.55;
981
+ pointer-events: none;
982
+ }
983
+
984
+ /* ---------------- 子项是纯文字/图标时的对齐 ---------------- */
985
+ .wd-group__item > span,
986
+ .wd-group__item > svg {
987
+ flex: none;
988
+ }
989
+
990
+ .wd-group__item--static {
991
+ color: var(--wd-ink-2);
992
+ padding: 0 calc(var(--wd-group-pad) * 0.7);
993
+ font-weight: var(--wd-fw-medium);
994
+ -webkit-user-select: none;
995
+ -webkit-user-select: none;
996
+ user-select: none;
997
+ }
998
+
999
+ /* =============================================================
1000
+ * 选中态高亮:呼吸光环
1001
+ *
1002
+ * ===== 为什么需要改 =====
1003
+ * 拼接(joined)布局里相邻项的边缘是完全贴合的:
1004
+ * 选中项如果画**外**描边或阴影,就会被后一项的背景盖掉一半,
1005
+ * 看起来像"边框重叠"或"只画了三条边"。
1006
+ *
1007
+ * ===== 做法 =====
1008
+ * 1. 用 `inset` 内阴影而不是外描边 —— 内阴影永远在元素内部,
1009
+ * 不会被相邻项遮挡
1010
+ * 2. 叠在 :focus-within / .is-active 上,用极缓慢的透明度呼吸
1011
+ * (2.6s,往返),提示"这里是当前项"但不刺眼
1012
+ * 3. 拼接布局加 2px 间隙:视觉上仍是连续的,但边缘不再互相压
1013
+ * ============================================================= */
1014
+ /*
1015
+ * 选中态(.is-active):只在项**内部**画一层内阴影。
1016
+ * 内阴影不会被相邻项遮挡,也不会和 group 的焦点环冲突 ——
1017
+ * 它是"这一项被选中",而 group 环是"焦点在这个组合里",语义不同。
1018
+ */
1019
+ .wd-group__item.is-active {
1020
+ position: relative;
1021
+ z-index: 1;
1022
+ }