isaacscript-common 81.0.5 → 82.0.0

package/dist/sets/bossSets.lua

@@ -2,13 +2,15 @@ local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__Spread = ____lualib.__TS__Spread
+local Set = ____lualib.Set
+local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
-local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+local StageID = ____isaac_2Dtypescript_2Ddefinitions.StageID
 local ____cachedEnumValues = require("arrays.cachedEnumValues")
-local BOSS_IDS = ____cachedEnumValues.BOSS_IDS
+local BOSS_ID_VALUES = ____cachedEnumValues.BOSS_ID_VALUES
 local ____set = require("functions.set")
 local combineSets = ____set.combineSets
 local ____storyBosses = require("functions.storyBosses")
@@ -17,7 +19,7 @@ local ____ReadonlyMap = require("types.ReadonlyMap")
 local ReadonlyMap = ____ReadonlyMap.ReadonlyMap
 local ____ReadonlySet = require("types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
---- Contains just the bosses in Basement (not e.g. Burning Basement).
+--- For `StageID.BASEMENT` (1).
 local BASEMENT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.MONSTRO,
     BossID.LARRY_JR,
@@ -34,7 +36,7 @@ local BASEMENT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.TURDLING,
     BossID.BABY_PLUM
 })
---- Contains just the bosses in Cellar (not e.g. Burning Basement).
+--- For `StageID.CELLAR` (2).
 local CELLAR_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.FAMINE,
     BossID.DUKE_OF_FLIES,
@@ -48,7 +50,7 @@ local CELLAR_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.RAG_MAN,
     BossID.BABY_PLUM
 })
---- Contains just the bosses in Burning Basement (not e.g. Cellar).
+--- For `StageID.BURNING_BASEMENT` (3).
 local BURNING_BASEMENT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.MONSTRO,
     BossID.LARRY_JR,
@@ -66,9 +68,9 @@ local BURNING_BASEMENT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.TURDLING,
     BossID.BABY_PLUM
 })
---- Contains just the bosses in Downpour (not e.g. Burning Basement).
+--- For `StageID.DOWNPOUR` (27).
 local DOWNPOUR_BOSSES_SET = __TS__New(ReadonlySet, {BossID.LIL_BLUB, BossID.WORMWOOD, BossID.RAINMAKER, BossID.MIN_MIN})
---- Contains just the bosses in Dross (not e.g. Burning Basement).
+--- For `StageID.DROSS` (28).
 local DROSS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.LIL_BLUB,
     BossID.WORMWOOD,
@@ -76,7 +78,7 @@ local DROSS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.COLOSTOMIA,
     BossID.TURDLET
 })
---- The set of unique bosses for Basement, Cellar, and so on.
+--- The set of unique bosses for Basement, Cellar, Burning Basement, Downpour, and Dross.
 local ALL_BASEMENT_BOSSES_SET = combineSets(
     nil,
     BASEMENT_BOSSES_SET,
@@ -85,14 +87,7 @@ local ALL_BASEMENT_BOSSES_SET = combineSets(
     DOWNPOUR_BOSSES_SET,
     DROSS_BOSSES_SET
 )
-local BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
-    {StageType.ORIGINAL, BASEMENT_BOSSES_SET},
-    {StageType.WRATH_OF_THE_LAMB, CELLAR_BOSSES_SET},
-    {StageType.AFTERBIRTH, BURNING_BASEMENT_BOSSES_SET},
-    {StageType.REPENTANCE, DOWNPOUR_BOSSES_SET},
-    {StageType.REPENTANCE_B, DROSS_BOSSES_SET}
-})
---- Contains just the bosses in Caves (not e.g. Flooded Caves).
+--- For `StageID.CAVES` (4).
 local CAVES_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.CHUB,
     BossID.GURDY,
@@ -110,7 +105,7 @@ local CAVES_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.BIG_HORN,
     BossID.BUMBINO
 })
---- Contains just the bosses in Catacombs (not e.g. Flooded Caves).
+--- For `StageID.CATACOMBS` (5).
 local CATACOMBS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.PESTILENCE,
     BossID.PEEP,
@@ -129,7 +124,7 @@ local CATACOMBS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.BIG_HORN,
     BossID.BUMBINO
 })
---- Contains just the bosses in Flooded Caves (not e.g. Catacombs).
+--- For `StageID.FLOODED_CAVES` (6).
 local FLOODED_CAVES_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.CHUB,
     BossID.GURDY,
@@ -149,9 +144,9 @@ local FLOODED_CAVES_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.BIG_HORN,
     BossID.BUMBINO
 })
---- Contains just the bosses in Mines (not e.g. Flooded Caves).
+--- For `StageID.MINES` (29).
 local MINES_BOSSES_SET = __TS__New(ReadonlySet, {BossID.REAP_CREEP, BossID.TUFF_TWINS, BossID.HORNFEL, BossID.GREAT_GIDEON})
---- Contains just the bosses in Ashpit (not e.g. Flooded Caves).
+--- For `StageID.ASHPIT` (30).
 local ASHPIT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.PILE,
     BossID.GREAT_GIDEON,
@@ -159,7 +154,7 @@ local ASHPIT_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.SHELL,
     BossID.CLUTCH
 })
---- The set of unique bosses for Caves, Catacombs, and so on.
+--- The set of unique bosses for Caves, Catacombs, Flooded Caves, Mines, and Ashpit.
 local ALL_CAVES_BOSSES_SET = combineSets(
     nil,
     CAVES_BOSSES_SET,
@@ -168,14 +163,7 @@ local ALL_CAVES_BOSSES_SET = combineSets(
     MINES_BOSSES_SET,
     ASHPIT_BOSSES_SET
 )
-local CAVES_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
-    {StageType.ORIGINAL, CAVES_BOSSES_SET},
-    {StageType.WRATH_OF_THE_LAMB, CATACOMBS_BOSSES_SET},
-    {StageType.AFTERBIRTH, FLOODED_CAVES_BOSSES_SET},
-    {StageType.REPENTANCE, MINES_BOSSES_SET},
-    {StageType.REPENTANCE_B, ASHPIT_BOSSES_SET}
-})
---- Contains just the bosses in Depths (not e.g. Dank Depths).
+--- For `StageID.DEPTHS` (7).
 -- 
 -- Note that this set includes Mom, even though they are not technically in the boss pool.
 local DEPTHS_BOSSES_SET = __TS__New(ReadonlySet, {
@@ -192,7 +180,7 @@ local DEPTHS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.SISTERS_VIS,
     BossID.REAP_CREEP
 })
---- Contains just the bosses in Necropolis (not e.g. Dank Depths).
+--- For `StageID.NECROPOLIS` (8).
 -- 
 -- Note that this set includes Mom, even though they are not technically in the boss pool.
 local NECROPOLIS_BOSSES_SET = __TS__New(ReadonlySet, {
@@ -208,7 +196,7 @@ local NECROPOLIS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.SISTERS_VIS,
     BossID.PILE
 })
---- Contains just the bosses in Dank Depths (not e.g. Necropolis).
+--- For `StageID.DANK_DEPTHS` (9).
 -- 
 -- Note that this set includes Mom, even though they are not technically in the boss pool.
 local DANK_DEPTHS_BOSSES_SET = __TS__New(ReadonlySet, {
@@ -225,15 +213,15 @@ local DANK_DEPTHS_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.SISTERS_VIS,
     BossID.REAP_CREEP
 })
---- Contains just the bosses in Mausoleum (not e.g. Dank Depths).
+--- For `StageID.MAUSOLEUM` (31).
 -- 
 -- Note that this set includes Mausoleum Mom, even though they are not technically in the boss pool.
 local MAUSOLEUM_BOSSES_SET = __TS__New(ReadonlySet, {BossID.SIREN, BossID.HERETIC, BossID.MAUSOLEUM_MOM})
---- Contains just the bosses in Gehenna (not e.g. Dank Depths).
+--- For `StageID.GEHENNA` (32).
 -- 
 -- Note that this set includes Mausoleum Mom, even though they are not technically in the boss pool.
 local GEHENNA_BOSSES_SET = __TS__New(ReadonlySet, {BossID.VISAGE, BossID.MAUSOLEUM_MOM, BossID.HORNY_BOYS})
---- The set of unique bosses for Depths, Necropolis, and so on.
+--- The set of unique bosses for Depths, Necropolis, Dank Depths, Mausoleum, and Gehenna.
 local ALL_DEPTHS_BOSSES_SET = combineSets(
     nil,
     DEPTHS_BOSSES_SET,
@@ -242,14 +230,7 @@ local ALL_DEPTHS_BOSSES_SET = combineSets(
     MAUSOLEUM_BOSSES_SET,
     GEHENNA_BOSSES_SET
 )
-local DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
-    {StageType.ORIGINAL, DEPTHS_BOSSES_SET},
-    {StageType.WRATH_OF_THE_LAMB, NECROPOLIS_BOSSES_SET},
-    {StageType.AFTERBIRTH, DANK_DEPTHS_BOSSES_SET},
-    {StageType.REPENTANCE, MAUSOLEUM_BOSSES_SET},
-    {StageType.REPENTANCE_B, GEHENNA_BOSSES_SET}
-})
---- Contains just the bosses in Womb (not e.g. Scarred Womb).
+--- For `StageID.WOMB` (10).
 -- 
 -- Note that this set includes Mom's Heart & It Lives, even though they are not technically in the
 -- boss pool.
@@ -267,7 +248,7 @@ local WOMB_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.MR_FRED,
     BossID.MATRIARCH
 })
---- Contains just the bosses in Utero (not e.g. Scarred Womb).
+--- For `StageID.UTERO` (11).
 -- 
 -- Note that this set includes Mom's Heart & It Lives, even though they are not technically in the
 -- boss pool.
@@ -284,7 +265,7 @@ local UTERO_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.DADDY_LONG_LEGS,
     BossID.TRIACHNID
 })
---- Contains just the bosses in Scarred Womb (not e.g. Utero).
+--- For `StageID.SCARRED_WOMB` (12).
 -- 
 -- Note that this set includes Mom's Heart & It Lives, even though they are not technically in the
 -- boss pool.
@@ -303,11 +284,11 @@ local SCARRED_WOMB_BOSSES_SET = __TS__New(ReadonlySet, {
     BossID.MR_FRED,
     BossID.MATRIARCH
 })
---- Contains just the bosses in Corpse (not e.g. Scarred Womb).
+--- For `StageID.CORPSE` (33).
 -- 
--- Note that this set includes Mother, even though they are not technically in the boss pool.
+-- Note that this set includes Mother, even though she is not technically in the boss pool.
 local CORPSE_BOSSES_SET = __TS__New(ReadonlySet, {BossID.SCOURGE, BossID.CHIMERA, BossID.ROTGUT, BossID.MOTHER})
---- The set of unique bosses for Womb, Utero, and so on.
+--- The set of unique bosses for Womb, Utero, Scarred Womb, and Corpse.
 local ALL_WOMB_BOSSES_SET = combineSets(
     nil,
     WOMB_BOSSES_SET,
@@ -315,38 +296,46 @@ local ALL_WOMB_BOSSES_SET = combineSets(
     SCARRED_WOMB_BOSSES_SET,
     CORPSE_BOSSES_SET
 )
-local WOMB_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, WOMB_BOSSES_SET}, {StageType.WRATH_OF_THE_LAMB, UTERO_BOSSES_SET}, {StageType.AFTERBIRTH, SCARRED_WOMB_BOSSES_SET}, {StageType.REPENTANCE, CORPSE_BOSSES_SET}})
 local BLUE_WOMB_BOSSES_SET = __TS__New(ReadonlySet, {BossID.HUSH})
-local BLUE_WOMB_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, BLUE_WOMB_BOSSES_SET}})
 local SHEOL_BOSSES_SET = __TS__New(ReadonlySet, {BossID.SATAN})
 local CATHEDRAL_BOSSES_SET = __TS__New(ReadonlySet, {BossID.ISAAC})
 local ALL_STAGE_10_BOSSES_SET = combineSets(nil, SHEOL_BOSSES_SET, CATHEDRAL_BOSSES_SET)
-local STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, SHEOL_BOSSES_SET}, {StageType.WRATH_OF_THE_LAMB, CATHEDRAL_BOSSES_SET}})
 --- Note that this set includes Mega Satan, even though they are not technically in the boss pool.
 local DARK_ROOM_BOSSES_SET = __TS__New(ReadonlySet, {BossID.LAMB, BossID.MEGA_SATAN})
 --- Note that this set includes Mega Satan, even though they are not technically in the boss pool.
 local CHEST_BOSSES_SET = __TS__New(ReadonlySet, {BossID.BLUE_BABY, BossID.MEGA_SATAN})
 local ALL_STAGE_11_BOSSES_SET = combineSets(nil, DARK_ROOM_BOSSES_SET, CHEST_BOSSES_SET)
-local STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, DARK_ROOM_BOSSES_SET}, {StageType.WRATH_OF_THE_LAMB, CHEST_BOSSES_SET}})
 local VOID_BOSSES_SET = __TS__New(ReadonlySet, {BossID.DELIRIUM})
-local VOID_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, VOID_BOSSES_SET}})
---- Note that this does not include Ultra Famine, Ultra Pestilence, Ultra War, and Ultra Death.
+--- Includes Dogma and The Beast. Does not include Ultra Famine, Ultra Pestilence, Ultra War, and
+-- Ultra Death (since they do not have boss IDs).
 local HOME_BOSSES_SET = __TS__New(ReadonlySet, {BossID.DOGMA, BossID.BEAST})
-local HOME_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, HOME_BOSSES_SET}})
-____exports.STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
-    {LevelStage.BASEMENT_1, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.BASEMENT_2, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.CAVES_1, CAVES_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.CAVES_2, CAVES_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.DEPTHS_1, DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.DEPTHS_2, DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.WOMB_1, WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.WOMB_2, WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.BLUE_WOMB, BLUE_WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.SHEOL_CATHEDRAL, STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.DARK_ROOM_CHEST, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.VOID, VOID_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {LevelStage.HOME, HOME_STAGE_TYPE_TO_BOSS_SET_MAP}
+____exports.STAGE_ID_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
+    {StageID.BASEMENT, BASEMENT_BOSSES_SET},
+    {StageID.CELLAR, CELLAR_BOSSES_SET},
+    {StageID.BURNING_BASEMENT, BURNING_BASEMENT_BOSSES_SET},
+    {StageID.DOWNPOUR, DOWNPOUR_BOSSES_SET},
+    {StageID.DROSS, DROSS_BOSSES_SET},
+    {StageID.CAVES, CAVES_BOSSES_SET},
+    {StageID.CATACOMBS, CATACOMBS_BOSSES_SET},
+    {StageID.FLOODED_CAVES, FLOODED_CAVES_BOSSES_SET},
+    {StageID.MINES, MINES_BOSSES_SET},
+    {StageID.ASHPIT, ASHPIT_BOSSES_SET},
+    {StageID.DEPTHS, DEPTHS_BOSSES_SET},
+    {StageID.NECROPOLIS, NECROPOLIS_BOSSES_SET},
+    {StageID.DANK_DEPTHS, DANK_DEPTHS_BOSSES_SET},
+    {StageID.MAUSOLEUM, MAUSOLEUM_BOSSES_SET},
+    {StageID.GEHENNA, GEHENNA_BOSSES_SET},
+    {StageID.WOMB, WOMB_BOSSES_SET},
+    {StageID.UTERO, UTERO_BOSSES_SET},
+    {StageID.SCARRED_WOMB, SCARRED_WOMB_BOSSES_SET},
+    {StageID.CORPSE, CORPSE_BOSSES_SET},
+    {StageID.BLUE_WOMB, BLUE_WOMB_BOSSES_SET},
+    {StageID.SHEOL, SHEOL_BOSSES_SET},
+    {StageID.CATHEDRAL, CATHEDRAL_BOSSES_SET},
+    {StageID.DARK_ROOM, DARK_ROOM_BOSSES_SET},
+    {StageID.CHEST, CHEST_BOSSES_SET},
+    {StageID.VOID, VOID_BOSSES_SET},
+    {StageID.HOME, HOME_BOSSES_SET}
 })
 ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {LevelStage.BASEMENT_1, ALL_BASEMENT_BOSSES_SET},
@@ -366,7 +355,7 @@ ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
 ____exports.ALL_BOSSES_SET = __TS__New(
     ReadonlySet,
     __TS__ArrayFilter(
-        BOSS_IDS,
+        BOSS_ID_VALUES,
         function(____, bossID) return bossID ~= BossID.RAGLICH end
     )
 )
@@ -377,4 +366,19 @@ ____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = __TS__New(
         function(____, bossID) return not isStoryBossID(nil, bossID) end
     )
 )
+____exports.BOSS_ID_TO_STAGE_IDS = (function()
+    local bossIDsToStageIDs = {}
+    for ____, bossID in ipairs(BOSS_ID_VALUES) do
+        local stageIDs = __TS__New(Set)
+        for ____, ____value in __TS__Iterator(____exports.STAGE_ID_TO_BOSS_SET_MAP) do
+            local stageID = ____value[1]
+            local bossSet = ____value[2]
+            if bossSet:has(bossID) then
+                stageIDs:add(stageID)
+            end
+        end
+        bossIDsToStageIDs[bossID] = stageIDs
+    end
+    return bossIDsToStageIDs
+end)(nil)
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "81.0.5",
+  "version": "82.0.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -37,6 +37,6 @@
     "lint": "tsx --tsconfig ./scripts/tsconfig.json ./scripts/lint.mts"
   },
   "dependencies": {
-    "isaac-typescript-definitions": "^39.0.5"
+    "isaac-typescript-definitions": "^39.0.6"
   }
 }

package/src/arrays/cachedEnumValues.ts

@@ -27,64 +27,48 @@ import { PlayerStat } from "../enums/PlayerStat";
 import { SerializationBrand } from "../enums/private/SerializationBrand";
 import { getEnumValues } from "../functions/enums";
 
-export const ACTIVE_SLOT_VALUES: readonly ActiveSlot[] =
-  getEnumValues(ActiveSlot);
+export const ACTIVE_SLOT_VALUES = getEnumValues(ActiveSlot);
 
-export const BOSS_IDS: readonly BossID[] = getEnumValues(BossID);
+export const BOSS_ID_VALUES = getEnumValues(BossID);
 
-export const CACHE_FLAG_VALUES: readonly CacheFlag[] = getEnumValues(CacheFlag);
+export const CACHE_FLAG_VALUES = getEnumValues(CacheFlag);
 
-export const CONTROLLER_INDEX_VALUES: readonly ControllerIndex[] =
-  getEnumValues(ControllerIndex);
+export const CONTROLLER_INDEX_VALUES = getEnumValues(ControllerIndex);
 
-export const DOOR_SLOT_FLAG_VALUES: readonly DoorSlotFlag[] =
-  getEnumValues(DoorSlotFlag);
+export const DOOR_SLOT_FLAG_VALUES = getEnumValues(DoorSlotFlag);
 
-export const DOOR_SLOT_VALUES: readonly DoorSlot[] = getEnumValues(DoorSlot);
+export const DOOR_SLOT_VALUES = getEnumValues(DoorSlot);
 
-export const GRID_ENTITY_TYPE_VALUES: readonly GridEntityType[] =
-  getEnumValues(GridEntityType);
+export const GRID_ENTITY_TYPE_VALUES = getEnumValues(GridEntityType);
 
-export const GRID_ENTITY_XML_TYPE_VALUES: readonly GridEntityXMLType[] =
-  getEnumValues(GridEntityXMLType);
+export const GRID_ENTITY_XML_TYPE_VALUES = getEnumValues(GridEntityXMLType);
 
-export const MOD_CALLBACK_CUSTOM_VALUES: readonly ModCallbackCustom[] =
-  getEnumValues(ModCallbackCustom);
+export const MOD_CALLBACK_CUSTOM_VALUES = getEnumValues(ModCallbackCustom);
 
-export const ITEM_CONFIG_TAG_VALUES: readonly ItemConfigTag[] =
-  getEnumValues(ItemConfigTag);
+export const ITEM_CONFIG_TAG_VALUES = getEnumValues(ItemConfigTag);
 
-export const ITEM_CONFIG_CARD_TYPE_VALUES: readonly ItemConfigCardType[] =
-  getEnumValues(ItemConfigCardType);
+export const ITEM_CONFIG_CARD_TYPE_VALUES = getEnumValues(ItemConfigCardType);
 
-export const ITEM_POOL_TYPE_VALUES: readonly ItemPoolType[] =
-  getEnumValues(ItemPoolType);
+export const ITEM_POOL_TYPE_VALUES = getEnumValues(ItemPoolType);
 
-export const KEYBOARD_VALUES: readonly Keyboard[] = getEnumValues(Keyboard);
+export const KEYBOARD_VALUES = getEnumValues(Keyboard);
 
-export const HEALTH_TYPE_VALUES: readonly HealthType[] =
-  getEnumValues(HealthType);
+export const HEALTH_TYPE_VALUES = getEnumValues(HealthType);
 
-export const PILL_COLOR_VALUES: readonly PillColor[] = getEnumValues(PillColor);
+export const PILL_COLOR_VALUES = getEnumValues(PillColor);
 
-export const PLAYER_FORM_VALUES: readonly PlayerForm[] =
-  getEnumValues(PlayerForm);
+export const PLAYER_FORM_VALUES = getEnumValues(PlayerForm);
 
-export const POCKET_ITEM_SLOT_VALUES: readonly PocketItemSlot[] =
-  getEnumValues(PocketItemSlot);
+export const POCKET_ITEM_SLOT_VALUES = getEnumValues(PocketItemSlot);
 
-export const ROOM_SHAPE_VALUES: readonly RoomShape[] = getEnumValues(RoomShape);
+export const ROOM_SHAPE_VALUES = getEnumValues(RoomShape);
 
-export const SEED_EFFECTS: readonly SeedEffect[] = getEnumValues(SeedEffect);
+export const SEED_EFFECTS = getEnumValues(SeedEffect);
 
-export const SERIALIZATION_BRAND_VALUES: readonly SerializationBrand[] =
-  getEnumValues(SerializationBrand);
+export const SERIALIZATION_BRAND_VALUES = getEnumValues(SerializationBrand);
 
-export const SOUND_EFFECT_VALUES: readonly SoundEffect[] =
-  getEnumValues(SoundEffect);
+export const SOUND_EFFECT_VALUES = getEnumValues(SoundEffect);
 
-export const PLAYER_STAT_VALUES: readonly PlayerStat[] =
-  getEnumValues(PlayerStat);
+export const PLAYER_STAT_VALUES = getEnumValues(PlayerStat);
 
-export const TRINKET_SLOT_VALUES: readonly TrinketSlot[] =
-  getEnumValues(TrinketSlot);
+export const TRINKET_SLOT_VALUES = getEnumValues(TrinketSlot);

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

@@ -244,7 +244,7 @@ export class CustomStages extends Feature {
     }
 
     if (!this.usingRedKey) {
-      return;
+      return undefined;
     }
     this.usingRedKey = false;
 
@@ -277,7 +277,7 @@ export class CustomStages extends Feature {
   ): Record<string, unknown> | undefined => {
     const customStage = v.run.currentCustomStage;
     if (customStage === null) {
-      return;
+      return undefined;
     }
 
     streakTextGetShaderParams(customStage, shaderName);

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

@@ -108,11 +108,11 @@ export class Pause extends Feature {
     buttonAction: ButtonAction,
   ): boolean | float | undefined => {
     if (buttonAction !== ButtonAction.SHOOT_RIGHT) {
-      return;
+      return undefined;
     }
 
     if (!v.run.shouldUnpause) {
-      return;
+      return undefined;
     }
     v.run.shouldUnpause = false;
 

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

@@ -76,7 +76,7 @@ export class PreventGridEntityRespawn extends Feature {
 
     const roomListIndex = getRoomListIndex();
     if (!v.level.roomListIndexToDecorationGridIndexes.has(roomListIndex)) {
-      return;
+      return undefined;
     }
 
     // Since the room was filled with decorations to prevent any grid entities from respawning, if

package/src/functions/bosses.ts

@@ -1,4 +1,4 @@
-import type { LevelStage, StageType } from "isaac-typescript-definitions";
+import type { LevelStage, StageID } from "isaac-typescript-definitions";
 import {
   BossID,
   EntityType,
@@ -13,8 +13,9 @@ import { BOSS_NAMES, DEFAULT_BOSS_NAME } from "../objects/bossNames";
 import {
   ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET,
   ALL_BOSSES_SET,
+  BOSS_ID_TO_STAGE_IDS,
+  STAGE_ID_TO_BOSS_SET_MAP,
   STAGE_TO_COMBINED_BOSS_SET_MAP,
-  STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP,
 } from "../sets/bossSets";
 import { REPENTANCE_ONLY_BOSS_IDS_SET } from "../sets/repentanceBossIDsSet";
 import { SIN_ENTITY_TYPES_SET } from "../sets/sinEntityTypesSet";
@@ -147,16 +148,13 @@ export function getBossName(bossID: BossID): string {
  *
  * Also see the `getAllBossesSet` and `getCombinedBossSet` functions.
  */
-export function getBossSet(
-  stage: LevelStage,
-  stageType: StageType,
-): ReadonlySet<BossID> | undefined {
-  const stageTypeMap = STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP.get(stage);
-  if (stageTypeMap === undefined) {
-    return undefined;
-  }
+export function getBossSet(stageID: StageID): ReadonlySet<BossID> | undefined {
+  return STAGE_ID_TO_BOSS_SET_MAP.get(stageID);
+}
 
-  return stageTypeMap.get(stageType);
+/** Helper function to get the set of stage IDs that a particular boss naturally appears in. */
+export function getBossStageIDs(bossID: BossID): ReadonlySet<StageID> {
+  return BOSS_ID_TO_STAGE_IDS[bossID];
 }
 
 /**

package/src/functions/gridEntities.ts

@@ -1226,7 +1226,7 @@ export function spawnGridEntityWithVariant(
     if (removeExistingGridEntity) {
       removeGridEntity(existingGridEntity, true);
     } else {
-      return;
+      return undefined;
     }
   }