namefully 2.1.0 → 2.2.0

package/dist/cjs/builder.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NameBuilder = void 0;
+const config_js_1 = require("./config.js");
 const validator_js_1 = require("./validator.js");
 const namefully_js_1 = require("./namefully.js");
 class Builder {
@@ -73,8 +74,10 @@ class NameBuilder extends Builder {
     build(options) {
         this.prebuild?.();
         const names = [...this.queue];
-        validator_js_1.ArrayNameValidator.create().validate(names);
-        this.instance = new namefully_js_1.Namefully(names, options);
+        const config = config_js_1.Config.merge(options);
+        if (!config.mono)
+            validator_js_1.ArrayNameValidator.create().validate(names);
+        this.instance = new namefully_js_1.Namefully(names, config);
         this.postbuild?.(this.instance);
         return this.instance;
     }

package/dist/cjs/config.js

@@ -13,6 +13,7 @@ class Config {
     #ending;
     #bypass;
     #surname;
+    #mono;
     static cache = new Map();
     get orderedBy() {
         return this.#orderedBy;
@@ -32,10 +33,13 @@ class Config {
     get surname() {
         return this.#surname;
     }
+    get mono() {
+        return this.#mono;
+    }
     get name() {
         return this.#name;
     }
-    constructor(name, orderedBy = types_js_1.NameOrder.FIRST_NAME, separator = types_js_1.Separator.SPACE, title = types_js_1.Title.UK, ending = false, bypass = true, surname = types_js_1.Surname.FATHER) {
+    constructor(name, orderedBy = types_js_1.NameOrder.FIRST_NAME, separator = types_js_1.Separator.SPACE, title = types_js_1.Title.UK, ending = false, bypass = true, surname = types_js_1.Surname.FATHER, mono = false) {
         this.#name = name;
         this.#orderedBy = orderedBy;
         this.#separator = separator;
@@ -43,6 +47,7 @@ class Config {
         this.#ending = ending;
         this.#bypass = bypass;
         this.#surname = surname;
+        this.#mono = mono;
     }
     static create(name = defaultName) {
         if (!_a.cache.has(name))
@@ -61,11 +66,12 @@ class Config {
             config.#ending = other.ending ?? config.ending;
             config.#bypass = other.bypass ?? config.bypass;
             config.#surname = other.surname ?? config.surname;
+            config.#mono = other.mono ?? config.mono;
             return config;
         }
     }
     copyWith(options = {}) {
-        const { name, orderedBy, separator, title, ending, bypass, surname } = options;
+        const { name, orderedBy, separator, title, ending, bypass, surname, mono } = options;
         const config = _a.create(this.#genNewName(name ?? this.name + copyAlias));
         config.#orderedBy = orderedBy ?? this.orderedBy;
         config.#separator = separator ?? this.separator;
@@ -73,6 +79,7 @@ class Config {
         config.#ending = ending ?? this.ending;
         config.#bypass = bypass ?? this.bypass;
         config.#surname = surname ?? this.surname;
+        config.#mono = mono ?? this.mono;
         return config;
     }
     clone() {
@@ -85,11 +92,9 @@ class Config {
         this.#ending = false;
         this.#bypass = true;
         this.#surname = types_js_1.Surname.FATHER;
+        this.#mono = false;
         _a.cache.set(this.name, this);
     }
-    updateOrder(orderedBy) {
-        this.update({ orderedBy });
-    }
     update({ orderedBy, title, ending }) {
         const config = _a.cache.get(this.name);
         if (!config)

package/dist/cjs/constants.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALLOWED_FORMAT_TOKENS = exports.MAX_NUMBER_OF_NAME_PARTS = exports.MIN_NUMBER_OF_NAME_PARTS = exports.VERSION = void 0;
-exports.VERSION = '2.1.0';
+exports.ZERO_WIDTH_SPACE = exports.ALLOWED_FORMAT_TOKENS = exports.MAX_NUMBER_OF_NAME_PARTS = exports.MIN_NUMBER_OF_NAME_PARTS = exports.VERSION = void 0;
+exports.VERSION = '2.2.0';
 exports.MIN_NUMBER_OF_NAME_PARTS = 2;
 exports.MAX_NUMBER_OF_NAME_PARTS = 5;
 exports.ALLOWED_FORMAT_TOKENS = ` .,_-()[]<>'"bBfFlLmMnNoOpPsS$`;
+exports.ZERO_WIDTH_SPACE = String.fromCharCode(8203);

package/dist/cjs/data.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deserialize = void 0;
 const builder_js_1 = require("./builder.js");
+const types_js_1 = require("./types.js");
 const name_js_1 = require("./name.js");
 const error_js_1 = require("./error.js");
 function deserialize(data) {
@@ -21,10 +22,12 @@ function deserialize(data) {
         if (sx)
             builder.add(name_js_1.Name.suffix(sx));
         if (mn)
-            builder.add(...mn.map((n) => name_js_1.Name.middle(n)));
+            builder.add(...(typeof mn === 'string' ? [name_js_1.Name.middle(mn)] : mn.map((n) => name_js_1.Name.middle(n))));
         builder.add(typeof fn === 'string' ? name_js_1.Name.first(fn) : new name_js_1.FirstName(fn.value, ...(fn.more ?? [])));
         builder.add(typeof ln === 'string' ? name_js_1.Name.last(ln) : new name_js_1.LastName(ln.father, ln.mother));
-        return builder.build(config);
+        const separator = types_js_1.Separator.cast(config.separator);
+        const mono = typeof config.mono === 'string' ? (types_js_1.Namon.cast(config.mono) ?? false) : config.mono;
+        return builder.build({ ...config, separator, mono });
     }
     catch (error) {
         if (error instanceof error_js_1.NameError)

package/dist/cjs/fullname.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FullName = void 0;
+exports.Mononym = exports.FullName = void 0;
 const config_js_1 = require("./config.js");
 const validator_js_1 = require("./validator.js");
+const constants_js_1 = require("./constants.js");
 const types_js_1 = require("./types.js");
 const error_js_1 = require("./error.js");
 const name_js_1 = require("./name.js");
@@ -34,14 +35,18 @@ class FullName {
     get suffix() {
         return this.#suffix;
     }
+    get isMono() {
+        return this instanceof Mononym;
+    }
     static parse(json, config) {
         try {
+            const { prefix, firstName: fn, middleName: mn, lastName: ln, suffix } = json;
             return new FullName(config)
-                .setPrefix(json.prefix)
-                .setFirstName(json.firstName)
-                .setMiddleName(json.middleName ?? [])
-                .setLastName(json.lastName)
-                .setSuffix(json.suffix);
+                .setPrefix(prefix)
+                .setFirstName(typeof fn === 'string' ? fn : new name_js_1.FirstName(fn.value, ...(fn.more ?? [])))
+                .setMiddleName(typeof mn === 'string' ? [mn] : (mn ?? []))
+                .setLastName(typeof ln === 'string' ? ln : new name_js_1.LastName(ln.father, ln.mother))
+                .setSuffix(suffix);
         }
         catch (error) {
             if (error instanceof error_js_1.NameError)
@@ -59,7 +64,7 @@ class FullName {
         if (!this.#config.bypass)
             validator_js_1.Validators.prefix.validate(name);
         const prefix = name instanceof name_js_1.Name ? name.value : name;
-        this.#prefix = name_js_1.Name.prefix(this.#config.title === types_js_1.Title.US ? `${prefix}.` : prefix);
+        this.#prefix = name_js_1.Name.prefix(this.#config.title === types_js_1.Title.US && !prefix.endsWith('.') ? `${prefix}.` : prefix);
         return this;
     }
     setFirstName(name) {
@@ -100,6 +105,11 @@ class FullName {
             return !!this.#suffix;
         return namon.equal(types_js_1.Namon.MIDDLE_NAME) ? this.#middleName.length > 0 : true;
     }
+    toString() {
+        if (this.isMono)
+            return this.value;
+        return Array.from(this.toIterable(true)).join(' ');
+    }
     *toIterable(flat = false) {
         if (this.#prefix)
             yield this.#prefix;
@@ -121,3 +131,38 @@ class FullName {
     }
 }
 exports.FullName = FullName;
+class Mononym extends FullName {
+    #namon;
+    #type;
+    constructor(name, options) {
+        super(options ?? { name: 'mononym', mono: true });
+        this.#namon = name.toString();
+        this.type = name instanceof name_js_1.Name ? name.type : types_js_1.Namon.FIRST_NAME;
+    }
+    set type(type) {
+        this.#type = typeof type === 'string' ? (types_js_1.Namon.cast(type) ?? types_js_1.Namon.FIRST_NAME) : type;
+        this.#build(this.#namon);
+    }
+    get type() {
+        return this.#type;
+    }
+    get value() {
+        return this.#namon;
+    }
+    #build(name) {
+        this.setFirstName(constants_js_1.ZERO_WIDTH_SPACE).setLastName(constants_js_1.ZERO_WIDTH_SPACE).setMiddleName([]).setPrefix(null).setSuffix(null);
+        if (this.#type.equal(types_js_1.Namon.FIRST_NAME))
+            this.setFirstName(name);
+        else if (this.#type.equal(types_js_1.Namon.LAST_NAME))
+            this.setLastName(name);
+        else if (this.#type.equal(types_js_1.Namon.MIDDLE_NAME))
+            this.setMiddleName([name]);
+        else if (this.#type.equal(types_js_1.Namon.PREFIX))
+            this.setPrefix(name);
+        else if (this.#type.equal(types_js_1.Namon.SUFFIX))
+            this.setSuffix(name);
+        else
+            throw new error_js_1.NameError(name, 'invalid mononym type');
+    }
+}
+exports.Mononym = Mononym;

package/dist/cjs/namefully.js

@@ -26,7 +26,12 @@ class Namefully {
     get config() {
         return this.#fullName.config;
     }
+    get isMono() {
+        return this.#fullName.isMono;
+    }
     get length() {
+        if (this.isMono)
+            return this.#fullName.toString().length;
         return this.birth.length;
     }
     get prefix() {
@@ -116,6 +121,8 @@ class Namefully {
         return this.#fullName.has(namon);
     }
     fullName(orderedBy) {
+        if (this.isMono)
+            return this.#fullName.toString();
         const sep = this.config.ending ? ',' : '';
         const names = [];
         if (this.prefix)
@@ -124,13 +131,21 @@ class Namefully {
             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) {
+        if (this.isMono)
+            return this.#fullName.toString();
         orderedBy ??= this.config.orderedBy;
         return orderedBy === types_js_1.NameOrder.FIRST_NAME
             ? [this.first, ...this.middleName(), this.last].join(' ')
@@ -146,6 +161,8 @@ class Namefully {
         return this.#fullName.lastName.toString(format);
     }
     initials(options) {
+        if (this.isMono)
+            return [this.#fullName.toString()[0]];
         const { orderedBy = this.config.orderedBy, only = types_js_1.NameType.BIRTH_NAME, asJson } = options ?? {};
         const firstInits = this.#fullName.firstName.initials();
         const midInits = this.#fullName.middleName.map((n) => n.value[0]);
@@ -163,6 +180,8 @@ class Namefully {
         }
     }
     shorten(orderedBy) {
+        if (this.isMono)
+            return this.#fullName.toString();
         orderedBy ??= this.config.orderedBy;
         const { firstName, lastName } = this.#fullName;
         return orderedBy === types_js_1.NameOrder.FIRST_NAME
@@ -173,6 +192,8 @@ class Namefully {
         const { by = types_js_1.Flat.MIDDLE_NAME, limit = 20, recursive = false, withMore = false, withPeriod = true, surname, } = options;
         if (this.length <= limit)
             return this.full;
+        if (this.isMono)
+            return `${this.initials()}${withPeriod ? '.' : ''}`;
         const { firstName, lastName, middleName } = this.#fullName;
         const sep = withPeriod ? '.' : '';
         const hasMid = this.hasMiddle;
@@ -320,6 +341,28 @@ class Namefully {
     toToggleCase() {
         return (0, utils_js_1.toggleCase)(this.birth);
     }
+    serialize() {
+        const { config, firstName: fn, lastName: ln } = this.#fullName;
+        return {
+            names: {
+                prefix: this.prefix,
+                firstName: fn.hasMore ? { value: fn.value, more: fn.more } : fn.value,
+                middleName: this.hasMiddle ? this.middleName() : undefined,
+                lastName: ln.hasMother ? { father: ln.father, mother: ln.mother } : ln.value,
+                suffix: this.suffix,
+            },
+            config: {
+                name: config.name,
+                orderedBy: config.orderedBy,
+                separator: config.separator.token,
+                title: config.title,
+                ending: config.ending,
+                bypass: config.bypass,
+                surname: config.surname,
+                mono: config.mono instanceof types_js_1.Namon ? config.mono.key : config.mono,
+            },
+        };
+    }
     #toParser(raw) {
         if (raw instanceof parser_js_1.Parser)
             return raw;
@@ -391,27 +434,6 @@ class Namefully {
                 return constants_js_1.ALLOWED_FORMAT_TOKENS.includes(char) ? char : undefined;
         }
     }
-    serialize() {
-        const { config, firstName: fn, lastName: ln } = this.#fullName;
-        return {
-            names: {
-                prefix: this.prefix,
-                firstName: fn.hasMore ? { value: fn.value, more: fn.more } : fn.value,
-                middleName: this.hasMiddle ? this.middleName() : undefined,
-                lastName: ln.hasMother ? { father: ln.father, mother: ln.mother } : ln.value,
-                suffix: this.suffix,
-            },
-            config: {
-                name: config.name,
-                orderedBy: config.orderedBy,
-                separator: config.separator.token,
-                title: config.title,
-                ending: config.ending,
-                bypass: config.bypass,
-                surname: config.surname,
-            },
-        };
-    }
 }
 exports.Namefully = Namefully;
 exports.default = (names, options) => {

package/dist/cjs/parser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArrayNameParser = exports.NamaParser = exports.ArrayStringParser = exports.StringParser = exports.Parser = void 0;
+exports.MonoParser = exports.ArrayNameParser = exports.NamaParser = exports.ArrayStringParser = exports.StringParser = exports.Parser = void 0;
 const config_js_1 = require("./config.js");
 const utils_js_1 = require("./utils.js");
 const error_js_1 = require("./error.js");
@@ -23,10 +23,7 @@ class Parser {
             return new ArrayNameParser(names);
         }
         if (length < 2) {
-            throw new error_js_1.InputError({
-                source: text,
-                message: 'cannot build from invalid input',
-            });
+            throw new error_js_1.InputError({ source: text, message: 'expecting at least 2 name parts' });
         }
         else if (length === 2 || length === 3) {
             return new StringParser(text);
@@ -51,14 +48,16 @@ class StringParser extends Parser {
     parse(options) {
         const config = config_js_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_js_1.Config.merge(options);
-        const fullName = new fullname_js_1.FullName(config);
+        if (this.raw.length === 1 && config.mono) {
+            return new MonoParser(this.raw[0]).parse(config);
+        }
         const raw = this.raw.map((n) => n.trim());
         const index = utils_js_1.NameIndex.when(config.orderedBy, raw.length);
         const validator = new validator_js_1.ArrayStringValidator(index);
@@ -69,8 +68,9 @@ class ArrayStringParser extends Parser {
             validator.validate(raw);
         }
         const { firstName, lastName, middleName, prefix, suffix } = index;
-        fullName.setFirstName(new name_js_1.FirstName(raw[firstName]));
-        fullName.setLastName(new name_js_1.LastName(raw[lastName]));
+        const fullName = new fullname_js_1.FullName(config)
+            .setFirstName(new name_js_1.FirstName(raw[firstName]))
+            .setLastName(new name_js_1.LastName(raw[lastName]));
         if (raw.length >= 3)
             fullName.setMiddleName(raw[middleName].split(config.separator.token));
         if (raw.length >= 4)
@@ -95,10 +95,10 @@ class NamaParser extends Parser {
             return [namon, value];
         }));
         if (config.bypass) {
-            validator_js_1.NamaValidator.create().validateKeys(names);
+            validator_js_1.Validators.nama.validateKeys(names);
         }
         else {
-            validator_js_1.NamaValidator.create().validate(names);
+            validator_js_1.Validators.nama.validate(names);
         }
         return fullname_js_1.FullName.parse(this.raw, config);
     }
@@ -107,8 +107,13 @@ exports.NamaParser = NamaParser;
 class ArrayNameParser extends Parser {
     parse(options) {
         const config = config_js_1.Config.merge(options);
+        if (this.raw.length === 1 && config.mono) {
+            return new MonoParser(this.raw[0]).parse(options);
+        }
+        else {
+            validator_js_1.ArrayNameValidator.create().validate(this.raw);
+        }
         const fullName = new fullname_js_1.FullName(config);
-        validator_js_1.ArrayNameValidator.create().validate(this.raw);
         for (const name of this.raw) {
             if (name.isPrefix) {
                 fullName.setPrefix(name);
@@ -131,3 +136,14 @@ class ArrayNameParser extends Parser {
     }
 }
 exports.ArrayNameParser = ArrayNameParser;
+class MonoParser extends Parser {
+    parse(options) {
+        const config = config_js_1.Config.merge(options);
+        if (config.bypass)
+            validator_js_1.Validators.namon.validate(this.raw);
+        const type = config.mono instanceof types_js_1.Namon ? config.mono : types_js_1.Namon.FIRST_NAME;
+        const name = this.raw instanceof name_js_1.Name ? this.raw : new name_js_1.Name(this.raw.trim(), type);
+        return new fullname_js_1.Mononym(name, config);
+    }
+}
+exports.MonoParser = MonoParser;

package/dist/esm/builder.js

@@ -1,3 +1,4 @@
+import { Config } from './config.js';
 import { ArrayNameValidator } from './validator.js';
 import { Namefully } from './namefully.js';
 class Builder {
@@ -70,8 +71,10 @@ export class NameBuilder extends Builder {
     build(options) {
         this.prebuild?.();
         const names = [...this.queue];
-        ArrayNameValidator.create().validate(names);
-        this.instance = new Namefully(names, options);
+        const config = Config.merge(options);
+        if (!config.mono)
+            ArrayNameValidator.create().validate(names);
+        this.instance = new Namefully(names, config);
         this.postbuild?.(this.instance);
         return this.instance;
     }

package/dist/esm/config.d.ts

@@ -1,4 +1,4 @@
-import { NameOrder, Separator, Title, Surname } from './types.js';
+import { NameOrder, Namon, Separator, Title, Surname } from './types.js';
 /**
  * The Configuration to use across the other components.
  *
@@ -61,6 +61,8 @@ export declare class Config {
      * prioritized and viewed as the source of truth for future considerations.
      */
     get surname(): Surname;
+    /** Whether to parse a single word name as a mononym. */
+    get mono(): boolean | Namon;
     /** The name of the cached configuration. */
     get name(): string;
     private constructor();
@@ -89,14 +91,6 @@ export declare class Config {
     clone(): Config;
     /** Resets the configuration by setting it back to its default values. */
     reset(): void;
-    /**
-     * Alters the name order between the first and last name, and rearrange the
-     * order of appearance of a name set.
-     * @deprecated use `update()` method instead.
-     */
-    updateOrder(orderedBy: NameOrder): void;
-    /**
-     * Allows the possibility to alter some options after creating a name set.
-     */
+    /** Allows the possibility to alter behavior-related options after creating a name set. */
     update({ orderedBy, title, ending }: Partial<Pick<Config, 'orderedBy' | 'title' | 'ending'>>): void;
 }

package/dist/esm/config.js

@@ -10,6 +10,7 @@ export class Config {
     #ending;
     #bypass;
     #surname;
+    #mono;
     static cache = new Map();
     get orderedBy() {
         return this.#orderedBy;
@@ -29,10 +30,13 @@ export class Config {
     get surname() {
         return this.#surname;
     }
+    get mono() {
+        return this.#mono;
+    }
     get name() {
         return this.#name;
     }
-    constructor(name, orderedBy = NameOrder.FIRST_NAME, separator = Separator.SPACE, title = Title.UK, ending = false, bypass = true, surname = Surname.FATHER) {
+    constructor(name, orderedBy = NameOrder.FIRST_NAME, separator = Separator.SPACE, title = Title.UK, ending = false, bypass = true, surname = Surname.FATHER, mono = false) {
         this.#name = name;
         this.#orderedBy = orderedBy;
         this.#separator = separator;
@@ -40,6 +44,7 @@ export class Config {
         this.#ending = ending;
         this.#bypass = bypass;
         this.#surname = surname;
+        this.#mono = mono;
     }
     static create(name = defaultName) {
         if (!_a.cache.has(name))
@@ -58,11 +63,12 @@ export class Config {
             config.#ending = other.ending ?? config.ending;
             config.#bypass = other.bypass ?? config.bypass;
             config.#surname = other.surname ?? config.surname;
+            config.#mono = other.mono ?? config.mono;
             return config;
         }
     }
     copyWith(options = {}) {
-        const { name, orderedBy, separator, title, ending, bypass, surname } = options;
+        const { name, orderedBy, separator, title, ending, bypass, surname, mono } = options;
         const config = _a.create(this.#genNewName(name ?? this.name + copyAlias));
         config.#orderedBy = orderedBy ?? this.orderedBy;
         config.#separator = separator ?? this.separator;
@@ -70,6 +76,7 @@ export class Config {
         config.#ending = ending ?? this.ending;
         config.#bypass = bypass ?? this.bypass;
         config.#surname = surname ?? this.surname;
+        config.#mono = mono ?? this.mono;
         return config;
     }
     clone() {
@@ -82,11 +89,9 @@ export class Config {
         this.#ending = false;
         this.#bypass = true;
         this.#surname = Surname.FATHER;
+        this.#mono = false;
         _a.cache.set(this.name, this);
     }
-    updateOrder(orderedBy) {
-        this.update({ orderedBy });
-    }
     update({ orderedBy, title, ending }) {
         const config = _a.cache.get(this.name);
         if (!config)

package/dist/esm/constants.d.ts

@@ -1,4 +1,5 @@
-export declare const VERSION = "2.1.0";
+export declare const VERSION = "2.2.0";
 export declare const MIN_NUMBER_OF_NAME_PARTS = 2;
 export declare const MAX_NUMBER_OF_NAME_PARTS = 5;
 export declare const ALLOWED_FORMAT_TOKENS = " .,_-()[]<>'\"bBfFlLmMnNoOpPsS$";
+export declare const ZERO_WIDTH_SPACE: string;

package/dist/esm/constants.js

@@ -1,4 +1,5 @@
-export const VERSION = '2.1.0';
+export const VERSION = '2.2.0';
 export const MIN_NUMBER_OF_NAME_PARTS = 2;
 export const MAX_NUMBER_OF_NAME_PARTS = 5;
 export const ALLOWED_FORMAT_TOKENS = ` .,_-()[]<>'"bBfFlLmMnNoOpPsS$`;
+export const ZERO_WIDTH_SPACE = String.fromCharCode(8203);

package/dist/esm/data.d.ts

@@ -1,20 +1,9 @@
+import { JsonName } from './name.js';
 import { type Namefully } from './namefully.js';
 /** Serialized representation of a Namefully instance. */
 export interface SerializedName {
     /** The name data (with its hierarchy intact). */
-    names: {
-        prefix?: string;
-        firstName: string | {
-            value: string;
-            more?: string[];
-        };
-        middleName?: string[];
-        lastName: string | {
-            father: string;
-            mother?: string;
-        };
-        suffix?: string;
-    };
+    names: JsonName;
     /** The configuration data. */
     config: {
         name: string;
@@ -24,6 +13,7 @@ export interface SerializedName {
         ending: boolean;
         bypass: boolean;
         surname: string;
+        mono: boolean | string;
     };
 }
 /**

package/dist/esm/data.js

@@ -1,4 +1,5 @@
 import { NameBuilder } from './builder.js';
+import { Namon, Separator } from './types.js';
 import { Name, FirstName, LastName } from './name.js';
 import { InputError, NameError, UnknownError } from './error.js';
 export function deserialize(data) {
@@ -18,10 +19,12 @@ export function deserialize(data) {
         if (sx)
             builder.add(Name.suffix(sx));
         if (mn)
-            builder.add(...mn.map((n) => Name.middle(n)));
+            builder.add(...(typeof mn === 'string' ? [Name.middle(mn)] : mn.map((n) => Name.middle(n))));
         builder.add(typeof fn === 'string' ? Name.first(fn) : new FirstName(fn.value, ...(fn.more ?? [])));
         builder.add(typeof ln === 'string' ? Name.last(ln) : new LastName(ln.father, ln.mother));
-        return builder.build(config);
+        const separator = Separator.cast(config.separator);
+        const mono = typeof config.mono === 'string' ? (Namon.cast(config.mono) ?? false) : config.mono;
+        return builder.build({ ...config, separator, mono });
     }
     catch (error) {
         if (error instanceof NameError)

package/dist/esm/fullname.d.ts

@@ -36,6 +36,8 @@ export declare class FullName {
     get middleName(): Name[];
     /** The suffix part of the full name. */
     get suffix(): Nullable<Name>;
+    /** Whether the full name is a single word name. */
+    get isMono(): boolean;
     /**
      * Parses a JSON name into a full name.
      * @param {JsonName} json parsable name element
@@ -49,8 +51,39 @@ export declare class FullName {
     setSuffix(name: Nullable<string | Name>): FullName;
     /** Returns true if a namon has been set. */
     has(key: Namon | string): boolean;
+    toString(): string;
     /** Returns an `Iterable` of existing `Name`s. */
     toIterable(flat?: boolean): Iterable<Name>;
     /** Returns the default iterator for this name set (enabling for-of statements). */
     [Symbol.iterator](): Iterator<Name>;
 }
+/**
+ * A single word name or mononym.
+ *
+ * This is a special case of `FullName` that is used to represent mononyms. This contradicts
+ * the original purpose of this library such as shaping and organizing name pieces accordingly.
+ *
+ * When enabled via `Config.mono`, this becomes the full name of a human. And as a single name,
+ * most of the `Namefully` methods become irrelevant.
+ */
+export declare class Mononym extends FullName {
+    #private;
+    /**
+     * Constructs a mononym from a piece of string.
+     * @param {string | Name} name to be used to construct the mononym.
+     */
+    constructor(name: string | Name, options?: Partial<Config>);
+    /**
+     * Re-assigns which name type is being used to represent the mononym.
+     *
+     * Ideally, this doesn't really matter as the mononym is always a single piece of name.
+     * When used as `string`, it must be a valid `Namon` type or else it will default to
+     * `Namon.FIRST_NAME`.
+     * @param {string | Namon} type of name to use.
+     */
+    set type(type: string | Namon);
+    /** The type of name being used to represent the mononym. */
+    get type(): Namon;
+    /** The piece of string treated as a name. */
+    get value(): string;
+}