typia 6.6.3-dev.20240801 → 6.7.0-dev.20240802

package/src/executable/TypiaPatchWizard.ts

@@ -1,42 +1,42 @@
-import fs from "fs";
-
-export namespace TypiaPatchWizard {
-  export const main = async (): Promise<void> => {
-    console.log("----------------------------------------");
-    console.log(" Typia Setup Wizard");
-    console.log("----------------------------------------");
-    console.log(
-      [
-        `Since TypeScript v5.3 update, "tsc" no more parses JSDoc comments.`,
-        ``,
-        `Therefore, "typia" revives the JSDoc parsing feature by patching "tsc".`,
-        ``,
-        `This is a temporary feature of "typia", and it would be removed when "ts-patch" being updated.`,
-      ].join("\n"),
-    );
-
-    await patch();
-  };
-
-  export const patch = async (): Promise<void> => {
-    const location: string = require.resolve("typescript/lib/tsc.js");
-    const content: string = await fs.promises.readFile(location, "utf8");
-    if (content.indexOf(FROM_WITH_COMMENT) !== -1)
-      await fs.promises.writeFile(
-        location,
-        content.replace(FROM_WITH_COMMENT, TO_WITH_COMMENT),
-        "utf8",
-      );
-    else if (content.indexOf(FROM_ONLY) !== -1)
-      await fs.promises.writeFile(
-        location,
-        content.replace(FROM_ONLY, TO_ONLY),
-        "utf8",
-      );
-  };
-}
-
-const FROM_WITH_COMMENT = `var defaultJSDocParsingMode = 2 /* ParseForTypeErrors */`;
-const TO_WITH_COMMENT = `var defaultJSDocParsingMode = 0 /* ParseAll */`;
-const FROM_ONLY = `var defaultJSDocParsingMode = 2`;
-const TO_ONLY = `var defaultJSDocParsingMode = 0`;
+import fs from "fs";
+
+export namespace TypiaPatchWizard {
+  export const main = async (): Promise<void> => {
+    console.log("----------------------------------------");
+    console.log(" Typia Setup Wizard");
+    console.log("----------------------------------------");
+    console.log(
+      [
+        `Since TypeScript v5.3 update, "tsc" no more parses JSDoc comments.`,
+        ``,
+        `Therefore, "typia" revives the JSDoc parsing feature by patching "tsc".`,
+        ``,
+        `This is a temporary feature of "typia", and it would be removed when "ts-patch" being updated.`,
+      ].join("\n"),
+    );
+
+    await patch();
+  };
+
+  export const patch = async (): Promise<void> => {
+    const location: string = require.resolve("typescript/lib/tsc.js");
+    const content: string = await fs.promises.readFile(location, "utf8");
+    if (content.indexOf(FROM_WITH_COMMENT) !== -1)
+      await fs.promises.writeFile(
+        location,
+        content.replace(FROM_WITH_COMMENT, TO_WITH_COMMENT),
+        "utf8",
+      );
+    else if (content.indexOf(FROM_ONLY) !== -1)
+      await fs.promises.writeFile(
+        location,
+        content.replace(FROM_ONLY, TO_ONLY),
+        "utf8",
+      );
+  };
+}
+
+const FROM_WITH_COMMENT = `var defaultJSDocParsingMode = 2 /* ParseForTypeErrors */`;
+const TO_WITH_COMMENT = `var defaultJSDocParsingMode = 0 /* ParseAll */`;
+const FROM_ONLY = `var defaultJSDocParsingMode = 2`;
+const TO_ONLY = `var defaultJSDocParsingMode = 0`;

package/src/executable/TypiaSetupWizard.ts

@@ -1,151 +1,151 @@
-import fs from "fs";
-
-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 {
-    manager: "npm" | "pnpm" | "yarn" | "bun";
-    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)(inquiry);
-
-    // INSTALL TYPESCRIPT COMPILERS
-    pack.install({ dev: true, modulo: "typescript", version: "5.5.2" });
-    pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
-    args.project ??= (() => {
-      const runner: string = pack.manager === "npm" ? "npx" : pack.manager;
-      CommandExecutor.run(`${runner} tsc --init`);
-      return (args.project = "tsconfig.json");
-    })();
-
-    // SETUP TRANSFORMER
-    await pack.save((data) => {
-      // COMPOSE PREPARE COMMAND
-      data.scripts ??= {};
-      if (
-        typeof data.scripts.prepare === "string" &&
-        data.scripts.prepare.trim().length
-      ) {
-        if (
-          data.scripts.prepare.indexOf("ts-patch install") === -1 &&
-          data.scripts.prepare.indexOf("typia patch") === -1
-        )
-          data.scripts.prepare =
-            "ts-patch install && typia patch && " + data.scripts.prepare;
-        else if (data.scripts.prepare.indexOf("ts-patch install") === -1)
-          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
-        else if (data.scripts.prepare.indexOf("typia patch") === -1)
-          data.scripts.prepare = data.scripts.prepare.replace(
-            "ts-patch install",
-            "ts-patch install && typia patch",
-          );
-      } else data.scripts.prepare = "ts-patch install && typia patch";
-
-      // FOR OLDER VERSIONS
-      if (typeof data.scripts.postinstall === "string") {
-        data.scripts.postinstall = data.scripts.postinstall
-          .split("&&")
-          .map((str) => str.trim())
-          .filter((str) => str.indexOf("ts-patch install") === -1)
-          .join(" && ");
-        if (data.scripts.postinstall.length === 0)
-          delete data.scripts.postinstall;
-      }
-    });
-
-    // CONFIGURE TYPIA
-    await PluginConfigurator.configure(args);
-    CommandExecutor.run(`${pack.manager} run prepare`);
-  }
-
-  const inquiry: ArgumentParser.Inquiry<IArguments> = async (
-    pack,
-    command,
-    prompt,
-    action,
-  ) => {
-    // PREPARE ASSETS
-    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[],
-        filter?: (choice: string) => Choice,
-      ): Promise<Choice> => {
-        questioned.value = true;
-        return (
-          await prompt()({
-            type: "list",
-            name: name,
-            message: message,
-            choices: choices,
-            ...(filter
-              ? {
-                  filter,
-                }
-              : {}),
-          })
-        )[name];
-      };
-    const configure = async (): Promise<string | null> => {
-      const fileList: string[] = await (
-        await fs.promises.readdir(process.cwd())
-      )
-        .filter(
-          (str) =>
-            str.substring(0, 8) === "tsconfig" &&
-            str.substring(str.length - 5) === ".json",
-        )
-        .sort((x, y) =>
-          x === "tsconfig.json"
-            ? -1
-            : y === "tsconfig.json"
-              ? 1
-              : x < y
-                ? -1
-                : 1,
-        );
-      if (fileList.length === 0) {
-        if (process.cwd() !== pack.directory)
-          throw new URIError(`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) => {
-      pack.manager = options.manager ??= await select("manager")(
-        "Package Manager",
-      )(
-        [
-          "npm" as const,
-          "pnpm" as const,
-          "bun" as const,
-          "yarn (berry is not supported)" as "yarn",
-        ],
-        (value) => value.split(" ")[0] as "yarn",
-      );
-      options.project ??= await configure();
-
-      if (questioned.value) console.log("");
-      return options as IArguments;
-    });
-  };
-}
+import fs from "fs";
+
+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 {
+    manager: "npm" | "pnpm" | "yarn" | "bun";
+    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)(inquiry);
+
+    // INSTALL TYPESCRIPT COMPILERS
+    pack.install({ dev: true, modulo: "typescript", version: "5.5.2" });
+    pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
+    args.project ??= (() => {
+      const runner: string = pack.manager === "npm" ? "npx" : pack.manager;
+      CommandExecutor.run(`${runner} tsc --init`);
+      return (args.project = "tsconfig.json");
+    })();
+
+    // SETUP TRANSFORMER
+    await pack.save((data) => {
+      // COMPOSE PREPARE COMMAND
+      data.scripts ??= {};
+      if (
+        typeof data.scripts.prepare === "string" &&
+        data.scripts.prepare.trim().length
+      ) {
+        if (
+          data.scripts.prepare.indexOf("ts-patch install") === -1 &&
+          data.scripts.prepare.indexOf("typia patch") === -1
+        )
+          data.scripts.prepare =
+            "ts-patch install && typia patch && " + data.scripts.prepare;
+        else if (data.scripts.prepare.indexOf("ts-patch install") === -1)
+          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
+        else if (data.scripts.prepare.indexOf("typia patch") === -1)
+          data.scripts.prepare = data.scripts.prepare.replace(
+            "ts-patch install",
+            "ts-patch install && typia patch",
+          );
+      } else data.scripts.prepare = "ts-patch install && typia patch";
+
+      // FOR OLDER VERSIONS
+      if (typeof data.scripts.postinstall === "string") {
+        data.scripts.postinstall = data.scripts.postinstall
+          .split("&&")
+          .map((str) => str.trim())
+          .filter((str) => str.indexOf("ts-patch install") === -1)
+          .join(" && ");
+        if (data.scripts.postinstall.length === 0)
+          delete data.scripts.postinstall;
+      }
+    });
+
+    // CONFIGURE TYPIA
+    await PluginConfigurator.configure(args);
+    CommandExecutor.run(`${pack.manager} run prepare`);
+  }
+
+  const inquiry: ArgumentParser.Inquiry<IArguments> = async (
+    pack,
+    command,
+    prompt,
+    action,
+  ) => {
+    // PREPARE ASSETS
+    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[],
+        filter?: (choice: string) => Choice,
+      ): Promise<Choice> => {
+        questioned.value = true;
+        return (
+          await prompt()({
+            type: "list",
+            name: name,
+            message: message,
+            choices: choices,
+            ...(filter
+              ? {
+                  filter,
+                }
+              : {}),
+          })
+        )[name];
+      };
+    const configure = async (): Promise<string | null> => {
+      const fileList: string[] = await (
+        await fs.promises.readdir(process.cwd())
+      )
+        .filter(
+          (str) =>
+            str.substring(0, 8) === "tsconfig" &&
+            str.substring(str.length - 5) === ".json",
+        )
+        .sort((x, y) =>
+          x === "tsconfig.json"
+            ? -1
+            : y === "tsconfig.json"
+              ? 1
+              : x < y
+                ? -1
+                : 1,
+        );
+      if (fileList.length === 0) {
+        if (process.cwd() !== pack.directory)
+          throw new URIError(`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) => {
+      pack.manager = options.manager ??= await select("manager")(
+        "Package Manager",
+      )(
+        [
+          "npm" as const,
+          "pnpm" as const,
+          "bun" as const,
+          "yarn (berry is not supported)" as "yarn",
+        ],
+        (value) => value.split(" ")[0] as "yarn",
+      );
+      options.project ??= await configure();
+
+      if (questioned.value) console.log("");
+      return options as IArguments;
+    });
+  };
+}

package/src/executable/setup/ArgumentParser.ts

@@ -1,43 +1,43 @@
-import commander from "commander";
-import inquirer from "inquirer";
-
-import { PackageManager } from "./PackageManager";
-
-export namespace ArgumentParser {
-  export type Inquiry<T> = (
-    pack: PackageManager,
-    command: commander.Command,
-    prompt: (opt?: inquirer.StreamOptions) => inquirer.PromptModule,
-    action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
-  ) => Promise<T>;
-
-  export const parse =
-    (pack: PackageManager) =>
-    async <T>(
-      inquiry: (
-        pack: PackageManager,
-        command: commander.Command,
-        prompt: (opt?: inquirer.StreamOptions) => inquirer.PromptModule,
-        action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
-      ) => Promise<T>,
-    ): Promise<T> => {
-      // TAKE OPTIONS
-      const action = (closure: (options: Partial<T>) => Promise<T>) =>
-        new Promise<T>((resolve, reject) => {
-          commander.program.action(async (options) => {
-            try {
-              resolve(await closure(options));
-            } catch (exp) {
-              reject(exp);
-            }
-          });
-          commander.program.parseAsync().catch(reject);
-        });
-      return inquiry(
-        pack,
-        commander.program,
-        inquirer.createPromptModule,
-        action,
-      );
-    };
-}
+import commander from "commander";
+import inquirer from "inquirer";
+
+import { PackageManager } from "./PackageManager";
+
+export namespace ArgumentParser {
+  export type Inquiry<T> = (
+    pack: PackageManager,
+    command: commander.Command,
+    prompt: (opt?: inquirer.StreamOptions) => inquirer.PromptModule,
+    action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
+  ) => Promise<T>;
+
+  export const parse =
+    (pack: PackageManager) =>
+    async <T>(
+      inquiry: (
+        pack: PackageManager,
+        command: commander.Command,
+        prompt: (opt?: inquirer.StreamOptions) => inquirer.PromptModule,
+        action: (closure: (options: Partial<T>) => Promise<T>) => Promise<T>,
+      ) => Promise<T>,
+    ): Promise<T> => {
+      // TAKE OPTIONS
+      const action = (closure: (options: Partial<T>) => Promise<T>) =>
+        new Promise<T>((resolve, reject) => {
+          commander.program.action(async (options) => {
+            try {
+              resolve(await closure(options));
+            } catch (exp) {
+              reject(exp);
+            }
+          });
+          commander.program.parseAsync().catch(reject);
+        });
+      return inquiry(
+        pack,
+        commander.program,
+        inquirer.createPromptModule,
+        action,
+      );
+    };
+}

package/src/executable/setup/CommandExecutor.ts

@@ -1,8 +1,8 @@
-import cp from "child_process";
-
-export namespace CommandExecutor {
-  export const run = (str: string): void => {
-    console.log(`\n$ ${str}`);
-    cp.execSync(str, { stdio: "inherit" });
-  };
-}
+import cp from "child_process";
+
+export namespace CommandExecutor {
+  export const run = (str: string): void => {
+    console.log(`\n$ ${str}`);
+    cp.execSync(str, { stdio: "inherit" });
+  };
+}

package/src/executable/setup/FileRetriever.ts

@@ -1,22 +1,22 @@
-import fs from "fs";
-import path from "path";
-
-export namespace FileRetriever {
-  export const directory =
-    (name: string) =>
-    (dir: string, depth: number = 0): string | null => {
-      const location: string = path.join(dir, name);
-      if (fs.existsSync(location)) return dir;
-      else if (depth > 2) return null;
-      return directory(name)(path.join(dir, ".."), depth + 1);
-    };
-
-  export const file =
-    (name: string) =>
-    (directory: string, depth: number = 0): string | null => {
-      const location: string = path.join(directory, name);
-      if (fs.existsSync(location)) return location;
-      else if (depth > 2) return null;
-      return file(name)(path.join(directory, ".."), depth + 1);
-    };
-}
+import fs from "fs";
+import path from "path";
+
+export namespace FileRetriever {
+  export const directory =
+    (name: string) =>
+    (dir: string, depth: number = 0): string | null => {
+      const location: string = path.join(dir, name);
+      if (fs.existsSync(location)) return dir;
+      else if (depth > 2) return null;
+      return directory(name)(path.join(dir, ".."), depth + 1);
+    };
+
+  export const file =
+    (name: string) =>
+    (directory: string, depth: number = 0): string | null => {
+      const location: string = path.join(directory, name);
+      if (fs.existsSync(location)) return location;
+      else if (depth > 2) return null;
+      return file(name)(path.join(directory, ".."), depth + 1);
+    };
+}