typia 3.7.3-dev.20230408 → 3.7.4-dev.20230410

package/README.md

@@ -37,7 +37,7 @@ export function prune<T extends object>(input: T): void; // erase extra props
 
 All functions in `typia` require **only one line**. You don't need any extra dedication like JSON schema definitions or decorator function calls. Just call `typia` function with only one line like `typia.assert<T>(input)`.
 
-Also, as `typia` performs AOT (Ahead of Time) compilation skill, its performance is much faster than other competitive libaries. For an example, when comparing validate function `is()` with other competitive libraries, `typia` is maximum **15,000x faster** than `class-validator`.
+Also, as `typia` performs AOT (Ahead of Time) compilation skill, its performance is much faster than other competitive libaries. For an example, when comparing validate function `is()` with other competitive libraries, `typia` is maximum **20,000x faster** than `class-validator`.
 
 ![Is Function Benchmark](https://github.com/samchon/typia/raw/master/benchmark/results/11th%20Gen%20Intel(R)%20Core(TM)%20i5-1135G7%20%40%202.40GHz/images/is.svg)
 
@@ -59,6 +59,7 @@ Your donation would encourage `typia` development.
 ## Setup
 ### Transformation
 ```bash
+npm install --save typia
 npx typia setup
 ```
 
@@ -250,7 +251,7 @@ export function createAssertStringify<T>(): (input: T) => string;
   - `application()`: generate JSON schema with only one line
     - you can complement JSON schema contents through [comment tags](https://github.com/samchon/typia/wiki/Enhanced-JSON#comment-tags)
   - `assertParse()`: parse JSON string safely with type validation
-  - `isStringify()`: maximum 10x faster JSON stringify fuction even type safe
+  - `isStringify()`: maximum 160x faster JSON stringify fuction even type safe
 
 ![JSON string conversion speed](https://raw.githubusercontent.com/samchon/typia/master/benchmark/results/AMD%20Ryzen%207%206800HS%20with%20Radeon%20Graphics/images/stringify.svg)
 
@@ -286,8 +287,8 @@ If you need specific random data generation, utilize comment tags or do customiz
 [Nestia](https://github.com/samchon/nestia) is a set of helper libraries for `NestJS`, supporting below features:
 
   - `@nestia/core`: superfast decorators using `typia`
-    - **15,000x faster** validation
-    - **100x faster** JSON serialization
+    - **20,000x faster** validation
+    - **200x faster** JSON serialization
   - `@nestia/sdk`: evolved **SDK** and **Swagger** generators
     - SDK (Software Development Kit)
       - interaction library for client developers
@@ -295,55 +296,3 @@ If you need specific random data generation, utilize comment tags or do customiz
   - `nestia`: just CLI (command line interface) tool
 
 ![nestia-sdk-demo](https://user-images.githubusercontent.com/13158709/215004990-368c589d-7101-404e-b81b-fbc936382f05.gif)
-
-### Reactia
-> Not published yet, but soon
-
-[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/reactia/blob/master/LICENSE)
-[![Build Status](https://github.com/samchon/reactia/workflows/build/badge.svg)](https://github.com/samchon/reactia/actions?query=workflow%3Abuild)
-[![Guide Documents](https://img.shields.io/badge/wiki-documentation-forestgreen)](https://github.com/samchon/reactia/wiki)
-
-[Reactia](https://github.com/samchon/reactia) is an automatic React components generator, just by analyzing TypeScript type.
-
-  - `@reactia/core`: Core Library analyzing TypeScript type
-  - `@reactia/mui`: Material UI Theme for `core` and `nest`
-  - `@reactia/nest`: Automatic Frontend Application Builder for `NestJS`
-
-![Sample](https://user-images.githubusercontent.com/13158709/199074008-46b2dd67-02be-40b1-aa0f-74ac41f3e0a7.png)
-
-When you want to automate an individual component, just use `@reactia/core`.
-
-```tsx
-import ReactDOM from "react-dom";
-
-import typia from "typia";
-import { ReactiaComponent } from "@reactia/core";
-import { MuiInputTheme } from "@reactia/mui";
-
-const RequestInput = ReactiaComponent<IRequestDto>(MuiInputTheme());
-const input: IRequestDto = { ... };
-
-ReactDOM.render(
-    <RequestInput input={input} />,
-    document.body
-);
-```
-
-Otherwise, you can fully automate frontend application development through `@reactia/nest`.
-
-```tsx
-import React from "react";
-import ReactDOM from "react-dom";
-
-import { ISwagger } "@nestia/swagger";
-import { MuiApplicationTheme } from "@reactia/mui";
-import { ReactiaApplication } from "@reactia/nest";
-
-const swagger: ISwagger = await import("./swagger.json");
-const App: React.FC = ReactiaApplication(MuiApplicationTheme())(swagger);
-
-ReactDOM.render(
-    <App />,
-    document.body
-);
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "3.7.3-dev.20230408",
+  "version": "3.7.4-dev.20230410",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -67,6 +67,12 @@
     "url": "https://github.com/samchon/typia/issues"
   },
   "homepage": "https://github.com/samchon/typia#readme",
+  "dependencies": {
+    "commander": "^10.0.0",
+    "comment-json": "^4.2.3",
+    "inquirer": "^8.2.5",
+    "randexp": "^0.5.3"
+  },
   "peerDependencies": {
     "typescript": ">= 4.5.2 && < 5.0.0"
   },
@@ -94,14 +100,11 @@
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
     "cli": "^1.0.1",
-    "commander": "^10.0.0",
-    "comment-json": "^4.2.3",
     "d3": "^5.16.0",
     "eslint-plugin-deprecation": "^1.3.2",
     "express": "^4.18.2",
     "fast-json-stringify": "^5.4.0",
     "fastify": "^4.9.2",
-    "inquirer": "^8.2.5",
     "io-ts": "^2.2.19",
     "jsdom": "^20.0.2",
     "physical-cpu-count": "^2.0.0",
@@ -125,8 +128,5 @@
     "package.json",
     "lib",
     "src"
-  ],
-  "dependencies": {
-    "randexp": "^0.5.3"
-  }
+  ]
 }

package/src/CustomValidatorMap.ts

@@ -1,126 +1,126 @@
-import { Customizable } from "./typings/Customizable";
-
-/**
- * Map of custom validators.
- *
- * Map of custom validator functions, storing tag name and type of target value
- * as key, and custom validator function as value.
- *
- * When you want to add a custom validation logic utilizing comment tags, you
- * can insert a custom validator function with specific tag name and type of
- * the target value like below.
- *
- * ```ts
- * typia.customValidators.insert("powerOf")("number")(
- *     (text: string) => {
- *         const denominator: number = Math.log(Number(text));
- *         return (value: number) => {
- *             value = Math.log(value) / denominator;
- *             return value === Math.floor(value);
- *         };
- *     }
- * );
- * typia.customValidators.insert("dollar")("string")(
- *     () => (value: string) => value.startsWith("$"),
- * );
- *
- * interface TagCustom {
- *    /**
- *     * @powerOf 10
- *     *\/
- *    powerOf: number;
- *
- *    /**
- *     * @dollar
- *     *\/
- *    dollar: string;
- * }
- * ```
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export interface CustomValidatorMap {
-    /**
-     * Get number of stored tags.
-     *
-     * @return Number of stored tags
-     */
-    size(): number;
-
-    /**
-     * Get number of stored types of the specified tag name.
-     *
-     * In other words, number of stored custom validator functions of
-     * the specified tag name.
-     *
-     * @param name Tag name
-     * @return Number of stored types function
-     */
-    size(name: string): number;
-
-    /**
-     * Test whether custom validator function exists or not.
-     *
-     * @param name Tag name
-     * @param type Type of the target value
-     * @returns Whether exists or not
-     */
-    has: (name: string) => (type: keyof Customizable) => boolean;
-
-    /**
-     * Get custom validator function.
-     *
-     * @param name Tag name
-     * @param type Type of the target value
-     * @returns Custom validator function or undefined value
-     */
-    get(
-        name: string,
-    ): <Type extends keyof Customizable>(
-        type: Type,
-    ) => CustomValidatorMap.Closure<Type> | undefined;
-
-    /**
-     * Insert a new custom validator function.
-     *
-     * You can add a custom validation logic utilizing comment tags,
-     * by inserting a function which returns a boolean value, with specific
-     * tag name and type of the target value.
-     *
-     * However, if you try to insert a duplicated tag name and type, the
-     * closure function would not be enrolled and `false` value would be
-     * returned.
-     *
-     * @param name Tag name
-     * @param type Type of the target value
-     * @param closure Custom validator function
-     * @returns Whether succeeded to insert or not
-     */
-    insert(
-        name: string,
-    ): <Type extends keyof Customizable>(
-        type: Type,
-    ) => (closure: CustomValidatorMap.Closure<Type>) => boolean;
-
-    /**
-     * Erase custom validator function.
-     *
-     * @param name Tag name
-     * @param type Type of the target value
-     * @returns Whether succeeded to erase or not
-     */
-    erase(name: string): (type: keyof Customizable) => boolean;
-}
-export namespace CustomValidatorMap {
-    /**
-     * Type of closure function of custom validation.
-     *
-     * @template Type Type of the target value
-     * @param text Text of the tag. For example, if the tag is `@powerOf 10`, `text` is 10.
-     * @param value Value to validate
-     * @returns Whether the value is valid or not
-     */
-    export type Closure<Type extends keyof Customizable> = (
-        text: string,
-    ) => (value: Customizable[Type]) => boolean;
-}
+import { Customizable } from "./typings/Customizable";
+
+/**
+ * Map of custom validators.
+ *
+ * Map of custom validator functions, storing tag name and type of target value
+ * as key, and custom validator function as value.
+ *
+ * When you want to add a custom validation logic utilizing comment tags, you
+ * can insert a custom validator function with specific tag name and type of
+ * the target value like below.
+ *
+ * ```ts
+ * typia.customValidators.insert("powerOf")("number")(
+ *     (text: string) => {
+ *         const denominator: number = Math.log(Number(text));
+ *         return (value: number) => {
+ *             value = Math.log(value) / denominator;
+ *             return value === Math.floor(value);
+ *         };
+ *     }
+ * );
+ * typia.customValidators.insert("dollar")("string")(
+ *     () => (value: string) => value.startsWith("$"),
+ * );
+ *
+ * interface TagCustom {
+ *    /**
+ *     * @powerOf 10
+ *     *\/
+ *    powerOf: number;
+ *
+ *    /**
+ *     * @dollar
+ *     *\/
+ *    dollar: string;
+ * }
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface CustomValidatorMap {
+    /**
+     * Get number of stored tags.
+     *
+     * @return Number of stored tags
+     */
+    size(): number;
+
+    /**
+     * Get number of stored types of the specified tag name.
+     *
+     * In other words, number of stored custom validator functions of
+     * the specified tag name.
+     *
+     * @param name Tag name
+     * @return Number of stored types function
+     */
+    size(name: string): number;
+
+    /**
+     * Test whether custom validator function exists or not.
+     *
+     * @param name Tag name
+     * @param type Type of the target value
+     * @returns Whether exists or not
+     */
+    has: (name: string) => (type: keyof Customizable) => boolean;
+
+    /**
+     * Get custom validator function.
+     *
+     * @param name Tag name
+     * @param type Type of the target value
+     * @returns Custom validator function or undefined value
+     */
+    get(
+        name: string,
+    ): <Type extends keyof Customizable>(
+        type: Type,
+    ) => CustomValidatorMap.Closure<Type> | undefined;
+
+    /**
+     * Insert a new custom validator function.
+     *
+     * You can add a custom validation logic utilizing comment tags,
+     * by inserting a function which returns a boolean value, with specific
+     * tag name and type of the target value.
+     *
+     * However, if you try to insert a duplicated tag name and type, the
+     * closure function would not be enrolled and `false` value would be
+     * returned.
+     *
+     * @param name Tag name
+     * @param type Type of the target value
+     * @param closure Custom validator function
+     * @returns Whether succeeded to insert or not
+     */
+    insert(
+        name: string,
+    ): <Type extends keyof Customizable>(
+        type: Type,
+    ) => (closure: CustomValidatorMap.Closure<Type>) => boolean;
+
+    /**
+     * Erase custom validator function.
+     *
+     * @param name Tag name
+     * @param type Type of the target value
+     * @returns Whether succeeded to erase or not
+     */
+    erase(name: string): (type: keyof Customizable) => boolean;
+}
+export namespace CustomValidatorMap {
+    /**
+     * Type of closure function of custom validation.
+     *
+     * @template Type Type of the target value
+     * @param text Text of the tag. For example, if the tag is `@powerOf 10`, `text` is 10.
+     * @param value Value to validate
+     * @returns Whether the value is valid or not
+     */
+    export type Closure<Type extends keyof Customizable> = (
+        text: string,
+    ) => (value: Customizable[Type]) => boolean;
+}

package/src/IRandomGenerator.ts

@@ -1,33 +1,33 @@
-import { Customizable } from "./typings/Customizable";
-
-export interface IRandomGenerator {
-    boolean(): boolean;
-    integer(minimum?: number, maximum?: number): number;
-    number(minimum?: number, maximum?: number): number;
-    bigint(minimum?: bigint, maximum?: bigint): bigint;
-    string(length?: number): string;
-    array<T>(closure: (index: number) => T, count?: number): T[];
-
-    uuid(): string;
-    email(): string;
-    url(): string;
-    ipv4(): string;
-    ipv6(): string;
-    pattern(regex: RegExp): string;
-    date(minimum?: number, maximum?: number): string;
-    datetime(minimum?: number, maximum?: number): string;
-
-    customs?: IRandomGenerator.CustomMap;
-}
-export namespace IRandomGenerator {
-    export type CustomMap = {
-        [Type in keyof Customizable]?: (
-            tags: ICommentTag[],
-        ) => Customizable[Type] | undefined;
-    };
-
-    export interface ICommentTag {
-        name: string;
-        value?: string;
-    }
-}
+import { Customizable } from "./typings/Customizable";
+
+export interface IRandomGenerator {
+    boolean(): boolean;
+    integer(minimum?: number, maximum?: number): number;
+    number(minimum?: number, maximum?: number): number;
+    bigint(minimum?: bigint, maximum?: bigint): bigint;
+    string(length?: number): string;
+    array<T>(closure: (index: number) => T, count?: number): T[];
+
+    uuid(): string;
+    email(): string;
+    url(): string;
+    ipv4(): string;
+    ipv6(): string;
+    pattern(regex: RegExp): string;
+    date(minimum?: number, maximum?: number): string;
+    datetime(minimum?: number, maximum?: number): string;
+
+    customs?: IRandomGenerator.CustomMap;
+}
+export namespace IRandomGenerator {
+    export type CustomMap = {
+        [Type in keyof Customizable]?: (
+            tags: ICommentTag[],
+        ) => Customizable[Type] | undefined;
+    };
+
+    export interface ICommentTag {
+        name: string;
+        value?: string;
+    }
+}

package/src/IValidation.ts

@@ -1,21 +1,21 @@
-export type IValidation<T = unknown> =
-    | IValidation.ISuccess<T>
-    | IValidation.IFailure;
-export namespace IValidation {
-    export interface ISuccess<T = unknown> {
-        success: true;
-        data: T;
-        errors: [];
-    }
-
-    export interface IFailure {
-        success: false;
-        errors: IError[];
-    }
-
-    export interface IError {
-        path: string;
-        expected: string;
-        value: any;
-    }
-}
+export type IValidation<T = unknown> =
+    | IValidation.ISuccess<T>
+    | IValidation.IFailure;
+export namespace IValidation {
+    export interface ISuccess<T = unknown> {
+        success: true;
+        data: T;
+        errors: [];
+    }
+
+    export interface IFailure {
+        success: false;
+        errors: IError[];
+    }
+
+    export interface IError {
+        path: string;
+        expected: string;
+        value: any;
+    }
+}