typia 7.1.0 → 7.2.1-dev.20241212

package/src/IRandomGenerator.ts

@@ -1,49 +1,49 @@
-import { OpenApi } from "@samchon/openapi";
-
-export interface IRandomGenerator {
-  // REGULAR
-  boolean(): boolean | undefined;
-  number(schema: OpenApi.IJsonSchema.INumber): number;
-  integer(schema: OpenApi.IJsonSchema.IInteger): number;
-  bigint(schema: OpenApi.IJsonSchema.IInteger): bigint;
-  string(schema: OpenApi.IJsonSchema.IString): string;
-  array<T>(
-    schema: Omit<OpenApi.IJsonSchema.IArray, "items"> & {
-      element: (index: number, count: number) => T;
-    },
-  ): T[];
-  pattern(regex: RegExp): string;
-
-  //----
-  // FORMAT
-  //----
-  // SPECIAL CHARACTERS
-  byte(): string;
-  password(): string;
-  regex(): string;
-  uuid(): string;
-
-  // ADDRESSES
-  email(): string;
-  hostname(): string;
-  idnEmail(): string;
-  idnHostname(): string;
-  iri(): string;
-  iriReference(): string;
-  ipv4(): string;
-  ipv6(): string;
-  uri(): string;
-  uriReference(): string;
-  uriTemplate(): string;
-  url(): string;
-
-  // TIMESTAMPS
-  datetime(props?: { minimum?: number; maximum?: number }): string;
-  date(props?: { minimum?: number; maximum?: number }): string;
-  time(): string;
-  duration(): string;
-
-  // POINTERS
-  jsonPointer(): string;
-  relativeJsonPointer(): string;
-}
+import { OpenApi } from "@samchon/openapi";
+
+export interface IRandomGenerator {
+  // REGULAR
+  boolean(): boolean | undefined;
+  number(schema: OpenApi.IJsonSchema.INumber): number;
+  integer(schema: OpenApi.IJsonSchema.IInteger): number;
+  bigint(schema: OpenApi.IJsonSchema.IInteger): bigint;
+  string(schema: OpenApi.IJsonSchema.IString): string;
+  array<T>(
+    schema: Omit<OpenApi.IJsonSchema.IArray, "items"> & {
+      element: (index: number, count: number) => T;
+    },
+  ): T[];
+  pattern(regex: RegExp): string;
+
+  //----
+  // FORMAT
+  //----
+  // SPECIAL CHARACTERS
+  byte(): string;
+  password(): string;
+  regex(): string;
+  uuid(): string;
+
+  // ADDRESSES
+  email(): string;
+  hostname(): string;
+  idnEmail(): string;
+  idnHostname(): string;
+  iri(): string;
+  iriReference(): string;
+  ipv4(): string;
+  ipv6(): string;
+  uri(): string;
+  uriReference(): string;
+  uriTemplate(): string;
+  url(): string;
+
+  // TIMESTAMPS
+  datetime(props?: { minimum?: number; maximum?: number }): string;
+  date(props?: { minimum?: number; maximum?: number }): string;
+  time(): string;
+  duration(): string;
+
+  // POINTERS
+  jsonPointer(): string;
+  relativeJsonPointer(): string;
+}

package/src/IReadableURLSearchParams.ts

@@ -1,9 +1,9 @@
-/**
- * Interface for a readable URLSearchParams object.
- *
- * This interface is a subset of the {@link URLSearchParams} interface,
- * designed especially for the [Hono.JS](https://hono.dev/) libray.
- *
- * @author https://github.com/miyaji255
- */
-export type IReadableURLSearchParams = Pick<URLSearchParams, "get" | "getAll">;
+/**
+ * Interface for a readable URLSearchParams object.
+ *
+ * This interface is a subset of the {@link URLSearchParams} interface,
+ * designed especially for the [Hono.JS](https://hono.dev/) libray.
+ *
+ * @author https://github.com/miyaji255
+ */
+export type IReadableURLSearchParams = Pick<URLSearchParams, "get" | "getAll">;

package/src/IValidation.ts

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

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`;