isaacscript-common 1.0.548 → 1.0.549

package/dist/functions/rooms.d.ts

@@ -7,6 +7,8 @@
 export declare function changeRoom(roomGridIndex: int): void;
 export declare function getAllRoomGridIndexes(): int[];
 export declare function getCurrentDimension(): Dimension;
+/** An alias to the `Level.GetCurrentRoomDesc()` method. */
+export declare function getCurrentRoomDescReadOnly(): RoomDescriptorReadOnly;
 export declare function getRoomData(): RoomConfig | undefined;
 /**
  * Helper function to get the type for the room from the XML/STB data. The room data type will
@@ -126,6 +128,11 @@ export declare function inCrawlspace(): boolean;
  * with the Death Certificate area.
  */
 export declare function inDeathCertificateArea(): boolean;
+/**
+ * Helper function to detect if the current room is a Treasure Room created when entering with a
+ * Devil's Crown trinket. Under the hood, this checks for the `RoomDescriptorFlag.DEVIL_TREASURE`
+ * flag.
+ */
 export declare function inDevilsCrownTreasureRoom(): boolean;
 export declare function inDimension(dimension: Dimension): boolean;
 /** Helper function to determine if the current room shape is one of the four L room shapes. */
@@ -152,6 +159,11 @@ export declare function inStartingRoom(): boolean;
  * default.
  */
 export declare function isAllRoomsClear(onlyCheckRoomTypes?: RoomType[]): boolean;
+/**
+ * Helper function to detect if the current room was created by the Red Key item. Under the hood,
+ * this checks for the `RoomDescriptorFlag.FLAG_RED_ROOM` flag.
+ */
+export declare function isRedKeyRoom(): boolean;
 /**
  * Helper function to determine whether or not the current room is part of the floor layout. For
  * example, Devil Rooms and the Mega Satan room are not considered to be inside the map.

package/dist/functions/rooms.lua

@@ -17,6 +17,11 @@ local setEntityPositions = ____entity.setEntityPositions
 local setEntityVelocities = ____entity.setEntityVelocities
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
+function ____exports.getCurrentRoomDescReadOnly(self)
+    local game = Game()
+    local level = game:GetLevel()
+    return level:GetCurrentRoomDesc()
+end
 function ____exports.getRoomData(self)
     local game = Game()
     local level = game:GetLevel()
@@ -25,9 +30,7 @@ function ____exports.getRoomData(self)
     return roomDesc.Data
 end
 function ____exports.getRoomSafeGridIndex(self)
-    local game = Game()
-    local level = game:GetLevel()
-    local roomDesc = level:GetCurrentRoomDesc()
+    local roomDesc = ____exports.getCurrentRoomDescReadOnly(nil)
     return roomDesc.SafeGridIndex
 end
 function ____exports.getRoomStageID(self)
@@ -130,9 +133,7 @@ function ____exports.getRoomDataType(self)
     return roomData.Type
 end
 function ____exports.getRoomListIndex(self)
-    local game = Game()
-    local level = game:GetLevel()
-    local roomDesc = level:GetCurrentRoomDesc()
+    local roomDesc = ____exports.getCurrentRoomDescReadOnly(nil)
     return roomDesc.ListIndex
 end
 function ____exports.getRoomGridIndexesForType(self, roomType)
@@ -169,9 +170,7 @@ function ____exports.getRoomVariant(self)
     return roomData.Variant
 end
 function ____exports.getRoomVisitedCount(self)
-    local game = Game()
-    local level = game:GetLevel()
-    local roomDesc = level:GetCurrentRoomDesc()
+    local roomDesc = ____exports.getCurrentRoomDescReadOnly(nil)
     return roomDesc.VisitedCount
 end
 function ____exports.gridToPos(self, x, y)
@@ -214,9 +213,7 @@ function ____exports.inCrawlspace(self)
     return (roomSafeGridIndex == GridRooms.ROOM_DUNGEON_IDX) and (roomSubType ~= 4)
 end
 function ____exports.inDevilsCrownTreasureRoom(self)
-    local game = Game()
-    local level = game:GetLevel()
-    local roomDesc = level:GetCurrentRoomDesc()
+    local roomDesc = ____exports.getCurrentRoomDescReadOnly(nil)
     return hasFlag(nil, roomDesc.Flags, 2048)
 end
 function ____exports.inDimension(self, dimension)
@@ -259,20 +256,24 @@ function ____exports.isAllRoomsClear(self, onlyCheckRoomTypes)
         do
             local roomData = roomDesc.Data
             if roomData == nil then
-                goto __continue48
+                goto __continue49
             end
             local roomType = roomData.Type
             if (roomTypeWhitelist ~= nil) and (not roomTypeWhitelist:has(roomType)) then
-                goto __continue48
+                goto __continue49
             end
             if not roomDesc.Clear then
                 return false
             end
         end
-        ::__continue48::
+        ::__continue49::
     end
     return true
 end
+function ____exports.isRedKeyRoom(self)
+    local roomDesc = ____exports.getCurrentRoomDescReadOnly(nil)
+    return hasFlag(nil, roomDesc.Flags, 1024)
+end
 function ____exports.isRoomInsideMap(self)
     local roomSafeGridIndex = ____exports.getRoomSafeGridIndex(nil)
     return roomSafeGridIndex >= 0
@@ -301,14 +302,14 @@ function ____exports.setRoomCleared(self)
     ) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue56
+                goto __continue58
             end
             door.State = DoorState.STATE_OPEN
             local sprite = door:GetSprite()
             sprite:Play("Opened", true)
             door.ExtraVisible = false
         end
-        ::__continue56::
+        ::__continue58::
     end
     sfx:Stop(SoundEffect.SOUND_DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)

package/dist/functions/seeds.d.ts

@@ -1,2 +1,2 @@
-/** Helper function to get the seed of the current run. */
+/** Alias for the `Seeds.GetStartSeedString` method. */
 export declare function getStartSeedString(): string;

package/dist/functions/stage.d.ts

@@ -5,9 +5,9 @@
  * consider Downpour 2 to have a stage of 3.
  */
 export declare function getEffectiveStage(): int;
-/** Helper function to get the current stage. */
+/** Alias for the `Level.GetStage` method. */
 export declare function getStage(): LevelStage;
-/** Helper function to get the current stage type. */
+/** Alias for the `Level.GetStageType` method. */
 export declare function getStageType(): StageType;
 /** Helper function to directly warp to a specific stage using the "stage" console command. */
 export declare function goToStage(stage: LevelStage, stageType: StageType): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.0.548",
+  "version": "1.0.549",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",