@oods /令牌
OODS组件使用的CSS变量和JavaScript令牌值。内置包包含发货品牌及其光,暗和高对比度范围。没有运行MCP服务器。
安装
npm install @oods/tokens
第一个结果
在基于绑定器的应用中,只需要导入一次样式表,然后在文档中选择一个作用域:
import '@oods/tokens/css';
document.documentElement.dataset.brand = 'A';
document.documentElement.dataset.theme = 'light';
在CSS中使用语义角色:
body {
background: var(--sys-surface-canvas);
color: var(--sys-text-primary);
}
对于JavaScript值:
import tokens from '@oods/tokens';
console.log(tokens.cssVariablesByScope.A.light['--oods-sys-surface-canvas']); // oklch(1 0 286)
作用域适用于任何元素,而不仅仅是文档:一个有自己的面板 data-brand 和 data-theme 获得该品牌和主题的角色,因此黑暗预览可以坐在一个明亮的页面。
样式表还声明了三种字体的标记名称:Geist、Geist Mono和DM Sans。他们的文件传送过来 dist/fonts 从旁边的样式表加载,永远不要从网络;浏览器只会为使用家族的文本获取一个。Vite用样式表复制它们;Esbuild需要一个加载器(--loader:.woff2=file),并webpack一个资源规则 .woff2.
cssVariablesByScope 保存每个品牌和主题的每个变量,并解析其值,以其全名为关键字,以 --oods-. 样式表使用短名称: --oods-sys-surface-canvas 在JavaScript中是值 var(--sys-surface-canvas) 需要下 data-brand="A" 和 data-theme="light".
@oods/tokens/brands 导出此构建中的品牌。 @oods/tokens/tailwind 导出构建的JSON令牌有效负载;它不会为您安装或配置顺风。
要将您的颜色代币转换为OODS Foundry品牌,请使用 brand_create 通过 @oods/foundry 它已经发货了 QUICKSTART.md. 为该品牌生成的应用带有一个单独的样式表,其中包含自定义作用域。
限制
生成的应用锁定生成它们的OODS版本;要升级,请重新生成应用程序或将所有四个引脚移到一起。这些包与本地MCP服务器是分开的, @oods/foundry.
许可证
Apache License 2.0。看到 许可证 和 请注意. Geist、Geist Mono和DM Sans字体文件采用SIL开放字体许可证1.1,颜色校准源自Radix Colors (dist/radix-calibration.json)受MIT授权;“通知”带有这些许可以及文件的来源。生成的输出属于其用户;已安装的包依赖项保留其自己的许可证。