@oods/tokens

中文文档
0.11.3发布于 2026/11/02Apache-2.0TypeScriptESM + CJS零依赖

为OODS Foundry设计标记:其品牌在浅色,深色和高对比度主题中的CSS变量和JavaScript值。

中文使用文档
文档目录4 节
  1. 安装
  2. 第一个结果
  3. 限制
  4. 许可证

@oods /令牌

OODS组件使用的CSS变量和JavaScript令牌值。内置包包含发货品牌及其光,暗和高对比度范围。没有运行MCP服务器。

安装

npm install @oods/tokens

第一个结果

在基于绑定器的应用中,只需要导入一次样式表,然后在文档中选择一个作用域:

import '@oods/tokens/css';
document.documentElement.dataset.brand = 'A';
document.documentElement.dataset.theme = 'light';

在CSS中使用语义角色:

body {
  background: var(--sys-surface-canvas);
  color: var(--sys-text-primary);
}

对于JavaScript值:

import tokens from '@oods/tokens';
console.log(tokens.cssVariablesByScope.A.light['--oods-sys-surface-canvas']); // oklch(1 0 286)

作用域适用于任何元素,而不仅仅是文档:一个有自己的面板 data-brand 和 data-theme 获得该品牌和主题的角色,因此黑暗预览可以坐在一个明亮的页面。

样式表还声明了三种字体的标记名称:Geist、Geist Mono和DM Sans。他们的文件传送过来 dist/fonts 从旁边的样式表加载,永远不要从网络;浏览器只会为使用家族的文本获取一个。Vite用样式表复制它们;Esbuild需要一个加载器(--loader:.woff2=file),并webpack一个资源规则 .woff2.

cssVariablesByScope 保存每个品牌和主题的每个变量,并解析其值,以其全名为关键字,以 --oods-. 样式表使用短名称: --oods-sys-surface-canvas 在JavaScript中是值 var(--sys-surface-canvas) 需要下 data-brand="A" 和 data-theme="light".

@oods/tokens/brands 导出此构建中的品牌。 @oods/tokens/tailwind 导出构建的JSON令牌有效负载;它不会为您安装或配置顺风。

要将您的颜色代币转换为OODS Foundry品牌,请使用 brand_create 通过 @oods/foundry 它已经发货了 QUICKSTART.md. 为该品牌生成的应用带有一个单独的样式表,其中包含自定义作用域。

限制

生成的应用锁定生成它们的OODS版本;要升级,请重新生成应用程序或将所有四个引脚移到一起。这些包与本地MCP服务器是分开的, @oods/foundry.

许可证

Apache License 2.0。看到 许可证 和 请注意. Geist、Geist Mono和DM Sans字体文件采用SIL开放字体许可证1.1,颜色校准源自Radix Colors (dist/radix-calibration.json)受MIT授权;“通知”带有这些许可以及文件的来源。生成的输出属于其用户;已安装的包依赖项保留其自己的许可证。

版本与发布记录

@oods/tokens 共发布 25 个版本,首次发布于 2026/09/26;过去 12 个月发布了 25 个版本。

版本发布日期距今
0.11.3latest2026/11/021 天前
0.11.22026/10/1123 天前
0.11.12026/10/1023 天前
0.11.02026/10/0925 天前
0.10.22026/10/0925 天前
0.10.12026/10/0825 天前

关于 @oods/tokens 的常见问题

@oods/tokens 是什么?

为OODS Foundry设计标记:其品牌在浅色,深色和高对比度主题中的CSS变量和JavaScript值。

如何安装 @oods/tokens?

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

@oods/tokens 支持 TypeScript 吗?

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

@oods/tokens 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@oods/tokens 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@oods/tokens 可以商用吗?

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

@oods/tokens 还在维护吗?

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