typia 12.0.0-dev.20260307-2 → 12.0.0-dev.20260310

package/src/TypeGuardError.ts

@@ -1,145 +1,145 @@
-/**
- * Error thrown when type assertion fails.
- *
- * Thrown by {@link assert}, {@link assertGuard}, and other assert-family
- * functions when input doesn't match expected type `T`. Contains detailed
- * information about the first assertion failure:
- *
- * - `method`: Which typia function threw (e.g., `"typia.assert"`)
- * - `path`: Property path where error occurred (e.g., `"input.user.age"`)
- * - `expected`: Expected type string (e.g., `"number & ExclusiveMinimum<19>"`)
- * - `value`: Actual value that failed validation
- *
- * @template T Expected type (for type safety)
- */
-export class TypeGuardError<T = any> extends Error {
-  /**
-   * Name of the typia method that threw this error.
-   *
-   * E.g., `"typia.assert"`, `"typia.assertEquals"`, `"typia.assertGuard"`.
-   */
-  public readonly method: string;
-
-  /**
-   * Property path where assertion failed.
-   *
-   * Uses dot notation for nested properties. `undefined` if error occurred at
-   * root level.
-   *
-   * E.g., `"input.age"`, `"input.profile.email"`, `"input[0].name"`.
-   */
-  public readonly path: string | undefined;
-
-  /**
-   * String representation of expected type.
-   *
-   * E.g., `"string"`, `"number & ExclusiveMinimum<19>"`, `"{ name: string; age:
-   * number }"`.
-   */
-  public readonly expected: string;
-
-  /**
-   * Actual value that failed assertion.
-   *
-   * The raw value at the error path, useful for debugging.
-   */
-  public readonly value: unknown;
-
-  /**
-   * Optional human-readable error description.
-   *
-   * Primarily for AI agent libraries or custom validation scenarios needing
-   * additional context. Standard assertions rely on `path`, `expected`, and
-   * `value` for error reporting.
-   */
-  public readonly description?: string | undefined;
-
-  /**
-   * Phantom property for TypeScript type safety.
-   *
-   * Not used at runtime—exists only to preserve generic type `T` in the type
-   * system. Always `undefined`.
-   *
-   * @internal
-   */
-  protected readonly fake_expected_typed_value_?: T | undefined;
-
-  /**
-   * Creates a new TypeGuardError instance.
-   *
-   * @param props Error properties
-   */
-  public constructor(props: TypeGuardError.IProps) {
-    // MESSAGE CONSTRUCTION
-    // Use custom message if provided, otherwise generate default format
-    super(
-      props.message ||
-        `Error on ${props.method}(): invalid type${
-          props.path ? ` on ${props.path}` : ""
-        }, expect to be ${props.expected}`,
-    );
-
-    // INHERITANCE POLYFILL
-    // Set up prototype for compatibility across different JavaScript environments
-    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;
-    if (props.description || props.value === undefined)
-      this.description =
-        props.description ??
-        [
-          "The value at this path is `undefined`.",
-          "",
-          `Please fill the \`${props.expected}\` typed value next time.`,
-        ].join("\n");
-  }
-}
-
-export namespace TypeGuardError {
-  /** Properties for constructing a TypeGuardError. */
-  export interface IProps {
-    /**
-     * Name of the typia method that threw the error.
-     *
-     * E.g., `"typia.assert"`, `"typia.assertEquals"`.
-     */
-    method: string;
-
-    /**
-     * Property path where assertion failed (optional).
-     *
-     * E.g., `"input.age"`, `"input.profile.email"`.
-     */
-    path?: undefined | string;
-
-    /**
-     * String representation of expected type.
-     *
-     * E.g., `"string"`, `"number & ExclusiveMinimum<19>"`.
-     */
-    expected: string;
-
-    /** Actual value that failed assertion. */
-    value: unknown;
-
-    /**
-     * Optional human-readable error description.
-     *
-     * For AI agent libraries or custom validation needing additional context.
-     */
-    description?: string;
-
-    /**
-     * Custom error message (optional).
-     *
-     * If not provided, a default message is generated from other properties.
-     */
-    message?: undefined | string;
-  }
-}
+/**
+ * Error thrown when type assertion fails.
+ *
+ * Thrown by {@link assert}, {@link assertGuard}, and other assert-family
+ * functions when input doesn't match expected type `T`. Contains detailed
+ * information about the first assertion failure:
+ *
+ * - `method`: Which typia function threw (e.g., `"typia.assert"`)
+ * - `path`: Property path where error occurred (e.g., `"input.user.age"`)
+ * - `expected`: Expected type string (e.g., `"number & ExclusiveMinimum<19>"`)
+ * - `value`: Actual value that failed validation
+ *
+ * @template T Expected type (for type safety)
+ */
+export class TypeGuardError<T = any> extends Error {
+  /**
+   * Name of the typia method that threw this error.
+   *
+   * E.g., `"typia.assert"`, `"typia.assertEquals"`, `"typia.assertGuard"`.
+   */
+  public readonly method: string;
+
+  /**
+   * Property path where assertion failed.
+   *
+   * Uses dot notation for nested properties. `undefined` if error occurred at
+   * root level.
+   *
+   * E.g., `"input.age"`, `"input.profile.email"`, `"input[0].name"`.
+   */
+  public readonly path: string | undefined;
+
+  /**
+   * String representation of expected type.
+   *
+   * E.g., `"string"`, `"number & ExclusiveMinimum<19>"`, `"{ name: string; age:
+   * number }"`.
+   */
+  public readonly expected: string;
+
+  /**
+   * Actual value that failed assertion.
+   *
+   * The raw value at the error path, useful for debugging.
+   */
+  public readonly value: unknown;
+
+  /**
+   * Optional human-readable error description.
+   *
+   * Primarily for AI agent libraries or custom validation scenarios needing
+   * additional context. Standard assertions rely on `path`, `expected`, and
+   * `value` for error reporting.
+   */
+  public readonly description?: string | undefined;
+
+  /**
+   * Phantom property for TypeScript type safety.
+   *
+   * Not used at runtime—exists only to preserve generic type `T` in the type
+   * system. Always `undefined`.
+   *
+   * @internal
+   */
+  protected readonly fake_expected_typed_value_?: T | undefined;
+
+  /**
+   * Creates a new TypeGuardError instance.
+   *
+   * @param props Error properties
+   */
+  public constructor(props: TypeGuardError.IProps) {
+    // MESSAGE CONSTRUCTION
+    // Use custom message if provided, otherwise generate default format
+    super(
+      props.message ||
+        `Error on ${props.method}(): invalid type${
+          props.path ? ` on ${props.path}` : ""
+        }, expect to be ${props.expected}`,
+    );
+
+    // INHERITANCE POLYFILL
+    // Set up prototype for compatibility across different JavaScript environments
+    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;
+    if (props.description || props.value === undefined)
+      this.description =
+        props.description ??
+        [
+          "The value at this path is `undefined`.",
+          "",
+          `Please fill the \`${props.expected}\` typed value next time.`,
+        ].join("\n");
+  }
+}
+
+export namespace TypeGuardError {
+  /** Properties for constructing a TypeGuardError. */
+  export interface IProps {
+    /**
+     * Name of the typia method that threw the error.
+     *
+     * E.g., `"typia.assert"`, `"typia.assertEquals"`.
+     */
+    method: string;
+
+    /**
+     * Property path where assertion failed (optional).
+     *
+     * E.g., `"input.age"`, `"input.profile.email"`.
+     */
+    path?: undefined | string;
+
+    /**
+     * String representation of expected type.
+     *
+     * E.g., `"string"`, `"number & ExclusiveMinimum<19>"`.
+     */
+    expected: string;
+
+    /** Actual value that failed assertion. */
+    value: unknown;
+
+    /**
+     * Optional human-readable error description.
+     *
+     * For AI agent libraries or custom validation needing additional context.
+     */
+    description?: string;
+
+    /**
+     * Custom error message (optional).
+     *
+     * If not provided, a default message is generated from other properties.
+     */
+    message?: undefined | string;
+  }
+}

package/src/executable/TypiaGenerateWizard.ts

@@ -1,82 +1,82 @@
-import { TypiaGenerator } from "@typia/transform";
-import fs from "fs";
-
-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 TypiaGenerator.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 { TypiaGenerator } from "@typia/transform";
+import fs from "fs";
+
+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 TypiaGenerator.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`;