isaacscript-common 1.2.27 → 1.2.31

package/dist/callbacks/postNewRoomEarly.lua

@@ -29,6 +29,9 @@ function checkRoomChanged(self)
     local topLeftWall = room:GetGridEntity(topLeftWallGridIndex)
     if topLeftWall == nil then
         topLeftWall = spawnGridEntity(nil, GridEntityType.GRID_WALL, topLeftWallGridIndex)
+        if topLeftWall == nil then
+            return
+        end
     end
     local topLeftWallPtrHash = GetPtrHash(topLeftWall)
     if topLeftWallPtrHash ~= currentRoomTopLeftWallPtrHash then

package/dist/features/deployJSONRoom.lua

@@ -6,7 +6,7 @@ local Map = ____lualib.Map
 local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local postNewRoom, setDecorationsInvisible, respawnPersistentEntities, removeSpecificNPCs, fillRoomWithDecorations, spawnAllEntities, spawnGridEntity, spawnNormalEntity, storePersistentEntity, fixPitGraphics, getPitMap, getPitFrame, FEATURE_NAME, NPC_TYPES_TO_NOT_REMOVE, PERSISTENT_ENTITY_TYPES, initialized, v
+local postNewRoom, setDecorationsInvisible, respawnPersistentEntities, removeSpecificNPCs, fillRoomWithDecorations, spawnAllEntities, spawnGridEntityForJSONRoom, spawnNormalEntityForJSONRoom, storePersistentEntity, fixPitGraphics, getPitMap, getPitFrame, FEATURE_NAME, NPC_TYPES_TO_NOT_REMOVE, PERSISTENT_ENTITY_TYPES, initialized, v
 local ____errors = require("errors")
 local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
 local ____entity = require("functions.entity")
@@ -18,6 +18,7 @@ local convertXMLGridEntityType = ____gridEntity.convertXMLGridEntityType
 local getGridEntities = ____gridEntity.getGridEntities
 local removeAllGridEntitiesExceptFor = ____gridEntity.removeAllGridEntitiesExceptFor
 local setGridEntityInvisible = ____gridEntity.setGridEntityInvisible
+local spawnGridEntityWithVariant = ____gridEntity.spawnGridEntityWithVariant
 local ____jsonRoom = require("functions.jsonRoom")
 local getRandomJSONRoom = ____jsonRoom.getRandomJSONRoom
 local ____log = require("functions.log")
@@ -138,7 +139,9 @@ function fillRoomWithDecorations(self)
                 end
                 local position = room:GetGridPosition(gridIndex)
                 local decoration = Isaac.GridSpawn(GridEntityType.GRID_DECORATION, 0, position, true)
-                setGridEntityInvisible(nil, decoration)
+                if decoration ~= nil then
+                    setGridEntityInvisible(nil, decoration)
+                end
                 __TS__ArrayPush(decorationGridIndexes, gridIndex)
             end
             ::__continue34::
@@ -185,7 +188,7 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
             if verbose then
                 log(((((((("Spawning grid entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
-            spawnGridEntity(
+            spawnGridEntityForJSONRoom(
                 nil,
                 entityType,
                 variant,
@@ -197,7 +200,7 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
             if verbose then
                 log(((((((((("Spawning normal entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. ".") .. tostring(subType)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
-            local entity = spawnNormalEntity(
+            local entity = spawnNormalEntityForJSONRoom(
                 nil,
                 entityType,
                 variant,
@@ -222,28 +225,28 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
     end
     return seed
 end
-function spawnGridEntity(self, xmlEntityType, xmlEntityVariant, x, y)
-    local gridEntityArray = convertXMLGridEntityType(nil, xmlEntityType, xmlEntityVariant)
-    if gridEntityArray == nil then
+function spawnGridEntityForJSONRoom(self, xmlEntityType, xmlEntityVariant, x, y)
+    local game = Game()
+    local room = game:GetRoom()
+    local gridEntityTuple = convertXMLGridEntityType(nil, xmlEntityType, xmlEntityVariant)
+    if gridEntityTuple == nil then
         return nil
     end
-    local entityType, variant = table.unpack(gridEntityArray)
+    local gridEntityType, variant = table.unpack(gridEntityTuple)
     local position = gridToPos(nil, x, y)
-    local gridEntity = Isaac.GridSpawn(entityType, variant, position, true)
-    if entityType == GridEntityType.GRID_PIT then
-        local pit = gridEntity:ToPit()
-        if pit ~= nil then
-            pit:UpdateCollision()
-        end
+    local gridIndex = room:GetGridIndex(position)
+    local gridEntity = spawnGridEntityWithVariant(nil, gridEntityType, variant, gridIndex)
+    if gridEntity == nil then
+        return gridEntity
     end
-    if entityType == GridEntityType.GRID_POOP then
+    if gridEntityType == GridEntityType.GRID_POOP then
         local sprite = gridEntity:GetSprite()
         sprite:Play("State1", true)
         sprite:SetLastFrame()
     end
     return gridEntity
 end
-function spawnNormalEntity(self, entityType, variant, subType, x, y, seed)
+function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y, seed)
     local game = Game()
     local room = game:GetRoom()
     local roomType = room:GetType()

package/dist/functions/gridEntity.d.ts

@@ -106,7 +106,7 @@ export declare function spawnGiantPoop(topLeftGridIndex: int): void;
  * - removes existing grid entities on the same tile, if any
  * - allows you to specify the grid index instead of the position
  */
-export declare function spawnGridEntity(gridEntityType: GridEntityType, gridIndex: int): GridEntity;
+export declare function spawnGridEntity(gridEntityType: GridEntityType, gridIndex: int): GridEntity | undefined;
 /**
  * Helper function to spawn a grid entity with a specific variant. Use this instead of the
  * `Isaac.GridSpawn()` method since it:
@@ -114,9 +114,9 @@ export declare function spawnGridEntity(gridEntityType: GridEntityType, gridInde
  * - removes existing grid entities on the same tile, if any
  * - allows you to specify the grid index instead of the position
  */
-export declare function spawnGridEntityWithVariant(gridEntityType: GridEntityType, variant: int, gridIndex: int): GridEntity;
+export declare function spawnGridEntityWithVariant(gridEntityType: GridEntityType, variant: int, gridIndex: int): GridEntity | undefined;
 /**
  * Helper function to spawn a Void Portal. This is more complicated than simply spawning a trapdoor
  * with the appropriate variant, as the game does not give it the correct sprite automatically.
  */
-export declare function spawnVoidPortal(gridIndex: int): void;
+export declare function spawnVoidPortal(gridIndex: int): GridEntity | undefined;

package/dist/functions/gridEntity.lua

@@ -48,6 +48,9 @@ function ____exports.spawnGridEntityWithVariant(self, gridEntityType, variant, g
     end
     local position = room:GetGridPosition(gridIndex)
     local gridEntity = Isaac.GridSpawn(gridEntityType, variant, position, true)
+    if gridEntity == nil then
+        return gridEntity
+    end
     if gridEntityType == GridEntityType.GRID_PIT then
         local pit = gridEntity:ToPit()
         if pit ~= nil then
@@ -221,8 +224,12 @@ function ____exports.spawnGridEntity(self, gridEntityType, gridIndex)
 end
 function ____exports.spawnVoidPortal(self, gridIndex)
     local voidPortal = ____exports.spawnGridEntityWithVariant(nil, GridEntityType.GRID_TRAPDOOR, 1, gridIndex)
+    if voidPortal == nil then
+        return voidPortal
+    end
     voidPortal.VarData = 1
     local sprite = voidPortal:GetSprite()
     sprite:Load("gfx/grid/voidtrapdoor.anm2", true)
+    return voidPortal
 end
 return ____exports

package/dist/functions/npc.lua

@@ -81,7 +81,10 @@ NON_ALIVE_NPCS_TYPE_VARIANT = __TS__New(
 )
 NON_ALIVE_NPCS_TYPE_VARIANT_SUBTYPE = __TS__New(
     Set,
-    {(((tostring(EntityType.ENTITY_CHARGER) .. ".") .. 0) .. ".") .. 1}
+    {
+        (((tostring(EntityType.ENTITY_CHARGER) .. ".") .. 0) .. ".") .. 1,
+        (((tostring(EntityType.ENTITY_MOTHER) .. ".") .. 0) .. ".") .. 1
+    }
 )
 function ____exports.fireProjectiles(self, npc, position, velocity, projectilesMode, projectileParams)
     if projectilesMode == nil then

package/dist/functions/rooms.d.ts

@@ -43,8 +43,11 @@ export declare function getRoomDescriptor(roomGridIndex?: int): RoomDescriptor;
  * specified room type.
  *
  * This function only searches through rooms in the current dimension.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get the combined grid
+ * indexes for N room types.
  */
-export declare function getRoomGridIndexesForType(roomType: RoomType): int[];
+export declare function getRoomGridIndexesForType(...roomTypes: RoomType[]): int[];
 /**
  * Helper function to get the item pool type for the current room. For example, this returns
  * `ItemPoolType.ItemPoolType.POOL_ANGEL` if you are in an Angel Room.

package/dist/functions/rooms.lua

@@ -1,6 +1,7 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local Set = ____lualib.Set
@@ -132,11 +133,12 @@ function ____exports.getRoomDataType(self, roomGridIndex)
     local roomData = ____exports.getRoomData(nil, roomGridIndex)
     return roomData == nil and -1 or roomData.Type
 end
-function ____exports.getRoomGridIndexesForType(self, roomType)
+function ____exports.getRoomGridIndexesForType(self, ...)
+    local roomTypes = {...}
     local rooms = ____exports.getRooms(nil)
     local matchingRooms = __TS__ArrayFilter(
         rooms,
-        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and roomDescriptor.Data.Type == roomType end
+        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and __TS__ArrayIncludes(roomTypes, roomDescriptor.Data.Type) end
     )
     return __TS__ArrayMap(
         matchingRooms,

package/dist/functions/sound.d.ts

@@ -0,0 +1 @@
+export declare function stopAllSoundEffects(): void;

package/dist/functions/sound.lua

@@ -0,0 +1,11 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local ____util = require("functions.util")
+local getEnumValues = ____util.getEnumValues
+function ____exports.stopAllSoundEffects(self)
+    local sfxManager = SFXManager()
+    for ____, soundEffect in ipairs(getEnumValues(nil, SoundEffect)) do
+        sfxManager:Stop(soundEffect)
+    end
+end
+return ____exports

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export * from "./functions/revive";
 export * from "./functions/rooms";
 export * from "./functions/seeds";
 export * from "./functions/set";
+export * from "./functions/sound";
 export * from "./functions/spawnCollectible";
 export * from "./functions/sprite";
 export * from "./functions/stage";

package/dist/index.lua

@@ -370,6 +370,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.sound")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.spawnCollectible")
     for ____exportKey, ____exportValue in pairs(____export) do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.27",
+  "version": "1.2.31",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -26,10 +26,10 @@
   ],
   "devDependencies": {
     "@zamiell/typescript-to-lua": "^1.4.0",
-    "isaac-typescript-definitions": "^1.0.339",
+    "isaac-typescript-definitions": "^1.0.343",
     "isaacscript-lint": "^1.0.79",
     "isaacscript-tsconfig": "^1.1.8",
-    "typedoc": "^0.22.11",
+    "typedoc": "^0.22.12",
     "typescript": "^4.5.5"
   }
 }