typia 9.5.0 → 9.6.0-dev.20250719

package/src/executable/TypiaGenerateWizard.ts

@@ -1,83 +1,83 @@
-import fs from "fs";
-
-import { TypiaProgrammer } from "../programmers/TypiaProgrammer";
-
-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, inquiry);
-    await TypiaProgrammer.build(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 (): Promise<string> => {
-      const files: string[] = await (
-        await fs.promises.readdir(process.cwd())
-      ).filter(
-        (str) =>
-          str.substring(0, 8) === "tsconfig" &&
-          str.substring(str.length - 5) === ".json",
-      );
-      if (files.length === 0)
-        throw new URIError(`Unable to find "tsconfig.json" file.`);
-      else if (files.length === 1) return files[0]!;
-      return select("tsconfig")("TS Config File")(files);
-    };
-
-    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;
-  }
-}
+import fs from "fs";
+
+import { TypiaProgrammer } from "../programmers/TypiaProgrammer";
+
+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, inquiry);
+    await TypiaProgrammer.build(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 (): Promise<string> => {
+      const files: string[] = await (
+        await fs.promises.readdir(process.cwd())
+      ).filter(
+        (str) =>
+          str.substring(0, 8) === "tsconfig" &&
+          str.substring(str.length - 5) === ".json",
+      );
+      if (files.length === 0)
+        throw new URIError(`Unable to find "tsconfig.json" file.`);
+      else if (files.length === 1) return files[0]!;
+      return select("tsconfig")("TS Config File")(files);
+    };
+
+    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/TypiaPatchWizard.ts

@@ -1,45 +1,45 @@
-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> => {
-    for (const file of ["tsc.js", "_tsc.js"])
-      try {
-        const location: string = require.resolve(`typescript/lib/${file}`);
-        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",
-          );
-      } catch {}
-  };
-}
-
-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> => {
+    for (const file of ["tsc.js", "_tsc.js"])
+      try {
+        const location: string = require.resolve(`typescript/lib/${file}`);
+        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",
+          );
+      } catch {}
+  };
+}
+
+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,171 +1,171 @@
-import fs from "fs";
-import { DetectResult, detect } from "package-manager-detector";
-
-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 const setup = async (): 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: await getTypeScriptVersion(),
-    });
-    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 !== 0
-      ) {
-        if (data.scripts.prepare.includes("ts-patch install") === false)
-          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
-      } else data.scripts.prepare = "ts-patch install";
-
-      // NO MORE "typia patch" REQUIRED
-      data.scripts.prepare = data.scripts.prepare
-        .split("&&")
-        .map((str) => str.trim())
-        .filter((str) => str !== "typia patch")
-        .join(" && ");
-
-      // 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 detectManager()) ??
-        (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;
-    });
-  };
-
-  const detectManager = async (): Promise<
-    "npm" | "pnpm" | "yarn" | "bun" | null
-  > => {
-    const result: DetectResult | null = await detect({ cwd: process.cwd() });
-    switch (result?.name) {
-      case "npm":
-      case "deno":
-        return null; // NPM case is still selectable & Deno is not supported
-      default:
-        return result?.name ?? null;
-    }
-  };
-
-  const getTypeScriptVersion = async (): Promise<string> => {
-    const content: string = await fs.promises.readFile(
-      `${__dirname}/../../package.json`,
-      "utf-8",
-    );
-    const json: { devDependencies: { typescript: string } } =
-      JSON.parse(content);
-    return json.devDependencies.typescript;
-  };
-}
+import fs from "fs";
+import { DetectResult, detect } from "package-manager-detector";
+
+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 const setup = async (): 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: await getTypeScriptVersion(),
+    });
+    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 !== 0
+      ) {
+        if (data.scripts.prepare.includes("ts-patch install") === false)
+          data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
+      } else data.scripts.prepare = "ts-patch install";
+
+      // NO MORE "typia patch" REQUIRED
+      data.scripts.prepare = data.scripts.prepare
+        .split("&&")
+        .map((str) => str.trim())
+        .filter((str) => str !== "typia patch")
+        .join(" && ");
+
+      // 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 detectManager()) ??
+        (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;
+    });
+  };
+
+  const detectManager = async (): Promise<
+    "npm" | "pnpm" | "yarn" | "bun" | null
+  > => {
+    const result: DetectResult | null = await detect({ cwd: process.cwd() });
+    switch (result?.name) {
+      case "npm":
+      case "deno":
+        return null; // NPM case is still selectable & Deno is not supported
+      default:
+        return result?.name ?? null;
+    }
+  };
+
+  const getTypeScriptVersion = async (): Promise<string> => {
+    const content: string = await fs.promises.readFile(
+      `${__dirname}/../../package.json`,
+      "utf-8",
+    );
+    const json: { devDependencies: { typescript: string } } =
+      JSON.parse(content);
+    return json.devDependencies.typescript;
+  };
+}