isaacscript-common 33.9.3 → 33.11.0

package/dist/index.rollup.d.ts

@@ -6670,13 +6670,12 @@ export declare function getRoomDescriptorsForType(...roomTypes: RoomType[]): Roo
 export declare function getRoomDisplayFlags(roomGridIndex?: int, minimapAPI?: boolean): BitFlags<DisplayFlag>;
 
 /**
- * Helper function to get the grid index of the current room.
+ * Helper function to get the safe grid index of the current room. (The safe grid index is defined
+ * as the top-left 1x1 section that the room overlaps with, or the top-right 1x1 section of a
+ * `RoomType.SHAPE_LTL` room.)
  *
- * - If the current room is inside of the grid, this function will return the `SafeGridIndex` from
- *   the room descriptor. (The safe grid index is defined as the top-left 1x1 section that the room
- *   overlaps with, or the top-right 1x1 section of a `RoomType.SHAPE_LTL` room.)
- * - If the current room is outside of the grid, it will return the index from the
- *   `Level.GetCurrentRoomIndex` method (since `SafeGridIndex` is bugged for these cases).
+ * Under the hood, this function uses the `Level.GetCurrentRoomDesc` method. (In Afterbirth+, this
+ * method was bugged for rooms outside of the grid, but it is now fixed.)
  *
  * Use this function instead of the `Level.GetCurrentRoomIndex` method directly because the latter
  * will return the specific 1x1 quadrant that the player entered the room at. For most situations,
@@ -8601,6 +8600,15 @@ export declare function isMinibossRoomOf(roomData: RoomConfig, minibossID: Minib
  */
 export declare function isMirrorRoom(roomData: RoomConfig): boolean;
 
+/**
+ * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
+ * ground, a wall, or a grid entity.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
+ * die if they hit an enemy, but they will die if they hit a wall or object.)
+ */
+export declare function isMissedTear(tear: EntityTear): boolean;
+
 /** Returns true for any card or rune added by a mod. */
 export declare function isModdedCardType(cardType: CardType): boolean;
 
@@ -8822,10 +8830,10 @@ export declare function isRoomType(roomData: RoomConfig, ...roomTypes: RoomType[
 /**
  * Helper function to check if a given room is visible on the minimap.
  *
- * @param roomGridIndex The room to check.
+ * @param roomGridIndexOrRoomDescriptor The room to check.
  * @param minimapAPI Optional. Whether MinimapAPI should be used, if present. Default is true.
  */
-export declare function isRoomVisible(roomGridIndex: int, minimapAPI?: boolean): boolean;
+export declare function isRoomVisible(roomGridIndexOrRoomDescriptor: int | RoomDescriptor, minimapAPI?: boolean): boolean;
 
 /** Returns true for cards that have `CardType.RUNE`. */
 export declare function isRune(cardType: CardType): boolean;

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 33.9.3
+isaacscript-common 33.11.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -20710,7 +20710,7 @@ ____exports.COLLECTIBLE_TYPE_TO_NAME_MAP = __TS__New(ReadonlyMap, {
     {653, "Vade Retro"},
     {654, "False PHD"},
     {655, "Spin to Win"},
-    {656, "Damocles"},
+    {656, "Damocles (Passive)"},
     {657, "Vasculitis"},
     {658, "Giant Cell"},
     {659, "Tropicamide"},
@@ -26764,11 +26764,6 @@ function ____exports.getRoomDescriptorReadOnly(self)
     return level:GetCurrentRoomDesc()
 end
 function ____exports.getRoomGridIndex(self)
-    local level = game:GetLevel()
-    local currentRoomIndex = level:GetCurrentRoomIndex()
-    if currentRoomIndex < 0 then
-        return currentRoomIndex
-    end
     local roomDescriptor = ____exports.getRoomDescriptorReadOnly(nil)
     return roomDescriptor.SafeGridIndex
 end
@@ -30876,6 +30871,9 @@ function ____exports.addTearsStat(self, player, tearsStat)
     local newMaxFireDelay = ____exports.getFireDelay(nil, newTearsStat)
     player.MaxFireDelay = newMaxFireDelay
 end
+function ____exports.isMissedTear(self, tear)
+    return tear:IsDead()
+end
 function ____exports.isTearFromFamiliar(self, tear, familiarVariant, subType)
     if tear.FrameCount == 0 then
         error("Failed to check if the given tear was from a player since the tear's frame count was equal to 0. (The \"isTearFromFamiliar\" function must only be used in the \"POST_TEAR_INIT_VERY_LATE\" callback or on frame 1 and onwards.)")
@@ -53786,6 +53784,8 @@ local getRoomDescriptor = ____roomData.getRoomDescriptor
 local getRoomGridIndex = ____roomData.getRoomGridIndex
 local ____rooms = require("src.functions.rooms")
 local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
+local ____types = require("src.functions.types")
+local isNumber = ____types.isNumber
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
 function ____exports.getRoomDisplayFlags(self, roomGridIndex, minimapAPI)
@@ -53878,10 +53878,11 @@ function ____exports.hideRoomOnMinimap(self, roomGridIndex)
         minimapAPIRoomDescriptor.Hidden = true
     end
 end
-function ____exports.isRoomVisible(self, roomGridIndex, minimapAPI)
+function ____exports.isRoomVisible(self, roomGridIndexOrRoomDescriptor, minimapAPI)
     if minimapAPI == nil then
         minimapAPI = true
     end
+    local roomGridIndex = isNumber(nil, roomGridIndexOrRoomDescriptor) and roomGridIndexOrRoomDescriptor or roomGridIndexOrRoomDescriptor.SafeGridIndex
     local roomDisplayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex, minimapAPI)
     return roomDisplayFlags ~= DisplayFlagZero
 end

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

@@ -65,10 +65,10 @@ export declare function hideRoomOnMinimap(roomGridIndex: int): void;
 /**
  * Helper function to check if a given room is visible on the minimap.
  *
- * @param roomGridIndex The room to check.
+ * @param roomGridIndexOrRoomDescriptor The room to check.
  * @param minimapAPI Optional. Whether MinimapAPI should be used, if present. Default is true.
  */
-export declare function isRoomVisible(roomGridIndex: int, minimapAPI?: boolean): boolean;
+export declare function isRoomVisible(roomGridIndexOrRoomDescriptor: int | RoomDescriptor, minimapAPI?: boolean): boolean;
 /**
  * Helper function to set the minimap `DisplayFlag` value for every room on the floor at once.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAQhE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,WAAW,EAAE,WAAW,EACxB,gBAAgB,UAAO,GACtB,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,UAAO,GAChB,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAUjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,EACnB,UAAU,UAAO,GAChB,QAAQ,CAAC,WAAW,CAAC,CAiBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAe1D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,GAAG,EAAE,UAAU,UAAO,GAAG,OAAO,CAG5E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAW5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EACnC,gBAAgB,UAAO,GACtB,IAAI,CAsBN"}
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../../../src/functions/minimap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAShE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,WAAW,EAAE,WAAW,EACxB,gBAAgB,UAAO,GACtB,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,UAAO,GAChB,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAUjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,CAAC,EAAE,GAAG,EACnB,UAAU,UAAO,GAChB,QAAQ,CAAC,WAAW,CAAC,CAiBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAe1D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,6BAA6B,EAAE,GAAG,GAAG,cAAc,EACnD,UAAU,UAAO,GAChB,OAAO,CAOT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAW5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAC/C,IAAI,CAWN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,GAAG,GAAG,SAAS,EAC9B,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,EACnC,gBAAgB,UAAO,GACtB,IAAI,CAsBN"}

package/dist/src/functions/minimap.lua

@@ -14,6 +14,8 @@ local getRoomDescriptor = ____roomData.getRoomDescriptor
 local getRoomGridIndex = ____roomData.getRoomGridIndex
 local ____rooms = require("src.functions.rooms")
 local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
+local ____types = require("src.functions.types")
+local isNumber = ____types.isNumber
 local ____utils = require("src.functions.utils")
 local assertDefined = ____utils.assertDefined
 --- Helper function to get a particular room's minimap display flags (e.g. whether it is visible and
@@ -170,12 +172,13 @@ function ____exports.hideRoomOnMinimap(self, roomGridIndex)
 end
 --- Helper function to check if a given room is visible on the minimap.
 -- 
--- @param roomGridIndex The room to check.
+-- @param roomGridIndexOrRoomDescriptor The room to check.
 -- @param minimapAPI Optional. Whether MinimapAPI should be used, if present. Default is true.
-function ____exports.isRoomVisible(self, roomGridIndex, minimapAPI)
+function ____exports.isRoomVisible(self, roomGridIndexOrRoomDescriptor, minimapAPI)
     if minimapAPI == nil then
         minimapAPI = true
     end
+    local roomGridIndex = isNumber(nil, roomGridIndexOrRoomDescriptor) and roomGridIndexOrRoomDescriptor or roomGridIndexOrRoomDescriptor.SafeGridIndex
     local roomDisplayFlags = ____exports.getRoomDisplayFlags(nil, roomGridIndex, minimapAPI)
     return roomDisplayFlags ~= DisplayFlagZero
 end

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

@@ -18,13 +18,12 @@ export declare function getRoomDescriptor(roomGridIndex?: int): RoomDescriptor;
  */
 export declare function getRoomDescriptorReadOnly(): Readonly<RoomDescriptor>;
 /**
- * Helper function to get the grid index of the current room.
+ * Helper function to get the safe grid index of the current room. (The safe grid index is defined
+ * as the top-left 1x1 section that the room overlaps with, or the top-right 1x1 section of a
+ * `RoomType.SHAPE_LTL` room.)
  *
- * - If the current room is inside of the grid, this function will return the `SafeGridIndex` from
- *   the room descriptor. (The safe grid index is defined as the top-left 1x1 section that the room
- *   overlaps with, or the top-right 1x1 section of a `RoomType.SHAPE_LTL` room.)
- * - If the current room is outside of the grid, it will return the index from the
- *   `Level.GetCurrentRoomIndex` method (since `SafeGridIndex` is bugged for these cases).
+ * Under the hood, this function uses the `Level.GetCurrentRoomDesc` method. (In Afterbirth+, this
+ * method was bugged for rooms outside of the grid, but it is now fixed.)
  *
  * Use this function instead of the `Level.GetCurrentRoomIndex` method directly because the latter
  * will return the specific 1x1 quadrant that the player entered the room at. For most situations,

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

@@ -1 +1 @@
-{"version":3,"file":"roomData.d.ts","sourceRoot":"","sources":["../../../src/functions/roomData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACR,MAAM,8BAA8B,CAAC;AAMtC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAgBtE;AAGD,wBAAgB,WAAW,IAAI,UAAU,CAAC;AAC1C,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,UAAU,GAAG,SAAS,CAAC;AAYzE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAQrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,QAAQ,CAAC,cAAc,CAAC,CAGpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAatC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,SAAS,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,QAAQ,GAAG,CAAC,CAAC,CAG9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGvD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAG5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAG1E"}
+{"version":3,"file":"roomData.d.ts","sourceRoot":"","sources":["../../../src/functions/roomData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACR,MAAM,8BAA8B,CAAC;AAMtC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAgBtE;AAGD,wBAAgB,WAAW,IAAI,UAAU,CAAC;AAC1C,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,UAAU,GAAG,SAAS,CAAC;AAYzE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,cAAc,CAQrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,QAAQ,CAAC,cAAc,CAAC,CAGpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAGtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,MAAM,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,SAAS,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,QAAQ,GAAG,CAAC,CAAC,CAG9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAGvD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAG5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAG1E"}

package/dist/src/functions/roomData.lua

@@ -33,13 +33,12 @@ function ____exports.getRoomDescriptorReadOnly(self)
     local level = game:GetLevel()
     return level:GetCurrentRoomDesc()
 end
---- Helper function to get the grid index of the current room.
+--- Helper function to get the safe grid index of the current room. (The safe grid index is defined
+-- as the top-left 1x1 section that the room overlaps with, or the top-right 1x1 section of a
+-- `RoomType.SHAPE_LTL` room.)
 -- 
--- - If the current room is inside of the grid, this function will return the `SafeGridIndex` from
---   the room descriptor. (The safe grid index is defined as the top-left 1x1 section that the room
---   overlaps with, or the top-right 1x1 section of a `RoomType.SHAPE_LTL` room.)
--- - If the current room is outside of the grid, it will return the index from the
---   `Level.GetCurrentRoomIndex` method (since `SafeGridIndex` is bugged for these cases).
+-- Under the hood, this function uses the `Level.GetCurrentRoomDesc` method. (In Afterbirth+, this
+-- method was bugged for rooms outside of the grid, but it is now fixed.)
 -- 
 -- Use this function instead of the `Level.GetCurrentRoomIndex` method directly because the latter
 -- will return the specific 1x1 quadrant that the player entered the room at. For most situations,
@@ -48,11 +47,6 @@ end
 -- Data structures that store data per room should use the room's `ListIndex` instead of
 -- `SafeGridIndex`, since the former is unique across different dimensions.
 function ____exports.getRoomGridIndex(self)
-    local level = game:GetLevel()
-    local currentRoomIndex = level:GetCurrentRoomIndex()
-    if currentRoomIndex < 0 then
-        return currentRoomIndex
-    end
     local roomDescriptor = ____exports.getRoomDescriptorReadOnly(nil)
     return roomDescriptor.SafeGridIndex
 end

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

@@ -31,6 +31,14 @@ export declare function getFireDelay(tearsStat: float): float;
  *   this function.
  */
 export declare function getTearsStat(fireDelay: float): float;
+/**
+ * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
+ * ground, a wall, or a grid entity.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
+ * die if they hit an enemy, but they will die if they hit a wall or object.)
+ */
+export declare function isMissedTear(tear: EntityTear): boolean;
 /**
  * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
  * is determined by looking at the parent.

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

@@ -1 +1 @@
-{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAuBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}
+{"version":3,"file":"tears.d.ts","sourceRoot":"","sources":["../../../src/functions/tears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAuBT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAgB1D"}

package/dist/src/functions/tears.lua

@@ -34,6 +34,14 @@ function ____exports.addTearsStat(self, player, tearsStat)
     local newMaxFireDelay = ____exports.getFireDelay(nil, newTearsStat)
     player.MaxFireDelay = newMaxFireDelay
 end
+--- Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
+-- ground, a wall, or a grid entity.
+-- 
+-- Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
+-- die if they hit an enemy, but they will die if they hit a wall or object.)
+function ____exports.isMissedTear(self, tear)
+    return tear:IsDead()
+end
 --- Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
 -- is determined by looking at the parent.
 -- 

package/dist/src/maps/collectibleTypeToNameMap.lua

@@ -657,7 +657,7 @@ ____exports.COLLECTIBLE_TYPE_TO_NAME_MAP = __TS__New(ReadonlyMap, {
     {653, "Vade Retro"},
     {654, "False PHD"},
     {655, "Spin to Win"},
-    {656, "Damocles"},
+    {656, "Damocles (Passive)"},
     {657, "Vasculitis"},
     {658, "Giant Cell"},
     {659, "Tropicamide"},

package/package.json

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

package/src/functions/minimap.ts

@@ -4,6 +4,7 @@ import { game } from "../core/cachedClasses";
 import { addFlag } from "./flag";
 import { getRoomDescriptor, getRoomGridIndex } from "./roomData";
 import { getRoomsInsideGrid } from "./rooms";
+import { isNumber } from "./types";
 import { assertDefined } from "./utils";
 
 /**
@@ -137,11 +138,18 @@ export function hideRoomOnMinimap(roomGridIndex: int): void {
 /**
  * Helper function to check if a given room is visible on the minimap.
  *
- * @param roomGridIndex The room to check.
+ * @param roomGridIndexOrRoomDescriptor The room to check.
  * @param minimapAPI Optional. Whether MinimapAPI should be used, if present. Default is true.
  */
-export function isRoomVisible(roomGridIndex: int, minimapAPI = true): boolean {
+export function isRoomVisible(
+  roomGridIndexOrRoomDescriptor: int | RoomDescriptor,
+  minimapAPI = true,
+): boolean {
+  const roomGridIndex = isNumber(roomGridIndexOrRoomDescriptor)
+    ? roomGridIndexOrRoomDescriptor
+    : roomGridIndexOrRoomDescriptor.SafeGridIndex;
   const roomDisplayFlags = getRoomDisplayFlags(roomGridIndex, minimapAPI);
+
   return roomDisplayFlags !== DisplayFlagZero;
 }
 

package/src/functions/roomData.ts

@@ -70,13 +70,12 @@ export function getRoomDescriptorReadOnly(): Readonly<RoomDescriptor> {
 }
 
 /**
- * Helper function to get the grid index of the current room.
+ * Helper function to get the safe grid index of the current room. (The safe grid index is defined
+ * as the top-left 1x1 section that the room overlaps with, or the top-right 1x1 section of a
+ * `RoomType.SHAPE_LTL` room.)
  *
- * - If the current room is inside of the grid, this function will return the `SafeGridIndex` from
- *   the room descriptor. (The safe grid index is defined as the top-left 1x1 section that the room
- *   overlaps with, or the top-right 1x1 section of a `RoomType.SHAPE_LTL` room.)
- * - If the current room is outside of the grid, it will return the index from the
- *   `Level.GetCurrentRoomIndex` method (since `SafeGridIndex` is bugged for these cases).
+ * Under the hood, this function uses the `Level.GetCurrentRoomDesc` method. (In Afterbirth+, this
+ * method was bugged for rooms outside of the grid, but it is now fixed.)
  *
  * Use this function instead of the `Level.GetCurrentRoomIndex` method directly because the latter
  * will return the specific 1x1 quadrant that the player entered the room at. For most situations,
@@ -86,16 +85,6 @@ export function getRoomDescriptorReadOnly(): Readonly<RoomDescriptor> {
  * `SafeGridIndex`, since the former is unique across different dimensions.
  */
 export function getRoomGridIndex(): int {
-  const level = game.GetLevel();
-  const currentRoomIndex = level.GetCurrentRoomIndex();
-
-  // Both `RoomDescriptor.GridIndex` and `RoomDescriptor.SafeGridIndex` will always be equal to -1
-  // for rooms outside of the grid. Thus, we revert to using the `Level.GetCurrentRoomIndex` method
-  // for these cases.
-  if (currentRoomIndex < 0) {
-    return currentRoomIndex;
-  }
-
   const roomDescriptor = getRoomDescriptorReadOnly();
   return roomDescriptor.SafeGridIndex;
 }

package/src/functions/tears.ts

@@ -44,6 +44,17 @@ export function getTearsStat(fireDelay: float): float {
   return 30 / (fireDelay + 1);
 }
 
+/**
+ * Helper function to check if a tear hit an enemy. A tear is considered to be missed if it hit the
+ * ground, a wall, or a grid entity.
+ *
+ * Under the hood, this function uses the `Entity.IsDead` method to determine this. (Tears will not
+ * die if they hit an enemy, but they will die if they hit a wall or object.)
+ */
+export function isMissedTear(tear: EntityTear): boolean {
+  return tear.IsDead();
+}
+
 /**
  * Helper function to check if a given tear is from a familiar (as opposed to e.g. a player). This
  * is determined by looking at the parent.

package/src/maps/collectibleTypeToNameMap.ts

@@ -661,7 +661,7 @@ export const COLLECTIBLE_TYPE_TO_NAME_MAP = new ReadonlyMap<
   [653, "Vade Retro"],
   [654, "False PHD"],
   [655, "Spin to Win"],
-  [656, "Damocles"],
+  [656, "Damocles (Passive)"],
   [657, "Vasculitis"],
   [658, "Giant Cell"],
   [659, "Tropicamide"],