isaacscript-common 9.15.0 → 9.17.0

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":"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"}
+{"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/minimap.d.ts

@@ -1,4 +1,14 @@
 import { DisplayFlag } from "isaac-typescript-definitions";
+/**
+ * Helper function to add a `DisplayFlag` to a particular room's minimap display flags (e.g. whether
+ * or not it is visible and so on).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param displayFlag The `DisplayFlag` to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export declare function addRoomDisplayFlag(roomGridIndex: int | undefined, displayFlag: DisplayFlag, updateVisibility?: boolean): void;
 /**
  * Helper function to set the value of `DisplayFlag` for every room on the floor to 0.
  *
@@ -33,11 +43,19 @@ export declare function setFloorDisplayFlags(displayFlagsMap: Map<int, BitFlags<
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
- * You must call the `Level.UpdateVisibility` method after using this function for the changes to
- * take effect.
- *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, displayFlags: BitFlags<DisplayFlag>, updateVisibility?: boolean): void;
+/**
+ * Helper function to make a single room visible in a similar way to how the Compass makes a Boss
+ * Room visible (e.g. by adding `DisplayFlag.SHOW_ICON`).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
  */
-export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, displayFlags: BitFlags<DisplayFlag>): void;
+export declare function setRoomVisible(roomGridIndex: int | undefined, updateVisibility?: boolean): void;
 //# sourceMappingURL=minimap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAK5E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,GAClB,QAAQ,CAAC,WAAW,CAAC,CAGvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAgBN;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAClC,IAAI,CAGN"}
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,8BAA8B,CAAC;AAM5E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,WAAW,EAAE,WAAW,EACxB,gBAAgB,UAAO,GACtB,IAAI,CAwBN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAS7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,GAClB,QAAQ,CAAC,WAAW,CAAC,CAGvB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAiBN;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EACnC,gBAAgB,UAAO,GACtB,IAAI,CAkBN;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,gBAAgB,UAAO,GACtB,IAAI,CAEN"}

package/dist/functions/minimap.lua

@@ -4,24 +4,72 @@ local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DisplayFlag = ____isaac_2Dtypescript_2Ddefinitions.DisplayFlag
 local DisplayFlagZero = ____isaac_2Dtypescript_2Ddefinitions.DisplayFlagZero
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
+local ____flag = require("functions.flag")
+local addFlag = ____flag.addFlag
 local ____roomData = require("functions.roomData")
 local getRoomDescriptor = ____roomData.getRoomDescriptor
+local getRoomGridIndex = ____roomData.getRoomGridIndex
 local ____rooms = require("functions.rooms")
 local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
 --- Helper function to set a particular room's minimap display flags (e.g. whether or not it is
 -- visible and so on).
 -- 
--- You must call the `Level.UpdateVisibility` method after using this function for the changes to
--- take effect.
--- 
 -- @param roomGridIndex Set to undefined to use the current room index.
 -- @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
-function ____exports.setRoomDisplayFlags(self, roomGridIndex, displayFlags)
-    local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
-    roomDescriptor.DisplayFlags = displayFlags
+-- @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+-- make the changes immediately visible. Default is true.
+function ____exports.setRoomDisplayFlags(self, roomGridIndex, displayFlags, updateVisibility)
+    if updateVisibility == nil then
+        updateVisibility = true
+    end
+    if MinimapAPI == nil then
+        local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
+        roomDescriptor.DisplayFlags = displayFlags
+    else
+        if roomGridIndex == nil then
+            roomGridIndex = getRoomGridIndex(nil)
+        end
+        local roomDescriptor = MinimapAPI:GetRoomByIdx(roomGridIndex)
+        if roomDescriptor ~= nil then
+            roomDescriptor.DisplayFlags = displayFlags
+        end
+    end
+    if updateVisibility then
+        local level = game:GetLevel()
+        level:UpdateVisibility()
+    end
+end
+--- Helper function to add a `DisplayFlag` to a particular room's minimap display flags (e.g. whether
+-- or not it is visible and so on).
+-- 
+-- @param roomGridIndex Set to undefined to use the current room index.
+-- @param displayFlag The `DisplayFlag` to set. (See the `DisplayFlag` enum.)
+-- @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+-- make the changes immediately visible. Default is true.
+function ____exports.addRoomDisplayFlag(self, roomGridIndex, displayFlag, updateVisibility)
+    if updateVisibility == nil then
+        updateVisibility = true
+    end
+    if MinimapAPI == nil then
+        local roomDescriptor = getRoomDescriptor(nil, roomGridIndex)
+        roomDescriptor.DisplayFlags = addFlag(nil, roomDescriptor.DisplayFlags, displayFlag)
+    else
+        if roomGridIndex == nil then
+            roomGridIndex = getRoomGridIndex(nil)
+        end
+        local roomDescriptor = MinimapAPI:GetRoomByIdx(roomGridIndex)
+        if roomDescriptor ~= nil then
+            roomDescriptor.DisplayFlags = addFlag(nil, roomDescriptor.DisplayFlags, displayFlag)
+        end
+    end
+    if updateVisibility then
+        local level = game:GetLevel()
+        level:UpdateVisibility()
+    end
 end
 --- Helper function to set the value of `DisplayFlag` for every room on the floor to 0.
 -- 
@@ -64,7 +112,7 @@ function ____exports.setDisplayFlags(self, displayFlagsMap)
         local roomGridIndex = ____value[1]
         local displayFlags = ____value[2]
         if MinimapAPI == nil then
-            ____exports.setRoomDisplayFlags(nil, roomGridIndex, displayFlags)
+            ____exports.setRoomDisplayFlags(nil, roomGridIndex, displayFlags, false)
         else
             local roomDescriptor = MinimapAPI:GetRoomByIdx(roomGridIndex)
             if roomDescriptor ~= nil then
@@ -78,4 +126,16 @@ end
 function ____exports.setFloorDisplayFlags(self, displayFlagsMap)
     ____exports.setDisplayFlags(nil, displayFlagsMap)
 end
+--- Helper function to make a single room visible in a similar way to how the Compass makes a Boss
+-- Room visible (e.g. by adding `DisplayFlag.SHOW_ICON`).
+-- 
+-- @param roomGridIndex Set to undefined to use the current room index.
+-- @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+-- make the changes immediately visible. Default is true.
+function ____exports.setRoomVisible(self, roomGridIndex, updateVisibility)
+    if updateVisibility == nil then
+        updateVisibility = true
+    end
+    ____exports.addRoomDisplayFlag(nil, roomGridIndex, DisplayFlag.SHOW_ICON, updateVisibility)
+end
 return ____exports

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

@@ -287,6 +287,17 @@ export declare function addRoomClearCharges(bigRoomDoubleCharge?: boolean): void
  */
 export declare function addRoomClearChargeToSlot(player: EntityPlayer, activeSlot: ActiveSlot, bigRoomDoubleCharge?: boolean, playSoundEffect?: boolean): void;
 
+/**
+ * Helper function to add a `DisplayFlag` to a particular room's minimap display flags (e.g. whether
+ * or not it is visible and so on).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param displayFlag The `DisplayFlag` to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export declare function addRoomDisplayFlag(roomGridIndex: int | undefined, displayFlag: DisplayFlag, updateVisibility?: boolean): void;
+
 /**
  * Helper function to add all of the values in one set to another set. The first set passed will be
  * modified in place.
@@ -596,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.
  *
@@ -3656,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.
@@ -3667,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,
@@ -10728,13 +10750,12 @@ export declare function setRoomData(roomGridIndex: int, roomData: Readonly<RoomC
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
- * You must call the `Level.UpdateVisibility` method after using this function for the changes to
- * take effect.
- *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
  */
-export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, displayFlags: BitFlags<DisplayFlag>): void;
+export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, displayFlags: BitFlags<DisplayFlag>, updateVisibility?: boolean): void;
 
 /**
  * Helper function to emulate what happens when you bomb an Angel Statue or push a Reward Plate that
@@ -10742,6 +10763,16 @@ export declare function setRoomDisplayFlags(roomGridIndex: int | undefined, disp
  */
 export declare function setRoomUncleared(): void;
 
+/**
+ * Helper function to make a single room visible in a similar way to how the Compass makes a Boss
+ * Room visible (e.g. by adding `DisplayFlag.SHOW_ICON`).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export declare function setRoomVisible(roomGridIndex: int | undefined, updateVisibility?: boolean): void;
+
 /** Helper function to set a seed to an RNG object using Blade's recommended shift index. */
 export declare function setSeed(rng: RNG, seed: Seed): void;
 

package/package.json

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

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/minimap.ts

@@ -1,8 +1,48 @@
 import { DisplayFlag, DisplayFlagZero } from "isaac-typescript-definitions";
 import { game } from "../core/cachedClasses";
-import { getRoomDescriptor } from "./roomData";
+import { addFlag } from "./flag";
+import { getRoomDescriptor, getRoomGridIndex } from "./roomData";
 import { getRoomsInsideGrid } from "./rooms";
 
+/**
+ * Helper function to add a `DisplayFlag` to a particular room's minimap display flags (e.g. whether
+ * or not it is visible and so on).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param displayFlag The `DisplayFlag` to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export function addRoomDisplayFlag(
+  roomGridIndex: int | undefined,
+  displayFlag: DisplayFlag,
+  updateVisibility = true,
+): void {
+  if (MinimapAPI === undefined) {
+    const roomDescriptor = getRoomDescriptor(roomGridIndex);
+    roomDescriptor.DisplayFlags = addFlag(
+      roomDescriptor.DisplayFlags,
+      displayFlag,
+    );
+  } else {
+    if (roomGridIndex === undefined) {
+      roomGridIndex = getRoomGridIndex();
+    }
+    const roomDescriptor = MinimapAPI.GetRoomByIdx(roomGridIndex);
+    if (roomDescriptor !== undefined) {
+      roomDescriptor.DisplayFlags = addFlag(
+        roomDescriptor.DisplayFlags,
+        displayFlag,
+      );
+    }
+  }
+
+  if (updateVisibility) {
+    const level = game.GetLevel();
+    level.UpdateVisibility();
+  }
+}
+
 /**
  * Helper function to set the value of `DisplayFlag` for every room on the floor to 0.
  *
@@ -66,7 +106,8 @@ export function setDisplayFlags(
 
   for (const [roomGridIndex, displayFlags] of displayFlagsMap.entries()) {
     if (MinimapAPI === undefined) {
-      setRoomDisplayFlags(roomGridIndex, displayFlags);
+      // We pass false to the `updateVisibility` argument as a small optimization.
+      setRoomDisplayFlags(roomGridIndex, displayFlags, false);
     } else {
       const roomDescriptor = MinimapAPI.GetRoomByIdx(roomGridIndex);
       if (roomDescriptor !== undefined) {
@@ -90,16 +131,46 @@ export function setFloorDisplayFlags(
  * Helper function to set a particular room's minimap display flags (e.g. whether or not it is
  * visible and so on).
  *
- * You must call the `Level.UpdateVisibility` method after using this function for the changes to
- * take effect.
- *
  * @param roomGridIndex Set to undefined to use the current room index.
  * @param displayFlags The bit flags value to set. (See the `DisplayFlag` enum.)
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
  */
 export function setRoomDisplayFlags(
   roomGridIndex: int | undefined,
   displayFlags: BitFlags<DisplayFlag>,
+  updateVisibility = true,
 ): void {
-  const roomDescriptor = getRoomDescriptor(roomGridIndex);
-  roomDescriptor.DisplayFlags = displayFlags;
+  if (MinimapAPI === undefined) {
+    const roomDescriptor = getRoomDescriptor(roomGridIndex);
+    roomDescriptor.DisplayFlags = displayFlags;
+  } else {
+    if (roomGridIndex === undefined) {
+      roomGridIndex = getRoomGridIndex();
+    }
+    const roomDescriptor = MinimapAPI.GetRoomByIdx(roomGridIndex);
+    if (roomDescriptor !== undefined) {
+      roomDescriptor.DisplayFlags = displayFlags;
+    }
+  }
+
+  if (updateVisibility) {
+    const level = game.GetLevel();
+    level.UpdateVisibility();
+  }
+}
+
+/**
+ * Helper function to make a single room visible in a similar way to how the Compass makes a Boss
+ * Room visible (e.g. by adding `DisplayFlag.SHOW_ICON`).
+ *
+ * @param roomGridIndex Set to undefined to use the current room index.
+ * @param updateVisibility Optional. Whether to call the `Level.UpdateVisibility` method in order to
+ *                         make the changes immediately visible. Default is true.
+ */
+export function setRoomVisible(
+  roomGridIndex: int | undefined,
+  updateVisibility = true,
+): void {
+  addRoomDisplayFlag(roomGridIndex, DisplayFlag.SHOW_ICON, updateVisibility);
 }

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.
  *