isaacscript-common 30.4.1 → 30.4.2

package/dist/index.rollup.d.ts

@@ -1844,10 +1844,10 @@ declare class CustomGridEntities extends Feature {
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.CUSTOM_GRID_ENTITIES`.
      */
-    getCustomGridEntities(): Array<[
-    gridEntity: GridEntity,
-    data: GridEntityCustomData
-    ]>;
+    getCustomGridEntities(): Array<{
+        gridEntity: GridEntity;
+        data: GridEntityCustomData;
+    }>;
     /**
      * Helper function to get the custom `GridEntityType` from a `GridEntity` or grid index. Returns
      * undefined if the provided `GridEntity` is not a custom grid entity, or if there was not a grid
@@ -4279,7 +4279,7 @@ export declare function getActivePocketItemSlot(player: EntityPlayer): PocketIte
  * This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
  * that function for more information.
  */
-export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): readonly int[];
 
 /**
  * Helper function to get only the adjacent room grid indexes that do not exist (i.e. do not have
@@ -4288,7 +4288,7 @@ export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int):
  * This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
  * that function for more information.
  */
-export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: int): readonly int[];
 
 /**
  * Helper function to get all of the room grid indexes that are adjacent to a given room grid index
@@ -4305,7 +4305,7 @@ export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: in
  *
  * @param roomGridIndex Optional. Default is the current room index.
  */
-export declare function getAdjacentRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentRoomGridIndexes(roomGridIndex?: int): readonly int[];
 
 /**
  * Helper function to get all of the non-dead bosses in the room.
@@ -4382,7 +4382,7 @@ export declare function getAllPillColors(): PillColor[];
 export declare function getAllPlayers(): EntityPlayer[];
 
 /** Helper function to get the room safe grid index for every room on the entire floor. */
-export declare function getAllRoomGridIndexes(): int[];
+export declare function getAllRoomGridIndexes(): readonly int[];
 
 /**
  * Helper function to get the corresponding ambush type for the current room. Returns undefined if
@@ -5488,7 +5488,11 @@ export declare function getNewGlobals(): ReadonlyArray<[AnyNotNil, unknown]>;
  * @returns Either a tuple of adjacent room grid index, `DoorSlot`, and new room grid index, or
  *          undefined.
  */
-export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRoomGridIndex: int, doorSlot: DoorSlot, newRoomGridIndex: int] | undefined;
+export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): {
+    readonly adjacentRoomGridIndex: int;
+    readonly doorSlot: DoorSlot;
+    readonly newRoomGridIndex: int;
+} | undefined;
 
 /**
  * Helper function to iterate through the possible doors for a room and see if any of them would be
@@ -5498,7 +5502,10 @@ export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRo
  * @param roomGridIndex Optional. Default is the current room index.
  * @returns A array of tuples of `DoorSlot` and room grid index.
  */
-export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Array<[doorSlot: DoorSlot, roomGridIndex: int]>;
+export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): ReadonlyArray<{
+    readonly doorSlot: DoorSlot;
+    readonly roomGridIndex: int;
+}>;
 
 /**
  * Helper function to search through all of the rooms on the floor for a spot to insert a brand new
@@ -5507,11 +5514,11 @@ export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Arr
  * @returns A array of tuples containing the adjacent room grid index, the `DoorSlot`, and the new
  *          room grid index.
  */
-export declare function getNewRoomCandidatesForLevel(): Array<[
-adjacentRoomGridIndex: int,
-doorSlot: DoorSlot,
-newRoomGridIndex: int
-]>;
+export declare function getNewRoomCandidatesForLevel(): ReadonlyArray<{
+    readonly adjacentRoomGridIndex: int;
+    readonly doorSlot: DoorSlot;
+    readonly newRoomGridIndex: int;
+}>;
 
 /**
  * Helper function to get the stage that a trapdoor or heaven door would take the player to, based
@@ -6356,7 +6363,7 @@ export declare function getRoomGridIndex(): int;
  * This function is variadic, meaning that you can specify N arguments to get the combined grid
  * indexes for N room types.
  */
-export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): int[];
+export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): readonly int[];
 
 /**
  * Helper function to get the item pool type for the current room. For example, this returns
@@ -14483,7 +14490,7 @@ export declare function roomExists(roomGridIndex: int): boolean;
  * - The bottom-left grid index of 156 is equal to coordinates of: (0, 12)
  * - The bottom-right grid index of 168 is equal to coordinates of: (12, 12)
  */
-export declare function roomGridIndexToVector(roomGridIndex: int): Vector;
+export declare function roomGridIndexToVector(roomGridIndex: int): Readonly<Vector>;
 
 declare class RoomHistory extends Feature {
     private postNewRoomEarly;
@@ -16200,10 +16207,7 @@ declare class StageHistory extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.STAGE_HISTORY`.
      */
-    getStageHistory(): ReadonlyArray<[
-    stage: LevelStage,
-    stageType: StageType
-    ]>;
+    getStageHistory(): readonly StageHistoryEntry[];
     /**
      * Helper function to check if a player has previous visited a particular stage (or stage + stage
      * type combination) on this run.
@@ -16217,6 +16221,12 @@ declare class StageHistory extends Feature {
     hasVisitedStage(stage: LevelStage, stageType?: StageType): boolean;
 }
 
+/** This is used by the `StageHistory` feature. */
+declare interface StageHistoryEntry {
+    readonly stage: LevelStage;
+    readonly stageType: StageType;
+}
+
 /**
  * Helper function to convert a numerical `StageType` into the letter suffix supplied to the "stage"
  * console command. For example, `StageType.REPENTANCE` is the stage type for Downpour, and the

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 30.4.1
+isaacscript-common 30.4.2
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -1491,6 +1491,20 @@ do
     end
 end
 
+local function __TS__NumberToFixed(self, fractionDigits)
+    if math.abs(self) >= 1e+21 or self ~= self then
+        return tostring(self)
+    end
+    local f = math.floor(fractionDigits or 0)
+    if f < 0 or f > 99 then
+        error("toFixed() digits argument must be between 0 and 99", 0)
+    end
+    return string.format(
+        ("%." .. tostring(f)) .. "f",
+        self
+    )
+end
+
 local function __TS__ObjectDefineProperty(target, key, desc)
     local luaKey = type(key) == "number" and key + 1 or key
     local value = rawget(target, luaKey)
@@ -2463,6 +2477,7 @@ return {
   __TS__NumberIsFinite = __TS__NumberIsFinite,
   __TS__NumberIsNaN = __TS__NumberIsNaN,
   __TS__NumberToString = __TS__NumberToString,
+  __TS__NumberToFixed = __TS__NumberToFixed,
   __TS__ObjectAssign = __TS__ObjectAssign,
   __TS__ObjectDefineProperty = __TS__ObjectDefineProperty,
   __TS__ObjectEntries = __TS__ObjectEntries,
@@ -27924,8 +27939,6 @@ local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local HeartSubType = ____isaac_2Dtypescript_2Ddefinitions.HeartSubType
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
-local ____cachedEnumValues = require("src.arrays.cachedEnumValues")
-local ACTIVE_SLOT_VALUES = ____cachedEnumValues.ACTIVE_SLOT_VALUES
 local ____constants = require("src.core.constants")
 local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
 local ____HealthType = require("src.enums.HealthType")
@@ -27939,6 +27952,7 @@ local getCharacterMaxHeartContainers = ____characters.getCharacterMaxHeartContai
 local ____charge = require("src.functions.charge")
 local getTotalCharge = ____charge.getTotalCharge
 local ____players = require("src.functions.players")
+local getActiveItemSlots = ____players.getActiveItemSlots
 local isCharacter = ____players.isCharacter
 local isKeeper = ____players.isKeeper
 local setActiveItem = ____players.setActiveItem
@@ -27997,18 +28011,14 @@ end
 function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()
-    ____exports.removeAllPlayerHealth(nil, player)
-    local alabasterBoxes = {}
-    if player:HasCollectible(CollectibleType.ALABASTER_BOX) then
-        for ____, activeSlot in ipairs(ACTIVE_SLOT_VALUES) do
-            local activeItem = player:GetActiveItem()
-            if activeItem == CollectibleType.ALABASTER_BOX then
-                local totalCharge = getTotalCharge(nil, player, activeSlot)
-                setActiveItem(nil, player, CollectibleType.NULL, activeSlot)
-                alabasterBoxes[#alabasterBoxes + 1] = {activeSlot, totalCharge}
-            end
-        end
+    local alabasterBoxDescriptions = {}
+    local alabasterBoxActiveSlots = getActiveItemSlots(nil, player, CollectibleType.ALABASTER_BOX)
+    for ____, activeSlot in ipairs(alabasterBoxActiveSlots) do
+        local totalCharge = getTotalCharge(nil, player, activeSlot)
+        setActiveItem(nil, player, CollectibleType.NULL, activeSlot)
+        alabasterBoxDescriptions[#alabasterBoxDescriptions + 1] = {activeSlot = activeSlot, totalCharge = totalCharge}
     end
+    ____exports.removeAllPlayerHealth(nil, player)
     if character == PlayerType.SOUL and subPlayer ~= nil then
         subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
     else
@@ -28025,25 +28035,25 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
                 addAmount = 1
             end
             repeat
-                local ____switch72 = soulHeartType
-                local ____cond72 = ____switch72 == HeartSubType.SOUL
-                if ____cond72 then
+                local ____switch70 = soulHeartType
+                local ____cond70 = ____switch70 == HeartSubType.SOUL
+                if ____cond70 then
                     do
                         player:AddSoulHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BLACK
-                if ____cond72 then
+                ____cond70 = ____cond70 or ____switch70 == HeartSubType.BLACK
+                if ____cond70 then
                     do
                         player:AddBlackHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BONE
-                if ____cond72 then
+                ____cond70 = ____cond70 or ____switch70 == HeartSubType.BONE
+                if ____cond70 then
                     do
                         player:AddBoneHearts(addAmount)
                         break
@@ -28081,9 +28091,9 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
     elseif character == PlayerType.BETHANY_B then
         player:SetBloodCharge(playerHealth.bloodCharges)
     end
-    for ____, ____value in ipairs(alabasterBoxes) do
-        local activeSlot = ____value[1]
-        local totalCharge = ____value[2]
+    for ____, ____value in ipairs(alabasterBoxDescriptions) do
+        local activeSlot = ____value.activeSlot
+        local totalCharge = ____value.totalCharge
         setActiveItem(
             nil,
             player,
@@ -34182,7 +34192,7 @@ function CustomGridEntities.prototype.getCustomGridEntities(self)
         local data = ____value[2]
         local gridEntity = room:GetGridEntity(gridIndex)
         if gridEntity ~= nil then
-            customGridEntities[#customGridEntities + 1] = {gridEntity, data}
+            customGridEntities[#customGridEntities + 1] = {gridEntity = gridEntity, data = data}
         end
     end
     return customGridEntities
@@ -41062,6 +41072,10 @@ function ____exports.getNextStageType(self, upwards)
     end
     return calculateStageType(nil, nextStage)
 end
+return ____exports
+ end,
+["src.interfaces.StageHistoryEntry"] = function(...) 
+local ____exports = {}
 return ____exports
  end,
 ["src.classes.features.other.StageHistory"] = function(...) 
@@ -41104,7 +41118,7 @@ function StageHistory.prototype.____constructor(self)
         local stage = level:GetStage()
         local stageType = level:GetStageType()
         local ____v_run_stageHistory_0 = v.run.stageHistory
-        ____v_run_stageHistory_0[#____v_run_stageHistory_0 + 1] = {stage, stageType}
+        ____v_run_stageHistory_0[#____v_run_stageHistory_0 + 1] = {stage = stage, stageType = stageType}
     end
     self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_LEVEL_REORDERED, self.postNewLevelReordered}}
 end
@@ -41243,22 +41257,12 @@ function StageHistory.prototype.hasVisitedStage(self, stage, stageType)
     if stageType == nil then
         return __TS__ArraySome(
             v.run.stageHistory,
-            function(____, ____bindingPattern0)
-                local previousStage
-                previousStage = ____bindingPattern0[1]
-                return previousStage == stage
-            end
+            function(____, stageHistoryEntry) return stageHistoryEntry.stage == stage end
         )
     end
     return __TS__ArraySome(
         v.run.stageHistory,
-        function(____, ____bindingPattern0)
-            local previousStageType
-            local previousStage
-            previousStage = ____bindingPattern0[1]
-            previousStageType = ____bindingPattern0[2]
-            return previousStage == stage and previousStageType == stageType
-        end
+        function(____, stageHistoryEntry) return stageHistoryEntry.stage == stage and stageHistoryEntry.stageType == stageType end
     )
 end
 __TS__Decorate({Exported}, StageHistory.prototype, "getNextStageTypeWithHistory", true)
@@ -47236,7 +47240,7 @@ function ____exports.getNewRoomCandidatesBesideRoom(self, roomGridIndex)
             if not ____exports.isDeadEnd(nil, adjacentRoomGridIndex) then
                 goto __continue17
             end
-            roomCandidates[#roomCandidates + 1] = {doorSlot, adjacentRoomGridIndex}
+            roomCandidates[#roomCandidates + 1] = {doorSlot = doorSlot, roomGridIndex = adjacentRoomGridIndex}
         end
         ::__continue17::
     end
@@ -47252,9 +47256,9 @@ function ____exports.getNewRoomCandidatesForLevel(self)
     for ____, room in ipairs(normalRooms) do
         local newRoomCandidatesBesideRoom = ____exports.getNewRoomCandidatesBesideRoom(nil, room.SafeGridIndex)
         for ____, ____value in ipairs(newRoomCandidatesBesideRoom) do
-            local doorSlot = ____value[1]
-            local newRoomGridIndex = ____value[2]
-            newRoomCandidates[#newRoomCandidates + 1] = {room.SafeGridIndex, doorSlot, newRoomGridIndex}
+            local doorSlot = ____value.doorSlot
+            local roomGridIndex = ____value.roomGridIndex
+            newRoomCandidates[#newRoomCandidates + 1] = {adjacentRoomGridIndex = room.SafeGridIndex, doorSlot = doorSlot, newRoomGridIndex = roomGridIndex}
         end
     end
     return newRoomCandidates
@@ -47408,7 +47412,9 @@ function ____exports.newRoom(self, seedOrRNG)
     if newRoomCandidate == nil then
         return nil
     end
-    local adjacentRoomGridIndex, doorSlot, newRoomGridIndex = table.unpack(newRoomCandidate)
+    local adjacentRoomGridIndex = newRoomCandidate.adjacentRoomGridIndex
+    local doorSlot = newRoomCandidate.doorSlot
+    local newRoomGridIndex = newRoomCandidate.newRoomGridIndex
     level:MakeRedRoomDoor(adjacentRoomGridIndex, doorSlot)
     local roomDescriptor = getRoomDescriptor(nil, newRoomGridIndex)
     roomDescriptor.Flags = removeFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.RED_ROOM)
@@ -50369,7 +50375,7 @@ local ____playerIndex = require("src.functions.playerIndex")
 local getPlayerIndex = ____playerIndex.getPlayerIndex
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
-local v = {run = {buttonActionTuples = {}}}
+local v = {run = {buttonActionPairs = {}}}
 ____exports.PressInput = __TS__Class()
 local PressInput = ____exports.PressInput
 PressInput.name = "PressInput"
@@ -50387,12 +50393,11 @@ function PressInput.prototype.____constructor(self)
         end
         local playerIndex = getPlayerIndex(nil, player)
         do
-            local i = #v.run.buttonActionTuples - 1
+            local i = #v.run.buttonActionPairs - 1
             while i >= 0 do
-                local tuple = v.run.buttonActionTuples[i + 1]
-                local tuplePlayerIndex, tupleButtonAction = table.unpack(tuple)
-                if tuplePlayerIndex == playerIndex and tupleButtonAction == buttonAction then
-                    __TS__ArraySplice(v.run.buttonActionTuples, i)
+                local pair = v.run.buttonActionPairs[i + 1]
+                if pair.playerIndex == playerIndex and pair.buttonAction == buttonAction then
+                    __TS__ArraySplice(v.run.buttonActionPairs, i)
                     return true
                 end
                 i = i - 1
@@ -50404,8 +50409,8 @@ function PressInput.prototype.____constructor(self)
 end
 function PressInput.prototype.pressInput(self, player, buttonAction)
     local playerIndex = getPlayerIndex(nil, player)
-    local ____v_run_buttonActionTuples_0 = v.run.buttonActionTuples
-    ____v_run_buttonActionTuples_0[#____v_run_buttonActionTuples_0 + 1] = {playerIndex, buttonAction}
+    local ____v_run_buttonActionPairs_0 = v.run.buttonActionPairs
+    ____v_run_buttonActionPairs_0[#____v_run_buttonActionPairs_0 + 1] = {playerIndex = playerIndex, buttonAction = buttonAction}
 end
 __TS__Decorate({Exported}, PressInput.prototype, "pressInput", true)
 return ____exports

package/dist/lualib_bundle.lua

@@ -1440,6 +1440,20 @@ do
     end
 end
 
+local function __TS__NumberToFixed(self, fractionDigits)
+    if math.abs(self) >= 1e+21 or self ~= self then
+        return tostring(self)
+    end
+    local f = math.floor(fractionDigits or 0)
+    if f < 0 or f > 99 then
+        error("toFixed() digits argument must be between 0 and 99", 0)
+    end
+    return string.format(
+        ("%." .. tostring(f)) .. "f",
+        self
+    )
+end
+
 local function __TS__ObjectDefineProperty(target, key, desc)
     local luaKey = type(key) == "number" and key + 1 or key
     local value = rawget(target, luaKey)
@@ -2412,6 +2426,7 @@ return {
   __TS__NumberIsFinite = __TS__NumberIsFinite,
   __TS__NumberIsNaN = __TS__NumberIsNaN,
   __TS__NumberToString = __TS__NumberToString,
+  __TS__NumberToFixed = __TS__NumberToFixed,
   __TS__ObjectAssign = __TS__ObjectAssign,
   __TS__ObjectDefineProperty = __TS__ObjectDefineProperty,
   __TS__ObjectEntries = __TS__ObjectEntries,

package/dist/src/classes/features/callbackLogic/CustomGridEntities.d.ts

@@ -112,10 +112,10 @@ export declare class CustomGridEntities extends Feature {
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.CUSTOM_GRID_ENTITIES`.
      */
-    getCustomGridEntities(): Array<[
-        gridEntity: GridEntity,
-        data: GridEntityCustomData
-    ]>;
+    getCustomGridEntities(): Array<{
+        gridEntity: GridEntity;
+        data: GridEntityCustomData;
+    }>;
     /**
      * Helper function to get the custom `GridEntityType` from a `GridEntity` or grid index. Returns
      * undefined if the provided `GridEntity` is not a custom grid entity, or if there was not a grid

package/dist/src/classes/features/callbackLogic/CustomGridEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomGridEntities.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomGridEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAatC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAiBhD,qBAAa,kBAAmB,SAAQ,OAAO;IAI7C,OAAO,CAAC,YAAY,CAAe;IA0BnC,OAAO,CAAC,0BAA0B,CA+ChC;IAGF,OAAO,CAAC,oBAAoB,CA4B1B;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+EG;IAEI,qBAAqB,CAC1B,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;IA8Cb;;;;;;;;;;;;;;;;;OAiBG;IAEI,sBAAsB,CAC3B,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS;IAuCzB;;;;;;OAMG;IAEI,qBAAqB,IAAI,KAAK,CACnC;QAAC,UAAU,EAAE,UAAU;QAAE,IAAI,EAAE,oBAAoB;KAAC,CACrD;IAoBD;;;;;;;OAOG;IAEI,uBAAuB,CAC5B,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS;IAyB7B;;;;;;OAMG;IAEI,kBAAkB,CAAC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GAAG,OAAO;CAM5E"}
+{"version":3,"file":"CustomGridEntities.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/callbackLogic/CustomGridEntities.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAClB,cAAc,EAGf,MAAM,8BAA8B,CAAC;AAatC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAiBhD,qBAAa,kBAAmB,SAAQ,OAAO;IAI7C,OAAO,CAAC,YAAY,CAAe;IA0BnC,OAAO,CAAC,0BAA0B,CA+ChC;IAGF,OAAO,CAAC,oBAAoB,CA4B1B;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+EG;IAEI,qBAAqB,CAC1B,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;IA8Cb;;;;;;;;;;;;;;;;;OAiBG;IAEI,sBAAsB,CAC3B,+BAA+B,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU,EAC1D,UAAU,UAAO,GAChB,UAAU,GAAG,SAAS;IAuCzB;;;;;;OAMG;IAEI,qBAAqB,IAAI,KAAK,CAAC;QACpC,UAAU,EAAE,UAAU,CAAC;QACvB,IAAI,EAAE,oBAAoB,CAAC;KAC5B,CAAC;IAuBF;;;;;;;OAOG;IAEI,uBAAuB,CAC5B,qBAAqB,EAAE,UAAU,GAAG,GAAG,GACtC,cAAc,GAAG,SAAS;IAyB7B;;;;;;OAMG;IAEI,kBAAkB,CAAC,qBAAqB,EAAE,UAAU,GAAG,GAAG,GAAG,OAAO;CAM5E"}

package/dist/src/classes/features/callbackLogic/CustomGridEntities.lua

@@ -193,7 +193,7 @@ function CustomGridEntities.prototype.getCustomGridEntities(self)
         local data = ____value[2]
         local gridEntity = room:GetGridEntity(gridIndex)
         if gridEntity ~= nil then
-            customGridEntities[#customGridEntities + 1] = {gridEntity, data}
+            customGridEntities[#customGridEntities + 1] = {gridEntity = gridEntity, data = data}
         end
     end
     return customGridEntities

package/dist/src/classes/features/other/PressInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PressInput.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/PressInput.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,UAAW,SAAQ,OAAO;IAoBrC,OAAO,CAAC,iBAAiB,CA+BvB;IAEF;;;;;;OAMG;IAEI,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;CAI1E"}
+{"version":3,"file":"PressInput.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/PressInput.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAWhD,qBAAa,UAAW,SAAQ,OAAO;IAoBrC,OAAO,CAAC,iBAAiB,CA8BvB;IAEF;;;;;;OAMG;IAEI,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;CAI1E"}

package/dist/src/classes/features/other/PressInput.lua

@@ -13,7 +13,7 @@ local ____playerIndex = require("src.functions.playerIndex")
 local getPlayerIndex = ____playerIndex.getPlayerIndex
 local ____Feature = require("src.classes.private.Feature")
 local Feature = ____Feature.Feature
-local v = {run = {buttonActionTuples = {}}}
+local v = {run = {buttonActionPairs = {}}}
 ____exports.PressInput = __TS__Class()
 local PressInput = ____exports.PressInput
 PressInput.name = "PressInput"
@@ -31,12 +31,11 @@ function PressInput.prototype.____constructor(self)
         end
         local playerIndex = getPlayerIndex(nil, player)
         do
-            local i = #v.run.buttonActionTuples - 1
+            local i = #v.run.buttonActionPairs - 1
             while i >= 0 do
-                local tuple = v.run.buttonActionTuples[i + 1]
-                local tuplePlayerIndex, tupleButtonAction = table.unpack(tuple)
-                if tuplePlayerIndex == playerIndex and tupleButtonAction == buttonAction then
-                    __TS__ArraySplice(v.run.buttonActionTuples, i)
+                local pair = v.run.buttonActionPairs[i + 1]
+                if pair.playerIndex == playerIndex and pair.buttonAction == buttonAction then
+                    __TS__ArraySplice(v.run.buttonActionPairs, i)
                     return true
                 end
                 i = i - 1
@@ -48,8 +47,8 @@ function PressInput.prototype.____constructor(self)
 end
 function PressInput.prototype.pressInput(self, player, buttonAction)
     local playerIndex = getPlayerIndex(nil, player)
-    local ____v_run_buttonActionTuples_0 = v.run.buttonActionTuples
-    ____v_run_buttonActionTuples_0[#____v_run_buttonActionTuples_0 + 1] = {playerIndex, buttonAction}
+    local ____v_run_buttonActionPairs_0 = v.run.buttonActionPairs
+    ____v_run_buttonActionPairs_0[#____v_run_buttonActionPairs_0 + 1] = {playerIndex = playerIndex, buttonAction = buttonAction}
 end
 __TS__Decorate({Exported}, PressInput.prototype, "pressInput", true)
 return ____exports

package/dist/src/classes/features/other/StageHistory.d.ts

@@ -1,4 +1,5 @@
 import { LevelStage, StageType } from "isaac-typescript-definitions";
+import { StageHistoryEntry } from "../../../interfaces/StageHistoryEntry";
 import { Feature } from "../../private/Feature";
 export declare class StageHistory extends Feature {
     private postNewLevelReordered;
@@ -32,10 +33,7 @@ export declare class StageHistory extends Feature {
      *
      * In order to use this function, you must upgrade your mod with `ISCFeature.STAGE_HISTORY`.
      */
-    getStageHistory(): ReadonlyArray<[
-        stage: LevelStage,
-        stageType: StageType
-    ]>;
+    getStageHistory(): readonly StageHistoryEntry[];
     /**
      * Helper function to check if a player has previous visited a particular stage (or stage + stage
      * type combination) on this run.

package/dist/src/classes/features/other/StageHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StageHistory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/StageHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAUtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,YAAa,SAAQ,OAAO;IAcvC,OAAO,CAAC,qBAAqB,CAM3B;IAEF;;;;;;;;;;;;OAYG;IAEI,2BAA2B,CAAC,OAAO,UAAQ,GAAG,SAAS;IAiG9D;;;;;;;;;OASG;IAEI,uBAAuB,IAAI,UAAU;IA8H5C;;;;OAIG;IAEI,eAAe,IAAI,aAAa,CACrC;QAAC,KAAK,EAAE,UAAU;QAAE,SAAS,EAAE,SAAS;KAAC,CAC1C;IAID;;;;;;;;;OASG;IAEI,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO;CAY1E"}
+{"version":3,"file":"StageHistory.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/StageHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAUtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQhD,qBAAa,YAAa,SAAQ,OAAO;IAcvC,OAAO,CAAC,qBAAqB,CAM3B;IAEF;;;;;;;;;;;;OAYG;IAEI,2BAA2B,CAAC,OAAO,UAAQ,GAAG,SAAS;IAiG9D;;;;;;;;;OASG;IAEI,uBAAuB,IAAI,UAAU;IA8H5C;;;;OAIG;IAEI,eAAe,IAAI,SAAS,iBAAiB,EAAE;IAItD;;;;;;;;;OASG;IAEI,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO;CAa1E"}

package/dist/src/classes/features/other/StageHistory.lua

@@ -37,7 +37,7 @@ function StageHistory.prototype.____constructor(self)
         local stage = level:GetStage()
         local stageType = level:GetStageType()
         local ____v_run_stageHistory_0 = v.run.stageHistory
-        ____v_run_stageHistory_0[#____v_run_stageHistory_0 + 1] = {stage, stageType}
+        ____v_run_stageHistory_0[#____v_run_stageHistory_0 + 1] = {stage = stage, stageType = stageType}
     end
     self.customCallbacksUsed = {{ModCallbackCustom.POST_NEW_LEVEL_REORDERED, self.postNewLevelReordered}}
 end
@@ -176,22 +176,12 @@ function StageHistory.prototype.hasVisitedStage(self, stage, stageType)
     if stageType == nil then
         return __TS__ArraySome(
             v.run.stageHistory,
-            function(____, ____bindingPattern0)
-                local previousStage
-                previousStage = ____bindingPattern0[1]
-                return previousStage == stage
-            end
+            function(____, stageHistoryEntry) return stageHistoryEntry.stage == stage end
         )
     end
     return __TS__ArraySome(
         v.run.stageHistory,
-        function(____, ____bindingPattern0)
-            local previousStageType
-            local previousStage
-            previousStage = ____bindingPattern0[1]
-            previousStageType = ____bindingPattern0[2]
-            return previousStage == stage and previousStageType == stageType
-        end
+        function(____, stageHistoryEntry) return stageHistoryEntry.stage == stage and stageHistoryEntry.stageType == stageType end
     )
 end
 __TS__Decorate({Exported}, StageHistory.prototype, "getNextStageTypeWithHistory", true)

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

@@ -13,7 +13,7 @@ import { DoorSlot, RoomShape, RoomType } from "isaac-typescript-definitions";
  * This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
  * that function for more information.
  */
-export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): readonly int[];
 /**
  * Helper function to get only the adjacent room grid indexes that do not exist (i.e. do not have
  * room data).
@@ -21,7 +21,7 @@ export declare function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int):
  * This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
  * that function for more information.
  */
-export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: int): readonly int[];
 /**
  * Helper function to get all of the room grid indexes that are adjacent to a given room grid index
  * (even if those room grid indexes do not have any rooms in them).
@@ -37,9 +37,9 @@ export declare function getAdjacentNonExistingRoomGridIndexes(roomGridIndex?: in
  *
  * @param roomGridIndex Optional. Default is the current room index.
  */
-export declare function getAdjacentRoomGridIndexes(roomGridIndex?: int): int[];
+export declare function getAdjacentRoomGridIndexes(roomGridIndex?: int): readonly int[];
 /** Helper function to get the room safe grid index for every room on the entire floor. */
-export declare function getAllRoomGridIndexes(): int[];
+export declare function getAllRoomGridIndexes(): readonly int[];
 /**
  * Helper function to pick a random valid spot on the floor to insert a brand new room. Note that
  * some floors will not have any valid spots. If this is the case, this function will return
@@ -50,7 +50,11 @@ export declare function getAllRoomGridIndexes(): int[];
  * @returns Either a tuple of adjacent room grid index, `DoorSlot`, and new room grid index, or
  *          undefined.
  */
-export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRoomGridIndex: int, doorSlot: DoorSlot, newRoomGridIndex: int] | undefined;
+export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): {
+    readonly adjacentRoomGridIndex: int;
+    readonly doorSlot: DoorSlot;
+    readonly newRoomGridIndex: int;
+} | undefined;
 /**
  * Helper function to iterate through the possible doors for a room and see if any of them would be
  * a valid spot to insert a brand new room on the floor. (Any potential new rooms cannot be
@@ -59,7 +63,10 @@ export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRo
  * @param roomGridIndex Optional. Default is the current room index.
  * @returns A array of tuples of `DoorSlot` and room grid index.
  */
-export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Array<[doorSlot: DoorSlot, roomGridIndex: int]>;
+export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): ReadonlyArray<{
+    readonly doorSlot: DoorSlot;
+    readonly roomGridIndex: int;
+}>;
 /**
  * Helper function to search through all of the rooms on the floor for a spot to insert a brand new
  * room.
@@ -67,11 +74,11 @@ export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Arr
  * @returns A array of tuples containing the adjacent room grid index, the `DoorSlot`, and the new
  *          room grid index.
  */
-export declare function getNewRoomCandidatesForLevel(): Array<[
-    adjacentRoomGridIndex: int,
-    doorSlot: DoorSlot,
-    newRoomGridIndex: int
-]>;
+export declare function getNewRoomCandidatesForLevel(): ReadonlyArray<{
+    readonly adjacentRoomGridIndex: int;
+    readonly doorSlot: DoorSlot;
+    readonly newRoomGridIndex: int;
+}>;
 /**
  * Helper function to get the grid indexes of all the rooms connected to the given room index,
  * taking the shape of the room into account. (This will only include rooms with valid data.)
@@ -102,7 +109,7 @@ export declare function getRoomDescriptorsForType(...roomTypes: RoomType[]): Roo
  * This function is variadic, meaning that you can specify N arguments to get the combined grid
  * indexes for N room types.
  */
-export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): int[];
+export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): readonly int[];
 /**
  * Helper function to get only the adjacent room grid indexes for a room shape that exist (i.e. have
  * room data).
@@ -199,7 +206,7 @@ export declare function roomExists(roomGridIndex: int): boolean;
  * - The bottom-left grid index of 156 is equal to coordinates of: (0, 12)
  * - The bottom-right grid index of 168 is equal to coordinates of: (12, 12)
  */
-export declare function roomGridIndexToVector(roomGridIndex: int): Vector;
+export declare function roomGridIndexToVector(roomGridIndex: int): Readonly<Vector>;
 /**
  * Helper function to convert a room grid index expressed as a vector back into an integer.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"levelGrid.d.ts","sourceRoot":"","sources":["../../../src/functions/levelGrid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"levelGrid.d.ts","sourceRoot":"","sources":["../../../src/functions/levelGrid.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/levelGrid.lua

@@ -116,7 +116,7 @@ function ____exports.getNewRoomCandidatesBesideRoom(self, roomGridIndex)
             if not ____exports.isDeadEnd(nil, adjacentRoomGridIndex) then
                 goto __continue17
             end
-            roomCandidates[#roomCandidates + 1] = {doorSlot, adjacentRoomGridIndex}
+            roomCandidates[#roomCandidates + 1] = {doorSlot = doorSlot, roomGridIndex = adjacentRoomGridIndex}
         end
         ::__continue17::
     end
@@ -137,9 +137,9 @@ function ____exports.getNewRoomCandidatesForLevel(self)
     for ____, room in ipairs(normalRooms) do
         local newRoomCandidatesBesideRoom = ____exports.getNewRoomCandidatesBesideRoom(nil, room.SafeGridIndex)
         for ____, ____value in ipairs(newRoomCandidatesBesideRoom) do
-            local doorSlot = ____value[1]
-            local newRoomGridIndex = ____value[2]
-            newRoomCandidates[#newRoomCandidates + 1] = {room.SafeGridIndex, doorSlot, newRoomGridIndex}
+            local doorSlot = ____value.doorSlot
+            local roomGridIndex = ____value.roomGridIndex
+            newRoomCandidates[#newRoomCandidates + 1] = {adjacentRoomGridIndex = room.SafeGridIndex, doorSlot = doorSlot, newRoomGridIndex = roomGridIndex}
         end
     end
     return newRoomCandidates
@@ -385,7 +385,9 @@ function ____exports.newRoom(self, seedOrRNG)
     if newRoomCandidate == nil then
         return nil
     end
-    local adjacentRoomGridIndex, doorSlot, newRoomGridIndex = table.unpack(newRoomCandidate)
+    local adjacentRoomGridIndex = newRoomCandidate.adjacentRoomGridIndex
+    local doorSlot = newRoomCandidate.doorSlot
+    local newRoomGridIndex = newRoomCandidate.newRoomGridIndex
     level:MakeRedRoomDoor(adjacentRoomGridIndex, doorSlot)
     local roomDescriptor = getRoomDescriptor(nil, newRoomGridIndex)
     roomDescriptor.Flags = removeFlag(nil, roomDescriptor.Flags, RoomDescriptorFlag.RED_ROOM)

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

@@ -1 +1 @@
-{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AASA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAOzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAsHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}
+{"version":3,"file":"playerHealth.d.ts","sourceRoot":"","sources":["../../../src/functions/playerHealth.ts"],"names":[],"mappings":";;AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAiB,MAAM,4BAA4B,CAAC;AAYzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA2ElE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAmDL;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAKzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAoDnE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAqCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAK7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,YAAY,GACnB,GAAG,CAML;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,YAAY,CAc9C;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,YAAY,GACnB,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAMjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,YAAY,GACzB,IAAI,CAyHN;AAED;;;;;;;;;GASG;AACH,wBAAgB,sDAAsD,CACpE,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,KAAK,GAClB,OAAO,CAyBT"}

package/dist/src/functions/playerHealth.lua

@@ -7,8 +7,6 @@ local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local HeartSubType = ____isaac_2Dtypescript_2Ddefinitions.HeartSubType
 local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
-local ____cachedEnumValues = require("src.arrays.cachedEnumValues")
-local ACTIVE_SLOT_VALUES = ____cachedEnumValues.ACTIVE_SLOT_VALUES
 local ____constants = require("src.core.constants")
 local MAX_PLAYER_HEART_CONTAINERS = ____constants.MAX_PLAYER_HEART_CONTAINERS
 local ____HealthType = require("src.enums.HealthType")
@@ -22,6 +20,7 @@ local getCharacterMaxHeartContainers = ____characters.getCharacterMaxHeartContai
 local ____charge = require("src.functions.charge")
 local getTotalCharge = ____charge.getTotalCharge
 local ____players = require("src.functions.players")
+local getActiveItemSlots = ____players.getActiveItemSlots
 local isCharacter = ____players.isCharacter
 local isKeeper = ____players.isKeeper
 local setActiveItem = ____players.setActiveItem
@@ -106,18 +105,14 @@ end
 function ____exports.setPlayerHealth(self, player, playerHealth)
     local character = player:GetPlayerType()
     local subPlayer = player:GetSubPlayer()
-    ____exports.removeAllPlayerHealth(nil, player)
-    local alabasterBoxes = {}
-    if player:HasCollectible(CollectibleType.ALABASTER_BOX) then
-        for ____, activeSlot in ipairs(ACTIVE_SLOT_VALUES) do
-            local activeItem = player:GetActiveItem()
-            if activeItem == CollectibleType.ALABASTER_BOX then
-                local totalCharge = getTotalCharge(nil, player, activeSlot)
-                setActiveItem(nil, player, CollectibleType.NULL, activeSlot)
-                alabasterBoxes[#alabasterBoxes + 1] = {activeSlot, totalCharge}
-            end
-        end
+    local alabasterBoxDescriptions = {}
+    local alabasterBoxActiveSlots = getActiveItemSlots(nil, player, CollectibleType.ALABASTER_BOX)
+    for ____, activeSlot in ipairs(alabasterBoxActiveSlots) do
+        local totalCharge = getTotalCharge(nil, player, activeSlot)
+        setActiveItem(nil, player, CollectibleType.NULL, activeSlot)
+        alabasterBoxDescriptions[#alabasterBoxDescriptions + 1] = {activeSlot = activeSlot, totalCharge = totalCharge}
     end
+    ____exports.removeAllPlayerHealth(nil, player)
     if character == PlayerType.SOUL and subPlayer ~= nil then
         subPlayer:AddMaxHearts(playerHealth.maxHearts, false)
     else
@@ -134,25 +129,25 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
                 addAmount = 1
             end
             repeat
-                local ____switch72 = soulHeartType
-                local ____cond72 = ____switch72 == HeartSubType.SOUL
-                if ____cond72 then
+                local ____switch70 = soulHeartType
+                local ____cond70 = ____switch70 == HeartSubType.SOUL
+                if ____cond70 then
                     do
                         player:AddSoulHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BLACK
-                if ____cond72 then
+                ____cond70 = ____cond70 or ____switch70 == HeartSubType.BLACK
+                if ____cond70 then
                     do
                         player:AddBlackHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BONE
-                if ____cond72 then
+                ____cond70 = ____cond70 or ____switch70 == HeartSubType.BONE
+                if ____cond70 then
                     do
                         player:AddBoneHearts(addAmount)
                         break
@@ -190,9 +185,9 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
     elseif character == PlayerType.BETHANY_B then
         player:SetBloodCharge(playerHealth.bloodCharges)
     end
-    for ____, ____value in ipairs(alabasterBoxes) do
-        local activeSlot = ____value[1]
-        local totalCharge = ____value[2]
+    for ____, ____value in ipairs(alabasterBoxDescriptions) do
+        local activeSlot = ____value.activeSlot
+        local totalCharge = ____value.totalCharge
         setActiveItem(
             nil,
             player,

package/dist/src/interfaces/StageHistoryEntry.d.ts

@@ -0,0 +1,7 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+/** This is used by the `StageHistory` feature. */
+export interface StageHistoryEntry {
+    readonly stage: LevelStage;
+    readonly stageType: StageType;
+}
+//# sourceMappingURL=StageHistoryEntry.d.ts.map

package/dist/src/interfaces/StageHistoryEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StageHistoryEntry.d.ts","sourceRoot":"","sources":["../../../src/interfaces/StageHistoryEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAErE,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B"}

package/dist/src/interfaces/StageHistoryEntry.lua

@@ -0,0 +1,2 @@
+local ____exports = {}
+return ____exports

package/package.json

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

package/src/classes/features/callbackLogic/CustomGridEntities.ts

@@ -351,9 +351,10 @@ export class CustomGridEntities extends Feature {
    * `ISCFeature.CUSTOM_GRID_ENTITIES`.
    */
   @Exported
-  public getCustomGridEntities(): Array<
-    [gridEntity: GridEntity, data: GridEntityCustomData]
-  > {
+  public getCustomGridEntities(): Array<{
+    gridEntity: GridEntity;
+    data: GridEntityCustomData;
+  }> {
     const roomListIndex = getRoomListIndex();
     const roomCustomGridEntities =
       v.level.customGridEntities.get(roomListIndex);
@@ -362,11 +363,14 @@ export class CustomGridEntities extends Feature {
     }
 
     const room = game.GetRoom();
-    const customGridEntities: Array<[GridEntity, GridEntityCustomData]> = [];
+    const customGridEntities: Array<{
+      gridEntity: GridEntity;
+      data: GridEntityCustomData;
+    }> = [];
     for (const [gridIndex, data] of roomCustomGridEntities) {
       const gridEntity = room.GetGridEntity(gridIndex);
       if (gridEntity !== undefined) {
-        customGridEntities.push([gridEntity, data]);
+        customGridEntities.push({ gridEntity, data });
       }
     }
 

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

@@ -10,7 +10,10 @@ import { Feature } from "../../private/Feature";
 
 const v = {
   run: {
-    buttonActionTuples: [] as Array<[PlayerIndex, ButtonAction]>,
+    buttonActionPairs: [] as Array<{
+      playerIndex: PlayerIndex;
+      buttonAction: ButtonAction;
+    }>,
   },
 };
 
@@ -50,16 +53,15 @@ export class PressInput extends Feature {
 
     const playerIndex = getPlayerIndex(player);
 
-    for (let i = v.run.buttonActionTuples.length - 1; i >= 0; i--) {
+    for (let i = v.run.buttonActionPairs.length - 1; i >= 0; i--) {
       // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-      const tuple = v.run.buttonActionTuples[i]!;
-      const [tuplePlayerIndex, tupleButtonAction] = tuple;
+      const pair = v.run.buttonActionPairs[i]!;
 
       if (
-        tuplePlayerIndex === playerIndex &&
-        tupleButtonAction === buttonAction
+        pair.playerIndex === playerIndex &&
+        pair.buttonAction === buttonAction
       ) {
-        v.run.buttonActionTuples.splice(i);
+        v.run.buttonActionPairs.splice(i);
         return true;
       }
     }
@@ -77,6 +79,6 @@ export class PressInput extends Feature {
   @Exported
   public pressInput(player: EntityPlayer, buttonAction: ButtonAction): void {
     const playerIndex = getPlayerIndex(player);
-    v.run.buttonActionTuples.push([playerIndex, buttonAction]);
+    v.run.buttonActionPairs.push({ playerIndex, buttonAction });
   }
 }

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

@@ -12,11 +12,12 @@ import {
   onRepentanceStage,
 } from "../../../functions/stage";
 import { asNumber } from "../../../functions/types";
+import { StageHistoryEntry } from "../../../interfaces/StageHistoryEntry";
 import { Feature } from "../../private/Feature";
 
 const v = {
   run: {
-    stageHistory: [] as Array<[stage: LevelStage, stageType: StageType]>,
+    stageHistory: [] as StageHistoryEntry[],
   },
 };
 
@@ -39,7 +40,7 @@ export class StageHistory extends Feature {
     const stage = level.GetStage();
     const stageType = level.GetStageType();
 
-    v.run.stageHistory.push([stage, stageType]);
+    v.run.stageHistory.push({ stage, stageType });
   };
 
   /**
@@ -296,9 +297,7 @@ export class StageHistory extends Feature {
    * In order to use this function, you must upgrade your mod with `ISCFeature.STAGE_HISTORY`.
    */
   @Exported
-  public getStageHistory(): ReadonlyArray<
-    [stage: LevelStage, stageType: StageType]
-  > {
+  public getStageHistory(): readonly StageHistoryEntry[] {
     return v.run.stageHistory;
   }
 
@@ -316,13 +315,14 @@ export class StageHistory extends Feature {
   public hasVisitedStage(stage: LevelStage, stageType?: StageType): boolean {
     if (stageType === undefined) {
       return v.run.stageHistory.some(
-        ([previousStage]) => previousStage === stage,
+        (stageHistoryEntry) => stageHistoryEntry.stage === stage,
       );
     }
 
     return v.run.stageHistory.some(
-      ([previousStage, previousStageType]) =>
-        previousStage === stage && previousStageType === stageType,
+      (stageHistoryEntry) =>
+        stageHistoryEntry.stage === stage &&
+        stageHistoryEntry.stageType === stageType,
     );
   }
 }

package/src/functions/levelGrid.ts

@@ -53,7 +53,9 @@ const ADJACENT_ROOM_GRID_INDEX_DELTAS = [LEFT, UP, RIGHT, DOWN] as const;
  * This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
  * that function for more information.
  */
-export function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): int[] {
+export function getAdjacentExistingRoomGridIndexes(
+  roomGridIndex?: int,
+): readonly int[] {
   const adjacentRoomGridIndexes = getAdjacentRoomGridIndexes(roomGridIndex);
   return adjacentRoomGridIndexes.filter(
     (adjacentRoomGridIndex) => getRoomData(adjacentRoomGridIndex) !== undefined,
@@ -69,7 +71,7 @@ export function getAdjacentExistingRoomGridIndexes(roomGridIndex?: int): int[] {
  */
 export function getAdjacentNonExistingRoomGridIndexes(
   roomGridIndex?: int,
-): int[] {
+): readonly int[] {
   const adjacentRoomGridIndexes = getAdjacentRoomGridIndexes(roomGridIndex);
   return adjacentRoomGridIndexes.filter(
     (adjacentRoomGridIndex) => getRoomData(adjacentRoomGridIndex) === undefined,
@@ -91,7 +93,9 @@ export function getAdjacentNonExistingRoomGridIndexes(
  *
  * @param roomGridIndex Optional. Default is the current room index.
  */
-export function getAdjacentRoomGridIndexes(roomGridIndex?: int): int[] {
+export function getAdjacentRoomGridIndexes(
+  roomGridIndex?: int,
+): readonly int[] {
   const roomGridIndexToUse =
     roomGridIndex === undefined ? getRoomGridIndex() : roomGridIndex;
 
@@ -109,7 +113,7 @@ export function getAdjacentRoomGridIndexes(roomGridIndex?: int): int[] {
 }
 
 /** Helper function to get the room safe grid index for every room on the entire floor. */
-export function getAllRoomGridIndexes(): int[] {
+export function getAllRoomGridIndexes(): readonly int[] {
   const rooms = getRooms();
   return rooms.map((roomDescriptor) => roomDescriptor.SafeGridIndex);
 }
@@ -124,10 +128,12 @@ export function getAllRoomGridIndexes(): int[] {
  * @returns Either a tuple of adjacent room grid index, `DoorSlot`, and new room grid index, or
  *          undefined.
  */
-export function getNewRoomCandidate(
-  seedOrRNG: Seed | RNG = getRandomSeed(),
-):
-  | [adjacentRoomGridIndex: int, doorSlot: DoorSlot, newRoomGridIndex: int]
+export function getNewRoomCandidate(seedOrRNG: Seed | RNG = getRandomSeed()):
+  | {
+      readonly adjacentRoomGridIndex: int;
+      readonly doorSlot: DoorSlot;
+      readonly newRoomGridIndex: int;
+    }
   | undefined {
   const newRoomCandidatesForLevel = getNewRoomCandidatesForLevel();
   if (newRoomCandidatesForLevel.length === 0) {
@@ -147,7 +153,7 @@ export function getNewRoomCandidate(
  */
 export function getNewRoomCandidatesBesideRoom(
   roomGridIndex?: int,
-): Array<[doorSlot: DoorSlot, roomGridIndex: int]> {
+): ReadonlyArray<{ readonly doorSlot: DoorSlot; readonly roomGridIndex: int }> {
   const roomDescriptor = getRoomDescriptor(roomGridIndex);
 
   // First, handle the case of rooms outside of the grid, which obviously cannot have any possible
@@ -168,7 +174,10 @@ export function getNewRoomCandidatesBesideRoom(
     roomData.Shape,
   );
 
-  const roomCandidates: Array<[DoorSlot, int]> = [];
+  const roomCandidates: Array<{
+    readonly doorSlot: DoorSlot;
+    readonly roomGridIndex: int;
+  }> = [];
 
   for (const [doorSlot, adjacentRoomGridIndex] of doorSlotToRoomGridIndexes) {
     // The "getRoomShapeAdjacentNonExistingGridIndexes" returns grid indexes for every possible
@@ -186,7 +195,10 @@ export function getNewRoomCandidatesBesideRoom(
       continue;
     }
 
-    roomCandidates.push([doorSlot, adjacentRoomGridIndex]);
+    roomCandidates.push({
+      doorSlot,
+      roomGridIndex: adjacentRoomGridIndex,
+    });
   }
 
   return roomCandidates;
@@ -199,9 +211,11 @@ export function getNewRoomCandidatesBesideRoom(
  * @returns A array of tuples containing the adjacent room grid index, the `DoorSlot`, and the new
  *          room grid index.
  */
-export function getNewRoomCandidatesForLevel(): Array<
-  [adjacentRoomGridIndex: int, doorSlot: DoorSlot, newRoomGridIndex: int]
-> {
+export function getNewRoomCandidatesForLevel(): ReadonlyArray<{
+  readonly adjacentRoomGridIndex: int;
+  readonly doorSlot: DoorSlot;
+  readonly newRoomGridIndex: int;
+}> {
   // We want to iterate over every room on the floor and search for potential new room spots.
   const rooms = getRoomsInsideGrid();
 
@@ -216,14 +230,22 @@ export function getNewRoomCandidatesForLevel(): Array<
       room.Data.Subtype !== asNumber(MinesRoomSubType.MINESHAFT_ENTRANCE),
   );
 
-  const newRoomCandidates: Array<[int, DoorSlot, int]> = [];
+  const newRoomCandidates: Array<{
+    readonly adjacentRoomGridIndex: int;
+    readonly doorSlot: DoorSlot;
+    readonly newRoomGridIndex: int;
+  }> = [];
 
   for (const room of normalRooms) {
     const newRoomCandidatesBesideRoom = getNewRoomCandidatesBesideRoom(
       room.SafeGridIndex,
     );
-    for (const [doorSlot, newRoomGridIndex] of newRoomCandidatesBesideRoom) {
-      newRoomCandidates.push([room.SafeGridIndex, doorSlot, newRoomGridIndex]);
+    for (const { doorSlot, roomGridIndex } of newRoomCandidatesBesideRoom) {
+      newRoomCandidates.push({
+        adjacentRoomGridIndex: room.SafeGridIndex,
+        doorSlot,
+        newRoomGridIndex: roomGridIndex,
+      });
     }
   }
 
@@ -291,7 +313,9 @@ export function getRoomDescriptorsForType(
  * This function is variadic, meaning that you can specify N arguments to get the combined grid
  * indexes for N room types.
  */
-export function getRoomGridIndexesForType(...roomTypes: RoomType[]): int[] {
+export function getRoomGridIndexesForType(
+  ...roomTypes: RoomType[]
+): readonly int[] {
   const roomDescriptors = getRoomDescriptorsForType(...roomTypes);
   return roomDescriptors.map((roomDescriptor) => roomDescriptor.SafeGridIndex);
 }
@@ -492,7 +516,8 @@ export function newRoom(seedOrRNG?: Seed | RNG): int | undefined {
   if (newRoomCandidate === undefined) {
     return undefined;
   }
-  const [adjacentRoomGridIndex, doorSlot, newRoomGridIndex] = newRoomCandidate;
+  const { adjacentRoomGridIndex, doorSlot, newRoomGridIndex } =
+    newRoomCandidate;
 
   level.MakeRedRoomDoor(adjacentRoomGridIndex, doorSlot);
 
@@ -552,7 +577,7 @@ export function roomExists(roomGridIndex: int): boolean {
  * - The bottom-left grid index of 156 is equal to coordinates of: (0, 12)
  * - The bottom-right grid index of 168 is equal to coordinates of: (12, 12)
  */
-export function roomGridIndexToVector(roomGridIndex: int): Vector {
+export function roomGridIndexToVector(roomGridIndex: int): Readonly<Vector> {
   const x = roomGridIndex % LEVEL_GRID_ROW_WIDTH;
   const y = Math.floor(roomGridIndex / LEVEL_GRID_ROW_WIDTH);
 

package/src/functions/playerHealth.ts

@@ -5,14 +5,18 @@ import {
   PlayerType,
   TrinketType,
 } from "isaac-typescript-definitions";
-import { ACTIVE_SLOT_VALUES } from "../arrays/cachedEnumValues";
 import { MAX_PLAYER_HEART_CONTAINERS } from "../core/constants";
 import { HealthType } from "../enums/HealthType";
 import { PlayerHealth, SoulHeartType } from "../interfaces/PlayerHealth";
 import { countSetBits, getKBitOfN, getNumBitsOfN } from "./bitwise";
 import { getCharacterMaxHeartContainers } from "./characters";
 import { getTotalCharge } from "./charge";
-import { isCharacter, isKeeper, setActiveItem } from "./players";
+import {
+  getActiveItemSlots,
+  isCharacter,
+  isKeeper,
+  setActiveItem,
+} from "./players";
 import { repeat } from "./utils";
 
 export function addPlayerHealthType(
@@ -543,21 +547,24 @@ export function setPlayerHealth(
   const character = player.GetPlayerType();
   const subPlayer = player.GetSubPlayer();
 
-  removeAllPlayerHealth(player);
-
-  // Before we add any health, we have to take away Alabaster Box, if present.
-  const alabasterBoxes: Array<[slot: ActiveSlot, totalCharge: int]> = [];
-  if (player.HasCollectible(CollectibleType.ALABASTER_BOX)) {
-    for (const activeSlot of ACTIVE_SLOT_VALUES) {
-      const activeItem = player.GetActiveItem();
-      if (activeItem === CollectibleType.ALABASTER_BOX) {
-        const totalCharge = getTotalCharge(player, activeSlot);
-        setActiveItem(player, CollectibleType.NULL, activeSlot);
-        alabasterBoxes.push([activeSlot, totalCharge]);
-      }
-    }
+  // Before we add or remove any health, we have to take away Alabaster Box, if present. (Removing
+  // soul hearts from the player will remove Alabaster Box charges.)
+  const alabasterBoxDescriptions: Array<{
+    activeSlot: ActiveSlot;
+    totalCharge: int;
+  }> = [];
+  const alabasterBoxActiveSlots = getActiveItemSlots(
+    player,
+    CollectibleType.ALABASTER_BOX,
+  );
+  for (const activeSlot of alabasterBoxActiveSlots) {
+    const totalCharge = getTotalCharge(player, activeSlot);
+    setActiveItem(player, CollectibleType.NULL, activeSlot);
+    alabasterBoxDescriptions.push({ activeSlot, totalCharge });
   }
 
+  removeAllPlayerHealth(player);
+
   // Add the red heart containers.
   if (character === PlayerType.SOUL && subPlayer !== undefined) {
     // Adding health to The Soul is a special case.
@@ -649,7 +656,7 @@ export function setPlayerHealth(
   }
 
   // Re-add the Alabaster Box, if present.
-  for (const [activeSlot, totalCharge] of alabasterBoxes) {
+  for (const { activeSlot, totalCharge } of alabasterBoxDescriptions) {
     setActiveItem(
       player,
       CollectibleType.ALABASTER_BOX,

package/src/interfaces/StageHistoryEntry.ts

@@ -0,0 +1,7 @@
+import { LevelStage, StageType } from "isaac-typescript-definitions";
+
+/** This is used by the `StageHistory` feature. */
+export interface StageHistoryEntry {
+  readonly stage: LevelStage;
+  readonly stageType: StageType;
+}