typia 4.0.0-dev.20230520 → 4.0.0-dev.20230527

package/src/utils/TsSymbolUtil.ts

@@ -1,153 +1,153 @@
-import { JSDocTagInfo } from "typescript";
-import type ts from "typescript/lib/tsclibrary";
-
-import { TsNodeUtil } from "./TsNodeUtil";
-
-export namespace TsSymbolUtil {
-    export const comments =
-        (tsc: typeof ts) =>
-        (symbol: ts.Symbol): string | undefined => {
-            const node = symbol.declarations?.[0];
-            if (!node) return undefined;
-
-            const range: ts.TextRange = tsc.getCommentRange(node);
-            const text: string = TsNodeUtil.getSourceFile(tsc)(
-                node,
-            ).text.substring(range.pos, range.end);
-            const output: string = transform(text).join("\n");
-            return output.length ? output : undefined;
-        };
-
-    export const getCommentTags =
-        (tsc: typeof ts) =>
-        (symbol: ts.Symbol): JSDocTagInfo[] | undefined => {
-            const node = symbol.declarations?.[0];
-            if (!node) return undefined;
-
-            const tagList: ts.JSDocTag[] = tsc
-                .getJSDocTags(node)
-                .map(emendTag(tsc));
-            // if (
-            //     tagList.some(
-            //         (tag) => tag.tagName.escapedText.toString() === "type",
-            //     )
-            // ) {
-            //     const entire = tsc.getJSDocCommentsAndTags(node);
-            //     const texts = entire.map((e) =>
-            //         tsc.isJSDoc(e) ? jsDocToText(e) : jsTagToText(e),
-            //     );
-            //     console.log(texts);
-            // }
-
-            return tagList.map((tag) => ({
-                name: tag.tagName.escapedText.toString(),
-                text:
-                    tag.comment === undefined
-                        ? undefined
-                        : typeof tag.comment === "string"
-                        ? [{ text: tag.comment, kind: "text" }]
-                        : tag.comment.map((text) => ({
-                              text: text.text,
-                              kind:
-                                  text.kind === tsc.SyntaxKind.JSDocText
-                                      ? "text"
-                                      : text.kind === tsc.SyntaxKind.JSDocLink
-                                      ? "link"
-                                      : text.kind ===
-                                        tsc.SyntaxKind.JSDocLinkCode
-                                      ? "link-code"
-                                      : "link-plain",
-                          })),
-            }));
-        };
-
-    const emendTag =
-        (tsc: typeof ts) =>
-        (tag: ts.JSDocTag): ts.JSDocTag => {
-            if (tag.comment !== undefined) return tag;
-
-            const tagName: string = tag.tagName.escapedText.toString();
-            const comment: string = TsNodeUtil.getSourceFile(tsc)(tag)
-                .text.substring(tag.pos, tag.end)
-                .replace(`@${tagName}`, "")
-                .split("\n")
-                .map((str) => trim(str))
-                .filter(
-                    (str, i, array) =>
-                        (i !== 0 && i !== array.length - 1) || !!str.length,
-                )
-                .join("\n");
-            return comment.length
-                ? {
-                      ...tag,
-                      comment,
-                  }
-                : tag;
-        };
-
-    const transform = (text: string): string[] => {
-        const elements: string[] = text.split("\n");
-        const first: number = lastIndexOf(elements)((elem) =>
-            elem.trim().startsWith("/**"),
-        );
-        const last: number = lastIndexOf(elements)((elem) =>
-            elem.trim().endsWith("*/"),
-        );
-
-        const cut: string[] = elements.slice(first, last + 1);
-        return cut
-            .map((elem, i) => {
-                if (i === 0) elem = elem.substring(elem.lastIndexOf("/**") + 3);
-                if (i === cut.length - 1)
-                    elem = elem.substring(0, elem.lastIndexOf("*/"));
-                return trim(elem);
-            })
-            .filter(
-                (str, i, array) =>
-                    (i !== 0 && i !== array.length - 1) || !!str.length,
-            );
-    };
-
-    const lastIndexOf =
-        <T>(array: T[]) =>
-        (pred: (elem: T) => boolean) => {
-            for (let i = array.length - 1; i >= 0; i--)
-                if (pred(array[i]!)) return i;
-            return -1;
-        };
-
-    const trim = (str: string): string => {
-        const vulnerable = (ch: string) =>
-            ch === " " ||
-            ch === "\n" ||
-            ch == "\r" ||
-            ch === "\t" ||
-            ch === "*";
-        let start: number;
-        let end: number;
-        for (start = 0; start < str.length; ++start)
-            if (!vulnerable(str.charAt(start))) break;
-        for (end = str.length - 1; end >= 0; --end)
-            if (!vulnerable(str.charAt(end))) break;
-        return start > end ? "" : str.substring(start, end + 1).trim();
-    };
-}
-
-// const jsDocToText = (doc: ts.JSDoc): string =>
-//     [jsCommentToText(doc.comment), ...(doc.tags ?? []).map(jsTagToText)]
-//         .filter((str) => !!str.length)
-//         .join(" ");
-
-// const jsTagToText = (doc: ts.JSDocTag): string =>
-//     ["@" + doc.tagName.escapedText.toString(), jsCommentToText(doc.comment)]
-//         .filter((str) => !!str.length)
-//         .join(" ");
-
-// const jsCommentToText = (
-//     comment: string | ts.NodeArray<ts.JSDocComment> | undefined,
-// ): string =>
-//     comment === undefined
-//         ? ""
-//         : typeof comment === "string"
-//         ? comment
-//         : comment.map((c) => c.text).join("");
+import { JSDocTagInfo } from "typescript";
+import type ts from "typescript/lib/tsclibrary";
+
+import { TsNodeUtil } from "./TsNodeUtil";
+
+export namespace TsSymbolUtil {
+    export const comments =
+        (tsc: typeof ts) =>
+        (symbol: ts.Symbol): string | undefined => {
+            const node = symbol.declarations?.[0];
+            if (!node) return undefined;
+
+            const range: ts.TextRange = tsc.getCommentRange(node);
+            const text: string = TsNodeUtil.getSourceFile(tsc)(
+                node,
+            ).text.substring(range.pos, range.end);
+            const output: string = transform(text).join("\n");
+            return output.length ? output : undefined;
+        };
+
+    export const getCommentTags =
+        (tsc: typeof ts) =>
+        (symbol: ts.Symbol): JSDocTagInfo[] | undefined => {
+            const node = symbol.declarations?.[0];
+            if (!node) return undefined;
+
+            const tagList: ts.JSDocTag[] = tsc
+                .getJSDocTags(node)
+                .map(emendTag(tsc));
+            // if (
+            //     tagList.some(
+            //         (tag) => tag.tagName.escapedText.toString() === "type",
+            //     )
+            // ) {
+            //     const entire = tsc.getJSDocCommentsAndTags(node);
+            //     const texts = entire.map((e) =>
+            //         tsc.isJSDoc(e) ? jsDocToText(e) : jsTagToText(e),
+            //     );
+            //     console.log(texts);
+            // }
+
+            return tagList.map((tag) => ({
+                name: tag.tagName.escapedText.toString(),
+                text:
+                    tag.comment === undefined
+                        ? undefined
+                        : typeof tag.comment === "string"
+                        ? [{ text: tag.comment, kind: "text" }]
+                        : tag.comment.map((text) => ({
+                              text: text.text,
+                              kind:
+                                  text.kind === tsc.SyntaxKind.JSDocText
+                                      ? "text"
+                                      : text.kind === tsc.SyntaxKind.JSDocLink
+                                      ? "link"
+                                      : text.kind ===
+                                        tsc.SyntaxKind.JSDocLinkCode
+                                      ? "link-code"
+                                      : "link-plain",
+                          })),
+            }));
+        };
+
+    const emendTag =
+        (tsc: typeof ts) =>
+        (tag: ts.JSDocTag): ts.JSDocTag => {
+            if (tag.comment !== undefined) return tag;
+
+            const tagName: string = tag.tagName.escapedText.toString();
+            const comment: string = TsNodeUtil.getSourceFile(tsc)(tag)
+                .text.substring(tag.pos, tag.end)
+                .replace(`@${tagName}`, "")
+                .split("\n")
+                .map((str) => trim(str))
+                .filter(
+                    (str, i, array) =>
+                        (i !== 0 && i !== array.length - 1) || !!str.length,
+                )
+                .join("\n");
+            return comment.length
+                ? {
+                      ...tag,
+                      comment,
+                  }
+                : tag;
+        };
+
+    const transform = (text: string): string[] => {
+        const elements: string[] = text.split("\n");
+        const first: number = lastIndexOf(elements)((elem) =>
+            elem.trim().startsWith("/**"),
+        );
+        const last: number = lastIndexOf(elements)((elem) =>
+            elem.trim().endsWith("*/"),
+        );
+
+        const cut: string[] = elements.slice(first, last + 1);
+        return cut
+            .map((elem, i) => {
+                if (i === 0) elem = elem.substring(elem.lastIndexOf("/**") + 3);
+                if (i === cut.length - 1)
+                    elem = elem.substring(0, elem.lastIndexOf("*/"));
+                return trim(elem);
+            })
+            .filter(
+                (str, i, array) =>
+                    (i !== 0 && i !== array.length - 1) || !!str.length,
+            );
+    };
+
+    const lastIndexOf =
+        <T>(array: T[]) =>
+        (pred: (elem: T) => boolean) => {
+            for (let i = array.length - 1; i >= 0; i--)
+                if (pred(array[i]!)) return i;
+            return -1;
+        };
+
+    const trim = (str: string): string => {
+        const vulnerable = (ch: string) =>
+            ch === " " ||
+            ch === "\n" ||
+            ch == "\r" ||
+            ch === "\t" ||
+            ch === "*";
+        let start: number;
+        let end: number;
+        for (start = 0; start < str.length; ++start)
+            if (!vulnerable(str.charAt(start))) break;
+        for (end = str.length - 1; end >= 0; --end)
+            if (!vulnerable(str.charAt(end))) break;
+        return start > end ? "" : str.substring(start, end + 1).trim();
+    };
+}
+
+// const jsDocToText = (doc: ts.JSDoc): string =>
+//     [jsCommentToText(doc.comment), ...(doc.tags ?? []).map(jsTagToText)]
+//         .filter((str) => !!str.length)
+//         .join(" ");
+
+// const jsTagToText = (doc: ts.JSDocTag): string =>
+//     ["@" + doc.tagName.escapedText.toString(), jsCommentToText(doc.comment)]
+//         .filter((str) => !!str.length)
+//         .join(" ");
+
+// const jsCommentToText = (
+//     comment: string | ts.NodeArray<ts.JSDocComment> | undefined,
+// ): string =>
+//     comment === undefined
+//         ? ""
+//         : typeof comment === "string"
+//         ? comment
+//         : comment.map((c) => c.text).join("");

package/src/utils/TsTypeUtil.ts

@@ -1,38 +1,38 @@
-import type ts from "typescript/lib/tsclibrary";
-
-export namespace TsTypeUtil {
-    export const isLiteral =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.LiteralType =>
-            !!(
-                type.flags &
-                (tsc.TypeFlags.StringLiteral |
-                    tsc.TypeFlags.NumberLiteral |
-                    tsc.TypeFlags.BigIntLiteral)
-            );
-
-    export const isTypeParameter =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.TypeParameter =>
-            !!(type.flags & tsc.TypeFlags.TypeParameter);
-
-    export const isUnionOrIntersection =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.UnionOrIntersectionType =>
-            !!(type.flags & tsc.TypeFlags.UnionOrIntersection);
-
-    export const isUnion =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.UnionType =>
-            !!(type.flags & tsc.TypeFlags.Union);
-
-    export const isIntersection =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.IntersectionType =>
-            !!(type.flags & tsc.TypeFlags.Intersection);
-
-    export const isClass =
-        (tsc: typeof ts) =>
-        (type: ts.Type): type is ts.InterfaceType =>
-            !!((tsc as any).getObjectFlags(type) & tsc.ObjectFlags.Class);
-}
+import type ts from "typescript/lib/tsclibrary";
+
+export namespace TsTypeUtil {
+    export const isLiteral =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.LiteralType =>
+            !!(
+                type.flags &
+                (tsc.TypeFlags.StringLiteral |
+                    tsc.TypeFlags.NumberLiteral |
+                    tsc.TypeFlags.BigIntLiteral)
+            );
+
+    export const isTypeParameter =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.TypeParameter =>
+            !!(type.flags & tsc.TypeFlags.TypeParameter);
+
+    export const isUnionOrIntersection =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.UnionOrIntersectionType =>
+            !!(type.flags & tsc.TypeFlags.UnionOrIntersection);
+
+    export const isUnion =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.UnionType =>
+            !!(type.flags & tsc.TypeFlags.Union);
+
+    export const isIntersection =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.IntersectionType =>
+            !!(type.flags & tsc.TypeFlags.Intersection);
+
+    export const isClass =
+        (tsc: typeof ts) =>
+        (type: ts.Type): type is ts.InterfaceType =>
+            !!((tsc as any).getObjectFlags(type) & tsc.ObjectFlags.Class);
+}