typia 5.3.0-dev.20231117 → 5.3.0-dev.20231119

package/src/transformers/FileTransformer.ts

@@ -1,57 +1,57 @@
-import ts from "typescript";
-
-import { IProject } from "./IProject";
-import { NodeTransformer } from "./NodeTransformer";
-import { TransformerError } from "./TransformerError";
-
-export namespace FileTransformer {
-    export const transform =
-        (project: Omit<IProject, "context">) =>
-        (context: ts.TransformationContext) =>
-        (file: ts.SourceFile): ts.SourceFile => {
-            if (file.isDeclarationFile) return file;
-            return ts.visitEachChild(
-                file,
-                (node) => iterate_node({ ...project, context })(context)(node),
-                context,
-            );
-        };
-
-    const iterate_node =
-        (project: IProject) =>
-        (context: ts.TransformationContext) =>
-        (node: ts.Node): ts.Node =>
-            ts.visitEachChild(
-                try_transform_node(project)(node) ?? node,
-                (child) => iterate_node(project)(context)(child),
-                context,
-            );
-
-    const try_transform_node =
-        (project: IProject) =>
-        (node: ts.Node): ts.Node | null => {
-            try {
-                return NodeTransformer.transform(project)(node);
-            } catch (exp) {
-                // ONLY ACCEPT TRANSFORMER-ERROR
-                if (!isTransformerError(exp)) throw exp;
-
-                // REPORT DIAGNOSTIC
-                const diagnostic = ts.createDiagnosticForNode(node, {
-                    key: exp.code,
-                    category: ts.DiagnosticCategory.Error,
-                    message: exp.message,
-                    code: `(${exp.code})` as any,
-                });
-                project.extras.addDiagnostic(diagnostic);
-                return null;
-            }
-        };
-}
-
-const isTransformerError = (error: any): error is TransformerError =>
-    typeof error === "object" &&
-    error !== null &&
-    error.constructor.name === "TransformerError" &&
-    typeof error.code === "string" &&
-    typeof error.message === "string";
+import ts from "typescript";
+
+import { IProject } from "./IProject";
+import { NodeTransformer } from "./NodeTransformer";
+import { TransformerError } from "./TransformerError";
+
+export namespace FileTransformer {
+  export const transform =
+    (project: Omit<IProject, "context">) =>
+    (context: ts.TransformationContext) =>
+    (file: ts.SourceFile): ts.SourceFile => {
+      if (file.isDeclarationFile) return file;
+      return ts.visitEachChild(
+        file,
+        (node) => iterate_node({ ...project, context })(context)(node),
+        context,
+      );
+    };
+
+  const iterate_node =
+    (project: IProject) =>
+    (context: ts.TransformationContext) =>
+    (node: ts.Node): ts.Node =>
+      ts.visitEachChild(
+        try_transform_node(project)(node) ?? node,
+        (child) => iterate_node(project)(context)(child),
+        context,
+      );
+
+  const try_transform_node =
+    (project: IProject) =>
+    (node: ts.Node): ts.Node | null => {
+      try {
+        return NodeTransformer.transform(project)(node);
+      } catch (exp) {
+        // ONLY ACCEPT TRANSFORMER-ERROR
+        if (!isTransformerError(exp)) throw exp;
+
+        // REPORT DIAGNOSTIC
+        const diagnostic = ts.createDiagnosticForNode(node, {
+          key: exp.code,
+          category: ts.DiagnosticCategory.Error,
+          message: exp.message,
+          code: `(${exp.code})` as any,
+        });
+        project.extras.addDiagnostic(diagnostic);
+        return null;
+      }
+    };
+}
+
+const isTransformerError = (error: any): error is TransformerError =>
+  typeof error === "object" &&
+  error !== null &&
+  error.constructor.name === "TransformerError" &&
+  typeof error.code === "string" &&
+  typeof error.message === "string";

package/src/transformers/IProject.ts

@@ -1,15 +1,15 @@
-import ts from "typescript";
-
-import { ITransformOptions } from "./ITransformOptions";
-
-export interface IProject {
-    program: ts.Program;
-    compilerOptions: ts.CompilerOptions;
-    checker: ts.TypeChecker;
-    printer: ts.Printer;
-    options: ITransformOptions;
-    context: ts.TransformationContext;
-    extras: {
-        addDiagnostic: (diag: ts.Diagnostic) => number;
-    };
-}
+import ts from "typescript";
+
+import { ITransformOptions } from "./ITransformOptions";
+
+export interface IProject {
+  program: ts.Program;
+  compilerOptions: ts.CompilerOptions;
+  checker: ts.TypeChecker;
+  printer: ts.Printer;
+  options: ITransformOptions;
+  context: ts.TransformationContext;
+  extras: {
+    addDiagnostic: (diag: ts.Diagnostic) => number;
+  };
+}

package/src/transformers/ITransformOptions.ts

@@ -1,62 +1,62 @@
-export interface ITransformOptions {
-    /**
-     * Whether to validate finite number or not.
-     *
-     * If configured true, number typed values would be validated by Number.isNaN().
-     *
-     * However, whatever you configure, it would be ignored when marshaling or parsing.
-     *
-     *   - when marshaling, always be true
-     *     - assertStringify()
-     *     - validateEncode()
-     *   - when parsing, always be false
-     *     - assertParse()
-     *     - isDecode()
-     *
-     * @default false
-     */
-    finite?: undefined | boolean;
-
-    /**
-     * Whether to validate finite number or not.
-     *
-     * If configured true, number typed values would be validated by Number.isFinite().
-     *
-     * However, whatever you configure, it can be ignored in below case.
-     *
-     *   - when `finite` option is true, this option would be ignored
-     *   - when marshaling, always be true
-     *     - assertStringify()
-     *     - validateEncode()
-     *   - when parsing, always be false
-     *     - assertParse()
-     *     - isDecode()
-     *
-     * @default false
-     */
-    numeric?: undefined | boolean;
-
-    /**
-     * Whether to validate functional type or not.
-     *
-     * However, whatever you configure, it becomes false when marshaling or parsing.
-     *
-     * @default false
-     */
-    functional?: undefined | boolean;
-
-    /**
-     * Whether to check undefined value or not.
-     *
-     * JavaScript can assign `undefined` value to a specific property and it is an
-     * issue when validating without allowing superfluous properties. Should undefined
-     * value assigned superfluous property be allowed or not?
-     *
-     * Note that, this option only works on {@link equals} function. Other function
-     * like {@link assertEquals} or {@link validateEquals} would ignore this option
-     * value and always allow the `undefined` value.
-     *
-     * @default true
-     */
-    undefined?: undefined | boolean;
-}
+export interface ITransformOptions {
+  /**
+   * Whether to validate finite number or not.
+   *
+   * If configured true, number typed values would be validated by Number.isNaN().
+   *
+   * However, whatever you configure, it would be ignored when marshaling or parsing.
+   *
+   *   - when marshaling, always be true
+   *     - assertStringify()
+   *     - validateEncode()
+   *   - when parsing, always be false
+   *     - assertParse()
+   *     - isDecode()
+   *
+   * @default false
+   */
+  finite?: undefined | boolean;
+
+  /**
+   * Whether to validate finite number or not.
+   *
+   * If configured true, number typed values would be validated by Number.isFinite().
+   *
+   * However, whatever you configure, it can be ignored in below case.
+   *
+   *   - when `finite` option is true, this option would be ignored
+   *   - when marshaling, always be true
+   *     - assertStringify()
+   *     - validateEncode()
+   *   - when parsing, always be false
+   *     - assertParse()
+   *     - isDecode()
+   *
+   * @default false
+   */
+  numeric?: undefined | boolean;
+
+  /**
+   * Whether to validate functional type or not.
+   *
+   * However, whatever you configure, it becomes false when marshaling or parsing.
+   *
+   * @default false
+   */
+  functional?: undefined | boolean;
+
+  /**
+   * Whether to check undefined value or not.
+   *
+   * JavaScript can assign `undefined` value to a specific property and it is an
+   * issue when validating without allowing superfluous properties. Should undefined
+   * value assigned superfluous property be allowed or not?
+   *
+   * Note that, this option only works on {@link equals} function. Other function
+   * like {@link assertEquals} or {@link validateEquals} would ignore this option
+   * value and always allow the `undefined` value.
+   *
+   * @default true
+   */
+  undefined?: undefined | boolean;
+}

package/src/transformers/ImportTransformer.ts

@@ -1,66 +1,66 @@
-import path from "path";
-import ts from "typescript";
-
-export namespace ImportTransformer {
-    export const transform =
-        (from: string) =>
-        (to: string) =>
-        (context: ts.TransformationContext) =>
-        (file: ts.SourceFile) =>
-            transform_file(from)(to)(context)(file);
-
-    const transform_file =
-        (top: string) =>
-        (to: string) =>
-        (context: ts.TransformationContext) =>
-        (file: ts.SourceFile): ts.SourceFile => {
-            if (file.isDeclarationFile) return file;
-
-            const from: string = get_directory_path(
-                path.resolve(file.getSourceFile().fileName),
-            );
-            to = from.replace(top, to);
-
-            return ts.visitEachChild(
-                file,
-                (node) => transform_node(top)(from)(to)(node),
-                context,
-            );
-        };
-
-    const transform_node =
-        (top: string) => (from: string) => (to: string) => (node: ts.Node) => {
-            if (
-                !ts.isImportDeclaration(node) ||
-                !ts.isStringLiteral(node.moduleSpecifier)
-            )
-                return node;
-
-            const text: string = node.moduleSpecifier.text;
-            if (text[0] !== ".") return node;
-
-            const location: string = path.resolve(from, text);
-            if (location.indexOf(top) === 0) return node;
-
-            const replaced: string = (() => {
-                const simple: string = path
-                    .relative(to, location)
-                    .split(path.sep)
-                    .join("/");
-                return simple[0] === "." ? simple : `./${simple}`;
-            })();
-
-            return ts.factory.createImportDeclaration(
-                undefined,
-                node.importClause,
-                ts.factory.createStringLiteral(replaced),
-                node.assertClause,
-            );
-        };
-}
-
-const get_directory_path = (file: string): string => {
-    const splitted: string[] = path.resolve(file).split(path.sep);
-    splitted.pop();
-    return path.resolve(splitted.join(path.sep));
-};
+import path from "path";
+import ts from "typescript";
+
+export namespace ImportTransformer {
+  export const transform =
+    (from: string) =>
+    (to: string) =>
+    (context: ts.TransformationContext) =>
+    (file: ts.SourceFile) =>
+      transform_file(from)(to)(context)(file);
+
+  const transform_file =
+    (top: string) =>
+    (to: string) =>
+    (context: ts.TransformationContext) =>
+    (file: ts.SourceFile): ts.SourceFile => {
+      if (file.isDeclarationFile) return file;
+
+      const from: string = get_directory_path(
+        path.resolve(file.getSourceFile().fileName),
+      );
+      to = from.replace(top, to);
+
+      return ts.visitEachChild(
+        file,
+        (node) => transform_node(top)(from)(to)(node),
+        context,
+      );
+    };
+
+  const transform_node =
+    (top: string) => (from: string) => (to: string) => (node: ts.Node) => {
+      if (
+        !ts.isImportDeclaration(node) ||
+        !ts.isStringLiteral(node.moduleSpecifier)
+      )
+        return node;
+
+      const text: string = node.moduleSpecifier.text;
+      if (text[0] !== ".") return node;
+
+      const location: string = path.resolve(from, text);
+      if (location.indexOf(top) === 0) return node;
+
+      const replaced: string = (() => {
+        const simple: string = path
+          .relative(to, location)
+          .split(path.sep)
+          .join("/");
+        return simple[0] === "." ? simple : `./${simple}`;
+      })();
+
+      return ts.factory.createImportDeclaration(
+        undefined,
+        node.importClause,
+        ts.factory.createStringLiteral(replaced),
+        node.assertClause,
+      );
+    };
+}
+
+const get_directory_path = (file: string): string => {
+  const splitted: string[] = path.resolve(file).split(path.sep);
+  splitted.pop();
+  return path.resolve(splitted.join(path.sep));
+};

package/src/transformers/NodeTransformer.ts

@@ -1,13 +1,13 @@
-import ts from "typescript";
-
-import { CallExpressionTransformer } from "./CallExpressionTransformer";
-import { IProject } from "./IProject";
-
-export namespace NodeTransformer {
-    export const transform =
-        (project: IProject) =>
-        (expression: ts.Node): ts.Node | null =>
-            ts.isCallExpression(expression) && expression.parent
-                ? CallExpressionTransformer.transform(project)(expression)
-                : expression;
-}
+import ts from "typescript";
+
+import { CallExpressionTransformer } from "./CallExpressionTransformer";
+import { IProject } from "./IProject";
+
+export namespace NodeTransformer {
+  export const transform =
+    (project: IProject) =>
+    (expression: ts.Node): ts.Node | null =>
+      ts.isCallExpression(expression) && expression.parent
+        ? CallExpressionTransformer.transform(project)(expression)
+        : expression;
+}

package/src/transformers/TransformerError.ts

@@ -1,55 +1,55 @@
-import { MetadataFactory } from "../factories/MetadataFactory";
-
-import { MetadataObject } from "../schemas/metadata/MetadataObject";
-
-import { Escaper } from "../utils/Escaper";
-
-export class TransformerError extends Error {
-    public readonly code: string;
-
-    public constructor(props: TransformerError.IProps) {
-        super(props.message);
-        this.code = props.code;
-
-        // INHERITANCE POLYFILL
-        const proto = new.target.prototype;
-        if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
-        else (this as any).__proto__ = proto;
-    }
-}
-export namespace TransformerError {
-    export interface IProps {
-        code: string;
-        message: string;
-    }
-
-    export const from =
-        (method: string) =>
-        (errors: MetadataFactory.IError[]): TransformerError => {
-            const body: string = errors
-                .map((e) => {
-                    const subject: string =
-                        e.explore.object === null
-                            ? ""
-                            : join(e.explore.object)(e.explore.property);
-                    const type: string = `${
-                        subject.length ? `${subject}: ` : ""
-                    }${e.name}`;
-                    return `- ${type}\n${e.messages
-                        .map((msg) => `  - ${msg}`)
-                        .join("\n")}`;
-                })
-                .join("\n\n");
-            return new TransformerError({
-                code: method,
-                message: `unsupported type detected\n\n${body}`,
-            });
-        };
-
-    const join = (object: MetadataObject) => (key: string | object | null) => {
-        if (key === null) return object.name;
-        else if (typeof key === "object") return `${object.name}[key]`;
-        else if (Escaper.variable(key)) return `${object.name}.${key}`;
-        return `${object.name}[${JSON.stringify(key)}]`;
-    };
-}
+import { MetadataFactory } from "../factories/MetadataFactory";
+
+import { MetadataObject } from "../schemas/metadata/MetadataObject";
+
+import { Escaper } from "../utils/Escaper";
+
+export class TransformerError extends Error {
+  public readonly code: string;
+
+  public constructor(props: TransformerError.IProps) {
+    super(props.message);
+    this.code = props.code;
+
+    // INHERITANCE POLYFILL
+    const proto = new.target.prototype;
+    if (Object.setPrototypeOf) Object.setPrototypeOf(this, proto);
+    else (this as any).__proto__ = proto;
+  }
+}
+export namespace TransformerError {
+  export interface IProps {
+    code: string;
+    message: string;
+  }
+
+  export const from =
+    (method: string) =>
+    (errors: MetadataFactory.IError[]): TransformerError => {
+      const body: string = errors
+        .map((e) => {
+          const subject: string =
+            e.explore.object === null
+              ? ""
+              : join(e.explore.object)(e.explore.property);
+          const type: string = `${subject.length ? `${subject}: ` : ""}${
+            e.name
+          }`;
+          return `- ${type}\n${e.messages
+            .map((msg) => `  - ${msg}`)
+            .join("\n")}`;
+        })
+        .join("\n\n");
+      return new TransformerError({
+        code: method,
+        message: `unsupported type detected\n\n${body}`,
+      });
+    };
+
+  const join = (object: MetadataObject) => (key: string | object | null) => {
+    if (key === null) return object.name;
+    else if (typeof key === "object") return `${object.name}[key]`;
+    else if (Escaper.variable(key)) return `${object.name}.${key}`;
+    return `${object.name}[${JSON.stringify(key)}]`;
+  };
+}

package/src/transformers/features/AssertTransformer.ts

@@ -1,19 +1,16 @@
-import { AssertProgrammer } from "../../programmers/AssertProgrammer";
-
-import { GenericTransformer } from "../internal/GenericTransformer";
-
-export namespace AssertTransformer {
-    export const transform = (props: { equals: boolean; guard: boolean }) =>
-        GenericTransformer.scalar(
-            props.equals
-                ? props.guard
-                    ? "assertGuardEquals"
-                    : "assertEquals"
-                : props.guard
-                ? "assertGuard"
-                : "assert",
-        )(
-            (project) => (modulo) =>
-                AssertProgrammer.write(project)(modulo)(props),
-        );
-}
+import { AssertProgrammer } from "../../programmers/AssertProgrammer";
+
+import { GenericTransformer } from "../internal/GenericTransformer";
+
+export namespace AssertTransformer {
+  export const transform = (props: { equals: boolean; guard: boolean }) =>
+    GenericTransformer.scalar(
+      props.equals
+        ? props.guard
+          ? "assertGuardEquals"
+          : "assertEquals"
+        : props.guard
+        ? "assertGuard"
+        : "assert",
+    )((project) => (modulo) => AssertProgrammer.write(project)(modulo)(props));
+}

package/src/transformers/features/CreateAssertTransformer.ts

@@ -1,19 +1,16 @@
-import { AssertProgrammer } from "../../programmers/AssertProgrammer";
-
-import { GenericTransformer } from "../internal/GenericTransformer";
-
-export namespace CreateAssertTransformer {
-    export const transform = (props: { equals: boolean; guard: boolean }) =>
-        GenericTransformer.factory(
-            props.equals
-                ? props.guard
-                    ? "createAssertGuardEquals"
-                    : "createAssertEquals"
-                : props.guard
-                ? "createAssertGuard"
-                : "createAssert",
-        )(
-            (project) => (modulo) =>
-                AssertProgrammer.write(project)(modulo)(props),
-        );
-}
+import { AssertProgrammer } from "../../programmers/AssertProgrammer";
+
+import { GenericTransformer } from "../internal/GenericTransformer";
+
+export namespace CreateAssertTransformer {
+  export const transform = (props: { equals: boolean; guard: boolean }) =>
+    GenericTransformer.factory(
+      props.equals
+        ? props.guard
+          ? "createAssertGuardEquals"
+          : "createAssertEquals"
+        : props.guard
+        ? "createAssertGuard"
+        : "createAssert",
+    )((project) => (modulo) => AssertProgrammer.write(project)(modulo)(props));
+}

package/src/transformers/features/CreateIsTransformer.ts

@@ -1,11 +1,10 @@
-import { IsProgrammer } from "../../programmers/IsProgrammer";
-
-import { GenericTransformer } from "../internal/GenericTransformer";
-
-export namespace CreateIsTransformer {
-    export const transform = (equals: boolean) =>
-        GenericTransformer.factory(equals ? "createEquals" : "createIs")(
-            (project) => (modulo) =>
-                IsProgrammer.write(project)(modulo)(equals),
-        );
-}
+import { IsProgrammer } from "../../programmers/IsProgrammer";
+
+import { GenericTransformer } from "../internal/GenericTransformer";
+
+export namespace CreateIsTransformer {
+  export const transform = (equals: boolean) =>
+    GenericTransformer.factory(equals ? "createEquals" : "createIs")(
+      (project) => (modulo) => IsProgrammer.write(project)(modulo)(equals),
+    );
+}