@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,1082 @@
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-timeline {
545
+ display: flex;
546
+ margin: 0;
547
+ padding: 0;
548
+ list-style: none;
549
+ --tl-dot: 10px;
550
+ --tl-gap: 18px;
551
+ }
552
+
553
+ .wd-timeline--sm {
554
+ --tl-dot: 8px;
555
+ --tl-gap: 13px;
556
+ }
557
+
558
+ /* ---------------- 纵向(默认) ---------------- */
559
+ .wd-timeline--vertical {
560
+ flex-direction: column;
561
+ }
562
+
563
+ .wd-timeline--vertical .wd-timeline__item {
564
+ position: relative;
565
+ display: flex;
566
+ gap: 12px;
567
+ padding-bottom: var(--tl-gap);
568
+ }
569
+
570
+ .wd-timeline--vertical .wd-timeline__item.is-last {
571
+ padding-bottom: 0;
572
+ }
573
+
574
+ /*
575
+ * ===== 节点与竖线的对齐 =====
576
+ *
577
+ * 核心问题:节点宽度会变(无图标 10px / 有图标 22px),
578
+ * 竖线必须**永远穿过节点圆心**。
579
+ *
580
+ * 前两次的做法都失败:
581
+ * a) 写死 `left: --tl-dot / 2`(5px)→ 有图标时节点 22px,线偏出 6px
582
+ * b) 给节点加 margin 居中 + 线按列宽算 → 有图标的对了,
583
+ * 无图标的节点只有 10px,圆心仍在列宽的一半之前 → 又偏 6px
584
+ *
585
+ * 根因:竖线挂在 item 上,而 item 不知道节点实际多宽。
586
+ *
587
+ * 最终方案:**竖线挂在节点自己身上**。
588
+ * 节点是 --tl-node-col 宽的列里的内容,但线用 `left: 50%` 相对节点自身定位,
589
+ * 于是无论节点 10px 还是 22px,线永远在它的水平正中。
590
+ *
591
+ * 用 ::after 而不是 ::before:::before 已被"节点底色/描边"占用。
592
+ * 线从上往下延伸到 item 底部 —— 节点自身高度不含整条 item,
593
+ * 所以仍然需要 item 提供高度参照:用 `bottom: calc(-100% - ...)` 不行,
594
+ * 改成给 item 加一个从节点垂直位置到 item 底部的伪元素段。
595
+ *
596
+ * 实际实现:节点画"线下段"(从自身底部到 item 底),
597
+ * item 不再画线。
598
+ */
599
+ .wd-timeline--vertical .wd-timeline__item {
600
+ --tl-node-col: calc(var(--tl-dot) + 12px);
601
+ position: relative;
602
+ }
603
+
604
+ /*
605
+ * ===== 节点:必须是正方形 =====
606
+ *
607
+ * ⚠️ 这轮踩的坑:为了让竖线穿过圆心,我把节点宽度强行设成了
608
+ * `width: var(--tl-node-col)`(22px),但高度仍是 `--tl-dot`(10px)——
609
+ * 结果节点变成 **22×10 的扁椭圆**。
610
+ *
611
+ * 列宽 ≠ 节点宽。列宽是布局占位,节点是视觉图形,
612
+ * 两者绑在一起必然出问题(节点被拉成椭圆)。
613
+ *
614
+ * 正解:节点保持自身尺寸(正方形),用 **margin 在列内居中**,
615
+ * 圆心 = 列宽/2,线也按列宽/2 定位,两者自然对齐。
616
+ */
617
+ .wd-timeline--vertical .wd-timeline__node {
618
+ /* 不参与 flex 拉伸/收缩 */
619
+ flex: none;
620
+ /* 正方形:宽高都跟 --tl-dot */
621
+ width: var(--tl-dot);
622
+ height: var(--tl-dot);
623
+ /* 在 --tl-node-col 宽的列里水平居中 */
624
+ margin-left: calc((var(--tl-node-col) - var(--tl-dot)) / 2);
625
+ margin-right: 0;
626
+ margin-top: 3px;
627
+ /* 内圈内容居中 */
628
+ justify-content: center;
629
+ }
630
+
631
+ .wd-timeline--vertical .wd-timeline__node:not(:has(> .wd-icon)) .wd-timeline__dot {
632
+ width: var(--tl-dot);
633
+ height: var(--tl-dot);
634
+ border-radius: 50%;
635
+ background: var(--wd-ink-4);
636
+ }
637
+
638
+ /*
639
+ * 有图标时:节点放大为圆形徽章。
640
+ *
641
+ * ⚠️ 关键:图标本身必须是**正方形**且不参与收缩。
642
+ * 之前只给了容器尺寸,内部的 .wd-icon 是 flex 子项,
643
+ * 在列宽约束下会被横向压缩 —— 表现为"图标都扁了"。
644
+ * 这里显式锁死图标的宽高比,并禁止 shrink。
645
+ */
646
+ /*
647
+ * 有图标时:徽章放大到 26px(比 --tl-node-col 的 22px 更宽松)。
648
+ * 22px 里塞 15px 图标只剩 3.5px 边距,看起来发挤。
649
+ */
650
+ /* 有图标:正方形 26px,margin 跟着重算(列宽也是 26,所以居中 = 0) */
651
+ .wd-timeline--vertical .wd-timeline__node:has(> .wd-icon) {
652
+ width: 26px;
653
+ height: 26px;
654
+ margin-left: 0;
655
+ }
656
+
657
+ /* 列宽同步放大,保证圆心不变 */
658
+ .wd-timeline--vertical .wd-timeline__item:has(.wd-timeline__node > .wd-icon) {
659
+ --tl-node-col: 26px;
660
+ --tl-node-h: 26px;
661
+ }
662
+
663
+ /*
664
+ * 节点内的图标。
665
+ *
666
+ * ⚠️ 两个都要管:
667
+ * 1. **不能被压扁** —— 之前只给了容器尺寸,图标作为 flex 子项
668
+ * 在固定列宽下被横向压缩(表现为"图标都扁了")。
669
+ * 用 aspect-ratio + flex: none 锁死比例。
670
+ * 2. **不能太小** —— 原来按 :size 传入 13~15px,
671
+ * 在 22px 的圆形徽章里只占 60%,看起来空。
672
+ * 放大到约 68%(15px),视觉重量才和徽章匹配。
673
+ *
674
+ * 尺寸用 em 相对节点,这样改 --tl-dot 时图标自动跟随。
675
+ */
676
+ .wd-timeline--vertical .wd-timeline__node > .wd-icon {
677
+ flex: none;
678
+ width: auto;
679
+ height: auto;
680
+ aspect-ratio: 1;
681
+ /* 撑到徽章内径的 ~68%:再大就贴边,再小显得空 */
682
+ min-width: 15px;
683
+ min-height: 15px;
684
+ }
685
+
686
+ /*
687
+ * 竖线:从**节点底边**延伸到下一条。
688
+ *
689
+ * ⚠️ 关键:起点不能写死 `--tl-dot + 12px`。
690
+ * 那个表达式假设节点恒为 22px(带图标的尺寸),
691
+ * 但无图标时节点只有 10px 高 / 有图标时 22px ——
692
+ * 于是无图标那条线会在节点下方留 12px 空隙,
693
+ * 带图标那条则刚好贴边,两行看起来对不齐。
694
+ *
695
+ * 正确做法:让 item 用一个 CSS 变量记录"节点占位高度",
696
+ * 线从该高度开始。
697
+ */
698
+ .wd-timeline--vertical .wd-timeline__item {
699
+ /* 节点占位高度:默认圆点高,带图标时由 :has 覆盖 */
700
+ --tl-node-h: var(--tl-dot);
701
+ }
702
+
703
+ .wd-timeline--vertical .wd-timeline__item:has(.wd-timeline__node > .wd-icon) {
704
+ --tl-node-h: calc(var(--tl-dot) + 12px);
705
+ }
706
+
707
+ .wd-timeline--vertical .wd-timeline__item::before {
708
+ content: "";
709
+ position: absolute;
710
+ /* 与节点圆心同一个表达式 —— 两者都基于 --tl-node-col */
711
+ left: calc(var(--tl-node-col) / 2 - 0.5px);
712
+ /* 从节点底边稍下一点开始,避免线和圆点描边粘连 */
713
+ top: calc(var(--tl-node-h) + 3px + 4px);
714
+ bottom: 0;
715
+ width: 1px;
716
+ background: var(--wd-ink-5);
717
+ }
718
+
719
+ .wd-timeline--vertical.wd-timeline--line-none .wd-timeline__item::before {
720
+ display: none;
721
+ }
722
+
723
+ .wd-timeline--vertical.wd-timeline--line-dashed .wd-timeline__item::before {
724
+ background: repeating-linear-gradient(to bottom, var(--wd-tint-3) 0, var(--wd-tint-3) 3px, transparent 3px, transparent 7px);
725
+ }
726
+
727
+ /* ---------------- 节点 ---------------- */
728
+ /*
729
+ * 节点尺寸:默认 = --tl-dot(10px 小圆点);
730
+ * 带图标时自动放大到能容下图标 —— 否则图标会溢出节点边框,
731
+ * 视觉上像是"图标浮在外面"(实测 10px 节点塞 13-15px 图标)。
732
+ *
733
+ * ⚠️ 用 min-width/min-height 而不是 width/height:
734
+ * 有图标时让它自然长大,无图标时保持小巧。
735
+ */
736
+ .wd-timeline__node {
737
+ position: relative;
738
+ z-index: 1;
739
+ display: inline-flex;
740
+ align-items: center;
741
+ justify-content: center;
742
+ flex: none;
743
+ /*
744
+ * ⚠️ 必须显式 align-self: flex-start。
745
+ * 父级 .wd-timeline__item 是 flex 容器且未设 align-items,
746
+ * 默认 stretch 会把节点在交叉轴拉满 —— 实测 22x65(应为 22x22)。
747
+ * 节点是"点",不该被拉伸成"条"。
748
+ */
749
+ align-self: flex-start;
750
+ min-width: var(--tl-dot);
751
+ min-height: var(--tl-dot);
752
+ border-radius: 50%;
753
+ /* 默认节点:空心描边,比实心更轻,不会把时间线压成一条黑点链 */
754
+ background: var(--wd-card);
755
+ box-shadow: inset 0 0 0 2px var(--wd-ink-4);
756
+ color: var(--wd-ink-2);
757
+ }
758
+
759
+ /* 带图标时:节点扩大为圆形徽章,图标完整居中 */
760
+ .wd-timeline__node:has(> .wd-icon) {
761
+ min-width: calc(var(--tl-dot) + 12px);
762
+ min-height: calc(var(--tl-dot) + 12px);
763
+ box-shadow: inset 0 0 0 1.5px var(--wd-ink-4);
764
+ }
765
+
766
+ .wd-timeline__dot {
767
+ width: calc(var(--tl-dot) - 4px);
768
+ height: calc(var(--tl-dot) - 4px);
769
+ border-radius: 50%;
770
+ background: var(--wd-ink-4);
771
+ }
772
+
773
+ /* 高亮节点:主色实心 */
774
+ .wd-timeline__item.is-active .wd-timeline__node {
775
+ background: var(--tl-color, var(--wd-red));
776
+ box-shadow: 0 0 0 3px var(--wd-ink-5);
777
+ color: #fff;
778
+ }
779
+
780
+ .wd-timeline__item.is-active .wd-timeline__dot {
781
+ background: #fff;
782
+ }
783
+
784
+ /* 自定义颜色:覆盖节点与圆点(注意这是「面上色」,不要拿来当前景色用) */
785
+ .wd-timeline__item {
786
+ --tl-color: var(--wd-red);
787
+ /* 文字色单独一条,允许与面上色不同(例如面上是深红、文字要提亮) */
788
+ --tl-text-color: var(--wd-red-text);
789
+ }
790
+
791
+ .wd-timeline__item.is-disabled .wd-timeline__node {
792
+ box-shadow: inset 0 0 0 2px var(--wd-tint-3);
793
+ }
794
+
795
+ .wd-timeline__item.is-disabled .wd-timeline__dot {
796
+ background: var(--wd-tint-3);
797
+ }
798
+
799
+ .wd-timeline__item.is-disabled .wd-timeline__title,
800
+ .wd-timeline__item.is-disabled .wd-timeline__desc {
801
+ color: var(--wd-ink-3);
802
+ }
803
+
804
+ /* ---------------- 内容 ---------------- */
805
+ .wd-timeline__body {
806
+ flex: 1;
807
+ min-width: 0;
808
+ padding-top: 1px;
809
+ }
810
+
811
+ .wd-timeline__period {
812
+ display: block;
813
+ margin-bottom: 3px;
814
+ /*
815
+ * ⚠️ 不要给 period 设 `flex: 0 0 4.5em`(老纵向双栏布局的约束)。
816
+ * 在 alternate/horizontal 的 grid/flex 里,固定 basis 会把标签压成竖排。
817
+ */
818
+ flex: none;
819
+ font-size: var(--wd-fs-xs);
820
+ font-weight: var(--wd-fw-bold);
821
+ letter-spacing: 0.02em;
822
+ /* 时间标签用中灰:只提供上下文,不抢视线 */
823
+ color: var(--wd-ink-2);
824
+ font-variant-numeric: tabular-nums;
825
+ }
826
+
827
+ /*
828
+ * 只有 active 节点的时间标签才用主色 —— 这是"点睛"的位置。
829
+ *
830
+ * ⚠️ 默认值必须用 --wd-red-text,不能用 --wd-red:
831
+ * --wd-red(#D62839) 是「面上」的红,浅底上 4.97:1 没问题,
832
+ * 但深色主题下卡片底是 #1C1C1E,同一个红只剩 3.42:1,12px 小字看不清。
833
+ * --wd-red-text 在深色下是 #EE7A85(深底 6.29:1),浅色下等于 --wd-red。
834
+ * 全站另外 8 处红字早就用了 red-text,只有这里漏了。
835
+ */
836
+ .wd-timeline__item.is-active .wd-timeline__period {
837
+ /*
838
+ * 这里刻意**不用** --tl-color。
839
+ *
840
+ * --tl-color 是给「圆点/节点填充」用的面上色(默认 --wd-red #D62839),
841
+ * 它默认被设成深红,直接拿来当 12px 文字色,在深色主题的卡片底(#1C1C1E)
842
+ * 上只有 3.42:1,看不清。文字要用「文字款」的 --wd-red-text:
843
+ * 浅色下等于 --wd-red,深色下自动变 #EE7A85(深底 6.29:1)。
844
+ * 用户仍可通过 color 属性自定义时间标签颜色(--tl-text-color)。
845
+ */
846
+ color: var(--tl-text-color, var(--wd-red-text));
847
+ }
848
+
849
+ .wd-timeline__title {
850
+ display: flex;
851
+ align-items: center;
852
+ gap: 5px;
853
+ margin: 0 0 4px;
854
+ font-size: var(--wd-fs-body);
855
+ font-weight: var(--wd-fw-semibold);
856
+ color: var(--wd-ink);
857
+ line-height: var(--wd-lh-snug);
858
+ }
859
+
860
+ .wd-timeline--sm .wd-timeline__title {
861
+ font-size: var(--wd-fs-caption);
862
+ }
863
+
864
+ .wd-timeline__desc {
865
+ margin: 0;
866
+ font-size: var(--wd-fs-caption);
867
+ line-height: var(--wd-lh-loose);
868
+ color: var(--wd-ink-2);
869
+ }
870
+
871
+ .wd-timeline--sm .wd-timeline__desc {
872
+ font-size: var(--wd-fs-label);
873
+ }
874
+
875
+ /* ---------------- 可折叠 ---------------- */
876
+ .wd-timeline__item.is-clickable {
877
+ cursor: pointer;
878
+ }
879
+
880
+ .wd-timeline__caret {
881
+ flex: none;
882
+ color: var(--wd-ink-3);
883
+ transition: transform var(--wd-dur-fast) var(--wd-ease-out);
884
+ }
885
+
886
+ .wd-timeline__caret.is-open {
887
+ transform: rotate(180deg);
888
+ }
889
+
890
+ .wd-timeline__detail {
891
+ margin-top: 8px;
892
+ padding: 10px 12px;
893
+ border-radius: var(--wd-radius-sm);
894
+ background: var(--wd-field);
895
+ font-size: var(--wd-fs-label);
896
+ line-height: var(--wd-lh-loose);
897
+ color: var(--wd-ink-2);
898
+ }
899
+
900
+ /* ---------------- 横向 ---------------- */
901
+ .wd-timeline--horizontal {
902
+ flex-direction: row;
903
+ align-items: flex-start;
904
+ overflow-x: auto;
905
+ padding-bottom: 4px;
906
+ scrollbar-width: thin;
907
+ }
908
+
909
+ /*
910
+ * 横向时每个 item 等分。
911
+ * ⚠️ 不能用 flex:1 —— 内容长的项会被压缩到读不出;
912
+ * 用 min-width 保证可读,超出时容器横向滚动。
913
+ */
914
+ .wd-timeline--horizontal .wd-timeline__item {
915
+ position: relative;
916
+ flex: 1 1 0;
917
+ min-width: 132px;
918
+ display: flex;
919
+ flex-direction: column;
920
+ align-items: flex-start;
921
+ gap: 8px;
922
+ padding-right: var(--tl-gap);
923
+ }
924
+
925
+ /* 横向连接线:从节点右侧连到下一个节点 */
926
+ .wd-timeline--horizontal .wd-timeline__item::before {
927
+ content: "";
928
+ position: absolute;
929
+ top: calc(var(--tl-dot) / 2 - 0.5px);
930
+ left: var(--tl-dot);
931
+ right: var(--tl-gap);
932
+ height: 1px;
933
+ background: var(--wd-tint-3);
934
+ }
935
+
936
+ .wd-timeline--horizontal.wd-timeline--line-none .wd-timeline__item::before {
937
+ display: none;
938
+ }
939
+
940
+ .wd-timeline--horizontal.wd-timeline--line-dashed .wd-timeline__item::before {
941
+ background: repeating-linear-gradient(to right, var(--wd-tint-3) 0, var(--wd-tint-3) 3px, transparent 3px, transparent 7px);
942
+ }
943
+
944
+ /* 最后一项不画线(否则线会伸到空白处) */
945
+ .wd-timeline--horizontal .wd-timeline__item.is-last::before {
946
+ display: none;
947
+ }
948
+
949
+ .wd-timeline--horizontal .wd-timeline__body {
950
+ padding-top: 0;
951
+ }
952
+
953
+ /* ---------------- 交替 ---------------- */
954
+ /*
955
+ * 节点居中,内容左右交替。
956
+ * 实现方式:item 用 grid 三列(1fr auto 1fr),
957
+ * 奇数项内容放左、偶数项放右,节点始终在中间列。
958
+ */
959
+ /*
960
+ * ⚠️ 必须显式写 column。
961
+ * `.wd-timeline` 基类没有设 flex-direction(默认 row),
962
+ * 之前 --vertical 和 --horizontal 各自覆盖了,唯独漏了 --alternate →
963
+ * 三个 item 横向排开,每个只有 255px,内容全被挤成竖排单字。
964
+ * 症状很像"grid 轨道算错了",实际是外层 flex 方向错了。
965
+ */
966
+ .wd-timeline--alternate {
967
+ flex-direction: column;
968
+ }
969
+
970
+ .wd-timeline--alternate .wd-timeline__item {
971
+ position: relative;
972
+ display: grid;
973
+ /*
974
+ * ⚠️ 三个轨道都要能收缩:`1fr auto 1fr` 里的 1fr 默认 min-width 是 auto,
975
+ * 内容一长就把另一侧挤到极窄(实测把"2026 Q4"挤成了竖排单字)。
976
+ * 用 `minmax(0, 1fr)` 明确允许收缩,再配合 body 的 min-width:0。
977
+ */
978
+ grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
979
+ gap: 0 18px;
980
+ align-items: start;
981
+ padding-bottom: var(--tl-gap);
982
+ }
983
+
984
+ .wd-timeline--alternate .wd-timeline__node {
985
+ grid-column: 2;
986
+ justify-self: center;
987
+ margin-top: 2px;
988
+ }
989
+
990
+ /* 奇数项(0,2,4...):内容在左,第二列占位 */
991
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__body {
992
+ grid-column: 1;
993
+ text-align: right;
994
+ /* 允许收缩(与 minmax(0,1fr) 配合),否则长词仍会把列撑开 */
995
+ min-width: 0;
996
+ }
997
+
998
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__period,
999
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__title {
1000
+ justify-content: flex-end;
1001
+ }
1002
+
1003
+ /*
1004
+ * 偶数项(1,3,5...):内容在右。
1005
+ * 第一列要放一个空占位,否则内容会挤到节点左边。
1006
+ */
1007
+ .wd-timeline--alternate .wd-timeline__item:nth-child(even) .wd-timeline__body {
1008
+ grid-column: 3;
1009
+ min-width: 0;
1010
+ }
1011
+
1012
+ .wd-timeline--alternate .wd-timeline__item:nth-child(even) .wd-timeline__node {
1013
+ grid-row: 1;
1014
+ }
1015
+
1016
+ /* 居中贯穿线 */
1017
+ .wd-timeline--alternate .wd-timeline__item::before {
1018
+ content: "";
1019
+ position: absolute;
1020
+ left: 50%;
1021
+ transform: translateX(-0.5px);
1022
+ top: calc(var(--tl-dot) + 4px);
1023
+ bottom: 0;
1024
+ width: 1px;
1025
+ background: var(--wd-tint-3);
1026
+ }
1027
+
1028
+ .wd-timeline--alternate.wd-timeline--line-none .wd-timeline__item::before {
1029
+ display: none;
1030
+ }
1031
+
1032
+ .wd-timeline--alternate.wd-timeline--line-dashed .wd-timeline__item::before {
1033
+ background: repeating-linear-gradient(to bottom, var(--wd-tint-3) 0, var(--wd-tint-3) 3px, transparent 3px, transparent 7px);
1034
+ }
1035
+
1036
+ .wd-timeline--alternate .wd-timeline__item.is-last::before {
1037
+ display: none;
1038
+ }
1039
+
1040
+ /* ---------------- 窄屏降级 ---------------- */
1041
+ /*
1042
+ * 交替布局在窄屏上左右空间不够,强行保留会让文字挤成一条。
1043
+ * 直接退回纵向单列 —— 这是移动端时间线的通行做法。
1044
+ */
1045
+ @media (max-width: 640px) {
1046
+ /*
1047
+ * ⚠️ 必须显式写 column。
1048
+ * `.wd-timeline` 基类没有设 flex-direction(默认 row),
1049
+ * 之前 --vertical 和 --horizontal 各自覆盖了,唯独漏了 --alternate →
1050
+ * 三个 item 横向排开,每个只有 255px,内容全被挤成竖排单字。
1051
+ * 症状很像"grid 轨道算错了",实际是外层 flex 方向错了。
1052
+ */
1053
+ .wd-timeline--alternate {
1054
+ flex-direction: column;
1055
+ }
1056
+ .wd-timeline--alternate .wd-timeline__item {
1057
+ display: flex;
1058
+ gap: 12px;
1059
+ padding-bottom: var(--tl-gap);
1060
+ }
1061
+ .wd-timeline--alternate .wd-timeline__node {
1062
+ margin-top: 3px;
1063
+ }
1064
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__body,
1065
+ .wd-timeline--alternate .wd-timeline__item:nth-child(even) .wd-timeline__body {
1066
+ grid-column: auto;
1067
+ text-align: left;
1068
+ }
1069
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__period,
1070
+ .wd-timeline--alternate .wd-timeline__item:nth-child(odd) .wd-timeline__title {
1071
+ justify-content: flex-start;
1072
+ }
1073
+ .wd-timeline--alternate .wd-timeline__item::before {
1074
+ left: calc(var(--tl-dot) / 2 - 0.5px);
1075
+ transform: none;
1076
+ }
1077
+ }
1078
+ @media (prefers-reduced-motion: reduce) {
1079
+ .wd-timeline__caret {
1080
+ transition: none;
1081
+ }
1082
+ }