# @happyvertical/smrt-types 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-types/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:56:06.066Z
中文译文更新时间：2026-11-17T09:29:17.450Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：149 kB，36 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-06-23T01:18:53.508Z
- 最新版本发布：2026-11-17T07:56:05.841Z
- 近 30 天下载量：52455（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：365（近 12 个月 365 个）

## 中文简介

共享 SDK 类型定义

## 安装

```sh
npm install @happyvertical/smrt-types
```

也可以使用：`pnpm add @happyvertical/smrt-types`、`yarn add @happyvertical/smrt-types`、`bun add @happyvertical/smrt-types`

## README

# @ happyvertical/ smrt- types (原始内容存档于2018- 2017) (英语)

S-m-r-t框架的共享类型Script类型定义. 通过集中多个软件包需要的类型来防止循环依赖.

## 安装

```bash
pnpm add @happyvertical/smrt-types
```

## 使用量

```typescript
// Import types (use `import type` for type-only imports)
import type { Signal, SignalType, SignalAdapter } from '@happyvertical/smrt-types';
import type { SmrtModuleMeta, ModuleUISlot } from '@happyvertical/smrt-types';

// Enums have runtime values — use regular import
import { UserStatus, TenantStatus, MembershipStatus } from '@happyvertical/smrt-types';
```

## 出口

### 信号系统(类型)

| 导出 | 说明 |
| --- | --- |
| `Signal` | 带有生命周期信息(id, className,方法,持续时间等)的信号载荷 |
| `SignalType` | 信号生命周期阶段: `'start'` | `'step'` | `'end'` | `'error'` |
| `SignalAdapter` | 信号处理器的接口(博客、计量、酒吧/子) |

### 模块 UI (类型)

| 导出 | 说明 |
| --- | --- |
| `SmrtModuleMeta` | 模块元数据(名称、版本、描述) |
| `ModuleUISlot` | 模块管理面板的用户界面槽定义 |
| `ModuleComponentType` | 构成部分类型分类 |
| `ModuleUIBaseProps` | 模块 UI 组件的基础道具接口 |
| `ModuleUIRegistryInterface` | 模块UI注册的注册界面 |

### 边界数据查询( 类型)

| 导出 | 说明 |
| --- | --- |
| `DataQueryRequest` 编号 : `DataQueryResult` | 可串行的、中性运输的有界查询和正常结果信封 |
| `DataQuerySchema` 编号 : `DataQueryFieldDescriptor` | 用于投影、过滤、排序和面对面能力的可信适配器允许列表 |
| `DataQueryFilter` 编号 : `DataQuerySort` 编号 : `DataQueryPage` | 已打入的上游、 确定排序的名词和光标/ 关闭的呼号 |
| `DataQueryTotal` 编号 : `DataQueryFreshness` | 明确完全准确性/语义和反应新鲜度 |

### 用户/ 十进制状态( enums- 运行时间值)

| 导出 | 说明 |
| --- | --- |
| `UserStatus` | 用户生命周期状况 |
| `TenantStatus` | 租户生命周期状况 |
| `MembershipStatus` | 成员生命周期状况 |
| `SessionStatus` | 会议周期状况 |
| `OverrideEffect` | 权限覆盖效果 |
| `TenantPermissionEffect` | 租户一级许可效力 |

## 规则

-   **零运行时间代码** 除 enum (需要运行时值)
-   **使用 `import type`** 用于非铝进口以避免不必要的运行时间依赖性
-   **在此添加共享类型** 如果两个或两个以上的软件包需要相同的类型定义

## 依赖关系

无。 这是一个零依赖性的叶包.

## 常见问题

### @happyvertical/smrt-types 是什么？

共享 SDK 类型定义

### 如何安装 @happyvertical/smrt-types？

在项目目录运行 npm install @happyvertical/smrt-types，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-types 支持 TypeScript 吗？

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

### @happyvertical/smrt-types 支持 ESM 还是 CommonJS？

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

### @happyvertical/smrt-types 可以商用吗？

@happyvertical/smrt-types 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @happyvertical/smrt-types 的下载量有多少？

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

### @happyvertical/smrt-types 还在维护吗？

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

