# @fest-lib/core 中文文档

规范地址：https://npmcn.com/package/%40fest-lib/core/

版本：0\.1\.40
npm 元数据更新时间：2026-11-07T23:24:12.917Z
中文译文更新时间：2026-11-14T15:03:39.435Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：212 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-08-07T14:55:42.225Z
- 最新版本发布：2026-11-07T23:24:12.748Z
- 近 30 天下载量：2780（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 37 个）

## 中文简介

fest-lib 核心: 获得Value, 类型守护, 推迟承诺, 路径, 时间, 网格数学

## 安装

```sh
npm install @fest-lib/core
```

也可以使用：`pnpm add @fest-lib/core`、`yarn add @fest-lib/core`、`bun add @fest-lib/core`

## README

**@ fest-lib/ core (英语)**  
0.5级——无同龄人. 堆栈中的其他所有东西都会通过这个包解开值 .

[![npm](https://img.shields.io/npm/v/@fest-lib/core?style=flat-square)](https://www.npmjs.com/package/@fest-lib/core) [![MIT](https://img.shields.io/npm/l/@fest-lib/core?style=flat-square)](https://npmcn.com/package/%40fest-lib/core/LICENSE) [![stars](https://img.shields.io/github/stars/fest-live/core.ts?style=flat-square)](https://github.com/fest-live/core.ts)

`getValue` 在 refs 、 type / 空后卫、 推迟承诺、 通道、 映射的收藏、 用户范围路径、 时间/ 电话帮助器、 发射器网格数学、 弱参考包和 DOM 构造器多填充器上, 因此相同的代码会运行在窗口、 工人和节点中.

```text
fest/core          ← you are here
 └── dom · object · veela · uniform · lure · icon · image · fl-ui
```

## 安装

```bash
npm install @fest-lib/core
```

仅限无害环境管理。 节点 **20岁以上**。没有同伴依赖关系.

```ts
import { getValue, isObject, createDeferred, debounce } from "@fest-lib/core";

const raw = getValue(maybeRef);          // ref.value or the value itself
const { promise, resolve } = createDeferred<string>();
const onResize = debounce(() => measure(), 48);
```

## 你得到的东西

| 区域 | 典型出口 | 来源 |
| --- | --- | --- |
| 参考文件类型( T) | `getValue`, (中文(简体) ), `isObject` | `src/utils/Primitive.ts` |
| 承诺 | `createDeferred`,队列,超时 | `src/utils/PromiseUtils.ts` |
| 跳过 | `debounce` | `src/utils/Misc.ts` |
| 收款 | 绘图助手 | `src/utils/Mapped.ts` |
| 路径 | 用户镜规范化 | `src/utils/UserPath.ts` |
| 发射器网格 | 单元格/布局数学 | `src/utils/GridItemUtils.ts` |
| 时间/ 电话 | 格式帮助 | `src/utils/Time.ts`, (中文(简体) ), `Phone.ts` |
| 主机多填充器 | `EventTarget` /DOM 工人中的医生 | `src/runtime/dom-globals-polyfill.ts` |

导入包安装多填充器一次 。 这是故意的.

## 工作空间

```bash
cd modules/projects/core.ts
npm run dev          # Vite playground
npm run build        # dist + typedoc
npm run publish      # patch +1, then npm publish
```

生成 API : `npm run docs:md` → `./docs-md`。许可证: [麻省理工学院](https://npmcn.com/package/%40fest-lib/core/LICENSE)。 。 。 .

## 常见问题

### @fest-lib/core 是什么？

fest-lib 核心: 获得Value, 类型守护, 推迟承诺, 路径, 时间, 网格数学

### 如何安装 @fest-lib/core？

在项目目录运行 npm install @fest-lib/core，或使用 pnpm add / yarn add / bun add。

### @fest-lib/core 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fest-lib\_\_core 是否存在。

### @fest-lib/core 支持 ESM 还是 CommonJS？

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

### @fest-lib/core 需要什么版本的 Node\.js？

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

### @fest-lib/core 可以商用吗？

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

### @fest-lib/core 的下载量有多少？

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

### @fest-lib/core 还在维护吗？

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