modelgo-design-tokens 0.10.0 → 0.11.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 +21 -0
- package/USAGE.md +36 -0
- package/base.css +597 -0
- package/console.css +829 -0
- package/package.json +10 -1
- package/website.css +46 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,27 @@
|
|
|
4
4
|
|
|
5
5
|
### Added
|
|
6
6
|
|
|
7
|
+
- **Token 分层产物:`base.css` / `console.css` / `website.css`**(241 / 434 / 4 个 token)。
|
|
8
|
+
消费方按需只引自己那层:控制台引 `base + console`,官网引 `base + website`;继续引全量
|
|
9
|
+
`tokens.css` 的行为与 0.10.0 完全一致,**不是 breaking change**。
|
|
10
|
+
- 三份是 `tokens.css` 的**投影,不是第二真源**。改值仍然只改 `tokens.css`(走预览站),
|
|
11
|
+
再 `npm run split` 重新生成。之所以不把真源拆成三份:本仓改值入口是预览站
|
|
12
|
+
`/api/save` 直接写回 `tokens.css`,四道门禁也全部扫它,拆真源要把这些全改一遍,
|
|
13
|
+
收益却只是消费方少引几个 token —— 不值得。
|
|
14
|
+
- 归属按 **token 名**判定(`token-layers.json`,本关唯一人工输入),不按它在
|
|
15
|
+
`tokens.css` 里的物理位置:物理位置只是作者组织文件的方式,同一个
|
|
16
|
+
`[data-theme='dark']` 块里可能混着不同层的 token;而分层要求同一个 token 的
|
|
17
|
+
**所有档(`:root` / dark / market)必须落在同一层**,否则只引 base 的消费方会缺档。
|
|
18
|
+
- 新增两道门禁,均已接进 `release.mjs` 预检:`check:layers-sync`(产物与 `tokens.css`
|
|
19
|
+
是否同步,过期直接拦住发版)、`check:layers`(无跨层重复 / 引用方向单向 / 档位完整 /
|
|
20
|
+
`base` 与 `base+console`、`base+website` 各自自闭合)。产物过期的故障形态是**静默的**
|
|
21
|
+
——消费方拿到旧值且不报错,同悬空 var,所以必须机器拦。
|
|
22
|
+
- ⚠️ **不能只引 `console.css` 不引 `base.css`**:console 层大量 token 是
|
|
23
|
+
`var(--mg-brand-base)` 这类对 base 的引用,缺 base 即悬空 var → 整条声明静默失效。
|
|
24
|
+
- **解决的真问题**:消费方为拿到派生层,历史上会把库的整份 token 抄进本地做转发
|
|
25
|
+
(console-web 抄了 337 个),于是库改值被本地重复声明压死、每次升级都要重复一遍撤除
|
|
26
|
+
动作(见下方 0.10.0 与 qa#615、qa#611 ④)。按需只引一层后,抄整份的动机就消失了。
|
|
27
|
+
|
|
7
28
|
- **对比度门禁(关卡 4)**:`scripts/check-token-contrast.mjs` + `contrast-contract.json`(语义配对表)
|
|
8
29
|
+ `contrast-baseline.json`(存量快照)。解析 `tokens.css` 的 `var()` 链与 `color-mix()`,
|
|
9
30
|
在 `market × theme` 全矩阵下算 WCAG 2.1 对比度。接在三处:`pre-commit-all.sh`、
|
package/USAGE.md
CHANGED
|
@@ -2,6 +2,42 @@
|
|
|
2
2
|
|
|
3
3
|
token 解决"值统一",这页解决"用法统一"——四端照同一套规则用,才不会再飘。
|
|
4
4
|
|
|
5
|
+
## 引哪一份(0.11.0 起)
|
|
6
|
+
|
|
7
|
+
包里除全量 `tokens.css` 外,另出三份分层产物,**按你是哪一端只引自己那层**:
|
|
8
|
+
|
|
9
|
+
```css
|
|
10
|
+
/* 控制台 */
|
|
11
|
+
@import "modelgo-design-tokens/base.css";
|
|
12
|
+
@import "modelgo-design-tokens/console.css";
|
|
13
|
+
|
|
14
|
+
/* 官网(domestic / global) */
|
|
15
|
+
@import "modelgo-design-tokens/base.css";
|
|
16
|
+
@import "modelgo-design-tokens/website.css";
|
|
17
|
+
|
|
18
|
+
/* 不确定 / 图省事 —— 全量,行为与 0.10.0 及以前完全一致 */
|
|
19
|
+
@import "modelgo-design-tokens/tokens.css";
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
| 层 | token 数 | 内容 | 依赖 |
|
|
23
|
+
|---|---|---|---|
|
|
24
|
+
| `base` | 241 | 原子与跨端语义:品牌色阶/灰阶/字阶/间距/圆角/阴影/动效/层级/断点/面与文字/玻璃/状态语义色 | 自闭合,不依赖任何层 |
|
|
25
|
+
| `console` | 434 | 控制台专用组件语义 | 只依赖 `base` |
|
|
26
|
+
| `website` | 4 | 官网专用组件语义(官网组件层大部分仍在官网本地维护、尚未下沉) | 只依赖 `base` |
|
|
27
|
+
|
|
28
|
+
三份是 `tokens.css` 的**投影,不是第二真源**:改值仍然只改 `tokens.css`(走预览站),
|
|
29
|
+
然后 `npm run split` 重新生成。`release.mjs` 预检会跑 `check:layers-sync`,产物过期
|
|
30
|
+
直接拦住发版——因为过期产物的故障形态是**静默的**(消费方拿到旧值,不报错)。
|
|
31
|
+
|
|
32
|
+
> ⚠️ **别只引 `console.css` 不引 `base.css`**。console 层里大量 token 是
|
|
33
|
+
> `var(--mg-brand-base)` 这类对 base 的引用,缺了 base 就是悬空 var → **整条声明
|
|
34
|
+
> 静默失效**。分层门禁保证的是「base 自闭合」和「base+console 自闭合」,
|
|
35
|
+
> 单独一个 console 不成立。
|
|
36
|
+
|
|
37
|
+
**这一层解决的真问题**:消费方为了拿到派生层,历史上会把库的整份 token 抄进本地
|
|
38
|
+
转发(console-web 就抄了 337 个),于是库改值被本地重复声明压死、每次升级都要重复
|
|
39
|
+
一遍撤除动作(见 CHANGELOG 0.10.0 与 qa#615)。按需只引一层之后,抄整份的动机就没了。
|
|
40
|
+
|
|
5
41
|
## 总则
|
|
6
42
|
|
|
7
43
|
- **只用 token,不写硬编码。** 任何颜色/字号/圆角/间距/阴影都走 `var(--mg-*)`;禁止裸 hex / 裸 px(语义状态色 green/red/yellow 例外,但也应走 `--mg-success/-warning/-error`)。
|