isaacscript-common 6.6.3 → 6.7.0

package/dist/functions/gridEntitiesSpecific.lua

@@ -0,0 +1,366 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorVariant = ____isaac_2Dtypescript_2Ddefinitions.DoorVariant
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local PitVariant = ____isaac_2Dtypescript_2Ddefinitions.PitVariant
+local PoopGridEntityVariant = ____isaac_2Dtypescript_2Ddefinitions.PoopGridEntityVariant
+local PressurePlateVariant = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateVariant
+local RockVariant = ____isaac_2Dtypescript_2Ddefinitions.RockVariant
+local ____gridEntities = require("functions.gridEntities")
+local getGridEntities = ____gridEntities.getGridEntities
+local removeGridEntities = ____gridEntities.removeGridEntities
+local spawnGridEntityWithVariant = ____gridEntities.spawnGridEntityWithVariant
+--- Helper function to spawn a `GridEntityType.DOOR` (16) with a specific variant.
+function ____exports.spawnDoorWithVariant(self, doorVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.DOOR, doorVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local door = gridEntity:ToDoor()
+    if door == nil then
+        error("Failed to spawn a door.")
+    end
+    return door
+end
+--- Helper function to spawn a `GridEntityType.PIT` (7) with a specific variant.
+function ____exports.spawnPitWithVariant(self, pitVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.PIT, pitVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local pit = gridEntity:ToPit()
+    if pit == nil then
+        error("Failed to spawn a pit.")
+    end
+    return pit
+end
+--- Helper function to spawn a `GridEntityType.POOP` (14) with a specific variant.
+function ____exports.spawnPoopWithVariant(self, poopVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.POOP, poopVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local poop = gridEntity:ToPoop()
+    if poop == nil then
+        error("Failed to spawn a poop.")
+    end
+    return poop
+end
+--- Helper function to spawn a `GridEntityType.PRESSURE_PLATE` (20) with a specific variant.
+function ____exports.spawnPressurePlateWithVariant(self, pressurePlateVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.PRESSURE_PLATE, pressurePlateVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local pressurePlate = gridEntity:ToPressurePlate()
+    if pressurePlate == nil then
+        error("Failed to spawn a pressure plate.")
+    end
+    return pressurePlate
+end
+--- Helper function to spawn a `GridEntityType.ROCK` (2) with a specific variant.
+function ____exports.spawnRockWithVariant(self, rockVariant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.ROCK, rockVariant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local rock = gridEntity:ToRock()
+    if rock == nil then
+        error("Failed to spawn a rock.")
+    end
+    return rock
+end
+--- Helper function to spawn a `GridEntityType.SPIKES` (8) with a specific variant.
+function ____exports.spawnSpikesWithVariant(self, variant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.SPIKES, variant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local spikes = gridEntity:ToSpikes()
+    if spikes == nil then
+        error("Failed to spawn spikes.")
+    end
+    return spikes
+end
+--- Helper function to spawn a `GridEntityType.TNT` (12) with a specific variant.
+function ____exports.spawnTNTWithVariant(self, variant, gridIndexOrPosition)
+    local gridEntity = spawnGridEntityWithVariant(nil, GridEntityType.TNT, variant, gridIndexOrPosition)
+    if gridEntity == nil then
+        return gridEntity
+    end
+    local tnt = gridEntity:ToTNT()
+    if tnt == nil then
+        error("Failed to spawn TNT.")
+    end
+    return tnt
+end
+--- Helper function to get all of the `GridEntityPit` in the room.
+-- 
+-- @param pitVariant Optional. If specified, will only get the pits that match the variant. Default
+-- is -1, which matches every variant.
+function ____exports.getPits(self, pitVariant)
+    if pitVariant == nil then
+        pitVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local pits = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pit = gridEntity:ToPit()
+        if pit ~= nil then
+            local gridEntityVariant = pit:GetVariant()
+            if pitVariant == -1 or pitVariant == gridEntityVariant then
+                pits[#pits + 1] = pit
+            end
+        end
+    end
+    return pits
+end
+--- Helper function to get all of the `GridEntityPoop` in the room.
+-- 
+-- @param poopVariant Optional. If specified, will only get the poops that match the variant.
+-- Default is -1, which matches every variant.
+function ____exports.getPoops(self, poopVariant)
+    if poopVariant == nil then
+        poopVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local poops = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local poop = gridEntity:ToPoop()
+        if poop ~= nil then
+            local gridEntityVariant = poop:GetVariant()
+            if poopVariant == -1 or poopVariant == gridEntityVariant then
+                poops[#poops + 1] = poop
+            end
+        end
+    end
+    return poops
+end
+--- Helper function to get all of the `GridEntityPressurePlate` in the room.
+-- 
+-- @param pressurePlateVariant Optional. If specified, will only get the pressure plates that match
+-- the variant. Default is -1, which matches every variant.
+function ____exports.getPressurePlates(self, pressurePlateVariant)
+    if pressurePlateVariant == nil then
+        pressurePlateVariant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local pressurePlates = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local pressurePlate = gridEntity:ToPressurePlate()
+        if pressurePlate ~= nil then
+            local gridEntityVariant = pressurePlate:GetVariant()
+            if pressurePlateVariant == -1 or pressurePlateVariant == gridEntityVariant then
+                pressurePlates[#pressurePlates + 1] = pressurePlate
+            end
+        end
+    end
+    return pressurePlates
+end
+--- Helper function to get all of the `GridEntityRock` in the room.
+-- 
+-- @param variant Optional. If specified, will only get the rocks that match the variant. Default is
+-- -1, which matches every variant. Note that this is not the same thing as the
+-- `RockVariant` enum, since that only applies to `GridEntityType.ROCK`, and other
+-- types of grid entities can be the `GridEntityRock` class.
+function ____exports.getRocks(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local rocks = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local rock = gridEntity:ToRock()
+        if rock ~= nil then
+            local gridEntityVariant = rock:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                rocks[#rocks + 1] = rock
+            end
+        end
+    end
+    return rocks
+end
+--- Helper function to get all of the `GridEntitySpikes` in the room.
+function ____exports.getSpikes(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local spikes = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local spike = gridEntity:ToSpikes()
+        if spike ~= nil then
+            local gridEntityVariant = spike:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                spikes[#spikes + 1] = spike
+            end
+        end
+    end
+    return spikes
+end
+--- Helper function to get all of the `GridEntityTNT` in the room.
+function ____exports.getTNT(self, variant)
+    if variant == nil then
+        variant = -1
+    end
+    local gridEntities = getGridEntities(nil)
+    local tntArray = {}
+    for ____, gridEntity in ipairs(gridEntities) do
+        local tnt = gridEntity:ToTNT()
+        if tnt ~= nil then
+            local gridEntityVariant = tnt:GetVariant()
+            if variant == -1 or variant == gridEntityVariant then
+                tntArray[#tntArray + 1] = tnt
+            end
+        end
+    end
+    return tntArray
+end
+--- Helper function to remove all of the `GridEntityPit` in the room.
+-- 
+-- @param pitVariant Optional. If specified, will only remove the pits that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the pits are removed. Default
+-- is false. For more information, see the description of the `removeGridEntities`
+-- helper function.
+-- @param cap Optional. If specified, will only remove the given amount of pits.
+-- @returns The pits that were removed.
+function ____exports.removeAllPits(self, pitVariant, updateRoom, cap)
+    if pitVariant == nil then
+        pitVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local pits = ____exports.getPits(nil, pitVariant)
+    return removeGridEntities(nil, pits, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityPoop` in the room.
+-- 
+-- Note that poops can either be an entity or a grid entity, depending on the situation. This
+-- function will only remove the grid entity poops.
+-- 
+-- @param poopVariant Optional. If specified, will only remove the poops that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the poops are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of poops.
+-- @returns The poops that were removed.
+function ____exports.removeAllPoops(self, poopVariant, updateRoom, cap)
+    if poopVariant == nil then
+        poopVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local poops = ____exports.getPoops(nil, poopVariant)
+    return removeGridEntities(nil, poops, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityPressurePlate` in the room.
+-- 
+-- @param pressurePlateVariant Optional. If specified, will only remove the pressure plates that
+-- match this variant. Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the pressure plates are
+-- removed. Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of pressure plates.
+-- @returns The pressure plates that were removed.
+function ____exports.removeAllPressurePlates(self, pressurePlateVariant, updateRoom, cap)
+    if pressurePlateVariant == nil then
+        pressurePlateVariant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local pressurePlates = ____exports.getPressurePlates(nil, pressurePlateVariant)
+    return removeGridEntities(nil, pressurePlates, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityRock` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the rocks that match this variant.
+-- Default is -1, which matches every variant. Note that this is not the same thing
+-- as the `RockVariant` enum, since that only applies to `GridEntityType.ROCK`, and
+-- other types of grid entities can be the `GridEntityRock` class.
+-- @param updateRoom Optional. Whether or not to update the room after the rocks are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of rocks.
+-- @returns The rocks that were removed.
+function ____exports.removeAllRocks(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local rocks = ____exports.getRocks(nil, variant)
+    return removeGridEntities(nil, rocks, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntitySpikes` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the spikes that match this variant.
+-- Default is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the spikes are removed.
+-- Default is false. For more information, see the description of the
+-- `removeGridEntities` helper function.
+-- @param cap Optional. If specified, will only remove the given amount of spikes.
+-- @returns The spikes that were removed.
+function ____exports.removeAllSpikes(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local spikes = ____exports.getSpikes(nil, variant)
+    return removeGridEntities(nil, spikes, updateRoom, cap)
+end
+--- Helper function to remove all of the `GridEntityTNT` in the room.
+-- 
+-- @param variant Optional. If specified, will only remove the TNTs that match this variant. Default
+-- is -1, which matches every variant.
+-- @param updateRoom Optional. Whether or not to update the room after the TNTs are removed. Default
+-- is false. For more information, see the description of the `removeGridEntities`
+-- helper function.
+-- @param cap Optional. If specified, will only remove the given amount of TNTs.
+-- @returns The TNTs that were removed.
+function ____exports.removeAllTNT(self, variant, updateRoom, cap)
+    if variant == nil then
+        variant = -1
+    end
+    if updateRoom == nil then
+        updateRoom = false
+    end
+    local tnt = ____exports.getTNT(nil, variant)
+    return removeGridEntities(nil, tnt, updateRoom, cap)
+end
+--- Helper function to spawn a `GridEntityType.DOOR` (16).
+function ____exports.spawnDoor(self, gridIndexOrPosition)
+    return ____exports.spawnDoorWithVariant(nil, DoorVariant.UNSPECIFIED, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.PIT` (7).
+function ____exports.spawnPit(self, gridIndexOrPosition)
+    return ____exports.spawnPitWithVariant(nil, PitVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.POOP` (14).
+function ____exports.spawnPoop(self, gridIndexOrPosition)
+    return ____exports.spawnPoopWithVariant(nil, PoopGridEntityVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.PRESSURE_PLATE` (20).
+function ____exports.spawnPressurePlate(self, gridIndexOrPosition)
+    return ____exports.spawnPressurePlateWithVariant(nil, PressurePlateVariant.PRESSURE_PLATE, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.ROCK` (2).
+function ____exports.spawnRock(self, gridIndexOrPosition)
+    return ____exports.spawnRockWithVariant(nil, RockVariant.NORMAL, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.SPIKES` (8).
+function ____exports.spawnSpikes(self, gridIndexOrPosition)
+    return ____exports.spawnSpikesWithVariant(nil, 0, gridIndexOrPosition)
+end
+--- Helper function to spawn a `GridEntityType.TNT` (12).
+function ____exports.spawnTNT(self, gridIndexOrPosition)
+    return ____exports.spawnTNTWithVariant(nil, 0, gridIndexOrPosition)
+end
+return ____exports

package/dist/functions/log.d.ts

@@ -64,7 +64,7 @@ export declare function logSounds(this: void): void;
  * recursively call itself if it counters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
- * instead of randomly). It will throw a runtime error if it encounters a non-string key.
+ * instead of randomly). It will throw a run-time error if it encounters a non-string key.
  */
 export declare function logTable(this: void, luaTable: unknown, parentTables?: number): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/functions/log.ts"],"names":[],"mappings":"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"}

package/dist/functions/log.lua

@@ -28,22 +28,22 @@ local ____array = require("functions.array")
 local arrayToString = ____array.arrayToString
 local ____collectibles = require("functions.collectibles")
 local getCollectibleName = ____collectibles.getCollectibleName
-local ____entity = require("functions.entity")
-local getEntities = ____entity.getEntities
-local getEntityID = ____entity.getEntityID
+local ____entities = require("functions.entities")
+local getEntities = ____entities.getEntities
+local getEntityID = ____entities.getEntityID
 local ____enums = require("functions.enums")
 local getEnumEntries = ____enums.getEnumEntries
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
-local ____gridEntity = require("functions.gridEntity")
-local getGridEntities = ____gridEntity.getGridEntities
+local ____gridEntities = require("functions.gridEntities")
+local getGridEntities = ____gridEntities.getGridEntities
 local ____isaacAPIClass = require("functions.isaacAPIClass")
 local getIsaacAPIClassName = ____isaacAPIClass.getIsaacAPIClassName
-local ____player = require("functions.player")
-local getEffectsList = ____player.getEffectsList
-local getPlayerName = ____player.getPlayerName
 local ____playerHealth = require("functions.playerHealth")
 local getPlayerHealth = ____playerHealth.getPlayerHealth
+local ____players = require("functions.players")
+local getEffectsList = ____players.getEffectsList
+local getPlayerName = ____players.getPlayerName
 local ____roomData = require("functions.roomData")
 local getRoomData = ____roomData.getRoomData
 local getRoomGridIndex = ____roomData.getRoomGridIndex
@@ -464,7 +464,7 @@ end
 -- recursively call itself if it counters a table within a table.
 -- 
 -- This function will only work on tables that have string keys (because it logs the keys in order,
--- instead of randomly). It will throw a runtime error if it encounters a non-string key.
+-- instead of randomly). It will throw a run-time error if it encounters a non-string key.
 function ____exports.logTable(luaTable, parentTables)
     if parentTables == nil then
         parentTables = 0
@@ -478,7 +478,9 @@ function ____exports.logTable(luaTable, parentTables)
         math.floor(numSpaces)
     )
     if not isTable(nil, luaTable) then
-        ____exports.log(((indentation .. "n/a (encountered a variable of type \"") .. __TS__TypeOf(luaTable)) .. "\" instead of a table)")
+        (function()
+            ____exports.log(((indentation .. "n/a (encountered a variable of type \"") .. __TS__TypeOf(luaTable)) .. "\" instead of a table)")
+        end)(nil)
         return
     end
     iterateTableInOrder(
@@ -494,8 +496,10 @@ function ____exports.logTable(luaTable, parentTables)
                 end
             end
         end
-    )
-    ____exports.log((indentation .. "The size of the table was: ") .. tostring(#luaTable))
+    );
+    (function()
+        ____exports.log((indentation .. "The size of the table was: ") .. tostring(#luaTable))
+    end)(nil)
 end
 --- Helper function to print out the differences between the entries of two tables. Note that this
 -- will only do a shallow comparison.

package/dist/functions/mergeTests.d.ts

@@ -1,2 +1,8 @@
-export declare function mergeTests(): void;
+/**
+ * Run the suite of tests that prove that the "merge" helper function works properly. (This function
+ * is not exported but is used internally in the save data manager.)
+ *
+ * This function is only useful if you are troubleshooting the save data manager.
+ */
+export declare function runMergeTests(): void;
 //# sourceMappingURL=mergeTests.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mergeTests.d.ts","sourceRoot":"","sources":["../../src/functions/mergeTests.ts"],"names":[],"mappings":"AAQA,wBAAgB,UAAU,IAAI,IAAI,CAajC"}
+{"version":3,"file":"mergeTests.d.ts","sourceRoot":"","sources":["../../src/functions/mergeTests.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAgBpC"}

package/dist/functions/mergeTests.lua

@@ -1,5 +1,10 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local oldTableHasUpdatedValue, newTableHasSameValue, oldTableHasUpdatedValueFromNull, oldTableHasSerializedIsaacAPIClass, oldTableHasFilledInterface, oldTableHasVector, oldTableHasVectorSerialized, oldTableHasRNG, oldTableHasRNGSerialized
+local oldTableHasUpdatedValue, newTableHasSameValue, oldTableHasUpdatedValueFromNull, oldTableHasSerializedIsaacAPIClass, oldTableHasFilledChildTable, oldTableHasFilledMap, oldTableHasFilledDefaultMap, oldTableHasVector, oldTableHasVectorSerialized, oldTableHasRNG, oldTableHasRNGSerialized
+local ____DefaultMap = require("classes.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
 local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
 local ____merge = require("features.saveDataManager.merge")
@@ -60,13 +65,13 @@ function oldTableHasSerializedIsaacAPIClass(self)
         error("The \"isSerializedIsaacAPIClass\" function says that a serialized vector is not serialized.")
     end
 end
-function oldTableHasFilledInterface(self)
+function oldTableHasFilledChildTable(self)
     local key = "foo"
     local newValue = "baz"
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    merge(nil, oldTable, newTable, "oldTableHasFilledInterface")
+    merge(nil, oldTable, newTable, "oldTableHasFilledChildTable")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
         error(("The old table's key of \"" .. key) .. "\" was not filled.")
@@ -75,6 +80,74 @@ function oldTableHasFilledInterface(self)
         error("The old table's key of \"bar\" was not filled.")
     end
 end
+function oldTableHasFilledMap(self)
+    local v = {run = {myMap = __TS__New(Map)}}
+    local saveData = {run = {myMap = __TS__New(Map, {{"foo1", "bar1"}, {"foo2", "bar2"}, {"foo3", "bar3"}})}}
+    local serializedSaveData = deepCopy(nil, saveData, SerializationType.SERIALIZE)
+    merge(nil, v, serializedSaveData, "oldTableHasFilledMap")
+    local expectedSize = 3
+    if v.run.myMap.size ~= expectedSize then
+        error((("The size of the merged map was equal to " .. tostring(v.run.myMap.size)) .. ", but it should be equal to: ") .. tostring(expectedSize))
+    end
+    do
+        local key = "foo1"
+        local expectedValue = "bar1"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo2"
+        local expectedValue = "bar2"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo3"
+        local expectedValue = "bar3"
+        local value = v.run.myMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+end
+function oldTableHasFilledDefaultMap(self)
+    local v = {run = {myDefaultMap = __TS__New(DefaultMap, "default")}}
+    local saveData = {run = {myDefaultMap = __TS__New(DefaultMap, "default", {{"foo1", "bar1"}, {"foo2", "bar2"}, {"foo3", "bar3"}})}}
+    local serializedSaveData = deepCopy(nil, saveData, SerializationType.SERIALIZE)
+    merge(nil, v, serializedSaveData, "oldTableHasFilledDefaultMap")
+    local expectedSize = 3
+    if v.run.myDefaultMap.size ~= expectedSize then
+        error((("The size of the merged default map was equal to " .. tostring(v.run.myDefaultMap.size)) .. ", but it should be equal to: ") .. tostring(expectedSize))
+    end
+    do
+        local key = "foo1"
+        local expectedValue = "bar1"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo2"
+        local expectedValue = "bar2"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+    do
+        local key = "foo3"
+        local expectedValue = "bar3"
+        local value = v.run.myDefaultMap:get(key)
+        if value ~= expectedValue then
+            error((((("The old table's default map key of \"" .. key) .. "\" was not equal to \"") .. expectedValue) .. "\" and was instead equal to: ") .. tostring(value))
+        end
+    end
+end
 function oldTableHasVector(self)
     log("Starting test: oldTableHasVector")
     local key = "foo"
@@ -108,7 +181,7 @@ function oldTableHasVectorSerialized(self)
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE)
+    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE, "oldTableHasVectorSerialized")
     merge(nil, oldTable, newTableSerialized, "oldTableHasVectorSerialized")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
@@ -153,7 +226,7 @@ function oldTableHasRNGSerialized(self)
     local oldTable = {foo = nil}
     local foo = {bar = newValue}
     local newTable = {foo = foo}
-    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE)
+    local newTableSerialized = deepCopy(nil, newTable, SerializationType.SERIALIZE, "oldTableHasRNGSerialized")
     merge(nil, oldTable, newTableSerialized, "oldTableHasRNGSerialized")
     local oldTableValue = oldTable[key]
     if oldTableValue == nil then
@@ -167,12 +240,18 @@ function oldTableHasRNGSerialized(self)
         error("The old table's seed not match: " .. tostring(seed))
     end
 end
-function ____exports.mergeTests(self)
+--- Run the suite of tests that prove that the "merge" helper function works properly. (This function
+-- is not exported but is used internally in the save data manager.)
+-- 
+-- This function is only useful if you are troubleshooting the save data manager.
+function ____exports.runMergeTests(self)
     oldTableHasUpdatedValue(nil)
     newTableHasSameValue(nil)
     oldTableHasUpdatedValueFromNull(nil)
     oldTableHasSerializedIsaacAPIClass(nil)
-    oldTableHasFilledInterface(nil)
+    oldTableHasFilledChildTable(nil)
+    oldTableHasFilledMap(nil)
+    oldTableHasFilledDefaultMap(nil)
     oldTableHasVector(nil)
     oldTableHasVectorSerialized(nil)
     oldTableHasRNG(nil)

package/dist/functions/{npc.d.ts → npcs.d.ts}

@@ -18,8 +18,16 @@ export declare function fireProjectiles(npc: EntityNPC, position: Vector, veloci
  *
  * This function will not include NPCs on an internal blacklist, such as Death's scythes or Big Horn
  * holes.
+ *
+ * @param entityType Optional. If specified, will only get the NPCs that match the type. Default is
+ *                   -1, which matches every type.
+ * @param variant Optional. If specified, will only get the NPCs that match the variant. Default is
+ *                -1, which matches every variant.
+ * @param subType Optional. If specified, will only get the NPCs that match the sub-type. Default is
+ *                -1, which matches every sub-type.
+ * @param ignoreFriendly Optional. Default is false.
  */
-export declare function getAliveNPCs(matchingEntityType?: EntityType, matchingVariant?: int, matchingSubType?: int, ignoreFriendly?: boolean): EntityNPC[];
+export declare function getAliveNPCs(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): EntityNPC[];
 /**
  * Checks for specific NPCs that have "CanShutDoors" set to true naturally by the game, but should
  * not actually keep the doors closed (like Death's scythes).
@@ -38,4 +46,18 @@ export declare function isDyingEggyWithNoSpidersLeft(npc: EntityNPC): boolean;
  * enemies.
  */
 export declare function isRaglingDeathPatch(npc: EntityNPC): boolean;
-//# sourceMappingURL=npc.d.ts.map
+/**
+ * The base game `EntityNPC.FireProjectiles` method does not return anything, which is a problem in
+ * situations where you need to work with the fired projectiles. This function invokes that method,
+ * and then returns the projectiles that were spawned.
+ *
+ * @param npc The EntityNPC firing projectiles.
+ * @param position The starting position of the projectiles.
+ * @param velocity The starting velocity of the projectiles.
+ * @param projectilesMode A ProjectilesMode enum value defining how to fire the projectiles.
+ * @param projectileParams A ProjectileParams object containing various parameters for the
+ *                         projectiles.
+ * @returns An array of EntityProjectiles containing all fired projectiles.
+ */
+export declare function npcFireProjectiles(npc: EntityNPC, position: Vector, velocity: Vector, projectilesMode: ProjectilesMode, projectileParams: ProjectileParams): EntityProjectile[];
+//# sourceMappingURL=npcs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../src/functions/npcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,UAAU,EAMV,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAgCtC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,GAAE,eAAgD,EACjE,gBAAgB,GAAE,gBAAqC,GACtD,gBAAgB,EAAE,CAMpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,UAAU,GAAE,UAAe,EAC3B,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAoB3D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAO3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,GACjC,gBAAgB,EAAE,CAOpB"}