{
  "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，再重新生成文档站"
    ]
  }
}