typia 13.1.1 → 13.2.0

package/README.md

@@ -58,6 +58,9 @@ export function random<T>(g?: Partial<IRandomGenerator>): T;
 > - JSON serialization is **200x faster** than `class-transformer`
 > - LLM function calling harness turns **6.75% → 100%** accuracy
 
+Write the type on the left, and `typia` compiles it into the validator on the right — at build time, with no schema and no runtime reflection.
+
+![Write a TypeScript type and typia compiles it into a dedicated validator](https://typia.io/images/concepts/transform.svg)
 
 ## Setup
 

package/lib/_virtual/_rolldown/runtime.mjs

@@ -9,9 +9,5 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
-	if (typeof require !== "undefined") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
-});
 //#endregion
-export { __exportAll, __require };
+export { __exportAll };

package/lib/executable/FileSystemIdentity.d.ts

@@ -0,0 +1,44 @@
+import fs from "fs";
+import path from "path";
+export declare namespace FileSystemIdentity {
+    interface IIdentity {
+        readonly caseSensitive: boolean;
+        contains(file: string, directory: string): boolean;
+        filesystemKey(file: string): string;
+        isDeclarationFile(file: string): boolean;
+        isSamePath(x: string, y: string): boolean;
+        isSupportedExtension(file: string): boolean;
+        projectFileKey(file: string): string;
+    }
+    function create(caseSensitive: boolean, pathApi?: typeof path.posix): IIdentity;
+    class Policy {
+        private caseSensitive_;
+        private location_;
+        observe(caseSensitive: boolean | undefined, location: string): void;
+        get(): IIdentity;
+    }
+    function inspectDirectory(directory: string): Promise<boolean | undefined>;
+    function probeDirectory(directory: string): Promise<boolean>;
+    /**
+     * Builds the key that decides whether two paths are the same filesystem
+     * object.
+     *
+     * The identity is read from `fs.BigIntStats` rather than `fs.Stats`, because
+     * `fs.Stats.ino` is a JavaScript number. An NTFS file ID is `(sequenceNumber
+     * << 48) | mftRecordIndex` and routinely exceeds `Number.MAX_SAFE_INTEGER` —
+     * in a 4000-directory probe, 1879 of them did — where the spacing between
+     * representable doubles is 8 or more. Two entries sharing a sequence number
+     * with MFT record indices within that spacing round to one double. The
+     * traversal callers would then treat a distinct directory or file as already
+     * visited and skip it with no diagnostic, and the overwrite guard would
+     * refuse a legitimate output (samchon/typia#2269).
+     *
+     * A filesystem that reports no inode at all keeps the canonical path
+     * fallback, which is the only identity available there.
+     *
+     * @param stat Stats read with `{ bigint: true }`.
+     * @param realpath Canonical path of the same object.
+     * @returns Key that is equal for two paths only when they are one object.
+     */
+    function identityKey(stat: Pick<fs.BigIntStats, "dev" | "ino">, realpath: string): string;
+}

package/lib/executable/FileSystemIdentity.js

@@ -0,0 +1,213 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemIdentity = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+var FileSystemIdentity;
+(function (FileSystemIdentity) {
+    function create(caseSensitive, pathApi = path_1.default) {
+        const fold = (value) => caseSensitive ? value : value.toLowerCase();
+        const filesystemKey = (file) => fold(pathApi.normalize(file));
+        return {
+            caseSensitive,
+            contains: (file, directory) => {
+                const fileKey = filesystemKey(pathApi.resolve(file));
+                const directoryKey = filesystemKey(pathApi.resolve(directory));
+                const prefix = directoryKey.endsWith(pathApi.sep)
+                    ? directoryKey
+                    : `${directoryKey}${pathApi.sep}`;
+                return fileKey === directoryKey || fileKey.startsWith(prefix);
+            },
+            filesystemKey,
+            isDeclarationFile: (file) => DTS_PATTERN.test(fold(pathApi.basename(file))),
+            isSamePath: (x, y) => filesystemKey(x) === filesystemKey(y),
+            isSupportedExtension: (file) => {
+                const filename = fold(pathApi.basename(file));
+                return (TS_PATTERN.test(filename) && DTS_PATTERN.test(filename) === false);
+            },
+            projectFileKey: fold,
+        };
+    }
+    FileSystemIdentity.create = create;
+    class Policy {
+        observe(caseSensitive, location) {
+            if (caseSensitive === undefined)
+                return;
+            if (this.caseSensitive_ === undefined) {
+                this.caseSensitive_ = caseSensitive;
+                this.location_ = location;
+            }
+            else if (this.caseSensitive_ !== caseSensitive) {
+                throw new URIError(`Error on TypiaGenerateWizard.generate(): inconsistent filesystem case behavior between ${this.location_} and ${location}.`);
+            }
+        }
+        get() {
+            if (this.caseSensitive_ === undefined) {
+                throw new URIError("Error on TypiaGenerateWizard.generate(): unable to determine filesystem case behavior for this run.");
+            }
+            return create(this.caseSensitive_);
+        }
+    }
+    FileSystemIdentity.Policy = Policy;
+    function inspectDirectory(directory) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const names = yield fs_1.default.promises.readdir(directory);
+            const entries = new Set(names);
+            for (const name of names) {
+                const alternate = alternateCase(name);
+                if (alternate === undefined)
+                    continue;
+                if (entries.has(alternate))
+                    return true;
+                try {
+                    yield fs_1.default.promises.lstat(path_1.default.join(directory, alternate));
+                    return false;
+                }
+                catch (error) {
+                    if (isMissingFileError(error))
+                        return true;
+                    throw error;
+                }
+            }
+            return undefined;
+        });
+    }
+    FileSystemIdentity.inspectDirectory = inspectDirectory;
+    function probeDirectory(directory) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const inspected = yield inspectDirectory(directory);
+            if (inspected !== undefined)
+                return inspected;
+            for (let attempt = 0; attempt < 10; ++attempt) {
+                const name = `.typia-case-probe-${process.pid}-${Date.now()}-${Math.random()
+                    .toString(36)
+                    .slice(2)}`.toLowerCase();
+                const original = path_1.default.join(directory, name);
+                const alternate = path_1.default.join(directory, name.toUpperCase());
+                let handle;
+                try {
+                    handle = yield fs_1.default.promises.open(original, "wx");
+                }
+                catch (error) {
+                    if (isAlreadyExistsError(error))
+                        continue;
+                    throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to probe filesystem case behavior at ${directory}: ${formatUnknownError(error)}`);
+                }
+                let closed = false;
+                try {
+                    yield handle.close();
+                    closed = true;
+                    try {
+                        yield fs_1.default.promises.lstat(alternate);
+                        return false;
+                    }
+                    catch (error) {
+                        if (isMissingFileError(error))
+                            return true;
+                        throw error;
+                    }
+                }
+                finally {
+                    let cleanupError;
+                    if (closed === false) {
+                        try {
+                            yield handle.close();
+                        }
+                        catch (error) {
+                            cleanupError = error;
+                        }
+                    }
+                    try {
+                        yield fs_1.default.promises.unlink(original);
+                    }
+                    catch (error) {
+                        if (isMissingFileError(error) === false)
+                            cleanupError !== null && cleanupError !== void 0 ? cleanupError : (cleanupError = error);
+                    }
+                    if (cleanupError !== undefined) {
+                        throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to clean filesystem case probe ${original}: ${formatUnknownError(cleanupError)}`);
+                    }
+                }
+            }
+            throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to reserve a filesystem case probe at ${directory}.`);
+        });
+    }
+    FileSystemIdentity.probeDirectory = probeDirectory;
+    /**
+     * Builds the key that decides whether two paths are the same filesystem
+     * object.
+     *
+     * The identity is read from `fs.BigIntStats` rather than `fs.Stats`, because
+     * `fs.Stats.ino` is a JavaScript number. An NTFS file ID is `(sequenceNumber
+     * << 48) | mftRecordIndex` and routinely exceeds `Number.MAX_SAFE_INTEGER` —
+     * in a 4000-directory probe, 1879 of them did — where the spacing between
+     * representable doubles is 8 or more. Two entries sharing a sequence number
+     * with MFT record indices within that spacing round to one double. The
+     * traversal callers would then treat a distinct directory or file as already
+     * visited and skip it with no diagnostic, and the overwrite guard would
+     * refuse a legitimate output (samchon/typia#2269).
+     *
+     * A filesystem that reports no inode at all keeps the canonical path
+     * fallback, which is the only identity available there.
+     *
+     * @param stat Stats read with `{ bigint: true }`.
+     * @param realpath Canonical path of the same object.
+     * @returns Key that is equal for two paths only when they are one object.
+     */
+    function identityKey(stat, realpath) {
+        // `BigInt(0)` rather than `0n`: this package compiles at ES2016, where a
+        // BigInt literal is a syntax error, while the constructor and the `bigint`
+        // type are fine.
+        return stat.ino === BigInt(0)
+            ? `path:${path_1.default.normalize(realpath)}`
+            : `inode:${stat.dev}:${stat.ino}`;
+    }
+    FileSystemIdentity.identityKey = identityKey;
+    function alternateCase(name) {
+        let changed = false;
+        let output = "";
+        for (const character of name) {
+            if (character >= "a" && character <= "z") {
+                output += character.toUpperCase();
+                changed = true;
+            }
+            else if (character >= "A" && character <= "Z") {
+                output += character.toLowerCase();
+                changed = true;
+            }
+            else
+                output += character;
+        }
+        return changed ? output : undefined;
+    }
+    function isAlreadyExistsError(error) {
+        return (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "EEXIST");
+    }
+    function isMissingFileError(error) {
+        return (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ENOENT");
+    }
+    function formatUnknownError(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+})(FileSystemIdentity || (exports.FileSystemIdentity = FileSystemIdentity = {}));
+const TS_PATTERN = /\.[cm]?tsx?$/;
+const DTS_PATTERN = /\.d\.[cm]?tsx?$/;
+//# sourceMappingURL=FileSystemIdentity.js.map

package/lib/executable/FileSystemIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemIdentity.js","sourceRoot":"","sources":["../../src/executable/FileSystemIdentity.ts"],"names":[],"mappings":"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"}

package/lib/executable/FileSystemIdentity.mjs

@@ -0,0 +1,133 @@
+import fs from "fs";
+import path from "path";
+//#region src/executable/FileSystemIdentity.ts
+let FileSystemIdentity;
+(function(_FileSystemIdentity) {
+	function create(caseSensitive, pathApi = path) {
+		const fold = (value) => caseSensitive ? value : value.toLowerCase();
+		const filesystemKey = (file) => fold(pathApi.normalize(file));
+		return {
+			caseSensitive,
+			contains: (file, directory) => {
+				const fileKey = filesystemKey(pathApi.resolve(file));
+				const directoryKey = filesystemKey(pathApi.resolve(directory));
+				const prefix = directoryKey.endsWith(pathApi.sep) ? directoryKey : `${directoryKey}${pathApi.sep}`;
+				return fileKey === directoryKey || fileKey.startsWith(prefix);
+			},
+			filesystemKey,
+			isDeclarationFile: (file) => DTS_PATTERN.test(fold(pathApi.basename(file))),
+			isSamePath: (x, y) => filesystemKey(x) === filesystemKey(y),
+			isSupportedExtension: (file) => {
+				const filename = fold(pathApi.basename(file));
+				return TS_PATTERN.test(filename) && DTS_PATTERN.test(filename) === false;
+			},
+			projectFileKey: fold
+		};
+	}
+	_FileSystemIdentity.create = create;
+	class Policy {
+		observe(caseSensitive, location) {
+			if (caseSensitive === void 0) return;
+			if (this.caseSensitive_ === void 0) {
+				this.caseSensitive_ = caseSensitive;
+				this.location_ = location;
+			} else if (this.caseSensitive_ !== caseSensitive) throw new URIError(`Error on TypiaGenerateWizard.generate(): inconsistent filesystem case behavior between ${this.location_} and ${location}.`);
+		}
+		get() {
+			if (this.caseSensitive_ === void 0) throw new URIError("Error on TypiaGenerateWizard.generate(): unable to determine filesystem case behavior for this run.");
+			return create(this.caseSensitive_);
+		}
+	}
+	_FileSystemIdentity.Policy = Policy;
+	async function inspectDirectory(directory) {
+		const names = await fs.promises.readdir(directory);
+		const entries = new Set(names);
+		for (const name of names) {
+			const alternate = alternateCase(name);
+			if (alternate === void 0) continue;
+			if (entries.has(alternate)) return true;
+			try {
+				await fs.promises.lstat(path.join(directory, alternate));
+				return false;
+			} catch (error) {
+				if (isMissingFileError(error)) return true;
+				throw error;
+			}
+		}
+	}
+	_FileSystemIdentity.inspectDirectory = inspectDirectory;
+	async function probeDirectory(directory) {
+		const inspected = await inspectDirectory(directory);
+		if (inspected !== void 0) return inspected;
+		for (let attempt = 0; attempt < 10; ++attempt) {
+			const name = `.typia-case-probe-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`.toLowerCase();
+			const original = path.join(directory, name);
+			const alternate = path.join(directory, name.toUpperCase());
+			let handle;
+			try {
+				handle = await fs.promises.open(original, "wx");
+			} catch (error) {
+				if (isAlreadyExistsError(error)) continue;
+				throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to probe filesystem case behavior at ${directory}: ${formatUnknownError(error)}`);
+			}
+			let closed = false;
+			try {
+				await handle.close();
+				closed = true;
+				try {
+					await fs.promises.lstat(alternate);
+					return false;
+				} catch (error) {
+					if (isMissingFileError(error)) return true;
+					throw error;
+				}
+			} finally {
+				let cleanupError;
+				if (closed === false) try {
+					await handle.close();
+				} catch (error) {
+					cleanupError = error;
+				}
+				try {
+					await fs.promises.unlink(original);
+				} catch (error) {
+					if (isMissingFileError(error) === false) cleanupError ??= error;
+				}
+				if (cleanupError !== void 0) throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to clean filesystem case probe ${original}: ${formatUnknownError(cleanupError)}`);
+			}
+		}
+		throw new URIError(`Error on TypiaGenerateWizard.generate(): unable to reserve a filesystem case probe at ${directory}.`);
+	}
+	_FileSystemIdentity.probeDirectory = probeDirectory;
+	function identityKey(stat, realpath) {
+		return stat.ino === BigInt(0) ? `path:${path.normalize(realpath)}` : `inode:${stat.dev}:${stat.ino}`;
+	}
+	_FileSystemIdentity.identityKey = identityKey;
+	function alternateCase(name) {
+		let changed = false;
+		let output = "";
+		for (const character of name) if (character >= "a" && character <= "z") {
+			output += character.toUpperCase();
+			changed = true;
+		} else if (character >= "A" && character <= "Z") {
+			output += character.toLowerCase();
+			changed = true;
+		} else output += character;
+		return changed ? output : void 0;
+	}
+	function isAlreadyExistsError(error) {
+		return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
+	}
+	function isMissingFileError(error) {
+		return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+	}
+	function formatUnknownError(error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+})(FileSystemIdentity || (FileSystemIdentity = {}));
+const TS_PATTERN = /\.[cm]?tsx?$/;
+const DTS_PATTERN = /\.d\.[cm]?tsx?$/;
+//#endregion
+export { FileSystemIdentity };
+
+//# sourceMappingURL=FileSystemIdentity.mjs.map

package/lib/executable/FileSystemIdentity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystemIdentity.mjs","names":[],"sources":["../../src/executable/FileSystemIdentity.ts"],"sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\n\nexport namespace FileSystemIdentity {\n  export interface IIdentity {\n    readonly caseSensitive: boolean;\n    contains(file: string, directory: string): boolean;\n    filesystemKey(file: string): string;\n    isDeclarationFile(file: string): boolean;\n    isSamePath(x: string, y: string): boolean;\n    isSupportedExtension(file: string): boolean;\n    projectFileKey(file: string): string;\n  }\n\n  export function create(\n    caseSensitive: boolean,\n    pathApi: typeof path.posix = path,\n  ): IIdentity {\n    const fold = (value: string): string =>\n      caseSensitive ? value : value.toLowerCase();\n    const filesystemKey = (file: string): string =>\n      fold(pathApi.normalize(file));\n    return {\n      caseSensitive,\n      contains: (file, directory) => {\n        const fileKey: string = filesystemKey(pathApi.resolve(file));\n        const directoryKey: string = filesystemKey(pathApi.resolve(directory));\n        const prefix: string = directoryKey.endsWith(pathApi.sep)\n          ? directoryKey\n          : `${directoryKey}${pathApi.sep}`;\n        return fileKey === directoryKey || fileKey.startsWith(prefix);\n      },\n      filesystemKey,\n      isDeclarationFile: (file) =>\n        DTS_PATTERN.test(fold(pathApi.basename(file))),\n      isSamePath: (x, y) => filesystemKey(x) === filesystemKey(y),\n      isSupportedExtension: (file) => {\n        const filename: string = fold(pathApi.basename(file));\n        return (\n          TS_PATTERN.test(filename) && DTS_PATTERN.test(filename) === false\n        );\n      },\n      projectFileKey: fold,\n    };\n  }\n\n  export class Policy {\n    private caseSensitive_: boolean | undefined;\n    private location_: string | undefined;\n\n    public observe(caseSensitive: boolean | undefined, location: string): void {\n      if (caseSensitive === undefined) return;\n      if (this.caseSensitive_ === undefined) {\n        this.caseSensitive_ = caseSensitive;\n        this.location_ = location;\n      } else if (this.caseSensitive_ !== caseSensitive) {\n        throw new URIError(\n          `Error on TypiaGenerateWizard.generate(): inconsistent filesystem case behavior between ${this.location_} and ${location}.`,\n        );\n      }\n    }\n\n    public get(): IIdentity {\n      if (this.caseSensitive_ === undefined) {\n        throw new URIError(\n          \"Error on TypiaGenerateWizard.generate(): unable to determine filesystem case behavior for this run.\",\n        );\n      }\n      return create(this.caseSensitive_);\n    }\n  }\n\n  export async function inspectDirectory(\n    directory: string,\n  ): Promise<boolean | undefined> {\n    const names: string[] = await fs.promises.readdir(directory);\n    const entries: Set<string> = new Set(names);\n    for (const name of names) {\n      const alternate: string | undefined = alternateCase(name);\n      if (alternate === undefined) continue;\n      if (entries.has(alternate)) return true;\n      try {\n        await fs.promises.lstat(path.join(directory, alternate));\n        return false;\n      } catch (error) {\n        if (isMissingFileError(error)) return true;\n        throw error;\n      }\n    }\n    return undefined;\n  }\n\n  export async function probeDirectory(directory: string): Promise<boolean> {\n    const inspected: boolean | undefined = await inspectDirectory(directory);\n    if (inspected !== undefined) return inspected;\n\n    for (let attempt = 0; attempt < 10; ++attempt) {\n      const name: string =\n        `.typia-case-probe-${process.pid}-${Date.now()}-${Math.random()\n          .toString(36)\n          .slice(2)}`.toLowerCase();\n      const original: string = path.join(directory, name);\n      const alternate: string = path.join(directory, name.toUpperCase());\n      let handle: fs.promises.FileHandle;\n      try {\n        handle = await fs.promises.open(original, \"wx\");\n      } catch (error) {\n        if (isAlreadyExistsError(error)) continue;\n        throw new URIError(\n          `Error on TypiaGenerateWizard.generate(): unable to probe filesystem case behavior at ${directory}: ${formatUnknownError(error)}`,\n        );\n      }\n      let closed: boolean = false;\n      try {\n        await handle.close();\n        closed = true;\n        try {\n          await fs.promises.lstat(alternate);\n          return false;\n        } catch (error) {\n          if (isMissingFileError(error)) return true;\n          throw error;\n        }\n      } finally {\n        let cleanupError: unknown;\n        if (closed === false) {\n          try {\n            await handle.close();\n          } catch (error) {\n            cleanupError = error;\n          }\n        }\n        try {\n          await fs.promises.unlink(original);\n        } catch (error) {\n          if (isMissingFileError(error) === false) cleanupError ??= error;\n        }\n        if (cleanupError !== undefined) {\n          throw new URIError(\n            `Error on TypiaGenerateWizard.generate(): unable to clean filesystem case probe ${original}: ${formatUnknownError(cleanupError)}`,\n          );\n        }\n      }\n    }\n    throw new URIError(\n      `Error on TypiaGenerateWizard.generate(): unable to reserve a filesystem case probe at ${directory}.`,\n    );\n  }\n\n  /**\n   * Builds the key that decides whether two paths are the same filesystem\n   * object.\n   *\n   * The identity is read from `fs.BigIntStats` rather than `fs.Stats`, because\n   * `fs.Stats.ino` is a JavaScript number. An NTFS file ID is `(sequenceNumber\n   * << 48) | mftRecordIndex` and routinely exceeds `Number.MAX_SAFE_INTEGER` —\n   * in a 4000-directory probe, 1879 of them did — where the spacing between\n   * representable doubles is 8 or more. Two entries sharing a sequence number\n   * with MFT record indices within that spacing round to one double. The\n   * traversal callers would then treat a distinct directory or file as already\n   * visited and skip it with no diagnostic, and the overwrite guard would\n   * refuse a legitimate output (samchon/typia#2269).\n   *\n   * A filesystem that reports no inode at all keeps the canonical path\n   * fallback, which is the only identity available there.\n   *\n   * @param stat Stats read with `{ bigint: true }`.\n   * @param realpath Canonical path of the same object.\n   * @returns Key that is equal for two paths only when they are one object.\n   */\n  export function identityKey(\n    stat: Pick<fs.BigIntStats, \"dev\" | \"ino\">,\n    realpath: string,\n  ): string {\n    // `BigInt(0)` rather than `0n`: this package compiles at ES2016, where a\n    // BigInt literal is a syntax error, while the constructor and the `bigint`\n    // type are fine.\n    return stat.ino === BigInt(0)\n      ? `path:${path.normalize(realpath)}`\n      : `inode:${stat.dev}:${stat.ino}`;\n  }\n\n  function alternateCase(name: string): string | undefined {\n    let changed: boolean = false;\n    let output: string = \"\";\n    for (const character of name) {\n      if (character >= \"a\" && character <= \"z\") {\n        output += character.toUpperCase();\n        changed = true;\n      } else if (character >= \"A\" && character <= \"Z\") {\n        output += character.toLowerCase();\n        changed = true;\n      } else output += character;\n    }\n    return changed ? output : undefined;\n  }\n\n  function isAlreadyExistsError(error: unknown): boolean {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      error.code === \"EEXIST\"\n    );\n  }\n\n  function isMissingFileError(error: unknown): boolean {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      error.code === \"ENOENT\"\n    );\n  }\n\n  function formatUnknownError(error: unknown): string {\n    return error instanceof Error ? error.message : String(error);\n  }\n}\n\nconst TS_PATTERN = /\\.[cm]?tsx?$/;\nconst DTS_PATTERN = /\\.d\\.[cm]?tsx?$/;\n"],"mappings":";;;AAGO,IAAA;;CAWE,SAAS,OACd,eACA,UAA6B,MAClB;EACX,MAAM,QAAQ,UACZ,gBAAgB,QAAQ,MAAM,YAAY;EAC5C,MAAM,iBAAiB,SACrB,KAAK,QAAQ,UAAU,IAAI,CAAC;EAC9B,OAAO;GACL;GACA,WAAW,MAAM,cAAc;IAC7B,MAAM,UAAkB,cAAc,QAAQ,QAAQ,IAAI,CAAC;IAC3D,MAAM,eAAuB,cAAc,QAAQ,QAAQ,SAAS,CAAC;IACrE,MAAM,SAAiB,aAAa,SAAS,QAAQ,GAAG,IACpD,eACA,GAAG,eAAe,QAAQ;IAC9B,OAAO,YAAY,gBAAgB,QAAQ,WAAW,MAAM;GAC9D;GACA;GACA,oBAAoB,SAClB,YAAY,KAAK,KAAK,QAAQ,SAAS,IAAI,CAAC,CAAC;GAC/C,aAAa,GAAG,MAAM,cAAc,CAAC,MAAM,cAAc,CAAC;GAC1D,uBAAuB,SAAS;IAC9B,MAAM,WAAmB,KAAK,QAAQ,SAAS,IAAI,CAAC;IACpD,OACE,WAAW,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,MAAM;GAEhE;GACA,gBAAgB;EAClB;CACF;;CAEO,MAAM,OAAO;EAIlB,QAAe,eAAoC,UAAwB;GACzE,IAAI,kBAAkB,KAAA,GAAW;GACjC,IAAI,KAAK,mBAAmB,KAAA,GAAW;IACrC,KAAK,iBAAiB;IACtB,KAAK,YAAY;GACnB,OAAO,IAAI,KAAK,mBAAmB,eACjC,MAAM,IAAI,SACR,0FAA0F,KAAK,UAAU,OAAO,SAAS,EAC3H;EAEJ;EAEA,MAAwB;GACtB,IAAI,KAAK,mBAAmB,KAAA,GAC1B,MAAM,IAAI,SACR,qGACF;GAEF,OAAO,OAAO,KAAK,cAAc;EACnC;CACF;;CAEO,eAAe,iBACpB,WAC8B;EAC9B,MAAM,QAAkB,MAAM,GAAG,SAAS,QAAQ,SAAS;EAC3D,MAAM,UAAuB,IAAI,IAAI,KAAK;EAC1C,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,YAAgC,cAAc,IAAI;GACxD,IAAI,cAAc,KAAA,GAAW;GAC7B,IAAI,QAAQ,IAAI,SAAS,GAAG,OAAO;GACnC,IAAI;IACF,MAAM,GAAG,SAAS,MAAM,KAAK,KAAK,WAAW,SAAS,CAAC;IACvD,OAAO;GACT,SAAS,OAAO;IACd,IAAI,mBAAmB,KAAK,GAAG,OAAO;IACtC,MAAM;GACR;EACF;CAEF;;CAEO,eAAe,eAAe,WAAqC;EACxE,MAAM,YAAiC,MAAM,iBAAiB,SAAS;EACvE,IAAI,cAAc,KAAA,GAAW,OAAO;EAEpC,KAAK,IAAI,UAAU,GAAG,UAAU,IAAI,EAAE,SAAS;GAC7C,MAAM,OACJ,qBAAqB,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAC5D,SAAS,EAAE,CAAC,CACZ,MAAM,CAAC,IAAI,YAAY;GAC5B,MAAM,WAAmB,KAAK,KAAK,WAAW,IAAI;GAClD,MAAM,YAAoB,KAAK,KAAK,WAAW,KAAK,YAAY,CAAC;GACjE,IAAI;GACJ,IAAI;IACF,SAAS,MAAM,GAAG,SAAS,KAAK,UAAU,IAAI;GAChD,SAAS,OAAO;IACd,IAAI,qBAAqB,KAAK,GAAG;IACjC,MAAM,IAAI,SACR,wFAAwF,UAAU,IAAI,mBAAmB,KAAK,GAChI;GACF;GACA,IAAI,SAAkB;GACtB,IAAI;IACF,MAAM,OAAO,MAAM;IACnB,SAAS;IACT,IAAI;KACF,MAAM,GAAG,SAAS,MAAM,SAAS;KACjC,OAAO;IACT,SAAS,OAAO;KACd,IAAI,mBAAmB,KAAK,GAAG,OAAO;KACtC,MAAM;IACR;GACF,UAAU;IACR,IAAI;IACJ,IAAI,WAAW,OACb,IAAI;KACF,MAAM,OAAO,MAAM;IACrB,SAAS,OAAO;KACd,eAAe;IACjB;IAEF,IAAI;KACF,MAAM,GAAG,SAAS,OAAO,QAAQ;IACnC,SAAS,OAAO;KACd,IAAI,mBAAmB,KAAK,MAAM,OAAO,iBAAiB;IAC5D;IACA,IAAI,iBAAiB,KAAA,GACnB,MAAM,IAAI,SACR,kFAAkF,SAAS,IAAI,mBAAmB,YAAY,GAChI;GAEJ;EACF;EACA,MAAM,IAAI,SACR,yFAAyF,UAAU,EACrG;CACF;;CAuBO,SAAS,YACd,MACA,UACQ;EAIR,OAAO,KAAK,QAAQ,OAAO,CAAC,IACxB,QAAQ,KAAK,UAAU,QAAQ,MAC/B,SAAS,KAAK,IAAI,GAAG,KAAK;CAChC;;CAEA,SAAS,cAAc,MAAkC;EACvD,IAAI,UAAmB;EACvB,IAAI,SAAiB;EACrB,KAAK,MAAM,aAAa,MACtB,IAAI,aAAa,OAAO,aAAa,KAAK;GACxC,UAAU,UAAU,YAAY;GAChC,UAAU;EACZ,OAAO,IAAI,aAAa,OAAO,aAAa,KAAK;GAC/C,UAAU,UAAU,YAAY;GAChC,UAAU;EACZ,OAAO,UAAU;EAEnB,OAAO,UAAU,SAAS,KAAA;CAC5B;CAEA,SAAS,qBAAqB,OAAyB;EACrD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS;CAEnB;CAEA,SAAS,mBAAmB,OAAyB;EACnD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS;CAEnB;CAEA,SAAS,mBAAmB,OAAwB;EAClD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CAC9D;GACD,uBAAA,qBAAA,CAAA,EAAD;AAEA,MAAM,aAAa;AACnB,MAAM,cAAc"}