@cssints/mise-en-mode

中文文档
0.35.1发布于 2026/11/07MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 7707

Mise en mode for cssints: 外观是地层应用中的主题 < 作者 < 查看器, 数据集- 模式范围

中文使用文档

@cssints/meise-en-mode (英语)

Mise 模式的外观层 点缀(单位:千美元) 听着 是一个主题设置在一个 data-mode 范围,和外观 由三个来源通过模式合同解决。 它是一位呼叫成员 cssints/plugin scope() (职位 参数 $tokens 财务报告和审定财务报表 $overrides,返回主题),所以将对照您的符号集查看 check.contrast 看见了. 没有运行时间.

import { createTokens } from "cssints" with { type: "cssints" };
import { look } from "@cssints/mise-en-mode" with { type: "cssints" };

const t = createTokens({
  color: { $type: "color", bg: { $value: "#ffffff" }, fg: { $value: "#111111" } },
});

// look(tokens, expression, source, overrides, { scope? })
look(t, "dark", "app", { color: { bg: "#0b0b0f", fg: "#f3f4f6" } });
look(t, "dark", "viewer", { color: { bg: "#101018" } });
look(t, "hero", "author", { color: { bg: "#123456" } }, { scope: "article.post" });
@layer app, author, viewer;
@layer app {
  :where([data-mode="dark"], [data-mode~="dark/color"]) {
    --color-bg: #0b0b0f;
    --color-fg: #f3f4f6;
  }
}
@layer viewer {
  :where([data-mode="dark"], [data-mode~="dark/color"]) {
    --color-bg: #101018;
  }
}
@layer author {
  @scope (article.post) {
    :where([data-mode="hero"], [data-mode~="hero/color"]) {
      --color-bg: #123456;
    }
  }
}

合同,像包裹一样

  • 资料来源(第5条). source 实值 "app", (中文(简体) ), "author" 或者说 "viewer": 层 app < author < viewer,一次声明 在发动机本身之后(layers() 因此,一看就比发动机的 :root 后退和观众的相貌比 作者过于应用. 每个变量从最首选的源填充它: 上面的查看器只设置 --color-bg,以及 --color-fg 仍然来自应用程序的外观.
  • 问题和问题(第4条). 一个方面是令牌集的顶级组(color, (中文(简体) ), typography) (中文(简体) ). 看着 overrides 由它分割,每个方面一个规则,每个规则与赤色标记或其碎片相匹配: data-mode="dark" 应用每个方面, data-mode="dark/color" 只有颜色组.
  • 表达相. expression 是一个 <custom-ident> 或字符串; 调用时引用一个被点缀的反向 DNS 密钥, look(t, '"com.alice.midnight"', "author", …)准确匹配.
  • 限制(第7条). { scope: "article.post" } 将规则包入 @scope (article.post) { … },所以外观 不能重新油漆宿主的铬。 是一个选择者, 由建筑检查 .
  • 覆盖 为: createGlobalTheme's:按符号路径计值,每个符号的类型, {color.bg} 允许参考文献, 检查您键入的类型, 并在构建时再次检查( e)color.bg value "blu" is not a <color>,位于呼叫处). 取决于被推翻的神迹的别名在范围上再次被宣布.
  • 相会相会. 一种表达式的外观和面相 是一个级联到 check.contrast它们彼此相依为命 层顺序,所以只设置文本颜色的查看器外观将检查 应用 看着是背景,是穷人 组合失败构建 .

外观打印无类:在模块的顶级调用, 如 createGlobalTheme。其类型从 scope() 定义 src/index.ts: 没有类型文件 .

更改自 cssints/mise-en-mode,该套件将替换: look(expression, source, declarations, { scope }) 带了 原始的习惯财产申报"--color-bg": "#000"(没有检查;现在是) look(tokens, expression, source, overrides, { scope }) 首先设置了符号,然后按符号路径进行覆盖,所以检查声明 异名被重新生成,反之亦然。 方方面面是象征物的组合,不再是表 --color- 财务报告和审定财务报表 --typography- 前缀和外观释放出主题,不再是全局.

cd packages/mise-en-mode && bun run test   # fixtures through the engine (output, errors, contrast), and the type test via bun run typecheck

贷项

Mise en Mode是AT协议上的开放样式标准(https://standard.mode.place (中文(简体) )),模式合同是其 规则 : data-mode 镜片,层 app < author < viewer,相关方面。 这套方案是执行 合同 scope();没有复制标准网站的代码.

版本与发布记录

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

版本发布日期距今
0.35.1latest2026/11/073 天前
0.35.02026/11/073 天前
0.34.02026/11/073 天前
0.33.02026/11/046 天前
0.32.02026/11/046 天前
0.31.02026/11/047 天前

关于 @cssints/mise-en-mode 的常见问题

@cssints/mise-en-mode 是什么?

Mise en mode for cssints: 外观是地层应用中的主题 < 作者 < 查看器, 数据集- 模式范围

如何安装 @cssints/mise-en-mode?

在项目目录运行 npm install @cssints/mise-en-mode,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:cssints(^0.35.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cssints/mise-en-mode 支持 TypeScript 吗?

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

@cssints/mise-en-mode 支持 ESM 还是 CommonJS?

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

@cssints/mise-en-mode 需要什么版本的 Node.js?

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

@cssints/mise-en-mode 可以商用吗?

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

@cssints/mise-en-mode 的下载量有多少?

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

@cssints/mise-en-mode 还在维护吗?

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