Kailash · Foundation Library v1

神山秘境 · 基础库 — 可检索目录

换样式、换页面时先检索、再选用:命中即复用,未命中才新建并回写目录。 三层资产(令牌 / 组件 / 动效)+ 注册表纪律 + A 端主题覆盖,构成标准工程处置方式(Design Tokens + Component Registry + Motion Registry)。 标 A端 的条目可在管理后台按目的地覆盖取值。

🎨 在线换肤预览器 → 实时看「暖金 → 冷蓝」主题覆盖,证明改版只换值不换系统
L0

令牌层 Tokens

颜色/间距/圆角/阴影/字号/时长/曲线。唯一数值来源,改一处全站生效。

app.wxss · styles/vi-tokens.wxss · styles/motion.wxss
L1

组件层 Components

DSL 契约块:props 白名单 + 数据 source + 动作 + 降级策略。未实现类型被引用 = 构建失败。

components/registry.ts · components/modules/m-*
L2

动效层 Motion

九式注册表:三问(从哪来/变成什么/去哪)+ 可调参数 + wxss/wxml/ts 导出。

v3-动效库-2026-09-25.html(MotionLab.register)
A端

主题覆盖 Theme

令牌按目的地分组存 A 端配置,运行时注入 CSS 变量覆盖默认值;组件 props 走既有 DSL 配置链。

destinations.theme_override → page style 注入

工程纪律(标准处置方式)

  1. 先检索后动手:新建任何样式/组件/动效前,先在本目录搜中文关键词或 token id;命中 = 复用,禁止平行造轮子。
  2. 数值只住在令牌层:组件与页面 wxss 一律 var(--…) 引用,禁止硬编码 hex/px/ms(既有 16 页已消费 var,23 页中其余待收敛)。
  3. 新增走注册表:组件进 registry.ts(props/sources/actions/fallback 契约);动效进 MotionLab.register;令牌进三个 wxss 之一并写注释说明。
  4. 回写目录:任何新增/改名/废弃,重跑 build-catalog 生成 catalog.json 并同步本浏览器页,保持目录与代码同源。
  5. A 端覆盖不碰代码:换肤/换目的地样式 = 改 A 端 theme_override 的令牌值,运行时注入;不改 wxss、不发版。
  6. 废弃不删先标:条目加 deprecated 标记并保留一版,避免线上页面断引用(参照 registry.ts 的 fallback 语义)。
业界标准本库对应现状
Design Tokens(W3C DTCG 草案)L0 令牌层 + catalog.json(机器可读)80 条已入库;待补 DTCG $value/$type 结构以对接 Style Dictionary
Component Library + 契约注册表L1 registry.ts + modules/15 类契约全 implemented=true,A 端 DSL 已在消费
Motion System(Material motion 思路)L2 动效库九式9 式注册,参数可调 + 三格式导出
Theming(多品牌/多租户)A 端 theme_override 注入机制设计完成,待接 A 端配置模型(波波域)
Docs site(Storybook 类)本浏览器页 + 动效库 demo已可用(单文件、离线)