refactor(design-tokens): 全量体系化重建设计令牌
Primitive + Semantic 双层令牌架构,HEX->HSL,明暗双份,@theme inline 暴露为 Tailwind 类。 - 新建 src/app/styles/tokens/ 6 个令牌文件(primitive/semantic-light/semantic-dark/lesson-preparation/tailwind-theme/index) - globals.css 改为 @import 引入,477->258 行 - 清理 91 处 #hex 硬编码颜色 -> hsl(var(--*)) - 清理 10 处硬编码字体 -> var(--font-family-*) - 清理 100 文件 Tailwind 任意值(Tier 1 映射/Tier 3 注释豁免) - 清理 M3 Surface 死代码,升级 --lp-* 令牌(HEX->HSL + 暗色补全) - 新建 ESLint 自定义规则 no-hardcoded-design-tokens(单词边界正则) - eslint.config.mjs 新增 no-restricted-syntax 禁止 #hex + 自定义规则加载(pathToFileURL) - 项目规则新增设计令牌规范强制章节 - 架构图 004/005 同步设计令牌体系节点 - known-issues.md 追加设计令牌问题分类(7 个规则表) 验证: tsc --noEmit 0 errors, npm run lint 0 errors/12 warnings(均为既有问题)
This commit is contained in:
70
eslint-rules/no-hardcoded-design-tokens.js
Normal file
70
eslint-rules/no-hardcoded-design-tokens.js
Normal file
@@ -0,0 +1,70 @@
|
||||
// eslint-rules/no-hardcoded-design-tokens.js
|
||||
// 检测 TSX/TS 中硬编码的字体家族字面量(Inter/Fraunces/JetBrains Mono)
|
||||
// 白名单:src/app/styles/tokens/primitive.css(令牌定义)、email-channel.ts、manifest.ts
|
||||
// 使用单词边界匹配,避免误判 Interval/Interactive/Interrupt 等含 Inter 子串的标识符
|
||||
|
||||
const FORBIDDEN_FONTS = ['Inter', 'Fraunces', 'JetBrains Mono'];
|
||||
const WHITELIST_FILES = [
|
||||
'eslint-rules/no-hardcoded-design-tokens.js',
|
||||
'src/app/styles/tokens/primitive.css',
|
||||
'src/modules/notifications/channels/email-channel.ts',
|
||||
'src/app/manifest.ts',
|
||||
];
|
||||
|
||||
// 为每个字体名构建单词边界正则:\bInter\b 匹配 "Inter" 但不匹配 "Interval"
|
||||
const FORBIDDEN_PATTERNS = FORBIDDEN_FONTS.map((font) => ({
|
||||
font,
|
||||
regex: new RegExp(`\\b${font}\\b`),
|
||||
}));
|
||||
|
||||
module.exports = {
|
||||
meta: {
|
||||
type: 'problem',
|
||||
docs: {
|
||||
description: '禁止硬编码字体家族字面量,使用 var(--font-family-sans/serif/mono)',
|
||||
category: 'Best Practices',
|
||||
recommended: true,
|
||||
},
|
||||
messages: {
|
||||
forbiddenFont:
|
||||
'禁止硬编码字体家族 "{{font}}",使用 var(--font-family-sans/serif/mono) 或 var(--font-family-mono)',
|
||||
},
|
||||
schema: [],
|
||||
},
|
||||
|
||||
create(context) {
|
||||
const filename = context.getFilename().replace(/\\/g, '/');
|
||||
if (WHITELIST_FILES.some((f) => filename.endsWith(f))) {
|
||||
return {};
|
||||
}
|
||||
|
||||
return {
|
||||
Literal(node) {
|
||||
if (typeof node.value !== 'string') return;
|
||||
for (const { font, regex } of FORBIDDEN_PATTERNS) {
|
||||
if (regex.test(node.value)) {
|
||||
context.report({
|
||||
node,
|
||||
messageId: 'forbiddenFont',
|
||||
data: { font },
|
||||
});
|
||||
break;
|
||||
}
|
||||
}
|
||||
},
|
||||
TemplateElement(node) {
|
||||
const raw = node.value.raw;
|
||||
for (const { font, regex } of FORBIDDEN_PATTERNS) {
|
||||
if (regex.test(raw)) {
|
||||
context.report({
|
||||
node,
|
||||
messageId: 'forbiddenFont',
|
||||
data: { font },
|
||||
});
|
||||
break;
|
||||
}
|
||||
}
|
||||
},
|
||||
};
|
||||
},
|
||||
};
|
||||
Reference in New Issue
Block a user