typia 3.8.0-dev.20230417 → 3.8.0-dev.20230420

package/src/executable/setup/PackageManager.ts

@@ -1,71 +1,71 @@
-import fs from "fs";
-import path from "path";
-
-import { CommandExecutor } from "./CommandExecutor";
-import { FileRetriever } from "./FileRetriever";
-
-export class PackageManager {
-    public manager: string = "npm";
-    public get file(): string {
-        return path.join(this.directory, "package.json");
-    }
-
-    public static async mount(): Promise<PackageManager> {
-        const location: string | null = await FileRetriever.directory(
-            "package.json",
-        )(process.cwd());
-        if (location === null)
-            throw new Error(`Unable to find "package.json" file`);
-
-        return new PackageManager(
-            location,
-            await this.load(path.join(location, "package.json")),
-        );
-    }
-
-    public async save(modifier: (data: Package.Data) => void): Promise<void> {
-        const content: string = await fs.promises.readFile(this.file, "utf8");
-        this.data = JSON.parse(content);
-        modifier(this.data);
-
-        return fs.promises.writeFile(
-            this.file,
-            JSON.stringify(this.data, null, 2),
-            "utf8",
-        );
-    }
-
-    public install(props: {
-        dev: boolean;
-        modulo: string;
-        version?: string;
-    }): boolean {
-        const middle: string =
-            this.manager === "yarn"
-                ? `add${props.dev ? " -D" : ""}`
-                : `install ${props.dev ? "--save-dev" : "--save"}`;
-        CommandExecutor.run(
-            `${this.manager} ${middle} ${props.modulo}${
-                props.version ? `@${props.version}` : ""
-            }`,
-        );
-        return true;
-    }
-
-    private constructor(
-        public readonly directory: string,
-        public data: Package.Data,
-    ) {}
-
-    private static async load(file: string): Promise<Package.Data> {
-        const content: string = await fs.promises.readFile(file, "utf8");
-        return JSON.parse(content);
-    }
-}
-export namespace Package {
-    export interface Data {
-        scripts?: Record<string, string>;
-        dependencies?: Record<string, string>;
-        devDependencies?: Record<string, string>;
-    }
-}
+import fs from "fs";
+import path from "path";
+
+import { CommandExecutor } from "./CommandExecutor";
+import { FileRetriever } from "./FileRetriever";
+
+export class PackageManager {
+    public manager: string = "npm";
+    public get file(): string {
+        return path.join(this.directory, "package.json");
+    }
+
+    public static async mount(): Promise<PackageManager> {
+        const location: string | null = await FileRetriever.directory(
+            "package.json",
+        )(process.cwd());
+        if (location === null)
+            throw new Error(`Unable to find "package.json" file`);
+
+        return new PackageManager(
+            location,
+            await this.load(path.join(location, "package.json")),
+        );
+    }
+
+    public async save(modifier: (data: Package.Data) => void): Promise<void> {
+        const content: string = await fs.promises.readFile(this.file, "utf8");
+        this.data = JSON.parse(content);
+        modifier(this.data);
+
+        return fs.promises.writeFile(
+            this.file,
+            JSON.stringify(this.data, null, 2),
+            "utf8",
+        );
+    }
+
+    public install(props: {
+        dev: boolean;
+        modulo: string;
+        version: `latest` | `${number}.${number}.${number}`;
+    }): boolean {
+        const middle: string =
+            this.manager === "yarn"
+                ? `add${props.dev ? " -D" : ""}`
+                : `install ${props.dev ? "--save-dev" : "--save"}`;
+        CommandExecutor.run(
+            `${this.manager} ${middle} ${props.modulo}${
+                props.version ? `@${props.version}` : ""
+            }`,
+        );
+        return true;
+    }
+
+    private constructor(
+        public readonly directory: string,
+        public data: Package.Data,
+    ) {}
+
+    private static async load(file: string): Promise<Package.Data> {
+        const content: string = await fs.promises.readFile(file, "utf8");
+        return JSON.parse(content);
+    }
+}
+export namespace Package {
+    export interface Data {
+        scripts?: Record<string, string>;
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+    }
+}

package/src/executable/setup/PluginConfigurator.ts

@@ -1,59 +1,59 @@
-import comments from "comment-json";
-import fs from "fs";
-
-import { TypiaSetupWizard } from "../TypiaSetupWizard";
-
-export namespace PluginConfigurator {
-    export async function configure(
-        args: TypiaSetupWizard.IArguments,
-    ): Promise<void> {
-        // GET COMPILER-OPTIONS
-        const config: comments.CommentObject = comments.parse(
-            await fs.promises.readFile(args.project!, "utf8"),
-        ) as comments.CommentObject;
-        const compilerOptions = config.compilerOptions as
-            | comments.CommentObject
-            | undefined;
-        if (compilerOptions === undefined)
-            throw new Error(
-                `${args.project} file does not have "compilerOptions" property.`,
-            );
-
-        // PREPARE PLUGINS
-        const plugins: comments.CommentArray<comments.CommentObject> = (() => {
-            const plugins = compilerOptions.plugins as
-                | comments.CommentArray<comments.CommentObject>
-                | undefined;
-            if (plugins === undefined)
-                return (compilerOptions.plugins = [] as any);
-            else if (!Array.isArray(plugins))
-                throw new Error(
-                    `"plugins" property of ${args.project} must be array type.`,
-                );
-            return plugins;
-        })();
-
-        const strict: boolean = compilerOptions.strict === true;
-        const oldbie: comments.CommentObject | undefined = plugins.find(
-            (p) =>
-                typeof p === "object" &&
-                p !== null &&
-                p.transform === "typia/lib/transform",
-        );
-        if (strict === true && oldbie !== undefined) return;
-
-        // DO CONFIGURE
-        compilerOptions.strict = true;
-        if (oldbie === undefined)
-            plugins.push(
-                comments.parse(`
-                        {
-                            "transform": "typia/lib/transform"
-                        }`) as comments.CommentObject,
-            );
-        await fs.promises.writeFile(
-            args.project!,
-            comments.stringify(config, null, 2),
-        );
-    }
-}
+import comments from "comment-json";
+import fs from "fs";
+
+import { TypiaSetupWizard } from "../TypiaSetupWizard";
+
+export namespace PluginConfigurator {
+    export async function configure(
+        args: TypiaSetupWizard.IArguments,
+    ): Promise<void> {
+        // GET COMPILER-OPTIONS
+        const config: comments.CommentObject = comments.parse(
+            await fs.promises.readFile(args.project!, "utf8"),
+        ) as comments.CommentObject;
+        const compilerOptions = config.compilerOptions as
+            | comments.CommentObject
+            | undefined;
+        if (compilerOptions === undefined)
+            throw new Error(
+                `${args.project} file does not have "compilerOptions" property.`,
+            );
+
+        // PREPARE PLUGINS
+        const plugins: comments.CommentArray<comments.CommentObject> = (() => {
+            const plugins = compilerOptions.plugins as
+                | comments.CommentArray<comments.CommentObject>
+                | undefined;
+            if (plugins === undefined)
+                return (compilerOptions.plugins = [] as any);
+            else if (!Array.isArray(plugins))
+                throw new Error(
+                    `"plugins" property of ${args.project} must be array type.`,
+                );
+            return plugins;
+        })();
+
+        const strict: boolean = compilerOptions.strict === true;
+        const oldbie: comments.CommentObject | undefined = plugins.find(
+            (p) =>
+                typeof p === "object" &&
+                p !== null &&
+                p.transform === "typia/lib/transform",
+        );
+        if (strict === true && oldbie !== undefined) return;
+
+        // DO CONFIGURE
+        compilerOptions.strict = true;
+        if (oldbie === undefined)
+            plugins.push(
+                comments.parse(`
+                        {
+                            "transform": "typia/lib/transform"
+                        }`) as comments.CommentObject,
+            );
+        await fs.promises.writeFile(
+            args.project!,
+            comments.stringify(config, null, 2),
+        );
+    }
+}

package/src/executable/typia.ts

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-const USAGE = `Wrong command has been detected. Use like below:
-
-  npx typia setup \\
-    --manager (npm|pnpm|yarn) \\
-    --project {tsconfig.json file path}
-
-    - npx typia setup
-    - npx typia setup --manager pnpm
-    - npx typia setup --project tsconfig.test.json
-
-  npx typia generate 
-    --input {directory} \\
-    --output {directory}
-
-    --npx typia generate --input src/templates --output src/functinoal
-`;
-
-function halt(desc: string): never {
-    console.error(desc);
-    process.exit(-1);
-}
-
-async function main(): Promise<void> {
-    try {
-        await import("comment-json");
-        await import("inquirer");
-        await import("commander");
-    } catch {
-        halt(`typia has not been installed. Run "npm i typia" before.`);
-    }
-
-    const type: string | undefined = process.argv[2];
-    if (type === "setup") {
-        const { TypiaSetupWizard } = await import("./TypiaSetupWizard");
-        await TypiaSetupWizard.setup();
-    } else if (type === "generate") {
-        try {
-            await import("typescript");
-        } catch {
-            halt(
-                `typescript has not been installed. Run "npm i -D typescript" before.`,
-            );
-        }
-        const { TypiaGenerateWizard } = await import("./TypiaGenerateWizard");
-        await TypiaGenerateWizard.generate();
-    } else halt(USAGE);
-}
-main().catch((exp) => {
-    console.error(exp);
-    process.exit(-1);
-});
+#!/usr/bin/env node
+const USAGE = `Wrong command has been detected. Use like below:
+
+  npx typia setup \\
+    --manager (npm|pnpm|yarn) \\
+    --project {tsconfig.json file path}
+
+    - npx typia setup
+    - npx typia setup --manager pnpm
+    - npx typia setup --project tsconfig.test.json
+
+  npx typia generate 
+    --input {directory} \\
+    --output {directory}
+
+    --npx typia generate --input src/templates --output src/functinoal
+`;
+
+const halt = (desc: string): never => {
+    console.error(desc);
+    process.exit(-1);
+};
+
+const main = async (): Promise<void> => {
+    try {
+        await import("comment-json");
+        await import("inquirer");
+        await import("commander");
+    } catch {
+        halt(`typia has not been installed. Run "npm i typia" before.`);
+    }
+
+    const type: string | undefined = process.argv[2];
+    if (type === "setup") {
+        const { TypiaSetupWizard } = await import("./TypiaSetupWizard");
+        await TypiaSetupWizard.setup();
+    } else if (type === "generate") {
+        try {
+            await import("typescript");
+        } catch {
+            halt(
+                `typescript has not been installed. Run "npm i -D typescript" before.`,
+            );
+        }
+        const { TypiaGenerateWizard } = await import("./TypiaGenerateWizard");
+        await TypiaGenerateWizard.generate();
+    } else halt(USAGE);
+};
+main().catch((exp) => {
+    console.error(exp);
+    process.exit(-1);
+});

package/src/factories/CommentFactory.ts

@@ -1,10 +1,15 @@
 import ts from "typescript";
 
 export namespace CommentFactory {
-    export function generate(comments: ts.SymbolDisplayPart[]): string {
-        return comments
+    export const string = (comments: ts.SymbolDisplayPart[]): string =>
+        comments
             .map((part) => part.text)
             .map((str) => str.split("\r\n").join("\n"))
             .join("");
-    }
+
+    /**
+     * @deprecated
+     * @internal
+     */
+    export const generate = string;
 }

package/src/factories/ExpressionFactory.ts

@@ -1,77 +1,70 @@
 import ts from "typescript";
 
 export namespace ExpressionFactory {
-    export function isRequired(input: ts.Expression): ts.Expression {
-        return ts.factory.createStrictInequality(
+    export const isRequired = (input: ts.Expression): ts.Expression =>
+        ts.factory.createStrictInequality(
             ts.factory.createIdentifier("undefined"),
             input,
         );
-    }
 
-    export function isArray(input: ts.Expression): ts.Expression {
-        return ts.factory.createCallExpression(
+    export const isArray = (input: ts.Expression): ts.Expression =>
+        ts.factory.createCallExpression(
             ts.factory.createIdentifier("Array.isArray"),
             undefined,
             [input],
         );
-    }
 
-    export function isObject(
-        input: ts.Expression,
-        options: {
-            checkNull: boolean;
-            checkArray: boolean;
-        },
-    ): ts.Expression {
-        const conditions: ts.Expression[] = [
-            ts.factory.createStrictEquality(
-                ts.factory.createStringLiteral("object"),
-                ts.factory.createTypeOfExpression(input),
-            ),
-        ];
-        if (options.checkNull === true)
-            conditions.push(
-                ts.factory.createStrictInequality(
-                    ts.factory.createNull(),
-                    input,
-                ),
-            );
-        if (options.checkArray === true)
-            conditions.push(
+    export const isObject =
+        (options: { checkNull: boolean; checkArray: boolean }) =>
+        (input: ts.Expression): ts.Expression => {
+            const conditions: ts.Expression[] = [
                 ts.factory.createStrictEquality(
-                    ts.factory.createFalse(),
-                    ts.factory.createCallExpression(
-                        ts.factory.createIdentifier("Array.isArray"),
-                        undefined,
-                        [input],
-                    ),
+                    ts.factory.createStringLiteral("object"),
+                    ts.factory.createTypeOfExpression(input),
                 ),
-            );
+            ];
+            if (options.checkNull === true)
+                conditions.push(
+                    ts.factory.createStrictInequality(
+                        ts.factory.createNull(),
+                        input,
+                    ),
+                );
+            if (options.checkArray === true)
+                conditions.push(
+                    ts.factory.createStrictEquality(
+                        ts.factory.createFalse(),
+                        ts.factory.createCallExpression(
+                            ts.factory.createIdentifier("Array.isArray"),
+                            undefined,
+                            [input],
+                        ),
+                    ),
+                );
 
-        return conditions.length === 1
-            ? conditions[0]!
-            : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
-    }
+            return conditions.length === 1
+                ? conditions[0]!
+                : conditions.reduce((x, y) =>
+                      ts.factory.createLogicalAnd(x, y),
+                  );
+        };
 
-    export function isInstanceOf(
-        input: ts.Expression,
-        type: string,
-    ): ts.Expression {
-        return ts.factory.createBinaryExpression(
-            input,
-            ts.factory.createToken(ts.SyntaxKind.InstanceOfKeyword),
-            ts.factory.createIdentifier(type),
-        );
-    }
+    export const isInstanceOf =
+        (type: string) =>
+        (input: ts.Expression): ts.Expression => {
+            return ts.factory.createBinaryExpression(
+                input,
+                ts.factory.createToken(ts.SyntaxKind.InstanceOfKeyword),
+                ts.factory.createIdentifier(type),
+            );
+        };
 
-    export function coalesce(
-        x: ts.Expression,
-        y: ts.Expression,
-    ): ts.Expression {
-        return ts.factory.createBinaryExpression(
-            x,
-            ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
-            y,
-        );
-    }
+    export const coalesce =
+        (x: ts.Expression) =>
+        (y: ts.Expression): ts.Expression =>
+            ts.factory.createBinaryExpression(
+                x,
+                ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+                y,
+            );
 }

package/src/factories/IdentifierFactory.ts

@@ -1,59 +1,57 @@
-import ts from "typescript";
-
-import { Escaper } from "../utils/Escaper";
-
-export namespace IdentifierFactory {
-    export function generate(name: string) {
-        return Escaper.variable(name)
-            ? ts.factory.createIdentifier(name)
-            : ts.factory.createStringLiteral(name);
-    }
-
-    export function join(prefix: ts.Expression, name: string) {
-        const postfix = generate(name);
-        return ts.isStringLiteral(postfix)
-            ? ts.factory.createElementAccessExpression(prefix, postfix)
-            : ts.factory.createPropertyAccessExpression(prefix, postfix);
-    }
-
-    export function postfix(str: string): string {
-        return Escaper.variable(str)
-            ? `".${str}"`
-            : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
-    }
-
-    export function parameter(
-        name: string | ts.BindingName,
-        type?: ts.TypeNode,
-        init?: ts.Expression | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
-    ) {
-        // instead of ts.version >= "4.8"
-        if (ts.getDecorators !== undefined)
-            return ts.factory.createParameterDeclaration(
-                undefined,
-                undefined,
-                name,
-                init?.kind === ts.SyntaxKind.QuestionToken
-                    ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
-                    : undefined,
-                type,
-                init && init.kind !== ts.SyntaxKind.QuestionToken
-                    ? init
-                    : undefined,
-            );
-        // eslint-disable-next-line
-        return (ts.factory.createParameterDeclaration as any)(
-            undefined,
-            undefined,
-            undefined,
-            name,
-            init?.kind === ts.SyntaxKind.QuestionToken
-                ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
-                : undefined,
-            type,
-            init && init.kind !== ts.SyntaxKind.QuestionToken
-                ? init
-                : undefined,
-        );
-    }
-}
+import ts from "typescript";
+
+import { Escaper } from "../utils/Escaper";
+
+export namespace IdentifierFactory {
+    export const accessor = (name: string) =>
+        Escaper.variable(name)
+            ? ts.factory.createIdentifier(name)
+            : ts.factory.createStringLiteral(name);
+
+    export const join = (prefix: ts.Expression) => (name: string) => {
+        const postfix = accessor(name);
+        return ts.isStringLiteral(postfix)
+            ? ts.factory.createElementAccessExpression(prefix, postfix)
+            : ts.factory.createPropertyAccessExpression(prefix, postfix);
+    };
+
+    export const postfix = (str: string): string =>
+        Escaper.variable(str)
+            ? `".${str}"`
+            : `"[${JSON.stringify(str).split('"').join('\\"')}]"`;
+
+    export const parameter = (
+        name: string | ts.BindingName,
+        type?: ts.TypeNode,
+        init?: ts.Expression | ts.PunctuationToken<ts.SyntaxKind.QuestionToken>,
+    ) => {
+        // instead of ts.version >= "4.8"
+        if (ts.getDecorators !== undefined)
+            return ts.factory.createParameterDeclaration(
+                undefined,
+                undefined,
+                name,
+                init?.kind === ts.SyntaxKind.QuestionToken
+                    ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+                    : undefined,
+                type,
+                init && init.kind !== ts.SyntaxKind.QuestionToken
+                    ? init
+                    : undefined,
+            );
+        // eslint-disable-next-line
+        return (ts.factory.createParameterDeclaration as any)(
+            undefined,
+            undefined,
+            undefined,
+            name,
+            init?.kind === ts.SyntaxKind.QuestionToken
+                ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+                : undefined,
+            type,
+            init && init.kind !== ts.SyntaxKind.QuestionToken
+                ? init
+                : undefined,
+        );
+    };
+}