# @girs/clutter-51 中文文档

规范地址：https://npmcn.com/package/%40girs/clutter-51/

版本：5\.6\.0
npm 元数据更新时间：2026-10-27T19:31:05.779Z
中文译文更新时间：2026-11-16T13:21:19.801Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40girs/clutter-51
原文对照：https://npmcn.com/package/%40girs/clutter-51/?lang=original
项目主页：https://github.com/gjsify/types/tree/main/clutter-51#readme
源码仓库：https://github.com/gjsify/types

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

- 包体积（解压后）：1.3 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：14 个
- 首次发布：2026-08-28T22:02:10.460Z
- 最新版本发布：2026-10-27T19:31:05.412Z
- 近 30 天下载量：2187（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

GJS 类型脚本定义 Clutter-51

## 安装

```sh
npm install @girs/clutter-51
```

也可以使用：`pnpm add @girs/clutter-51`、`yarn add @girs/clutter-51`、`bun add @girs/clutter-51`

## README

# 克吕特 -51

![version](https://img.shields.io/npm/v/@girs/clutter-51) ![downloads/week](https://img.shields.io/npm/dw/@girs/clutter-51)

使用 Clutter-51 的 GJS TypeScript 类型定义 [转写](https://github.com/gjsify/ts-for-gir) 页:1.

此套件仅包含类型声明. 它没有运行时间代码,所以它添加 没有任何与你的程序, 工作与任何捆绑者或完全没有.

## 安装

```bash
npm install @girs/clutter-51
```

任何软件包管理器都有效。 软件包没有其他依赖性 `@girs/*` 类型包.

## 出口的东西

| 导入 | 你得到的东西 |
| --- | --- |
| `@girs/clutter-51` | 名称空间作为默认导出,加上环境和全球声明 |
| `@girs/clutter-51/ambient` | 仅限 `gi://` 模块声明 |
| `@girs/clutter-51/import` | 仅限 `imports.gi` 声明 |
| `@girs/clutter-51/clutter-51` | 名称空间,没有副作用声明 |
| `@girs/clutter-51/vocabulary` | GIR 生成的部件数据: 设置属性、 enum nicks 、 槽候选人 |

## 三种进口方式

你用哪一个取决于你如何在别处输入,而不是工具链.

### 作为模块

```ts
import Clutter from '@girs/clutter-51';
```

### 作为 `gi://`

GJS 解决 `gi://` 在运行时间。 要给它打字,请参考包一次,要么 从您的切入点或从 `tsconfig.json`数字 :

```ts
import '@girs/clutter-51';
```

```json
{ "include": ["@girs/clutter-51"] }
```

然后运行时间拼写类型检查:

```ts
import Clutter from 'gi://Clutter?version=51';
```

参考 `@girs/clutter-51/ambient` 而不是把这些声明 一个人 见 [环境模块](https://github.com/gjsify/ts-for-gir/tree/main/packages/cli#ambient-modules)。 。 。 .

### 作为 `imports.gi`

GJS 全球对象的工作方式相同,通过 `@girs/clutter-51/import`数字 :

```ts
const Clutter = imports.gi.Clutter;
```

## 部件词汇

`clutter-51` 宣布部件,所以它也带有 GIR 对这些部件的描述,因为 类型和作为值,测试可读取:

```ts
import type { Widgets, PropsOf } from '@girs/clutter-51/vocabulary';
import { OWN_PROPS, ENUM_NICKS, PROVENANCE } from '@girs/clutter-51/vocabulary';
```

属性按键为 GObject 注册方式, 仅可写和可选, 因此 匹配 `g_object_set`, GtkBuilder XML 和"蓝图". `PROVENANCE.libraryVersion` 名称 库的发布来自此, 它让检查告诉“ 比什么更新 ” 安装"从"错误".

这个子路径可以回答GIR所说的话,而不是安装的库中的内容. 给 第二个问题,问图书馆.

## 大楼

宣言不需要建立一步。 如果你捆绑,每个捆绑者工作,因为有 无法解析运行时代码 。 这个 [实例](https://github.com/gjsify/ts-for-gir/tree/main/examples) 显示几个工作设置.

## 其他软件包

每个预生成的软件包都在 [gjsify/类型](https://github.com/gjsify/types)。 。 。 .

## 常见问题

### @girs/clutter-51 是什么？

GJS 类型脚本定义 Clutter-51

### 如何安装 @girs/clutter-51？

在项目目录运行 npm install @girs/clutter-51，或使用 pnpm add / yarn add / bun add。

### @girs/clutter-51 支持 TypeScript 吗？

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

### @girs/clutter-51 支持 ESM 还是 CommonJS？

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

### @girs/clutter-51 可以商用吗？

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

### @girs/clutter-51 的下载量有多少？

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

### @girs/clutter-51 还在维护吗？

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

