HIsheR
33 lines
1.4 KiB
JSON
33 lines
1.4 KiB
JSON
{
|
|
"name": "@ui-arch/tokens",
|
|
"type": "design-tokens",
|
|
"description": "Single source of design tokens. Skin packages consume CSS variables only - hardcoded colors inside skins are forbidden. Dark theme overrides values under [data-theme='dark'], never names.",
|
|
"tags": [
|
|
"tokens",
|
|
"theme",
|
|
"css-variables"
|
|
],
|
|
"api": {
|
|
"entry": "tokens.css",
|
|
"exports": [
|
|
"tokens.css: import '@ui-arch/tokens/tokens.css' once at app root",
|
|
"tokens.json: programmatic access for tools and agents"
|
|
],
|
|
"keyTypes": [
|
|
"--ua-color-*",
|
|
"--ua-space-*",
|
|
"--ua-radius-*"
|
|
]
|
|
},
|
|
"usage": "import '@ui-arch/tokens/tokens.css'; then use var(--ua-color-accent) etc. in any skin package",
|
|
"docs": {
|
|
"intro": "设计令牌唯一来源：CSS 变量 --ua-* + 同名 JSON。皮肤只允许消费变量，禁止硬编码颜色；暗色只换值不换名。",
|
|
"steps": [
|
|
"引入：在应用入口 import '@ui-arch/tokens/tokens.css'",
|
|
"消费：组件样式一律 var(--ua-color-accent) 这类变量，不写死色值",
|
|
"暗色：根元素设 data-theme=dark，变量值自动切换",
|
|
"扩展：新令牌先同时加进 tokens.css 与 tokens.json，再重新生成文档站",
|
|
"选区：库内文字选区 ::selection 统一为主题色淡底（皮肤包已全局处理），应用侧不必再写"
|
|
]
|
|
}
|
|
} |