@upmo-ai/tokens

中文文档
1.0.0-rc.1发布于 2026/11/03AGPL-3.0-onlyTypeScriptES Module零依赖

Upmo设计标记:用于浅色、深色和高对比度主题的CSS变量,以及每个值的类型化对象。

中文使用文档
文档目录3 节
  1. 使用
  2. 设计方向
  3. 构建

@upmo-ai /令牌

Upmo设计符号:颜色、字体、间距、 半径,阴影,大小,断点,z-index和运动。由 tokens.json 分成三个工件:

  • dist/tokens.css 的CSS自定义属性 light, dark 和 hc (高对比度)主题,范围由 :root 和 [data-theme="..."],再加上 排版工具类(.body, .h1, .code等)。每种类型风格 也是一套吗 :root 变量: --text-<style>-size, -line, -weight 在样式设置字母间距的地方, -tracking (例如 --text-body-size: 15px, --text-overline-tracking: 0.06em)。
  • dist/tokens.js + dist/tokens.d.ts -每个值的类型JS对象, 每个主题,当CSS变量不够时(图表,画布,JS逻辑)。
  • dist/tokens.json -原始源代码,为模具复制。

没有React,没有运行时依赖。

使用

import '@upmo-ai/tokens/tokens.css';
import { color, spacing, motion } from '@upmo-ai/tokens';

color['emerald-deep'].light; // "#176b47"
motion['duration-sweep'];     // "1600ms"

在根元素上设置主题:

<html data-theme="dark"> ... </html>

设计方向

  • True-neutral理由。 坡道式,业务和数据密集。边界带 结构;阴影只能提升浮动层。翡翠是一种文雅的口音, 从来没有一个表面填充。
  • 状态/活跃音调。 中性/主动/积极/注意/ 至关重要的。活插入符号(工作,检查)在 duration-sweep 循环并折叠为一个静态绘制的插入符号 运动。
  • 访问层。 正文在声明的基础上清除4.5:1;控制 边缘和大/图标颜色清晰3:1;在光明和黑暗中验证。这个 高对比度主题进一步提升了一切。

构建

pnpm --filter @upmo-ai/tokens build

版本与发布记录

@upmo-ai/tokens 共发布 2 个版本,首次发布于 2026/11/03;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.0-rc.1latest2026/11/03今天
0.0.0-stage2026/11/03今天

关于 @upmo-ai/tokens 的常见问题

@upmo-ai/tokens 是什么?

Upmo设计标记:用于浅色、深色和高对比度主题的CSS变量,以及每个值的类型化对象。

如何安装 @upmo-ai/tokens?

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

@upmo-ai/tokens 支持 TypeScript 吗?

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

@upmo-ai/tokens 支持 ESM 还是 CommonJS?

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

@upmo-ai/tokens 可以商用吗?

@upmo-ai/tokens 使用 AGPL-3.0-only 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@upmo-ai/tokens 还在维护吗?

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