# @empyria/name 中文文档

规范地址：https://npmcn.com/package/%40empyria/name/

版本：0\.1\.22
npm 元数据更新时间：2026-10-31T23:34:37.390Z
中文译文更新时间：2026-11-01T02:28:49.116Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：11.8 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=26
- 运行依赖：3 个
- 首次发布：2026-09-05T15:06:25.030Z
- 最新版本发布：2026-10-31T23:34:36.942Z
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Empyria的名称和标题操作库

## 安装

```sh
npm install @empyria/name
```

也可以使用：`pnpm add @empyria/name`、`yarn add @empyria/name`、`bun add @empyria/name`

## README

# @empyria /名称

的名称和标题操作实用程序 **Empyria**，构建一个纳米服务框架 主要是在面包上。

提供一份精选的职衔一览表(`TITLE_LIST`/`TITLES`)跨越公共， 正式的，学术的和宗教的用法 `findTitle` 解析自由文本输入 （任何大小写、标点或可转写的文字）变成规范形式。通用 字符串助手 `TRANS`， `capitalise`, `shortify`, `transliterate`/`slugify` 从 [`transliteration`](https://www.npmjs.com/package/transliteration) 包, 在这里重新导出是为了方便，因为名称/标题处理严重依赖于它们。

## 要求

-   包子 `>=1.4.0` 或node . js `>=26`
-   简单的ESM，没有构建步骤，没有TypeScript

## 安装

```bash
bun add @empyria/name
```

## 使用

```js
import { findTitle, TITLES, capitalise, slugify } from '@empyria/name'

findTitle('dr.') // 'Dr'
findTitle('Vice-Chancellor') // 'Vice-Chancellor'
findTitle('Wizard') // undefined — not a recognised title

TITLES.DR // 'Dr'

capitalise('jean') // 'Jean'
slugify('Jean Pierre') // 'jean-pierre'
```

## 模块

| 模块 | 目的 |
| --- | --- |
| [index.js](https://npmcn.com/package/%40empyria/name/index.js) | 包入口点；再出口 [lib / Name.js](https://npmcn.com/package/%40empyria/name/lib/Name.js). |
| [lib / Name.js](https://npmcn.com/package/%40empyria/name/lib/Name.js) | `TITLE_LIST`/`TITLES` （完整的标题目录）， `findTitle`,再加上 `TRANS`/`capitalise`/`shortify`/`transliterate`/`slugify` 再出口的 `@empyria/classification`/`transliteration` 为了方便。 |

测试在 [测试/](https://npmcn.com/package/%40empyria/name/test/)，每个模块一个文件，与 `lib/` 来源。

## 脚本

```bash
bun run format       # check formatting (oxfmt)
bun run format:fix   # apply formatting
bun run lint         # lint (oxlint)
bun run lint:fix     # lint and fix
bun run test         # run tests with coverage
```

## 许可证

MIT©Imre Fazekas

## 常见问题

### @empyria/name 是什么？

Empyria的名称和标题操作库

### 如何安装 @empyria/name？

在项目目录运行 npm install @empyria/name，或使用 pnpm add / yarn add / bun add。

### @empyria/name 支持 TypeScript 吗？

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

### @empyria/name 支持 ESM 还是 CommonJS？

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

### @empyria/name 需要什么版本的 Node\.js？

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

### @empyria/name 可以商用吗？

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

### @empyria/name 还在维护吗？

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