@eocrm/design-tokens

中文文档
0.8.16发布于 2026/11/13Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 4798

共享网络和克特林多平台/构成的EOCRM可视化符号. npm包包含生成的 Sass; Maven 文物包含生成的,强烈的打入的 Compose API. 两者的出版版本都与 @eocrm/design-system。 。 。 .

中文使用文档
文档目录5 节
  1. 网页
  2. Kotlin 多平台和编曲
  3. 分数
  4. 捐款
  5. 许可证

@ eocrm/ 设计指针

共享网络和克特林多平台/构成的EOCRM可视化符号. 时间 包中包含生成的 Sass; Maven 文物包含生成的, 强烈打入了 Compose API. 两者的出版版本都与 @eocrm/design-system。 。 。 .

现场操场 (手提箱和部件,从 main: https://eocrm.github.io/design-system/ (中文(简体) )

网页

软件包在 npmjs 上公开( 无) .npmrc 或需要的标志 :

npm install @eocrm/design-tokens

导入光/主题中立的契约和暗主题覆盖:

@use '@eocrm/design-tokens/styles/tokens.scss';
@use '@eocrm/design-tokens/styles/dark.scss';

反应消费者导入编译的 @eocrm/design-system/styles/global.css (或 tokens.css),不需要此软件包;为 Sass 变量安装 或直接合同.

Kotlin 多平台和编曲

GitHub套件甚至对公共的Maven套件也需要认证. 对于 本地开发,使用经典的个人访问符 read:packages· ; 保留 gpr.user 财务报告和审定财务报表 gpr.key 在您的用户级别 ~/.gradle/gradle.properties, (中文(简体) ), 不是在仓库里 在 GitHub 动作中, 允许消费存储器访问 到软件包并使用工作流程 GITHUB_TOKEN。 。 。 .

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/eocrm/design-system")
        credentials {
            username = providers.gradleProperty("gpr.user").orNull
            password = providers.gradleProperty("gpr.key").orNull
        }
    }
}

dependencies {
    commonMainImplementation("com.eocrm.design:design-tokens-compose:1.2.3")
}

直接使用生成的主题对象 :

import com.eocrm.design.tokens.EocrmDarkTokens
import com.eocrm.design.tokens.EocrmLightTokens

val background = EocrmLightTokens.colors.background
val darkBackground = EocrmDarkTokens.colors.background
val spacing = EocrmLightTokens.dimensions.space4

该文物支持了JVM,Android,iOS设备(iosArm64),和苹果硅 iOS 模拟器 (iosSimulatorArm64) (中文(简体) ). 它故意不发表 情报 iosX64 目标.

分数

tokens.json 可能有一个根 accents 键 : { "<name>": { "<tokenId>": { "light": "#rrggbb", "dark": "#rrggbb" } } }每个口音发出a [data-accent='<name>'] 块来压上每个主题块中的这些符号(光线、强迫黑暗、OS黑暗),以及一个编曲 Eocrm<Name>LightTokens 编号 : Eocrm<Name>DarkTokens 双人 校验者拒绝:

  • unknown-accent-token - 代号id不存在
  • accent-non-color - 符号不是颜色
  • accent-unthemed - 底牌不是浅/暗的
  • accent-alias ——该值是一个别名而不是颜色
  • invalid-token-value - 颜色不整齐

捐款

src/tokens.json 是唯一可编辑符号值的来源。 不编辑 任何在下面的东西 generated/ 或生成 Kotlin 文件 compose/src/commonMain;再生取代它们.

npm run tokens:validate
npm run tokens:generate
npm run tokens:test
npm run tokens:check
packages/design-tokens/compose/gradlew --no-daemon -p packages/design-tokens/compose jvmTest assemble

在源更改的同时提交生成的产出 . tokens:check 验证 计划与语义合同, 运行测试, 失败在产生的漂移.

见 共享设计所有权 联 合 国 介于中性符号、 React 组件、 Compose 产品 UI 和 本土平台行为.

许可证

Apache 许可证 2.0。 。 。 .

版本与发布记录

@eocrm/design-tokens 共发布 27 个版本,首次发布于 2026/11/02;过去 12 个月发布了 27 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.8.16latest2026/11/13今天
0.8.152026/11/13今天
0.8.142026/11/13今天
0.8.132026/11/113 天前
0.8.122026/11/113 天前
0.8.112026/11/094 天前

关于 @eocrm/design-tokens 的常见问题

@eocrm/design-tokens 是什么?

共享网络和克特林多平台/构成的EOCRM可视化符号. npm包包含生成的 Sass; Maven 文物包含生成的,强烈的打入的 Compose API. 两者的出版版本都与 @eocrm/design-system。 。 。 .

如何安装 @eocrm/design-tokens?

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

@eocrm/design-tokens 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/eocrm__design-tokens 是否存在。

@eocrm/design-tokens 支持 ESM 还是 CommonJS?

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

@eocrm/design-tokens 可以商用吗?

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

@eocrm/design-tokens 的下载量有多少?

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

@eocrm/design-tokens 还在维护吗?

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