marek-saji / given-name

Validate given name or get hypocoristics of a name.

given-name

Validate given name or get hypocoristics of a name.

Usage

const hypocoristics = require('given-name/hypocoristics');
hypocoristics('Lex');
// → [Alexander, Alex, Xander, Sander, Sandy]

const data = require('given-name/data');
// → [Aaron, Aar, Abigail, …]
const enData = require('given-name/data/en');
const plData = require('given-name/data/pl');

const plHypocoristicsData = require('given-name/data/pl/hypocoristics');
// → [Ada, Adusia], [Adela, Adelka], …]

const givenName = require('given-name');
// → { data: Array, hypocoristics: Function }

Languages and sources

Sources of data. Pull requests for additional languages are very much welcome.

• English: https://en.m.wiktionary.org/wiki/Appendix:English_given_names
• Polish: https://pl.m.wiktionary.org/wiki/Indeks:Polski_-_Imiona

License

ISC

What does that even mean?

given-name's Issues

Implement hypocoristics getter

As promised in README:

const hypocoristics = require('given-name/hypocoristics');
hypocoristics('Lex'); // → [Alexander, Alex, Xander, Sander, Sandy]

Remove duplicates in generators

e.g. [Ada, Ada, Adusia]

Handle non-unique names

given-name/utils/merge-hypocoristics.js

Lines 13 to 21 in c5a380f

	// FIXME Some names added with “/” are not unique
	// (e.g. Polly in English) and with this in place
	// will be groupped together
	const aliasIdx = carry.findIndex(carryRow => carryRow.includes(name));
	if (aliasIdx !== -1)
	{
	carry[aliasIdx] = unique(carry[aliasIdx].concat(row));
	return carry;
	}

Don’t dedup during merge, but later in #2.

Fix merge-hypocoristics

Publish to npm