@cssints/apg-specs

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

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

中文使用文档
文档目录3 节
  1. 版式
  2. 图标
  3. 安装和使用

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

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

生成的文件( E)*.model.generated.json, (中文(简体) ), *.scaffolding.generated.ts) 由代码生成 @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) (中文(简体) ).

安装和使用

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,这些规格将导入)
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 共发布 37 个版本,首次发布于 2026/10/23;过去 12 个月发布了 37 个版本。最新版本附带 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/apg-specs 的常见问题

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