isaacscript-common 1.0.576 → 1.0.580

package/dist/functions/rooms.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
  * Helper function for quickly switching to a new room without playing a particular animation.
- * Always use this helper function over invoking `Game().ChangeRoom()` directly to ensure that you
- * do not forget to set the LeaveDoor property.
+ * Use this helper function over invoking `Game().ChangeRoom()` directly to ensure that you do not
+ * forget to set the LeaveDoor property and to prevent crashing on invalid room grid indexes.
  */
 export declare function changeRoom(roomGridIndex: int): void;
 export declare function getAllRoomGridIndexes(): int[];
@@ -220,3 +220,15 @@ export declare function setRoomCleared(): void;
  * spawns an NPC.
  */
 export declare function setRoomUncleared(): void;
+/**
+ * Helper function to change the current room. It can be used for both teleportation and "normal"
+ * room transitions, depending on what is passed for the `direction` and `roomTransitionAnim`
+ * arguments. Use this function instead of invoking `Game.StartRoomTransition()` directly so that
+ * you do not forget to set `Level.LeaveDoor` property and to prevent crashing on invalid room grid
+ * indexes.
+ *
+ * @param roomGridIndex The room grid index of the destination room.
+ * @param direction Optional. Default is `Direction.NO_DIRECTION`.
+ * @param roomTransitionAnim Optional. Default is `RoomTransitionAnim.TELEPORT`.
+ */
+export declare function teleport(roomGridIndex: int, direction?: Direction, roomTransitionAnim?: RoomTransitionAnim): void;

package/dist/functions/rooms.lua

@@ -85,6 +85,10 @@ end
 function ____exports.changeRoom(self, roomGridIndex)
     local game = Game()
     local level = game:GetLevel()
+    local roomData = ____exports.getRoomData(nil, roomGridIndex)
+    if roomData == nil then
+        error(("Failed to change the room to grid index " .. tostring(roomGridIndex)) .. " because that room does not exist.")
+    end
     level.LeaveDoor = -1
     game:ChangeRoom(roomGridIndex)
 end
@@ -246,17 +250,17 @@ function ____exports.isAllRoomsClear(self, onlyCheckRoomTypes)
         do
             local roomData = roomDescriptor.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 roomDescriptor.Clear then
                 return false
             end
         end
-        ::__continue48::
+        ::__continue49::
     end
     return true
 end
@@ -292,12 +296,12 @@ function ____exports.setRoomCleared(self)
     for ____, door in ipairs(getDoors(nil)) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue59
+                goto __continue60
             end
             openDoorFast(nil, door)
             door.ExtraVisible = false
         end
-        ::__continue59::
+        ::__continue60::
     end
     sfx:Stop(SoundEffect.SOUND_DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)
@@ -308,4 +312,20 @@ function ____exports.setRoomUncleared(self)
     room:SetClear(false)
     closeAllDoors(nil)
 end
+function ____exports.teleport(self, roomGridIndex, direction, roomTransitionAnim)
+    if direction == nil then
+        direction = Direction.NO_DIRECTION
+    end
+    if roomTransitionAnim == nil then
+        roomTransitionAnim = RoomTransitionAnim.TELEPORT
+    end
+    local game = Game()
+    local level = game:GetLevel()
+    local roomData = ____exports.getRoomData(nil, roomGridIndex)
+    if roomData == nil then
+        error(("Failed to change the room to grid index " .. tostring(roomGridIndex)) .. " because that room does not exist.")
+    end
+    level.LeaveDoor = -1
+    game:StartRoomTransition(roomGridIndex, direction, roomTransitionAnim)
+end
 return ____exports

package/dist/functions/util.d.ts

@@ -90,14 +90,3 @@ export declare function printConsole(msg: string): void;
  * `clear` method does not exist. Use this helper function as a drop-in replacement for this.
  */
 export declare function tableClear(table: LuaTable): void;
-/**
- * Helper function to change the current room. It can be used for both teleportation and "normal"
- * room transitions, depending on what is passed for the `direction` and `roomTransitionAnim`
- * arguments. Use this function instead of invoking `Game.StartRoomTransition()` directly so that
- * you don't forget to set `Level.LeaveDoor` property.
- *
- * @param roomGridIndex The room grid index of the destination room.
- * @param direction Optional. Default is `Direction.NO_DIRECTION`.
- * @param roomTransitionAnim Optional. Default is `RoomTransitionAnim.TELEPORT`.
- */
-export declare function teleport(roomGridIndex: int, direction?: Direction, roomTransitionAnim?: RoomTransitionAnim): void;

package/dist/functions/util.lua

@@ -70,16 +70,4 @@ function ____exports.tableClear(self, ____table)
         ____table[key] = nil
     end
 end
-function ____exports.teleport(self, roomGridIndex, direction, roomTransitionAnim)
-    if direction == nil then
-        direction = Direction.NO_DIRECTION
-    end
-    if roomTransitionAnim == nil then
-        roomTransitionAnim = RoomTransitionAnim.TELEPORT
-    end
-    local game = Game()
-    local level = game:GetLevel()
-    level.LeaveDoor = -1
-    game:StartRoomTransition(roomGridIndex, direction, roomTransitionAnim)
-end
 return ____exports

package/dist/patchErrorFunctions.lua

@@ -15,7 +15,8 @@ function errorWithTraceback(message, level)
     end
     local tracebackOutput = getTraceback(nil)
     local slimmedTracebackOutput = slimTracebackOutput(nil, tracebackOutput)
-    Isaac.DebugString(slimmedTracebackOutput)
+    message = message .. "\n"
+    message = message .. slimmedTracebackOutput
     return vanillaError(message, level + 1)
 end
 function slimTracebackOutput(self, tracebackOutput)

package/package.json

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