# @basiiik/tokens 中文文档

规范地址：https://npmcn.com/package/%40basiiik/tokens/

版本：0\.8\.0
npm 元数据更新时间：2026-10-27T21:04:11.245Z
中文译文更新时间：2026-11-08T02:41:29.344Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40basiiik/tokens
原文对照：https://npmcn.com/package/%40basiiik/tokens/?lang=original
项目主页：https://basiiik.pages.dev/

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

- 包体积（解压后）：223 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-10-17T09:53:53.355Z
- 最新版本发布：2026-10-27T21:04:11.051Z
- 近 30 天下载量：1928（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Basiek 以 DTCG 2025.10 为格式设计符号,并有已准备好的 CSS 变量(Light, Dark)和 JS/TS 常数.

## 安装

```sh
npm install @basiiik/tokens
```

也可以使用：`pnpm add @basiiik/tokens`、`yarn add @basiiik/tokens`、`bun add @basiiik/tokens`

## README

# @ basiik/ 键

巴斯克设计标志,在 [DTCG 2025。 10](https://www.designtokens.org/) 格式,包含随时可用的CSS变量和JS/TS常数. 单独用于任何框架; `@basiiik/ui` 捆绑同样的CSS.

```bash
npm install @basiiik/tokens
```

## 使用 CSS 软件

```css
@import '@basiiik/tokens/tokens.css';        /* Light, on :root */
@import '@basiiik/tokens/tokens.dark.css';   /* Dark, on [data-theme="dark"] */
/* or follow the OS instead: */
@import '@basiiik/tokens/tokens.dark-media.css';
```

```css
.card { background: var(--color-bg-surface); color: var(--color-text-primary); padding: var(--spacing-4); border-radius: var(--radius-lg); }
```

偏爱 **语义** 指针( a)`--color-bg-*`, (中文(简体) ), `--color-text-*`, (中文(简体) ), `--color-border-*`, (中文(简体) ), `--color-icon-*`:它们与主题切换. 核心标志`--color-gray-500`没有.

## 使用常数

```ts
import { ColorBrand600 } from '@basiiik/tokens';
```

## 从自己的原始人开始

`dtcg/` 持有源 : `core/*.json` (原始内容)和 `semantic/light.json` + 键 `dark.json` (68个语义颜色,别名为核心). 替换品牌缩放 `core/color.json`,用 [样式词典](https://styledictionary.com/),每个语义符号都随之而来.

```js
import tokens from '@basiiik/tokens/dtcg/semantic/light.json' with { type: 'json' };
```

许可证:麻省理工学院.

## 常见问题

### @basiiik/tokens 是什么？

Basiek 以 DTCG 2025\.10 为格式设计符号,并有已准备好的 CSS 变量\(Light, Dark\)和 JS/TS 常数\.

### 如何安装 @basiiik/tokens？

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

### @basiiik/tokens 支持 TypeScript 吗？

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

### @basiiik/tokens 支持 ESM 还是 CommonJS？

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

### @basiiik/tokens 需要什么版本的 Node\.js？

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

### @basiiik/tokens 可以商用吗？

@basiiik/tokens 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @basiiik/tokens 的下载量有多少？

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

### @basiiik/tokens 还在维护吗？

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