isaacscript-common 51.10.0 → 51.11.0

package/dist/index.rollup.d.ts

@@ -7781,6 +7781,14 @@ export declare function getUnusedDoorSlots(): DoorSlot[];
  */
 export declare function getUsableActiveItemSlots(player: EntityPlayer, collectibleType: CollectibleType): ActiveSlot[];
 
+/**
+ * Returns a set containing every vanilla collectible type with the given quality.
+ *
+ * Note that this function will only return vanilla collectible types. To handle modded collectible
+ * types, use the `getCollectibleTypesOfQuality` helper function instead.
+ */
+export declare function getVanillaCollectibleTypesOfQuality(quality: Quality): ReadonlySet<CollectibleType>;
+
 /**
  * Helper function to get the set of grid indexes that represent where the walls are supposed to be
  * in a given room shape.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 51.10.0
+isaacscript-common 51.11.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -23054,6 +23054,73 @@ function PostHolyMantleRemoved.prototype.____constructor(self)
     end
     self.customCallbacksUsed = {{ModCallbackCustom.POST_PEFFECT_UPDATE_REORDERED, self.postPEffectUpdateReordered}}
 end
+return ____exports
+ end,
+["src.core.constantsVanilla"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____types = require("src.functions.types")
+local asCardType = ____types.asCardType
+local asCollectibleType = ____types.asCollectibleType
+local asPillEffect = ____types.asPillEffect
+local asTrinketType = ____types.asTrinketType
+local ____utils = require("src.functions.utils")
+local iRange = ____utils.iRange
+local ____ReadonlySet = require("src.types.ReadonlySet")
+local ReadonlySet = ____ReadonlySet.ReadonlySet
+local ____cachedClasses = require("src.core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____constantsFirstLast = require("src.core.constantsFirstLast")
+local FIRST_CARD_TYPE = ____constantsFirstLast.FIRST_CARD_TYPE
+local FIRST_COLLECTIBLE_TYPE = ____constantsFirstLast.FIRST_COLLECTIBLE_TYPE
+local FIRST_PILL_EFFECT = ____constantsFirstLast.FIRST_PILL_EFFECT
+local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
+local LAST_VANILLA_CARD_TYPE = ____constantsFirstLast.LAST_VANILLA_CARD_TYPE
+local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
+local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
+local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
+____exports.VANILLA_COLLECTIBLE_TYPE_RANGE = iRange(nil, FIRST_COLLECTIBLE_TYPE, LAST_VANILLA_COLLECTIBLE_TYPE)
+____exports.VANILLA_COLLECTIBLE_TYPES = __TS__ArrayFilter(
+    ____exports.VANILLA_COLLECTIBLE_TYPE_RANGE,
+    function(____, potentialCollectibleType)
+        local collectibleType = asCollectibleType(nil, potentialCollectibleType)
+        local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+        return itemConfigItem ~= nil
+    end
+)
+____exports.VANILLA_COLLECTIBLE_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_COLLECTIBLE_TYPES)
+____exports.VANILLA_TRINKET_TYPE_RANGE = iRange(nil, FIRST_TRINKET_TYPE, LAST_VANILLA_TRINKET_TYPE)
+____exports.VANILLA_TRINKET_TYPES = __TS__ArrayFilter(
+    ____exports.VANILLA_TRINKET_TYPE_RANGE,
+    function(____, potentialTrinketType)
+        local trinketType = asTrinketType(nil, potentialTrinketType)
+        local itemConfigTrinket = itemConfig:GetTrinket(trinketType)
+        return itemConfigTrinket ~= nil
+    end
+)
+____exports.VANILLA_TRINKET_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_TRINKET_TYPES)
+____exports.VANILLA_CARD_TYPE_RANGE = iRange(nil, FIRST_CARD_TYPE, LAST_VANILLA_CARD_TYPE)
+____exports.VANILLA_CARD_TYPES = __TS__ArrayFilter(
+    ____exports.VANILLA_CARD_TYPE_RANGE,
+    function(____, potentialCardType)
+        local cardType = asCardType(nil, potentialCardType)
+        local itemConfigCard = itemConfig:GetCard(cardType)
+        return itemConfigCard ~= nil
+    end
+)
+____exports.VANILLA_CARD_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_CARD_TYPES)
+____exports.VANILLA_PILL_EFFECT_RANGE = iRange(nil, FIRST_PILL_EFFECT, LAST_VANILLA_PILL_EFFECT)
+____exports.VANILLA_PILL_EFFECTS = __TS__ArrayFilter(
+    ____exports.VANILLA_PILL_EFFECT_RANGE,
+    function(____, potentialPillEffect)
+        local pillEffect = asPillEffect(nil, potentialPillEffect)
+        local itemConfigPillEffect = itemConfig:GetPillEffect(pillEffect)
+        return itemConfigPillEffect ~= nil
+    end
+)
+____exports.VANILLA_PILL_EFFECTS_SET = __TS__New(ReadonlySet, ____exports.VANILLA_PILL_EFFECTS)
 return ____exports
  end,
 ["src.types.ReadonlyMap"] = function(...) 
@@ -24586,8 +24653,12 @@ end
 return ____exports
  end,
 ["src.functions.collectibles"] = function(...) 
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
 local ____exports = {}
-local initQuestionMarkSprite, getCollectibleTypeFromArg
+local getCollectibleTypeFromArg
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
 local CollectibleSpriteLayer = ____isaac_2Dtypescript_2Ddefinitions.CollectibleSpriteLayer
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -24604,8 +24675,11 @@ local itemConfig = ____cachedClasses.itemConfig
 local ____constants = require("src.core.constants")
 local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local DEFAULT_ITEM_POOL_TYPE = ____constants.DEFAULT_ITEM_POOL_TYPE
+local QUALITIES = ____constants.QUALITIES
 local ____constantsFirstLast = require("src.core.constantsFirstLast")
 local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
+local ____constantsVanilla = require("src.core.constantsVanilla")
+local VANILLA_COLLECTIBLE_TYPES = ____constantsVanilla.VANILLA_COLLECTIBLE_TYPES
 local ____collectibleDescriptionMap = require("src.maps.collectibleDescriptionMap")
 local COLLECTIBLE_DESCRIPTION_MAP = ____collectibleDescriptionMap.COLLECTIBLE_DESCRIPTION_MAP
 local DEFAULT_COLLECTIBLE_DESCRIPTION = ____collectibleDescriptionMap.DEFAULT_COLLECTIBLE_DESCRIPTION
@@ -24625,13 +24699,8 @@ local clearSprite = ____sprites.clearSprite
 local spriteEquals = ____sprites.spriteEquals
 local ____types = require("src.functions.types")
 local isInteger = ____types.isInteger
-function initQuestionMarkSprite(self)
-    local sprite = Sprite()
-    sprite:Load("gfx/005.100_collectible.anm2", false)
-    sprite:ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png")
-    sprite:LoadGraphics()
-    return sprite
-end
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 function ____exports.clearCollectibleSprite(self, collectible)
     if not isCollectible(nil, collectible) then
         local entityID = getEntityID(nil, collectible)
@@ -24639,6 +24708,14 @@ function ____exports.clearCollectibleSprite(self, collectible)
     end
     ____exports.setCollectibleSprite(nil, collectible, nil)
 end
+function ____exports.getCollectibleQuality(self, collectibleOrCollectibleType)
+    local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "getCollectibleQuality")
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return 0
+    end
+    return itemConfigItem.Quality
+end
 function ____exports.isVanillaCollectibleType(self, collectibleType)
     return collectibleType <= LAST_VANILLA_COLLECTIBLE_TYPE
 end
@@ -24695,7 +24772,27 @@ end
 local COLLECTIBLE_ANM2_PATH = "gfx/005.100_collectible.anm2"
 local DEFAULT_COLLECTIBLE_PRICE = 15
 local GLITCHED_ITEM_THRESHOLD = 4000000000
-local questionMarkSprite = initQuestionMarkSprite(nil)
+local QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP = (function()
+    local qualityToCollectibleTypesMap = __TS__New(Map)
+    for ____, quality in ipairs(QUALITIES) do
+        local collectibleTypesSet = __TS__New(Set)
+        for ____, collectibleType in ipairs(VANILLA_COLLECTIBLE_TYPES) do
+            local collectibleTypeQuality = ____exports.getCollectibleQuality(nil, collectibleType)
+            if collectibleTypeQuality == quality then
+                collectibleTypesSet:add(collectibleType)
+            end
+        end
+        qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+    end
+    return qualityToCollectibleTypesMap
+end)(nil)
+local questionMarkSprite = (function()
+    local sprite = Sprite()
+    sprite:Load("gfx/005.100_collectible.anm2", false)
+    sprite:ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png")
+    sprite:LoadGraphics()
+    return sprite
+end)(nil)
 function ____exports.collectibleHasCacheFlag(self, collectibleOrCollectibleType, cacheFlag)
     local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "collectibleHasCacheFlag")
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
@@ -24827,19 +24924,20 @@ function ____exports.getCollectiblePedestalType(self, collectible)
     local sprite = collectible:GetSprite()
     return sprite:GetOverlayFrame()
 end
-function ____exports.getCollectibleQuality(self, collectibleOrCollectibleType)
-    local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "getCollectibleQuality")
-    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-    if itemConfigItem == nil then
-        return 0
-    end
-    return itemConfigItem.Quality
-end
 function ____exports.getCollectibleTags(self, collectibleOrCollectibleType)
     local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "getCollectibleTags")
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     return itemConfigItem == nil and ItemConfigTagZero or itemConfigItem.Tags
 end
+function ____exports.getVanillaCollectibleTypesOfQuality(self, quality)
+    local collectibleTypes = QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP:get(quality)
+    assertDefined(
+        nil,
+        collectibleTypes,
+        "Failed to find the vanilla collectible types corresponding to quality: " .. tostring(quality)
+    )
+    return collectibleTypes
+end
 function ____exports.isActiveCollectible(self, collectibleType)
     local itemType = ____exports.getCollectibleItemType(nil, collectibleType)
     return itemType == ItemType.ACTIVE
@@ -38273,73 +38371,6 @@ function PickupChangeDetection.prototype.____constructor(self, postPickupChanged
     self.postPickupChanged = postPickupChanged
     self.pickupIndexCreation = pickupIndexCreation
 end
-return ____exports
- end,
-["src.core.constantsVanilla"] = function(...) 
-local ____lualib = require("lualib_bundle")
-local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local ____types = require("src.functions.types")
-local asCardType = ____types.asCardType
-local asCollectibleType = ____types.asCollectibleType
-local asPillEffect = ____types.asPillEffect
-local asTrinketType = ____types.asTrinketType
-local ____utils = require("src.functions.utils")
-local iRange = ____utils.iRange
-local ____ReadonlySet = require("src.types.ReadonlySet")
-local ReadonlySet = ____ReadonlySet.ReadonlySet
-local ____cachedClasses = require("src.core.cachedClasses")
-local itemConfig = ____cachedClasses.itemConfig
-local ____constantsFirstLast = require("src.core.constantsFirstLast")
-local FIRST_CARD_TYPE = ____constantsFirstLast.FIRST_CARD_TYPE
-local FIRST_COLLECTIBLE_TYPE = ____constantsFirstLast.FIRST_COLLECTIBLE_TYPE
-local FIRST_PILL_EFFECT = ____constantsFirstLast.FIRST_PILL_EFFECT
-local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
-local LAST_VANILLA_CARD_TYPE = ____constantsFirstLast.LAST_VANILLA_CARD_TYPE
-local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
-local LAST_VANILLA_PILL_EFFECT = ____constantsFirstLast.LAST_VANILLA_PILL_EFFECT
-local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
-____exports.VANILLA_COLLECTIBLE_TYPE_RANGE = iRange(nil, FIRST_COLLECTIBLE_TYPE, LAST_VANILLA_COLLECTIBLE_TYPE)
-____exports.VANILLA_COLLECTIBLE_TYPES = __TS__ArrayFilter(
-    ____exports.VANILLA_COLLECTIBLE_TYPE_RANGE,
-    function(____, potentialCollectibleType)
-        local collectibleType = asCollectibleType(nil, potentialCollectibleType)
-        local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-        return itemConfigItem ~= nil
-    end
-)
-____exports.VANILLA_COLLECTIBLE_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_COLLECTIBLE_TYPES)
-____exports.VANILLA_TRINKET_TYPE_RANGE = iRange(nil, FIRST_TRINKET_TYPE, LAST_VANILLA_TRINKET_TYPE)
-____exports.VANILLA_TRINKET_TYPES = __TS__ArrayFilter(
-    ____exports.VANILLA_TRINKET_TYPE_RANGE,
-    function(____, potentialTrinketType)
-        local trinketType = asTrinketType(nil, potentialTrinketType)
-        local itemConfigTrinket = itemConfig:GetTrinket(trinketType)
-        return itemConfigTrinket ~= nil
-    end
-)
-____exports.VANILLA_TRINKET_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_TRINKET_TYPES)
-____exports.VANILLA_CARD_TYPE_RANGE = iRange(nil, FIRST_CARD_TYPE, LAST_VANILLA_CARD_TYPE)
-____exports.VANILLA_CARD_TYPES = __TS__ArrayFilter(
-    ____exports.VANILLA_CARD_TYPE_RANGE,
-    function(____, potentialCardType)
-        local cardType = asCardType(nil, potentialCardType)
-        local itemConfigCard = itemConfig:GetCard(cardType)
-        return itemConfigCard ~= nil
-    end
-)
-____exports.VANILLA_CARD_TYPES_SET = __TS__New(ReadonlySet, ____exports.VANILLA_CARD_TYPES)
-____exports.VANILLA_PILL_EFFECT_RANGE = iRange(nil, FIRST_PILL_EFFECT, LAST_VANILLA_PILL_EFFECT)
-____exports.VANILLA_PILL_EFFECTS = __TS__ArrayFilter(
-    ____exports.VANILLA_PILL_EFFECT_RANGE,
-    function(____, potentialPillEffect)
-        local pillEffect = asPillEffect(nil, potentialPillEffect)
-        local itemConfigPillEffect = itemConfig:GetPillEffect(pillEffect)
-        return itemConfigPillEffect ~= nil
-    end
-)
-____exports.VANILLA_PILL_EFFECTS_SET = __TS__New(ReadonlySet, ____exports.VANILLA_PILL_EFFECTS)
 return ____exports
  end,
 ["src.objects.cardDescriptions"] = function(...) 

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

@@ -85,6 +85,13 @@ export declare function getCollectibleQuality(collectibleOrCollectibleType: Enti
  * ```
  */
 export declare function getCollectibleTags(collectibleOrCollectibleType: EntityPickup | CollectibleType): BitFlags<ItemConfigTag>;
+/**
+ * Returns a set containing every vanilla collectible type with the given quality.
+ *
+ * Note that this function will only return vanilla collectible types. To handle modded collectible
+ * types, use the `getCollectibleTypesOfQuality` helper function instead.
+ */
+export declare function getVanillaCollectibleTypesOfQuality(quality: Quality): ReadonlySet<CollectibleType>;
 /** Returns true if the item type in the item config is equal to `ItemType.ITEM_ACTIVE`. */
 export declare function isActiveCollectible(collectibleType: CollectibleType): boolean;
 /**

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

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

package/dist/src/functions/collectibles.lua

@@ -1,5 +1,9 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
 local ____exports = {}
-local initQuestionMarkSprite, getCollectibleTypeFromArg
+local getCollectibleTypeFromArg
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CollectibleSpriteLayer = ____isaac_2Dtypescript_2Ddefinitions.CollectibleSpriteLayer
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
@@ -16,8 +20,11 @@ local itemConfig = ____cachedClasses.itemConfig
 local ____constants = require("src.core.constants")
 local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local DEFAULT_ITEM_POOL_TYPE = ____constants.DEFAULT_ITEM_POOL_TYPE
+local QUALITIES = ____constants.QUALITIES
 local ____constantsFirstLast = require("src.core.constantsFirstLast")
 local LAST_VANILLA_COLLECTIBLE_TYPE = ____constantsFirstLast.LAST_VANILLA_COLLECTIBLE_TYPE
+local ____constantsVanilla = require("src.core.constantsVanilla")
+local VANILLA_COLLECTIBLE_TYPES = ____constantsVanilla.VANILLA_COLLECTIBLE_TYPES
 local ____collectibleDescriptionMap = require("src.maps.collectibleDescriptionMap")
 local COLLECTIBLE_DESCRIPTION_MAP = ____collectibleDescriptionMap.COLLECTIBLE_DESCRIPTION_MAP
 local DEFAULT_COLLECTIBLE_DESCRIPTION = ____collectibleDescriptionMap.DEFAULT_COLLECTIBLE_DESCRIPTION
@@ -37,13 +44,8 @@ local clearSprite = ____sprites.clearSprite
 local spriteEquals = ____sprites.spriteEquals
 local ____types = require("src.functions.types")
 local isInteger = ____types.isInteger
-function initQuestionMarkSprite(self)
-    local sprite = Sprite()
-    sprite:Load("gfx/005.100_collectible.anm2", false)
-    sprite:ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png")
-    sprite:LoadGraphics()
-    return sprite
-end
+local ____utils = require("src.functions.utils")
+local assertDefined = ____utils.assertDefined
 function ____exports.clearCollectibleSprite(self, collectible)
     if not isCollectible(nil, collectible) then
         local entityID = getEntityID(nil, collectible)
@@ -51,6 +53,17 @@ function ____exports.clearCollectibleSprite(self, collectible)
     end
     ____exports.setCollectibleSprite(nil, collectible, nil)
 end
+--- Helper function to get a collectible's quality, which ranges from 0 to 4 (inclusive). For
+-- example, Mom's Knife has a quality of 4. Returns 0 if the provided collectible type was not
+-- valid.
+function ____exports.getCollectibleQuality(self, collectibleOrCollectibleType)
+    local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "getCollectibleQuality")
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return 0
+    end
+    return itemConfigItem.Quality
+end
 function ____exports.isVanillaCollectibleType(self, collectibleType)
     return collectibleType <= LAST_VANILLA_COLLECTIBLE_TYPE
 end
@@ -123,8 +136,30 @@ function getCollectibleTypeFromArg(self, collectibleOrCollectibleType, functionN
 end
 local COLLECTIBLE_ANM2_PATH = "gfx/005.100_collectible.anm2"
 local DEFAULT_COLLECTIBLE_PRICE = 15
+--- Glitched items start at id 4294967295 (the final 32-bit integer) and increment backwards.
 local GLITCHED_ITEM_THRESHOLD = 4000000000
-local questionMarkSprite = initQuestionMarkSprite(nil)
+local QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP = (function()
+    local qualityToCollectibleTypesMap = __TS__New(Map)
+    for ____, quality in ipairs(QUALITIES) do
+        local collectibleTypesSet = __TS__New(Set)
+        for ____, collectibleType in ipairs(VANILLA_COLLECTIBLE_TYPES) do
+            local collectibleTypeQuality = ____exports.getCollectibleQuality(nil, collectibleType)
+            if collectibleTypeQuality == quality then
+                collectibleTypesSet:add(collectibleType)
+            end
+        end
+        qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+    end
+    return qualityToCollectibleTypesMap
+end)(nil)
+--- The `isBlindCollectible` function needs a reference sprite to work properly.
+local questionMarkSprite = (function()
+    local sprite = Sprite()
+    sprite:Load("gfx/005.100_collectible.anm2", false)
+    sprite:ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png")
+    sprite:LoadGraphics()
+    return sprite
+end)(nil)
 --- Helper function to check in the item config if a given collectible has a given cache flag.
 function ____exports.collectibleHasCacheFlag(self, collectibleOrCollectibleType, cacheFlag)
     local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "collectibleHasCacheFlag")
@@ -290,17 +325,6 @@ function ____exports.getCollectiblePedestalType(self, collectible)
     local sprite = collectible:GetSprite()
     return sprite:GetOverlayFrame()
 end
---- Helper function to get a collectible's quality, which ranges from 0 to 4 (inclusive). For
--- example, Mom's Knife has a quality of 4. Returns 0 if the provided collectible type was not
--- valid.
-function ____exports.getCollectibleQuality(self, collectibleOrCollectibleType)
-    local collectibleType = getCollectibleTypeFromArg(nil, collectibleOrCollectibleType, "getCollectibleQuality")
-    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-    if itemConfigItem == nil then
-        return 0
-    end
-    return itemConfigItem.Quality
-end
 --- Helper function to get the tags of a collectible (which is the composition of zero or more
 -- `ItemConfigTag`). Returns 0 if the provided collectible type is not valid.
 -- 
@@ -315,6 +339,19 @@ function ____exports.getCollectibleTags(self, collectibleOrCollectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     return itemConfigItem == nil and ItemConfigTagZero or itemConfigItem.Tags
 end
+--- Returns a set containing every vanilla collectible type with the given quality.
+-- 
+-- Note that this function will only return vanilla collectible types. To handle modded collectible
+-- types, use the `getCollectibleTypesOfQuality` helper function instead.
+function ____exports.getVanillaCollectibleTypesOfQuality(self, quality)
+    local collectibleTypes = QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP:get(quality)
+    assertDefined(
+        nil,
+        collectibleTypes,
+        "Failed to find the vanilla collectible types corresponding to quality: " .. tostring(quality)
+    )
+    return collectibleTypes
+end
 --- Returns true if the item type in the item config is equal to `ItemType.ITEM_ACTIVE`.
 function ____exports.isActiveCollectible(self, collectibleType)
     local itemType = ____exports.getCollectibleItemType(nil, collectibleType)

package/package.json

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

package/src/functions/collectibles.ts

@@ -15,8 +15,13 @@ import {
   RenderMode,
 } from "isaac-typescript-definitions";
 import { game, itemConfig } from "../core/cachedClasses";
-import { BLIND_ITEM_PNG_PATH, DEFAULT_ITEM_POOL_TYPE } from "../core/constants";
+import {
+  BLIND_ITEM_PNG_PATH,
+  DEFAULT_ITEM_POOL_TYPE,
+  QUALITIES,
+} from "../core/constants";
 import { LAST_VANILLA_COLLECTIBLE_TYPE } from "../core/constantsFirstLast";
+import { VANILLA_COLLECTIBLE_TYPES } from "../core/constantsVanilla";
 import {
   COLLECTIBLE_DESCRIPTION_MAP,
   DEFAULT_COLLECTIBLE_DESCRIPTION,
@@ -31,25 +36,46 @@ import { hasFlag } from "./flag";
 import { isCollectible } from "./pickupVariants";
 import { clearSprite, spriteEquals } from "./sprites";
 import { isInteger } from "./types";
+import { assertDefined } from "./utils";
 
 const COLLECTIBLE_ANM2_PATH = "gfx/005.100_collectible.anm2";
 
 const DEFAULT_COLLECTIBLE_PRICE = 15;
 
-// Glitched items start at id 4294967295 (the final 32-bit integer) and increment backwards.
+/** Glitched items start at id 4294967295 (the final 32-bit integer) and increment backwards. */
 const GLITCHED_ITEM_THRESHOLD = 4_000_000_000;
 
-// The `isBlindCollectible` function needs a reference sprite to work properly.
-const questionMarkSprite = initQuestionMarkSprite();
+const QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP: ReadonlyMap<
+  Quality,
+  Set<CollectibleType>
+> = (() => {
+  const qualityToCollectibleTypesMap = new Map<Quality, Set<CollectibleType>>();
+
+  for (const quality of QUALITIES) {
+    const collectibleTypesSet = new Set<CollectibleType>();
 
-function initQuestionMarkSprite() {
+    for (const collectibleType of VANILLA_COLLECTIBLE_TYPES) {
+      const collectibleTypeQuality = getCollectibleQuality(collectibleType);
+      if (collectibleTypeQuality === quality) {
+        collectibleTypesSet.add(collectibleType);
+      }
+    }
+
+    qualityToCollectibleTypesMap.set(quality, collectibleTypesSet);
+  }
+
+  return qualityToCollectibleTypesMap;
+})();
+
+/** The `isBlindCollectible` function needs a reference sprite to work properly. */
+const questionMarkSprite = (() => {
   const sprite = Sprite();
   sprite.Load("gfx/005.100_collectible.anm2", false);
   sprite.ReplaceSpritesheet(1, "gfx/items/collectibles/questionmark.png");
   sprite.LoadGraphics();
 
   return sprite;
-}
+})();
 
 export function clearCollectibleSprite(collectible: EntityPickup): void {
   if (!isCollectible(collectible)) {
@@ -403,6 +429,25 @@ export function getCollectibleTags(
   return itemConfigItem === undefined ? ItemConfigTagZero : itemConfigItem.Tags;
 }
 
+/**
+ * Returns a set containing every vanilla collectible type with the given quality.
+ *
+ * Note that this function will only return vanilla collectible types. To handle modded collectible
+ * types, use the `getCollectibleTypesOfQuality` helper function instead.
+ */
+export function getVanillaCollectibleTypesOfQuality(
+  quality: Quality,
+): ReadonlySet<CollectibleType> {
+  const collectibleTypes =
+    QUALITY_TO_VANILLA_COLLECTIBLE_TYPES_MAP.get(quality);
+  assertDefined(
+    collectibleTypes,
+    `Failed to find the vanilla collectible types corresponding to quality: ${quality}`,
+  );
+
+  return collectibleTypes;
+}
+
 /** Returns true if the item type in the item config is equal to `ItemType.ITEM_ACTIVE`. */
 export function isActiveCollectible(collectibleType: CollectibleType): boolean {
   const itemType = getCollectibleItemType(collectibleType);