@hanzo/tokens

中文文档
1.1.3发布于 2026/11/13MITTypeScriptESM + CJS零依赖近 30 天下载 1.3万

Hanzo UI的设计符号:颜色、间隔、光度、打字、主题

中文使用文档

@hanzo/托肯斯

汉藏设计符号的单一真理来源——颜色,半径,类型, 间距 - 每个 表面。 反应读取 TypeScript; 非反应表面( a) Gitea分叉,一个Go仪表板,一个Argo CD分叉)嵌入了生成的CSS. 一个编辑 到处宣传.

花佐的染色体为单色:一色通过不透明阶梯,默认为暗色. 铬中只有各州(--state-error, (中文(简体) ), --state-warning, (中文(简体) ), --state-online, (中文(简体) ), --state-success) (中文(简体) ). 类型为" Zen"+" Zen"单",出自@hanzo/font.

数据是一个例外,范围是: src/data.ts 是二十六个调色板 十二步胡同( s)--data-<hue>-<step>) 对于一个人的颜色——一个选择选项的 标记,一个 kanban 列,一个对象的图标平板,一个外形的初始,一个图表序列. 从来不是按钮,边框或焦点环. 21个可摘的二十个 hu和所有5个中性为Radix Clors天平; hueOf(seed) 选择 唱片的呼声来自一个稳定的字符串散列, 所以唱片保持它的颜色任何地方 它被绘制或导入.

输油管

src/theme.ts   ──gen-css──▶  dist/colors.css   ──▶  @hanzo/design/tokens/colors.css ──▶ styles.css
 (the source)                dist/tokens.css    ──▶  @hanzo/brand/styles/variables.css ──▶ git/ci/cd
  • src/theme.ts 持有每种颜色的符号( e)dark → :root, (中文(简体) ), light → .light+ 半径/ 类型/ 间距 scale。数值是原始 CSS 字符串,所以 var() 参考书目仍为参考书目,所排放的捆绑是消费者 已经上船了 这是编辑一个值的 ONE 位置 .
  • scripts/gen-css.mjs 读取已建 dist/theme.mjs 并发出:
    • dist/colors.css ——只使用彩色符号(@hanzo/tokens/css/colors; 计 数 合同 @hanzo/design 换了.
    • dist/tokens.css ——颜色+半径+类型+间隔+数据调色板 (单位:千美元)@hanzo/tokens/css; 何为 @hanzo/brand 为 Go 表面重现 .
    • dist/data.css 单是数据调色板(@hanzo/tokens/css/data) (中文(简体) ). 不进去 colors.css,其设计重排为铬合同.
  • @hanzo/ui 编曲 data.css 输入主题.cs,以及每个符号 软件包声明 @ hanzo/ deign' set 尚未发货 — 因此添加了一个符号 在此到达组件之前, 设计组下一次复制它.
  • themes.ts 编号 : colors.ts 是 JavaScript 消费者的解析平坦视图 无法调试 var()镜像 theme.ts。 。 。 .

重新生成

pnpm --filter @hanzo/tokens gen-css

流程:编辑 src/theme.ts → gen-css → @hanzo/design 财务报告和审定财务报表 @hanzo/brand 牵出 下个生成的 CSS gen编号 :build – gi / ci / cd 把它捡起来. gen-css 运行为 build (和 prepublish),所以出版的包 总是船 当前 CSS.

版本与发布记录

@hanzo/tokens 共发布 9 个版本,首次发布于 2026/03/23;过去 12 个月发布了 9 个版本。

版本发布日期距今
1.1.3latest2026/11/134 天前
1.1.22026/11/134 天前
1.1.12026/10/2127 天前
1.1.02026/10/1928 天前
1.0.42026/10/021 个月前
1.0.32026/10/021 个月前

关于 @hanzo/tokens 的常见问题

@hanzo/tokens 是什么?

Hanzo UI的设计符号:颜色、间隔、光度、打字、主题

如何安装 @hanzo/tokens?

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

@hanzo/tokens 支持 TypeScript 吗?

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

@hanzo/tokens 支持 ESM 还是 CommonJS?

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

@hanzo/tokens 可以商用吗?

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

@hanzo/tokens 的下载量有多少?

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

@hanzo/tokens 还在维护吗?

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