isaacscript-common 79.1.1 → 79.3.0

package/dist/functions/map.d.ts

@@ -44,6 +44,34 @@ export declare function getReversedMap<K, V>(map: ReadonlyMap<K, V>): ReadonlyMa
  * the map uses `PtrHash` as an index.
  */
 export declare function mapSetHash<V>(map: Map<PtrHash, V>, entity: Entity, value: V): void;
+/**
+ * Helper function to convert an object to a map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToReadonlyMap` function.
+ */
+export declare function objectToMap<K extends string | number | symbol, V>(object: Record<K, V>): Map<K, V>;
+/**
+ * Helper function to convert an object to a read-only map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToMap` function.
+ */
+export declare function objectToReadonlyMap<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlyMap<K, V>;
 /** Helper function to sum every value in a map together. */
 export declare function sumMap(map: Map<unknown, number> | ReadonlyMap<unknown, number>): number;
 //# sourceMappingURL=map.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/functions/map.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAOX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EACtD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,SAAS,EAAE,CAAC,GACd,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CACpB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACvD,MAAM,CAGR"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/functions/map.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAOX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EACtD,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,SAAS,EAAE,CAAC,GACd,CAAC,CAGH;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,GACP,IAAI,CAGN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAC/D,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAQX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACvE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAEnB;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CACpB,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GACvD,MAAM,CAGR"}

package/dist/functions/map.lua

@@ -2,6 +2,7 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
 local ____array = require("functions.array")
@@ -64,6 +65,40 @@ function ____exports.getReversedMap(self, map)
     end
     return reverseMap
 end
+--- Helper function to convert an object to a map.
+-- 
+-- This is useful when you need to construct a type safe object with the `satisfies` operator, but
+-- then later on you need to query it in a way where you expect the return value to be T or
+-- undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+-- assertions.
+-- 
+-- Note that the map values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectToReadonlyMap` function.
+function ____exports.objectToMap(self, object)
+    local map = __TS__New(Map)
+    for ____, ____value in ipairs(__TS__ObjectEntries(object)) do
+        local key = ____value[1]
+        local value = ____value[2]
+        map:set(key, value)
+    end
+    return map
+end
+--- Helper function to convert an object to a read-only map.
+-- 
+-- This is useful when you need to construct a type safe object with the `satisfies` operator, but
+-- then later on you need to query it in a way where you expect the return value to be T or
+-- undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+-- assertions.
+-- 
+-- Note that the map values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectToMap` function.
+function ____exports.objectToReadonlyMap(self, object)
+    return ____exports.objectToMap(nil, object)
+end
 --- Helper function to sum every value in a map together.
 function ____exports.sumMap(self, map)
     local values = {__TS__Spread(map:values())}

package/dist/functions/pickupsSpecific.d.ts

@@ -21,6 +21,14 @@ export declare function getBombPickups(bombSubType?: BombSubType | -1): EntityPi
  *                 is -1, which matches every sub-type.
  */
 export declare function getCards(cardType?: CardType | -1): EntityPickupCard[];
+/**
+ * Helper function to get all of the chest entities in the room. Specifically, this is all of the
+ * pickups with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only get the chests that match the sub-type. Default
+ *                is -1, which matches every sub-type.
+ */
+export declare function getChests(subType?: number): EntityPickup[];
 /**
  * Helper function to get all of the coin pickup entities in the room.
  *
@@ -98,6 +106,16 @@ export declare function removeAllBombPickups(bombSubType?: BombSubType | -1, cap
  * @returns The cards that were removed.
  */
 export declare function removeAllCards(cardType?: CardType | -1, cap?: int): EntityPickupCard[];
+/**
+ * Helper function to remove all of the chests in the room. Specifically, this is all of the pickups
+ * with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only remove chests that match this sub-type. Default
+ *                is -1, which matches every sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of chests.
+ * @returns The chests that were removed.
+ */
+export declare function removeAllChests(subType?: number, cap?: int): EntityPickup[];
 /**
  * Helper function to remove all of the coins in the room.
  *

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

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

package/dist/functions/pickupsSpecific.lua

@@ -1,8 +1,13 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayPushArray = ____lualib.__TS__ArrayPushArray
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
 local ____constants = require("core.constants")
+local CHEST_PICKUP_VARIANTS = ____constants.CHEST_PICKUP_VARIANTS
 local VectorZero = ____constants.VectorZero
+local ____entities = require("functions.entities")
+local removeEntities = ____entities.removeEntities
 local ____entitiesSpecific = require("functions.entitiesSpecific")
 local getPickups = ____entitiesSpecific.getPickups
 local removeAllPickups = ____entitiesSpecific.removeAllPickups
@@ -38,6 +43,22 @@ function ____exports.getCards(self, cardType)
     end
     return getPickups(nil, PickupVariant.CARD, cardType)
 end
+--- Helper function to get all of the chest entities in the room. Specifically, this is all of the
+-- pickups with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+-- 
+-- @param subType Optional. If specified, will only get the chests that match the sub-type. Default
+-- is -1, which matches every sub-type.
+function ____exports.getChests(self, subType)
+    if subType == nil then
+        subType = -1
+    end
+    local chests = {}
+    for ____, pickupVariant in ipairs(CHEST_PICKUP_VARIANTS) do
+        local pickups = getPickups(nil, pickupVariant, subType)
+        __TS__ArrayPushArray(chests, pickups)
+    end
+    return chests
+end
 --- Helper function to get all of the coin pickup entities in the room.
 -- 
 -- @param coinSubType Optional. If specified, will only get the coins that match the sub-type.
@@ -145,6 +166,20 @@ function ____exports.removeAllCards(self, cardType, cap)
     end
     return removeAllPickups(nil, PickupVariant.CARD, cardType, cap)
 end
+--- Helper function to remove all of the chests in the room. Specifically, this is all of the pickups
+-- with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+-- 
+-- @param subType Optional. If specified, will only remove chests that match this sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of chests.
+-- @returns The chests that were removed.
+function ____exports.removeAllChests(self, subType, cap)
+    if subType == nil then
+        subType = -1
+    end
+    local chests = ____exports.getChests(nil, subType)
+    return removeEntities(nil, chests, cap)
+end
 --- Helper function to remove all of the coins in the room.
 -- 
 -- @param coinSubType Optional. If specified, will only remove coins that match this sub-type.

package/dist/index.rollup.d.ts

@@ -5322,6 +5322,15 @@ export declare function getChargesAwayFromMax(player: EntityPlayer, activeSlot?:
  */
 export declare function getChestName(pickupVariant: PickupVariant): string;
 
+/**
+ * Helper function to get all of the chest entities in the room. Specifically, this is all of the
+ * pickups with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only get the chests that match the sub-type. Default
+ *                is -1, which matches every sub-type.
+ */
+export declare function getChests(subType?: number): EntityPickup[];
+
 /**
  * Helper function to get an array of equidistant points on the circumference around a circle.
  * Useful for equally distributing things in a circle pattern.
@@ -14889,6 +14898,36 @@ export declare const NUM_VANILLA_PILL_EFFECTS: int;
 /** Calculated from the `TrinketType` enum. (`TrinketType.NULL` is not included.) */
 export declare const NUM_VANILLA_TRINKET_TYPES: number;
 
+/**
+ * Helper function to convert an object to a map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToReadonlyMap` function.
+ */
+export declare function objectToMap<K extends string | number | symbol, V>(object: Record<K, V>): Map<K, V>;
+
+/**
+ * Helper function to convert an object to a read-only map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToMap` function.
+ */
+export declare function objectToReadonlyMap<K extends string | number | symbol, V>(object: Record<K, V>): ReadonlyMap<K, V>;
+
 /** Helper function to see if the player is playing any challenge. */
 export declare function onAnyChallenge(): boolean;
 
@@ -15986,6 +16025,17 @@ export declare function removeAllCards(cardType?: CardType | -1, cap?: int): Ent
 
 export declare function removeAllCharacters(string: string, character: string): string;
 
+/**
+ * Helper function to remove all of the chests in the room. Specifically, this is all of the pickups
+ * with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only remove chests that match this sub-type. Default
+ *                is -1, which matches every sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of chests.
+ * @returns The chests that were removed.
+ */
+export declare function removeAllChests(subType?: number, cap?: int): EntityPickup[];
+
 /**
  * Helper function to remove all of the coins in the room.
  *

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 79.1.0
+isaacscript-common 79.2.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -45920,11 +45920,16 @@ ____exports.RED_HEART_SUB_TYPES_SET = __TS__New(ReadonlySet, {HeartSubType.FULL,
 return ____exports
  end,
 ["functions.pickupsSpecific"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayPushArray = ____lualib.__TS__ArrayPushArray
 local ____exports = {}
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.index")
 local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
 local ____constants = require("core.constants")
+local CHEST_PICKUP_VARIANTS = ____constants.CHEST_PICKUP_VARIANTS
 local VectorZero = ____constants.VectorZero
+local ____entities = require("functions.entities")
+local removeEntities = ____entities.removeEntities
 local ____entitiesSpecific = require("functions.entitiesSpecific")
 local getPickups = ____entitiesSpecific.getPickups
 local removeAllPickups = ____entitiesSpecific.removeAllPickups
@@ -45960,6 +45965,22 @@ function ____exports.getCards(self, cardType)
     end
     return getPickups(nil, PickupVariant.CARD, cardType)
 end
+--- Helper function to get all of the chest entities in the room. Specifically, this is all of the
+-- pickups with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+-- 
+-- @param subType Optional. If specified, will only get the chests that match the sub-type. Default
+-- is -1, which matches every sub-type.
+function ____exports.getChests(self, subType)
+    if subType == nil then
+        subType = -1
+    end
+    local chests = {}
+    for ____, pickupVariant in ipairs(CHEST_PICKUP_VARIANTS) do
+        local pickups = getPickups(nil, pickupVariant, subType)
+        __TS__ArrayPushArray(chests, pickups)
+    end
+    return chests
+end
 --- Helper function to get all of the coin pickup entities in the room.
 -- 
 -- @param coinSubType Optional. If specified, will only get the coins that match the sub-type.
@@ -46067,6 +46088,20 @@ function ____exports.removeAllCards(self, cardType, cap)
     end
     return removeAllPickups(nil, PickupVariant.CARD, cardType, cap)
 end
+--- Helper function to remove all of the chests in the room. Specifically, this is all of the pickups
+-- with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+-- 
+-- @param subType Optional. If specified, will only remove chests that match this sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param cap Optional. If specified, will only remove the given amount of chests.
+-- @returns The chests that were removed.
+function ____exports.removeAllChests(self, subType, cap)
+    if subType == nil then
+        subType = -1
+    end
+    local chests = ____exports.getChests(nil, subType)
+    return removeEntities(nil, chests, cap)
+end
 --- Helper function to remove all of the coins in the room.
 -- 
 -- @param coinSubType Optional. If specified, will only remove coins that match this sub-type.
@@ -46834,6 +46869,7 @@ local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__Spread = ____lualib.__TS__Spread
 local ____exports = {}
 local ____array = require("functions.array")
@@ -46896,6 +46932,40 @@ function ____exports.getReversedMap(self, map)
     end
     return reverseMap
 end
+--- Helper function to convert an object to a map.
+-- 
+-- This is useful when you need to construct a type safe object with the `satisfies` operator, but
+-- then later on you need to query it in a way where you expect the return value to be T or
+-- undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+-- assertions.
+-- 
+-- Note that the map values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectToReadonlyMap` function.
+function ____exports.objectToMap(self, object)
+    local map = __TS__New(Map)
+    for ____, ____value in ipairs(__TS__ObjectEntries(object)) do
+        local key = ____value[1]
+        local value = ____value[2]
+        map:set(key, value)
+    end
+    return map
+end
+--- Helper function to convert an object to a read-only map.
+-- 
+-- This is useful when you need to construct a type safe object with the `satisfies` operator, but
+-- then later on you need to query it in a way where you expect the return value to be T or
+-- undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+-- assertions.
+-- 
+-- Note that the map values will be inserted in a random order, due to how `pairs` works under the
+-- hood.
+-- 
+-- Also see the `objectToMap` function.
+function ____exports.objectToReadonlyMap(self, object)
+    return ____exports.objectToMap(nil, object)
+end
 --- Helper function to sum every value in a map together.
 function ____exports.sumMap(self, map)
     local values = {__TS__Spread(map:values())}

package/package.json

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

package/src/functions/map.ts

@@ -89,6 +89,50 @@ export function mapSetHash<V>(
   map.set(hash, value);
 }
 
+/**
+ * Helper function to convert an object to a map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToReadonlyMap` function.
+ */
+export function objectToMap<K extends string | number | symbol, V>(
+  object: Record<K, V>,
+): Map<K, V> {
+  const map = new Map<K, V>();
+
+  for (const [key, value] of Object.entries(object)) {
+    map.set(key as K, value as V);
+  }
+
+  return map;
+}
+
+/**
+ * Helper function to convert an object to a read-only map.
+ *
+ * This is useful when you need to construct a type safe object with the `satisfies` operator, but
+ * then later on you need to query it in a way where you expect the return value to be T or
+ * undefined. In this situation, by converting the object to a map, you can avoid unsafe type
+ * assertions.
+ *
+ * Note that the map values will be inserted in a random order, due to how `pairs` works under the
+ * hood.
+ *
+ * Also see the `objectToMap` function.
+ */
+export function objectToReadonlyMap<K extends string | number | symbol, V>(
+  object: Record<K, V>,
+): ReadonlyMap<K, V> {
+  return objectToMap(object);
+}
+
 /** Helper function to sum every value in a map together. */
 export function sumMap(
   map: Map<unknown, number> | ReadonlyMap<unknown, number>,

package/src/functions/pickupsSpecific.ts

@@ -11,7 +11,8 @@ import type {
   TrinketType,
 } from "isaac-typescript-definitions";
 import { PickupVariant } from "isaac-typescript-definitions";
-import { VectorZero } from "../core/constants";
+import { CHEST_PICKUP_VARIANTS, VectorZero } from "../core/constants";
+import { removeEntities } from "./entities";
 import { getPickups, removeAllPickups, spawnPickup } from "./entitiesSpecific";
 
 /**
@@ -52,6 +53,24 @@ export function getCards(cardType: CardType | -1 = -1): EntityPickupCard[] {
   return getPickups(PickupVariant.CARD, cardType) as EntityPickupCard[];
 }
 
+/**
+ * Helper function to get all of the chest entities in the room. Specifically, this is all of the
+ * pickups with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only get the chests that match the sub-type. Default
+ *                is -1, which matches every sub-type.
+ */
+export function getChests(subType = -1): EntityPickup[] {
+  const chests: EntityPickup[] = [];
+
+  for (const pickupVariant of CHEST_PICKUP_VARIANTS) {
+    const pickups = getPickups(pickupVariant, subType);
+    chests.push(...pickups);
+  }
+
+  return chests;
+}
+
 /**
  * Helper function to get all of the coin pickup entities in the room.
  *
@@ -196,6 +215,20 @@ export function removeAllCards(
   ) as EntityPickupCard[];
 }
 
+/**
+ * Helper function to remove all of the chests in the room. Specifically, this is all of the pickups
+ * with a variant in the `CHEST_PICKUP_VARIANTS` constant.
+ *
+ * @param subType Optional. If specified, will only remove chests that match this sub-type. Default
+ *                is -1, which matches every sub-type.
+ * @param cap Optional. If specified, will only remove the given amount of chests.
+ * @returns The chests that were removed.
+ */
+export function removeAllChests(subType = -1, cap?: int): EntityPickup[] {
+  const chests = getChests(subType);
+  return removeEntities(chests, cap);
+}
+
 /**
  * Helper function to remove all of the coins in the room.
  *