namefully 1.2.1 → 1.3.1

package/dist/lib/namefully.js

@@ -23,27 +23,29 @@ var _Namefully_instances, _Namefully_fullName, _Namefully_toParser, _Namefully_m
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Namefully = void 0;
 const constants_1 = require("./constants");
+const name_1 = require("./name");
 const error_1 = require("./error");
-const parser_1 = require("./parser");
-const types_1 = require("./types");
 const utils_1 = require("./utils");
+const types_1 = require("./types");
+const parser_1 = require("./parser");
 class Namefully {
     constructor(names, options) {
         _Namefully_instances.add(this);
         _Namefully_fullName.set(this, void 0);
+        this.json = this.toJson;
         __classPrivateFieldSet(this, _Namefully_fullName, __classPrivateFieldGet(this, _Namefully_instances, "m", _Namefully_toParser).call(this, names).parse(options), "f");
     }
-    static tryParse(text) {
+    static tryParse(text, index) {
         try {
-            return new this(parser_1.Parser.build(text));
+            return new Namefully(parser_1.Parser.build(text, index));
         }
-        catch (error) {
+        catch (_a) {
             return undefined;
         }
     }
-    static parse(text) {
+    static parse(text, index) {
         return __awaiter(this, void 0, void 0, function* () {
-            return parser_1.Parser.buildAsync(text).then((parser) => new Namefully(parser));
+            return parser_1.Parser.buildAsync(text, index).then((parser) => new Namefully(parser));
         });
     }
     get config() {
@@ -87,25 +89,46 @@ class Namefully {
     get public() {
         return this.format('f $l');
     }
+    get salutation() {
+        return this.format('p l');
+    }
+    get parts() {
+        return __classPrivateFieldGet(this, _Namefully_fullName, "f").toIterable();
+    }
+    get size() {
+        return Array.from(this.parts).length;
+    }
+    *[(_Namefully_fullName = new WeakMap(), _Namefully_instances = new WeakSet(), Symbol.iterator)]() {
+        yield* __classPrivateFieldGet(this, _Namefully_fullName, "f").toIterable(true);
+    }
     toString() {
         return this.full;
     }
-    get(namon) {
-        if (namon.equal(types_1.Namon.PREFIX))
+    get(key) {
+        const namon = typeof key === 'string' ? types_1.Namon.cast(key) : key;
+        if (namon === null || namon === void 0 ? void 0 : namon.equal(types_1.Namon.PREFIX))
             return __classPrivateFieldGet(this, _Namefully_fullName, "f").prefix;
-        if (namon.equal(types_1.Namon.FIRST_NAME))
+        if (namon === null || namon === void 0 ? void 0 : namon.equal(types_1.Namon.FIRST_NAME))
             return __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName;
-        if (namon.equal(types_1.Namon.MIDDLE_NAME))
+        if (namon === null || namon === void 0 ? void 0 : namon.equal(types_1.Namon.MIDDLE_NAME))
             return __classPrivateFieldGet(this, _Namefully_fullName, "f").middleName;
-        if (namon.equal(types_1.Namon.LAST_NAME))
+        if (namon === null || namon === void 0 ? void 0 : namon.equal(types_1.Namon.LAST_NAME))
             return __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName;
-        if (namon.equal(types_1.Namon.SUFFIX))
+        if (namon === null || namon === void 0 ? void 0 : namon.equal(types_1.Namon.SUFFIX))
             return __classPrivateFieldGet(this, _Namefully_fullName, "f").suffix;
         return undefined;
     }
     equal(other) {
         return this.toString() === other.toString();
     }
+    deepEqual(other) {
+        const others = Array.from(other.parts);
+        for (const part of this.parts) {
+            if (!others.some((name) => name.equal(part)))
+                return false;
+        }
+        return true;
+    }
     toJson() {
         return {
             prefix: this.prefix,
@@ -121,21 +144,26 @@ class Namefully {
     fullName(orderedBy) {
         const sep = this.config.ending ? ',' : '';
         const names = [];
-        orderedBy = orderedBy || this.config.orderedBy;
         if (this.prefix)
             names.push(this.prefix);
-        if (orderedBy === types_1.NameOrder.FIRST_NAME) {
+        if ((orderedBy !== null && orderedBy !== void 0 ? orderedBy : this.config.orderedBy) === types_1.NameOrder.FIRST_NAME) {
             names.push(this.first, ...this.middleName(), this.last + sep);
         }
         else {
-            names.push(this.last, this.first, this.middleName().join(' ') + sep);
+            names.push(this.last);
+            if (this.hasMiddle) {
+                names.push(this.first, this.middleName().join(' ') + sep);
+            }
+            else {
+                names.push(this.first + sep);
+            }
         }
         if (this.suffix)
             names.push(this.suffix);
         return names.join(' ').trim();
     }
     birthName(orderedBy) {
-        orderedBy = orderedBy || this.config.orderedBy;
+        orderedBy !== null && orderedBy !== void 0 ? orderedBy : (orderedBy = this.config.orderedBy);
         return orderedBy === types_1.NameOrder.FIRST_NAME
             ? [this.first, ...this.middleName(), this.last].join(' ')
             : [this.last, this.first, ...this.middleName()].join(' ');
@@ -150,50 +178,42 @@ class Namefully {
         return __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.toString(format);
     }
     initials(options) {
-        const initials = [];
+        const { orderedBy = this.config.orderedBy, only = types_1.NameType.BIRTH_NAME, asJson } = options !== null && options !== void 0 ? options : {};
         const firstInits = __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.initials();
-        const midInits = __classPrivateFieldGet(this, _Namefully_fullName, "f").middleName.map((n) => n.initials()[0]);
+        const midInits = __classPrivateFieldGet(this, _Namefully_fullName, "f").middleName.map((n) => n.value[0]);
         const lastInits = __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.initials();
-        const mergedOptions = Object.assign({ orderedBy: this.config.orderedBy, only: types_1.NameType.BIRTH_NAME }, options);
-        const { orderedBy, only } = mergedOptions;
+        if (asJson)
+            return { firstName: firstInits, middleName: midInits, lastName: lastInits };
         if (only !== types_1.NameType.BIRTH_NAME) {
-            if (only === types_1.NameType.FIRST_NAME) {
-                initials.push(...firstInits);
-            }
-            else if (only === types_1.NameType.MIDDLE_NAME) {
-                initials.push(...midInits);
-            }
-            else {
-                initials.push(...lastInits);
-            }
+            return only === types_1.NameType.FIRST_NAME ? firstInits : only === types_1.NameType.MIDDLE_NAME ? midInits : lastInits;
         }
         else if (orderedBy === types_1.NameOrder.FIRST_NAME) {
-            initials.push(...firstInits, ...midInits, ...lastInits);
+            return [...firstInits, ...midInits, ...lastInits];
         }
         else {
-            initials.push(...lastInits, ...firstInits, ...midInits);
+            return [...lastInits, ...firstInits, ...midInits];
         }
-        return initials;
     }
     shorten(orderedBy) {
-        orderedBy = orderedBy || this.config.orderedBy;
+        orderedBy !== null && orderedBy !== void 0 ? orderedBy : (orderedBy = this.config.orderedBy);
+        const { firstName, lastName } = __classPrivateFieldGet(this, _Namefully_fullName, "f");
         return orderedBy === types_1.NameOrder.FIRST_NAME
-            ? [__classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.value, __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.toString()].join(' ')
-            : [__classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.toString(), __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.value].join(' ');
+            ? [firstName.value, lastName.toString()].join(' ')
+            : [lastName.toString(), firstName.value].join(' ');
     }
     flatten(options) {
-        if (this.length <= options.limit)
+        const { by = types_1.Flat.MIDDLE_NAME, limit = 20, recursive = false, withMore = false, withPeriod = true, surname, } = options;
+        if (this.length <= limit)
             return this.full;
-        const mergedOptions = Object.assign({ limit: 20, by: types_1.Flat.MIDDLE_NAME, withPeriod: true, recursive: false, withMore: false }, options);
-        const { by, limit, recursive, withMore, withPeriod, surname } = mergedOptions;
+        const { firstName, lastName, middleName } = __classPrivateFieldGet(this, _Namefully_fullName, "f");
         const sep = withPeriod ? '.' : '';
-        const fn = __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.toString();
-        const mn = this.middleName().join(' ');
-        const ln = __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.toString();
         const hasMid = this.hasMiddle;
-        const f = __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.initials(withMore).join(sep + ' ') + sep;
-        const l = __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.initials(surname).join(sep + ' ') + sep;
-        const m = hasMid ? __classPrivateFieldGet(this, _Namefully_fullName, "f").middleName.map((n) => n.initials()[0]).join(sep + ' ') + sep : '';
+        const fn = firstName.toString();
+        const mn = this.middleName().join(' ');
+        const ln = lastName.toString();
+        const f = firstName.initials(withMore).join(sep + ' ') + sep;
+        const l = lastName.initials(surname).join(sep + ' ') + sep;
+        const m = hasMid ? middleName.map((n) => n.value[0]).join(sep + ' ') + sep : '';
         let name = [];
         if (this.config.orderedBy === types_1.NameOrder.FIRST_NAME) {
             switch (by) {
@@ -212,7 +232,7 @@ class Namefully {
                 case types_1.Flat.MID_LAST:
                     name = hasMid ? [fn, m, l] : [fn, l];
                     break;
-                case types_1.Flat.ALL:
+                default:
                     name = hasMid ? [f, m, l] : [f, l];
                     break;
             }
@@ -234,7 +254,7 @@ class Namefully {
                 case types_1.Flat.MID_LAST:
                     name = hasMid ? [l, fn, m] : [l, fn];
                     break;
-                case types_1.Flat.ALL:
+                default:
                     name = hasMid ? [l, f, m] : [l, f];
                     break;
             }
@@ -275,8 +295,8 @@ class Namefully {
             pattern = 'o';
         let group = '';
         const formatted = [];
-        for (const char of pattern.split('')) {
-            if (constants_1.ALLOWED_TOKENS.indexOf(char) === -1) {
+        for (const char of pattern) {
+            if (!constants_1.ALLOWED_FORMAT_TOKENS.includes(char)) {
                 throw new error_1.NotAllowedError({
                     source: this.full,
                     operation: 'format',
@@ -292,7 +312,8 @@ class Namefully {
         return formatted.join('').trim();
     }
     flip() {
-        this.config.updateOrder(this.config.orderedBy === types_1.NameOrder.FIRST_NAME ? types_1.NameOrder.LAST_NAME : types_1.NameOrder.FIRST_NAME);
+        const order = this.config.orderedBy === types_1.NameOrder.FIRST_NAME ? types_1.NameOrder.LAST_NAME : types_1.NameOrder.FIRST_NAME;
+        this.config.update({ orderedBy: order });
     }
     split(separator = /[' -]/g) {
         return this.birth.replace(separator, ' ').split(' ');
@@ -334,27 +355,21 @@ class Namefully {
     }
 }
 exports.Namefully = Namefully;
-_Namefully_fullName = new WeakMap(), _Namefully_instances = new WeakSet(), _Namefully_toParser = function _Namefully_toParser(raw) {
+_Namefully_toParser = function _Namefully_toParser(raw) {
     if (raw instanceof parser_1.Parser)
         return raw;
     if (typeof raw === 'string')
         return new parser_1.StringParser(raw);
     if ((0, utils_1.isStringArray)(raw))
         return new parser_1.ArrayStringParser(raw);
-    if ((0, utils_1.isNameArray)(raw))
+    if ((0, name_1.isNameArray)(raw))
         return new parser_1.ArrayNameParser(raw);
     if (typeof raw === 'object')
         return new parser_1.NamaParser(raw);
-    throw new error_1.InputError({ source: raw, message: 'Cannot parse raw data. Review expected data types.' });
+    throw new error_1.InputError({ source: raw, message: 'Cannot parse raw data; review expected data types.' });
 }, _Namefully_map = function _Namefully_map(char) {
     var _a, _b;
     switch (char) {
-        case '.':
-        case ',':
-        case ' ':
-        case '-':
-        case '_':
-            return char;
         case 'b':
             return this.birth;
         case 'B':
@@ -372,21 +387,21 @@ _Namefully_fullName = new WeakMap(), _Namefully_instances = new WeakSet(), _Name
             return char === 'm' ? this.middleName().join(' ') : this.middleName().join(' ').toUpperCase();
         case 'o':
         case 'O':
-            const sep = this.config.ending ? ',' : '';
-            const names = [];
-            if (this.prefix)
-                names.push(this.prefix);
-            names.push(`${this.last},`.toUpperCase());
-            if (this.hasMiddle) {
-                names.push(this.first, this.middleName().join(' ') + sep);
-            }
-            else {
-                names.push(this.first + sep);
-            }
-            if (this.suffix)
-                names.push(this.suffix);
-            const nama = names.join(' ').trim();
-            return char === 'o' ? nama : nama.toUpperCase();
+            return ((character) => {
+                const sep = this.config.ending ? ',' : '';
+                const names = [];
+                if (this.prefix)
+                    names.push(this.prefix);
+                names.push(`${this.last},`.toUpperCase());
+                if (this.hasMiddle)
+                    names.push(this.first, this.middleName().join(' ') + sep);
+                else
+                    names.push(this.first + sep);
+                if (this.suffix)
+                    names.push(this.suffix);
+                const nama = names.join(' ').trim();
+                return character === 'o' ? nama : nama.toUpperCase();
+            })(char);
         case 'p':
             return this.prefix;
         case 'P':
@@ -396,15 +411,21 @@ _Namefully_fullName = new WeakMap(), _Namefully_instances = new WeakSet(), _Name
         case 'S':
             return (_b = this.suffix) === null || _b === void 0 ? void 0 : _b.toUpperCase();
         case '$f':
+            return __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.value[0];
         case '$F':
-            return __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.initials()[0];
+            return __classPrivateFieldGet(this, _Namefully_fullName, "f").firstName.initials(true).join('');
         case '$l':
+            return __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.value[0];
         case '$L':
-            return __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.initials()[0];
+            return __classPrivateFieldGet(this, _Namefully_fullName, "f").lastName.initials().join('');
         case '$m':
-        case '$M':
             return this.hasMiddle ? this.middle[0] : undefined;
+        case '$M':
+            return this.hasMiddle ? __classPrivateFieldGet(this, _Namefully_fullName, "f").middleName.map((n) => n.value[0]).join('') : undefined;
         default:
-            return undefined;
+            return constants_1.ALLOWED_FORMAT_TOKENS.includes(char) ? char : undefined;
     }
 };
+exports.default = (names, options) => {
+    return new Namefully(names, options);
+};

package/dist/lib/parser.js

@@ -1,31 +1,28 @@
 "use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _NamaParser_instances, _NamaParser_asNama;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArrayNameParser = exports.NamaParser = exports.ArrayStringParser = exports.StringParser = exports.Parser = void 0;
-const full_name_1 = require("./full-name");
 const config_1 = require("./config");
 const utils_1 = require("./utils");
-const validator_1 = require("./validator");
-const name_1 = require("./name");
-const types_1 = require("./types");
 const error_1 = require("./error");
+const full_name_1 = require("./full-name");
+const types_1 = require("./types");
+const name_1 = require("./name");
+const validator_1 = require("./validator");
 class Parser {
     constructor(raw) {
         this.raw = raw;
     }
-    static build(text) {
+    static build(text, index) {
         const parts = text.trim().split(types_1.Separator.SPACE.token);
         const length = parts.length;
+        if (index instanceof utils_1.NameIndex) {
+            const names = Object.entries(index.json())
+                .filter(([, position]) => position > -1 && position < length)
+                .map(([key, position]) => new name_1.Name(parts[position], types_1.Namon.all.get(key)));
+            return new ArrayNameParser(names);
+        }
         if (length < 2) {
-            throw new error_1.InputError({
-                source: text,
-                message: 'cannot build from invalid input',
-            });
+            throw new error_1.InputError({ source: text, message: 'expecting at least 2 name parts' });
         }
         else if (length === 2 || length === 3) {
             return new StringParser(text);
@@ -36,9 +33,9 @@ class Parser {
             return new ArrayStringParser([first, middles.join(' '), last]);
         }
     }
-    static buildAsync(text) {
+    static buildAsync(text, index) {
         try {
-            return Promise.resolve(Parser.build(text));
+            return Promise.resolve(Parser.build(text, index));
         }
         catch (error) {
             return Promise.reject(error);
@@ -50,14 +47,13 @@ class StringParser extends Parser {
     parse(options) {
         const config = config_1.Config.merge(options);
         const names = this.raw.split(config.separator.token);
-        return new ArrayStringParser(names).parse(options);
+        return new ArrayStringParser(names).parse(config);
     }
 }
 exports.StringParser = StringParser;
 class ArrayStringParser extends Parser {
     parse(options) {
         const config = config_1.Config.merge(options);
-        const fullName = new full_name_1.FullName(config);
         const raw = this.raw.map((n) => n.trim());
         const index = utils_1.NameIndex.when(config.orderedBy, raw.length);
         const validator = new validator_1.ArrayStringValidator(index);
@@ -68,8 +64,9 @@ class ArrayStringParser extends Parser {
             validator.validate(raw);
         }
         const { firstName, lastName, middleName, prefix, suffix } = index;
-        fullName.setFirstName(new name_1.FirstName(raw[firstName]));
-        fullName.setLastName(new name_1.LastName(raw[lastName]));
+        const fullName = new full_name_1.FullName(config)
+            .setFirstName(new name_1.FirstName(raw[firstName]))
+            .setLastName(new name_1.LastName(raw[lastName]));
         if (raw.length >= 3)
             fullName.setMiddleName(raw[middleName].split(config.separator.token));
         if (raw.length >= 4)
@@ -81,39 +78,32 @@ class ArrayStringParser extends Parser {
 }
 exports.ArrayStringParser = ArrayStringParser;
 class NamaParser extends Parser {
-    constructor() {
-        super(...arguments);
-        _NamaParser_instances.add(this);
-    }
     parse(options) {
         const config = config_1.Config.merge(options);
+        const names = new Map(Object.entries(this.raw).map(([key, value]) => {
+            const namon = types_1.Namon.cast(key);
+            if (!namon) {
+                throw new error_1.InputError({
+                    source: Object.values(this.raw).join(' '),
+                    message: `unsupported key "${key}"`,
+                });
+            }
+            return [namon, value];
+        }));
         if (config.bypass) {
-            validator_1.NamaValidator.create().validateKeys(__classPrivateFieldGet(this, _NamaParser_instances, "m", _NamaParser_asNama).call(this));
+            validator_1.Validators.nama.validateKeys(names);
         }
         else {
-            validator_1.NamaValidator.create().validate(__classPrivateFieldGet(this, _NamaParser_instances, "m", _NamaParser_asNama).call(this));
+            validator_1.Validators.nama.validate(names);
         }
         return full_name_1.FullName.parse(this.raw, config);
     }
 }
 exports.NamaParser = NamaParser;
-_NamaParser_instances = new WeakSet(), _NamaParser_asNama = function _NamaParser_asNama() {
-    return new Map(Object.entries(this.raw).map(([key, value]) => {
-        const namon = types_1.Namon.cast(key);
-        if (!namon) {
-            throw new error_1.InputError({
-                source: Object.values(this.raw).join(' '),
-                message: `unsupported key "${key}"`,
-            });
-        }
-        return [namon, value];
-    }));
-};
 class ArrayNameParser extends Parser {
     parse(options) {
-        const config = config_1.Config.merge(options);
-        const fullName = new full_name_1.FullName(config);
         validator_1.ArrayNameValidator.create().validate(this.raw);
+        const fullName = new full_name_1.FullName(options);
         for (const name of this.raw) {
             if (name.isPrefix) {
                 fullName.setPrefix(name);
@@ -128,8 +118,8 @@ class ArrayNameParser extends Parser {
                 fullName.middleName.push(name);
             }
             else if (name.isLastName) {
-                const lastName = new name_1.LastName(name.value, name instanceof name_1.LastName ? name.mother : undefined, config.surname);
-                fullName.setLastName(lastName);
+                const mother = name instanceof name_1.LastName ? name.mother : undefined;
+                fullName.setLastName(new name_1.LastName(name.value, mother, fullName.config.surname));
             }
         }
         return fullName;

package/dist/lib/types.js

@@ -49,7 +49,10 @@ class Namon {
         return Namon.all.has(key);
     }
     static cast(key) {
-        return Namon.has(key) ? Namon.all.get(key) : undefined;
+        var _a;
+        const searchValue = String(key).toLowerCase();
+        const namon = (_a = Object.entries(Namon.aliases).find(([, list]) => list.includes(searchValue))) === null || _a === void 0 ? void 0 : _a[0];
+        return Namon.has(namon !== null && namon !== void 0 ? namon : '') ? Namon.all.get(key) : undefined;
     }
     toString() {
         return `Namon.${this.key}`;
@@ -72,11 +75,26 @@ Namon.all = new Map([
     [Namon.LAST_NAME.key, Namon.LAST_NAME],
     [Namon.SUFFIX.key, Namon.SUFFIX],
 ]);
+Namon.aliases = {
+    [Namon.PREFIX.key]: ['prefix', 'px', 'p'],
+    [Namon.FIRST_NAME.key]: ['firstname', 'first', 'fn', 'f'],
+    [Namon.MIDDLE_NAME.key]: ['middlename', 'middle', 'mid', 'mn', 'm'],
+    [Namon.LAST_NAME.key]: ['lastname', 'last', 'ln', 'l'],
+    [Namon.SUFFIX.key]: ['suffix', 'sx', 's'],
+};
 class Separator {
     constructor(name, token) {
         this.name = name;
         this.token = token;
     }
+    static cast(key) {
+        for (const [name, separator] of Separator.all) {
+            if (separator.token === key || name.toLowerCase() === key.toLowerCase()) {
+                return separator;
+            }
+        }
+        return undefined;
+    }
     toString() {
         return `Separator.${this.name}`;
     }

package/dist/lib/utils.js

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isNameArray = exports.isStringArray = exports.toggleCase = exports.decapitalize = exports.capitalize = exports.NameIndex = void 0;
-const constants_1 = require("./constants");
-const name_1 = require("./name");
+exports.isStringArray = exports.toggleCase = exports.decapitalize = exports.capitalize = exports.NameIndex = void 0;
 const types_1 = require("./types");
+const constants_1 = require("./constants");
 class NameIndex {
     static get min() {
         return constants_1.MIN_NUMBER_OF_NAME_PARTS;
@@ -17,21 +16,22 @@ class NameIndex {
         this.middleName = middleName;
         this.lastName = lastName;
         this.suffix = suffix;
+        this.json = this.toJson;
     }
     static base() {
-        return new this(-1, 0, -1, 1, -1);
+        return new NameIndex(-1, 0, -1, 1, -1);
     }
     static when(order, count = 2) {
         if (order === types_1.NameOrder.FIRST_NAME) {
             switch (count) {
                 case 2:
-                    return new this(-1, 0, -1, 1, -1);
+                    return new NameIndex(-1, 0, -1, 1, -1);
                 case 3:
-                    return new this(-1, 0, 1, 2, -1);
+                    return new NameIndex(-1, 0, 1, 2, -1);
                 case 4:
-                    return new this(0, 1, 2, 3, -1);
+                    return new NameIndex(0, 1, 2, 3, -1);
                 case 5:
-                    return new this(0, 1, 2, 3, 4);
+                    return new NameIndex(0, 1, 2, 3, 4);
                 default:
                     return NameIndex.base();
             }
@@ -39,54 +39,54 @@ class NameIndex {
         else {
             switch (count) {
                 case 2:
-                    return new this(-1, 1, -1, 0, -1);
+                    return new NameIndex(-1, 1, -1, 0, -1);
                 case 3:
-                    return new this(-1, 1, 2, 0, -1);
+                    return new NameIndex(-1, 1, 2, 0, -1);
                 case 4:
-                    return new this(0, 2, 3, 1, -1);
+                    return new NameIndex(0, 2, 3, 1, -1);
                 case 5:
-                    return new this(0, 2, 3, 1, 4);
+                    return new NameIndex(0, 2, 3, 1, 4);
                 default:
                     return NameIndex.base();
             }
         }
     }
+    static only({ prefix = -1, firstName, middleName = -1, lastName, suffix = -1 }) {
+        return new NameIndex(prefix, firstName, middleName, lastName, suffix);
+    }
+    toJson() {
+        return {
+            prefix: this.prefix,
+            firstName: this.firstName,
+            middleName: this.middleName,
+            lastName: this.lastName,
+            suffix: this.suffix,
+        };
+    }
 }
 exports.NameIndex = NameIndex;
 function capitalize(str, range = types_1.CapsRange.INITIAL) {
     if (!str || range === types_1.CapsRange.NONE)
         return str;
-    const initial = str[0].toUpperCase();
-    const rest = str.slice(1).toLowerCase();
+    const [initial, rest] = [str[0].toUpperCase(), str.slice(1).toLowerCase()];
     return range === types_1.CapsRange.INITIAL ? initial.concat(rest) : str.toUpperCase();
 }
 exports.capitalize = capitalize;
 function decapitalize(str, range = types_1.CapsRange.INITIAL) {
     if (!str || range === types_1.CapsRange.NONE)
         return str;
-    const initial = str[0].toLowerCase();
-    const rest = str.slice(1);
+    const [initial, rest] = [str[0].toLowerCase(), str.slice(1)];
     return range === types_1.CapsRange.INITIAL ? initial.concat(rest) : str.toLowerCase();
 }
 exports.decapitalize = decapitalize;
 function toggleCase(str) {
-    const chars = [];
-    for (const c of str) {
-        if (c === c.toUpperCase()) {
-            chars.push(c.toLowerCase());
-        }
-        else {
-            chars.push(c.toUpperCase());
-        }
-    }
-    return chars.join('');
+    return str
+        .split('')
+        .map((c) => (c === c.toUpperCase() ? c.toLowerCase() : c.toUpperCase()))
+        .join('');
 }
 exports.toggleCase = toggleCase;
 function isStringArray(value) {
     return Array.isArray(value) && value.length > 0 && value.every((e) => typeof e === 'string');
 }
 exports.isStringArray = isStringArray;
-function isNameArray(value) {
-    return Array.isArray(value) && value.length > 0 && value.every((e) => e instanceof name_1.Name);
-}
-exports.isNameArray = isNameArray;