typia/lib/factories/CommentFactory.mjs

Superfast runtime validators with only one line

import ts from 'typescript';

var CommentFactory;
(function (CommentFactory) {
    CommentFactory.description = (symbol, includeTags = false) => {
        const node = symbol.declarations?.[0];
        if (!node)
            return undefined;
        // FOR LEGACY TS < 5.2
        const [major, minor] = ts.versionMajorMinor.split(".").map(Number);
        if (major < 5 || (major === 5 && minor < 1)) {
            const content = [];
            const main = ts.displayPartsToString(symbol.getDocumentationComment(undefined));
            if (main.length) {
                content.push(main);
                if (includeTags && symbol.getJsDocTags().length)
                    content.push("");
            }
            if (includeTags)
                for (const tag of symbol.getJsDocTags()) {
                    content.push(tag.text
                        ? `@${tag.name} ${ts.displayPartsToString(tag.text)}`
                        : `@${tag.name}`);
                }
            return content.length
                ? content.map((line) => line.split("\r\n").join("\n")).join("\n")
                : undefined;
        }
        // NEW FEATURE OF TS 5.2
        const elements = ts.getJSDocCommentsAndTags(node);
        if (elements.length === 0)
            return undefined;
        const content = [];
        for (const comment of elements) {
            if (ts.isJSDoc(comment)) {
                const parsed = ts.getTextOfJSDocComment(comment.comment);
                if (parsed?.length) {
                    content.push(parsed);
                    if (includeTags && comment.tags?.length)
                        content.push("");
                }
                if (includeTags)
                    for (const tag of comment.tags ?? [])
                        content.push(parseJSDocTag(tag));
            }
            else if (includeTags)
                content.push(parseJSDocTag(comment));
        }
        const output = content
            .map((line) => line.split("\r\n").join("\n"))
            .join("\n");
        return output.length ? output : undefined;
    };
    CommentFactory.merge = (comments) => comments
        .map((part) => part.text)
        .map((str) => str.split("\r\n").join("\n"))
        .join("");
})(CommentFactory || (CommentFactory = {}));
const parseJSDocTag = (tag) => {
    const name = tag.name?.getText();
    const parsed = ts.getTextOfJSDocComment(tag.comment);
    return [`@${tag.tagName.text}`, name, parsed]
        .filter((str) => !!str?.length)
        .join(" ");
};

export { CommentFactory };
//# sourceMappingURL=CommentFactory.mjs.map