isaacscript-common 7.5.0 → 7.6.1

package/dist/classes/DefaultMap.d.ts

@@ -1,5 +1,6 @@
 /**
- * `DefaultMap` is a data structure that makes working with default values easier.
+ * `DefaultMap` is a data structure that makes working with default values easier. It extends a
+ * `Map` and adds additional methods.
  *
  * It is a common pattern to look up a value in a `Map`, and then, if the value does not exist, set
  * a default value for the key, and then return the default value. `DefaultMap` abstracts this
@@ -83,7 +84,7 @@ export declare class DefaultMap<Key, Value, Args extends unknown[] = []> extends
     private defaultValueFactory;
     /**
      * See the main `DefaultMap` documentation:
-     * https://isaacscript.github.io/isaacscript-common/classes/classes_DefaultMap.DefaultMap
+     * https://isaacscript.github.io/isaacscript-common/other/classes/DefaultMap
      */
     constructor(defaultValueOrFactoryFunction: Value | FactoryFunction<Value, Args>, initializerArray?: Iterable<[Key, Value]>);
     /**

package/dist/classes/DefaultMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultMap.d.ts","sourceRoot":"","sources":["../../src/classes/DefaultMap.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,qBAAa,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,CAAE,SAAQ,GAAG,CAC1E,GAAG,EACH,KAAK,CACN;IACC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,mBAAmB,CAA2C;IAEtE;;;OAGG;gBAED,6BAA6B,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,EACnE,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAqB3C;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAWhD;;;OAGG;IACH,eAAe,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAYrC;;;OAGG;IACH,iBAAiB,IAAI,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC;CAW1D;AAGD;;;GAGG;AACH,oBAAY,eAAe,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC"}
+{"version":3,"file":"DefaultMap.d.ts","sourceRoot":"","sources":["../../src/classes/DefaultMap.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,qBAAa,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,CAAE,SAAQ,GAAG,CAC1E,GAAG,EACH,KAAK,CACN;IACC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,mBAAmB,CAA2C;IAEtE;;;OAGG;gBAED,6BAA6B,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,EACnE,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAqB3C;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAWhD;;;OAGG;IACH,eAAe,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK;IAYrC;;;OAGG;IACH,iBAAiB,IAAI,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC;CAW1D;AAGD;;;GAGG;AACH,oBAAY,eAAe,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC"}

package/dist/classes/DefaultMap.lua

@@ -8,7 +8,8 @@ local ____exports = {}
 local ____types = require("functions.types")
 local isFunction = ____types.isFunction
 local isPrimitive = ____types.isPrimitive
---- `DefaultMap` is a data structure that makes working with default values easier.
+--- `DefaultMap` is a data structure that makes working with default values easier. It extends a
+-- `Map` and adds additional methods.
 -- 
 -- It is a common pattern to look up a value in a `Map`, and then, if the value does not exist, set
 -- a default value for the key, and then return the default value. `DefaultMap` abstracts this

package/dist/features/customGridEntity.d.ts

@@ -28,8 +28,11 @@ export declare function customGridEntityInit(mod: ModUpgraded): void;
  * @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
  *                            entity at. If a position is specified, the closest grid index will be
  *                            used.
- * @param gridCollisionClass The collision class that you want the custom grid entity to have.
- * @param anm2Path The path to the ANM2 file to use for the sprite.
+ * @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
+ *                           have. If not specified, the grid collision class from the base grid
+ *                           entity will be used.
+ * @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
+ *                 normal sprite from the base grid entity will be used.
  * @param defaultAnimation Optional. The name of the animation to play after the sprite is
  *                         initialized and after the player re-enters a room with this grid entity
  *                         in it. If not specified, the default animation in the anm2 will be used.
@@ -38,7 +41,7 @@ export declare function customGridEntityInit(mod: ModUpgraded): void;
  * @param baseGridEntityVariant Optional. The variant of the grid entity to use as a "base" for this
  *                              custom grid entity. Default is 0.
  */
-export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityType, gridIndexOrPosition: int | Vector, gridCollisionClass: GridCollisionClass, anm2Path: string, defaultAnimation?: string, baseGridEntityType?: GridEntityType, baseGridEntityVariant?: number): GridEntity;
+export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityType, gridIndexOrPosition: int | Vector, gridCollisionClass?: GridCollisionClass, anm2Path?: string, defaultAnimation?: string, baseGridEntityType?: GridEntityType, baseGridEntityVariant?: number): GridEntity;
 /**
  * Helper function to remove a custom grid entity created by the `spawnCustomGrid` function.
  *

package/dist/features/customGridEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customGridEntity.d.ts","sourceRoot":"","sources":["../../src/features/customGridEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAoB1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmB3D;AAkID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,EAAE,kBAAkB,EACtC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU,CAyCZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS,CAuCxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAC5C;IAAC,UAAU,EAAE,UAAU;IAAE,IAAI,EAAE,oBAAoB;CAAC,CACrD,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,OAAO,CAOT"}
+{"version":3,"file":"customGridEntity.d.ts","sourceRoot":"","sources":["../../src/features/customGridEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAerD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAoB1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmB3D;AAoID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,qBAAqB,CACnC,oBAAoB,EAAE,cAAc,EACpC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,EACzB,kBAAkB,iBAA4B,EAC9C,qBAAqB,SAAI,GACxB,UAAU,CA8CZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS,CAuCxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAC5C;IAAC,UAAU,EAAE,UAAU;IAAE,IAAI,EAAE,oBAAoB;CAAC,CACrD,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,OAAO,CAOT"}

package/dist/features/customGridEntity.lua

@@ -115,10 +115,12 @@ function postNewRoomReordered(self)
                 roomCustomGridEntities:delete(gridIndex)
                 goto __continue19
             end
-            local sprite = decoration:GetSprite()
-            sprite:Load(data.anm2Path, true)
-            local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
-            sprite:Play(animationToPlay, true)
+            if data.anm2Path ~= nil then
+                local sprite = decoration:GetSprite()
+                sprite:Load(data.anm2Path, true)
+                local animationToPlay = data.defaultAnimation == nil and sprite:GetDefaultAnimation() or data.defaultAnimation
+                sprite:Play(animationToPlay, true)
+            end
         end
         ::__continue19::
     end
@@ -165,8 +167,11 @@ end
 -- @param gridIndexOrPosition The grid index or position in the room that you want to spawn the grid
 -- entity at. If a position is specified, the closest grid index will be
 -- used.
--- @param gridCollisionClass The collision class that you want the custom grid entity to have.
--- @param anm2Path The path to the ANM2 file to use for the sprite.
+-- @param gridCollisionClass Optional. The collision class that you want the custom grid entity to
+-- have. If not specified, the grid collision class from the base grid
+-- entity will be used.
+-- @param anm2Path Optional. The path to the ANM2 file to use for the sprite. If not specified, the
+-- normal sprite from the base grid entity will be used.
 -- @param defaultAnimation Optional. The name of the animation to play after the sprite is
 -- initialized and after the player re-enters a room with this grid entity
 -- in it. If not specified, the default animation in the anm2 will be used.
@@ -189,11 +194,15 @@ function ____exports.spawnCustomGridEntity(self, gridEntityTypeCustom, gridIndex
     if customGridEntity == nil then
         error("Failed to spawn a custom grid entity.")
     end
-    customGridEntity.CollisionClass = gridCollisionClass
-    local sprite = customGridEntity:GetSprite()
-    sprite:Load(anm2Path, true)
-    local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
-    sprite:Play(animationToPlay, true)
+    if gridCollisionClass ~= nil then
+        customGridEntity.CollisionClass = gridCollisionClass
+    end
+    if anm2Path ~= nil then
+        local sprite = customGridEntity:GetSprite()
+        sprite:Load(anm2Path, true)
+        local animationToPlay = defaultAnimation == nil and sprite:GetDefaultAnimation() or defaultAnimation
+        sprite:Play(animationToPlay, true)
+    end
     local customGridEntityData = {
         gridEntityTypeCustom = gridEntityTypeCustom,
         roomListIndex = roomListIndex,

package/dist/features/customStage/customStageConstants.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+export declare const CUSTOM_STAGE_FEATURE_NAME = "customStage";
 export declare const ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage";
 /** Corresponds to "ui_streak.anm2". */
 export declare enum UIStreakAnimation {

package/dist/features/customStage/customStageConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}
+{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}

package/dist/features/customStage/customStageConstants.lua

@@ -1,4 +1,5 @@
 local ____exports = {}
+____exports.CUSTOM_STAGE_FEATURE_NAME = "customStage"
 ____exports.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage"
 --- Corresponds to "ui_streak.anm2".
 ____exports.UIStreakAnimation = {}

package/dist/features/customStage/customStageGridEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAOnE,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAuBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAyBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAuBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}
+{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAiBA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AASnE,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAuBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAyBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAuBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAwBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}

package/dist/features/customStage/customStageGridEntities.lua

@@ -25,6 +25,7 @@ local ____customGridEntity = require("features.customGridEntity")
 local isCustomGridEntity = ____customGridEntity.isCustomGridEntity
 local ____exports = require("features.customTrapdoor.exports")
 local spawnCustomTrapdoor = ____exports.spawnCustomTrapdoor
+local spawnCustomTrapdoorToVanilla = ____exports.spawnCustomTrapdoorToVanilla
 local ____exports = require("features.customStage.exports")
 local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
 local ____v = require("features.customStage.v")
@@ -238,11 +239,14 @@ function ____exports.convertVanillaTrapdoors(self, customStage, gridEntity)
         return
     end
     removeGridEntity(nil, gridEntity, true)
-    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
-    local vanillaNextStage = baseStage + 2
-    local vanillaNextStageType = calculateStageType(nil, vanillaNextStage)
-    local destination = v.run.firstFloor and ({customStage.name, 2}) or ({vanillaNextStage, vanillaNextStageType})
-    spawnCustomTrapdoor(nil, gridEntity.Position, destination)
+    if v.run.firstFloor then
+        spawnCustomTrapdoor(nil, gridEntity.Position, customStage.name, 2)
+    else
+        local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+        local stage = baseStage + 2
+        local stageType = calculateStageType(nil, stage)
+        spawnCustomTrapdoorToVanilla(nil, gridEntity.Position, stage, stageType)
+    end
 end
 --- The rewards are based on the ones from the wiki:
 -- https://bindingofisaacrebirth.fandom.com/wiki/Rocks#Urns

package/dist/features/customStage/customStageUtils.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="isaac-typescript-definitions" />
-import { CustomStageRoomMetadata } from "../../interfaces/CustomStageLua";
+import { CustomStageBossPoolEntry, CustomStageRoomMetadata } from "../../interfaces/CustomStageTSConfig";
 /**
  * Helper function to get a random custom stage room from an array of custom stage rooms.
  *
@@ -9,4 +9,5 @@ import { CustomStageRoomMetadata } from "../../interfaces/CustomStageLua";
  * https://stackoverflow.com/questions/1761626/weighted-random-numbers
  */
 export declare function getRandomCustomStageRoom(roomsMetadata: readonly CustomStageRoomMetadata[], seedOrRNG?: Seed | RNG, verbose?: boolean): CustomStageRoomMetadata;
+export declare function getRandomBossRoomFromPool(roomsMetadata: readonly CustomStageRoomMetadata[], bossPool: readonly CustomStageBossPoolEntry[], seedOrRNG?: Seed | RNG, verbose?: boolean): CustomStageRoomMetadata;
 //# sourceMappingURL=customStageUtils.d.ts.map

package/dist/features/customStage/customStageUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageUtils.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageUtils.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,SAAS,uBAAuB,EAAE,EACjD,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,uBAAuB,CAYzB"}
+{"version":3,"file":"customStageUtils.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageUtils.ts"],"names":[],"mappings":";;AAIA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,sCAAsC,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,SAAS,uBAAuB,EAAE,EACjD,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,uBAAuB,CAYzB;AA0BD,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,SAAS,uBAAuB,EAAE,EACjD,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAC7C,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,uBAAuB,CAiBzB"}

package/dist/features/customStage/customStageUtils.lua

@@ -1,7 +1,8 @@
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
-local getTotalWeightOfCustomStageRooms, getCustomStageRoomWithChosenWeight
+local getTotalWeightOfCustomStageRooms, getCustomStageRoomWithChosenWeight, getTotalWeightOfBossPool, getBossEntryWithChosenWeight
 local ____array = require("functions.array")
 local sumArray = ____array.sumArray
 local ____log = require("functions.log")
@@ -26,6 +27,22 @@ function getCustomStageRoomWithChosenWeight(self, roomsMetadata, chosenWeight)
     end
     error("Failed to get a custom stage room with chosen weight: " .. tostring(chosenWeight))
 end
+function getTotalWeightOfBossPool(self, bossPool)
+    local weights = __TS__ArrayMap(
+        bossPool,
+        function(____, bossEntry) return bossEntry.weight end
+    )
+    return sumArray(nil, weights)
+end
+function getBossEntryWithChosenWeight(self, bossPool, chosenWeight)
+    for ____, bossEntry in ipairs(bossPool) do
+        if chosenWeight < bossEntry.weight then
+            return bossEntry
+        end
+        chosenWeight = chosenWeight - bossEntry.weight
+    end
+    error("Failed to get a custom stage boss entry with chosen weight: " .. tostring(chosenWeight))
+end
 --- Helper function to get a random custom stage room from an array of custom stage rooms.
 -- 
 -- Note that this function does not simply choose a random element in the provided array; it will
@@ -48,4 +65,26 @@ function ____exports.getRandomCustomStageRoom(self, roomsMetadata, seedOrRNG, ve
     end
     return getCustomStageRoomWithChosenWeight(nil, roomsMetadata, chosenWeight)
 end
+function ____exports.getRandomBossRoomFromPool(self, roomsMetadata, bossPool, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local totalWeight = getTotalWeightOfBossPool(nil, bossPool)
+    if verbose then
+        log("Total weight of the custom stage boss pool provided: " .. tostring(totalWeight))
+    end
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    if verbose then
+        log("Randomly chose weight for custom stage boss pool: " .. tostring(chosenWeight))
+    end
+    local bossEntry = getBossEntryWithChosenWeight(nil, bossPool, chosenWeight)
+    local roomsMetadataForBoss = __TS__ArrayFilter(
+        roomsMetadata,
+        function(____, roomMetadata) return roomMetadata.subType == bossEntry.subType end
+    )
+    return ____exports.getRandomCustomStageRoom(nil, roomsMetadataForBoss, seedOrRNG, verbose)
+end
 return ____exports

package/dist/features/customStage/exports.d.ts

@@ -5,7 +5,7 @@
  *
  * @module
  */
-import { EntityType, LevelStage, StageType } from "isaac-typescript-definitions";
+import { LevelStage, StageType } from "isaac-typescript-definitions";
 export declare const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
 export declare const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
 export declare const INVALID_STAGE_VALUE: LevelStage;
@@ -23,30 +23,6 @@ export declare const INVALID_STAGE_VALUE: LevelStage;
  *                Default is false.
  */
 export declare function setCustomStage(name: string, firstFloor?: boolean, verbose?: boolean): void;
-/**
- * By default, unknown bosses will be drawn on the boss "versus" screen as "???". If your custom
- * stage has custom bosses, you can use this function to register the corresponding graphic file
- * files for them.
- *
- * For reference:
- * - The vanilla name sprite for Monstro is located at:
- *   `resources/gfx/ui/boss/bossname_20.0_monstro.png`
- * - The vanilla portrait sprite for Monstro is located at:
- *   `resources/gfx/ui/boss/portrait_20.0_monstro.png`
- *
- * (Note that boss metadata like this cannot be specified with the rest of the custom stage metadata
- * in the "tsconfig.json" file because there is not a way to retrieve the name of an entity at
- * run-time.)
- *
- * @param entityType The entity type of the custom boss.
- * @param variant The variant of the custom boss.
- * @param subType The sub-type of the custom boss.
- * @param namePNGPath The full path to the PNG file that contains the name of the boss that will be
- *                    displayed on the top of the boss "versus" screen.
- * @param portraitPNGPath The full path to the PNG file that contains the portrait of the boss that
- *                        will be displayed on the right side of the boss "versus" screen.
- */
-export declare function registerCustomBoss(entityType: EntityType, variant: int, subType: int, namePNGPath: string, portraitPNGPath: string): void;
 /**
  * Helper function to disable the custom stage. This is typically called before taking the player to
  * a vanilla floor.

package/dist/features/customStage/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAoBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,YAAmB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAwDN;AA4ED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAEL,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAoBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,YAAmB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAwDN;AAkGD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/features/customStage/exports.lua

@@ -1,8 +1,10 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local ____exports = {}
 local setStageRoomsData
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
@@ -11,8 +13,8 @@ local ____reorderedCallbacks = require("callbacks.reorderedCallbacks")
 local reorderedCallbacksSetStageInternal = ____reorderedCallbacks.reorderedCallbacksSetStageInternal
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
-local ____entities = require("functions.entities")
-local getEntityIDFromConstituents = ____entities.getEntityIDFromConstituents
+local ____doors = require("functions.doors")
+local doorSlotFlagsToDoorSlots = ____doors.doorSlotFlagsToDoorSlots
 local ____log = require("functions.log")
 local logError = ____log.logError
 local ____rng = require("functions.rng")
@@ -25,10 +27,10 @@ local setStage = ____stage.setStage
 local ____types = require("functions.types")
 local asNumber = ____types.asNumber
 local ____customStageUtils = require("features.customStage.customStageUtils")
+local getRandomBossRoomFromPool = ____customStageUtils.getRandomBossRoomFromPool
 local getRandomCustomStageRoom = ____customStageUtils.getRandomCustomStageRoom
 local ____v = require("features.customStage.v")
 local v = ____v.default
-local customBossPNGPaths = ____v.customBossPNGPaths
 local customStageCachedRoomData = ____v.customStageCachedRoomData
 local customStagesMap = ____v.customStagesMap
 function setStageRoomsData(self, customStage, rng, verbose)
@@ -60,9 +62,31 @@ function setStageRoomsData(self, customStage, rng, verbose)
             local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
             if roomsMetadata == nil then
                 logError((((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") + DoorSlotFlags ") .. tostring(doorSlotFlags)) .. " for custom stage: ") .. customStage.name)
+                local header = ("For reference, a DoorSlotFlags of " .. tostring(doorSlotFlags)) .. " is equal to the following doors being enabled:\n"
+                local doorSlots = doorSlotFlagsToDoorSlots(nil, doorSlotFlags)
+                local doorSlotLines = __TS__ArrayMap(
+                    doorSlots,
+                    function(____, doorSlot) return ((("- DoorSlot." .. tostring(DoorSlot[doorSlot])) .. " (") .. tostring(doorSlot)) .. ")" end
+                )
+                local explanation = header .. table.concat(doorSlotLines, "\n")
+                logError(explanation)
                 goto __continue7
             end
-            local randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
+            local randomRoom
+            if roomType == RoomType.BOSS then
+                if customStage.bossPool == nil then
+                    goto __continue7
+                end
+                randomRoom = getRandomBossRoomFromPool(
+                    nil,
+                    roomsMetadata,
+                    customStage.bossPool,
+                    rng,
+                    verbose
+                )
+            else
+                randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
+            end
             local newRoomData = customStageCachedRoomData:get(randomRoom.variant)
             if newRoomData == nil then
                 newRoomData = getRoomDataForTypeVariant(nil, roomType, randomRoom.variant, false)
@@ -125,31 +149,6 @@ function ____exports.setCustomStage(self, name, firstFloor, verbose)
     level:SetStage(targetStage, targetStageType)
     reorderedCallbacksSetStageInternal(nil, targetStage, targetStageType)
 end
---- By default, unknown bosses will be drawn on the boss "versus" screen as "???". If your custom
--- stage has custom bosses, you can use this function to register the corresponding graphic file
--- files for them.
--- 
--- For reference:
--- - The vanilla name sprite for Monstro is located at:
---   `resources/gfx/ui/boss/bossname_20.0_monstro.png`
--- - The vanilla portrait sprite for Monstro is located at:
---   `resources/gfx/ui/boss/portrait_20.0_monstro.png`
--- 
--- (Note that boss metadata like this cannot be specified with the rest of the custom stage metadata
--- in the "tsconfig.json" file because there is not a way to retrieve the name of an entity at
--- run-time.)
--- 
--- @param entityType The entity type of the custom boss.
--- @param variant The variant of the custom boss.
--- @param subType The sub-type of the custom boss.
--- @param namePNGPath The full path to the PNG file that contains the name of the boss that will be
--- displayed on the top of the boss "versus" screen.
--- @param portraitPNGPath The full path to the PNG file that contains the portrait of the boss that
--- will be displayed on the right side of the boss "versus" screen.
-function ____exports.registerCustomBoss(self, entityType, variant, subType, namePNGPath, portraitPNGPath)
-    local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
-    customBossPNGPaths:set(entityID, {namePNGPath, portraitPNGPath})
-end
 --- Helper function to disable the custom stage. This is typically called before taking the player to
 -- a vanilla floor.
 function ____exports.disableCustomStage(self)

package/dist/features/customStage/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA6BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0BtD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA8BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0BtD"}

package/dist/features/customStage/init.lua

@@ -19,6 +19,8 @@ local ____exports = require("features.saveDataManager.exports")
 local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
 local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
+local ____customStageConstants = require("features.customStage.customStageConstants")
+local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
 local ____customStageGridEntities = require("features.customStage.customStageGridEntities")
 local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
 local removeUrnRewards = ____customStageGridEntities.removeUrnRewards
@@ -133,7 +135,7 @@ function ____exports.customStageInit(self, mod)
     if customStagesMap.size == 0 then
         return
     end
-    saveDataManager(nil, "customStage", v)
+    saveDataManager(nil, CUSTOM_STAGE_FEATURE_NAME, v)
     versusScreenInit(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)

package/dist/features/customStage/v.d.ts

@@ -30,6 +30,4 @@ export default v;
 export declare const customStagesMap: Map<string, CustomStage>;
 /** Indexed by room variant. */
 export declare const customStageCachedRoomData: Map<number, Readonly<RoomConfig>>;
-/** Indexed by entity ID. */
-export declare const customBossPNGPaths: Map<string, [namePNGPath: string, portraitPNGPath: string]>;
 //# sourceMappingURL=v.d.ts.map

package/dist/features/customStage/v.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAA,MAAM,CAAC;;;QAIH,iDAAiD;;;QAKjD,oFAAoF;;;;;;;;;;;;;;;;;CAqBvF,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,oCAAoC;AACpC,eAAO,MAAM,eAAe,0BAAiC,CAAC;AAE9D,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB,mCAAuC,CAAC;AAE9E,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,6DAG5B,CAAC"}
+{"version":3,"file":"v.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/v.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAA,MAAM,CAAC;;;QAIH,iDAAiD;;;QAKjD,oFAAoF;;;;;;;;;;;;;;;;;CAqBvF,CAAC;AACF,eAAe,CAAC,CAAC;AAEjB,oCAAoC;AACpC,eAAO,MAAM,eAAe,0BAAiC,CAAC;AAE9D,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB,mCAAuC,CAAC"}

package/dist/features/customStage/v.lua

@@ -21,6 +21,4 @@ ____exports.default = v
 ____exports.customStagesMap = __TS__New(Map)
 --- Indexed by room variant.
 ____exports.customStageCachedRoomData = __TS__New(Map)
---- Indexed by entity ID.
-____exports.customBossPNGPaths = __TS__New(Map)
 return ____exports

package/dist/features/customStage/versusScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AA2EnE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAwExE;AAoFD,wBAAgB,sBAAsB,IAAI,IAAI,CAoC7C"}
+{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/versusScreen.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AA+EnE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CA4ExE;AAmGD,wBAAgB,sBAAsB,IAAI,IAAI,CAkC7C"}