# @aurea-uds/tokens 中文文档

规范地址：https://npmcn.com/package/%40aurea-uds/tokens/

版本：0\.62\.1
npm 元数据更新时间：2026-11-08T12:09:11.019Z
中文译文更新时间：2026-11-08T12:10:14.933Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aurea-uds/tokens
原文对照：https://npmcn.com/package/%40aurea-uds/tokens/?lang=original
项目主页：https://github.com/victor1mor/aurea-uds/tree/main/packages/tokens#readme
源码仓库：https://github.com/victor1mor/aurea-uds

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：472 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-31T11:22:11.823Z
- 最新版本发布：2026-11-08T12:09:10.830Z
- 近 30 天下载量：6646（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

Os sorders da Aurea UDS: a fontite em DTCG e as variáveis CSS geradas dela. 中国植物物种信息数据库.

## 安装

```sh
npm install @aurea-uds/tokens
```

也可以使用：`pnpm add @aurea-uds/tokens`、`yarn add @aurea-uds/tokens`、`bun add @aurea-uds/tokens`

## README

# Aurea基金会——什么是象征,什么不是

官方回答是"哪个轴控制了这个值".

计数活在 [`STATE.md`](https://github.com/victor1mor/aurea-uds/blob/main/STATE.md),生成和 检查。 这个文件有规矩.

* * *

## 斧头

| 轴 | 键 | 单位 | 页:1 |
| --- | --- | --- | --- |
| 颜色 | `--<semantic>`, (中文(简体) ), `--<family>-<step>` | oklch / 十六进制 | 语义符号是第一位的;坡道步骤是用来建造语义符号,而不是直接使用 |
| 空间 | `--space-0` . `--space-24` | 对 | 缩略图故意跳过值——不是每个整数都存在 |
| 类型大小 | `--text-xs` . `--text-7xl` | 对 |  |
| 类型家庭 | `--font-ui`, (中文(简体) ), `--font-heading`, (中文(简体) ), `--font-editorial`, (中文(简体) ), `--font-code` | —— 说 | Inter / Sora (每个h1到h6) / Inter (化名, 在 1.0 中去除) / IBM Plex Mono |
| 类型重量 | `--weight-regular` . `--weight-extrabold` | 编号 |  |
| 线高 | `--leading-none` . `--leading-relaxed` | 编号 | `--leading-none` 对于HEGHT是合同组成部分的组件存在 |
| 字母间隔 | `--tracking-tight` . `--tracking-widest` | 计划 |  |
| 半径 | `--radius-xs` . `--radius-card`, (中文(简体) ), `--radius-sheet`, (中文(简体) ), `--radius-control` | ưμ㼯a | `--radius-card` (22页x), `--radius-sheet` (32px,从下起起的表)和 `--radius-control` (999px)是身份——检查 |
| 边框 | `--border-width` | ưμ㼯a |  |
| 阴影 | `--shadow-sm`, (中文(简体) ), `--shadow-md`, (中文(简体) ), `--shadow-lg` | 阴影 |  |
| 层 | `--z-sticky` . `--z-toast` | 编号 | 因为叠叠叠。 当地人 `z-index: 1/2/3` 组件内不是此轴 |
| 动议 | `--duration-*`, (中文(简体) ), `--ease-*` | 持续时间/ 曲线 |  |
| 图标大小 | `--icon-sm` . `--icon-xl` | 对 | 以雷姆为单位,所以文字跟随文字 |
| 触摸目标 | `--target-min` | 对 | 44px带有16px根-WCAG 2.5/2.5.8 |
| 断点 | `--breakpoint-2xs` . `--breakpoint-2xl` | ưμ㼯a | `@media` 无法读取 `var()`,因此CSS重复每个断点 `em` (它跟随浏览器的字体大小)和一个建置检查守护大小 |
| 密度 | 见下文 | 对 |  |

**这些轴上的新值来自一个符号.** 核心中的原始值为每 轴对基线:计数可能会下降,永远不会上升.

* * *

## 密度合同-实际变化

`data-density="compact | comfortable | spacious"` 变动 **十一岁** 标志,只有那些:

`--control-h-xs`, (中文(简体) ), `--control-h-sm`, (中文(简体) ), `--control-h-md`, (中文(简体) ), `--control-h-lg`, (中文(简体) ), `--control-h-xl`, (中文(简体) ), `--touch-control-h-sm`, (中文(简体) ), `--touch-control-h-md`, (中文(简体) ), `--touch-control-h-lg` (当地人的控制高度) 触摸目标, `--row-h`, (中文(简体) ), `--card-pad`, (中文(简体) ), `--section-gap`。 。 。 .

换言之:密度变化 **控制高度、 表格行高、 加卡和空格 节次**。 。 。 .

没错 **没有** 更改, 目的: 类型大小、 一般空间尺度、 排版缺口、 弧度、 图标大小 或线高. 密度是指控件的相距有多近,而不是第二个类型尺度.

每一个控制者都必须从 `--control-h-*`。 。 。 . `tests/visual/geometry.spec.ts` 检查这个.

* * *

## 主题合同——和不对称,目的

`data-theme="dark | light"`暗是底;光会覆盖它.

两个主题是: **没有** 完全对称,这是例外: 光能覆盖三种颜色 底值为暗叶- `warning-500`, (中文(简体) ), `oracle-300` 财务报告和审定财务报表 `oracle-400`。在暗处没有未定义的内容: 这些符号继承了基础值, 所以没有缺少值 .

特性在主题之间没有变化:主要黄色是 `oklch(0.795 0.184 86.047)` 两者,以及 建造失败了 不仅在符号名称上.

* * *

## 单位: 所有应该遵循文本的内容的雷姆

类型、空间、图标大小、控制高度、侧边栏宽度和上边栏高 **对**这样一个人谁 扩展浏览器的文本得到更大的控制而不是被剪接的文本(WCAG 1.4.4). 转换 从 px( px-% 16) 完全正确, 因此默认根大小没有移动 .

Radii 留在这 **ưμ㼯a**:角是一个物理形状,而不是文字,用文字来缩放 胶囊停止做胶囊.

* * *

## 没人用过

并非每个符号都被核心引用. 这不是自动浪费:

| 组 | 为什么它存在 |
| --- | --- |
| `--breakpoint-*` | `@media` 无法读取 `var()`。CSS 重复数字 和一个建置检查 守门员对天平 |
| `--oracle-*` | 仅由 `apps/docs/docs.css`。 。 。 . `oracle` 是应用程序的词汇,而不是系统词汇,它们随网页一起消失 |
| 斜坡阶梯 | 语义学家族的中间步骤, 保存这样一个消费者可以构建一个变体 |

**规则:** 符号来自一种用途,而不是一个看起来完整的尺度。 没用的托克 任何地方都被删除,需要的东西被创造出来.

重复是参考文献,而不是副本 : `--radius-full` 实值 `{radius-control}`,所以这两个名字不能 分别. 手书上写着相同号码的两道道道具 在其中之一调整的那天就不同了.

* * *

## 连锁店

`packages/core/dist/aurea.css` 将符号包起来 **财务报告和审定财务报表** cSS 中组件 `@layer aurea`编辑 消费者自己的CSS,没有一层的写出,无论选择者的特殊性如何,都胜过库. 没有 `!important`没有特定的狩猎.

道具坐于地层以内,与地心并出而外出. 自定义属性 **声明** 和任何其他人一样在级联中竞争: `:root` 覆盖 核心在媒体查询中声明损失到基准值,侧边栏跳出48px。 应用程序 重新定义一个没有层次的符号 `:root` 仍然胜过两者.

## 常见问题

### @aurea-uds/tokens 是什么？

Os sorders da Aurea UDS: a fontite em DTCG e as variáveis CSS geradas dela\. 中国植物物种信息数据库\.

### 如何安装 @aurea-uds/tokens？

在项目目录运行 npm install @aurea-uds/tokens，或使用 pnpm add / yarn add / bun add。

### @aurea-uds/tokens 支持 TypeScript 吗？

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

### @aurea-uds/tokens 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aurea-uds/tokens 可以商用吗？

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

### @aurea-uds/tokens 的下载量有多少？

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

### @aurea-uds/tokens 还在维护吗？

最新版本 0\.62\.1 发布于 2026/11/08（今天）；至今共发布 78 个版本，其中过去 12 个月发布了 78 个；首次发布于 2026/07/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。