isaacscript-common 21.5.3 → 21.6.0

package/dist/src/objects/stageToStageID.lua

@@ -0,0 +1,93 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+local BASEMENT_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.BASEMENT,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.CELLAR,
+    [StageType.AFTERBIRTH] = StageID.BURNING_BASEMENT,
+    [StageType.GREED_MODE] = StageID.BASEMENT,
+    [StageType.REPENTANCE] = StageID.DOWNPOUR,
+    [StageType.REPENTANCE_B] = StageID.DROSS
+}
+local CAVES_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.CAVES,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.CATACOMBS,
+    [StageType.AFTERBIRTH] = StageID.FLOODED_CAVES,
+    [StageType.GREED_MODE] = StageID.CAVES,
+    [StageType.REPENTANCE] = StageID.MINES,
+    [StageType.REPENTANCE_B] = StageID.ASHPIT
+}
+local DEPTHS_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.DEPTHS,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.NECROPOLIS,
+    [StageType.AFTERBIRTH] = StageID.DANK_DEPTHS,
+    [StageType.GREED_MODE] = StageID.DEPTHS,
+    [StageType.REPENTANCE] = StageID.MAUSOLEUM,
+    [StageType.REPENTANCE_B] = StageID.GEHENNA
+}
+local WOMB_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.WOMB,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.UTERO,
+    [StageType.AFTERBIRTH] = StageID.SCARRED_WOMB,
+    [StageType.GREED_MODE] = StageID.WOMB,
+    [StageType.REPENTANCE] = StageID.CORPSE,
+    [StageType.REPENTANCE_B] = StageID.MORTIS
+}
+local BLUE_WOMB_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.BLUE_WOMB,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.BLUE_WOMB,
+    [StageType.AFTERBIRTH] = StageID.BLUE_WOMB,
+    [StageType.GREED_MODE] = StageID.BLUE_WOMB,
+    [StageType.REPENTANCE] = StageID.BLUE_WOMB,
+    [StageType.REPENTANCE_B] = StageID.BLUE_WOMB
+}
+local SHEOL_CATHEDRAL_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.SHEOL,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.CATHEDRAL,
+    [StageType.AFTERBIRTH] = StageID.SHEOL,
+    [StageType.GREED_MODE] = StageID.SHEOL,
+    [StageType.REPENTANCE] = StageID.SHEOL,
+    [StageType.REPENTANCE_B] = StageID.SHEOL
+}
+local DARK_ROOM_CHEST_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.DARK_ROOM,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.CHEST,
+    [StageType.AFTERBIRTH] = StageID.DARK_ROOM,
+    [StageType.GREED_MODE] = StageID.DARK_ROOM,
+    [StageType.REPENTANCE] = StageID.DARK_ROOM,
+    [StageType.REPENTANCE_B] = StageID.DARK_ROOM
+}
+local VOID_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.VOID,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.VOID,
+    [StageType.AFTERBIRTH] = StageID.VOID,
+    [StageType.GREED_MODE] = StageID.VOID,
+    [StageType.REPENTANCE] = StageID.VOID,
+    [StageType.REPENTANCE_B] = StageID.VOID
+}
+local HOME_TO_STAGE_ID = {
+    [StageType.ORIGINAL] = StageID.HOME,
+    [StageType.WRATH_OF_THE_LAMB] = StageID.HOME,
+    [StageType.AFTERBIRTH] = StageID.HOME,
+    [StageType.GREED_MODE] = StageID.HOME,
+    [StageType.REPENTANCE] = StageID.HOME,
+    [StageType.REPENTANCE_B] = StageID.HOME
+}
+____exports.STAGE_TO_STAGE_ID = {
+    [LevelStage.BASEMENT_1] = BASEMENT_TO_STAGE_ID,
+    [LevelStage.BASEMENT_2] = BASEMENT_TO_STAGE_ID,
+    [LevelStage.CAVES_1] = CAVES_TO_STAGE_ID,
+    [LevelStage.CAVES_2] = CAVES_TO_STAGE_ID,
+    [LevelStage.DEPTHS_1] = DEPTHS_TO_STAGE_ID,
+    [LevelStage.DEPTHS_2] = DEPTHS_TO_STAGE_ID,
+    [LevelStage.WOMB_1] = WOMB_TO_STAGE_ID,
+    [LevelStage.WOMB_2] = WOMB_TO_STAGE_ID,
+    [LevelStage.BLUE_WOMB] = BLUE_WOMB_TO_STAGE_ID,
+    [LevelStage.SHEOL_CATHEDRAL] = SHEOL_CATHEDRAL_TO_STAGE_ID,
+    [LevelStage.DARK_ROOM_CHEST] = DARK_ROOM_CHEST_TO_STAGE_ID,
+    [LevelStage.THE_VOID] = VOID_TO_STAGE_ID,
+    [LevelStage.HOME] = HOME_TO_STAGE_ID
+}
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "21.5.3",
+  "version": "21.6.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/callbacks/InputActionFilter.ts

@@ -22,7 +22,6 @@ export class InputActionFilter extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/InputActionPlayer.ts

@@ -22,7 +22,6 @@ export class InputActionPlayer extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostCollectibleEmpty.ts

@@ -32,7 +32,6 @@ export class PostCollectibleEmpty extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostCustomRevive.ts

@@ -15,7 +15,6 @@ export class PostCustomRevive extends CustomCallback<ModCallbackCustom.POST_CUST
     this.featuresUsed = [ISCFeature.CUSTOM_REVIVE];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostDiceRoomActivated.ts

@@ -34,7 +34,6 @@ export class PostDiceRoomActivated extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostGridEntityCollision.ts

@@ -15,7 +15,6 @@ export class PostGridEntityCollision extends CustomCallback<T> {
     this.featuresUsed = [ISCFeature.GRID_ENTITY_COLLISION_DETECTION];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostGridEntityCustomCollision.ts

@@ -15,7 +15,6 @@ export class PostGridEntityCustomCollision extends CustomCallback<T> {
     this.featuresUsed = [ISCFeature.GRID_ENTITY_COLLISION_DETECTION];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostGridEntityCustomRemove.ts

@@ -15,7 +15,6 @@ export class PostGridEntityCustomRemove extends CustomCallback<T> {
     this.featuresUsed = [ISCFeature.GRID_ENTITY_UPDATE_DETECTION];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostGridEntityRemove.ts

@@ -15,7 +15,6 @@ export class PostGridEntityRemove extends CustomCallback<T> {
     this.featuresUsed = [ISCFeature.GRID_ENTITY_UPDATE_DETECTION];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostItemDischarge.ts

@@ -68,7 +68,6 @@ export class PostItemDischarge extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostKeyboardChanged.ts

@@ -26,7 +26,6 @@ export class PostKeyboardChanged extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostPurchase.ts

@@ -34,7 +34,6 @@ export class PostPurchase extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostRoomClearChanged.ts

@@ -29,7 +29,6 @@ export class PostRoomClearChanged extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PostTransformation.ts

@@ -34,7 +34,6 @@ export class PostTransformation extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PreEntitySpawnFilter.ts

@@ -18,7 +18,6 @@ export class PreEntitySpawnFilter extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/classes/callbacks/PreRoomEntitySpawnFilter.ts

@@ -22,7 +22,6 @@ export class PreRoomEntitySpawnFilter extends CustomCallback<T> {
     ];
   }
 
-  // eslint-disable-next-line class-methods-use-this
   protected override shouldFire = (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

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

@@ -127,8 +127,12 @@ export class CustomItemPools extends Feature {
       customItemPool,
       seedOrRNG,
     );
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    const tuple = customItemPool[randomIndex]!;
+    const tuple = customItemPool[randomIndex];
+    if (tuple === undefined) {
+      error(
+        `Failed to get an element from a custom item pool using a random index of: ${randomIndex}`,
+      );
+    }
 
     if (decrease) {
       arrayRemoveIndexInPlace(customItemPool, randomIndex);

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

@@ -40,7 +40,6 @@ export class RunInNFrames extends Feature {
     },
   };
 
-  // eslint-disable-next-line class-methods-use-this
   public override vConditionalFunc = (): boolean => false;
 
   private roomHistory: RoomHistory;

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

@@ -11,7 +11,6 @@ export class RunNextRoom extends Feature {
     },
   };
 
-  // eslint-disable-next-line class-methods-use-this
   public override vConditionalFunc = (): boolean => false;
 
   /** @internal */

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

@@ -31,7 +31,6 @@ export class TaintedLazarusPlayers extends Feature {
     },
   };
 
-  // eslint-disable-next-line class-methods-use-this
   public override vConditionalFunc = (): boolean => false;
 
   /** @internal */

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

@@ -179,8 +179,7 @@ function spawnWallEntity(
   wallEffect.SpriteOffset = modifiedOffset;
 
   sprite.LoadGraphics();
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-  const roomShapeName = RoomShape[roomShape]!;
+  const roomShapeName = RoomShape[roomShape];
   const animation = trimPrefix(roomShapeName, "SHAPE_");
   const modifiedAnimation = isExtraWall ? `${animation}X` : animation;
   sprite.Play(modifiedAnimation, true);
@@ -254,8 +253,7 @@ function spawnFloorEntity(customStage: CustomStage, rng: RNG) {
   floorEffect.SpriteOffset = modifiedOffset;
 
   sprite.LoadGraphics();
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-  const roomShapeName = RoomShape[roomShape]!;
+  const roomShapeName = RoomShape[roomShape];
   const animation = trimPrefix(roomShapeName, "SHAPE_");
   sprite.Play(animation, true);
 }

package/src/classes/private/CustomCallback.ts

@@ -81,7 +81,6 @@ export abstract class CustomCallback<
    * This method needs to be overwritten for any callback that has optional filtration arguments.
    * See "shouldFire.ts" for methods tailored to specific kinds of callbacks.
    */
-  // eslint-disable-next-line class-methods-use-this
   protected shouldFire: (
     fireArgs: FireArgs<T>,
     optionalArgs: OptionalArgs<T>,

package/src/functions/stage.ts

@@ -2,11 +2,13 @@ import {
   GameStateFlag,
   LevelStage,
   RoomType,
+  StageID,
   StageType,
 } from "isaac-typescript-definitions";
 import { game } from "../core/cachedClasses";
 import { ENGLISH_LEVEL_NAMES } from "../objects/englishLevelNames";
 import { ROOM_TYPE_GOTO_PREFIXES } from "../objects/roomTypeGotoPrefixes";
+import { STAGE_TO_STAGE_ID } from "../objects/stageToStageID";
 import { STAGE_TYPE_SUFFIXES } from "../objects/stageTypeSuffixes";
 import { STAGE_TYPE_TO_LETTER } from "../objects/stageTypeToLetter";
 import { asLevelStage, asNumber } from "./types";
@@ -88,7 +90,6 @@ export function getEffectiveStage(): LevelStage {
   return stage;
 }
 
-// eslint-disable-next-line isaacscript/complete-sentences-jsdoc
 /**
  * Helper function to get the English name of the level. For example, "Caves 1".
  *
@@ -134,6 +135,31 @@ export function getStage(): LevelStage {
   return level.GetStage();
 }
 
+/**
+ * Helper function to get the stage ID that corresponds to a particular floor. It does this by
+ * manually converting `LevelStage` and `StageType` into `StageID`. This is useful because
+ * `getRoomStageID` will not correctly return the `StageID` if the player is in a special room.
+ *
+ * @param stage Optional. If not specified, the stage corresponding to the current floor will be
+ *              used.
+ * @param stageType Optional. If not specified, the stage type corresponding to the current floor
+ *                  will be used.
+ */
+export function getStageID(stage?: LevelStage, stageType?: StageType): StageID {
+  const level = game.GetLevel();
+
+  if (stage === undefined) {
+    stage = level.GetStage();
+  }
+
+  if (stageType === undefined) {
+    stageType = level.GetStageType();
+  }
+
+  const stageTypeToStageID = STAGE_TO_STAGE_ID[stage];
+  return stageTypeToStageID[stageType];
+}
+
 /** Alias for the `Level.GetStageType` method. */
 export function getStageType(): StageType {
   const level = game.GetLevel();

package/src/functions/weighted.ts

@@ -13,8 +13,14 @@ export function getRandomFromWeightedArray<T>(
   seedOrRNG: Seed | RNG = getRandomSeed(),
 ): T {
   const randomIndex = getRandomIndexFromWeightedArray(weightedArray, seedOrRNG);
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-  const randomElement = weightedArray[randomIndex]!;
+
+  const randomElement = weightedArray[randomIndex];
+  if (randomElement === undefined) {
+    error(
+      `Failed to get an element from a weighted array using a random index of: ${randomIndex}`,
+    );
+  }
+
   return randomElement[0];
 }
 

package/src/interfaces/CustomStageTSConfig.ts

@@ -548,7 +548,6 @@ export interface CustomStageBossPoolEntry {
 
   /** Optional. A collection of sprites used for the boss on the "versus" screen. */
   versusScreen?: {
-    // eslint-disable-next-line isaacscript/complete-sentences-jsdoc
     /**
      * Mandatory. The full path to the spritesheet that contains the graphics of the name of the
      * boss that will be displayed on the top of the boss "versus" screen.
@@ -557,7 +556,6 @@ export interface CustomStageBossPoolEntry {
      */
     namePNGPath: string;
 
-    // eslint-disable-next-line isaacscript/complete-sentences-jsdoc
     /**
      * Mandatory. The full path to the spritesheet that contains the portrait of the boss that will
      * be displayed on the right side of the boss "versus" screen.

package/src/objects/englishLevelNames.ts

@@ -1,6 +1,5 @@
 import { LevelStage, StageType } from "isaac-typescript-definitions";
 
-// eslint-disable-next-line isaacscript/complete-sentences-jsdoc
 /**
  * A mapping of stage and stage types to the corresponding English level name.
  *

package/src/objects/stageToMusic.ts

@@ -1,98 +1,98 @@
 import { LevelStage, Music, StageType } from "isaac-typescript-definitions";
 
 const BASEMENT_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.BASEMENT,
-  [StageType.WRATH_OF_THE_LAMB]: Music.CELLAR,
-  [StageType.AFTERBIRTH]: Music.BURNING_BASEMENT,
-  [StageType.GREED_MODE]: Music.BASEMENT,
-  [StageType.REPENTANCE]: Music.DOWNPOUR,
-  [StageType.REPENTANCE_B]: Music.DROSS,
+  [StageType.ORIGINAL]: Music.BASEMENT, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.CELLAR, // 1
+  [StageType.AFTERBIRTH]: Music.BURNING_BASEMENT, // 2
+  [StageType.GREED_MODE]: Music.BASEMENT, // 3
+  [StageType.REPENTANCE]: Music.DOWNPOUR, // 4
+  [StageType.REPENTANCE_B]: Music.DROSS, // 5
 } as const satisfies Record<StageType, Music>;
 
 const CAVES_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.CAVES,
-  [StageType.WRATH_OF_THE_LAMB]: Music.CATACOMBS,
-  [StageType.AFTERBIRTH]: Music.FLOODED_CAVES,
-  [StageType.GREED_MODE]: Music.CAVES,
-  [StageType.REPENTANCE]: Music.MINES,
-  [StageType.REPENTANCE_B]: Music.ASHPIT,
+  [StageType.ORIGINAL]: Music.CAVES, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.CATACOMBS, // 1
+  [StageType.AFTERBIRTH]: Music.FLOODED_CAVES, // 2
+  [StageType.GREED_MODE]: Music.CAVES, // 3
+  [StageType.REPENTANCE]: Music.MINES, // 4
+  [StageType.REPENTANCE_B]: Music.ASHPIT, // 5
 } as const satisfies Record<StageType, Music>;
 
 const DEPTHS_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.DEPTHS,
-  [StageType.WRATH_OF_THE_LAMB]: Music.NECROPOLIS,
-  [StageType.AFTERBIRTH]: Music.DANK_DEPTHS,
-  [StageType.GREED_MODE]: Music.DEPTHS,
-  [StageType.REPENTANCE]: Music.MAUSOLEUM,
-  [StageType.REPENTANCE_B]: Music.GEHENNA,
+  [StageType.ORIGINAL]: Music.DEPTHS, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.NECROPOLIS, // 1
+  [StageType.AFTERBIRTH]: Music.DANK_DEPTHS, // 2
+  [StageType.GREED_MODE]: Music.DEPTHS, // 3
+  [StageType.REPENTANCE]: Music.MAUSOLEUM, // 4
+  [StageType.REPENTANCE_B]: Music.GEHENNA, // 5
 } as const satisfies Record<StageType, Music>;
 
 const WOMB_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.WOMB,
-  [StageType.WRATH_OF_THE_LAMB]: Music.UTERO,
-  [StageType.AFTERBIRTH]: Music.SCARRED_WOMB,
-  [StageType.GREED_MODE]: Music.WOMB,
-  [StageType.REPENTANCE]: Music.CORPSE,
-  [StageType.REPENTANCE_B]: Music.MORTIS,
+  [StageType.ORIGINAL]: Music.WOMB, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.UTERO, // 1
+  [StageType.AFTERBIRTH]: Music.SCARRED_WOMB, // 2
+  [StageType.GREED_MODE]: Music.WOMB, // 3
+  [StageType.REPENTANCE]: Music.CORPSE, // 4
+  [StageType.REPENTANCE_B]: Music.MORTIS, // 5
 } as const satisfies Record<StageType, Music>;
 
 const BLUE_WOMB_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.BLUE_WOMB,
-  [StageType.WRATH_OF_THE_LAMB]: Music.BLUE_WOMB,
-  [StageType.AFTERBIRTH]: Music.BLUE_WOMB,
-  [StageType.GREED_MODE]: Music.BLUE_WOMB,
-  [StageType.REPENTANCE]: Music.BLUE_WOMB,
-  [StageType.REPENTANCE_B]: Music.BLUE_WOMB,
+  [StageType.ORIGINAL]: Music.BLUE_WOMB, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.BLUE_WOMB, // 1
+  [StageType.AFTERBIRTH]: Music.BLUE_WOMB, // 2
+  [StageType.GREED_MODE]: Music.BLUE_WOMB, // 3
+  [StageType.REPENTANCE]: Music.BLUE_WOMB, // 4
+  [StageType.REPENTANCE_B]: Music.BLUE_WOMB, // 5
 } as const satisfies Record<StageType, Music>;
 
 const SHEOL_CATHEDRAL_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.SHEOL,
-  [StageType.WRATH_OF_THE_LAMB]: Music.CATHEDRAL,
-  [StageType.AFTERBIRTH]: Music.SHEOL,
-  [StageType.GREED_MODE]: Music.SHEOL,
-  [StageType.REPENTANCE]: Music.SHEOL,
-  [StageType.REPENTANCE_B]: Music.SHEOL,
+  [StageType.ORIGINAL]: Music.SHEOL, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.CATHEDRAL, // 1
+  [StageType.AFTERBIRTH]: Music.SHEOL, // 2
+  [StageType.GREED_MODE]: Music.SHEOL, // 3
+  [StageType.REPENTANCE]: Music.SHEOL, // 4
+  [StageType.REPENTANCE_B]: Music.SHEOL, // 5
 } as const satisfies Record<StageType, Music>;
 
 const DARK_ROOM_CHEST_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.DARK_ROOM,
-  [StageType.WRATH_OF_THE_LAMB]: Music.CHEST,
-  [StageType.AFTERBIRTH]: Music.DARK_ROOM,
-  [StageType.GREED_MODE]: Music.DARK_ROOM,
-  [StageType.REPENTANCE]: Music.DARK_ROOM,
-  [StageType.REPENTANCE_B]: Music.DARK_ROOM,
+  [StageType.ORIGINAL]: Music.DARK_ROOM, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.CHEST, // 1
+  [StageType.AFTERBIRTH]: Music.DARK_ROOM, // 2
+  [StageType.GREED_MODE]: Music.DARK_ROOM, // 3
+  [StageType.REPENTANCE]: Music.DARK_ROOM, // 4
+  [StageType.REPENTANCE_B]: Music.DARK_ROOM, // 5
 } as const satisfies Record<StageType, Music>;
 
-const THE_VOID_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.VOID,
-  [StageType.WRATH_OF_THE_LAMB]: Music.VOID,
-  [StageType.AFTERBIRTH]: Music.VOID,
-  [StageType.GREED_MODE]: Music.VOID,
-  [StageType.REPENTANCE]: Music.VOID,
-  [StageType.REPENTANCE_B]: Music.VOID,
+const VOID_TO_MUSIC = {
+  [StageType.ORIGINAL]: Music.VOID, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.VOID, // 1
+  [StageType.AFTERBIRTH]: Music.VOID, // 2
+  [StageType.GREED_MODE]: Music.VOID, // 3
+  [StageType.REPENTANCE]: Music.VOID, // 4
+  [StageType.REPENTANCE_B]: Music.VOID, // 5
 } as const satisfies Record<StageType, Music>;
 
 const HOME_TO_MUSIC = {
-  [StageType.ORIGINAL]: Music.ISAACS_HOUSE,
-  [StageType.WRATH_OF_THE_LAMB]: Music.ISAACS_HOUSE,
-  [StageType.AFTERBIRTH]: Music.ISAACS_HOUSE,
-  [StageType.GREED_MODE]: Music.ISAACS_HOUSE,
-  [StageType.REPENTANCE]: Music.ISAACS_HOUSE,
-  [StageType.REPENTANCE_B]: Music.ISAACS_HOUSE,
+  [StageType.ORIGINAL]: Music.ISAACS_HOUSE, // 0
+  [StageType.WRATH_OF_THE_LAMB]: Music.ISAACS_HOUSE, // 1
+  [StageType.AFTERBIRTH]: Music.ISAACS_HOUSE, // 2
+  [StageType.GREED_MODE]: Music.ISAACS_HOUSE, // 3
+  [StageType.REPENTANCE]: Music.ISAACS_HOUSE, // 4
+  [StageType.REPENTANCE_B]: Music.ISAACS_HOUSE, // 5
 } as const satisfies Record<StageType, Music>;
 
 export const STAGE_TO_MUSIC = {
-  [LevelStage.BASEMENT_1]: BASEMENT_TO_MUSIC,
-  [LevelStage.BASEMENT_2]: BASEMENT_TO_MUSIC,
-  [LevelStage.CAVES_1]: CAVES_TO_MUSIC,
-  [LevelStage.CAVES_2]: CAVES_TO_MUSIC,
-  [LevelStage.DEPTHS_1]: DEPTHS_TO_MUSIC,
-  [LevelStage.DEPTHS_2]: DEPTHS_TO_MUSIC,
-  [LevelStage.WOMB_1]: WOMB_TO_MUSIC,
-  [LevelStage.WOMB_2]: WOMB_TO_MUSIC,
-  [LevelStage.BLUE_WOMB]: BLUE_WOMB_TO_MUSIC,
-  [LevelStage.SHEOL_CATHEDRAL]: SHEOL_CATHEDRAL_TO_MUSIC,
-  [LevelStage.DARK_ROOM_CHEST]: DARK_ROOM_CHEST_TO_MUSIC,
-  [LevelStage.THE_VOID]: THE_VOID_TO_MUSIC,
-  [LevelStage.HOME]: HOME_TO_MUSIC,
+  [LevelStage.BASEMENT_1]: BASEMENT_TO_MUSIC, // 1
+  [LevelStage.BASEMENT_2]: BASEMENT_TO_MUSIC, // 2
+  [LevelStage.CAVES_1]: CAVES_TO_MUSIC, // 3
+  [LevelStage.CAVES_2]: CAVES_TO_MUSIC, // 4
+  [LevelStage.DEPTHS_1]: DEPTHS_TO_MUSIC, // 5
+  [LevelStage.DEPTHS_2]: DEPTHS_TO_MUSIC, // 6
+  [LevelStage.WOMB_1]: WOMB_TO_MUSIC, // 7
+  [LevelStage.WOMB_2]: WOMB_TO_MUSIC, // 8
+  [LevelStage.BLUE_WOMB]: BLUE_WOMB_TO_MUSIC, // 9
+  [LevelStage.SHEOL_CATHEDRAL]: SHEOL_CATHEDRAL_TO_MUSIC, // 10
+  [LevelStage.DARK_ROOM_CHEST]: DARK_ROOM_CHEST_TO_MUSIC, // 11
+  [LevelStage.THE_VOID]: VOID_TO_MUSIC, // 12
+  [LevelStage.HOME]: HOME_TO_MUSIC, // 13
 } as const satisfies Record<LevelStage, Record<StageType, Music>>;