isaacscript-common 20.17.0 → 20.18.1

package/dist/index.d.ts

@@ -3269,6 +3269,16 @@ declare class DisableInputs extends Feature {
 /** This is also the distance that a player spawns from the door that they enter a room from. */
 export declare const DISTANCE_OF_GRID_TILE = 40;
 
+/**
+ * Helper function to check if one or more matching entities exist in the current room. It uses the
+ * `doesEntityExist` helper function to determine this.
+ *
+ * @param entityTypes An array or set of the entity types that you want to check for. Will return
+ *                    true if any of the provided entity types exist.
+ * @param ignoreFriendly Optional. Default is false.
+ */
+export declare function doesAnyEntityExist(entityTypes: EntityType[] | readonly EntityType[] | Set<EntityType> | ReadonlySet<EntityType>, ignoreFriendly?: boolean): boolean;
+
 /**
  * Helper function to check if one or more of a specific kind of entity is present in the current
  * room. It uses the `countEntities` helper function to determine this.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.17.0
+isaacscript-common 20.18.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -19715,13 +19715,167 @@ function ____exports.spriteEquals(self, sprite1, sprite2, layerID, xStart, xFini
     end
     return true
 end
+return ____exports
+ end,
+["src.classes.DefaultMap"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local Map = ____lualib.Map
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____types = require("src.functions.types")
+local isFunction = ____types.isFunction
+local isPrimitive = ____types.isPrimitive
+____exports.DefaultMap = __TS__Class()
+local DefaultMap = ____exports.DefaultMap
+DefaultMap.name = "DefaultMap"
+__TS__ClassExtends(DefaultMap, Map)
+function DefaultMap.prototype.____constructor(self, defaultValueOrFactoryFunction, initializerArray)
+    local argIsPrimitive = isPrimitive(nil, defaultValueOrFactoryFunction)
+    local argIsFunction = isFunction(nil, defaultValueOrFactoryFunction)
+    if not argIsPrimitive and not argIsFunction then
+        error(("Failed to instantiate a DefaultMap since the provided default value was of type \"" .. __TS__TypeOf(defaultValueOrFactoryFunction)) .. "\". This error usually means that you are trying to use an array (or some other non-primitive data structure that is passed by reference) as the default value. Instead, return the data structure in a factory function, like \"() => []\". See the DefaultMap documentation for more details.")
+    end
+    Map.prototype.____constructor(self, initializerArray)
+    if argIsFunction then
+        self.defaultValue = nil
+        self.defaultValueFactory = defaultValueOrFactoryFunction
+    else
+        self.defaultValue = defaultValueOrFactoryFunction
+        self.defaultValueFactory = nil
+    end
+end
+function DefaultMap.prototype.getAndSetDefault(self, key, ...)
+    local value = Map.prototype.get(self, key)
+    if value ~= nil then
+        return value
+    end
+    local defaultValue = self:getDefaultValue(...)
+    self:set(key, defaultValue)
+    return defaultValue
+end
+function DefaultMap.prototype.getDefaultValue(self, ...)
+    if self.defaultValue ~= nil then
+        return self.defaultValue
+    end
+    if self.defaultValueFactory ~= nil then
+        return self:defaultValueFactory(...)
+    end
+    error("A DefaultMap was incorrectly instantiated.")
+end
+function DefaultMap.prototype.getConstructorArg(self)
+    if self.defaultValue ~= nil then
+        return self.defaultValue
+    end
+    if self.defaultValueFactory ~= nil then
+        return self.defaultValueFactory
+    end
+    error("A DefaultMap was incorrectly instantiated.")
+end
+local function test(self)
+    local myDefaultMapBoolean = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapBooleanFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return false end
+    )
+    local myDefaultMapBooleanWithoutParams = __TS__New(____exports.DefaultMap, false)
+    local myDefaultMapNumber = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapNumberFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return 123 end
+    )
+    local myDefaultMapNumberWithoutParams = __TS__New(____exports.DefaultMap, 123)
+    local myDefaultMapString = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapStringFactory = __TS__New(
+        ____exports.DefaultMap,
+        function() return "foo" end
+    )
+    local myDefaultMapStringWithoutParams = __TS__New(____exports.DefaultMap, "foo")
+    local myDefaultMapArray = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapArrayWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return {} end
+    )
+    local myDefaultMapMap = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+    local myDefaultMapMapWithoutParams = __TS__New(
+        ____exports.DefaultMap,
+        function() return __TS__New(Map) end
+    )
+end
+return ____exports
+ end,
+["src.interfaces.TSTLClassMetatable"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["src.types.TSTLClass"] = function(...) 
+local ____exports = {}
+return ____exports
+ end,
+["src.functions.tstlClass"] = function(...) 
+local ____exports = {}
+local ____types = require("src.functions.types")
+local isTable = ____types.isTable
+function ____exports.getTSTLClassConstructor(self, object)
+    if not isTable(nil, object) then
+        return nil
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return nil
+    end
+    return metatable.constructor
+end
+function ____exports.getTSTLClassName(self, object)
+    local constructor = ____exports.getTSTLClassConstructor(nil, object)
+    if constructor == nil then
+        return nil
+    end
+    return constructor.name
+end
+function ____exports.isDefaultMap(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "DefaultMap"
+end
+function ____exports.isTSTLClass(self, object)
+    local tstlClassName = ____exports.getTSTLClassName(nil, object)
+    return tstlClassName ~= nil
+end
+function ____exports.isTSTLMap(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "Map"
+end
+function ____exports.isTSTLSet(self, object)
+    local className = ____exports.getTSTLClassName(nil, object)
+    return className == "Set"
+end
+function ____exports.newTSTLClass(self, oldClass)
+    local constructor = ____exports.getTSTLClassConstructor(nil, oldClass)
+    if constructor == nil then
+        error("Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable/constructor.")
+    end
+    local newClass = {}
+    local newClassMetatable = setmetatable(newClass, constructor.prototype)
+    newClassMetatable:____constructor()
+    return newClass
+end
 return ____exports
  end,
 ["src.functions.entities"] = function(...) 
 local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__StringSplit = ____lualib.__TS__StringSplit
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
-local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
@@ -19743,6 +19897,8 @@ local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____sprites = require("src.functions.sprites")
 local setSpriteOpacity = ____sprites.setSpriteOpacity
+local ____tstlClass = require("src.functions.tstlClass")
+local isTSTLSet = ____tstlClass.isTSTLSet
 local ____types = require("src.functions.types")
 local asNumber = ____types.asNumber
 local isPrimitive = ____types.isPrimitive
@@ -19750,44 +19906,6 @@ local ____vector = require("src.functions.vector")
 local doesVectorHaveLength = ____vector.doesVectorHaveLength
 local isVector = ____vector.isVector
 local vectorToString = ____vector.vectorToString
-function setPrimitiveEntityFields(self, entity, metatable, entityFields)
-    local propGetTable = metatable.__propget
-    if propGetTable == nil then
-        error("Failed to get the \"__propget\" table for an entity.")
-    end
-    for key in pairs(propGetTable) do
-        local indexKey = key
-        local value = entity[indexKey]
-        if isPrimitive(nil, value) then
-            entityFields[indexKey] = value
-        elseif isVector(nil, value) then
-            entityFields[indexKey] = vectorToString(nil, value)
-        end
-    end
-end
-function ____exports.removeEntities(self, entities, cap)
-    if #entities == 0 then
-        return {}
-    end
-    local entitiesRemoved = {}
-    for ____, entity in ipairs(entities) do
-        entity:Remove()
-        entitiesRemoved[#entitiesRemoved + 1] = entity
-        if cap ~= nil and #entitiesRemoved >= cap then
-            break
-        end
-    end
-    return entitiesRemoved
-end
-local DAMAGE_FLASH_COLOR = Color(
-    0.5,
-    0.5,
-    0.5,
-    1,
-    200 / 255,
-    0 / 255,
-    0 / 255
-)
 function ____exports.countEntities(self, entityType, variant, subType, ignoreFriendly)
     if entityType == nil then
         entityType = -1
@@ -19835,6 +19953,60 @@ function ____exports.doesEntityExist(self, entityType, variant, subType, ignoreF
     )
     return count > 0
 end
+function setPrimitiveEntityFields(self, entity, metatable, entityFields)
+    local propGetTable = metatable.__propget
+    if propGetTable == nil then
+        error("Failed to get the \"__propget\" table for an entity.")
+    end
+    for key in pairs(propGetTable) do
+        local indexKey = key
+        local value = entity[indexKey]
+        if isPrimitive(nil, value) then
+            entityFields[indexKey] = value
+        elseif isVector(nil, value) then
+            entityFields[indexKey] = vectorToString(nil, value)
+        end
+    end
+end
+function ____exports.removeEntities(self, entities, cap)
+    if #entities == 0 then
+        return {}
+    end
+    local entitiesRemoved = {}
+    for ____, entity in ipairs(entities) do
+        entity:Remove()
+        entitiesRemoved[#entitiesRemoved + 1] = entity
+        if cap ~= nil and #entitiesRemoved >= cap then
+            break
+        end
+    end
+    return entitiesRemoved
+end
+local DAMAGE_FLASH_COLOR = Color(
+    0.5,
+    0.5,
+    0.5,
+    1,
+    200 / 255,
+    0 / 255,
+    0 / 255
+)
+function ____exports.doesAnyEntityExist(self, entityTypes, ignoreFriendly)
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local entityTypesArray = isTSTLSet(nil, entityTypes) and ({__TS__Spread(entityTypes:values())}) or entityTypes
+    return __TS__ArraySome(
+        entityTypesArray,
+        function(____, entityType) return ____exports.doesEntityExist(
+            nil,
+            entityType,
+            -1,
+            -1,
+            ignoreFriendly
+        ) end
+    )
+end
 function ____exports.getClosestEntityTo(self, referenceEntity, entities, filterFunc)
     local closestEntity
     local closestDistance = math.huge
@@ -20415,158 +20587,6 @@ function ____exports.setToBitFlags(self, set)
     end
     return flags
 end
-return ____exports
- end,
-["src.classes.DefaultMap"] = function(...) 
-local ____lualib = require("lualib_bundle")
-local __TS__Class = ____lualib.__TS__Class
-local Map = ____lualib.Map
-local __TS__ClassExtends = ____lualib.__TS__ClassExtends
-local __TS__TypeOf = ____lualib.__TS__TypeOf
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local ____types = require("src.functions.types")
-local isFunction = ____types.isFunction
-local isPrimitive = ____types.isPrimitive
-____exports.DefaultMap = __TS__Class()
-local DefaultMap = ____exports.DefaultMap
-DefaultMap.name = "DefaultMap"
-__TS__ClassExtends(DefaultMap, Map)
-function DefaultMap.prototype.____constructor(self, defaultValueOrFactoryFunction, initializerArray)
-    local argIsPrimitive = isPrimitive(nil, defaultValueOrFactoryFunction)
-    local argIsFunction = isFunction(nil, defaultValueOrFactoryFunction)
-    if not argIsPrimitive and not argIsFunction then
-        error(("Failed to instantiate a DefaultMap since the provided default value was of type \"" .. __TS__TypeOf(defaultValueOrFactoryFunction)) .. "\". This error usually means that you are trying to use an array (or some other non-primitive data structure that is passed by reference) as the default value. Instead, return the data structure in a factory function, like \"() => []\". See the DefaultMap documentation for more details.")
-    end
-    Map.prototype.____constructor(self, initializerArray)
-    if argIsFunction then
-        self.defaultValue = nil
-        self.defaultValueFactory = defaultValueOrFactoryFunction
-    else
-        self.defaultValue = defaultValueOrFactoryFunction
-        self.defaultValueFactory = nil
-    end
-end
-function DefaultMap.prototype.getAndSetDefault(self, key, ...)
-    local value = Map.prototype.get(self, key)
-    if value ~= nil then
-        return value
-    end
-    local defaultValue = self:getDefaultValue(...)
-    self:set(key, defaultValue)
-    return defaultValue
-end
-function DefaultMap.prototype.getDefaultValue(self, ...)
-    if self.defaultValue ~= nil then
-        return self.defaultValue
-    end
-    if self.defaultValueFactory ~= nil then
-        return self:defaultValueFactory(...)
-    end
-    error("A DefaultMap was incorrectly instantiated.")
-end
-function DefaultMap.prototype.getConstructorArg(self)
-    if self.defaultValue ~= nil then
-        return self.defaultValue
-    end
-    if self.defaultValueFactory ~= nil then
-        return self.defaultValueFactory
-    end
-    error("A DefaultMap was incorrectly instantiated.")
-end
-local function test(self)
-    local myDefaultMapBoolean = __TS__New(____exports.DefaultMap, false)
-    local myDefaultMapBooleanFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return false end
-    )
-    local myDefaultMapBooleanWithoutParams = __TS__New(____exports.DefaultMap, false)
-    local myDefaultMapNumber = __TS__New(____exports.DefaultMap, 123)
-    local myDefaultMapNumberFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return 123 end
-    )
-    local myDefaultMapNumberWithoutParams = __TS__New(____exports.DefaultMap, 123)
-    local myDefaultMapString = __TS__New(____exports.DefaultMap, "foo")
-    local myDefaultMapStringFactory = __TS__New(
-        ____exports.DefaultMap,
-        function() return "foo" end
-    )
-    local myDefaultMapStringWithoutParams = __TS__New(____exports.DefaultMap, "foo")
-    local myDefaultMapArray = __TS__New(
-        ____exports.DefaultMap,
-        function() return {} end
-    )
-    local myDefaultMapArrayWithoutParams = __TS__New(
-        ____exports.DefaultMap,
-        function() return {} end
-    )
-    local myDefaultMapMap = __TS__New(
-        ____exports.DefaultMap,
-        function() return __TS__New(Map) end
-    )
-    local myDefaultMapMapWithoutParams = __TS__New(
-        ____exports.DefaultMap,
-        function() return __TS__New(Map) end
-    )
-end
-return ____exports
- end,
-["src.interfaces.TSTLClassMetatable"] = function(...) 
-local ____exports = {}
-return ____exports
- end,
-["src.types.TSTLClass"] = function(...) 
-local ____exports = {}
-return ____exports
- end,
-["src.functions.tstlClass"] = function(...) 
-local ____exports = {}
-local ____types = require("src.functions.types")
-local isTable = ____types.isTable
-function ____exports.getTSTLClassConstructor(self, object)
-    if not isTable(nil, object) then
-        return nil
-    end
-    local metatable = getmetatable(object)
-    if metatable == nil then
-        return nil
-    end
-    return metatable.constructor
-end
-function ____exports.getTSTLClassName(self, object)
-    local constructor = ____exports.getTSTLClassConstructor(nil, object)
-    if constructor == nil then
-        return nil
-    end
-    return constructor.name
-end
-function ____exports.isDefaultMap(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "DefaultMap"
-end
-function ____exports.isTSTLClass(self, object)
-    local tstlClassName = ____exports.getTSTLClassName(nil, object)
-    return tstlClassName ~= nil
-end
-function ____exports.isTSTLMap(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "Map"
-end
-function ____exports.isTSTLSet(self, object)
-    local className = ____exports.getTSTLClassName(nil, object)
-    return className == "Set"
-end
-function ____exports.newTSTLClass(self, oldClass)
-    local constructor = ____exports.getTSTLClassConstructor(nil, oldClass)
-    if constructor == nil then
-        error("Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable/constructor.")
-    end
-    local newClass = {}
-    local newClassMetatable = setmetatable(newClass, constructor.prototype)
-    newClassMetatable:____constructor()
-    return newClass
-end
 return ____exports
  end,
 ["src.functions.doors"] = function(...) 

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

@@ -13,6 +13,15 @@ import { EntityID } from "../types/EntityID";
  * @param ignoreFriendly Optional. Default is false.
  */
 export declare function countEntities(entityType?: EntityType, variant?: number, subType?: number, ignoreFriendly?: boolean): int;
+/**
+ * Helper function to check if one or more matching entities exist in the current room. It uses the
+ * `doesEntityExist` helper function to determine this.
+ *
+ * @param entityTypes An array or set of the entity types that you want to check for. Will return
+ *                    true if any of the provided entity types exist.
+ * @param ignoreFriendly Optional. Default is false.
+ */
+export declare function doesAnyEntityExist(entityTypes: EntityType[] | readonly EntityType[] | Set<EntityType> | ReadonlySet<EntityType>, ignoreFriendly?: boolean): boolean;
 /**
  * Helper function to check if one or more of a specific kind of entity is present in the current
  * room. It uses the `countEntities` helper function to determine this.

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

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

package/dist/src/functions/entities.lua

@@ -1,7 +1,9 @@
 local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__StringSplit = ____lualib.__TS__StringSplit
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
-local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
 local ____exports = {}
@@ -23,6 +25,8 @@ local isRNG = ____rng.isRNG
 local newRNG = ____rng.newRNG
 local ____sprites = require("src.functions.sprites")
 local setSpriteOpacity = ____sprites.setSpriteOpacity
+local ____tstlClass = require("src.functions.tstlClass")
+local isTSTLSet = ____tstlClass.isTSTLSet
 local ____types = require("src.functions.types")
 local asNumber = ____types.asNumber
 local isPrimitive = ____types.isPrimitive
@@ -30,50 +34,6 @@ local ____vector = require("src.functions.vector")
 local doesVectorHaveLength = ____vector.doesVectorHaveLength
 local isVector = ____vector.isVector
 local vectorToString = ____vector.vectorToString
-function setPrimitiveEntityFields(self, entity, metatable, entityFields)
-    local propGetTable = metatable.__propget
-    if propGetTable == nil then
-        error("Failed to get the \"__propget\" table for an entity.")
-    end
-    for key in pairs(propGetTable) do
-        local indexKey = key
-        local value = entity[indexKey]
-        if isPrimitive(nil, value) then
-            entityFields[indexKey] = value
-        elseif isVector(nil, value) then
-            entityFields[indexKey] = vectorToString(nil, value)
-        end
-    end
-end
---- Helper function to remove all of the entities in the supplied array.
--- 
--- @param entities The array of entities to remove.
--- @param cap Optional. If specified, will only remove the given amount of entities.
--- @returns An array of the entities that were removed.
-function ____exports.removeEntities(self, entities, cap)
-    if #entities == 0 then
-        return {}
-    end
-    local entitiesRemoved = {}
-    for ____, entity in ipairs(entities) do
-        entity:Remove()
-        entitiesRemoved[#entitiesRemoved + 1] = entity
-        if cap ~= nil and #entitiesRemoved >= cap then
-            break
-        end
-    end
-    return entitiesRemoved
-end
---- From DeadInfinity.
-local DAMAGE_FLASH_COLOR = Color(
-    0.5,
-    0.5,
-    0.5,
-    1,
-    200 / 255,
-    0 / 255,
-    0 / 255
-)
 --- Helper function to count the number of entities in room. Use this over the vanilla
 -- `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
 -- enemies.
@@ -136,6 +96,72 @@ function ____exports.doesEntityExist(self, entityType, variant, subType, ignoreF
     )
     return count > 0
 end
+function setPrimitiveEntityFields(self, entity, metatable, entityFields)
+    local propGetTable = metatable.__propget
+    if propGetTable == nil then
+        error("Failed to get the \"__propget\" table for an entity.")
+    end
+    for key in pairs(propGetTable) do
+        local indexKey = key
+        local value = entity[indexKey]
+        if isPrimitive(nil, value) then
+            entityFields[indexKey] = value
+        elseif isVector(nil, value) then
+            entityFields[indexKey] = vectorToString(nil, value)
+        end
+    end
+end
+--- Helper function to remove all of the entities in the supplied array.
+-- 
+-- @param entities The array of entities to remove.
+-- @param cap Optional. If specified, will only remove the given amount of entities.
+-- @returns An array of the entities that were removed.
+function ____exports.removeEntities(self, entities, cap)
+    if #entities == 0 then
+        return {}
+    end
+    local entitiesRemoved = {}
+    for ____, entity in ipairs(entities) do
+        entity:Remove()
+        entitiesRemoved[#entitiesRemoved + 1] = entity
+        if cap ~= nil and #entitiesRemoved >= cap then
+            break
+        end
+    end
+    return entitiesRemoved
+end
+--- From DeadInfinity.
+local DAMAGE_FLASH_COLOR = Color(
+    0.5,
+    0.5,
+    0.5,
+    1,
+    200 / 255,
+    0 / 255,
+    0 / 255
+)
+--- Helper function to check if one or more matching entities exist in the current room. It uses the
+-- `doesEntityExist` helper function to determine this.
+-- 
+-- @param entityTypes An array or set of the entity types that you want to check for. Will return
+-- true if any of the provided entity types exist.
+-- @param ignoreFriendly Optional. Default is false.
+function ____exports.doesAnyEntityExist(self, entityTypes, ignoreFriendly)
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local entityTypesArray = isTSTLSet(nil, entityTypes) and ({__TS__Spread(entityTypes:values())}) or entityTypes
+    return __TS__ArraySome(
+        entityTypesArray,
+        function(____, entityType) return ____exports.doesEntityExist(
+            nil,
+            entityType,
+            -1,
+            -1,
+            ignoreFriendly
+        ) end
+    )
+end
 --- Given an array of entities, this helper function returns the closest one to a provided reference
 -- entity.
 -- 

package/package.json

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

package/src/functions/entities.ts

@@ -9,6 +9,7 @@ import { getIsaacAPIClassName } from "./isaacAPIClass";
 import { getRandom } from "./random";
 import { isRNG, newRNG } from "./rng";
 import { setSpriteOpacity } from "./sprites";
+import { isTSTLSet } from "./tstlClass";
 import { asNumber, isPrimitive } from "./types";
 import { doesVectorHaveLength, isVector, vectorToString } from "./vector";
 
@@ -54,6 +55,31 @@ export function countEntities(
   return entities.length;
 }
 
+/**
+ * Helper function to check if one or more matching entities exist in the current room. It uses the
+ * `doesEntityExist` helper function to determine this.
+ *
+ * @param entityTypes An array or set of the entity types that you want to check for. Will return
+ *                    true if any of the provided entity types exist.
+ * @param ignoreFriendly Optional. Default is false.
+ */
+export function doesAnyEntityExist(
+  entityTypes:
+    | EntityType[]
+    | readonly EntityType[]
+    | Set<EntityType>
+    | ReadonlySet<EntityType>,
+  ignoreFriendly = false,
+): boolean {
+  const entityTypesArray = isTSTLSet(entityTypes)
+    ? [...entityTypes.values()]
+    : (entityTypes as EntityType[]);
+
+  return entityTypesArray.some((entityType) =>
+    doesEntityExist(entityType, -1, -1, ignoreFriendly),
+  );
+}
+
 /**
  * Helper function to check if one or more of a specific kind of entity is present in the current
  * room. It uses the `countEntities` helper function to determine this.