# @cssints/mise-en-mode 中文文档

规范地址：https://npmcn.com/package/%40cssints/mise-en-mode/

版本：0\.35\.1
npm 元数据更新时间：2026-11-07T14:55:40.550Z
中文译文更新时间：2026-11-11T03:36:26.191Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cssints/mise-en-mode
原文对照：https://npmcn.com/package/%40cssints/mise-en-mode/?lang=original
项目主页：https://cssints.dev/
源码仓库：https://github.com/alexeiaccio/css-in-ts-compiler

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

- 包体积（解压后）：8.9 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：cssints ^0\.35\.0
- 首次发布：2026-10-10T20:57:53.631Z
- 最新版本发布：2026-11-07T14:55:39.985Z
- 近 30 天下载量：7707（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 43 个）

## 中文简介

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

## 安装

```sh
npm install @cssints/mise-en-mode
```

也可以使用：`pnpm add @cssints/mise-en-mode`、`yarn add @cssints/mise-en-mode`、`bun add @cssints/mise-en-mode`

## README

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

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

```ts
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" });
```

```css
@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-` 前缀和外观释放出主题,不再是全局.

```bash
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 (中文(简体) )](https://standard.mode.place/)),模式合同是其 规则 : `data-mode` 镜片,层 `app < author < viewer`,相关方面。 这套方案是执行 合同 `scope()`;没有复制标准网站的代码.

## 常见问题

### @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 和提交记录判断。