typia 4.2.3 → 4.3.0-dev.20230821

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 =>
-            ts.isCallExpression(expression)
-                ? 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 =>
+            ts.isCallExpression(expression)
+                ? CallExpressionTransformer.transform(project)(expression)
+                : expression;
+}

package/src/transformers/features/miscellaneous/ApplicationTransformer.ts

@@ -1,112 +1,112 @@
-import ts from "typescript";
-
-import { LiteralFactory } from "../../../factories/LiteralFactory";
-import { MetadataCollection } from "../../../factories/MetadataCollection";
-import { MetadataFactory } from "../../../factories/MetadataFactory";
-
-import { Metadata } from "../../../metadata/Metadata";
-import { IJsonApplication } from "../../../schemas/IJsonApplication";
-
-import { ApplicationProgrammer } from "../../../programmers/ApplicationProgrammer";
-
-import { IProject } from "../../IProject";
-
-export namespace ApplicationTransformer {
-    export const transform =
-        ({ checker }: IProject) =>
-        (expression: ts.CallExpression): ts.Expression => {
-            if (!expression.typeArguments?.length)
-                throw new Error(NO_GENERIC_ARGUMENT);
-
-            //----
-            // GET ARGUMENTS
-            //----
-            // VALIDATE TUPLE ARGUMENTS
-            const top: ts.Node = expression.typeArguments[0]!;
-            if (!ts.isTupleTypeNode(top)) return expression;
-            else if (top.elements.some((child) => !ts.isTypeNode(child)))
-                return expression;
-
-            // GET TYPES
-            const types: ts.Type[] = top.elements.map((child) =>
-                checker.getTypeFromTypeNode(child as ts.TypeNode),
-            );
-            if (types.some((t) => t.isTypeParameter()))
-                throw new Error(GENERIC_ARGUMENT);
-
-            // ADDITIONAL PARAMETERS
-            const purpose: "swagger" | "ajv" = get_parameter(
-                checker,
-                "Purpose",
-                expression.typeArguments[1],
-                (str) => str === "swagger" || str === "ajv",
-                () => "swagger",
-            );
-
-            //----
-            // GENERATORS
-            //----
-            // METADATA
-            const collection: MetadataCollection = new MetadataCollection({
-                replace: MetadataCollection.replace,
-            });
-            const metadatas: Array<Metadata> = types.map((type) =>
-                MetadataFactory.analyze(checker)({
-                    resolve: true,
-                    constant: true,
-                    absorb: false,
-                    validate: (meta) => {
-                        if (meta.atomics.find((str) => str === "bigint"))
-                            throw new Error(NO_BIGIT);
-                        else if (
-                            meta.arrays.some(
-                                (array) => array.value.isRequired() === false,
-                            )
-                        )
-                            throw new Error(NO_UNDEFINED_IN_ARRAY);
-                    },
-                })(collection)(type),
-            );
-
-            // APPLICATION
-            const app: IJsonApplication = ApplicationProgrammer.write({
-                purpose,
-            })(metadatas);
-
-            // RETURNS WITH LITERAL EXPRESSION
-            return LiteralFactory.generate(app);
-        };
-
-    const get_parameter = <T extends string>(
-        checker: ts.TypeChecker,
-        name: string,
-        node: ts.TypeNode | undefined,
-        predicator: (value: string) => boolean,
-        defaulter: () => T,
-    ): T => {
-        if (!node) return defaulter();
-
-        // CHECK LITERAL TYPE
-        const type: ts.Type = checker.getTypeFromTypeNode(node);
-        if (!type.isLiteral())
-            throw new Error(
-                `Error on typia.application(): generic argument "${name}" must be constant.`,
-            );
-
-        // GET VALUE AND VALIDATE IT
-        const value = type.value;
-        if (typeof value !== "string" || predicator(value) === false)
-            throw new Error(
-                `Error on typia.application(): invalid value on generic argument "${name}".`,
-            );
-        return value as T;
-    };
-}
-
-const NO_GENERIC_ARGUMENT =
-    "Error on typia.application(): no generic argument.";
-const GENERIC_ARGUMENT =
-    "Error on typia.application(): non-specified generic argument(s).";
-const NO_BIGIT = "Error on typia.application(): does not allow bigint type.";
-const NO_UNDEFINED_IN_ARRAY =
-    "Error on typia.application(): does not allow undefined type in array.";
+import ts from "typescript";
+
+import { LiteralFactory } from "../../../factories/LiteralFactory";
+import { MetadataCollection } from "../../../factories/MetadataCollection";
+import { MetadataFactory } from "../../../factories/MetadataFactory";
+
+import { Metadata } from "../../../metadata/Metadata";
+import { IJsonApplication } from "../../../schemas/IJsonApplication";
+
+import { ApplicationProgrammer } from "../../../programmers/ApplicationProgrammer";
+
+import { IProject } from "../../IProject";
+
+export namespace ApplicationTransformer {
+    export const transform =
+        ({ checker }: IProject) =>
+        (expression: ts.CallExpression): ts.Expression => {
+            if (!expression.typeArguments?.length)
+                throw new Error(NO_GENERIC_ARGUMENT);
+
+            //----
+            // GET ARGUMENTS
+            //----
+            // VALIDATE TUPLE ARGUMENTS
+            const top: ts.Node = expression.typeArguments[0]!;
+            if (!ts.isTupleTypeNode(top)) return expression;
+            else if (top.elements.some((child) => !ts.isTypeNode(child)))
+                return expression;
+
+            // GET TYPES
+            const types: ts.Type[] = top.elements.map((child) =>
+                checker.getTypeFromTypeNode(child as ts.TypeNode),
+            );
+            if (types.some((t) => t.isTypeParameter()))
+                throw new Error(GENERIC_ARGUMENT);
+
+            // ADDITIONAL PARAMETERS
+            const purpose: "swagger" | "ajv" = get_parameter(
+                checker,
+                "Purpose",
+                expression.typeArguments[1],
+                (str) => str === "swagger" || str === "ajv",
+                () => "swagger",
+            );
+
+            //----
+            // GENERATORS
+            //----
+            // METADATA
+            const collection: MetadataCollection = new MetadataCollection({
+                replace: MetadataCollection.replace,
+            });
+            const metadatas: Array<Metadata> = types.map((type) =>
+                MetadataFactory.analyze(checker)({
+                    resolve: true,
+                    constant: true,
+                    absorb: false,
+                    validate: (meta) => {
+                        if (meta.atomics.find((str) => str === "bigint"))
+                            throw new Error(NO_BIGIT);
+                        else if (
+                            meta.arrays.some(
+                                (array) => array.value.isRequired() === false,
+                            )
+                        )
+                            throw new Error(NO_UNDEFINED_IN_ARRAY);
+                    },
+                })(collection)(type),
+            );
+
+            // APPLICATION
+            const app: IJsonApplication = ApplicationProgrammer.write({
+                purpose,
+            })(metadatas);
+
+            // RETURNS WITH LITERAL EXPRESSION
+            return LiteralFactory.generate(app);
+        };
+
+    const get_parameter = <T extends string>(
+        checker: ts.TypeChecker,
+        name: string,
+        node: ts.TypeNode | undefined,
+        predicator: (value: string) => boolean,
+        defaulter: () => T,
+    ): T => {
+        if (!node) return defaulter();
+
+        // CHECK LITERAL TYPE
+        const type: ts.Type = checker.getTypeFromTypeNode(node);
+        if (!type.isLiteral())
+            throw new Error(
+                `Error on typia.application(): generic argument "${name}" must be constant.`,
+            );
+
+        // GET VALUE AND VALIDATE IT
+        const value = type.value;
+        if (typeof value !== "string" || predicator(value) === false)
+            throw new Error(
+                `Error on typia.application(): invalid value on generic argument "${name}".`,
+            );
+        return value as T;
+    };
+}
+
+const NO_GENERIC_ARGUMENT =
+    "Error on typia.application(): no generic argument.";
+const GENERIC_ARGUMENT =
+    "Error on typia.application(): non-specified generic argument(s).";
+const NO_BIGIT = "Error on typia.application(): does not allow bigint type.";
+const NO_UNDEFINED_IN_ARRAY =
+    "Error on typia.application(): does not allow undefined type in array.";

package/src/transformers/features/miscellaneous/AssertCloneTransformer.ts

@@ -1,9 +1,9 @@
-import { AssertCloneProgrammer } from "../../../programmers/AssertCloneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace AssertCloneTransformer {
-    export const transform = GenericTransformer.scalar("assertClone")(
-        (project) => (modulo) => AssertCloneProgrammer.write(project)(modulo),
-    );
-}
+import { AssertCloneProgrammer } from "../../../programmers/AssertCloneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace AssertCloneTransformer {
+    export const transform = GenericTransformer.scalar("assertClone")(
+        (project) => (modulo) => AssertCloneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/AssertPruneTransformer.ts

@@ -1,9 +1,9 @@
-import { AssertPruneProgrammer } from "../../../programmers/AssertPruneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace AssertPruneTransformer {
-    export const transform = GenericTransformer.scalar("assertPrune")(
-        (project) => (modulo) => AssertPruneProgrammer.write(project)(modulo),
-    );
-}
+import { AssertPruneProgrammer } from "../../../programmers/AssertPruneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace AssertPruneTransformer {
+    export const transform = GenericTransformer.scalar("assertPrune")(
+        (project) => (modulo) => AssertPruneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CloneTransformer.ts

@@ -1,9 +1,9 @@
-import { CloneProgrammer } from "../../../programmers/CloneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CloneTransformer {
-    export const transform = GenericTransformer.scalar("clone")(
-        (project) => (modulo) => CloneProgrammer.write(project)(modulo),
-    );
-}
+import { CloneProgrammer } from "../../../programmers/CloneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CloneTransformer {
+    export const transform = GenericTransformer.scalar("clone")(
+        (project) => (modulo) => CloneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateAssertCloneTransformer.ts

@@ -1,9 +1,9 @@
-import { AssertCloneProgrammer } from "../../../programmers/AssertCloneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreateAssertCloneTransformer {
-    export const transform = GenericTransformer.factory("createAssertClone")(
-        (project) => (modulo) => AssertCloneProgrammer.write(project)(modulo),
-    );
-}
+import { AssertCloneProgrammer } from "../../../programmers/AssertCloneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreateAssertCloneTransformer {
+    export const transform = GenericTransformer.factory("createAssertClone")(
+        (project) => (modulo) => AssertCloneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateAssertPruneTransformer.ts

@@ -1,9 +1,9 @@
-import { AssertPruneProgrammer } from "../../../programmers/AssertPruneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreateAssertPruneTransformer {
-    export const transform = GenericTransformer.factory("createAssertPrune")(
-        (project) => (modulo) => AssertPruneProgrammer.write(project)(modulo),
-    );
-}
+import { AssertPruneProgrammer } from "../../../programmers/AssertPruneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreateAssertPruneTransformer {
+    export const transform = GenericTransformer.factory("createAssertPrune")(
+        (project) => (modulo) => AssertPruneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateCloneTransformer.ts

@@ -1,9 +1,9 @@
-import { CloneProgrammer } from "../../../programmers/CloneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreateCloneTransformer {
-    export const transform = GenericTransformer.factory("createClone")(
-        (project) => (modulo) => CloneProgrammer.write(project)(modulo),
-    );
-}
+import { CloneProgrammer } from "../../../programmers/CloneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreateCloneTransformer {
+    export const transform = GenericTransformer.factory("createClone")(
+        (project) => (modulo) => CloneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateIsCloneTransformer.ts

@@ -1,9 +1,9 @@
-import { IsCloneProgrammer } from "../../../programmers/IsCloneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreateIsCloneTransformer {
-    export const transform = GenericTransformer.factory("createIsClone")(
-        (project) => (modulo) => IsCloneProgrammer.write(project)(modulo),
-    );
-}
+import { IsCloneProgrammer } from "../../../programmers/IsCloneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreateIsCloneTransformer {
+    export const transform = GenericTransformer.factory("createIsClone")(
+        (project) => (modulo) => IsCloneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateIsPruneTransformer.ts

@@ -1,9 +1,9 @@
-import { IsPruneProgrammer } from "../../../programmers/IsPruneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreateIsPruneTransformer {
-    export const transform = GenericTransformer.factory("createIsPrune")(
-        (project) => (modulo) => IsPruneProgrammer.write(project)(modulo),
-    );
-}
+import { IsPruneProgrammer } from "../../../programmers/IsPruneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreateIsPruneTransformer {
+    export const transform = GenericTransformer.factory("createIsPrune")(
+        (project) => (modulo) => IsPruneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreatePruneTransformer.ts

@@ -1,9 +1,9 @@
-import { PruneProgrammer } from "../../../programmers/PruneProgrammer";
-
-import { GenericTransformer } from "../../internal/GenericTransformer";
-
-export namespace CreatePruneTransformer {
-    export const transform = GenericTransformer.factory("createPrune")(
-        (project) => (modulo) => PruneProgrammer.write(project)(modulo),
-    );
-}
+import { PruneProgrammer } from "../../../programmers/PruneProgrammer";
+
+import { GenericTransformer } from "../../internal/GenericTransformer";
+
+export namespace CreatePruneTransformer {
+    export const transform = GenericTransformer.factory("createPrune")(
+        (project) => (modulo) => PruneProgrammer.write(project)(modulo),
+    );
+}

package/src/transformers/features/miscellaneous/CreateRandomTransformer.ts

@@ -1,39 +1,39 @@
-import ts from "typescript";
-
-import { RandomProgrammer } from "../../../programmers/RandomProgrammer";
-
-import { IProject } from "../../IProject";
-
-export namespace CreateRandomTransformer {
-    export const transform =
-        (project: IProject) =>
-        (modulo: ts.LeftHandSideExpression) =>
-        (expression: ts.CallExpression): ts.Expression => {
-            // CHECK GENERIC ARGUMENT EXISTENCE
-            if (!expression.typeArguments?.[0]) throw new Error(NOT_SPECIFIED);
-
-            // GET TYPE INFO
-            const node: ts.TypeNode = expression.typeArguments[0];
-            const type: ts.Type = project.checker.getTypeFromTypeNode(node);
-
-            if (type.isTypeParameter()) throw new Error(NO_GENERIC_ARGUMENT);
-
-            // DO TRANSFORM
-            return RandomProgrammer.write({
-                ...project,
-                options: {
-                    ...project.options,
-                    functional: false,
-                    numeric: false,
-                },
-            })(modulo)(expression.arguments?.[0])(
-                type,
-                node.getFullText().trim(),
-            );
-        };
-}
-
-const NOT_SPECIFIED =
-    "Error on typia.createRandom(): generic argument is not specified.";
-const NO_GENERIC_ARGUMENT =
-    "Error on typia.createRandom(): non-specified generic argument.";
+import ts from "typescript";
+
+import { RandomProgrammer } from "../../../programmers/RandomProgrammer";
+
+import { IProject } from "../../IProject";
+
+export namespace CreateRandomTransformer {
+    export const transform =
+        (project: IProject) =>
+        (modulo: ts.LeftHandSideExpression) =>
+        (expression: ts.CallExpression): ts.Expression => {
+            // CHECK GENERIC ARGUMENT EXISTENCE
+            if (!expression.typeArguments?.[0]) throw new Error(NOT_SPECIFIED);
+
+            // GET TYPE INFO
+            const node: ts.TypeNode = expression.typeArguments[0];
+            const type: ts.Type = project.checker.getTypeFromTypeNode(node);
+
+            if (type.isTypeParameter()) throw new Error(NO_GENERIC_ARGUMENT);
+
+            // DO TRANSFORM
+            return RandomProgrammer.write({
+                ...project,
+                options: {
+                    ...project.options,
+                    functional: false,
+                    numeric: false,
+                },
+            })(modulo)(expression.arguments?.[0])(
+                type,
+                node.getFullText().trim(),
+            );
+        };
+}
+
+const NOT_SPECIFIED =
+    "Error on typia.createRandom(): generic argument is not specified.";
+const NO_GENERIC_ARGUMENT =
+    "Error on typia.createRandom(): non-specified generic argument.";