@aurea-uds/tokens

中文文档
0.62.1发布于 2026/11/08Apache-2.0TypeScriptCommonJS零依赖近 30 天下载 6646

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

中文使用文档
文档目录6 节
  1. 斧头
  2. 密度合同-实际变化
  3. 主题合同——和不对称,目的
  4. 单位: 所有应该遵循文本的内容的雷姆
  5. 没人用过
  6. 连锁店

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

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

计数活在 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 共发布 78 个版本,首次发布于 2026/07/31;过去 12 个月发布了 78 个版本。

版本发布日期距今
0.62.1latest2026/11/08今天
0.62.02026/11/08今天
0.61.02026/11/071 天前
0.59.02026/11/071 天前
0.56.02026/11/052 天前
0.54.12026/11/044 天前

关于 @aurea-uds/tokens 的常见问题

@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 和提交记录判断。