isaacscript-common 9.16.0 → 9.17.1

package/dist/callbacks/subscriptions/postPurchase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postPurchase.d.ts","sourceRoot":"","sources":["../../../src/callbacks/subscriptions/postPurchase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,oBAAY,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI;IAC9D,aAAa,CAAC,EAAE,aAAa;IAC7B,aAAa,CAAC,EAAE,GAAG;CACpB,CAAC;AAIF,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,oBAAoB,CAClC,GAAG,IAAI,EAAE,8BAA8B,GACtC,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,IAAI,CAIN"}
+{"version":3,"file":"postPurchase.d.ts","sourceRoot":"","sources":["../../../src/callbacks/subscriptions/postPurchase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,oBAAY,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI;IAC9D,aAAa,CAAC,EAAE,aAAa;IAC7B,aAAa,CAAC,EAAE,GAAG;CACpB,CAAC;AAIF,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,oBAAoB,CAClC,GAAG,IAAI,EAAE,8BAA8B,GACtC,IAAI,CAEN;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,IAAI,CAwBN"}

package/dist/callbacks/subscriptions/postPurchase.lua

@@ -10,7 +10,18 @@ end
 function ____exports.postPurchaseFire(self, player, pickup)
     for ____, ____value in ipairs(subscriptions) do
         local callback = ____value[1]
-        callback(nil, player, pickup)
+        local callbackPickupVariant = ____value[2]
+        local callbackPickupSubType = ____value[3]
+        do
+            if callbackPickupVariant ~= nil and callbackPickupVariant ~= pickup.Variant then
+                goto __continue5
+            end
+            if callbackPickupSubType ~= nil and callbackPickupSubType ~= pickup.SubType then
+                goto __continue5
+            end
+            callback(nil, player, pickup)
+        end
+        ::__continue5::
     end
 end
 return ____exports

package/dist/functions/levelGrid.d.ts

@@ -53,7 +53,8 @@ export declare function getAllRoomGridIndexes(): int[];
 export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRoomGridIndex: int, doorSlot: DoorSlot, 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.
+ * a valid spot to insert a brand new room on the floor. (Any potential new rooms cannot be
+ * connected to any other existing rooms on the floor.)
  *
  * @param roomGridIndex Optional. Default is the current room index.
  * @returns A array of tuples of `DoorSlot` and room grid index.
@@ -63,7 +64,8 @@ export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Arr
  * Helper function to search through all of the rooms on the floor for a spot to insert a brand new
  * room.
  *
- * @returns A array of tuples of adjacent room grid index, `DoorSlot`, and new room grid index.
+ * @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,

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

@@ -1 +1 @@
-{"version":3,"file":"levelGrid.d.ts","sourceRoot":"","sources":["../../src/functions/levelGrid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,QAAQ,EAKR,SAAS,EACT,QAAQ,EACT,MAAM,8BAA8B,CAAC;AA8BtC;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAK7E;AAED;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,aAAa,CAAC,EAAE,GAAG,GAClB,GAAG,EAAE,CAKP;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAerE;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,IAAI,GAAG,EAAE,CAG7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,IAAI,GAAG,GAAqB,GAErC,CAAC,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,CAAC,GACvE,SAAS,CAOZ;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,CAAC,EAAE,GAAG,GAClB,KAAK,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,CA0CjD;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,KAAK,CACnD;IAAC,qBAAqB,EAAE,GAAG;IAAE,QAAQ,EAAE,QAAQ;IAAE,gBAAgB,EAAE,GAAG;CAAC,CACxE,CAsBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,CAAC,EAAE,GAAG,GAClB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAgBpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,GAAG,EAAE,CAWzE;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,iBAAiB,EAAE,GAAG,EACtB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAiBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAEpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,iBAAiB,EAAE,GAAG,EACtB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAapB;AAED;;;;;;GAMG;AACH,wBAAgB,0CAA0C,CACxD,iBAAiB,EAAE,GAAG,EACtB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAiBpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO,CAKtD;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,GAAG,GACjB,OAAO,CAGT;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,GAAG,GACjB,OAAO,CAqBT;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO,CAM7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CAmD/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,GAAG,GAAG,OAAO,CAGtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAKtE"}
+{"version":3,"file":"levelGrid.d.ts","sourceRoot":"","sources":["../../src/functions/levelGrid.ts"],"names":[],"mappings":"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"}

package/dist/functions/levelGrid.lua

@@ -47,16 +47,15 @@ local ____roomShape = require("functions.roomShape")
 local getGridIndexDelta = ____roomShape.getGridIndexDelta
 local ____types = require("functions.types")
 local asNumber = ____types.asNumber
---- Helper function to get only the adjacent room grid indexes that do not exist (i.e. do not have
--- room data).
+--- Helper function to get only the adjacent room grid indexes that exist (i.e. have room data).
 -- 
 -- This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
 -- that function for more information.
-function ____exports.getAdjacentNonExistingRoomGridIndexes(self, roomGridIndex)
+function ____exports.getAdjacentExistingRoomGridIndexes(self, roomGridIndex)
     local adjacentRoomGridIndexes = ____exports.getAdjacentRoomGridIndexes(nil, roomGridIndex)
     return __TS__ArrayFilter(
         adjacentRoomGridIndexes,
-        function(____, adjacentRoomGridIndex) return getRoomData(nil, adjacentRoomGridIndex) == nil end
+        function(____, adjacentRoomGridIndex) return getRoomData(nil, adjacentRoomGridIndex) ~= nil end
     )
 end
 --- Helper function to get all of the room grid indexes that are adjacent to a given room grid index
@@ -87,7 +86,8 @@ function ____exports.getAdjacentRoomGridIndexes(self, roomGridIndex)
     )
 end
 --- 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.
+-- a valid spot to insert a brand new room on the floor. (Any potential new rooms cannot be
+-- connected to any other existing rooms on the floor.)
 -- 
 -- @param roomGridIndex Optional. Default is the current room index.
 -- @returns A array of tuples of `DoorSlot` and room grid index.
@@ -122,7 +122,8 @@ end
 --- Helper function to search through all of the rooms on the floor for a spot to insert a brand new
 -- room.
 -- 
--- @returns A array of tuples of adjacent room grid index, `DoorSlot`, and new room grid index.
+-- @returns A array of tuples containing the adjacent room grid index, the `DoorSlot`, and the new
+-- room grid index.
 function ____exports.getNewRoomCandidatesForLevel(self)
     local rooms = getRoomsInsideGrid(nil)
     local normalRooms = __TS__ArrayFilter(
@@ -214,8 +215,8 @@ end
 -- 
 -- @param roomGridIndex Optional. Default is the current room index.
 function ____exports.isDeadEnd(self, roomGridIndex)
-    local adjacentNonExistingRoomGridIndexes = ____exports.getAdjacentNonExistingRoomGridIndexes(nil, roomGridIndex)
-    return #adjacentNonExistingRoomGridIndexes == 1
+    local adjacentExistingRoomGridIndexes = ____exports.getAdjacentExistingRoomGridIndexes(nil, roomGridIndex)
+    return #adjacentExistingRoomGridIndexes == 1
 end
 --- Helper function to determine if a given room grid index is inside of the normal 13x13 level grid.
 -- 
@@ -239,15 +240,16 @@ local UP = -LEVEL_GRID_ROW_WIDTH
 local RIGHT = 1
 local DOWN = LEVEL_GRID_ROW_WIDTH
 ADJACENT_ROOM_GRID_INDEX_DELTAS = {LEFT, UP, RIGHT, DOWN}
---- Helper function to get only the adjacent room grid indexes that exist (i.e. have room data).
+--- Helper function to get only the adjacent room grid indexes that do not exist (i.e. do not have
+-- room data).
 -- 
 -- This is just a filtering of the results of the `getAdjacentExistingRoomGridIndexes` function. See
 -- that function for more information.
-function ____exports.getAdjacentExistingRoomGridIndexes(self, roomGridIndex)
+function ____exports.getAdjacentNonExistingRoomGridIndexes(self, roomGridIndex)
     local adjacentRoomGridIndexes = ____exports.getAdjacentRoomGridIndexes(nil, roomGridIndex)
     return __TS__ArrayFilter(
         adjacentRoomGridIndexes,
-        function(____, adjacentRoomGridIndex) return getRoomData(nil, adjacentRoomGridIndex) ~= nil end
+        function(____, adjacentRoomGridIndex) return getRoomData(nil, adjacentRoomGridIndex) == nil end
     )
 end
 --- Helper function to get the room safe grid index for every room on the entire floor.

package/dist/functions/playerHealth.d.ts

@@ -3,6 +3,14 @@
 import { HealthType } from "../enums/HealthType";
 import { PlayerHealth } from "../interfaces/PlayerHealth";
 export declare function addPlayerHealthType(player: EntityPlayer, healthType: HealthType, numHearts: int): void;
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export declare function canPickEternalHearts(player: EntityPlayer): boolean;
 /**
  * Returns whether or not all of the player's soul-heart-type hearts are black hearts.
  *

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

@@ -1 +1 @@
-{"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;AAQzE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,GAAG,GACb,IAAI,CA+CN;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;AAQzE,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"}

package/dist/functions/playerHealth.lua

@@ -135,25 +135,25 @@ function ____exports.setPlayerHealth(self, player, playerHealth)
                 addAmount = 1
             end
             repeat
-                local ____switch71 = soulHeartType
-                local ____cond71 = ____switch71 == HeartSubType.SOUL
-                if ____cond71 then
+                local ____switch72 = soulHeartType
+                local ____cond72 = ____switch72 == HeartSubType.SOUL
+                if ____cond72 then
                     do
                         player:AddSoulHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond71 = ____cond71 or ____switch71 == HeartSubType.BLACK
-                if ____cond71 then
+                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BLACK
+                if ____cond72 then
                     do
                         player:AddBlackHearts(addAmount)
                         soulHeartsRemaining = soulHeartsRemaining - addAmount
                         break
                     end
                 end
-                ____cond71 = ____cond71 or ____switch71 == HeartSubType.BONE
-                if ____cond71 then
+                ____cond72 = ____cond72 or ____switch72 == HeartSubType.BONE
+                if ____cond72 then
                     do
                         player:AddBoneHearts(addAmount)
                         break
@@ -271,6 +271,17 @@ function ____exports.addPlayerHealthType(self, player, healthType, numHearts)
         end
     until true
 end
+--- Helper function to see if the provided player can pick up an eternal heart. (If a player already
+-- has an eternal heart and full heart containers, they are not able to pick up any additional
+-- eternal hearts.)
+-- 
+-- This function's name matches the existing `EntityPlayer` methods.
+function ____exports.canPickEternalHearts(self, player)
+    local eternalHearts = player:GetEternalHearts()
+    local maxHearts = player:GetMaxHearts()
+    local heartLimit = player:GetHeartLimit()
+    return eternalHearts == 0 or maxHearts ~= heartLimit
+end
 --- Returns whether or not all of the player's soul-heart-type hearts are black hearts.
 -- 
 -- Note that this function does not consider red heart containers.
@@ -385,57 +396,57 @@ function ____exports.getPlayerHealth(self, player)
 end
 function ____exports.getPlayerHealthType(self, player, healthType)
     repeat
-        local ____switch28 = healthType
-        local ____cond28 = ____switch28 == HealthType.RED
-        if ____cond28 then
+        local ____switch29 = healthType
+        local ____cond29 = ____switch29 == HealthType.RED
+        if ____cond29 then
             do
                 return ____exports.getPlayerHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.SOUL
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.SOUL
+        if ____cond29 then
             do
                 return ____exports.getPlayerSoulHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.ETERNAL
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.ETERNAL
+        if ____cond29 then
             do
                 return player:GetEternalHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BLACK
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BLACK
+        if ____cond29 then
             do
                 return ____exports.getPlayerBlackHearts(nil, player)
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.GOLDEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.GOLDEN
+        if ____cond29 then
             do
                 return player:GetGoldenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BONE
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BONE
+        if ____cond29 then
             do
                 return player:GetBoneHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.ROTTEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.ROTTEN
+        if ____cond29 then
             do
                 return player:GetRottenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.BROKEN
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.BROKEN
+        if ____cond29 then
             do
                 return player:GetBrokenHearts()
             end
         end
-        ____cond28 = ____cond28 or ____switch28 == HealthType.MAX_HEARTS
-        if ____cond28 then
+        ____cond29 = ____cond29 or ____switch29 == HealthType.MAX_HEARTS
+        if ____cond29 then
             do
                 return player:GetMaxHearts()
             end

package/dist/index.d.ts

@@ -607,6 +607,15 @@ export declare function calculateStageType(stage: LevelStage): StageType;
  */
 export declare function calculateStageTypeRepentance(stage: LevelStage): StageType;
 
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export declare function canPickEternalHearts(player: EntityPlayer): boolean;
+
 /**
  * Helper function to determine if a player will destroy a rock/pot/skull if they walk over it.
  *
@@ -3667,7 +3676,8 @@ export declare function getNewRoomCandidate(seedOrRNG?: Seed | RNG): [adjacentRo
 
 /**
  * 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.
+ * a valid spot to insert a brand new room on the floor. (Any potential new rooms cannot be
+ * connected to any other existing rooms on the floor.)
  *
  * @param roomGridIndex Optional. Default is the current room index.
  * @returns A array of tuples of `DoorSlot` and room grid index.
@@ -3678,7 +3688,8 @@ export declare function getNewRoomCandidatesBesideRoom(roomGridIndex?: int): Arr
  * Helper function to search through all of the rooms on the floor for a spot to insert a brand new
  * room.
  *
- * @returns A array of tuples of adjacent room grid index, `DoorSlot`, and new room grid index.
+ * @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,

package/package.json

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

package/src/callbacks/subscriptions/postPurchase.ts

@@ -22,7 +22,27 @@ export function postPurchaseFire(
   player: EntityPlayer,
   pickup: EntityPickup,
 ): void {
-  for (const [callback] of subscriptions) {
+  for (const [
+    callback,
+    callbackPickupVariant,
+    callbackPickupSubType,
+  ] of subscriptions) {
+    // Handle the optional 2nd callback argument.
+    if (
+      callbackPickupVariant !== undefined &&
+      callbackPickupVariant !== pickup.Variant
+    ) {
+      continue;
+    }
+
+    // Handle the optional 3rd callback argument.
+    if (
+      callbackPickupSubType !== undefined &&
+      callbackPickupSubType !== pickup.SubType
+    ) {
+      continue;
+    }
+
     callback(player, pickup);
   }
 }

package/src/functions/levelGrid.ts

@@ -138,7 +138,8 @@ export function getNewRoomCandidate(
 
 /**
  * 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.
+ * a valid spot to insert a brand new room on the floor. (Any potential new rooms cannot be
+ * connected to any other existing rooms on the floor.)
  *
  * @param roomGridIndex Optional. Default is the current room index.
  * @returns A array of tuples of `DoorSlot` and room grid index.
@@ -148,10 +149,14 @@ export function getNewRoomCandidatesBesideRoom(
 ): Array<[doorSlot: DoorSlot, roomGridIndex: int]> {
   const roomDescriptor = getRoomDescriptor(roomGridIndex);
 
+  // First, handle the case of rooms outside of the grid, which obviously cannot have any possible
+  // adjacent new room candidates.
   if (!isRoomInsideGrid(roomDescriptor.SafeGridIndex)) {
     return [];
   }
 
+  // Rooms without data are non-existent, so they obviously cannot have any possible adjacent new
+  // room candidates.
   const roomData = roomDescriptor.Data;
   if (roomData === undefined) {
     return [];
@@ -193,16 +198,22 @@ export function getNewRoomCandidatesBesideRoom(
  * Helper function to search through all of the rooms on the floor for a spot to insert a brand new
  * room.
  *
- * @returns A array of tuples of adjacent room grid index, `DoorSlot`, and new room grid index.
+ * @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]
 > {
+  // We want to iterate over every room on the floor and search for potential new room spots.
   const rooms = getRoomsInsideGrid();
+
+  // However, we want to filter out special rooms because they are supposed to be dead ends.
   const normalRooms = rooms.filter(
     (room) =>
       room.Data !== undefined &&
       room.Data.Type === RoomType.DEFAULT &&
+      // The mirror room and the mineshaft entrance count as normal rooms, but those are supposed to
+      // be dead ends as well.
       room.Data.Subtype !== asNumber(DownpourRoomSubType.MIRROR) &&
       room.Data.Subtype !== asNumber(MinesRoomSubType.MINESHAFT_ENTRANCE),
   );
@@ -385,10 +396,10 @@ export function getRoomShapeAdjacentNonExistingGridIndexes(
  * @param roomGridIndex Optional. Default is the current room index.
  */
 export function isDeadEnd(roomGridIndex?: int): boolean {
-  const adjacentNonExistingRoomGridIndexes =
-    getAdjacentNonExistingRoomGridIndexes(roomGridIndex);
+  const adjacentExistingRoomGridIndexes =
+    getAdjacentExistingRoomGridIndexes(roomGridIndex);
 
-  return adjacentNonExistingRoomGridIndexes.length === 1;
+  return adjacentExistingRoomGridIndexes.length === 1;
 }
 
 export function isDoorSlotValidAtGridIndex(

package/src/functions/playerHealth.ts

@@ -68,6 +68,21 @@ export function addPlayerHealthType(
   }
 }
 
+/**
+ * Helper function to see if the provided player can pick up an eternal heart. (If a player already
+ * has an eternal heart and full heart containers, they are not able to pick up any additional
+ * eternal hearts.)
+ *
+ * This function's name matches the existing `EntityPlayer` methods.
+ */
+export function canPickEternalHearts(player: EntityPlayer): boolean {
+  const eternalHearts = player.GetEternalHearts();
+  const maxHearts = player.GetMaxHearts();
+  const heartLimit = player.GetHeartLimit();
+
+  return eternalHearts === 0 || maxHearts !== heartLimit;
+}
+
 /**
  * Returns whether or not all of the player's soul-heart-type hearts are black hearts.
  *