typia 3.6.2 → 3.6.4

package/src/executable/setup/PluginConfigurator.ts

@@ -1,99 +1,99 @@
-import type Comment from "comment-json";
-import fs from "fs";
-import path from "path";
-
-import { TypiaSetupWizard } from "../TypiaSetupWizard";
-import { FileRetriever } from "./FileRetriever";
-import { PackageManager } from "./PackageManager";
-
-export namespace PluginConfigurator {
-    export async function configure(
-        pack: PackageManager,
-        args: TypiaSetupWizard.IArguments,
-    ): Promise<void> {
-        // INSTALL COMMENT-JSON
-        const installed: boolean = pack.install({
-            dev: true,
-            modulo: "comment-json",
-            version: "4.2.3",
-            silent: true,
-        });
-
-        // DO CONFIGURE
-        const error: Error | null = await (async () => {
-            try {
-                await _Configure(pack, args);
-                return null;
-            } catch (exp) {
-                return exp as Error;
-            }
-        })();
-
-        // REMOVE IT
-        if (installed)
-            pack.erase({
-                modulo: "comment-json",
-                silent: true,
-            });
-        if (error !== null) throw error;
-    }
-
-    async function _Configure(
-        pack: PackageManager,
-        args: TypiaSetupWizard.IArguments,
-    ): Promise<void> {
-        // GET COMPILER-OPTIONS
-        const Comment: typeof import("comment-json") =
-            await FileRetriever.require(
-                path.join("node_modules", "comment-json"),
-            )(pack.directory);
-
-        const config: Comment.CommentObject = Comment.parse(
-            await fs.promises.readFile(args.project!, "utf8"),
-        ) as Comment.CommentObject;
-        const compilerOptions = config.compilerOptions as
-            | Comment.CommentObject
-            | undefined;
-        if (compilerOptions === undefined)
-            throw new Error(
-                `${args.project} file does not have "compilerOptions" property.`,
-            );
-
-        // PREPARE PLUGINS
-        const plugins: Comment.CommentArray<Comment.CommentObject> = (() => {
-            const plugins = compilerOptions.plugins as
-                | Comment.CommentArray<Comment.CommentObject>
-                | undefined;
-            if (plugins === undefined)
-                return (compilerOptions.plugins = [] as any);
-            else if (!Array.isArray(plugins))
-                throw new Error(
-                    `"plugins" property of ${args.project} must be array type.`,
-                );
-            return plugins;
-        })();
-
-        const strict: boolean = compilerOptions.strict === true;
-        const oldbie: Comment.CommentObject | undefined = plugins.find(
-            (p) =>
-                typeof p === "object" &&
-                p !== null &&
-                p.transform === "typia/lib/transform",
-        );
-        if (strict === true && oldbie !== undefined) return;
-
-        // DO CONFIGURE
-        compilerOptions.strict = true;
-        if (oldbie === undefined)
-            plugins.push(
-                Comment.parse(`
-                        {
-                            "transform": "typia/lib/transform"
-                        }`) as Comment.CommentObject,
-            );
-        await fs.promises.writeFile(
-            args.project!,
-            Comment.stringify(config, null, 2),
-        );
-    }
-}
+import type Comment from "comment-json";
+import fs from "fs";
+import path from "path";
+
+import { TypiaSetupWizard } from "../TypiaSetupWizard";
+import { FileRetriever } from "./FileRetriever";
+import { PackageManager } from "./PackageManager";
+
+export namespace PluginConfigurator {
+    export async function configure(
+        pack: PackageManager,
+        args: TypiaSetupWizard.IArguments,
+    ): Promise<void> {
+        // INSTALL COMMENT-JSON
+        const installed: boolean = pack.install({
+            dev: true,
+            modulo: "comment-json",
+            version: "4.2.3",
+            silent: true,
+        });
+
+        // DO CONFIGURE
+        const error: Error | null = await (async () => {
+            try {
+                await _Configure(pack, args);
+                return null;
+            } catch (exp) {
+                return exp as Error;
+            }
+        })();
+
+        // REMOVE IT
+        if (installed)
+            pack.erase({
+                modulo: "comment-json",
+                silent: true,
+            });
+        if (error !== null) throw error;
+    }
+
+    async function _Configure(
+        pack: PackageManager,
+        args: TypiaSetupWizard.IArguments,
+    ): Promise<void> {
+        // GET COMPILER-OPTIONS
+        const Comment: typeof import("comment-json") =
+            await FileRetriever.require(
+                path.join("node_modules", "comment-json"),
+            )(pack.directory);
+
+        const config: Comment.CommentObject = Comment.parse(
+            await fs.promises.readFile(args.project!, "utf8"),
+        ) as Comment.CommentObject;
+        const compilerOptions = config.compilerOptions as
+            | Comment.CommentObject
+            | undefined;
+        if (compilerOptions === undefined)
+            throw new Error(
+                `${args.project} file does not have "compilerOptions" property.`,
+            );
+
+        // PREPARE PLUGINS
+        const plugins: Comment.CommentArray<Comment.CommentObject> = (() => {
+            const plugins = compilerOptions.plugins as
+                | Comment.CommentArray<Comment.CommentObject>
+                | undefined;
+            if (plugins === undefined)
+                return (compilerOptions.plugins = [] as any);
+            else if (!Array.isArray(plugins))
+                throw new Error(
+                    `"plugins" property of ${args.project} must be array type.`,
+                );
+            return plugins;
+        })();
+
+        const strict: boolean = compilerOptions.strict === true;
+        const oldbie: Comment.CommentObject | undefined = plugins.find(
+            (p) =>
+                typeof p === "object" &&
+                p !== null &&
+                p.transform === "typia/lib/transform",
+        );
+        if (strict === true && oldbie !== undefined) return;
+
+        // DO CONFIGURE
+        compilerOptions.strict = true;
+        if (oldbie === undefined)
+            plugins.push(
+                Comment.parse(`
+                        {
+                            "transform": "typia/lib/transform"
+                        }`) as Comment.CommentObject,
+            );
+        await fs.promises.writeFile(
+            args.project!,
+            Comment.stringify(config, null, 2),
+        );
+    }
+}

package/src/factories/internal/metadata/emplace_metadata_object.ts

@@ -1,140 +1,142 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../metadata/Metadata";
-import { MetadataObject } from "../../../metadata/MetadataObject";
-import { MetadataProperty } from "../../../metadata/MetadataProperty";
-
-import { Writable } from "../../../typings/Writable";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { CommentFactory } from "../../CommentFactory";
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-import { MetadataTagFactory } from "../../MetadataTagFactory";
-import { MetadataHelper } from "./MetadataHelper";
-import { explore_metadata } from "./explore_metadata";
-
-export const emplace_metadata_object =
-    (checker: ts.TypeChecker) =>
-    (options: MetadataFactory.IOptions) =>
-    (collection: MetadataCollection) =>
-    (parent: ts.Type, nullable: boolean): MetadataObject => {
-        // EMPLACE OBJECT
-        const [obj, newbie] = collection.emplace(checker, parent);
-        ArrayUtil.add(obj.nullables, nullable, (elem) => elem === nullable);
-        if (newbie === false) return obj;
-
-        // PREPARE ASSETS
-        const isClass: boolean = parent.isClass();
-        const pred: (node: ts.Declaration) => boolean = isClass
-            ? (node) => {
-                  const kind: ts.SyntaxKind | undefined = node
-                      .getChildren()[0]
-                      ?.getChildren()[0]?.kind;
-                  return (
-                      kind !== ts.SyntaxKind.PrivateKeyword &&
-                      kind !== ts.SyntaxKind.ProtectedKeyword &&
-                      (ts.isParameter(node) || ts.isPropertyDeclaration(node))
-                  );
-              }
-            : (node) =>
-                  ts.isPropertyDeclaration(node) ||
-                  ts.isPropertyAssignment(node) ||
-                  ts.isPropertySignature(node) ||
-                  ts.isTypeLiteralNode(node);
-
-        const insert =
-            (key: Metadata) =>
-            (value: Metadata) =>
-            (identifier: () => string) =>
-            (
-                symbol: ts.Symbol | undefined,
-                filter?: (doc: ts.JSDocTagInfo) => boolean,
-            ): MetadataProperty => {
-                // COMMENTS AND TAGS
-                const description: string | undefined =
-                    CommentFactory.generate(
-                        symbol?.getDocumentationComment(checker) || [],
-                    ) || undefined;
-                const jsDocTags: ts.JSDocTagInfo[] = (
-                    symbol?.getJsDocTags() || []
-                ).filter(filter || (() => true));
-
-                // THE PROPERTY
-                const property = MetadataProperty.create({
-                    key,
-                    value,
-                    description,
-                    jsDocTags,
-                    tags: MetadataTagFactory.generate(
-                        () => identifier(),
-                        value,
-                        jsDocTags,
-                    ),
-                });
-                obj.properties.push(property);
-                return property;
-            };
-
-        //----
-        // REGULAR PROPERTIES
-        //----
-        for (const prop of parent.getApparentProperties()) {
-            // CHECK INTERNAL TAG
-            if (
-                (prop.getJsDocTags(checker) || []).find(
-                    (tag) => tag.name === "internal",
-                ) !== undefined
-            )
-                continue;
-
-            // CHECK NODE IS A FORMAL PROPERTY
-            const [node, type] = (() => {
-                const node = (prop.getDeclarations() || [])[0] as
-                    | ts.PropertyDeclaration
-                    | undefined;
-                const type: ts.Type | undefined = node
-                    ? checker.getTypeOfSymbolAtLocation(prop, node)
-                    : "getTypeOfPropertyOfType" in checker
-                    ? (checker as any).getTypeOfPropertyOfType(
-                          parent,
-                          prop.name,
-                      )
-                    : undefined;
-                return [node, type];
-            })();
-            if ((node && pred(node) === false) || type === undefined) continue;
-
-            // GET EXACT TYPE
-            const key: Metadata = MetadataHelper.literal_to_metadata(prop.name);
-            const value: Metadata = explore_metadata(checker)(options)(
-                collection,
-            )(type, false);
-
-            // INSERT WITH REQUIRED CONFIGURATION
-            if (node?.questionToken) Writable(value).required = false;
-            insert(key)(value)(() => `${obj.name}.${prop.name}`)(prop);
-        }
-
-        //----
-        // DYNAMIC PROPERTIES
-        //----
-        for (const index of checker.getIndexInfosOfType(parent)) {
-            // GET EXACT TYPE
-            const analyzer = (type: ts.Type) =>
-                explore_metadata(checker)(options)(collection)(type, false);
-            const key: Metadata = analyzer(index.keyType);
-            const value: Metadata = analyzer(index.type);
-
-            // INSERT WITH REQUIRED CONFIGURATION
-            insert(key)(value)(() => `${obj.name}[${key.getName()}]`)(
-                index.declaration?.parent
-                    ? checker.getSymbolAtLocation(index.declaration.parent)
-                    : undefined,
-                (doc) => doc.name !== "default",
-            );
-        }
-
-        return obj;
-    };
+import ts from "typescript";
+
+import { Metadata } from "../../../metadata/Metadata";
+import { MetadataObject } from "../../../metadata/MetadataObject";
+import { MetadataProperty } from "../../../metadata/MetadataProperty";
+
+import { Writable } from "../../../typings/Writable";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { CommentFactory } from "../../CommentFactory";
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+import { MetadataTagFactory } from "../../MetadataTagFactory";
+import { MetadataHelper } from "./MetadataHelper";
+import { explore_metadata } from "./explore_metadata";
+
+export const emplace_metadata_object =
+    (checker: ts.TypeChecker) =>
+    (options: MetadataFactory.IOptions) =>
+    (collection: MetadataCollection) =>
+    (parent: ts.Type, nullable: boolean): MetadataObject => {
+        // EMPLACE OBJECT
+        const [obj, newbie] = collection.emplace(checker, parent);
+        ArrayUtil.add(obj.nullables, nullable, (elem) => elem === nullable);
+        if (newbie === false) return obj;
+
+        // PREPARE ASSETS
+        const isClass: boolean = parent.isClass();
+        const pred: (node: ts.Declaration) => boolean = isClass
+            ? (node) => {
+                  const kind: ts.SyntaxKind | undefined = node
+                      .getChildren()[0]
+                      ?.getChildren()[0]?.kind;
+                  return (
+                      kind !== ts.SyntaxKind.PrivateKeyword &&
+                      kind !== ts.SyntaxKind.ProtectedKeyword &&
+                      (ts.isParameter(node) || isProperty(node))
+                  );
+              }
+            : (node) => isProperty(node);
+
+        const insert =
+            (key: Metadata) =>
+            (value: Metadata) =>
+            (identifier: () => string) =>
+            (
+                symbol: ts.Symbol | undefined,
+                filter?: (doc: ts.JSDocTagInfo) => boolean,
+            ): MetadataProperty => {
+                // COMMENTS AND TAGS
+                const description: string | undefined =
+                    CommentFactory.generate(
+                        symbol?.getDocumentationComment(checker) || [],
+                    ) || undefined;
+                const jsDocTags: ts.JSDocTagInfo[] = (
+                    symbol?.getJsDocTags() || []
+                ).filter(filter || (() => true));
+
+                // THE PROPERTY
+                const property = MetadataProperty.create({
+                    key,
+                    value,
+                    description,
+                    jsDocTags,
+                    tags: MetadataTagFactory.generate(
+                        () => identifier(),
+                        value,
+                        jsDocTags,
+                    ),
+                });
+                obj.properties.push(property);
+                return property;
+            };
+
+        //----
+        // REGULAR PROPERTIES
+        //----
+        for (const prop of parent.getApparentProperties()) {
+            // CHECK INTERNAL TAG
+            if (
+                (prop.getJsDocTags(checker) || []).find(
+                    (tag) => tag.name === "internal",
+                ) !== undefined
+            )
+                continue;
+
+            // CHECK NODE IS A FORMAL PROPERTY
+            const [node, type] = (() => {
+                const node = (prop.getDeclarations() || [])[0] as
+                    | ts.PropertyDeclaration
+                    | undefined;
+                const type: ts.Type | undefined = node
+                    ? checker.getTypeOfSymbolAtLocation(prop, node)
+                    : "getTypeOfPropertyOfType" in checker
+                    ? (checker as any).getTypeOfPropertyOfType(
+                          parent,
+                          prop.name,
+                      )
+                    : undefined;
+                return [node, type];
+            })();
+            if ((node && pred(node) === false) || type === undefined) continue;
+
+            // GET EXACT TYPE
+            const key: Metadata = MetadataHelper.literal_to_metadata(prop.name);
+            const value: Metadata = explore_metadata(checker)(options)(
+                collection,
+            )(type, false);
+
+            // INSERT WITH REQUIRED CONFIGURATION
+            if (node?.questionToken) Writable(value).required = false;
+            insert(key)(value)(() => `${obj.name}.${prop.name}`)(prop);
+        }
+
+        //----
+        // DYNAMIC PROPERTIES
+        //----
+        for (const index of checker.getIndexInfosOfType(parent)) {
+            // GET EXACT TYPE
+            const analyzer = (type: ts.Type) =>
+                explore_metadata(checker)(options)(collection)(type, false);
+            const key: Metadata = analyzer(index.keyType);
+            const value: Metadata = analyzer(index.type);
+
+            // INSERT WITH REQUIRED CONFIGURATION
+            insert(key)(value)(() => `${obj.name}[${key.getName()}]`)(
+                index.declaration?.parent
+                    ? checker.getSymbolAtLocation(index.declaration.parent)
+                    : undefined,
+                (doc) => doc.name !== "default",
+            );
+        }
+
+        return obj;
+    };
+
+const isProperty = (node: ts.Declaration) =>
+    ts.isPropertyDeclaration(node) ||
+    ts.isPropertyAssignment(node) ||
+    ts.isPropertySignature(node) ||
+    ts.isTypeLiteralNode(node);

package/src/functional/$is_uuid.ts

@@ -1,5 +1,4 @@
 export function $is_uuid(str: string): boolean {
     return REGEX.test(str);
 }
-const REGEX =
-    /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+const REGEX = /^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$/i;