@aleph-alpha/config-tokens

中文文档
0.2.0发布于 2026/06/18Apache-2.0ES Module近 30 天下载 1.4万

@aleph-alpha/ 配置键

中文使用文档
文档目录7 节
  1. 配置托肯斯
  2. 安装
  3. 使用量
  4. 托肯管线
  5. 发展
  6. 配置托肯斯帮助 UI 自定义
  7. 参考资料

配置托肯斯

@aleph-alpha/ 配置键

Aleph Alpha 前端的设计符,由Figma库出自Tokens Studio和样式词典. 以JSON的形式将所处理的符文曝光,所以其他包可以消耗.

UnoCSS 预设将这些令牌转换为工具类, CSS 变量位于其中 @aleph-alpha/config-unocss嵌入式网络字体(Raleway、Roboto、蒙特塞拉特、Inter) @aleph-alpha/config-fonts。 。 。 .

安装

pnpm add @aleph-alpha/config-tokens

使用量

导入令牌直接设定为 JSON :

import lightModeSet from '@aleph-alpha/config-tokens/sd-output/light-mode.json';
import darkModeSet from '@aleph-alpha/config-tokens/sd-output/dark-mode.json';
import spacingsSet from '@aleph-alpha/config-tokens/sd-output/spacings.json';
import boxShadowsSet from '@aleph-alpha/config-tokens/sd-output/box-shadows.json';
import typographySet from '@aleph-alpha/config-tokens/sd-output/typography.json';

对UnoCSS消费者,使用 @aleph-alpha/config-unocss 相反的——它已经把这些JSON文件接入一个预设的堆栈,其中包含CSS自定义属性,主题映射,以及网页字体.

托肯管线

包裹的目的是把Figma Tokens带过 托肯斯工作室 并把它们转换为下游包可以消耗的JSON文件(UnoCSS预设,MUI调色板,.

建设步骤是:

  1. 设计师将符号更改从 Figma 推到 tokens.json 打开一个MR.
  2. MR合并后,管道会运行并触发建设过程.
  3. 来自 tokens.json 被转换,分为不同类别,并储存在 transformed-tokens 目录为 符号转换器 因此样式词典可以读取. 类别是: light-mode, (中文(简体) ), dark-mode,以及 global。 。 。 .
  4. 转换后的信使用 样式词典 生成符号集 sd-output/。 。 。 .
  5. 消费者(例如:. @aleph-alpha/config-unocss阅读 sd-output/ JSON通过子路径导入.
graph TD
    A[Designer pushes token changes from Figma to tokens.json] --> B[Open MR]
    B --> C{MR merged?}
    C -->|Yes| D[Pipeline runs]
    D --> E[Trigger build process]
    E --> F[Transform and split tokens with token-transformer]
    F --> G[Store transformed tokens in transformed-tokens directory]
    G --> H[Process tokens with style-dictionary]
    H --> I[Store processed tokens in sd-output directory]
    C -->|No| B
    subgraph Token Categories
        F --> F1[light-mode]
        F --> F2[dark-mode]
        F --> F3[global]
    end

发展

pnpm install
pnpm build

配置托肯斯帮助 UI 自定义

读到这里

参考资料

版本与发布记录

@aleph-alpha/config-tokens 共发布 1 个版本,首次发布于 2026/06/18;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.2.0latest2026/06/184 个月前

关于 @aleph-alpha/config-tokens 的常见问题

@aleph-alpha/config-tokens 是什么?

@aleph-alpha/ 配置键

如何安装 @aleph-alpha/config-tokens?

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

@aleph-alpha/config-tokens 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/aleph-alpha__config-tokens 是否存在。

@aleph-alpha/config-tokens 支持 ESM 还是 CommonJS?

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

@aleph-alpha/config-tokens 可以商用吗?

@aleph-alpha/config-tokens 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aleph-alpha/config-tokens 的下载量有多少?

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

@aleph-alpha/config-tokens 还在维护吗?

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