isaacscript-common 20.2.0 → 20.3.1

package/src/classes/features/other/PickupIndexCreation.ts

@@ -275,7 +275,7 @@ function getStoredPickupIndex(
   pickup: Entity,
   pickupDescriptions: Map<PickupIndex, PickupDescription>,
 ): PickupIndex | undefined {
-  for (const [pickupIndex, pickupDescription] of pickupDescriptions.entries()) {
+  for (const [pickupIndex, pickupDescription] of pickupDescriptions) {
     if (
       vectorEquals(pickupDescription.position, pickup.Position) &&
       pickupDescription.initSeed === pickup.InitSeed

package/src/classes/features/other/PonyDetection.ts

@@ -11,11 +11,11 @@ import { getPlayers } from "../../../functions/playerIndex";
 import { PlayerIndex } from "../../../types/PlayerIndex";
 import { Feature } from "../../private/Feature";
 
-const FLAGS_WHEN_PONY_IS_ACTIVE: readonly EntityFlag[] = [
+const FLAGS_WHEN_PONY_IS_ACTIVE = [
   EntityFlag.NO_KNOCKBACK, // 1 << 26
   EntityFlag.NO_PHYSICS_KNOCKBACK, // 1 << 30
   EntityFlag.NO_DAMAGE_BLINK, // 1 << 36
-];
+] as const;
 
 export class PonyDetection extends Feature {
   /** @internal */

package/src/classes/features/other/customStages/backdrop.ts

@@ -72,10 +72,10 @@ const ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS: {
 const WALL_OFFSET = Vector(-80, -80);
 
 /** Corresponds to "floor-backdrop.anm2". */
-const L_FLOOR_ANM2_LAYERS: readonly int[] = [16, 17];
+const L_FLOOR_ANM2_LAYERS = [16, 17] as const;
 
 /** Corresponds to "floor-backdrop.anm2". */
-const N_FLOOR_ANM2_LAYERS: readonly int[] = [18, 19];
+const N_FLOOR_ANM2_LAYERS = [18, 19] as const;
 
 /**
  * Normally, we would make a custom entity to represent a backdrop effect, but we don't want to

package/src/classes/features/other/customStages/streakText.ts

@@ -49,10 +49,12 @@ const STREAK_TEXT_BOTTOM_Y_OFFSET = -9;
 const NUM_RENDER_FRAMES_MAP_HELD_BEFORE_STREAK_TEXT = 11;
 
 /** Taken from StageAPI. */
-const TEXT_IN_ADJUSTMENTS = [-800, -639, -450, -250, -70, 10, 6, 3];
+const TEXT_IN_ADJUSTMENTS = [-800, -639, -450, -250, -70, 10, 6, 3] as const;
 
 /** Taken from StageAPI. */
-const TEXT_OUT_ADJUSTMENTS = [0, -5, -10, -15, -20, 144, 308, 472, 636, 800];
+const TEXT_OUT_ADJUSTMENTS = [
+  0, -5, -10, -15, -20, 144, 308, 472, 636, 800,
+] as const;
 
 /** Taken from StageAPI. */
 const TEXT_IN_SCALES = [
@@ -64,7 +66,7 @@ const TEXT_IN_SCALES = [
   Vector(0.95, 1.05),
   Vector(0.97, 1.03),
   Vector(0.98, 1.02),
-];
+] as const;
 
 /** Taken from StageAPI. */
 const TEXT_OUT_SCALES = [
@@ -78,7 +80,7 @@ const TEXT_OUT_SCALES = [
   Vector(2.18, 0.56),
   Vector(2.59, 0.38),
   Vector(3, 0.2),
-];
+] as const;
 
 interface StreakTextVars {
   run: {

package/src/classes/features/other/saveDataManager/glowingHourGlass.ts

@@ -14,10 +14,10 @@ import { SAVE_DATA_MANAGER_DEBUG } from "./constants";
  * When the Glowing Hourglass is used, certain save data keys will automatically be restored to a
  * backup.
  */
-const GLOWING_HOUR_GLASS_BACKUP_KEYS: readonly SaveDataKey[] = [
+const GLOWING_HOUR_GLASS_BACKUP_KEYS = [
   SaveDataKey.RUN,
   SaveDataKey.LEVEL,
-];
+] as const;
 
 const IGNORE_GLOWING_HOUR_GLASS_KEY = "__ignoreGlowingHourGlass";
 

package/src/core/constants.ts

@@ -79,12 +79,13 @@ export const GAME_FRAMES_PER_SECOND = 30;
 export const GAME_FRAMES_PER_MINUTE = GAME_FRAMES_PER_SECOND * 60;
 
 /** The set of all `ItemConfigCardType` values that are not a rune or special object. */
-export const ITEM_CONFIG_CARD_TYPES_FOR_CARDS = new Set([
-  ItemConfigCardType.TAROT,
-  ItemConfigCardType.SUIT,
-  ItemConfigCardType.SPECIAL,
-  ItemConfigCardType.TAROT_REVERSE,
-]);
+export const ITEM_CONFIG_CARD_TYPES_FOR_CARDS: ReadonlySet<ItemConfigCardType> =
+  new Set([
+    ItemConfigCardType.TAROT,
+    ItemConfigCardType.SUIT,
+    ItemConfigCardType.SPECIAL,
+    ItemConfigCardType.TAROT_REVERSE,
+  ]);
 
 /** Render frames are what is returned by the `Isaac.GetFrameCount` method. */
 export const RENDER_FRAMES_PER_SECOND = 60;

package/src/enums/ModCallbackCustom.ts

@@ -1873,12 +1873,14 @@ export enum ModCallbackCustom {
    *
    * ```ts
    * function preEntitySpawnFilter(
-   *   entity: Entity,
-   *   amount: float,
-   *   damageFlags: BitFlags<DamageFlag>,
-   *   source: EntityRef,
-   *   countdownFrames: int,
-   * ): boolean | undefined {}
+   *   entityType: EntityType,
+   *   variant: int,
+   *   subType: int,
+   *   position: Vector,
+   *   velocity: Vector,
+   *   spawner: Entity | undefined,
+   *   initSeed: Seed,
+   * ): [EntityType, int, int, int] | undefined {}
    * ```
    */
   PRE_ENTITY_SPAWN_FILTER,
@@ -1979,4 +1981,28 @@ export enum ModCallbackCustom {
    * ```
    */
   PRE_NPC_UPDATE_FILTER,
+
+  /**
+   * The exact same thing as the vanilla `PRE_ROOM_ENTITY_SPAWN` callback, except this callback
+   * allows you to specify extra arguments for additional filtration.
+   *
+   * When registering the callback with the `ModUpgraded.AddCallbackCustom` method:
+   * - You can provide an optional third argument that will make the callback only fire if it
+   *   matches the `EntityType` or `GridEntityXMLType` provided.
+   * - You can provide an optional fourth argument that will make the callback only fire if it
+   *   matches the variant provided.
+   * - You can provide an optional fifth argument that will make the callback only fire if it
+   *   matches the sub-type provided.
+   *
+   * ```ts
+   * function preRoomEntitySpawnFilter(
+   *   entityTypeOrGridEntityXMLType: EntityType | GridEntityXMLType,
+   *   variant: int,
+   *   subType: int,
+   *   gridIndex: int,
+   *   seed: Seed,
+   * ): [EntityType | GridEntityXMLType, int, int] | undefined {}
+   * ```
+   */
+  PRE_ROOM_ENTITY_SPAWN_FILTER,
 }

package/src/functions/bitSet128.ts

@@ -14,7 +14,7 @@ export type SerializedBitSet128 = LuaMap<string, unknown> & {
 };
 
 const OBJECT_NAME = "BitSet128";
-const KEYS = ["l", "h"];
+const KEYS = ["l", "h"] as const;
 
 /** Helper function to copy a `BitSet128` Isaac API class. */
 export function copyBitSet128(bitSet128: BitSet128): BitSet128 {

package/src/functions/color.ts

@@ -16,7 +16,7 @@ export type SerializedColor = LuaMap<string, unknown> & {
 };
 
 const OBJECT_NAME = "Color";
-const KEYS = ["R", "G", "B", "A", "RO", "GO", "BO"];
+const KEYS = ["R", "G", "B", "A", "RO", "GO", "BO"] as const;
 
 export function colorEquals(color1: Color, color2: Color): boolean {
   return isaacAPIClassEquals(color1, color2, KEYS);

package/src/functions/hex.ts

@@ -6,8 +6,9 @@ const HEX_STRING_LENGTH = 6;
  * Converts a hex string like "#33aa33" to a KColor object.
  *
  * @param hexString A hex string like "#ffffff" or "ffffff". (The "#" character is optional.)
+ * @param alpha Optional. Range is from 0 to 1. Default is 1. (The same as the `Color` constructor.)
  */
-export function hexToColor(hexString: string, alpha: float): Color {
+export function hexToColor(hexString: string, alpha = 1.0): Color {
   const [r, g, b] = hexToRGB(hexString);
 
   // Color values should be between 0 and 1.
@@ -19,8 +20,9 @@ export function hexToColor(hexString: string, alpha: float): Color {
  * Converts a hex string like "#33aa33" to a Color object.
  *
  * @param hexString A hex string like "#ffffff" or "ffffff". (The "#" character is optional.)
+ * @param alpha Range is from 0 to 1. Default is 1.
  */
-export function hexToKColor(hexString: string, alpha: float): KColor {
+export function hexToKColor(hexString: string, alpha = 1.0): KColor {
   const [r, g, b] = hexToRGB(hexString);
 
   // KColor values should be between 0 and 1.

package/src/functions/input.ts

@@ -8,7 +8,7 @@ import { KEYBOARD_TO_STRING } from "../maps/keyboardToString";
 import { getEnumValues } from "./enums";
 import { trimPrefix } from "./string";
 
-const MODIFIER_KEYS: readonly Keyboard[] = [
+const MODIFIER_KEYS = [
   Keyboard.LEFT_SHIFT, // 340
   Keyboard.LEFT_CONTROL, // 341
   Keyboard.LEFT_ALT, // 342
@@ -17,25 +17,25 @@ const MODIFIER_KEYS: readonly Keyboard[] = [
   Keyboard.RIGHT_CONTROL, // 345
   Keyboard.RIGHT_ALT, // 346
   Keyboard.RIGHT_SUPER, // 347
-];
+] as const;
 
-const MOVEMENT_ACTIONS: readonly ButtonAction[] = [
+const MOVEMENT_ACTIONS = [
   ButtonAction.LEFT, // 0
   ButtonAction.RIGHT, // 1
   ButtonAction.UP, // 2
   ButtonAction.DOWN, // 3
-];
+] as const;
 
 export const MOVEMENT_ACTIONS_SET: ReadonlySet<ButtonAction> = new Set(
   MOVEMENT_ACTIONS,
 );
 
-const SHOOTING_ACTIONS: readonly ButtonAction[] = [
+const SHOOTING_ACTIONS = [
   ButtonAction.SHOOT_LEFT, // 4
   ButtonAction.SHOOT_RIGHT, // 5
   ButtonAction.SHOOT_UP, // 6
   ButtonAction.SHOOT_DOWN, // 7
-];
+] as const;
 
 export const SHOOTING_ACTIONS_SET: ReadonlySet<ButtonAction> = new Set(
   SHOOTING_ACTIONS,

package/src/functions/isaacAPIClass.ts

@@ -162,7 +162,7 @@ export function isTear(variable: unknown): variable is EntityTear {
 export function isaacAPIClassEquals(
   object1: unknown,
   object2: unknown,
-  keys: string[],
+  keys: string[] | readonly string[],
 ): boolean {
   const table1 = object1 as LuaMap<AnyNotNil, unknown>;
   const table2 = object2 as LuaMap<AnyNotNil, unknown>;

package/src/functions/kColor.ts

@@ -16,7 +16,7 @@ export type SerializedKColor = LuaMap<string, unknown> & {
 };
 
 const OBJECT_NAME = "KColor";
-const KEYS = ["Red", "Green", "Blue", "Alpha"];
+const KEYS = ["Red", "Green", "Blue", "Alpha"] as const;
 
 /** Helper function to copy a `KColor` Isaac API class. */
 export function copyKColor(kColor: KColor): KColor {

package/src/functions/levelGrid.ts

@@ -45,7 +45,7 @@ const UP = -LEVEL_GRID_ROW_WIDTH;
 const RIGHT = 1;
 const DOWN = LEVEL_GRID_ROW_WIDTH;
 
-const ADJACENT_ROOM_GRID_INDEX_DELTAS: readonly int[] = [LEFT, UP, RIGHT, DOWN];
+const ADJACENT_ROOM_GRID_INDEX_DELTAS = [LEFT, UP, RIGHT, DOWN] as const;
 
 /**
  * Helper function to get only the adjacent room grid indexes that exist (i.e. have room data).
@@ -300,10 +300,7 @@ export function getRoomShapeAdjacentExistingGridIndexes(
     getRoomShapeAdjacentGridIndexes(safeRoomGridIndex, roomShape),
   );
 
-  for (const [
-    doorSlot,
-    roomGridIndex,
-  ] of roomShapeAdjacentGridIndexes.entries()) {
+  for (const [doorSlot, roomGridIndex] of roomShapeAdjacentGridIndexes) {
     const roomData = getRoomData(roomGridIndex);
     if (roomData === undefined) {
       roomShapeAdjacentGridIndexes.delete(doorSlot);
@@ -369,10 +366,7 @@ export function getRoomShapeAdjacentNonExistingGridIndexes(
     getRoomShapeAdjacentGridIndexes(safeRoomGridIndex, roomShape),
   );
 
-  for (const [
-    doorSlot,
-    roomGridIndex,
-  ] of roomShapeAdjacentGridIndexes.entries()) {
+  for (const [doorSlot, roomGridIndex] of roomShapeAdjacentGridIndexes) {
     const roomData = getRoomData(roomGridIndex);
     if (roomData !== undefined) {
       roomShapeAdjacentGridIndexes.delete(doorSlot);

package/src/functions/map.ts

@@ -56,10 +56,10 @@ export function defaultMapSetHash<V>(
  * ]);
  * const searchText = "f";
  * const match = getMapPartialMatch(map, searchText); // match is now equal to ["foo", 123]
+ * ```
  *
  * @returns If a match was found, returns a tuple of the map key and value. If a match was not
- * found, returns undefined.
- * ```
+ *          found, returns undefined.
  */
 export function getMapPartialMatch<T>(
   searchText: string,

package/src/functions/merge.ts

@@ -219,7 +219,7 @@ function mergeSerializedTable(
         if (!isTable(oldValue)) {
           // The child table does not exist on the old table. However, we still need to copy over
           // the new table, because we need to handle data types like "Foo | null". Thus, set up a
-          // blank sub-table on the old table, and continue to recursively merge..
+          // blank sub-table on the old table, and continue to recursively merge.
           oldValue = new LuaMap();
           oldTable.set(key, oldValue);
         }

package/src/functions/minimap.ts

@@ -108,7 +108,7 @@ export function setDisplayFlags(
 ): void {
   const level = game.GetLevel();
 
-  for (const [roomGridIndex, displayFlags] of displayFlagsMap.entries()) {
+  for (const [roomGridIndex, displayFlags] of displayFlagsMap) {
     if (MinimapAPI === undefined) {
       // We pass false to the `updateVisibility` argument as a small optimization.
       setRoomDisplayFlags(roomGridIndex, displayFlags, false);

package/src/functions/rng.ts

@@ -18,7 +18,7 @@ export type SerializedRNG = LuaMap<string, unknown> & {
 const RECOMMENDED_SHIFT_IDX = 35;
 
 const OBJECT_NAME = "RNG";
-const KEYS = ["seed"];
+const KEYS = ["seed"] as const;
 
 /** Helper function to copy an `RNG` Isaac API class. */
 export function copyRNG(rng: RNG): RNG {

package/src/functions/table.ts

@@ -13,7 +13,7 @@ export function clearTable(luaMap: LuaMap<AnyNotNil, unknown>): void {
 /** Helper function to copy specific values from a userdata object (e.g. `Vector`) to a table. */
 export function copyUserdataValuesToTable(
   object: unknown,
-  keys: string[],
+  keys: string[] | readonly string[],
   luaMap: LuaMap<string, unknown>,
 ): void {
   if (!isUserdata(object)) {

package/src/functions/utils.ts

@@ -9,15 +9,14 @@ import { CONSOLE_COMMANDS_SET } from "../sets/consoleCommandsSet";
  * - For example, `eRange(1, 3)` will return `[1, 2]`.
  * - For example, `eRange(2)` will return `[0, 1]`.
  *
- * @param start The number to start at.
- * @param end Optional. The number to end at. If not specified, then the start will be 0 and the
+ * @param start The integer to start at.
+ * @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
  *            first argument will be the end.
  * @param increment Optional. The increment to use. Default is 1.
  */
 export function eRange(start: int, end?: int, increment = 1): int[] {
   if (end === undefined) {
-    end = start;
-    start = 0;
+    return eRange(0, start);
   }
 
   const array: int[] = [];
@@ -52,23 +51,18 @@ export function getTraversalDescription(
  * - For example, `iRange(1, 3)` will return `[1, 2, 3]`.
  * - For example, `iRange(2)` will return `[0, 1, 2]`.
  *
- * @param start The number to start at.
- * @param end Optional. The number to end at. If not specified, then the start will be 0 and the
+ * @param start The integer to start at.
+ * @param end Optional. The integer to end at. If not specified, then the start will be 0 and the
  *            first argument will be the end.
  * @param increment Optional. The increment to use. Default is 1.
  */
 export function iRange(start: int, end?: int, increment = 1): int[] {
   if (end === undefined) {
-    end = start;
-    start = 0;
+    return iRange(0, start);
   }
 
-  const array: int[] = [];
-  for (let i = start; i <= end; i += increment) {
-    array.push(i);
-  }
-
-  return array;
+  const exclusiveEnd = end + 1;
+  return eRange(start, exclusiveEnd, increment);
 }
 
 /**
@@ -226,7 +220,7 @@ export function twoDimensionalSort<T>(array1: T[], array2: T[]): -1 | 0 | 1 {
  *
  * This function is only meant to be used with interfaces (i.e. types that will not exist at
  * run-time). If you are generating an object that will contain all of the keys of an enum, use the
- * `newObjectWithEnumKeys` helper function instead.
+ * `satisfies` operator with the `HasAllEnumValues` helper type instead.
  */
 export function validateInterfaceMatchesEnum<
   // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/src/functions/vector.ts

@@ -20,7 +20,7 @@ export type SerializedVector = LuaMap<string, unknown> & {
 };
 
 const OBJECT_NAME = "Vector";
-const KEYS = ["X", "Y"];
+const KEYS = ["X", "Y"] as const;
 
 /** Helper function to copy a `Vector` Isaac API class. */
 export function copyVector(vector: Vector): Vector {

package/src/interfaces/private/AddCallbackParametersCustom.ts

@@ -10,6 +10,7 @@ import {
   EntityType,
   FamiliarVariant,
   GridEntityType,
+  GridEntityXMLType,
   InputHook,
   ItemType,
   KnifeVariant,
@@ -793,6 +794,19 @@ export interface AddCallbackParametersCustom {
     variant?: int,
     subType?: int,
   ];
+
+  [ModCallbackCustom.PRE_ROOM_ENTITY_SPAWN_FILTER]: [
+    callback: (
+      entityTypeOrGridEntityXMLType: EntityType | GridEntityXMLType,
+      variant: int,
+      subType: int,
+      gridIndex: int,
+      seed: Seed,
+    ) => [EntityType | GridEntityXMLType, int, int] | undefined,
+    entityTypeOrGridEntityXMLType?: EntityType | GridEntityXMLType,
+    variant?: int,
+    subType?: int,
+  ];
 }
 
 validateInterfaceMatchesEnum<AddCallbackParametersCustom, ModCallbackCustom>();

package/src/maps/characterNameToTypeMap.ts

@@ -1,88 +1,89 @@
 import { PlayerType } from "isaac-typescript-definitions";
 
 /** Maps character names to the values of the `PlayerType` enum. */
-export const CHARACTER_NAME_TO_TYPE_MAP = new Map<string, PlayerType>([
-  ["isaac", PlayerType.ISAAC], // 0
-  ["magdalene", PlayerType.MAGDALENE], // 1
-  ["maggy", PlayerType.MAGDALENE], // 1
-  ["cain", PlayerType.CAIN], // 2
-  ["judas", PlayerType.JUDAS], // 3
-  ["blueBaby", PlayerType.BLUE_BABY], // 4
-  ["bb", PlayerType.BLUE_BABY], // 4
-  ["eve", PlayerType.EVE], // 5
-  ["samson", PlayerType.SAMSON], // 6
-  ["azazel", PlayerType.AZAZEL], // 7
-  ["lazarus", PlayerType.LAZARUS], // 8
-  // Needed so that "laz2" does not take precedence over "lazarus".
-  ["laz", PlayerType.LAZARUS], // 8
-  ["eden", PlayerType.EDEN], // 9
-  ["theLost", PlayerType.LOST], // 10
-  ["lost", PlayerType.LOST], // 10
-  ["lazarus2", PlayerType.LAZARUS_2], // 11
-  ["laz2", PlayerType.LAZARUS_2], // 11
-  ["darkJudas", PlayerType.DARK_JUDAS], // 12
-  ["dJudas", PlayerType.DARK_JUDAS], // 12
-  ["blackJudas", PlayerType.DARK_JUDAS], // 12
-  ["bJudas", PlayerType.DARK_JUDAS], // 12
-  ["lilith", PlayerType.LILITH], // 13
-  ["keeper", PlayerType.KEEPER], // 14
-  ["apollyon", PlayerType.APOLLYON], // 15
-  ["theForgotten", PlayerType.FORGOTTEN], // 16
-  ["forgotten", PlayerType.FORGOTTEN], // 16
-  ["theSoul", PlayerType.SOUL], // 17
-  ["soul", PlayerType.SOUL], // 17
-  ["bethany", PlayerType.BETHANY], // 18
-  ["jacob", PlayerType.JACOB], // 19
-  ["esau", PlayerType.ESAU], // 20
-  ["taintedIsaac", PlayerType.ISAAC_B], // 21
-  ["tIsaac", PlayerType.ISAAC_B], // 21
-  ["taintedMagdalene", PlayerType.MAGDALENE_B], // 22
-  ["tMagdalene", PlayerType.MAGDALENE_B], // 22
-  ["taintedMaggy", PlayerType.MAGDALENE_B], // 22
-  ["tMaggy", PlayerType.MAGDALENE_B], // 22
-  ["taintedCain", PlayerType.CAIN_B], // 23
-  ["tCain", PlayerType.CAIN_B], // 23
-  ["taintedJudas", PlayerType.JUDAS_B], // 24
-  ["tJudas", PlayerType.JUDAS_B], // 24
-  ["taintedBlueBaby", PlayerType.BLUE_BABY_B], // 25
-  ["tBlueBaby", PlayerType.BLUE_BABY_B], // 25
-  ["tbb", PlayerType.BLUE_BABY_B], // 25
-  ["taintedEve", PlayerType.EVE_B], // 26
-  ["tEve", PlayerType.EVE_B], // 26
-  ["taintedSamson", PlayerType.SAMSON_B], // 27
-  ["tSamson", PlayerType.SAMSON_B], // 27
-  ["taintedAzazel", PlayerType.AZAZEL_B], // 28
-  ["tAzazel", PlayerType.AZAZEL_B], // 28
-  ["taintedLazarus", PlayerType.LAZARUS_B], // 29
-  ["tLazarus", PlayerType.LAZARUS_B], // 29
-  ["taintedLaz", PlayerType.LAZARUS_B], // 29
-  ["tLaz", PlayerType.LAZARUS_B], // 29
-  ["taintedEden", PlayerType.EDEN_B], // 30
-  ["tEden", PlayerType.EDEN_B], // 30
-  ["taintedLost", PlayerType.LOST_B], // 31
-  ["tLost", PlayerType.LOST_B], // 31
-  ["taintedLilith", PlayerType.LILITH_B], // 32
-  ["tLilith", PlayerType.LILITH_B], // 32
-  ["taintedKeeper", PlayerType.KEEPER_B], // 33
-  ["tKeeper", PlayerType.KEEPER_B], // 33
-  ["taintedApollyon", PlayerType.APOLLYON_B], // 34
-  ["tApollyon", PlayerType.APOLLYON_B], // 34
-  ["taintedForgotten", PlayerType.FORGOTTEN_B], // 35
-  ["tForgotten", PlayerType.FORGOTTEN_B], // 35
-  ["taintedBethany", PlayerType.BETHANY_B], // 36
-  ["tBethany", PlayerType.BETHANY_B], // 36
-  ["taintedJacob", PlayerType.JACOB_B], // 37
-  ["tJacob", PlayerType.JACOB_B], // 37
-  ["taintedLazarusDead", PlayerType.LAZARUS_2_B], // 38
-  ["tLazarusDead", PlayerType.LAZARUS_2_B], // 38
-  ["taintedLazDead", PlayerType.LAZARUS_2_B], // 38
-  ["tLazDead", PlayerType.LAZARUS_2_B], // 38
-  ["deadTaintedLazarus", PlayerType.LAZARUS_2_B], // 38
-  ["deadTLazarus", PlayerType.LAZARUS_2_B], // 38
-  ["deadTaintedLaz", PlayerType.LAZARUS_2_B], // 38
-  ["deadTLaz", PlayerType.LAZARUS_2_B], // 38
-  ["taintedJacobGhost", PlayerType.JACOB_2_B], // 39
-  ["tJacobGhost", PlayerType.JACOB_2_B], // 39
-  ["taintedSoul", PlayerType.SOUL_B], // 40
-  ["tSoul", PlayerType.SOUL_B], // 40
-]);
+export const CHARACTER_NAME_TO_TYPE_MAP: ReadonlyMap<string, PlayerType> =
+  new Map([
+    ["isaac", PlayerType.ISAAC], // 0
+    ["magdalene", PlayerType.MAGDALENE], // 1
+    ["maggy", PlayerType.MAGDALENE], // 1
+    ["cain", PlayerType.CAIN], // 2
+    ["judas", PlayerType.JUDAS], // 3
+    ["blueBaby", PlayerType.BLUE_BABY], // 4
+    ["bb", PlayerType.BLUE_BABY], // 4
+    ["eve", PlayerType.EVE], // 5
+    ["samson", PlayerType.SAMSON], // 6
+    ["azazel", PlayerType.AZAZEL], // 7
+    ["lazarus", PlayerType.LAZARUS], // 8
+    // Needed so that "laz2" does not take precedence over "lazarus".
+    ["laz", PlayerType.LAZARUS], // 8
+    ["eden", PlayerType.EDEN], // 9
+    ["theLost", PlayerType.LOST], // 10
+    ["lost", PlayerType.LOST], // 10
+    ["lazarus2", PlayerType.LAZARUS_2], // 11
+    ["laz2", PlayerType.LAZARUS_2], // 11
+    ["darkJudas", PlayerType.DARK_JUDAS], // 12
+    ["dJudas", PlayerType.DARK_JUDAS], // 12
+    ["blackJudas", PlayerType.DARK_JUDAS], // 12
+    ["bJudas", PlayerType.DARK_JUDAS], // 12
+    ["lilith", PlayerType.LILITH], // 13
+    ["keeper", PlayerType.KEEPER], // 14
+    ["apollyon", PlayerType.APOLLYON], // 15
+    ["theForgotten", PlayerType.FORGOTTEN], // 16
+    ["forgotten", PlayerType.FORGOTTEN], // 16
+    ["theSoul", PlayerType.SOUL], // 17
+    ["soul", PlayerType.SOUL], // 17
+    ["bethany", PlayerType.BETHANY], // 18
+    ["jacob", PlayerType.JACOB], // 19
+    ["esau", PlayerType.ESAU], // 20
+    ["taintedIsaac", PlayerType.ISAAC_B], // 21
+    ["tIsaac", PlayerType.ISAAC_B], // 21
+    ["taintedMagdalene", PlayerType.MAGDALENE_B], // 22
+    ["tMagdalene", PlayerType.MAGDALENE_B], // 22
+    ["taintedMaggy", PlayerType.MAGDALENE_B], // 22
+    ["tMaggy", PlayerType.MAGDALENE_B], // 22
+    ["taintedCain", PlayerType.CAIN_B], // 23
+    ["tCain", PlayerType.CAIN_B], // 23
+    ["taintedJudas", PlayerType.JUDAS_B], // 24
+    ["tJudas", PlayerType.JUDAS_B], // 24
+    ["taintedBlueBaby", PlayerType.BLUE_BABY_B], // 25
+    ["tBlueBaby", PlayerType.BLUE_BABY_B], // 25
+    ["tbb", PlayerType.BLUE_BABY_B], // 25
+    ["taintedEve", PlayerType.EVE_B], // 26
+    ["tEve", PlayerType.EVE_B], // 26
+    ["taintedSamson", PlayerType.SAMSON_B], // 27
+    ["tSamson", PlayerType.SAMSON_B], // 27
+    ["taintedAzazel", PlayerType.AZAZEL_B], // 28
+    ["tAzazel", PlayerType.AZAZEL_B], // 28
+    ["taintedLazarus", PlayerType.LAZARUS_B], // 29
+    ["tLazarus", PlayerType.LAZARUS_B], // 29
+    ["taintedLaz", PlayerType.LAZARUS_B], // 29
+    ["tLaz", PlayerType.LAZARUS_B], // 29
+    ["taintedEden", PlayerType.EDEN_B], // 30
+    ["tEden", PlayerType.EDEN_B], // 30
+    ["taintedLost", PlayerType.LOST_B], // 31
+    ["tLost", PlayerType.LOST_B], // 31
+    ["taintedLilith", PlayerType.LILITH_B], // 32
+    ["tLilith", PlayerType.LILITH_B], // 32
+    ["taintedKeeper", PlayerType.KEEPER_B], // 33
+    ["tKeeper", PlayerType.KEEPER_B], // 33
+    ["taintedApollyon", PlayerType.APOLLYON_B], // 34
+    ["tApollyon", PlayerType.APOLLYON_B], // 34
+    ["taintedForgotten", PlayerType.FORGOTTEN_B], // 35
+    ["tForgotten", PlayerType.FORGOTTEN_B], // 35
+    ["taintedBethany", PlayerType.BETHANY_B], // 36
+    ["tBethany", PlayerType.BETHANY_B], // 36
+    ["taintedJacob", PlayerType.JACOB_B], // 37
+    ["tJacob", PlayerType.JACOB_B], // 37
+    ["taintedLazarusDead", PlayerType.LAZARUS_2_B], // 38
+    ["tLazarusDead", PlayerType.LAZARUS_2_B], // 38
+    ["taintedLazDead", PlayerType.LAZARUS_2_B], // 38
+    ["tLazDead", PlayerType.LAZARUS_2_B], // 38
+    ["deadTaintedLazarus", PlayerType.LAZARUS_2_B], // 38
+    ["deadTLazarus", PlayerType.LAZARUS_2_B], // 38
+    ["deadTaintedLaz", PlayerType.LAZARUS_2_B], // 38
+    ["deadTLaz", PlayerType.LAZARUS_2_B], // 38
+    ["taintedJacobGhost", PlayerType.JACOB_2_B], // 39
+    ["tJacobGhost", PlayerType.JACOB_2_B], // 39
+    ["taintedSoul", PlayerType.SOUL_B], // 40
+    ["tSoul", PlayerType.SOUL_B], // 40
+  ]);

package/src/objects/roomShapeBounds.ts

@@ -6,10 +6,10 @@ import {
   ONE_BY_ONE_CONTENTS_WIDTH,
 } from "./roomShapeVolumes";
 
-const TWO_BY_TWO_BOUNDS: [width: int, height: int] = [
+const TWO_BY_TWO_BOUNDS: readonly [width: int, height: int] = [
   ONE_BY_ONE_CONTENTS_WIDTH * 2,
   ONE_BY_ONE_CONTENTS_HEIGHT * 2,
-];
+] as const;
 
 /**
  * The size of a room shape's contents. This does not include the tiles that the walls are on. L