isaacscript 3.16.0 → 3.16.1-dev.0

package/dist/checkForWindowsTerminalBugs.js

@@ -0,0 +1,57 @@
+import chalk from "chalk";
+import { appendFile, isFile, readFile } from "isaacscript-common-node";
+import path from "node:path";
+import { HOME_DIR, PROJECT_NAME } from "./constants.js";
+import { getInputYesNo } from "./prompt.js";
+const BASH_PROFILE_PATH = path.join(HOME_DIR, ".bash_profile");
+/**
+ * By default, Git Bash for Windows uses MINGW64. This will not work correctly with the prompt
+ * library. Try to detect this and warn the end-user.
+ */
+export async function checkForWindowsTerminalBugs() {
+    if (process.platform !== "win32") {
+        return;
+    }
+    if (process.env["SHELL"] !== "C:\\Program Files\\Git\\usr\\bin\\bash.exe") {
+        return;
+    }
+    await checkForWindowsBugColor();
+}
+async function checkForWindowsBugColor() {
+    if (process.env["FORCE_COLOR"] === "true") {
+        return;
+    }
+    console.error(chalk.red(`Error: It looks like you are using Git Bash for Windows (MINGW64) without the "${chalk.green("FORCE_COLOR")}" environment variable.`));
+    console.error("This is necessary in order for colors to work properly in the terminal.");
+    const shouldFixColors = await getInputYesNo("Do you want me to fix this for you?");
+    if (!shouldFixColors) {
+        return;
+    }
+    applyFixesToBashProfile();
+}
+function applyFixesToBashProfile() {
+    // Check to see if the Bash profile has data.
+    const bashProfileContents = isFile(BASH_PROFILE_PATH)
+        ? readFile(BASH_PROFILE_PATH)
+        : "";
+    const appendText = getBashProfileAppendText(bashProfileContents);
+    appendFile(BASH_PROFILE_PATH, appendText);
+    console.log(`The terminal fixes have been added to: ${chalk.green(BASH_PROFILE_PATH)}`, chalk.red("Please close and re-open your terminal, then run this program again."));
+    process.exit(0);
+}
+function getBashProfileAppendText(bashProfileContents) {
+    let newText = "";
+    if (bashProfileContents !== "" && !bashProfileContents.endsWith("\n")) {
+        // If the Bash profile exists and has data, it should end in a newline. Add an extra newline if
+        // this is not the case.
+        newText += "\n";
+    }
+    if (bashProfileContents !== "") {
+        // If the Bash profile exists and has data, add an extra newline between the existing stuff and
+        // the new lines added by us.
+        newText += "\n";
+    }
+    newText += `# Terminal fixes added by ${PROJECT_NAME}\n`;
+    newText += "export FORCE_COLOR=true\n";
+    return newText;
+}

package/{src → dist}/classes/Config.js

@@ -1,11 +1,8 @@
-"use strict";
 // - Note that all mandatory properties must be explicitly validated in `configFile.ts`.
 // - The types are explicitly annotated to work around a bug in `ts-json-schema-generator`:
 // https://github.com/vega/ts-json-schema-generator/issues/1531
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Config = void 0;
 /** This is the format for the "isaacscript.json" file. */
-class Config {
+export class Config {
     // Marked as public to disable `knip` warnings.
     /** @public */
     $schema = "https://raw.githubusercontent.com/IsaacScript/isaacscript/main/packages/isaacscript-cli/schemas/isaacscript-schema.json";
@@ -41,5 +38,3 @@ class Config {
         }
     }
 }
-exports.Config = Config;
-//# sourceMappingURL=Config.js.map

package/dist/classes/ValidatedConfig.js

@@ -0,0 +1 @@
+export {};

package/{src → dist}/commands/check/check.js

@@ -1,16 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTruncatedText = exports.check = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const klaw_sync_1 = tslib_1.__importDefault(require("klaw-sync"));
-const node_path_1 = tslib_1.__importDefault(require("node:path"));
-const constants_js_1 = require("../../constants.js");
-const PackageManager_js_1 = require("../../enums/PackageManager.js");
-const exec_js_1 = require("../../exec.js");
-const file_js_1 = require("../../file.js");
-const isaacScriptCommonTS_js_1 = require("../../isaacScriptCommonTS.js");
-const packageManager_js_1 = require("../../packageManager.js");
+import chalk from "chalk";
+import { PACKAGE_MANAGER_LOCK_FILE_NAMES, PackageManager, deleteFileOrDirectory, fatalError, isDirectory, isFile, readFile, writeFile, } from "isaacscript-common-node";
+import { ReadonlySet, getEnumValues, trimPrefix } from "isaacscript-common-ts";
+import klawSync from "klaw-sync";
+import path from "node:path";
+import { ACTION_YML, ACTION_YML_TEMPLATE_PATH, CWD, TEMPLATES_DIR, TEMPLATES_DYNAMIC_DIR, TEMPLATES_STATIC_DIR, YARNRC_TEMPLATE_PATH, YARNRC_YML, } from "../../constants.js";
+import { execShell } from "../../exec.js";
+import { getPackageManagerUsedForExistingProject } from "../../packageManager.js";
 const URL_PREFIX = "https://raw.githubusercontent.com/IsaacScript/isaacscript/main/packages/isaacscript-cli/file-templates";
 const MARKER_CUSTOMIZATION_START = "@template-customization-start";
 const MARKER_CUSTOMIZATION_END = "@template-customization-end";
@@ -21,23 +16,23 @@ const PACKAGE_MANAGER_STRINGS = [
     "PACKAGE_MANAGER_NAME",
     "PACKAGE_MANAGER_INSTALL_COMMAND",
     "PACKAGE_MANAGER_LOCK_FILE_NAME",
-    ...(0, isaacScriptCommonTS_js_1.getEnumValues)(PackageManager_js_1.PackageManager),
-    ...(0, packageManager_js_1.getAllPackageManagerLockFileNames)(),
+    ...getEnumValues(PackageManager),
+    ...PACKAGE_MANAGER_LOCK_FILE_NAMES,
 ];
-function check(args, typeScript) {
+export function check(args, typeScript) {
     const ignore = args.ignore ?? "";
     const verbose = args.verbose === true;
-    const packageManager = (0, packageManager_js_1.getPackageManagerUsedForExistingProject)(args, verbose);
+    const packageManager = getPackageManagerUsedForExistingProject(args);
     let oneOrMoreErrors = false;
     const ignoreFileNames = ignore.split(",");
-    const ignoreFileNamesSet = new isaacScriptCommonTS_js_1.ReadonlySet(ignoreFileNames);
+    const ignoreFileNamesSet = new ReadonlySet(ignoreFileNames);
     // First, check the static files that are shared between TypeScript projects and IsaacScript mods.
-    if (checkTemplateDirectory(constants_js_1.TEMPLATES_STATIC_DIR, ignoreFileNamesSet, verbose)) {
+    if (checkTemplateDirectory(TEMPLATES_STATIC_DIR, ignoreFileNamesSet, verbose)) {
         oneOrMoreErrors = true;
     }
     // Second, check the files that are specific to either a TypeScript project or an IsaacScript mod.
     const staticDirSuffix = typeScript ? "ts" : "mod";
-    const staticDirPath = node_path_1.default.join(constants_js_1.TEMPLATES_DIR, `static-${staticDirSuffix}`);
+    const staticDirPath = path.join(TEMPLATES_DIR, `static-${staticDirSuffix}`);
     if (checkTemplateDirectory(staticDirPath, ignoreFileNamesSet, verbose)) {
         oneOrMoreErrors = true;
     }
@@ -46,39 +41,38 @@ function check(args, typeScript) {
         oneOrMoreErrors = true;
     }
     if (oneOrMoreErrors) {
-        (0, isaacScriptCommonTS_js_1.fatalError)("The check command failed.");
+        fatalError("The check command failed.");
     }
 }
-exports.check = check;
 function checkTemplateDirectory(templateDirectory, ignoreFileNamesSet, verbose) {
     let oneOrMoreErrors = false;
-    for (const klawItem of (0, klaw_sync_1.default)(templateDirectory)) {
+    for (const klawItem of klawSync(templateDirectory)) {
         const templateFilePath = klawItem.path;
-        if ((0, file_js_1.isDir)(templateFilePath, verbose)) {
+        if (isDirectory(templateFilePath)) {
             continue;
         }
-        const originalFileName = node_path_1.default.basename(templateFilePath);
+        const originalFileName = path.basename(templateFilePath);
         if (originalFileName === "main.ts") {
             continue;
         }
-        const relativeTemplateFilePath = node_path_1.default.relative(templateDirectory, templateFilePath);
-        const templateFileName = node_path_1.default.basename(relativeTemplateFilePath);
-        let projectFilePath = node_path_1.default.join(constants_js_1.CWD, relativeTemplateFilePath);
+        const relativeTemplateFilePath = path.relative(templateDirectory, templateFilePath);
+        const templateFileName = path.basename(relativeTemplateFilePath);
+        let projectFilePath = path.join(CWD, relativeTemplateFilePath);
         switch (templateFileName) {
             case "_eslintrc.cjs": {
-                projectFilePath = node_path_1.default.join(projectFilePath, "..", ".eslintrc.cjs");
+                projectFilePath = path.join(projectFilePath, "..", ".eslintrc.cjs");
                 break;
             }
-            case "_cspell.json": {
-                projectFilePath = node_path_1.default.join(projectFilePath, "..", "cspell.json");
+            case "_cspell.jsonc": {
+                projectFilePath = path.join(projectFilePath, "..", "cspell.jsonc");
                 break;
             }
             case "_gitattributes": {
-                projectFilePath = node_path_1.default.join(projectFilePath, "..", ".gitattributes");
+                projectFilePath = path.join(projectFilePath, "..", ".gitattributes");
                 break;
             }
         }
-        const projectFileName = node_path_1.default.basename(projectFilePath);
+        const projectFileName = path.basename(projectFilePath);
         if (ignoreFileNamesSet.has(projectFileName)) {
             continue;
         }
@@ -90,19 +84,19 @@ function checkTemplateDirectory(templateDirectory, ignoreFileNamesSet, verbose)
 }
 function checkIndividualFiles(ignoreFileNamesSet, packageManager, verbose) {
     let oneOrMoreErrors = false;
-    if (!ignoreFileNamesSet.has(constants_js_1.CI_YML)) {
-        const templateFilePath = constants_js_1.CI_YML_TEMPLATE_PATH;
-        const relativeTemplateFilePath = node_path_1.default.relative(constants_js_1.TEMPLATES_DYNAMIC_DIR, templateFilePath);
-        const projectFilePath = node_path_1.default.join(constants_js_1.CWD, relativeTemplateFilePath);
+    if (!ignoreFileNamesSet.has(ACTION_YML)) {
+        const templateFilePath = ACTION_YML_TEMPLATE_PATH;
+        const relativeTemplateFilePath = path.relative(TEMPLATES_DYNAMIC_DIR, templateFilePath);
+        const projectFilePath = path.join(CWD, relativeTemplateFilePath);
         if (!compareTextFiles(projectFilePath, templateFilePath, verbose)) {
             oneOrMoreErrors = true;
         }
     }
-    if (packageManager === PackageManager_js_1.PackageManager.yarn &&
-        !ignoreFileNamesSet.has(constants_js_1.YARNRC_YML)) {
-        const templateFilePath = constants_js_1.YARNRC_TEMPLATE_PATH;
-        const relativeTemplateFilePath = node_path_1.default.relative(constants_js_1.TEMPLATES_DYNAMIC_DIR, templateFilePath);
-        const projectFilePath = node_path_1.default.join(constants_js_1.CWD, relativeTemplateFilePath);
+    if (packageManager === PackageManager.yarn &&
+        !ignoreFileNamesSet.has(YARNRC_YML)) {
+        const templateFilePath = YARNRC_TEMPLATE_PATH;
+        const relativeTemplateFilePath = path.relative(TEMPLATES_DYNAMIC_DIR, templateFilePath);
+        const projectFilePath = path.join(CWD, relativeTemplateFilePath);
         if (!compareTextFiles(projectFilePath, templateFilePath, verbose)) {
             oneOrMoreErrors = true;
         }
@@ -111,21 +105,21 @@ function checkIndividualFiles(ignoreFileNamesSet, packageManager, verbose) {
 }
 /** @returns Whether the project file is valid in reference to the template file. */
 function compareTextFiles(projectFilePath, templateFilePath, verbose) {
-    if (!(0, file_js_1.fileExists)(projectFilePath, verbose)) {
+    if (!isFile(projectFilePath)) {
         console.log(`Failed to find the following file: ${projectFilePath}`);
         printTemplateLocation(templateFilePath);
         return false;
     }
-    const projectFileObject = getTruncatedFileText(projectFilePath, new Set(), new Set(), verbose);
-    const templateFileObject = getTruncatedFileText(templateFilePath, projectFileObject.ignoreLines, projectFileObject.linesBeforeIgnore, verbose);
+    const projectFileObject = getTruncatedFileText(projectFilePath, new Set(), new Set());
+    const templateFileObject = getTruncatedFileText(templateFilePath, projectFileObject.ignoreLines, projectFileObject.linesBeforeIgnore);
     if (projectFileObject.text === templateFileObject.text) {
         return true;
     }
-    console.log(`The contents of the following file do not match: ${chalk_1.default.red(projectFilePath)}`);
+    console.log(`The contents of the following file do not match: ${chalk.red(projectFilePath)}`);
     printTemplateLocation(templateFilePath);
     if (verbose) {
-        const originalTemplateFile = (0, file_js_1.readFile)(templateFilePath, verbose);
-        const originalProjectFile = (0, file_js_1.readFile)(projectFilePath, verbose);
+        const originalTemplateFile = readFile(templateFilePath);
+        const originalProjectFile = readFile(projectFilePath);
         console.log("--- Original template file: ---\n");
         console.log(originalTemplateFile);
         console.log();
@@ -139,19 +133,19 @@ function compareTextFiles(projectFilePath, templateFilePath, verbose) {
         console.log(projectFileObject.text);
         console.log();
     }
-    const tempProjectFilePath = node_path_1.default.join(constants_js_1.CWD, "tempProjectFile.txt");
-    const tempTemplateFilePath = node_path_1.default.join(constants_js_1.CWD, "tempTemplateFile.txt");
-    (0, file_js_1.writeFile)(tempProjectFilePath, projectFileObject.text, verbose);
-    (0, file_js_1.writeFile)(tempTemplateFilePath, templateFileObject.text, verbose);
-    const { stdout } = (0, exec_js_1.execShell)("diff", [tempProjectFilePath, tempTemplateFilePath, "--ignore-blank-lines"], verbose, true);
+    const tempProjectFilePath = path.join(CWD, "tempProjectFile.txt");
+    const tempTemplateFilePath = path.join(CWD, "tempTemplateFile.txt");
+    writeFile(tempProjectFilePath, projectFileObject.text);
+    writeFile(tempTemplateFilePath, templateFileObject.text);
+    const { stdout } = execShell("diff", [tempProjectFilePath, tempTemplateFilePath, "--ignore-blank-lines"], verbose, true);
     console.log(`${stdout}\n`);
-    (0, file_js_1.deleteFileOrDirectory)(tempProjectFilePath, verbose);
-    (0, file_js_1.deleteFileOrDirectory)(tempTemplateFilePath, verbose);
+    deleteFileOrDirectory(tempProjectFilePath);
+    deleteFileOrDirectory(tempTemplateFilePath);
     return false;
 }
-function getTruncatedFileText(filePath, ignoreLines, linesBeforeIgnore, verbose) {
-    const fileName = node_path_1.default.basename(filePath);
-    const fileContents = (0, file_js_1.readFile)(filePath, verbose);
+function getTruncatedFileText(filePath, ignoreLines, linesBeforeIgnore) {
+    const fileName = path.basename(filePath);
+    const fileContents = readFile(filePath);
     return getTruncatedText(fileName, fileContents, ignoreLines, linesBeforeIgnore);
 }
 /**
@@ -163,7 +157,7 @@ function getTruncatedFileText(filePath, ignoreLines, linesBeforeIgnore, verbose)
  *          markers (and other specific hard-coded exclusions), as well as an array of lines that
  *          had a "ignore-next-line" marker below them.
  */
-function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
+export function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
     const lines = text.split("\n");
     const newLines = [];
     const newIgnoreLines = new Set();
@@ -212,7 +206,7 @@ function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
             continue;
         }
         if (isIgnoring) {
-            const baseLine = (0, isaacScriptCommonTS_js_1.trimPrefix)(line.trim(), "// ");
+            const baseLine = trimPrefix(line.trim(), "// ");
             newIgnoreLines.add(baseLine);
             continue;
         }
@@ -220,7 +214,7 @@ function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
         // Specific file checks
         // --------------------
         // End-users can have different ignored words.
-        if (fileName === "cspell.json" || fileName === "_cspell.json") {
+        if (fileName === "cspell.jsonc" || fileName === "_cspell.jsonc") {
             if (line.match(/"words": \[.*]/) !== null) {
                 continue;
             }
@@ -233,12 +227,12 @@ function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
                 continue;
             }
         }
-        if (fileName === "ci.yml") {
+        if (fileName === "ci.yml" || fileName === "action.yml") {
             // End-users can have different package managers.
             if (hasPackageManagerString(line)) {
                 continue;
             }
-            // Ignore comments, since end-users are expected to delete the explanation.
+            // Ignore comments, since end-users are expected to delete the explanations.
             if (line.match(/^\s*#/) !== null) {
                 continue;
             }
@@ -258,17 +252,15 @@ function getTruncatedText(fileName, text, ignoreLines, linesBeforeIgnore) {
         linesBeforeIgnore: newLinesBeforeIgnore,
     };
 }
-exports.getTruncatedText = getTruncatedText;
 function printTemplateLocation(templateFilePath) {
-    const unixPath = templateFilePath.split(node_path_1.default.sep).join(node_path_1.default.posix.sep);
+    const unixPath = templateFilePath.split(path.sep).join(path.posix.sep);
     const match = unixPath.match(/.+\/file-templates\/(?<urlSuffix>.+)/);
     if (match === null || match.groups === undefined) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`Failed to parse the template file path: ${templateFilePath}`);
+        fatalError(`Failed to parse the template file path: ${templateFilePath}`);
     }
     const { urlSuffix } = match.groups;
-    console.log(`You can find the template at: ${chalk_1.default.green(`${URL_PREFIX}/${urlSuffix}`)}\n`);
+    console.log(`You can find the template at: ${chalk.green(`${URL_PREFIX}/${urlSuffix}`)}\n`);
 }
 function hasPackageManagerString(line) {
     return PACKAGE_MANAGER_STRINGS.some((string) => line.includes(string));
 }
-//# sourceMappingURL=check.js.map

package/dist/commands/check/check.test.js

@@ -0,0 +1,86 @@
+import { strictEqual } from "node:assert";
+import test from "node:test";
+import { getTruncatedText } from "./check.js";
+test("no markers", () => {
+    const templateText = `
+line 1
+line 2
+line 3
+`.trim();
+    const { text } = getTruncatedText("test", templateText, new Set(), new Set());
+    strictEqual(text, templateText);
+});
+test("customization marker", () => {
+    const templateText = `
+line 1
+@template-customization-start
+line 2
+@template-customization-end
+line 3
+  `.trim();
+    const expectedTemplateText = `
+line 1
+line 3
+  `.trim();
+    const { text } = getTruncatedText("test", templateText, new Set(), new Set());
+    strictEqual(text, expectedTemplateText);
+});
+test("ignore block marker part 1", () => {
+    const templateText = `
+line 1
+@template-ignore-block-start
+// line 2
+@template-ignore-block-end
+line 3
+  `.trim();
+    const parsedTemplateText = `
+line 1
+line 3
+  `.trim();
+    const { text, ignoreLines } = getTruncatedText("test", templateText, new Set(), new Set());
+    strictEqual(text, parsedTemplateText);
+    strictEqual(ignoreLines.size, 1);
+    strictEqual([...ignoreLines][0], "line 2");
+});
+test("ignore block marker part 2", () => {
+    const templateText = `
+line 1
+line 2
+line 3
+  `.trim();
+    const expectedTemplateText = `
+line 1
+line 3
+  `.trim();
+    const { text } = getTruncatedText("test", templateText, new Set(["line 2"]), new Set());
+    strictEqual(text, expectedTemplateText);
+});
+test("ignore next line part 1", () => {
+    const templateText = `
+line 1
+@template-ignore-next-line
+line 2
+line 3
+  `.trim();
+    const expectedTemplateText = `
+line 1
+line 3
+  `.trim();
+    const { text, linesBeforeIgnore } = getTruncatedText("test", templateText, new Set(), new Set());
+    strictEqual(linesBeforeIgnore.size, 1);
+    strictEqual([...linesBeforeIgnore][0], "line 1");
+    strictEqual(text, expectedTemplateText);
+});
+test("ignore next line part 2", () => {
+    const templateText = `
+line 1
+line 2
+line 3
+  `.trim();
+    const expectedTemplateText = `
+line 1
+line 3
+  `.trim();
+    const { text } = getTruncatedText("test", templateText, new Set(), new Set(["line 1"]));
+    strictEqual(text, expectedTemplateText);
+});

package/dist/commands/copy/copy.js

@@ -0,0 +1,29 @@
+import { copyFileOrDirectory, deleteFileOrDirectory, getPackageManagerExecCommand, } from "isaacscript-common-node";
+import path from "node:path";
+import { MOD_SOURCE_PATH } from "../../constants.js";
+import { prepareCustomStages } from "../../customStage.js";
+import { execShellString } from "../../exec.js";
+import { getPackageManagerUsedForExistingProject } from "../../packageManager.js";
+import { getModTargetDirectoryName } from "../../utils.js";
+export async function copy(args, config) {
+    const verbose = args.verbose === true;
+    const packageManager = getPackageManagerUsedForExistingProject(args);
+    const modTargetDirectoryName = getModTargetDirectoryName(config);
+    const modTargetPath = path.join(config.modsDirectory, modTargetDirectoryName);
+    await compileAndCopy(MOD_SOURCE_PATH, modTargetPath, packageManager, verbose);
+}
+export async function compileAndCopy(modSourcePath, modTargetPath, packageManager, verbose) {
+    await prepareCustomStages(packageManager, verbose);
+    compile(packageManager, verbose);
+    copyMod(modSourcePath, modTargetPath);
+}
+function compile(packageManager, verbose) {
+    const command = getPackageManagerExecCommand(packageManager);
+    execShellString(`${command} tstl`, verbose);
+    console.log("Mod compiled successfully.");
+}
+function copyMod(modSourcePath, modTargetPath) {
+    deleteFileOrDirectory(modTargetPath);
+    copyFileOrDirectory(modSourcePath, modTargetPath);
+    console.log("Mod copied successfully.");
+}

package/dist/commands/init/checkIfProjectPathExists.js

@@ -0,0 +1,21 @@
+import chalk from "chalk";
+import { deleteFileOrDirectory, fatalError, fileOrDirectoryExists, isDirectory, } from "isaacscript-common-node";
+import { CWD } from "../../constants.js";
+import { getInputYesNo } from "../../prompt.js";
+export async function checkIfProjectPathExists(projectPath, yes) {
+    if (projectPath === CWD || !fileOrDirectoryExists(projectPath)) {
+        return;
+    }
+    const fileType = isDirectory(projectPath) ? "directory" : "file";
+    if (yes) {
+        deleteFileOrDirectory(projectPath);
+        console.log(`Deleted ${fileType}: ${chalk.green(projectPath)}`);
+        return;
+    }
+    console.log(`A ${fileType} already exists with a name of: ${chalk.green(projectPath)}`);
+    const shouldDelete = await getInputYesNo("Do you want me to delete it?");
+    if (!shouldDelete) {
+        fatalError("Ok then. Goodbye.");
+    }
+    deleteFileOrDirectory(projectPath);
+}

package/dist/commands/init/checkModSubdirectory.js

@@ -0,0 +1,9 @@
+import chalk from "chalk";
+import { fatalError, isSubdirectoryOf } from "isaacscript-common-node";
+import { CWD } from "../../constants.js";
+export function checkModSubdirectory(projectPath, modsDirectory) {
+    if (isSubdirectoryOf(CWD, modsDirectory)) {
+        console.error(`Error: The project directory of "${chalk.green(projectPath)}" is a subdirectory of "${chalk.green(modsDirectory)}".`);
+        fatalError('You are supposed to have your project folder somewhere else on the system than the Isaac mods directory. (This is because we don\'t want to upload the ".git" folder or the TypeScript files to the Steam Workshop.) Exiting.');
+    }
+}

package/dist/commands/init/checkModTargetDirectory.js

@@ -0,0 +1,24 @@
+import chalk from "chalk";
+import { deleteFileOrDirectory, fatalError, fileOrDirectoryExists, isDirectory, } from "isaacscript-common-node";
+import path from "node:path";
+import { PROJECT_NAME } from "../../constants.js";
+import { getInputYesNo } from "../../prompt.js";
+export async function checkModTargetDirectory(modsDirectory, projectName, yes) {
+    const modTargetPath = path.join(modsDirectory, projectName);
+    if (!fileOrDirectoryExists(modTargetPath)) {
+        return;
+    }
+    const fileType = isDirectory(modTargetPath) ? "directory" : "file";
+    if (yes) {
+        deleteFileOrDirectory(modTargetPath);
+        console.log(`Deleted ${fileType}: ${chalk.green(modTargetPath)}`);
+        return;
+    }
+    console.log(`A ${fileType} already exists at at the mod path of: ${chalk.green(modTargetPath)}`);
+    console.log(`${PROJECT_NAME} will need to sync your project folder with this directory.`);
+    const shouldDelete = await getInputYesNo("Do you want me to delete it?");
+    if (!shouldDelete) {
+        fatalError("Ok then. Goodbye.");
+    }
+    deleteFileOrDirectory(modTargetPath);
+}