typia 8.0.0 → 8.0.1

package/lib/AssertionGuard.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=AssertionGuard.mjs.map

package/lib/AssertionGuard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssertionGuard.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/CamelCase.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=CamelCase.mjs.map

package/lib/CamelCase.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CamelCase.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/IRandomGenerator.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IRandomGenerator.mjs.map

package/lib/IRandomGenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRandomGenerator.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/IReadableURLSearchParams.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IReadableURLSearchParams.mjs.map

package/lib/IReadableURLSearchParams.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReadableURLSearchParams.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/IValidation.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IValidation.mjs.map

package/lib/IValidation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IValidation.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/PascalCase.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=PascalCase.mjs.map

package/lib/PascalCase.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PascalCase.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/Primitive.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=Primitive.mjs.map

package/lib/Primitive.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Primitive.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/Resolved.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=Resolved.mjs.map

package/lib/Resolved.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resolved.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/SnakeCase.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=SnakeCase.mjs.map

package/lib/SnakeCase.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnakeCase.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/TypeGuardError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"TypeGuardError.mjs","sources":["../src/TypeGuardError.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAM,MAAO,cAAwB,SAAQ,KAAK,CAAA;AAChC,IAAA,MAAM;AACN,IAAA,IAAI;AACJ,IAAA,QAAQ;AACR,IAAA,KAAK;AACF,IAAA,0BAA0B;AAE7C,IAAA,WAAA,CAAmB,KAA4B,EAAA;;QAE7C,KAAK,CACH,KAAK,CAAC,OAAO;YACX,CAAY,SAAA,EAAA,KAAK,CAAC,MAAM,CACtB,gBAAA,EAAA,KAAK,CAAC,IAAI,GAAG,CAAO,IAAA,EAAA,KAAK,CAAC,IAAI,CAAA,CAAE,GAAG,EACrC,CAAkB,eAAA,EAAA,KAAK,CAAC,QAAQ,CAAE,CAAA,CACrC;;AAGD,QAAA,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS;QAClC,IAAI,MAAM,CAAC,cAAc;AAAE,YAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;;AACvD,YAAA,IAAY,CAAC,SAAS,GAAG,KAAK;;AAGpC,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;AAC1B,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,QAAA,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ;AAC9B,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;;AAE3B;;;;"}
+{"version":3,"file":"TypeGuardError.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/TypiaGenerateWizard.mjs

@@ -0,0 +1,59 @@
+import fs from 'fs';
+import { TypiaProgrammer } from '../programmers/TypiaProgrammer.mjs';
+import { ArgumentParser } from './setup/ArgumentParser.mjs';
+import { PackageManager } from './setup/PackageManager.mjs';
+
+var TypiaGenerateWizard;
+(function (TypiaGenerateWizard) {
+    async function generate() {
+        console.log("----------------------------------------");
+        console.log(" Typia Generate Wizard");
+        console.log("----------------------------------------");
+        // LOAD PACKAGE.JSON INFO
+        const pack = await PackageManager.mount();
+        const options = await ArgumentParser.parse(pack, inquiry);
+        await TypiaProgrammer.build(options);
+    }
+    TypiaGenerateWizard.generate = generate;
+    const inquiry = async (_pack, command, prompt, action) => {
+        // PREPARE ASSETS
+        command.option("--input [path]", "input directory");
+        command.option("--output [directory]", "output directory");
+        command.option("--project [project]", "tsconfig.json file location");
+        const input = (name) => async (message) => {
+            const result = await prompt()({
+                type: "input",
+                name,
+                message,
+                default: "",
+            });
+            return result[name];
+        };
+        const select = (name) => (message) => async (choices) => {
+            return (await prompt()({
+                type: "list",
+                name: name,
+                message: message,
+                choices: choices,
+            }))[name];
+        };
+        const configure = async () => {
+            const files = await (await fs.promises.readdir(process.cwd())).filter((str) => str.substring(0, 8) === "tsconfig" &&
+                str.substring(str.length - 5) === ".json");
+            if (files.length === 0)
+                throw new URIError(`Unable to find "tsconfig.json" file.`);
+            else if (files.length === 1)
+                return files[0];
+            return select("tsconfig")("TS Config File")(files);
+        };
+        return action(async (options) => {
+            options.input ??= await input("input")("input directory");
+            options.output ??= await input("output")("output directory");
+            options.project ??= await configure();
+            return options;
+        });
+    };
+})(TypiaGenerateWizard || (TypiaGenerateWizard = {}));
+
+export { TypiaGenerateWizard };
+//# sourceMappingURL=TypiaGenerateWizard.mjs.map

package/lib/executable/TypiaGenerateWizard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypiaGenerateWizard.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/TypiaPatchWizard.mjs

@@ -0,0 +1,37 @@
+import fs from 'fs';
+
+var TypiaPatchWizard;
+(function (TypiaPatchWizard) {
+    TypiaPatchWizard.main = async () => {
+        console.log("----------------------------------------");
+        console.log(" Typia Setup Wizard");
+        console.log("----------------------------------------");
+        console.log([
+            `Since TypeScript v5.3 update, "tsc" no more parses JSDoc comments.`,
+            ``,
+            `Therefore, "typia" revives the JSDoc parsing feature by patching "tsc".`,
+            ``,
+            `This is a temporary feature of "typia", and it would be removed when "ts-patch" being updated.`,
+        ].join("\n"));
+        await TypiaPatchWizard.patch();
+    };
+    TypiaPatchWizard.patch = async () => {
+        for (const file of ["tsc.js", "_tsc.js"])
+            try {
+                const location = require.resolve(`typescript/lib/${file}`);
+                const content = await fs.promises.readFile(location, "utf8");
+                if (content.indexOf(FROM_WITH_COMMENT) !== -1)
+                    await fs.promises.writeFile(location, content.replace(FROM_WITH_COMMENT, TO_WITH_COMMENT), "utf8");
+                else if (content.indexOf(FROM_ONLY) !== -1)
+                    await fs.promises.writeFile(location, content.replace(FROM_ONLY, TO_ONLY), "utf8");
+            }
+            catch { }
+    };
+})(TypiaPatchWizard || (TypiaPatchWizard = {}));
+const FROM_WITH_COMMENT = `var defaultJSDocParsingMode = 2 /* ParseForTypeErrors */`;
+const TO_WITH_COMMENT = `var defaultJSDocParsingMode = 0 /* ParseAll */`;
+const FROM_ONLY = `var defaultJSDocParsingMode = 2`;
+const TO_ONLY = `var defaultJSDocParsingMode = 0`;
+
+export { TypiaPatchWizard };
+//# sourceMappingURL=TypiaPatchWizard.mjs.map

package/lib/executable/TypiaPatchWizard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypiaPatchWizard.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/TypiaSetupWizard.mjs

@@ -0,0 +1,131 @@
+import fs from 'fs';
+import { detect } from 'package-manager-detector';
+import { ArgumentParser } from './setup/ArgumentParser.mjs';
+import { CommandExecutor } from './setup/CommandExecutor.mjs';
+import { PackageManager } from './setup/PackageManager.mjs';
+import { PluginConfigurator } from './setup/PluginConfigurator.mjs';
+
+var TypiaSetupWizard;
+(function (TypiaSetupWizard) {
+    TypiaSetupWizard.setup = async () => {
+        console.log("----------------------------------------");
+        console.log(" Typia Setup Wizard");
+        console.log("----------------------------------------");
+        // PREPARE ASSETS
+        const pack = await PackageManager.mount();
+        const args = await ArgumentParser.parse(pack, inquiry);
+        // INSTALL TYPESCRIPT COMPILERS
+        pack.install({
+            dev: true,
+            modulo: "typescript",
+            version: await getTypeScriptVersion(),
+        });
+        pack.install({ dev: true, modulo: "ts-patch", version: "latest" });
+        args.project ??= (() => {
+            const runner = pack.manager === "npm" ? "npx" : pack.manager;
+            CommandExecutor.run(`${runner} tsc --init`);
+            return (args.project = "tsconfig.json");
+        })();
+        // SETUP TRANSFORMER
+        await pack.save((data) => {
+            // COMPOSE PREPARE COMMAND
+            data.scripts ??= {};
+            if (typeof data.scripts.prepare === "string" &&
+                data.scripts.prepare.trim().length !== 0) {
+                if (data.scripts.prepare.includes("ts-patch install") === false)
+                    data.scripts.prepare = "ts-patch install && " + data.scripts.prepare;
+            }
+            else
+                data.scripts.prepare = "ts-patch install";
+            // NO MORE "typia patch" REQUIRED
+            data.scripts.prepare = data.scripts.prepare
+                .split("&&")
+                .map((str) => str.trim())
+                .filter((str) => str !== "typia patch")
+                .join(" && ");
+            // FOR OLDER VERSIONS
+            if (typeof data.scripts.postinstall === "string") {
+                data.scripts.postinstall = data.scripts.postinstall
+                    .split("&&")
+                    .map((str) => str.trim())
+                    .filter((str) => str.indexOf("ts-patch install") === -1)
+                    .join(" && ");
+                if (data.scripts.postinstall.length === 0)
+                    delete data.scripts.postinstall;
+            }
+        });
+        // CONFIGURE TYPIA
+        await PluginConfigurator.configure(args);
+        CommandExecutor.run(`${pack.manager} run prepare`);
+    };
+    const inquiry = async (pack, command, prompt, action) => {
+        // PREPARE ASSETS
+        command.option("--manager [manager", "package manager");
+        command.option("--project [project]", "tsconfig.json file location");
+        // INTERNAL PROCEDURES
+        const questioned = { value: false };
+        const select = (name) => (message) => async (choices, filter) => {
+            questioned.value = true;
+            return (await prompt()({
+                type: "list",
+                name: name,
+                message: message,
+                choices: choices,
+                ...(filter ? { filter } : {}),
+            }))[name];
+        };
+        const configure = async () => {
+            const fileList = await (await fs.promises.readdir(process.cwd()))
+                .filter((str) => str.substring(0, 8) === "tsconfig" &&
+                str.substring(str.length - 5) === ".json")
+                .sort((x, y) => x === "tsconfig.json"
+                ? -1
+                : y === "tsconfig.json"
+                    ? 1
+                    : x < y
+                        ? -1
+                        : 1);
+            if (fileList.length === 0) {
+                if (process.cwd() !== pack.directory)
+                    throw new URIError(`Unable to find "tsconfig.json" file.`);
+                return null;
+            }
+            else if (fileList.length === 1)
+                return fileList[0];
+            return select("tsconfig")("TS Config File")(fileList);
+        };
+        // DO CONSTRUCT
+        return action(async (options) => {
+            pack.manager = options.manager ??=
+                (await detectManager()) ??
+                    (await select("manager")("Package Manager")([
+                        "npm",
+                        "pnpm",
+                        "bun",
+                        "yarn (berry is not supported)",
+                    ], (value) => value.split(" ")[0]));
+            options.project ??= await configure();
+            if (questioned.value)
+                console.log("");
+            return options;
+        });
+    };
+    const detectManager = async () => {
+        const result = await detect({ cwd: process.cwd() });
+        switch (result?.name) {
+            case "npm":
+            case "deno":
+                return null; // NPM case is still selectable & Deno is not supported
+            default:
+                return result?.name ?? null;
+        }
+    };
+    const getTypeScriptVersion = async () => {
+        const content = await fs.promises.readFile(`${__dirname}/../../package.json`, "utf-8");
+        const json = JSON.parse(content);
+        return json.devDependencies.typescript;
+    };
+})(TypiaSetupWizard || (TypiaSetupWizard = {}));
+
+export { TypiaSetupWizard };
+//# sourceMappingURL=TypiaSetupWizard.mjs.map

package/lib/executable/TypiaSetupWizard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypiaSetupWizard.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/setup/ArgumentParser.mjs

@@ -0,0 +1,24 @@
+import commander from 'commander';
+import inquirer from 'inquirer';
+
+var ArgumentParser;
+(function (ArgumentParser) {
+    ArgumentParser.parse = async (pack, inquiry) => {
+        // TAKE OPTIONS
+        const action = (closure) => new Promise((resolve, reject) => {
+            commander.program.action(async (options) => {
+                try {
+                    resolve(await closure(options));
+                }
+                catch (exp) {
+                    reject(exp);
+                }
+            });
+            commander.program.parseAsync().catch(reject);
+        });
+        return inquiry(pack, commander.program, inquirer.createPromptModule, action);
+    };
+})(ArgumentParser || (ArgumentParser = {}));
+
+export { ArgumentParser };
+//# sourceMappingURL=ArgumentParser.mjs.map

package/lib/executable/setup/ArgumentParser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgumentParser.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/setup/CommandExecutor.mjs

@@ -0,0 +1,12 @@
+import cp from 'child_process';
+
+var CommandExecutor;
+(function (CommandExecutor) {
+    CommandExecutor.run = (str) => {
+        console.log(`\n$ ${str}`);
+        cp.execSync(str, { stdio: "inherit" });
+    };
+})(CommandExecutor || (CommandExecutor = {}));
+
+export { CommandExecutor };
+//# sourceMappingURL=CommandExecutor.mjs.map

package/lib/executable/setup/CommandExecutor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandExecutor.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/setup/FileRetriever.mjs

@@ -0,0 +1,21 @@
+import fs from 'fs';
+import path from 'path';
+
+var FileRetriever;
+(function (FileRetriever) {
+    FileRetriever.directory = (props) => {
+        const location = path.join(props.location, props.file);
+        if (fs.existsSync(location))
+            return props.location;
+        else if ((props.depth ?? 0) > 2)
+            return null;
+        return FileRetriever.directory({
+            file: props.file,
+            location: path.join(props.location, ".."),
+            depth: (props.depth ?? 0) + 1,
+        });
+    };
+})(FileRetriever || (FileRetriever = {}));
+
+export { FileRetriever };
+//# sourceMappingURL=FileRetriever.mjs.map

package/lib/executable/setup/FileRetriever.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileRetriever.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/setup/PackageManager.mjs

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import { CommandExecutor } from './CommandExecutor.mjs';
+import { FileRetriever } from './FileRetriever.mjs';
+
+class PackageManager {
+    directory;
+    data;
+    manager = "npm";
+    get file() {
+        return path.join(this.directory, "package.json");
+    }
+    static async mount() {
+        const location = await FileRetriever.directory({
+            file: "package.json",
+            location: process.cwd(),
+        });
+        if (location === null)
+            throw new URIError(`Unable to find "package.json" file`);
+        return new PackageManager(location, await this.load(path.join(location, "package.json")));
+    }
+    async save(modifier) {
+        const content = await fs.promises.readFile(this.file, "utf8");
+        this.data = JSON.parse(content);
+        modifier(this.data);
+        return fs.promises.writeFile(this.file, JSON.stringify(this.data, null, 2), "utf8");
+    }
+    install(props) {
+        const middle = [
+            installCmdTable[this.manager],
+            props.dev ? devOptionTable[this.manager] : "",
+        ]
+            .filter((str) => !!str.length)
+            .join(" ");
+        const modulo = `${props.modulo}${props.version ? `@${props.version}` : ""}`;
+        CommandExecutor.run([this.manager, middle, modulo].join(" "));
+        return true;
+    }
+    constructor(directory, data) {
+        this.directory = directory;
+        this.data = data;
+    }
+    static async load(file) {
+        const content = await fs.promises.readFile(file, "utf8");
+        return JSON.parse(content);
+    }
+}
+const installCmdTable = {
+    npm: "i",
+    pnpm: "add",
+    yarn: "add",
+    bun: "add",
+};
+const devOptionTable = {
+    npm: "-D",
+    pnpm: "-D",
+    yarn: "-D",
+    bun: "-d",
+};
+
+export { PackageManager };
+//# sourceMappingURL=PackageManager.mjs.map

package/lib/executable/setup/PackageManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageManager.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/setup/PluginConfigurator.mjs

@@ -0,0 +1,45 @@
+import comments from 'comment-json';
+import fs from 'fs';
+
+var PluginConfigurator;
+(function (PluginConfigurator) {
+    async function configure(args) {
+        // GET COMPILER-OPTIONS
+        const config = comments.parse(await fs.promises.readFile(args.project, "utf8"));
+        const compilerOptions = config.compilerOptions;
+        if (compilerOptions === undefined)
+            throw new ReferenceError(`${args.project} file does not have "compilerOptions" property.`);
+        // PREPARE PLUGINS
+        const plugins = (() => {
+            const plugins = compilerOptions.plugins;
+            if (plugins === undefined)
+                return (compilerOptions.plugins = []);
+            else if (!Array.isArray(plugins))
+                throw new TypeError(`"plugins" property of ${args.project} must be array type.`);
+            return plugins;
+        })();
+        const strict = compilerOptions.strict;
+        const strictNullChecks = compilerOptions.strictNullChecks;
+        const oldbie = plugins.find((p) => typeof p === "object" &&
+            p !== null &&
+            p.transform === "typia/lib/transform");
+        if (strictNullChecks !== false &&
+            (strict === true || strictNullChecks === true) &&
+            oldbie !== undefined)
+            return;
+        // DO CONFIGURE
+        compilerOptions.strictNullChecks = true;
+        if (strict === undefined && strictNullChecks === undefined)
+            compilerOptions.strict = true;
+        if (oldbie === undefined)
+            plugins.push(comments.parse(`
+                        {
+                            "transform": "typia/lib/transform"
+                        }`));
+        await fs.promises.writeFile(args.project, comments.stringify(config, null, 2));
+    }
+    PluginConfigurator.configure = configure;
+})(PluginConfigurator || (PluginConfigurator = {}));
+
+export { PluginConfigurator };
+//# sourceMappingURL=PluginConfigurator.mjs.map

package/lib/executable/setup/PluginConfigurator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginConfigurator.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/executable/typia.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+const USAGE = `Wrong command has been detected. Use like below:
+
+  npx typia setup \\
+    --manager (npm|pnpm|yarn) \\
+    --project {tsconfig.json file path}
+
+    - npx typia setup
+    - npx typia setup --manager pnpm
+    - npx typia setup --project tsconfig.test.json
+
+  npx typia generate 
+    --input {directory} \\
+    --output {directory}
+
+    --npx typia generate --input src/templates --output src/functinoal
+`;
+const halt = (desc) => {
+    console.error(desc);
+    process.exit(-1);
+};
+const main = async () => {
+    try {
+        await import('comment-json');
+        await import('inquirer');
+        await import('commander');
+    }
+    catch {
+        halt(`typia has not been installed. Run "npm i typia" before.`);
+    }
+    const type = process.argv[2];
+    if (type === "setup") {
+        const { TypiaSetupWizard } = await import('./TypiaSetupWizard.mjs');
+        await TypiaSetupWizard.setup();
+    }
+    else if (type === "patch") {
+        const { TypiaPatchWizard } = await import('./TypiaPatchWizard.mjs');
+        await TypiaPatchWizard.main();
+    }
+    else if (type === "generate") {
+        try {
+            await import('typescript');
+        }
+        catch {
+            halt(`typescript has not been installed. Run "npm i -D typescript" before.`);
+        }
+        const { TypiaGenerateWizard } = await import('./TypiaGenerateWizard.mjs');
+        await TypiaGenerateWizard.generate();
+    }
+    else
+        halt(USAGE);
+};
+main().catch((exp) => {
+    console.error(exp);
+    process.exit(-1);
+});
+//# sourceMappingURL=typia.mjs.map

package/lib/executable/typia.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typia.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/factories/CommentFactory.mjs

@@ -0,0 +1,68 @@
+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

package/lib/factories/CommentFactory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentFactory.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}