typia 3.5.8 → 3.6.0-dev.20230225

package/src/Primitive.ts

@@ -1,82 +1,104 @@
-/**
- * Primitive type.
- *
- * `Primitive` is a type of TMP (Type Meta Programming) type who converts its argument as a
- * primitive type.
- *
- * If the target argument is a built-in class who returns its origin primitive type through
- * the `valueOf()` method like the `String` or `Number`, its return type would be the
- * `string` or `number`.
- *
- * Otherwise, the target argument is a type of custom class, all of its custom method would
- * be erased and its prototype would be changed to the primitive `object`. Therefore, return
- * type of the TMP type finally be the primitive object.
- *
- * In addition, if the target argument is a type of custom class and it has a special
- * method `toJSON()`, return type of this `Primitive` would be not `Primitive<Instance>`
- * but `Primitive<ReturnType<Instance.toJSON>>`.
- *
- * Before                  | After
- * ------------------------|----------------------------------------
- * `Boolean`               | `boolean`
- * `Number`                | `number`
- * `String`                | `string`
- * `Class`                 | `object`
- * `Class` with `toJSON()` | `Primitive<ReturnType<Class.toJSON>>`
- * Others                  | No change
- *
- * @template Instance Target argument type.
- * @author Jenogho Nam - https://github.com/samchon
- */
-export type Primitive<T> = _Equal<T, _Primitive<T>> extends true
-    ? T
-    : _Primitive<T>;
-
-type _Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
-
-type _Primitive<Instance> = _ValueOf<Instance> extends object
-    ? Instance extends object
-        ? Instance extends IJsonable<infer Raw>
-            ? _ValueOf<Raw> extends object
-                ? Raw extends object
-                    ? _PrimitiveObject<Raw> // object would be primitified
-                    : never // cannot be
-                : _ValueOf<Raw> // atomic value
-            : _PrimitiveObject<Instance> // object would be primitified
-        : never // cannot be
-    : _ValueOf<Instance>;
-
-type _PrimitiveObject<Instance extends object> = Instance extends Array<infer T>
-    ? _Primitive<T>[]
-    : {
-          [P in keyof Instance]: Instance[P] extends Function
-              ? never
-              : _Primitive<Instance[P]>;
-      };
-
-type _ValueOf<Instance> = _IsValueOf<Instance, Boolean> extends true
-    ? boolean
-    : _IsValueOf<Instance, Number> extends true
-    ? number
-    : _IsValueOf<Instance, String> extends true
-    ? string
-    : Instance;
-
-type _IsValueOf<
-    Instance,
-    Object extends IValueOf<any>,
-> = Instance extends Object
-    ? Object extends IValueOf<infer Primitive>
-        ? Instance extends Primitive
-            ? false
-            : true // not Primitive, but Object
-        : false // cannot be
-    : false;
-
-interface IValueOf<T> {
-    valueOf(): T;
-}
-
-interface IJsonable<T> {
-    toJSON(): T;
-}
+/**
+ * Primitive type.
+ *
+ * `Primitive` is a type of TMP (Type Meta Programming) type who converts its argument as a
+ * primitive type.
+ *
+ * If the target argument is a built-in class who returns its origin primitive type through
+ * the `valueOf()` method like the `String` or `Number`, its return type would be the
+ * `string` or `number`.
+ *
+ * Otherwise, the target argument is a type of custom class, all of its custom method would
+ * be erased and its prototype would be changed to the primitive `object`. Therefore, return
+ * type of the TMP type finally be the primitive object.
+ *
+ * In addition, if the target argument is a type of custom class and it has a special
+ * method `toJSON()`, return type of this `Primitive` would be not `Primitive<Instance>`
+ * but `Primitive<ReturnType<Instance.toJSON>>`.
+ *
+ * Before                  | After
+ * ------------------------|----------------------------------------
+ * `Boolean`               | `boolean`
+ * `Number`                | `number`
+ * `String`                | `string`
+ * `Class`                 | `object`
+ * `Class` with `toJSON()` | `Primitive<ReturnType<Class.toJSON>>`
+ * Others                  | No change
+ *
+ * @template Instance Target argument type.
+ * @author Jenogho Nam - https://github.com/samchon
+ */
+export type Primitive<T> = _Equal<T, _Primitive<T>> extends true
+    ? T
+    : _Primitive<T>;
+
+type _Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
+
+type _Primitive<Instance> = _ValueOf<Instance> extends object
+    ? Instance extends object
+        ? Instance extends _Native
+            ? {}
+            : Instance extends IJsonable<infer Raw>
+            ? _ValueOf<Raw> extends object
+                ? Raw extends object
+                    ? _PrimitiveObject<Raw> // object would be primitified
+                    : never // cannot be
+                : _ValueOf<Raw> // atomic value
+            : _PrimitiveObject<Instance> // object would be primitified
+        : never // cannot be
+    : _ValueOf<Instance>;
+
+type _PrimitiveObject<Instance extends object> = Instance extends Array<infer T>
+    ? _Primitive<T>[]
+    : {
+          [P in keyof Instance]: Instance[P] extends Function
+              ? never
+              : _Primitive<Instance[P]>;
+      };
+
+type _ValueOf<Instance> = _IsValueOf<Instance, Boolean> extends true
+    ? boolean
+    : _IsValueOf<Instance, Number> extends true
+    ? number
+    : _IsValueOf<Instance, String> extends true
+    ? string
+    : Instance;
+
+type _Native =
+    | Set<any>
+    | Map<any, any>
+    | WeakSet<any>
+    | WeakMap<any, any>
+    | Uint8Array
+    | Uint8ClampedArray
+    | Uint16Array
+    | Uint32Array
+    | BigUint64Array
+    | Int8Array
+    | Int16Array
+    | Int32Array
+    | BigInt64Array
+    | Float32Array
+    | Float64Array
+    | ArrayBuffer
+    | SharedArrayBuffer
+    | DataView;
+
+type _IsValueOf<
+    Instance,
+    Object extends IValueOf<any>,
+> = Instance extends Object
+    ? Object extends IValueOf<infer Primitive>
+        ? Instance extends Primitive
+            ? false
+            : true // not Primitive, but Object
+        : false // cannot be
+    : false;
+
+interface IValueOf<T> {
+    valueOf(): T;
+}
+
+interface IJsonable<T> {
+    toJSON(): T;
+}

package/src/TypeGuardError.ts

@@ -1,36 +1,36 @@
-export class TypeGuardError extends Error {
-    public readonly method: string;
-    public readonly path: string | undefined;
-    public readonly expected: string;
-    public readonly value: any;
-
-    public constructor(props: TypeGuardError.IProps) {
-        // MESSAGE CONSTRUCTION
-        super(
-            props.message ||
-                `Error on ${props.method}(): invalid type${
-                    props.path ? ` on ${props.path}` : ""
-                }, expect to be ${props.expected}`,
-        );
-
-        // INHERITANCE POLYFILL
-        const proto = new.target.prototype;
-        if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
-        else (this as any).__proto__ = proto;
-
-        // ASSIGN MEMBERS
-        this.method = props.method;
-        this.path = props.path;
-        this.expected = props.expected;
-        this.value = props.value;
-    }
-}
-export namespace TypeGuardError {
-    export interface IProps {
-        method: string;
-        path?: string;
-        expected: string;
-        value: any;
-        message?: string;
-    }
-}
+export class TypeGuardError extends Error {
+    public readonly method: string;
+    public readonly path: string | undefined;
+    public readonly expected: string;
+    public readonly value: any;
+
+    public constructor(props: TypeGuardError.IProps) {
+        // MESSAGE CONSTRUCTION
+        super(
+            props.message ||
+                `Error on ${props.method}(): invalid type${
+                    props.path ? ` on ${props.path}` : ""
+                }, expect to be ${props.expected}`,
+        );
+
+        // INHERITANCE POLYFILL
+        const proto = new.target.prototype;
+        if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
+        else (this as any).__proto__ = proto;
+
+        // ASSIGN MEMBERS
+        this.method = props.method;
+        this.path = props.path;
+        this.expected = props.expected;
+        this.value = props.value;
+    }
+}
+export namespace TypeGuardError {
+    export interface IProps {
+        method: string;
+        path?: string;
+        expected: string;
+        value: any;
+        message?: string;
+    }
+}

package/src/executable/TypiaGenerateWizard.ts

@@ -0,0 +1,87 @@
+import fs from "fs";
+
+import { TypiaFileFactory } from "../factories/TypiaFileFactory";
+
+import { ArgumentParser } from "./setup/ArgumentParser";
+import { PackageManager } from "./setup/PackageManager";
+
+export namespace TypiaGenerateWizard {
+    export async function generate(): Promise<void> {
+        console.log("----------------------------------------");
+        console.log(" Typia Generate Wizard");
+        console.log("----------------------------------------");
+
+        // LOAD PACKAGE.JSON INFO
+        const pack: PackageManager = await PackageManager.mount();
+        const options: IArguments = await ArgumentParser.parse(pack)(false)(
+            inquiry,
+        );
+        await TypiaFileFactory.generate(options);
+    }
+
+    const inquiry: ArgumentParser.Inquiry<IArguments> = async (
+        _pack,
+        command,
+        prompt,
+        action,
+    ) => {
+        // PREPARE ASSETS
+        command.option("--input [path]", "input directory");
+        command.option("--output [directory]", "output directory");
+        command.option("--project [project]", "tsconfig.json file location");
+
+        const questioned = { value: false };
+
+        const input = (name: string) => async (message: string) => {
+            const result = await prompt()({
+                type: "input",
+                name,
+                message,
+                default: "",
+            });
+            return result[name] as string;
+        };
+        const select =
+            (name: string) =>
+            (message: string) =>
+            async <Choice extends string>(
+                choices: Choice[],
+            ): Promise<Choice> => {
+                questioned.value = true;
+                return (
+                    await prompt()({
+                        type: "list",
+                        name: name,
+                        message: message,
+                        choices: choices,
+                    })
+                )[name];
+            };
+        const configure = async () => {
+            const fileList: string[] = await (
+                await fs.promises.readdir(process.cwd())
+            ).filter(
+                (str) =>
+                    str.substring(0, 8) === "tsconfig" &&
+                    str.substring(str.length - 5) === ".json",
+            );
+            if (fileList.length === 0)
+                throw new Error(`Unable to find "tsconfig.json" file.`);
+            else if (fileList.length === 1) return fileList[0];
+            return select("tsconfig")("TS Config File")(fileList);
+        };
+
+        return action(async (options) => {
+            options.input ??= await input("input")("input directory");
+            options.output ??= await input("output")("output directory");
+            options.project ??= await configure();
+            return options as IArguments;
+        });
+    };
+
+    export interface IArguments {
+        input: string;
+        output: string;
+        project: string;
+    }
+}

package/src/executable/TypiaSetupWizard.ts

@@ -1,142 +1,142 @@
-import fs from "fs";
-import path from "path";
-
-import { ArgumentParser } from "./setup/ArgumentParser";
-import { CommandExecutor } from "./setup/CommandExecutor";
-import { PackageManager } from "./setup/PackageManager";
-import { PluginConfigurator } from "./setup/PluginConfigurator";
-
-export namespace TypiaSetupWizard {
-    export interface IArguments {
-        compiler: "ts-patch" | "ttypescript";
-        manager: "npm" | "pnpm" | "yarn";
-        project: string | null;
-    }
-
-    export async function setup(): Promise<void> {
-        console.log("----------------------------------------");
-        console.log(" Typia Setup Wizard");
-        console.log("----------------------------------------");
-
-        // PREPARE ASSETS
-        const pack: PackageManager = await PackageManager.mount();
-        const args: IArguments = await ArgumentParser.parse(pack)(true)(
-            inquiry,
-        );
-
-        // INSTALL TYPESCRIPT
-        pack.install({ dev: true, modulo: "typescript" });
-        args.project ??= (() => {
-            CommandExecutor.run("npx tsc --init", false);
-            return (args.project = "tsconfig.json");
-        })();
-        pack.install({ dev: true, modulo: "ts-node" });
-
-        // INSTALL COMPILER
-        pack.install({ dev: true, modulo: args.compiler });
-        if (args.compiler === "ts-patch") {
-            await pack.save((data) => {
-                data.scripts ??= {};
-                if (
-                    typeof data.scripts.prepare === "string" &&
-                    data.scripts.prepare.indexOf("ts-patch install") === -1
-                )
-                    data.scripts.prepare =
-                        "ts-patch install && " + data.scripts.prepare;
-                else data.scripts.prepare = "ts-patch install";
-            });
-            CommandExecutor.run("npm run prepare", false);
-        }
-
-        // INSTALL AND CONFIGURE TYPIA
-        pack.install({ dev: false, modulo: "typia" });
-        await PluginConfigurator.configure(pack, args);
-    }
-
-    const inquiry: ArgumentParser.Inquiry<IArguments> = async (
-        pack,
-        command,
-        prompt,
-        action,
-    ) => {
-        // PREPARE ASSETS
-        command.option("--compiler [compiler]", "compiler type");
-        command.option("--manager [manager", "package manager");
-        command.option("--project [project]", "tsconfig.json file location");
-
-        // INTERNAL PROCEDURES
-        const questioned = { value: false };
-        const select =
-            (name: string) =>
-            (message: string) =>
-            async <Choice extends string>(
-                choices: Choice[],
-            ): Promise<Choice> => {
-                questioned.value = true;
-                return (
-                    await prompt()({
-                        type: "list",
-                        name: name,
-                        message: message,
-                        choices: choices,
-                    })
-                )[name];
-            };
-        const configure = async () => {
-            const fileList: string[] = await (
-                await fs.promises.readdir(process.cwd())
-            ).filter(
-                (str) =>
-                    str.substring(0, 8) === "tsconfig" &&
-                    str.substring(str.length - 5) === ".json",
-            );
-            if (fileList.length === 0) {
-                if (process.cwd() !== pack.directory)
-                    throw new Error(`Unable to find "tsconfig.json" file.`);
-                return null;
-            } else if (fileList.length === 1) return fileList[0];
-            return select("tsconfig")("TS Config File")(fileList);
-        };
-
-        // DO CONSTRUCT
-        return action(async (options) => {
-            if (options.compiler === undefined) {
-                console.log(COMPILER_DESCRIPTION);
-                options.compiler = await select("compiler")(`Compiler`)(
-                    is_nest_cli(pack)
-                        ? ["ts-patch" as const, "ttypescript" as const]
-                        : ["ttypescript" as const, "ts-patch" as const],
-                );
-            }
-            options.manager ??= await select("manager")("Package Manager")([
-                "npm" as const,
-                "pnpm" as const,
-                "yarn" as const,
-            ]);
-            pack.manager = options.manager;
-            options.project ??= await configure();
-
-            if (questioned.value) console.log("");
-            return options as IArguments;
-        });
-    };
-
-    function is_nest_cli(pack: PackageManager): boolean {
-        return (
-            (typeof pack.data.scripts?.build === "string" &&
-                pack.data.scripts.build.indexOf("nest build") !== -1) ||
-            fs.existsSync(path.join(pack.directory, "nest-cli.json"))
-        );
-    }
-}
-
-const COMPILER_DESCRIPTION = [
-    `About compiler, if you adapt "ttypescript", you should use "ttsc" instead.`,
-    ``,
-    `Otherwise, you choose "ts-patch", you can use the original "tsc" command.`,
-    `However, the "ts-patch" hacks "node_modules/typescript" source code.`,
-    `Also, whenever update "typescript", you've to run "npm run prepare" command.`,
-    ``,
-    `By the way, when using "@nest/cli", you must just choose "ts-patch".`,
-    ``,
-].join("\n");
+import fs from "fs";
+import path from "path";
+
+import { ArgumentParser } from "./setup/ArgumentParser";
+import { CommandExecutor } from "./setup/CommandExecutor";
+import { PackageManager } from "./setup/PackageManager";
+import { PluginConfigurator } from "./setup/PluginConfigurator";
+
+export namespace TypiaSetupWizard {
+    export interface IArguments {
+        compiler: "ts-patch" | "ttypescript";
+        manager: "npm" | "pnpm" | "yarn";
+        project: string | null;
+    }
+
+    export async function setup(): Promise<void> {
+        console.log("----------------------------------------");
+        console.log(" Typia Setup Wizard");
+        console.log("----------------------------------------");
+
+        // PREPARE ASSETS
+        const pack: PackageManager = await PackageManager.mount();
+        const args: IArguments = await ArgumentParser.parse(pack)(true)(
+            inquiry,
+        );
+
+        // INSTALL TYPESCRIPT
+        pack.install({ dev: true, modulo: "typescript" });
+        args.project ??= (() => {
+            CommandExecutor.run("npx tsc --init", false);
+            return (args.project = "tsconfig.json");
+        })();
+        pack.install({ dev: true, modulo: "ts-node" });
+
+        // INSTALL COMPILER
+        pack.install({ dev: true, modulo: args.compiler });
+        if (args.compiler === "ts-patch") {
+            await pack.save((data) => {
+                data.scripts ??= {};
+                if (
+                    typeof data.scripts.prepare === "string" &&
+                    data.scripts.prepare.indexOf("ts-patch install") === -1
+                )
+                    data.scripts.prepare =
+                        "ts-patch install && " + data.scripts.prepare;
+                else data.scripts.prepare = "ts-patch install";
+            });
+            CommandExecutor.run("npm run prepare", false);
+        }
+
+        // INSTALL AND CONFIGURE TYPIA
+        pack.install({ dev: false, modulo: "typia" });
+        await PluginConfigurator.configure(pack, args);
+    }
+
+    const inquiry: ArgumentParser.Inquiry<IArguments> = async (
+        pack,
+        command,
+        prompt,
+        action,
+    ) => {
+        // PREPARE ASSETS
+        command.option("--compiler [compiler]", "compiler type");
+        command.option("--manager [manager", "package manager");
+        command.option("--project [project]", "tsconfig.json file location");
+
+        // INTERNAL PROCEDURES
+        const questioned = { value: false };
+        const select =
+            (name: string) =>
+            (message: string) =>
+            async <Choice extends string>(
+                choices: Choice[],
+            ): Promise<Choice> => {
+                questioned.value = true;
+                return (
+                    await prompt()({
+                        type: "list",
+                        name: name,
+                        message: message,
+                        choices: choices,
+                    })
+                )[name];
+            };
+        const configure = async () => {
+            const fileList: string[] = await (
+                await fs.promises.readdir(process.cwd())
+            ).filter(
+                (str) =>
+                    str.substring(0, 8) === "tsconfig" &&
+                    str.substring(str.length - 5) === ".json",
+            );
+            if (fileList.length === 0) {
+                if (process.cwd() !== pack.directory)
+                    throw new Error(`Unable to find "tsconfig.json" file.`);
+                return null;
+            } else if (fileList.length === 1) return fileList[0];
+            return select("tsconfig")("TS Config File")(fileList);
+        };
+
+        // DO CONSTRUCT
+        return action(async (options) => {
+            if (options.compiler === undefined) {
+                console.log(COMPILER_DESCRIPTION);
+                options.compiler = await select("compiler")(`Compiler`)(
+                    is_nest_cli(pack)
+                        ? ["ts-patch" as const, "ttypescript" as const]
+                        : ["ttypescript" as const, "ts-patch" as const],
+                );
+            }
+            options.manager ??= await select("manager")("Package Manager")([
+                "npm" as const,
+                "pnpm" as const,
+                "yarn" as const,
+            ]);
+            pack.manager = options.manager;
+            options.project ??= await configure();
+
+            if (questioned.value) console.log("");
+            return options as IArguments;
+        });
+    };
+
+    function is_nest_cli(pack: PackageManager): boolean {
+        return (
+            (typeof pack.data.scripts?.build === "string" &&
+                pack.data.scripts.build.indexOf("nest build") !== -1) ||
+            fs.existsSync(path.join(pack.directory, "nest-cli.json"))
+        );
+    }
+}
+
+const COMPILER_DESCRIPTION = [
+    `About compiler, if you adapt "ttypescript", you should use "ttsc" instead.`,
+    ``,
+    `Otherwise, you choose "ts-patch", you can use the original "tsc" command.`,
+    `However, the "ts-patch" hacks "node_modules/typescript" source code.`,
+    `Also, whenever update "typescript", you've to run "npm run prepare" command.`,
+    ``,
+    `By the way, when using "@nest/cli", you must just choose "ts-patch".`,
+    ``,
+].join("\n");