isaacscript-common 47.4.0 → 47.5.3

package/dist/index.rollup.d.ts

@@ -4724,8 +4724,11 @@ export declare function getAliveNPCs(entityType?: EntityType | -1, variant?: num
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
- * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
- * and Gabriel.).
+ * Note that this set does not include:
+ * - mini-bosses (e.g. Ultra Pride, Krampus)
+ * - bosses that do not appear in Boss Rooms (e.g. Uriel, Gabriel)
+ * - the second phase of multi-phase bosses (e.g. Mega Satan 2), with the exception of The Beast
+ *   (Ultra Famine, Ultra Pestilence, Ultra War, and Ultra Death are included)
  *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *
@@ -14033,9 +14036,9 @@ export declare function onFirstFloor(): boolean;
 export declare function onRepentanceStage(): boolean;
 
 /**
- * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
- * pressing tab on the character selection screen). When the player resets the game on a set seed,
- * the game will not switch to a different seed.
+ * Helper function to check whether the player is playing on a set seed (i.e. that they entered in a
+ * specific seed by pressing tab on the character selection screen). When the player resets the game
+ * on a set seed, the game will not switch to a different seed.
  *
  * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
  * `Seeds.IsCustomRun` method.
@@ -14115,6 +14118,12 @@ export declare function onStageWithShovelTrapdoors(): boolean;
  */
 export declare function onStageWithStoryBoss(): boolean;
 
+/**
+ * Helper function to check whether the player is on a Victory Lap (i.e. they answered "yes" to the
+ * popup that happens after defeating The Lamb).
+ */
+export declare function onVictoryLap(): boolean;
+
 /**
  * For the purposes of this function, doors to Secret Rooms or Super Secret Rooms that have not been
  * discovered yet will not be opened.
@@ -16642,8 +16651,8 @@ export declare function setTrinketSprite(trinket: EntityPickup, pngPath: string
 /**
  * Helper function to change the run status to that of an unseeded run with a new random seed.
  *
- * This is useful to revert the behavior where playing on a set and restarting the game will not
- * take you to a new seed.
+ * This is useful to revert the behavior where playing on a set seed and restarting the game will
+ * not take you to a new seed.
  *
  * Under the hood, this function calls the `Seeds.Reset` method and the
  * `Seeds.Restart(Challenge.NULL)` method.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 47.4.0
+isaacscript-common 47.5.3
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -22554,6 +22554,10 @@ function ____exports.onSetSeed(self)
     local challenge = Isaac.GetChallenge()
     return challenge == Challenge.NULL and customRun
 end
+function ____exports.onVictoryLap(self)
+    local numVictoryLaps = game:GetVictoryLap()
+    return numVictoryLaps > 0
+end
 function ____exports.restart(self, character)
     if character == nil then
         local command = "restart"
@@ -43741,14 +43745,11 @@ return ____exports
 ["src.sets.bossSets"] = function(...) 
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
-local __TS__Spread = ____lualib.__TS__Spread
-local __TS__SparseArrayNew = ____lualib.__TS__SparseArrayNew
-local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
-local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
 local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
-local getAllBossesExcludingStoryBossesSet
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local BeastVariant = ____isaac_2Dtypescript_2Ddefinitions.BeastVariant
 local BigHornVariant = ____isaac_2Dtypescript_2Ddefinitions.BigHornVariant
 local ChubVariant = ____isaac_2Dtypescript_2Ddefinitions.ChubVariant
 local DaddyLongLegsVariant = ____isaac_2Dtypescript_2Ddefinitions.DaddyLongLegsVariant
@@ -43781,6 +43782,7 @@ local WidowVariant = ____isaac_2Dtypescript_2Ddefinitions.WidowVariant
 local ____entities = require("src.functions.entities")
 local parseEntityTypeVariantString = ____entities.parseEntityTypeVariantString
 local ____set = require("src.functions.set")
+local combineSets = ____set.combineSets
 local copySet = ____set.copySet
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
@@ -43790,19 +43792,6 @@ local ____ReadonlySet = require("src.types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____storyBossesSet = require("src.sets.storyBossesSet")
 local STORY_BOSSES_SET = ____storyBossesSet.STORY_BOSSES_SET
-function getAllBossesExcludingStoryBossesSet(self)
-    local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
-    local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
-    for ____, entityTypeVariantString in ipairs(allBosses) do
-        local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
-        assertDefined(nil, tuple, "Failed to parse a boss tuple when constructing the story boss set.")
-        local entityType, _variant = table.unpack(tuple)
-        if STORY_BOSSES_SET:has(entityType) then
-            allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
-        end
-    end
-    return allBossesExcludingStoryBossesSet
-end
 local BASEMENT_BOSSES_SET = __TS__New(
     ReadonlySet,
     {
@@ -43877,27 +43866,13 @@ local DROSS_BOSSES_SET = __TS__New(
         tostring(EntityType.TURDLET) .. ".0"
     }
 )
-local ____ReadonlySet_1 = ReadonlySet
-local ____array_0 = __TS__SparseArrayNew(__TS__Spread(BASEMENT_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(CELLAR_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(BURNING_BASEMENT_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(DOWNPOUR_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(DROSS_BOSSES_SET:values())
-)
-local ALL_BASEMENT_BOSSES_SET = __TS__New(
-    ____ReadonlySet_1,
-    {__TS__SparseArraySpread(____array_0)}
+local ALL_BASEMENT_BOSSES_SET = combineSets(
+    nil,
+    BASEMENT_BOSSES_SET,
+    CELLAR_BOSSES_SET,
+    BURNING_BASEMENT_BOSSES_SET,
+    DOWNPOUR_BOSSES_SET,
+    DROSS_BOSSES_SET
 )
 local BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, BASEMENT_BOSSES_SET},
@@ -43988,27 +43963,13 @@ local ASHPIT_BOSSES_SET = __TS__New(
         tostring(EntityType.CLUTCH) .. ".0"
     }
 )
-local ____ReadonlySet_3 = ReadonlySet
-local ____array_2 = __TS__SparseArrayNew(__TS__Spread(CAVES_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(CATACOMBS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(FLOODED_CAVES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(MINES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(ASHPIT_BOSSES_SET:values())
-)
-local ALL_CAVES_BOSSES_SET = __TS__New(
-    ____ReadonlySet_3,
-    {__TS__SparseArraySpread(____array_2)}
+local ALL_CAVES_BOSSES_SET = combineSets(
+    nil,
+    CAVES_BOSSES_SET,
+    CATACOMBS_BOSSES_SET,
+    FLOODED_CAVES_BOSSES_SET,
+    MINES_BOSSES_SET,
+    ASHPIT_BOSSES_SET
 )
 local CAVES_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, CAVES_BOSSES_SET},
@@ -44083,27 +44044,13 @@ local GEHENNA_BOSSES_SET = __TS__New(
         tostring(EntityType.HORNY_BOYS) .. ".0"
     }
 )
-local ____ReadonlySet_5 = ReadonlySet
-local ____array_4 = __TS__SparseArrayNew(__TS__Spread(DEPTHS_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(NECROPOLIS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(DANK_DEPTHS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(MAUSOLEUM_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(GEHENNA_BOSSES_SET:values())
-)
-local ALL_DEPTHS_BOSSES_SET = __TS__New(
-    ____ReadonlySet_5,
-    {__TS__SparseArraySpread(____array_4)}
+local ALL_DEPTHS_BOSSES_SET = combineSets(
+    nil,
+    DEPTHS_BOSSES_SET,
+    NECROPOLIS_BOSSES_SET,
+    DANK_DEPTHS_BOSSES_SET,
+    MAUSOLEUM_BOSSES_SET,
+    GEHENNA_BOSSES_SET
 )
 local DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, DEPTHS_BOSSES_SET},
@@ -44172,27 +44119,13 @@ local CORPSE_BOSSES_SET = __TS__New(
         tostring(EntityType.MOTHER) .. ".0"
     }
 )
-local ____ReadonlySet_7 = ReadonlySet
-local ____array_6 = __TS__SparseArrayNew(__TS__Spread(WOMB_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(UTERO_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(SCARRED_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(MAUSOLEUM_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(GEHENNA_BOSSES_SET:values())
-)
-local ALL_WOMB_BOSSES_SET = __TS__New(
-    ____ReadonlySet_7,
-    {__TS__SparseArraySpread(____array_6)}
+local ALL_WOMB_BOSSES_SET = combineSets(
+    nil,
+    WOMB_BOSSES_SET,
+    UTERO_BOSSES_SET,
+    SCARRED_WOMB_BOSSES_SET,
+    MAUSOLEUM_BOSSES_SET,
+    GEHENNA_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(
@@ -44208,36 +44141,41 @@ local CATHEDRAL_BOSSES_SET = __TS__New(
     ReadonlySet,
     {(tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.ISAAC)}
 )
-local ____ReadonlySet_9 = ReadonlySet
-local ____array_8 = __TS__SparseArrayNew(__TS__Spread(SHEOL_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_8,
-    __TS__Spread(CATHEDRAL_BOSSES_SET:values())
-)
-local ALL_STAGE_10_BOSSES_SET = __TS__New(
-    ____ReadonlySet_9,
-    {__TS__SparseArraySpread(____array_8)}
-)
+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}})
 local DARK_ROOM_BOSSES_SET = __TS__New(
     ReadonlySet,
-    {(tostring(EntityType.THE_LAMB) .. ".") .. tostring(LambVariant.LAMB)}
+    {
+        (tostring(EntityType.THE_LAMB) .. ".") .. tostring(LambVariant.LAMB),
+        tostring(EntityType.MEGA_SATAN) .. ".0"
+    }
 )
 local CHEST_BOSSES_SET = __TS__New(
     ReadonlySet,
-    {(tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.BLUE_BABY)}
+    {
+        (tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.BLUE_BABY),
+        tostring(EntityType.MEGA_SATAN) .. ".0"
+    }
 )
-local ____ReadonlySet_11 = ReadonlySet
-local ____array_10 = __TS__SparseArrayNew(__TS__Spread(DARK_ROOM_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_10,
-    __TS__Spread(CHEST_BOSSES_SET:values())
+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 THE_VOID_BOSSES_SET = __TS__New(
+    ReadonlySet,
+    {tostring(EntityType.DELIRIUM) .. ".0"}
 )
-local ALL_STAGE_11_BOSSES_SET = __TS__New(
-    ____ReadonlySet_11,
-    {__TS__SparseArraySpread(____array_10)}
+local THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, THE_VOID_BOSSES_SET}})
+local HOME_BOSSES_SET = __TS__New(
+    ReadonlySet,
+    {
+        tostring(EntityType.DOGMA) .. ".0",
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.BEAST),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_FAMINE),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_PESTILENCE),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_WAR),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_DEATH)
+    }
 )
-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 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, {
     {1, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
     {2, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
@@ -44249,7 +44187,9 @@ ____exports.STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {8, WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
     {9, BLUE_WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
     {10, STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {11, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP}
+    {11, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP},
+    {12, THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP},
+    {13, HOME_STAGE_TYPE_TO_BOSS_SET_MAP}
 })
 ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {1, ALL_BASEMENT_BOSSES_SET},
@@ -44262,39 +44202,35 @@ ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {8, ALL_WOMB_BOSSES_SET},
     {9, BLUE_WOMB_BOSSES_SET},
     {10, ALL_STAGE_10_BOSSES_SET},
-    {11, ALL_STAGE_11_BOSSES_SET}
+    {11, ALL_STAGE_11_BOSSES_SET},
+    {12, THE_VOID_BOSSES_SET},
+    {13, HOME_BOSSES_SET}
 })
-local ____ReadonlySet_13 = ReadonlySet
-local ____array_12 = __TS__SparseArrayNew(__TS__Spread(ALL_BASEMENT_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_CAVES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_DEPTHS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(BLUE_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_STAGE_10_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_STAGE_11_BOSSES_SET:values())
-)
-____exports.ALL_BOSSES_SET = __TS__New(
-    ____ReadonlySet_13,
-    {__TS__SparseArraySpread(____array_12)}
+____exports.ALL_BOSSES_SET = combineSets(
+    nil,
+    ALL_BASEMENT_BOSSES_SET,
+    ALL_CAVES_BOSSES_SET,
+    ALL_DEPTHS_BOSSES_SET,
+    ALL_WOMB_BOSSES_SET,
+    BLUE_WOMB_BOSSES_SET,
+    ALL_STAGE_10_BOSSES_SET,
+    ALL_STAGE_11_BOSSES_SET,
+    THE_VOID_BOSSES_SET,
+    HOME_BOSSES_SET
 )
-____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = getAllBossesExcludingStoryBossesSet(nil)
+____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = (function()
+    local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
+    local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
+    for ____, entityTypeVariantString in ipairs(allBosses) do
+        local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
+        assertDefined(nil, tuple, "Failed to parse a boss tuple when constructing the story boss set.")
+        local entityType, _variant = table.unpack(tuple)
+        if STORY_BOSSES_SET:has(entityType) then
+            allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
+        end
+    end
+    return allBossesExcludingStoryBossesSet
+end)(nil)
 return ____exports
  end,
 ["src.sets.sinEntityTypesSet"] = function(...) 

package/dist/src/functions/bosses.d.ts

@@ -20,8 +20,11 @@ export declare function getAliveBosses(entityType?: EntityType | -1, variant?: n
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
- * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
- * and Gabriel.).
+ * Note that this set does not include:
+ * - mini-bosses (e.g. Ultra Pride, Krampus)
+ * - bosses that do not appear in Boss Rooms (e.g. Uriel, Gabriel)
+ * - the second phase of multi-phase bosses (e.g. Mega Satan 2), with the exception of The Beast
+ *   (Ultra Famine, Ultra Pestilence, Ultra War, and Ultra Death are included)
  *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *

package/dist/src/functions/bosses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bosses.d.ts","sourceRoot":"","sources":["../../../src/functions/bosses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAe,MAAM,8BAA8B,CAAC;AA0BvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,UAAU,GAAG,CAAC,CAAM,EAChC,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,UAAO,GACxB,WAAW,CAAC,MAAM,CAAC,CAIrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAYjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,GACT,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjC;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,EAC7C,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAiCX;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAYX"}
+{"version":3,"file":"bosses.d.ts","sourceRoot":"","sources":["../../../src/functions/bosses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAe,MAAM,8BAA8B,CAAC;AA0BvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,UAAU,GAAG,CAAC,CAAM,EAChC,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,UAAO,GACxB,WAAW,CAAC,MAAM,CAAC,CAIrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAYjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,GACT,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjC;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,EAC7C,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAiCX;AAmCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAYX"}

package/dist/src/functions/bosses.lua

@@ -108,8 +108,11 @@ end
 -- 
 -- The set contains strings with the entity type and variant, separated by a period.
 -- 
--- Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
--- and Gabriel.).
+-- Note that this set does not include:
+-- - mini-bosses (e.g. Ultra Pride, Krampus)
+-- - bosses that do not appear in Boss Rooms (e.g. Uriel, Gabriel)
+-- - the second phase of multi-phase bosses (e.g. Mega Satan 2), with the exception of The Beast
+--   (Ultra Famine, Ultra Pestilence, Ultra War, and Ultra Death are included)
 -- 
 -- Also see the `getBossSet` and `getCombinedBossSet` functions.
 -- 

package/dist/src/functions/run.d.ts

@@ -24,14 +24,19 @@ export declare function getSeedEffects(): SeedEffect[];
  */
 export declare function isGreedMode(): boolean;
 /**
- * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
- * pressing tab on the character selection screen). When the player resets the game on a set seed,
- * the game will not switch to a different seed.
+ * Helper function to check whether the player is playing on a set seed (i.e. that they entered in a
+ * specific seed by pressing tab on the character selection screen). When the player resets the game
+ * on a set seed, the game will not switch to a different seed.
  *
  * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
  * `Seeds.IsCustomRun` method.
  */
 export declare function onSetSeed(): boolean;
+/**
+ * Helper function to check whether the player is on a Victory Lap (i.e. they answered "yes" to the
+ * popup that happens after defeating The Lamb).
+ */
+export declare function onVictoryLap(): boolean;
 /**
  * Helper function to restart the run using the console command of "restart". If the player is
  * playing a seeded run, then it will restart the game to the beginning of the seed. Otherwise, it
@@ -43,8 +48,8 @@ export declare function restart(character?: PlayerType): void;
 /**
  * Helper function to change the run status to that of an unseeded run with a new random seed.
  *
- * This is useful to revert the behavior where playing on a set and restarting the game will not
- * take you to a new seed.
+ * This is useful to revert the behavior where playing on a set seed and restarting the game will
+ * not take you to a new seed.
  *
  * Under the hood, this function calls the `Seeds.Reset` method and the
  * `Seeds.Restart(Challenge.NULL)` method.

package/dist/src/functions/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAGL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAStC,qDAAqD;AACrD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAO7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/functions/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAGL,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAStC,qDAAqD;AACrD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAUlD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAO7C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAMnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAkBpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAUlC"}

package/dist/src/functions/run.lua

@@ -54,9 +54,9 @@ end
 function ____exports.isGreedMode(self)
     return game.Difficulty == Difficulty.GREED or game.Difficulty == Difficulty.GREEDIER
 end
---- Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
--- pressing tab on the character selection screen). When the player resets the game on a set seed,
--- the game will not switch to a different seed.
+--- Helper function to check whether the player is playing on a set seed (i.e. that they entered in a
+-- specific seed by pressing tab on the character selection screen). When the player resets the game
+-- on a set seed, the game will not switch to a different seed.
 -- 
 -- Under the hood, this checks if the current challenge is `Challenge.NULL` and the
 -- `Seeds.IsCustomRun` method.
@@ -66,6 +66,12 @@ function ____exports.onSetSeed(self)
     local challenge = Isaac.GetChallenge()
     return challenge == Challenge.NULL and customRun
 end
+--- Helper function to check whether the player is on a Victory Lap (i.e. they answered "yes" to the
+-- popup that happens after defeating The Lamb).
+function ____exports.onVictoryLap(self)
+    local numVictoryLaps = game:GetVictoryLap()
+    return numVictoryLaps > 0
+end
 --- Helper function to restart the run using the console command of "restart". If the player is
 -- playing a seeded run, then it will restart the game to the beginning of the seed. Otherwise, it
 -- will put the player on a run with an entirely new seed.
@@ -88,8 +94,8 @@ function ____exports.restart(self, character)
 end
 --- Helper function to change the run status to that of an unseeded run with a new random seed.
 -- 
--- This is useful to revert the behavior where playing on a set and restarting the game will not
--- take you to a new seed.
+-- This is useful to revert the behavior where playing on a set seed and restarting the game will
+-- not take you to a new seed.
 -- 
 -- Under the hood, this function calls the `Seeds.Reset` method and the
 -- `Seeds.Restart(Challenge.NULL)` method.

package/dist/src/sets/bossSets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bossSets.d.ts","sourceRoot":"","sources":["../../../src/sets/bossSets.ts"],"names":[],"mappings":";AAobA,eAAO,MAAM,mCAAmC,yDAe9C,CAAC;AAEH,eAAO,MAAM,8BAA8B,uCAezC,CAAC;AAEH,eAAO,MAAM,cAAc,qBAQzB,CAAC;AAEH,eAAO,MAAM,qCAAqC,qBACX,CAAC"}
+{"version":3,"file":"bossSets.d.ts","sourceRoot":"","sources":["../../../src/sets/bossSets.ts"],"names":[],"mappings":";AA8cA,eAAO,MAAM,mCAAmC,yDAiB9C,CAAC;AAEH,eAAO,MAAM,8BAA8B,uCAiBzC,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAU9C,CAAC;AAEF,eAAO,MAAM,qCAAqC,EAAE,WAAW,CAAC,MAAM,CAoBhE,CAAC"}

package/dist/src/sets/bossSets.lua

@@ -1,13 +1,10 @@
 local ____lualib = require("lualib_bundle")
 local __TS__New = ____lualib.__TS__New
-local __TS__Spread = ____lualib.__TS__Spread
-local __TS__SparseArrayNew = ____lualib.__TS__SparseArrayNew
-local __TS__SparseArrayPush = ____lualib.__TS__SparseArrayPush
-local __TS__SparseArraySpread = ____lualib.__TS__SparseArraySpread
 local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
-local getAllBossesExcludingStoryBossesSet
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BeastVariant = ____isaac_2Dtypescript_2Ddefinitions.BeastVariant
 local BigHornVariant = ____isaac_2Dtypescript_2Ddefinitions.BigHornVariant
 local ChubVariant = ____isaac_2Dtypescript_2Ddefinitions.ChubVariant
 local DaddyLongLegsVariant = ____isaac_2Dtypescript_2Ddefinitions.DaddyLongLegsVariant
@@ -40,6 +37,7 @@ local WidowVariant = ____isaac_2Dtypescript_2Ddefinitions.WidowVariant
 local ____entities = require("src.functions.entities")
 local parseEntityTypeVariantString = ____entities.parseEntityTypeVariantString
 local ____set = require("src.functions.set")
+local combineSets = ____set.combineSets
 local copySet = ____set.copySet
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
@@ -49,19 +47,6 @@ local ____ReadonlySet = require("src.types.ReadonlySet")
 local ReadonlySet = ____ReadonlySet.ReadonlySet
 local ____storyBossesSet = require("src.sets.storyBossesSet")
 local STORY_BOSSES_SET = ____storyBossesSet.STORY_BOSSES_SET
-function getAllBossesExcludingStoryBossesSet(self)
-    local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
-    local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
-    for ____, entityTypeVariantString in ipairs(allBosses) do
-        local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
-        assertDefined(nil, tuple, "Failed to parse a boss tuple when constructing the story boss set.")
-        local entityType, _variant = table.unpack(tuple)
-        if STORY_BOSSES_SET:has(entityType) then
-            allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
-        end
-    end
-    return allBossesExcludingStoryBossesSet
-end
 --- Contains just the bosses in Basement (not e.g. Burning Basement).
 local BASEMENT_BOSSES_SET = __TS__New(
     ReadonlySet,
@@ -141,28 +126,14 @@ local DROSS_BOSSES_SET = __TS__New(
         tostring(EntityType.TURDLET) .. ".0"
     }
 )
-local ____ReadonlySet_1 = ReadonlySet
-local ____array_0 = __TS__SparseArrayNew(__TS__Spread(BASEMENT_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(CELLAR_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(BURNING_BASEMENT_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(DOWNPOUR_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_0,
-    __TS__Spread(DROSS_BOSSES_SET:values())
-)
 --- The set of unique bosses for Basement, Cellar, and so on.
-local ALL_BASEMENT_BOSSES_SET = __TS__New(
-    ____ReadonlySet_1,
-    {__TS__SparseArraySpread(____array_0)}
+local ALL_BASEMENT_BOSSES_SET = combineSets(
+    nil,
+    BASEMENT_BOSSES_SET,
+    CELLAR_BOSSES_SET,
+    BURNING_BASEMENT_BOSSES_SET,
+    DOWNPOUR_BOSSES_SET,
+    DROSS_BOSSES_SET
 )
 local BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, BASEMENT_BOSSES_SET},
@@ -258,28 +229,14 @@ local ASHPIT_BOSSES_SET = __TS__New(
         tostring(EntityType.CLUTCH) .. ".0"
     }
 )
-local ____ReadonlySet_3 = ReadonlySet
-local ____array_2 = __TS__SparseArrayNew(__TS__Spread(CAVES_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(CATACOMBS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(FLOODED_CAVES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(MINES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_2,
-    __TS__Spread(ASHPIT_BOSSES_SET:values())
-)
 --- The set of unique bosses for Caves, Catacombs, and so on.
-local ALL_CAVES_BOSSES_SET = __TS__New(
-    ____ReadonlySet_3,
-    {__TS__SparseArraySpread(____array_2)}
+local ALL_CAVES_BOSSES_SET = combineSets(
+    nil,
+    CAVES_BOSSES_SET,
+    CATACOMBS_BOSSES_SET,
+    FLOODED_CAVES_BOSSES_SET,
+    MINES_BOSSES_SET,
+    ASHPIT_BOSSES_SET
 )
 local CAVES_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, CAVES_BOSSES_SET},
@@ -359,28 +316,14 @@ local GEHENNA_BOSSES_SET = __TS__New(
         tostring(EntityType.HORNY_BOYS) .. ".0"
     }
 )
-local ____ReadonlySet_5 = ReadonlySet
-local ____array_4 = __TS__SparseArrayNew(__TS__Spread(DEPTHS_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(NECROPOLIS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(DANK_DEPTHS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(MAUSOLEUM_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_4,
-    __TS__Spread(GEHENNA_BOSSES_SET:values())
-)
 --- The set of unique bosses for Depths, Necropolis, and so on.
-local ALL_DEPTHS_BOSSES_SET = __TS__New(
-    ____ReadonlySet_5,
-    {__TS__SparseArraySpread(____array_4)}
+local ALL_DEPTHS_BOSSES_SET = combineSets(
+    nil,
+    DEPTHS_BOSSES_SET,
+    NECROPOLIS_BOSSES_SET,
+    DANK_DEPTHS_BOSSES_SET,
+    MAUSOLEUM_BOSSES_SET,
+    GEHENNA_BOSSES_SET
 )
 local DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {StageType.ORIGINAL, DEPTHS_BOSSES_SET},
@@ -453,28 +396,14 @@ local CORPSE_BOSSES_SET = __TS__New(
         tostring(EntityType.MOTHER) .. ".0"
     }
 )
-local ____ReadonlySet_7 = ReadonlySet
-local ____array_6 = __TS__SparseArrayNew(__TS__Spread(WOMB_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(UTERO_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(SCARRED_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(MAUSOLEUM_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_6,
-    __TS__Spread(GEHENNA_BOSSES_SET:values())
-)
 --- The set of unique bosses for Depths, Necropolis, and so on.
-local ALL_WOMB_BOSSES_SET = __TS__New(
-    ____ReadonlySet_7,
-    {__TS__SparseArraySpread(____array_6)}
+local ALL_WOMB_BOSSES_SET = combineSets(
+    nil,
+    WOMB_BOSSES_SET,
+    UTERO_BOSSES_SET,
+    SCARRED_WOMB_BOSSES_SET,
+    MAUSOLEUM_BOSSES_SET,
+    GEHENNA_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(
@@ -490,36 +419,41 @@ local CATHEDRAL_BOSSES_SET = __TS__New(
     ReadonlySet,
     {(tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.ISAAC)}
 )
-local ____ReadonlySet_9 = ReadonlySet
-local ____array_8 = __TS__SparseArrayNew(__TS__Spread(SHEOL_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_8,
-    __TS__Spread(CATHEDRAL_BOSSES_SET:values())
-)
-local ALL_STAGE_10_BOSSES_SET = __TS__New(
-    ____ReadonlySet_9,
-    {__TS__SparseArraySpread(____array_8)}
-)
+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}})
 local DARK_ROOM_BOSSES_SET = __TS__New(
     ReadonlySet,
-    {(tostring(EntityType.THE_LAMB) .. ".") .. tostring(LambVariant.LAMB)}
+    {
+        (tostring(EntityType.THE_LAMB) .. ".") .. tostring(LambVariant.LAMB),
+        tostring(EntityType.MEGA_SATAN) .. ".0"
+    }
 )
 local CHEST_BOSSES_SET = __TS__New(
     ReadonlySet,
-    {(tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.BLUE_BABY)}
+    {
+        (tostring(EntityType.ISAAC) .. ".") .. tostring(IsaacVariant.BLUE_BABY),
+        tostring(EntityType.MEGA_SATAN) .. ".0"
+    }
 )
-local ____ReadonlySet_11 = ReadonlySet
-local ____array_10 = __TS__SparseArrayNew(__TS__Spread(DARK_ROOM_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_10,
-    __TS__Spread(CHEST_BOSSES_SET:values())
+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 THE_VOID_BOSSES_SET = __TS__New(
+    ReadonlySet,
+    {tostring(EntityType.DELIRIUM) .. ".0"}
 )
-local ALL_STAGE_11_BOSSES_SET = __TS__New(
-    ____ReadonlySet_11,
-    {__TS__SparseArraySpread(____array_10)}
+local THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {{StageType.ORIGINAL, THE_VOID_BOSSES_SET}})
+local HOME_BOSSES_SET = __TS__New(
+    ReadonlySet,
+    {
+        tostring(EntityType.DOGMA) .. ".0",
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.BEAST),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_FAMINE),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_PESTILENCE),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_WAR),
+        (tostring(EntityType.BEAST) .. ".") .. tostring(BeastVariant.ULTRA_DEATH)
+    }
 )
-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 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, {
     {1, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
     {2, BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP},
@@ -531,7 +465,9 @@ ____exports.STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {8, WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
     {9, BLUE_WOMB_STAGE_TYPE_TO_BOSS_SET_MAP},
     {10, STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP},
-    {11, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP}
+    {11, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP},
+    {12, THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP},
+    {13, HOME_STAGE_TYPE_TO_BOSS_SET_MAP}
 })
 ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {1, ALL_BASEMENT_BOSSES_SET},
@@ -544,37 +480,33 @@ ____exports.STAGE_TO_COMBINED_BOSS_SET_MAP = __TS__New(ReadonlyMap, {
     {8, ALL_WOMB_BOSSES_SET},
     {9, BLUE_WOMB_BOSSES_SET},
     {10, ALL_STAGE_10_BOSSES_SET},
-    {11, ALL_STAGE_11_BOSSES_SET}
+    {11, ALL_STAGE_11_BOSSES_SET},
+    {12, THE_VOID_BOSSES_SET},
+    {13, HOME_BOSSES_SET}
 })
-local ____ReadonlySet_13 = ReadonlySet
-local ____array_12 = __TS__SparseArrayNew(__TS__Spread(ALL_BASEMENT_BOSSES_SET:values()))
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_CAVES_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_DEPTHS_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(BLUE_WOMB_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_STAGE_10_BOSSES_SET:values())
-)
-__TS__SparseArrayPush(
-    ____array_12,
-    __TS__Spread(ALL_STAGE_11_BOSSES_SET:values())
-)
-____exports.ALL_BOSSES_SET = __TS__New(
-    ____ReadonlySet_13,
-    {__TS__SparseArraySpread(____array_12)}
-)
-____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = getAllBossesExcludingStoryBossesSet(nil)
+____exports.ALL_BOSSES_SET = combineSets(
+    nil,
+    ALL_BASEMENT_BOSSES_SET,
+    ALL_CAVES_BOSSES_SET,
+    ALL_DEPTHS_BOSSES_SET,
+    ALL_WOMB_BOSSES_SET,
+    BLUE_WOMB_BOSSES_SET,
+    ALL_STAGE_10_BOSSES_SET,
+    ALL_STAGE_11_BOSSES_SET,
+    THE_VOID_BOSSES_SET,
+    HOME_BOSSES_SET
+)
+____exports.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = (function()
+    local allBossesExcludingStoryBossesSet = copySet(nil, ____exports.ALL_BOSSES_SET)
+    local allBosses = {__TS__Spread(____exports.ALL_BOSSES_SET:values())}
+    for ____, entityTypeVariantString in ipairs(allBosses) do
+        local tuple = parseEntityTypeVariantString(nil, entityTypeVariantString)
+        assertDefined(nil, tuple, "Failed to parse a boss tuple when constructing the story boss set.")
+        local entityType, _variant = table.unpack(tuple)
+        if STORY_BOSSES_SET:has(entityType) then
+            allBossesExcludingStoryBossesSet:delete(entityTypeVariantString)
+        end
+    end
+    return allBossesExcludingStoryBossesSet
+end)(nil)
 return ____exports

package/package.json

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

package/src/functions/bosses.ts

@@ -54,8 +54,11 @@ export function getAliveBosses(
  *
  * The set contains strings with the entity type and variant, separated by a period.
  *
- * Note that this set does not include bosses that do not appear in Boss Rooms (e.g. Krampus, Uriel,
- * and Gabriel.).
+ * Note that this set does not include:
+ * - mini-bosses (e.g. Ultra Pride, Krampus)
+ * - bosses that do not appear in Boss Rooms (e.g. Uriel, Gabriel)
+ * - the second phase of multi-phase bosses (e.g. Mega Satan 2), with the exception of The Beast
+ *   (Ultra Famine, Ultra Pestilence, Ultra War, and Ultra Death are included)
  *
  * Also see the `getBossSet` and `getCombinedBossSet` functions.
  *

package/src/functions/run.ts

@@ -71,9 +71,9 @@ export function isGreedMode(): boolean {
 }
 
 /**
- * Whether the player is playing on a set seed (i.e. that they entered in a specific seed by
- * pressing tab on the character selection screen). When the player resets the game on a set seed,
- * the game will not switch to a different seed.
+ * Helper function to check whether the player is playing on a set seed (i.e. that they entered in a
+ * specific seed by pressing tab on the character selection screen). When the player resets the game
+ * on a set seed, the game will not switch to a different seed.
  *
  * Under the hood, this checks if the current challenge is `Challenge.NULL` and the
  * `Seeds.IsCustomRun` method.
@@ -86,6 +86,15 @@ export function onSetSeed(): boolean {
   return challenge === Challenge.NULL && customRun;
 }
 
+/**
+ * Helper function to check whether the player is on a Victory Lap (i.e. they answered "yes" to the
+ * popup that happens after defeating The Lamb).
+ */
+export function onVictoryLap(): boolean {
+  const numVictoryLaps = game.GetVictoryLap();
+  return numVictoryLaps > 0;
+}
+
 /**
  * Helper function to restart the run using the console command of "restart". If the player is
  * playing a seeded run, then it will restart the game to the beginning of the seed. Otherwise, it
@@ -116,8 +125,8 @@ export function restart(character?: PlayerType): void {
 /**
  * Helper function to change the run status to that of an unseeded run with a new random seed.
  *
- * This is useful to revert the behavior where playing on a set and restarting the game will not
- * take you to a new seed.
+ * This is useful to revert the behavior where playing on a set seed and restarting the game will
+ * not take you to a new seed.
  *
  * Under the hood, this function calls the `Seeds.Reset` method and the
  * `Seeds.Restart(Challenge.NULL)` method.

package/src/sets/bossSets.ts

@@ -1,4 +1,5 @@
 import {
+  BeastVariant,
   BigHornVariant,
   ChubVariant,
   DaddyLongLegsVariant,
@@ -30,7 +31,7 @@ import {
   WidowVariant,
 } from "isaac-typescript-definitions";
 import { parseEntityTypeVariantString } from "../functions/entities";
-import { copySet } from "../functions/set";
+import { combineSets, copySet } from "../functions/set";
 import { assertDefined } from "../functions/utils";
 import { ReadonlyMap } from "../types/ReadonlyMap";
 import { ReadonlySet } from "../types/ReadonlySet";
@@ -112,13 +113,13 @@ const DROSS_BOSSES_SET = new ReadonlySet<string>([
 ]);
 
 /** The set of unique bosses for Basement, Cellar, and so on. */
-const ALL_BASEMENT_BOSSES_SET = new ReadonlySet<string>([
-  ...BASEMENT_BOSSES_SET.values(),
-  ...CELLAR_BOSSES_SET.values(),
-  ...BURNING_BASEMENT_BOSSES_SET.values(),
-  ...DOWNPOUR_BOSSES_SET.values(),
-  ...DROSS_BOSSES_SET.values(),
-]);
+const ALL_BASEMENT_BOSSES_SET: ReadonlySet<string> = combineSets(
+  BASEMENT_BOSSES_SET,
+  CELLAR_BOSSES_SET,
+  BURNING_BASEMENT_BOSSES_SET,
+  DOWNPOUR_BOSSES_SET,
+  DROSS_BOSSES_SET,
+);
 
 const BASEMENT_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -209,13 +210,13 @@ const ASHPIT_BOSSES_SET = new ReadonlySet<string>([
 ]);
 
 /** The set of unique bosses for Caves, Catacombs, and so on. */
-const ALL_CAVES_BOSSES_SET = new ReadonlySet<string>([
-  ...CAVES_BOSSES_SET.values(),
-  ...CATACOMBS_BOSSES_SET.values(),
-  ...FLOODED_CAVES_BOSSES_SET.values(),
-  ...MINES_BOSSES_SET.values(),
-  ...ASHPIT_BOSSES_SET.values(),
-]);
+const ALL_CAVES_BOSSES_SET: ReadonlySet<string> = combineSets(
+  CAVES_BOSSES_SET,
+  CATACOMBS_BOSSES_SET,
+  FLOODED_CAVES_BOSSES_SET,
+  MINES_BOSSES_SET,
+  ASHPIT_BOSSES_SET,
+);
 
 const CAVES_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -290,13 +291,13 @@ const GEHENNA_BOSSES_SET = new ReadonlySet<string>([
 ]);
 
 /** The set of unique bosses for Depths, Necropolis, and so on. */
-const ALL_DEPTHS_BOSSES_SET = new ReadonlySet<string>([
-  ...DEPTHS_BOSSES_SET.values(),
-  ...NECROPOLIS_BOSSES_SET.values(),
-  ...DANK_DEPTHS_BOSSES_SET.values(),
-  ...MAUSOLEUM_BOSSES_SET.values(),
-  ...GEHENNA_BOSSES_SET.values(),
-]);
+const ALL_DEPTHS_BOSSES_SET: ReadonlySet<string> = combineSets(
+  DEPTHS_BOSSES_SET,
+  NECROPOLIS_BOSSES_SET,
+  DANK_DEPTHS_BOSSES_SET,
+  MAUSOLEUM_BOSSES_SET,
+  GEHENNA_BOSSES_SET,
+);
 
 const DEPTHS_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -366,13 +367,13 @@ const CORPSE_BOSSES_SET = new ReadonlySet<string>([
 ]);
 
 /** The set of unique bosses for Depths, Necropolis, and so on. */
-const ALL_WOMB_BOSSES_SET = new ReadonlySet<string>([
-  ...WOMB_BOSSES_SET.values(),
-  ...UTERO_BOSSES_SET.values(),
-  ...SCARRED_WOMB_BOSSES_SET.values(),
-  ...MAUSOLEUM_BOSSES_SET.values(),
-  ...GEHENNA_BOSSES_SET.values(),
-]);
+const ALL_WOMB_BOSSES_SET: ReadonlySet<string> = combineSets(
+  WOMB_BOSSES_SET,
+  UTERO_BOSSES_SET,
+  SCARRED_WOMB_BOSSES_SET,
+  MAUSOLEUM_BOSSES_SET,
+  GEHENNA_BOSSES_SET,
+);
 
 const WOMB_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -400,10 +401,10 @@ const CATHEDRAL_BOSSES_SET = new ReadonlySet<string>([
   `${EntityType.ISAAC}.${IsaacVariant.ISAAC}`, // 102.0
 ]);
 
-const ALL_STAGE_10_BOSSES_SET = new ReadonlySet<string>([
-  ...SHEOL_BOSSES_SET.values(),
-  ...CATHEDRAL_BOSSES_SET.values(),
-]);
+const ALL_STAGE_10_BOSSES_SET: ReadonlySet<string> = combineSets(
+  SHEOL_BOSSES_SET,
+  CATHEDRAL_BOSSES_SET,
+);
 
 const STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -415,16 +416,18 @@ const STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
 
 const DARK_ROOM_BOSSES_SET = new ReadonlySet<string>([
   `${EntityType.THE_LAMB}.${LambVariant.LAMB}`, // 273.0
+  `${EntityType.MEGA_SATAN}.0`, // 274.0
 ]);
 
 const CHEST_BOSSES_SET = new ReadonlySet<string>([
   `${EntityType.ISAAC}.${IsaacVariant.BLUE_BABY}`, // 102.1
+  `${EntityType.MEGA_SATAN}.0`, // 274.0
 ]);
 
-const ALL_STAGE_11_BOSSES_SET = new ReadonlySet<string>([
-  ...DARK_ROOM_BOSSES_SET.values(),
-  ...CHEST_BOSSES_SET.values(),
-]);
+const ALL_STAGE_11_BOSSES_SET: ReadonlySet<string> = combineSets(
+  DARK_ROOM_BOSSES_SET,
+  CHEST_BOSSES_SET,
+);
 
 const STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   StageType,
@@ -434,6 +437,29 @@ const STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   [StageType.WRATH_OF_THE_LAMB, CHEST_BOSSES_SET],
 ]);
 
+const THE_VOID_BOSSES_SET = new ReadonlySet<string>([
+  `${EntityType.DELIRIUM}.0`, // 412.0
+]);
+
+const THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
+  StageType,
+  ReadonlySet<string>
+>([[StageType.ORIGINAL, THE_VOID_BOSSES_SET]]);
+
+const HOME_BOSSES_SET = new ReadonlySet<string>([
+  `${EntityType.DOGMA}.0`, // 950.0
+  `${EntityType.BEAST}.${BeastVariant.BEAST}`, // 951.0
+  `${EntityType.BEAST}.${BeastVariant.ULTRA_FAMINE}`, // 951.10
+  `${EntityType.BEAST}.${BeastVariant.ULTRA_PESTILENCE}`, // 951.20
+  `${EntityType.BEAST}.${BeastVariant.ULTRA_WAR}`, // 951.30
+  `${EntityType.BEAST}.${BeastVariant.ULTRA_DEATH}`, // 951.40
+]);
+
+const HOME_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
+  StageType,
+  ReadonlySet<string>
+>([[StageType.ORIGINAL, HOME_BOSSES_SET]]);
+
 export const STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   int,
   ReadonlyMap<int, ReadonlySet<string>>
@@ -449,6 +475,8 @@ export const STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = new ReadonlyMap<
   [9, BLUE_WOMB_STAGE_TYPE_TO_BOSS_SET_MAP],
   [10, STAGE_10_STAGE_TYPE_TO_BOSS_SET_MAP],
   [11, STAGE_11_STAGE_TYPE_TO_BOSS_SET_MAP],
+  [12, THE_VOID_STAGE_TYPE_TO_BOSS_SET_MAP],
+  [13, HOME_STAGE_TYPE_TO_BOSS_SET_MAP],
 ]);
 
 export const STAGE_TO_COMBINED_BOSS_SET_MAP = new ReadonlyMap<
@@ -466,40 +494,40 @@ export const STAGE_TO_COMBINED_BOSS_SET_MAP = new ReadonlyMap<
   [9, BLUE_WOMB_BOSSES_SET],
   [10, ALL_STAGE_10_BOSSES_SET],
   [11, ALL_STAGE_11_BOSSES_SET],
-]);
-
-export const ALL_BOSSES_SET = new ReadonlySet<string>([
-  ...ALL_BASEMENT_BOSSES_SET.values(),
-  ...ALL_CAVES_BOSSES_SET.values(),
-  ...ALL_DEPTHS_BOSSES_SET.values(),
-  ...ALL_WOMB_BOSSES_SET.values(),
-  ...BLUE_WOMB_BOSSES_SET.values(),
-  ...ALL_STAGE_10_BOSSES_SET.values(),
-  ...ALL_STAGE_11_BOSSES_SET.values(),
-]);
-
-export const ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET =
-  getAllBossesExcludingStoryBossesSet();
-
-/**
- * Since story bosses are stored by entity type, we copy the existing bosses and filter them (to
- * avoid having to hard-code story boss variants).
- */
-function getAllBossesExcludingStoryBossesSet(): ReadonlySet<string> {
-  const allBossesExcludingStoryBossesSet = copySet(ALL_BOSSES_SET);
-  const allBosses = [...ALL_BOSSES_SET.values()];
-  for (const entityTypeVariantString of allBosses) {
-    const tuple = parseEntityTypeVariantString(entityTypeVariantString);
-    assertDefined(
-      tuple,
-      "Failed to parse a boss tuple when constructing the story boss set.",
-    );
-
-    const [entityType, _variant] = tuple;
-    if (STORY_BOSSES_SET.has(entityType)) {
-      allBossesExcludingStoryBossesSet.delete(entityTypeVariantString);
+  [12, THE_VOID_BOSSES_SET],
+  [13, HOME_BOSSES_SET],
+]);
+
+export const ALL_BOSSES_SET: ReadonlySet<string> = combineSets(
+  ALL_BASEMENT_BOSSES_SET,
+  ALL_CAVES_BOSSES_SET,
+  ALL_DEPTHS_BOSSES_SET,
+  ALL_WOMB_BOSSES_SET,
+  BLUE_WOMB_BOSSES_SET,
+  ALL_STAGE_10_BOSSES_SET,
+  ALL_STAGE_11_BOSSES_SET,
+  THE_VOID_BOSSES_SET,
+  HOME_BOSSES_SET,
+);
+
+export const ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET: ReadonlySet<string> =
+  (() => {
+    // Since story bosses are stored by entity type, we copy the existing bosses and filter them (to
+    // avoid having to hard-code story boss variants).
+    const allBossesExcludingStoryBossesSet = copySet(ALL_BOSSES_SET);
+    const allBosses = [...ALL_BOSSES_SET.values()];
+    for (const entityTypeVariantString of allBosses) {
+      const tuple = parseEntityTypeVariantString(entityTypeVariantString);
+      assertDefined(
+        tuple,
+        "Failed to parse a boss tuple when constructing the story boss set.",
+      );
+
+      const [entityType, _variant] = tuple;
+      if (STORY_BOSSES_SET.has(entityType)) {
+        allBossesExcludingStoryBossesSet.delete(entityTypeVariantString);
+      }
     }
-  }
 
-  return allBossesExcludingStoryBossesSet;
-}
+    return allBossesExcludingStoryBossesSet;
+  })();