isaacscript 3.16.0 → 3.16.1-dev.0

package/dist/dev.js

@@ -0,0 +1,10 @@
+import { fatalError, isDirectory } from "isaacscript-common-node";
+import path from "node:path";
+export function getAndValidateIsaacScriptMonorepoDirectory(projectPath) {
+    const isaacScriptMonorepoDirectory = path.join(projectPath, "..", "isaacscript");
+    if (!isDirectory(isaacScriptMonorepoDirectory)) {
+        console.error(`Failed to find the IsaacScript repository at: ${isaacScriptMonorepoDirectory}`);
+        fatalError("In order to link a development version of IsaacScript common, you must place the repositories side by side. (If you do not already have the IsaacScript repository cloned, then you need to fork the repo and then clone your fork.)");
+    }
+    return isaacScriptMonorepoDirectory;
+}

package/{src/enums → dist/enums/copied}/DoorSlot.js

@@ -1,7 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DoorSlot = void 0;
-var DoorSlot;
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaac-typescript-definitions" package.
+/// DO NOT EDIT THIS FILE!
+export var DoorSlot;
 (function (DoorSlot) {
     DoorSlot[DoorSlot["NO_DOOR_SLOT"] = -1] = "NO_DOOR_SLOT";
     /** In a normal room, the left door. In a 2x2 room, the uppermost door on the left side. */
@@ -20,5 +20,4 @@ var DoorSlot;
     DoorSlot[DoorSlot["RIGHT_1"] = 6] = "RIGHT_1";
     /** In a 2x2 room, the rightmost door on the bottom side. */
     DoorSlot[DoorSlot["DOWN_1"] = 7] = "DOWN_1";
-})(DoorSlot || (exports.DoorSlot = DoorSlot = {}));
-//# sourceMappingURL=DoorSlot.js.map
+})(DoorSlot || (DoorSlot = {}));

package/dist/enums/copied/DoorSlotFlag.js

@@ -0,0 +1,35 @@
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaac-typescript-definitions" package.
+/// DO NOT EDIT THIS FILE!
+/* eslint-disable no-bitwise */
+import { DoorSlot } from "./DoorSlot.js";
+/**
+ * For `GridEntityType.DOOR` (16).
+ *
+ * This is represented as an object instead of an enum due to limitations with TypeScript enums. (We
+ * want this type to be a child of the `BitFlag` type.)
+ *
+ * @enum
+ * @notExported
+ * @rename DoorSlotFlag
+ */
+const DoorSlotFlagInternal = {
+    /** 1 << 0 (1) */
+    LEFT_0: 1 << DoorSlot.LEFT_0,
+    /** 1 << 1 (2) */
+    UP_0: 1 << DoorSlot.UP_0,
+    /** 1 << 2 (4) */
+    RIGHT_0: 1 << DoorSlot.RIGHT_0,
+    /** 1 << 3 (8) */
+    DOWN_0: 1 << DoorSlot.DOWN_0,
+    /** 1 << 4 (16) */
+    LEFT_1: 1 << DoorSlot.LEFT_1,
+    /** 1 << 5 (32) */
+    UP_1: 1 << DoorSlot.UP_1,
+    /** 1 << 6 (64) */
+    RIGHT_1: 1 << DoorSlot.RIGHT_1,
+    /** 1 << 7 (128) */
+    DOWN_1: 1 << DoorSlot.DOWN_1,
+};
+export const DoorSlotFlag = DoorSlotFlagInternal;
+export const DoorSlotFlagZero = 0;

package/{src/enums → dist/enums/copied}/RoomShape.js

@@ -1,7 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RoomShape = void 0;
-var RoomShape;
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaac-typescript-definitions" package.
+/// DO NOT EDIT THIS FILE!
+export var RoomShape;
 (function (RoomShape) {
     /**
      * A "normal" room.
@@ -43,5 +43,4 @@ var RoomShape;
     RoomShape[RoomShape["LBL"] = 11] = "LBL";
     /** Looks like a "Г" with a gap in the bottom-right-hand corner. */
     RoomShape[RoomShape["LBR"] = 12] = "LBR";
-})(RoomShape || (exports.RoomShape = RoomShape = {}));
-//# sourceMappingURL=RoomShape.js.map
+})(RoomShape || (RoomShape = {}));

package/{src → dist}/exec.js

@@ -1,52 +1,46 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execShell = exports.execShellString = exports.execPowershell = exports.execExe = void 0;
-const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const node_child_process_1 = require("node:child_process");
-const constants_js_1 = require("./constants.js");
-const isaacScriptCommonTS_js_1 = require("./isaacScriptCommonTS.js");
-function execExe(path, args, verbose, cwd = constants_js_1.CWD) {
+import chalk from "chalk";
+import { fatalError } from "isaacscript-common-node";
+import { execFileSync, execSync, spawnSync } from "node:child_process";
+import { CWD } from "./constants.js";
+export function execExe(path, args, verbose, cwd = CWD) {
     if (verbose) {
         console.log(`Executing binary: ${path}`);
     }
     let stdout;
     try {
-        const buffer = (0, node_child_process_1.execFileSync)(path, args, {
+        const buffer = execFileSync(path, args, {
             cwd,
         });
         stdout = buffer.toString().trim();
     }
     catch (error) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`Failed to run "${chalk_1.default.green(path)}":`, error);
+        fatalError(`Failed to run "${chalk.green(path)}":`, error);
     }
     if (verbose) {
         console.log(`Executed binary: ${path}`);
     }
     return stdout;
 }
-exports.execExe = execExe;
-function execPowershell(command, verbose = false, cwd = constants_js_1.CWD) {
+export function execPowershell(command, verbose = false, cwd = CWD) {
     if (verbose) {
         console.log(`Executing PowerShell command: ${command}`);
     }
     let stdout;
     try {
-        const buffer = (0, node_child_process_1.execSync)(command, {
+        const buffer = execSync(command, {
             shell: "powershell.exe",
             cwd,
         });
         stdout = buffer.toString().trim();
     }
     catch (error) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`Failed to run PowerShell command "${chalk_1.default.green(command)}":`, error);
+        fatalError(`Failed to run PowerShell command "${chalk.green(command)}":`, error);
     }
     if (verbose) {
         console.log(`Executed PowerShell command: ${command}`);
     }
     return stdout;
 }
-exports.execPowershell = execPowershell;
 /**
  * Same as `execShell`, but accepts the command as a string instead of an array of arguments.
  *
@@ -55,15 +49,14 @@ exports.execPowershell = execPowershell;
  * @param allowFailure Default is false.
  * @param cwd Default is CWD.
  */
-function execShellString(commandString, verbose = false, allowFailure = false, cwd = constants_js_1.CWD) {
+export function execShellString(commandString, verbose = false, allowFailure = false, cwd = CWD) {
     const args = commandString.split(" ");
     const command = args.shift();
     if (command === undefined) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`execShellString failed to parse the command of: ${commandString}`);
+        fatalError(`execShellString failed to parse the command of: ${commandString}`);
     }
     return execShell(command, args, verbose, allowFailure, cwd);
 }
-exports.execShellString = execShellString;
 /**
  * Returns a tuple of exit status and stdout. The stdout is trimmed for convenience.
  *
@@ -73,15 +66,15 @@ exports.execShellString = execShellString;
  * @param allowFailure Default is false.
  * @param cwd Default is CWD.
  */
-function execShell(command, args = [], verbose = false, allowFailure = false, cwd = constants_js_1.CWD) {
+export function execShell(command, args = [], verbose = false, allowFailure = false, cwd = CWD) {
     // On Windows, "spawnSync()" will not account for spaces in arguments. Thus, wrap everything in a
     // double quote. This will cause arguments that naturally have double quotes to fail.
     if (command.includes("''") || command.includes('"')) {
-        (0, isaacScriptCommonTS_js_1.fatalError)("execShell cannot execute commands with single quotes or double quotes in the command.");
+        fatalError("execShell cannot execute commands with single quotes or double quotes in the command.");
     }
     const argsHasDoubleQuotes = args.some((arg) => arg.includes('"'));
     if (argsHasDoubleQuotes) {
-        (0, isaacScriptCommonTS_js_1.fatalError)("execShell cannot execute commands with double quotes in the arguments.");
+        fatalError("execShell cannot execute commands with double quotes in the arguments.");
     }
     const quotedArgs = args.map((arg) => `"${arg}"`);
     const commandDescription = `${command} ${quotedArgs.join(" ")}`.trim();
@@ -90,32 +83,30 @@ function execShell(command, args = [], verbose = false, allowFailure = false, cw
     }
     let spawnSyncReturns;
     try {
-        spawnSyncReturns = (0, node_child_process_1.spawnSync)(command, quotedArgs, {
+        spawnSyncReturns = spawnSync(command, quotedArgs, {
             shell: true,
             cwd,
         });
     }
     catch (error) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`Failed to run the "${chalk_1.default.green(commandDescription)}" command:`, error);
+        fatalError(`Failed to run the "${chalk.green(commandDescription)}" command:`, error);
     }
     if (verbose) {
         console.log(`Executed command: ${commandDescription}`);
     }
     const exitStatus = spawnSyncReturns.status;
     if (exitStatus === null) {
-        (0, isaacScriptCommonTS_js_1.fatalError)(`Failed to get the return status of command: ${commandDescription}`);
+        fatalError(`Failed to get the return status of command: ${commandDescription}`);
     }
     const stdout = spawnSyncReturns.output.join("\n").trim();
     if (exitStatus !== 0) {
         if (allowFailure) {
             return { exitStatus, stdout };
         }
-        console.error(`Failed to run the "${chalk_1.default.green(commandDescription)}" command with an exit code of ${exitStatus}.`);
+        console.error(`Failed to run the "${chalk.green(commandDescription)}" command with an exit code of ${exitStatus}.`);
         console.error("The output was as follows:");
         console.error(stdout);
         process.exit(1);
     }
     return { exitStatus, stdout };
 }
-exports.execShell = execShell;
-//# sourceMappingURL=exec.js.map

package/dist/git.js

@@ -0,0 +1,133 @@
+import chalk from "chalk";
+import commandExists from "command-exists";
+import { getPackageJSONVersion, isFile, readFile, } from "isaacscript-common-node";
+import path from "node:path";
+import yaml from "yaml";
+import { HOME_DIR, PROJECT_NAME, REPO_ROOT } from "./constants.js";
+import { execShell, execShellString } from "./exec.js";
+import { getInputString, getInputYesNo } from "./prompt.js";
+export async function promptGitHubRepoOrGitRemoteURL(projectName, noGit, yes, dev, verbose) {
+    if (noGit || dev) {
+        return undefined;
+    }
+    // Hard-code certain project names as never causing a Git repository to be initialized.
+    if (projectName.startsWith("test") || projectName === "foo") {
+        return undefined;
+    }
+    // We do not need to prompt the user if they do not have Git installed.
+    if (!commandExists.sync("git")) {
+        console.log('Git does not seem to be installed. (The "git" command is not in the path.) Skipping Git-related things.');
+        return undefined;
+    }
+    const gitHubUsername = getGitHubUsername();
+    if (gitHubUsername !== undefined) {
+        const { exitStatus } = execShell("gh", ["repo", "view", projectName], verbose, true);
+        const gitHubRepoExists = exitStatus === 0;
+        const url = `https://github.com/${gitHubUsername}/${projectName}`;
+        if (gitHubRepoExists) {
+            console.log(`Detected an existing GitHub repository at: ${chalk.green(url)}`);
+            const guessedRemoteURL = getGitRemoteURL(projectName, gitHubUsername);
+            if (yes) {
+                console.log(`Using a Git remote URL of: ${chalk.green(guessedRemoteURL)}`);
+                return guessedRemoteURL;
+            }
+            const shouldUseGuessedURL = await getInputYesNo(`Do you want to use a Git remote URL of: ${chalk.green(guessedRemoteURL)}`);
+            if (shouldUseGuessedURL) {
+                return guessedRemoteURL;
+            }
+            // Assume that since they do not want to connect this project to the existing GitHub
+            // repository, they do not want to initialize a remote Git URL at all.
+            return undefined;
+        }
+        if (yes) {
+            execShell("gh", ["repo", "create", projectName, "--public"]);
+            console.log(`Created a new GitHub repository at: ${chalk.green(url)}`);
+            return getGitRemoteURL(projectName, gitHubUsername);
+        }
+        const createNewGitHubRepo = await getInputYesNo(`Would you like to create a new GitHub repository at: ${chalk.green(url)}`);
+        if (createNewGitHubRepo) {
+            execShell("gh", ["repo", "create", projectName, "--public"]);
+            console.log("Successfully created a new GitHub repository.");
+            return getGitRemoteURL(projectName, gitHubUsername);
+        }
+        // Assume that since they do not want to create a new GitHub repository, they do not want to
+        // initialize a remote Git URL at all.
+        return undefined;
+    }
+    const gitRemoteURL = await getInputString(`Paste in the remote Git URL for your project.
+For example, if you have an SSH key, it would be something like:
+${chalk.green("git@github.com:Alice/green-candle.git")}
+If you don't have an SSH key, it would be something like:
+${chalk.green("https://github.com/Alice/green-candle.git")}
+If you don't want to initialize a Git repository for this project, press enter to skip.
+`);
+    return gitRemoteURL === "" ? undefined : gitRemoteURL;
+}
+export function getGitHubUsername() {
+    // If the GitHub CLI is installed, we can derive the user's GitHub username.
+    if (!commandExists.sync("gh")) {
+        return undefined;
+    }
+    const githubCLIHostsPath = getGithubCLIHostsPath();
+    if (githubCLIHostsPath === undefined) {
+        return undefined;
+    }
+    if (!isFile(githubCLIHostsPath)) {
+        return undefined;
+    }
+    const configYAMLRaw = readFile(githubCLIHostsPath);
+    const configYAML = yaml.parse(configYAMLRaw);
+    const githubCom = configYAML["github.com"];
+    if (githubCom === undefined) {
+        return undefined;
+    }
+    const { user } = githubCom;
+    if (user === undefined || user === "") {
+        return undefined;
+    }
+    return user;
+}
+function getGithubCLIHostsPath() {
+    if (process.platform === "win32") {
+        const appData = process.env["APPDATA"];
+        if (appData === undefined || appData === "") {
+            return undefined;
+        }
+        return path.join(appData, "GitHub CLI", "hosts.yml");
+    }
+    // The location is the same on both macOS and Linux.
+    return path.join(HOME_DIR, ".config", "gh", "hosts.yml");
+}
+function getGitRemoteURL(projectName, gitHubUsername) {
+    return `git@github.com:${gitHubUsername}/${projectName}.git`;
+}
+export function initGitRepository(projectPath, gitRemoteURL, verbose) {
+    if (!commandExists.sync("git")) {
+        return;
+    }
+    if (gitRemoteURL === undefined) {
+        return;
+    }
+    execShellString("git init --initial-branch=main", verbose, false, projectPath);
+    if (isGitNameAndEmailConfigured(verbose)) {
+        execShellString("git add --all", verbose, false, projectPath);
+        const isaacScriptCLIVersion = getPackageJSONVersion(REPO_ROOT);
+        const commitMessage = `chore: add files from ${PROJECT_NAME} ${isaacScriptCLIVersion} template`;
+        execShell("git", ["commit", "--message", commitMessage], verbose, false, projectPath);
+    }
+    execShell("git", ["remote", "add", "origin", gitRemoteURL], verbose, false, projectPath);
+}
+function isGitNameAndEmailConfigured(verbose) {
+    const nameExitStatus = execShellString("git config --global user.name", verbose, true).exitStatus;
+    const emailExitStatus = execShellString("git config --global user.email", verbose, true).exitStatus;
+    return nameExitStatus === 0 && emailExitStatus === 0;
+}
+export function gitCommitAllAndPush(message, verbose) {
+    execShellString("git add --all", verbose);
+    execShell("git", ["commit", "--message", message], verbose);
+    execShellString("git push", verbose);
+    console.log(`Committed and pushed to the git repository with a message of: ${message}`);
+}
+export function getReleaseGitCommitMessage(version) {
+    return `chore: release ${version}`;
+}

package/dist/interfaces/GitHubCLIHostsYAML.js

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

package/dist/interfaces/IsaacScriptTSConfig.js

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

package/dist/interfaces/ShadersXML.js

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

package/dist/interfaces/copied/CustomStageTSConfig.js

@@ -0,0 +1,4 @@
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaacscript-common" package.
+/// DO NOT EDIT THIS FILE!
+export {};

package/dist/interfaces/copied/JSONRoomsFile.js

@@ -0,0 +1,4 @@
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaacscript-common" package.
+/// DO NOT EDIT THIS FILE!
+export {};

package/dist/main.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import chalk from "chalk";
+import figlet from "figlet";
+import { fatalError, getPackageJSONVersion, getPackageManagerInstallCommand, nukeDependencies, updatePackageJSON, } from "isaacscript-common-node";
+import sourceMapSupport from "source-map-support";
+import { checkForWindowsTerminalBugs } from "./checkForWindowsTerminalBugs.js";
+import { Config } from "./classes/Config.js";
+import { check } from "./commands/check/check.js";
+import { copy } from "./commands/copy/copy.js";
+import { init } from "./commands/init/init.js";
+import { monitor } from "./commands/monitor/monitor.js";
+import { publish } from "./commands/publish/publish.js";
+import { getConfigFromFile } from "./configFile.js";
+import { CWD, PROJECT_NAME, REPO_ROOT } from "./constants.js";
+import { execShellString } from "./exec.js";
+import { getPackageManagerUsedForExistingProject } from "./packageManager.js";
+import { parseArgs } from "./parseArgs.js";
+import { promptInit } from "./prompt.js";
+import { DEFAULT_COMMAND, isIsaacScriptModCommand } from "./types/Command.js";
+import { validateInIsaacScriptProject } from "./validateInIsaacScriptProject.js";
+import { validateNodeVersion } from "./validateNodeVersion.js";
+await main();
+async function main() {
+    sourceMapSupport.install();
+    promptInit();
+    const args = parseArgs();
+    const command = getCommandFromArgs(args);
+    validateNodeVersion();
+    printBanner(command);
+    // Pre-flight checks
+    await checkForWindowsTerminalBugs();
+    await handleCommands(command, args);
+    if (command !== "monitor") {
+        process.exit(0);
+    }
+}
+function getCommandFromArgs(args) {
+    const positionalArgs = args._;
+    const firstPositionArg = positionalArgs[0];
+    return firstPositionArg === undefined || firstPositionArg === ""
+        ? DEFAULT_COMMAND
+        : firstPositionArg;
+}
+function printBanner(command) {
+    // Skip displaying the banner for specific commands.
+    if (command.startsWith("check")) {
+        return;
+    }
+    const banner = figlet.textSync(PROJECT_NAME);
+    console.log(chalk.green(banner));
+    const isaacScriptCLIVersion = getPackageJSONVersion(REPO_ROOT);
+    const versionString = `v${isaacScriptCLIVersion}`;
+    const bannerLines = banner.split("\n");
+    const firstBannerLine = bannerLines[0];
+    if (firstBannerLine === undefined) {
+        fatalError(firstBannerLine, "Failed to get the first line of the banner text.");
+    }
+    const bannerHorizontalLength = firstBannerLine.length;
+    const leftPaddingAmount = Math.floor((bannerHorizontalLength + versionString.length) / 2);
+    const versionLine = versionString.padStart(leftPaddingAmount);
+    console.log(`${versionLine}\n`);
+}
+async function handleCommands(command, args) {
+    const skipProjectChecks = args.skipProjectChecks === true;
+    const verbose = args.verbose === true;
+    let config = new Config();
+    if (command !== "init" &&
+        command !== "check" &&
+        isIsaacScriptModCommand(command)) {
+        if (!skipProjectChecks) {
+            validateInIsaacScriptProject();
+        }
+        const shouldDisplayOutput = !command.startsWith("check");
+        ensureDepsAreInstalled(args, shouldDisplayOutput, verbose);
+        config = await getConfigFromFile(args, false);
+    }
+    switch (command) {
+        case "monitor": {
+            await monitor(args, config);
+            break;
+        }
+        case "init": {
+            await init(args, false);
+            break;
+        }
+        case "init-ts": {
+            await init(args, true);
+            break;
+        }
+        case "copy": {
+            await copy(args, config);
+            break;
+        }
+        case "publish": {
+            await publish(args, config, false);
+            break;
+        }
+        case "publish-ts": {
+            await publish(args, config, true);
+            break;
+        }
+        case "check": {
+            check(args, false);
+            break;
+        }
+        case "check-ts": {
+            check(args, true);
+            break;
+        }
+        case "update": {
+            const hasNewDependencies = await updatePackageJSON(CWD);
+            const msg = hasNewDependencies
+                ? "Successfully installed new Node.js dependencies."
+                : "There were no new Node.js dependency updates.";
+            console.log(msg);
+            break;
+        }
+        case "nuke": {
+            nukeDependencies(CWD);
+            console.log("Successfully reinstalled Node.js dependencies.");
+            break;
+        }
+    }
+}
+function ensureDepsAreInstalled(args, shouldDisplayOutput, verbose) {
+    const packageManager = getPackageManagerUsedForExistingProject(args);
+    const command = getPackageManagerInstallCommand(packageManager);
+    if (shouldDisplayOutput) {
+        console.log(`Running "${command}" to ensure that the project's dependencies are installed correctly.`);
+    }
+    execShellString(command, verbose);
+}

package/dist/objects/copied/doorSlotToDoorSlotFlag.js

@@ -0,0 +1,16 @@
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaacscript-common" package.
+/// DO NOT EDIT THIS FILE!
+import { DoorSlot } from "../../enums/copied/DoorSlot.js";
+import { DoorSlotFlag, DoorSlotFlagZero, } from "../../enums/copied/DoorSlotFlag.js";
+export const DOOR_SLOT_TO_DOOR_SLOT_FLAG = {
+    [DoorSlot.NO_DOOR_SLOT]: DoorSlotFlagZero,
+    [DoorSlot.LEFT_0]: DoorSlotFlag.LEFT_0,
+    [DoorSlot.UP_0]: DoorSlotFlag.UP_0,
+    [DoorSlot.RIGHT_0]: DoorSlotFlag.RIGHT_0,
+    [DoorSlot.DOWN_0]: DoorSlotFlag.DOWN_0,
+    [DoorSlot.LEFT_1]: DoorSlotFlag.LEFT_1,
+    [DoorSlot.UP_1]: DoorSlotFlag.UP_1,
+    [DoorSlot.RIGHT_1]: DoorSlotFlag.RIGHT_1,
+    [DoorSlot.DOWN_1]: DoorSlotFlag.DOWN_1, // 7
+};

package/dist/objects/copied/roomShapeToDoorSlotCoordinates.js

@@ -0,0 +1,112 @@
+/// THIS FILE IS AUTOMATICALLY GENERATED BY THE "build.ts" SCRIPT.
+/// IT IS COPIED FROM THE "isaacscript-common" package.
+/// DO NOT EDIT THIS FILE!
+import { DoorSlot } from "../../enums/copied/DoorSlot.js";
+import { RoomShape } from "../../enums/copied/RoomShape.js";
+/**
+ * The coordinates correspond to the x and y values that are present in a room's XML file.
+ *
+ * e.g. `<door exists="False" x="-1" y="3" />`
+ */
+export const ROOM_SHAPE_TO_DOOR_SLOT_COORDINATES = {
+    // 1
+    [RoomShape.SHAPE_1x1]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [13, 3],
+        [DoorSlot.DOWN_0]: [6, 7], // 3
+    },
+    // 2
+    [RoomShape.IH]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.RIGHT_0]: [13, 3], // 2
+    },
+    // 3
+    [RoomShape.IV]: {
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.DOWN_0]: [6, 7], // 3
+    },
+    // 4
+    [RoomShape.SHAPE_1x2]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [13, 3],
+        [DoorSlot.DOWN_0]: [6, 14],
+        [DoorSlot.LEFT_1]: [-1, 10],
+        [DoorSlot.RIGHT_1]: [13, 10], // 6
+    },
+    // 5
+    [RoomShape.IIV]: {
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.DOWN_0]: [6, 14], // 3
+    },
+    // 6
+    [RoomShape.SHAPE_2x1]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [26, 3],
+        [DoorSlot.DOWN_0]: [6, 7],
+        [DoorSlot.UP_1]: [19, -1],
+        [DoorSlot.DOWN_1]: [19, 7], // 7
+    },
+    // 7
+    [RoomShape.IIH]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.RIGHT_0]: [26, 3], // 2
+    },
+    // 8
+    [RoomShape.SHAPE_2x2]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [26, 3],
+        [DoorSlot.DOWN_0]: [6, 14],
+        [DoorSlot.LEFT_1]: [-1, 10],
+        [DoorSlot.UP_1]: [19, -1],
+        [DoorSlot.RIGHT_1]: [26, 10],
+        [DoorSlot.DOWN_1]: [19, 14], // 7
+    },
+    // 9
+    [RoomShape.LTL]: {
+        [DoorSlot.LEFT_0]: [12, 3],
+        [DoorSlot.UP_0]: [6, 6],
+        [DoorSlot.RIGHT_0]: [26, 3],
+        [DoorSlot.DOWN_0]: [6, 14],
+        [DoorSlot.LEFT_1]: [-1, 10],
+        [DoorSlot.UP_1]: [19, -1],
+        [DoorSlot.RIGHT_1]: [26, 10],
+        [DoorSlot.DOWN_1]: [19, 14], // 7
+    },
+    // 10
+    [RoomShape.LTR]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [13, 3],
+        [DoorSlot.DOWN_0]: [6, 14],
+        [DoorSlot.LEFT_1]: [-1, 10],
+        [DoorSlot.UP_1]: [19, 6],
+        [DoorSlot.RIGHT_1]: [26, 10],
+        [DoorSlot.DOWN_1]: [19, 14], // 7
+    },
+    // 11
+    [RoomShape.LBL]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [26, 3],
+        [DoorSlot.DOWN_0]: [6, 7],
+        [DoorSlot.LEFT_1]: [12, 10],
+        [DoorSlot.UP_1]: [19, -1],
+        [DoorSlot.RIGHT_1]: [26, 10],
+        [DoorSlot.DOWN_1]: [19, 14], // 7
+    },
+    // 12
+    [RoomShape.LBR]: {
+        [DoorSlot.LEFT_0]: [-1, 3],
+        [DoorSlot.UP_0]: [6, -1],
+        [DoorSlot.RIGHT_0]: [26, 3],
+        [DoorSlot.DOWN_0]: [6, 14],
+        [DoorSlot.LEFT_1]: [-1, 10],
+        [DoorSlot.UP_1]: [19, -1],
+        [DoorSlot.RIGHT_1]: [13, 10],
+        [DoorSlot.DOWN_1]: [19, 7], // 7
+    },
+};