@ gener8v/ 托肯斯
GENER8V设计系统真相之源. 仓库里的一切 从这里的一个文件生成 .
npm i @gener8v/tokens # public on npm, MIT
import tokens from '@gener8v/tokens';
tokens['--color-action']; // '#1547B7'
tokens['--control-h-md']; // '44px'
@import '@gener8v/tokens/styles.css'; /* the whole stylesheet, if not using @gener8v/ui */
产生什么
src/theme.mjs 是任何人编辑的唯一文件. pnpm build:tokens 粉丝出来:
src/theme.mjs
├──▶ design/styles.css the only stylesheet — tokens + component layer
├──▶ packages/tokens/styles.css the same sheet, shipped in this package
├──▶ dist/tokens.{mjs,d.ts,json} the same values as JS, for logic and tests
├──▶ design/theme.json machine-readable record of the parameters
├──▶ design/_adherence.oxlintrc.json lint config a consuming repo can enforce
├──▶ packages/tailwind-preset/theme.css the same values as Tailwind utilities
├──▶ figma/plugin/tokens.json DTCG, for the Figma generator
├──▶ design/foundations/*.html the foundations pages, from the real values
├──▶ design/index.html the home page
└──▶ skills/…/references/components.md the class index the Claude skill reads
永远不要手动剪辑. CI 重建并失败, 如果生成的文件不同, 所以 a
手版无法到达 main。变化 src/theme.mjs,或 CSS 中的组件
src/components/并重建.
这里有什么
| 文件 | 它所持有的 |
|---|---|
src/theme.mjs | 调色板指针、字体、密度、半径、空间和类型、控制高度 |
src/color.mjs | OKLCH引擎——坡道生成,游戏绘图,WCAG对比. 无依赖关系 |
src/base.css | 重置、基础打字、焦点环、布局原始、大气设施 |
src/components/*.css | 组件层 每个家族一个文件. zz-adaptive.css 它有强迫的颜色和打印功能 |
build.mjs | 缩写符,样式表,主题.json, 遵守配置 |
build-pages.mjs | 提供基础网页、主页、反应灵敏的利用和技能参考 |
斜道怎么运作
每个坡道都是在OKLCH中以一个共同的感光尺度生成的,所以同一步 任何坡道都具有相同的视觉重量。 有两个细节是负载的:
中性染色体向暗处上升. --color-neutral-100 几乎为白色,而
-900 这很酷 光线接口不会被读取为未设计
默认灰色。 它和口音坡道不一样,不是疏忽.
动作不用重音 . --color-action 坡道700级(#1547B7) (中文(简体) ). 口音 口音
#2563EB 用于焦点环、链接和大气层。 一个间接就是阻止
界面读取为默认框架蓝色,它将主按钮放入了8.02:1.
词汇
| 组 | 名称 |
|---|---|
| 作用 | --color-bg --color-surface --color-text --color-accent --color-accent-2 --color-divider |
| 行动 | --color-action --color-action-hover --color-action-active |
| 倾斜 | --color-{neutral,accent,accent-2}-{100…900} |
| 状态 | --color-{success,warning,danger} + 键 -{100,300,700,800} —— 说 保留从不装饰 |
| 图表序列 | --series-1 . --series-8 固定订单,从未循环 |
| 类型 | --font-{heading,heading-weight,body,mono} --text-* --leading-* --tracking-* |
| 空间 | --space-{1…32} - 这个名字是4px的倍数,所以 --space-12 为 48px |
| 控件 | --control-h-{xs,sm,md,lg,xl} ——按钮、输入和选择共享这些 |
| 半径 | --radius-{xs,sm,md,lg,full} |
| 电梯 | --shadow-{sm,md,lg} |
| 动议 | --ease-out --ease-in-out --dur-{fast,base,slow} |
缩放为 作者, 未计算。在任何地方都没有分数像素值——a
以前的版本将一个基乘以密度系数并生成 14.4px,这就是如何
系统开始寻找 未经考虑.
改变外观
编辑 src/theme.mjs运行 pnpm check如果改变的话,两道门会跟你争论
不安全 : lint:contrast 未在 WCAG 2.2 AA 下根据
真正的坡道,和 lint:palette 重新运行图表序列上的数据维兹验证器 ——
包括检查所记录的散射和地图格式的三号编上限是否仍然
没错.
这就是大门的位置。 颜色改变会打破色盲分离 响亮的失败,不是飞船.