@empyria/name 0.1.0

package/.oxfmtrc.json

@@ -0,0 +1,9 @@
+{
+	"$schema": "./node_modules/oxfmt/configuration_schema.json",
+	"ignorePatterns": [],
+	"useTabs": true,
+	"tabWidth": 4,
+	"singleQuote": true,
+	"trailingComma": "all",
+	"semi": false
+}

package/.oxlintrc.json

@@ -0,0 +1,3 @@
+{
+	"ignorePatterns": ["node_modules", ".nx", "coverage", "**/tmp/**"]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Imre Fazekas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @empyria/name
+
+Name and title manipulation utilities for **Empyria**, a nanoservice framework built
+primarily on Bun.
+
+Provides a curated list of honorifics/titles (`TITLE_LIST`/`TITLES`) spanning common,
+formal, academic, and religious usage, plus `findTitle` to resolve free-text input
+(any case, punctuation, or transliterable script) to its canonical form. The generic
+string helpers `TRANS`, `capitalise`, and `shortify`, and `transliterate`/`slugify`
+from the [`transliteration`](https://www.npmjs.com/package/transliteration) package,
+are re-exported here for convenience since name/title handling relies on them heavily.
+
+## Requirements
+
+- Bun `>=1.4.0` or Node.js `>=26`
+- Plain ESM, no build step, no TypeScript
+
+## Install
+
+```bash
+bun add @empyria/name
+```
+
+## Usage
+
+```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'
+```
+
+## Modules
+
+| Module                       | Purpose                                                                                                                                                                                                   |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [index.js](./index.js)       | Package entry point; re-exports [lib/Name.js](./lib/Name.js).                                                                                                                                             |
+| [lib/Name.js](./lib/Name.js) | `TITLE_LIST`/`TITLES` (the full title catalog), `findTitle`, plus `TRANS`/`capitalise`/`shortify`/`transliterate`/`slugify` re-exported from `@empyria/classification`/`transliteration` for convenience. |
+
+Tests live under [test/](./test/), one file per module, separate from the `lib/` sources.
+
+## Scripts
+
+```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
+```
+
+## License
+
+MIT © Imre Fazekas

package/index.js

@@ -0,0 +1,3 @@
+export * from './lib/Name.js'
+
+export * from './lib/Chunker.js'

package/lib/Chunker.js

@@ -0,0 +1,4 @@
+// Re-exported from @empyria/classification, which owns the canonical implementation (this
+// package already depends on it) — kept here as its own module so `chunkDocument` stays
+// importable from this package too, without maintaining a second copy that can drift.
+export { chunkDocument } from '@empyria/classification'

package/lib/Name.js

@@ -0,0 +1,102 @@
+import { transliterate, slugify } from 'transliteration'
+
+import { enumise, TRANS, capitalise, shortify } from '@empyria/classification'
+
+export const TITLE_LIST = [
+	// Common titles
+	'Master',
+	'Mr',
+	'Messrs',
+	'Miss',
+	'Mrs',
+	'Ms',
+	'Mx',
+	// Formal titles
+	'Sir',
+	'Gentleman',
+	'Sire',
+	'Mistress',
+	'Madame',
+	'Dame',
+	'Lord',
+	'Esq',
+	'Esquire',
+	'Excellency',
+	'Excellence',
+	'Her Honour',
+	'His Honour',
+	'The Right Honourable',
+	'The Most Honourable',
+	'The Much Honoured',
+	'King',
+	'Queen',
+	'Prince',
+	'Princess',
+	// Academic and professional titles
+	'Dr',
+	'Professor',
+	'KC', // King's Counsel
+	'Cl', // Counsel
+	'Counsel',
+	'SCl', // Senior Counsel
+	'Senior Counsel',
+	'Chancellor',
+	'Vice-Chancellor',
+	'Principal',
+	'President',
+	'Warden',
+	'Dean',
+	'Regent',
+	'Rector',
+	'Provost',
+	// Religious titles
+	'His Holiness',
+	'His All Holiness',
+	'His Beatitude',
+	'His Excellency',
+	'His Most Eminent Highness',
+	'His Eminence',
+	'Most Reverend Eminence',
+	'The Most Reverend',
+	'His Grace',
+	'His Lordship',
+	'The Reverend',
+	'Father',
+	'Pastor',
+	'Brother',
+	'Sister',
+	'Elder',
+	'Rabbi',
+	'Cantor',
+	'Chief Rabbi',
+	'Grand Rabbi',
+	'Rebbetzin',
+	transliterate('Imām'),
+	transliterate('Shaykh'),
+	transliterate('Muftī'),
+	transliterate('Hāfiz'),
+	transliterate('Hāfizah'),
+	transliterate('Qārī'),
+	transliterate('Mawlānā'),
+	transliterate('Hājī'),
+	'Sayyid',
+	'Sayyidah',
+	'Sharif',
+	'Ayatollah',
+	'Seghatoleslam',
+	'Mohyeddin',
+	'Eminent',
+	transliterate('Rōshi'),
+	'Sensei',
+	'Venerable',
+]
+export const TITLES = enumise(TITLE_LIST)
+
+export function findTitle(_title) {
+	if (!_title) return undefined
+
+	const title = transliterate(_title.replace(/[^a-z0-9\s-]/gi, '')).toUpperCase()
+	return TITLE_LIST.find((t) => transliterate(t).toUpperCase() === title)
+}
+
+export { transliterate, slugify, TRANS, capitalise, shortify }

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@empyria/name",
+	"version": "0.1.0",
+	"description": "Name and title manipulation library for Empyria",
+	"license": "MIT",
+	"author": "Imre Fazekas <imre.fazekas@icloud.com>",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/empyria-nano/name.git"
+	},
+	"type": "module",
+	"main": "./index.js",
+	"scripts": {
+		"format": "bun oxfmt --check",
+		"format:fix": "bun oxfmt",
+		"lint": "bun oxlint",
+		"lint:fix": "bun oxlint --fix",
+		"test": "bun test --coverage",
+		"test:watch": "bun test --watch"
+	},
+	"dependencies": {
+		"@empyria/classification": "0.1.5",
+		"@empyria/common": "0.1.8",
+		"transliteration": "^2.6.1"
+	},
+	"devDependencies": {
+		"oxfmt": "0.66.0",
+		"oxlint": "1.81.0"
+	},
+	"engines": {
+		"bun": ">=1.4.0",
+		"node": ">=26"
+	},
+	"packageManager": "bun@1.4.2"
+}

package/test/Name.test.js

@@ -0,0 +1,75 @@
+import { describe, test, expect } from 'bun:test'
+import {
+	TITLE_LIST,
+	TITLES,
+	findTitle,
+	TRANS,
+	capitalise,
+	shortify,
+	transliterate,
+	slugify,
+} from '../lib/Name.js'
+
+describe('TITLE_LIST', () => {
+	test('has no duplicate entries', () => {
+		expect(new Set(TITLE_LIST).size).toBe(TITLE_LIST.length)
+	})
+})
+
+describe('TITLES', () => {
+	test('enumises every title in TITLE_LIST', () => {
+		expect(TITLES.DR).toBe('Dr')
+		expect(TITLES.MR).toBe('Mr')
+	})
+})
+
+describe('findTitle', () => {
+	test('finds a plain title regardless of case', () => {
+		expect(findTitle('dr')).toBe('Dr')
+		expect(findTitle('DR')).toBe('Dr')
+	})
+
+	test('ignores surrounding punctuation', () => {
+		expect(findTitle('Dr.')).toBe('Dr')
+	})
+
+	test('matches a multi-word title', () => {
+		expect(findTitle('the right honourable')).toBe('The Right Honourable')
+	})
+
+	test('matches a hyphenated title', () => {
+		expect(findTitle('Vice-Chancellor')).toBe('Vice-Chancellor')
+		expect(findTitle('vice chancellor')).toBeUndefined()
+	})
+
+	test('returns undefined for an unknown title', () => {
+		expect(findTitle('Wizard')).toBeUndefined()
+	})
+
+	test('returns undefined for falsy input', () => {
+		expect(findTitle('')).toBeUndefined()
+		expect(findTitle(null)).toBeUndefined()
+	})
+})
+
+describe('re-exported string helpers (from @empyria/classification)', () => {
+	test('TRANS transliterates, strips whitespace, and upper-cases', () => {
+		expect(TRANS('hello world')).toBe('HELLOWORLD')
+	})
+
+	test('capitalise upper-cases only the first character', () => {
+		expect(capitalise('hello')).toBe('Hello')
+	})
+
+	test('shortify truncates and appends an ellipsis when over the limit', () => {
+		expect(shortify('hello world', 5)).toBe('hello...')
+	})
+
+	test('transliterate is re-exported from the transliteration package', () => {
+		expect(typeof transliterate).toBe('function')
+	})
+
+	test('slugify is re-exported from the transliteration package', () => {
+		expect(slugify('Jean Pierre')).toBe('jean-pierre')
+	})
+})