# @cssints/apg-specs 中文文档

规范地址：https://npmcn.com/package/%40cssints/apg-specs/

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

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

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

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

- 包体积（解压后）：11.9 MB，287 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：effect ^4\.0\.6
- 首次发布：2026-10-23T14:35:51.314Z
- 最新版本发布：2026-11-07T14:55:55.050Z
- 近 30 天下载量：6735（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 37 个）

## 中文简介

APG 部件规格: 昆特源、 生成模型、 情景桥和端口情景集、 无头部件的测试预告

## 安装

```sh
npm install @cssints/apg-specs
```

也可以使用：`pnpm add @cssints/apg-specs`、`yarn add @cssints/apg-specs`、`bun add @cssints/apg-specs`

## README

# @ cssints/ apg- specs — APG 部件规格

后面的昆特谱 [`@cssints/headless`](https://npmcn.com/package/%40cssints/headless/README.md):每WAI-ARIA APG图案1个光谱,每个由它们组成的非APG图案1个光谱(可处理面板),以及插件的运行时间模型(反应)外加画布相机/指针合同;生成的模型和打入的脚手架 `SpecBridge` 用于每种模式的情景集(转出上游和我们自己的),以及光谱核查。 这是测试元件和 `native/headless`,并发布后,此寄存器以外的部件库可以根据自己的代码重放相同的规格和情景.

生成的文件( E)`*.model.generated.json`, (中文(简体) ), `*.scaffolding.generated.ts`) 由代码生成 [`@quint-machine/core`](https://www.npmjs.com/package/@quint-machine/core) 绝不是手工编辑的。 票号像 `effects-of-atmosphere-dx00` 在规格和测试的评论中 是寄存器的门票 这些文件来自.

## 版式

```
specs/apg/<pattern>.qnt                           # APG pattern specs (one behavior-machine each)
specs/canvas/<machine>.qnt                        # canvas camera + pointer specs
specs/patterns/<machine>.qnt                      # non-APG patterns composed of APG widgets (resizable-panels), a plugin runtime (reactive)
shared/<module>.qnt                               # vocabulary + pure defs: aria, focusgroup, popover, invokers, details-group
src/<service>/<machine>.model.generated.json      # generated model document
src/<service>/<machine>.scaffolding.generated.ts  # generated typed scaffolding
src/apg/<pattern>.bridge.ts                       # scenario vocabulary <-> spec events/state
src/patterns/<machine>.bridge.ts                  # the same, for a non-APG pattern
src/scenario.ts                                   # scenario decoder + replay/differential-walk runtime
scenarios/apg/*.json, scenarios/canvas/*.json     # ported upstream scenario sets
scenarios/patterns/*.json                         # scenarios written from our own pattern specs
scenarios/parts.json                              # part names per pattern
test/<service>/<machine>.test.ts                  # spec-only verification
scripts/generate-all.ts                           # regenerates every spec under specs/
```

平台合同模块(`shared/focusgroup.qnt` 旋转的标签索引, `shared/popover.qnt` 轻而易举, `shared/invokers.qnt` `commandfor`编号 :`command`, (中文(简体) ), `shared/details-group.qnt` `<details name>`)是每个本土网络特征的一款;一种图案导入了一款,而模型仅是它的三角形. `shared/` 只持有词汇和纯度.

## 图标

跑进去 `packages/apg-specs`数字 :

-   `bun run generate:all [specs/apg/tabs.qnt ...]` ——再生文物`node scripts/generate-all.ts`) (中文(简体) ). 每个生成的文件都带有它的光谱的sha256;编辑一个光谱,然后再生. formatter 跳过生成的文件 (`.prettierignore`) (中文(简体) ).
-   `bun run typecheck:quint` ——昆特自己的打字机,覆盖每个谱(~90 s).
-   `bun run test` ——光谱核查(`vp test run`) (中文(简体) ). 详尽的探索(玩家,相机)每集需要一分钟时间,可以使用装入的机器出场;在称失败为真实之前单独运行.
-   `bun run typecheck` —— 说 `effect-tsrs` 结束 `src`, (中文(简体) ), `test` 财务报告和审定财务报表 `scripts`。 。 。 .
-   `bun run check` ——以上所有,按顺序排列.
-   `bun run build` —— 说 `vp pack`数字 : `dist/` (跑道和桥梁作为无害环境管理与 `.d.mts`,生成的模型为 `.json`) (中文(简体) ).

## 安装和使用

```sh
npm install @cssints/apg-specs effect @quint-machine/core
```

`effect` (单位:千美元)`^4.0.0`是一个同行, `@quint-machine/core` a 依赖性。 该套件仅导出子路径 :

| 指定者 | 什麽 |
| --- | --- |
| `@cssints/apg-specs/scenario` | 情景解码器, `replayScenario`, (中文(简体) ), `differentialWalk`, (中文(简体) ), `specDriver`, (中文(简体) ), `Unsupported`,驱动和桥型 |
| `@cssints/apg-specs/apg/<pattern>.bridge` | 页:1 `SpecBridge`, (中文(简体) ), `<pattern>Config`, (中文(简体) ), `<pattern>Steps` 财务报告和审定财务报表 `<pattern>Probe` 图案 |
| `@cssints/apg-specs/apg/<pattern>.model.json` | 生成的模型文档(`src/apg/<pattern>.model.generated.json` (储存库) |
| `@cssints/apg-specs/patterns/<machine>.bridge` | 由APG 部件组成的非APG 模式也一样(`resizable-panels`, (中文(简体) ), `reactive`(中文(简体) ) |
| `@cssints/apg-specs/patterns/<machine>.model.json` | 其生成的示范文件(`src/patterns/<machine>.model.generated.json`(中文(简体) ) |
| `@cssints/apg-specs/canvas/{canvas.bridge,camera.model.json,pointer.model.json}` | 帆布桥和模型 |
| `@cssints/apg-specs/scenarios/apg/<pattern>.<set>.json` | 移植情景集(也) `scenarios/canvas/*.json`, (中文(简体) ), `scenarios/parts.json`(中文(简体) ) |
| `@cssints/apg-specs/scenarios/patterns/<machine>.spec.json` | 从我们自己的图案光谱中写入的情景集 |
| `@cssints/apg-specs/specs/apg/<pattern>.qnt` | 生质谱( 也) `specs/canvas/*.qnt`, (中文(简体) ), `specs/patterns/*.qnt`, (中文(简体) ), `shared/*.qnt`,这些规格将导入) |

```ts
import {
  Unsupported,
  differentialWalk,
  replayScenario,
  specDriver,
} from "@cssints/apg-specs/scenario";
import { buttonBridge, buttonConfig } from "@cssints/apg-specs/apg/button.bridge";
import buttonModel from "@cssints/apg-specs/apg/button.model.json" with { type: "json" };
import baseUi from "@cssints/apg-specs/scenarios/apg/button.base-ui.json" with { type: "json" };
```

在这个寄存器中 `development` (视频,tsc)和 `bun` 出口条件 `src/`中指定了设想格式 `scenarios/apg/README.md`· ; `scenarios/patterns/` 持有我们自己的非APG模式的情景(格式相同,不上游).

## 常见问题

### @cssints/apg-specs 是什么？

APG 部件规格: 昆特源、 生成模型、 情景桥和端口情景集、 无头部件的测试预告

### 如何安装 @cssints/apg-specs？

在项目目录运行 npm install @cssints/apg-specs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：effect（^4\.0\.6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cssints/apg-specs 支持 TypeScript 吗？

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

### @cssints/apg-specs 支持 ESM 还是 CommonJS？

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

### @cssints/apg-specs 需要什么版本的 Node\.js？

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

### @cssints/apg-specs 可以商用吗？

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

### @cssints/apg-specs 的下载量有多少？

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

### @cssints/apg-specs 还在维护吗？

最新版本 0\.35\.1 发布于 2026/11/07（3 天前）；至今共发布 37 个版本，其中过去 12 个月发布了 37 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。