typia 9.7.0 → 9.7.2

package/src/misc.ts

@@ -26,10 +26,9 @@ import { TypeGuardError } from "./TypeGuardError";
  * literals<"A" | "B" | 1>; // ["A", "B", 1]
  * ```
  *
- * @template T Union literal type
- * @return Array of union literal type's members
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T Union literal type
+ * @returns Array of union literal type's members
  */
 export function literals(): never;
 
@@ -42,16 +41,13 @@ export function literals(): never;
  * literals<"A" | "B" | 1>; // ["A", "B", 1]
  * ```
  *
- * @template T Union literal type
- * @return Array of union literal type's members
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @template T Union literal type
+ * @returns Array of union literal type's members
  */
 export function literals<T extends Atomic.Type | null>(): T[];
 
-/**
- * @internal
- */
+/** @internal */
 export function literals(): never {
   NoTransformConfigurationError("misc.literals");
 }
@@ -62,26 +58,23 @@ export function literals(): never {
 /**
  * Clone data.
  *
- * Clones an instance following type `T`. If the target *input* value or its member
- * variable contains a class instance having methods, those methods would not be
- * cloned.
+ * Clones an instance following type `T`. If the target _input_ value or its
+ * member variable contains a class instance having methods, those methods would
+ * not be cloned.
  *
- * For reference, this `typia.misc.clone()` function does not validate the input value
- * type. It just believes that the input value is following the type `T`. Therefore,
- * if you can't ensure the input value type, it would be better to call
- * {@link assertClone} function instead.
+ * For reference, this `typia.misc.clone()` function does not validate the input
+ * value type. It just believes that the input value is following the type `T`.
+ * Therefore, if you can't ensure the input value type, it would be better to
+ * call {@link assertClone} function instead.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input A value to be cloned
- * @return Cloned data
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @returns Cloned data
  */
 export function clone<T>(input: T): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function clone(): never {
   NoTransformConfigurationError("misc.clone");
 }
@@ -89,20 +82,20 @@ export function clone(): never {
 /**
  * Clone data with type assertion.
  *
- * Clones an instance following type `T`, with type assertion. If the target `input`
- * value or its member variable contains a class instance having methods, those
- * methods would not be cloned.
+ * Clones an instance following type `T`, with type assertion. If the target
+ * `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it throws an
- * {@link TypeGuardError} or custom error generated by *errorFactory*. Otherwise,
- * there's no problem on the `input` value, cloned data would be returned.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * throws an {@link TypeGuardError} or custom error generated by _errorFactory_.
+ * Otherwise, there's no problem on the `input` value, cloned data would be
+ * returned.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input A value to be cloned
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @return Cloned data
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @returns Cloned data
  */
 export function assertClone<T>(
   input: T,
@@ -112,29 +105,27 @@ export function assertClone<T>(
 /**
  * Clone data with type assertion.
  *
- * Clones an instance following type `T`, with type assertion. If the target `input`
- * value or its member variable contains a class instance having methods, those
- * methods would not be cloned.
+ * Clones an instance following type `T`, with type assertion. If the target
+ * `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it throws an
- * {@link TypeGuardError} or custom error generated by *errorFactory*. Otherwise,
- * there's no problem on the `input` value, cloned data would be returned.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * throws an {@link TypeGuardError} or custom error generated by _errorFactory_.
+ * Otherwise, there's no problem on the `input` value, cloned data would be
+ * returned.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input A value to be cloned
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
- * @return Cloned data
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @returns Cloned data
  */
 export function assertClone<T>(
   input: unknown,
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function assertClone(): never {
   NoTransformConfigurationError("misc.assertClone");
 }
@@ -142,44 +133,40 @@ export function assertClone(): never {
 /**
  * Clone data with type checking.
  *
- * Clones an instance following type `T`, with type checking. If the target `input`
- * value or its member variable contains a class instance having methods, those
- * methods would not be cloned.
+ * Clones an instance following type `T`, with type checking. If the target
+ * `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * `null` value instead. Otherwise, there's no problem on the `input` value, cloned
- * data would be returned.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns `null` value instead. Otherwise, there's no problem on the `input`
+ * value, cloned data would be returned.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input A value to be cloned
- * @return Cloned data when exact type, otherwise null
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @returns Cloned data when exact type, otherwise null
  */
 export function isClone<T>(input: T): Resolved<T> | null;
 
 /**
  * Clone data with type checking.
  *
- * Clones an instance following type `T`, with type checking. If the target `input`
- * value or its member variable contains a class instance having methods, those
- * methods would not be cloned.
+ * Clones an instance following type `T`, with type checking. If the target
+ * `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * `null` value instead. Otherwise, there's no problem on the `input` value, cloned
- * data would be returned.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns `null` value instead. Otherwise, there's no problem on the `input`
+ * value, cloned data would be returned.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input A value to be cloned
- * @return Cloned data when exact type, otherwise null
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @returns Cloned data when exact type, otherwise null
  */
 export function isClone<T>(input: unknown): Resolved<T> | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function isClone(): never {
   NoTransformConfigurationError("misc.isClone");
 }
@@ -187,14 +174,14 @@ export function isClone(): never {
 /**
  * Clone data with detailed type validation.
  *
- * Clones an instance following type `T`, with detailed type validation. If the target
- * `input` value or its member variable contains a class instance having methods,
- * those methods would not be cloned.
+ * Clones an instance following type `T`, with detailed type validation. If the
+ * target `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * {@link IValidation.Failure} value. Otherwise, there's no problem on the `input`
- * value, cloned data would be stored in `data` property of the output
- * {@link IValidation.Success} instance.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns {@link IValidation.Failure} value. Otherwise, there's no problem on
+ * the `input` value, cloned data would be stored in `data` property of the
+ * output {@link IValidation.Success} instance.
  *
  * @template T Type of the input value
  * @param input A value to be cloned
@@ -205,14 +192,14 @@ export function validateClone<T>(input: T): IValidation<Resolved<T>>;
 /**
  * Clone data with detailed type validation.
  *
- * Clones an instance following type `T`, with detailed type validation. If the target
- * `input` value or its member variable contains a class instance having methods,
- * those methods would not be cloned.
+ * Clones an instance following type `T`, with detailed type validation. If the
+ * target `input` value or its member variable contains a class instance having
+ * methods, those methods would not be cloned.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * {@link IValidation.Failure} value. Otherwise, there's no problem on the `input`
- * value, cloned data would be stored in `data` property of the output
- * {@link IValidation.Success} instance.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns {@link IValidation.Failure} value. Otherwise, there's no problem on
+ * the `input` value, cloned data would be stored in `data` property of the
+ * output {@link IValidation.Success} instance.
  *
  * @template T Type of the input value
  * @param input A value to be cloned
@@ -220,9 +207,7 @@ export function validateClone<T>(input: T): IValidation<Resolved<T>>;
  */
 export function validateClone<T>(input: unknown): IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function validateClone(): never {
   NoTransformConfigurationError("misc.validateClone");
 }
@@ -233,29 +218,27 @@ export function validateClone(): never {
 /**
  * Prune, erase superfluous properties.
  *
- * Remove all superfluous properties from the `input` object, even including nested
- * objects. Note that, as all superfluous properties would be deleted, you never can
- * read those superfluous properties after calling this `prune()` function.
+ * Remove all superfluous properties from the `input` object, even including
+ * nested objects. Note that, as all superfluous properties would be deleted,
+ * you never can read those superfluous properties after calling this `prune()`
+ * function.
  *
- * For reference, this `typia.misc.prune()` function does not validate the input value
- * type. It just believes that the input value is following the type `T`. Therefore,
- * if you can't ensure the input value type, it would better to call one of below
- * functions instead.
+ * For reference, this `typia.misc.prune()` function does not validate the input
+ * value type. It just believes that the input value is following the type `T`.
+ * Therefore, if you can't ensure the input value type, it would better to call
+ * one of below functions instead.
  *
- *   - {@link assertPrune}
- *   - {@link isPrune}
- *   - {@link validatePrune}
+ * - {@link assertPrune}
+ * - {@link isPrune}
+ * - {@link validatePrune}
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to prune
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function prune<T extends object>(input: T): void;
 
-/**
- * @internal
- */
+/** @internal */
 export function prune(): never {
   NoTransformConfigurationError("misc.prune");
 }
@@ -264,19 +247,18 @@ export function prune(): never {
  * Prune, erase superfluous properties, with type assertion.
  *
  * `typia.misc.assertPrune()` is a combination function of {@link assert} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type assertion.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type assertion.
  *
- * In such reason, when `input` value is not matched with the type `T`, it throws an
- * {@link TypeGuardError} or custom error generated by *errorFactory*. Otherwise,
- * there's no problem on the `input` value, its all superfluous properties would be
- * removed, including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * throws an {@link TypeGuardError} or custom error generated by _errorFactory_.
+ * Otherwise, there's no problem on the `input` value, its all superfluous
+ * properties would be removed, including nested objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to assert and prune
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function assertPrune<T>(
   input: T,
@@ -287,28 +269,25 @@ export function assertPrune<T>(
  * Prune, erase superfluous properties, with type assertion.
  *
  * `typia.misc.assertPrune()` is a combination function of {@link assert} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type assertion.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type assertion.
  *
- * In such reason, when `input` value is not matched with the type `T`, it throws an
- * {@link TypeGuardError} or custom error generated by *errorFactory*. Otherwise, there's
- * no problem on the `input` value, its all superfluous properties would be removed,
- * including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * throws an {@link TypeGuardError} or custom error generated by _errorFactory_.
+ * Otherwise, there's no problem on the `input` value, its all superfluous
+ * properties would be removed, including nested objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to assert and prune
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function assertPrune<T>(
   input: unknown,
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): T;
 
-/**
- * @internal
- */
+/** @internal */
 export function assertPrune(): unknown {
   NoTransformConfigurationError("misc.assertPrune");
 }
@@ -317,18 +296,18 @@ export function assertPrune(): unknown {
  * Prune, erase superfluous properties, with type checking.
  *
  * `typia.misc.isPrune()` is a combination function of {@link is} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type checking.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type checking.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * `false` value. Otherwise, there's no problem on the `input` value, it returns
- * `true` after removing all superfluous properties, including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns `false` value. Otherwise, there's no problem on the `input` value, it
+ * returns `true` after removing all superfluous properties, including nested
+ * objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to check and prune
  * @returns Whether the parametric value is following the type `T` or not
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function isPrune<T>(input: T): input is T;
 
@@ -336,24 +315,22 @@ export function isPrune<T>(input: T): input is T;
  * Prune, erase superfluous properties, with type checking.
  *
  * `typia.misc.isPrune()` is a combination function of {@link is} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type checking.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type checking.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * `false` value. Otherwise, there's no problem on the `input` value, it returns
- * `true` after removing all superfluous properties, including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns `false` value. Otherwise, there's no problem on the `input` value, it
+ * returns `true` after removing all superfluous properties, including nested
+ * objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to check and prune
  * @returns Whether the parametric value is following the type `T` or not
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function isPrune<T>(input: unknown): input is T;
 
-/**
- * @internal
- */
+/** @internal */
 export function isPrune(): never {
   NoTransformConfigurationError("misc.isPrune");
 }
@@ -362,19 +339,19 @@ export function isPrune(): never {
  * Prune, erase superfluous properties, with type validation.
  *
  * `typia.misc.validatePrune()` is a combination function of {@link validate} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type validation.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type validation.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * {@link IValidation.IFailure} value with detailed error reasons. Otherwise, there's
- * no problem on the `input` value, it returns {@link IValidation.ISuccess} value after
- * removing all superfluous properties, including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns {@link IValidation.IFailure} value with detailed error reasons.
+ * Otherwise, there's no problem on the `input` value, it returns
+ * {@link IValidation.ISuccess} value after removing all superfluous properties,
+ * including nested objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to validate and prune
  * @returns Validation result
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function validatePrune<T>(input: T): IValidation<T>;
 
@@ -382,25 +359,23 @@ export function validatePrune<T>(input: T): IValidation<T>;
  * Prune, erase superfluous properties, with type validation.
  *
  * `typia.misc.validatePrune()` is a combination function of {@link validate} and
- * {@link prune}. Therefore, it removes all superfluous properties from the `input`
- * object including nested objects, with type validation.
+ * {@link prune}. Therefore, it removes all superfluous properties from the
+ * `input` object including nested objects, with type validation.
  *
- * In such reason, when `input` value is not matched with the type `T`, it returns
- * {@link IValidation.IFailure} value with detailed error reasons. Otherwise, there's
- * no problem on the `input` value, it returns {@link IValidation.ISuccess} value after
- * removing all superfluous properties, including nested objects.
+ * In such reason, when `input` value is not matched with the type `T`, it
+ * returns {@link IValidation.IFailure} value with detailed error reasons.
+ * Otherwise, there's no problem on the `input` value, it returns
+ * {@link IValidation.ISuccess} value after removing all superfluous properties,
+ * including nested objects.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param input Target instance to validate and prune
  * @returns Validation result
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function validatePrune<T>(input: unknown): IValidation<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function validatePrune<T>(): IValidation<T> {
   NoTransformConfigurationError("misc.validatePrune");
 }
@@ -411,27 +386,23 @@ export function validatePrune<T>(): IValidation<T> {
 /**
  * Creates a reusable {@link clone} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createClone(): never;
 
 /**
  * Creates a reusable {@link clone} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `clone` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createClone<T>(): (input: T) => Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createClone(): never {
   NoTransformConfigurationError("misc.createClone");
 }
@@ -439,12 +410,11 @@ export function createClone(): never {
 /**
  * Creates a reusable {@link assertClone} function.
  *
- * @danger You must configure the generic argument `T`
+ * @author Jeongho Nam - https://github.com/samchon
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
  * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createAssertClone(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
@@ -453,19 +423,16 @@ export function createAssertClone(
 /**
  * Creates a reusable {@link assertClone} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
  * @returns A reusable `clone` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createAssertClone<T>(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): (input: unknown) => Resolved<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createAssertClone(): never {
   NoTransformConfigurationError("misc.createAssertClone");
 }
@@ -473,27 +440,23 @@ export function createAssertClone(): never {
 /**
  * Creates a reusable {@link isClone} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createIsClone(): never;
 
 /**
  * Creates a reusable {@link isClone} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `clone` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createIsClone<T>(): (input: unknown) => Resolved<T> | null;
 
-/**
- * @internal
- */
+/** @internal */
 export function createIsClone(): never {
   NoTransformConfigurationError("misc.createIsClone");
 }
@@ -501,29 +464,25 @@ export function createIsClone(): never {
 /**
  * Creates a reusable {@link validateClone} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createValidateClone(): never;
 
 /**
  * Creates a reusable {@link validateClone} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `clone` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createValidateClone<T>(): (
   input: unknown,
 ) => IValidation<Resolved<T>>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createValidateClone(): never {
   NoTransformConfigurationError("misc.createValidateClone");
 }
@@ -531,27 +490,23 @@ export function createValidateClone(): never {
 /**
  * Creates a reusable {@link prune} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createPrune(): never;
 
 /**
  * Creates a reusable {@link prune} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `prune` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createPrune<T extends object>(): (input: T) => void;
 
-/**
- * @internal
- */
+/** @internal */
 export function createPrune<T extends object>(): (input: T) => void {
   NoTransformConfigurationError("misc.createPrune");
 }
@@ -559,12 +514,11 @@ export function createPrune<T extends object>(): (input: T) => void {
 /**
  * Creates a reusable {@link assertPrune} function.
  *
- * @danger You must configure the generic argument `T`
+ * @author Jeongho Nam - https://github.com/samchon
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
  * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
- * @author Jeongho Nam - https://github.com/samchon
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createAssertPrune(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
@@ -573,19 +527,16 @@ export function createAssertPrune(
 /**
  * Creates a reusable {@link assertPrune} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @param errorFactory Custom error factory. Default is `TypeGuardError`
  * @returns A reusable `isPrune` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createAssertPrune<T extends object>(
   errorFactory?: undefined | ((props: TypeGuardError.IProps) => Error),
 ): (input: T) => T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createAssertPrune<T extends object>(): (input: T) => T {
   NoTransformConfigurationError("misc.createAssertPrune");
 }
@@ -593,27 +544,23 @@ export function createAssertPrune<T extends object>(): (input: T) => T {
 /**
  * Creates a reusable {@link isPrune} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createIsPrune(): never;
 
 /**
  * Creates a reusable {@link isPrune} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `isPrune` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createIsPrune<T extends object>(): (input: T) => input is T;
 
-/**
- * @internal
- */
+/** @internal */
 export function createIsPrune<T extends object>(): (input: T) => input is T {
   NoTransformConfigurationError("misc.createIsPrune");
 }
@@ -621,29 +568,25 @@ export function createIsPrune<T extends object>(): (input: T) => input is T {
 /**
  * Creates a reusable {@link validatePrune} function.
  *
- * @danger You must configure the generic argument `T`
- * @returns Nothing until you configure the generic argument `T`
- * @throws compile error
- *
  * @author Jeongho Nam - https://github.com/samchon
+ * @returns Nothing until you configure the generic argument `T`
+ * @throws Compile error
+ * @danger You must configure the generic argument `T`
  */
 export function createValidatePrune(): never;
 
 /**
  * Creates a reusable {@link validatePrune} function.
  *
+ * @author Jeongho Nam - https://github.com/samchon
  * @template T Type of the input value
  * @returns A reusable `validatePrune` function
- *
- * @author Jeongho Nam - https://github.com/samchon
  */
 export function createValidatePrune<T extends object>(): (
   input: T,
 ) => IValidation<T>;
 
-/**
- * @internal
- */
+/** @internal */
 export function createValidatePrune<T extends object>(): (
   input: T,
 ) => IValidation<T> {