@bysages/tokens

中文文档
0.6.0发布于 2026/11/07MITTypeScriptES Module零依赖近 30 天下载 1926

为 By Sages Elements 所设计符文 — DTCG 源编译为 CSS 变量和 JavaScript : 地表坡道, 从光, 密度级, 主题

中文使用文档
文档目录5 节
  1. 特征
  2. 安装
  3. 快速启动
  4. 重建
  5. 许可证

@ bysages/ tokens

npm version npm downloads npm license

由"圣贤元素"的设计标志—— 技术合作组 源用样式词典编译为 CSS 自定义属性和类型Script 类型。 系统中唯一允许的视觉值来源.

特征

  • 🎨 两级 ——组件实际消耗的原始活字(原始调色板,类型坡道,间隔)和语义符号(地表梯子,墨水,边框,高地,运动)
  • 🌗 主题维度作为数据 ——轻/暗模式,矿坑口音(清华/celadon/zhusha),固定语义颜色(bamboo/ochre/cinnabar/超海洋),4个密度级,对比级,场景预设
  • 💡 发光意识高地 ——从 --bs-light-x 编号 : --bs-light-reach 部件,从不复制,所以光源也是变量
  • 📦 三项产出 - 编译的样式表(@bysages/tokens/css,符号树作为数据(.语义层作为JS(./styles(中文(简体) )
  • 🔤 有声音的打字法 ——"歌词"标题,"hei-sans"UI染色体,CJK标签跟踪——为"中国×西方"注册的双轨堆

安装

# pnpm
pnpm add @bysages/tokens

# npm
npm install @bysages/tokens

# yarn
yarn add @bysages/tokens

# bun
bun add @bysages/tokens

快速启动

将编译的样式表一次导入到 app root 上 – 每个符号块作为 CSS 自定义属性 :root数字 :

import "@bysages/tokens/css";

然后在任何地方消费标志物——这是合同中的每个组件样式如下:

.card {
  background: var(--bs-color-surface-2);
  border: 1px solid var(--bs-color-border);
  border-radius: var(--bs-radius-lg);
  box-shadow: var(--bs-elevation-1);
  padding: var(--bs-space-4);
}

重建

符号在构建时编译( I)node scripts/build.mjs(三); pnpm dev 在软件包根表和再编译中。 单列的消费者读取汇编 dist,所以在这里重建 之前,他们的改变 取出新的符号.

许可证

版本与发布记录

@bysages/tokens 共发布 17 个版本,首次发布于 2026/09/16;过去 12 个月发布了 17 个版本。

版本发布日期距今
0.6.0latest2026/11/072 天前
0.5.02026/11/036 天前
0.4.42026/10/1921 天前
0.4.32026/10/1525 天前
0.4.22026/10/1327 天前
0.4.12026/10/1129 天前

关于 @bysages/tokens 的常见问题

@bysages/tokens 是什么?

为 By Sages Elements 所设计符文 — DTCG 源编译为 CSS 变量和 JavaScript : 地表坡道, 从光, 密度级, 主题

如何安装 @bysages/tokens?

在项目目录运行 npm install @bysages/tokens,或使用 pnpm add / yarn add / bun add。

@bysages/tokens 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bysages/tokens 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bysages/tokens 可以商用吗?

@bysages/tokens 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bysages/tokens 的下载量有多少?

根据 npm 官方下载统计,@bysages/tokens 在 2026/10/09 – 2026/11/07 这 30 天内被下载 1,926 次,日均约 64 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bysages/tokens 还在维护吗?

最新版本 0.6.0 发布于 2026/11/07(2 天前);至今共发布 17 个版本,其中过去 12 个月发布了 17 个;首次发布于 2026/09/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。