isaacscript-common 51.9.2 → 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.
@@ -13287,6 +13295,7 @@ declare class ModdedElementSets extends Feature {
     private readonly tagToCollectibleTypesMap;
     private readonly edenActiveCollectibleTypesSet;
     private readonly edenPassiveCollectibleTypesSet;
+    private readonly qualityToCollectibleTypesMap;
     private readonly itemConfigCardTypeToCardTypeMap;
     /**
      * The set of card types that are not:
@@ -13307,6 +13316,7 @@ declare class ModdedElementSets extends Feature {
     private lazyInitFlyingCollectibleTypesSet;
     private lazyInitFlyingTrinketTypesSet;
     private lazyInitEdenCollectibleTypesSet;
+    private lazyInitQualityToCollectibleTypesMap;
     private lazyInitCardTypes;
     /**
      * Returns an array containing every valid collectible type in the game, including modded
@@ -13640,7 +13650,7 @@ declare class ModdedElementSets extends Feature {
      */
     getCollectibleTypesWithTag(itemConfigTag: ItemConfigTag): ReadonlySet<CollectibleType>;
     /**
-     * Returns the number of items that a player has towards a particular transformation.
+     * Returns an array of collectible types that a player has with a particular tag.
      *
      * This function can only be called if at least one callback has been executed. This is because
      * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -13667,7 +13677,8 @@ declare class ModdedElementSets extends Feature {
      */
     getCollectibleTypesForTransformation(playerForm: PlayerForm): ReadonlySet<CollectibleType>;
     /**
-     * Returns the number of items that a player has towards a particular transformation.
+     * Returns an array of collectible types that a player has that count towards a particular
+     * transformation.
      *
      * This function can only be called if at least one callback has been executed. This is because
      * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -13731,6 +13742,26 @@ declare class ModdedElementSets extends Feature {
      * @param exceptions Optional. An array of runes to not select.
      */
     getRandomEdenPassiveCollectibleType(seedOrRNG?: Seed | RNG, exceptions?: CollectibleType[] | readonly CollectibleType[]): CollectibleType;
+    /**
+     * Returns a set containing every collectible type with the given quality.
+     *
+     * This function can only be called if at least one callback has been executed. This is because
+     * not all collectible types will necessarily be present when a mod first loads (due to mod load
+     * order).
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     */
+    getCollectibleTypesOfQuality(quality: Quality): ReadonlySet<CollectibleType>;
+    /**
+     * Returns an array of collectible types that a player has that are of a particular quality.
+     *
+     * This function can only be called if at least one callback has been executed. This is because
+     * not all collectible types will necessarily be present when a mod first loads (due to mod load
+     * order).
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     */
+    getPlayerCollectiblesOfQuality(player: EntityPlayer, quality: Quality): CollectibleType[];
     /**
      * Helper function to get a set of card types matching the `ItemConfigCardType`.
      *
@@ -15081,6 +15112,12 @@ export declare function PriorityCallbackCustom<T extends ModCallbackCustom>(modC
 /** Helper type to extract only the public interface of a class. */
 export declare type PublicInterface<T> = Pick<T, keyof T>;
 
+/**
+ * An array representing every valid collectible type quality. Specifically, this is `[0, 1, 2, 3,
+ * 4]`.
+ */
+export declare const QUALITIES: readonly Quality[];
+
 declare interface QueueElement {
     playerIndex: PlayerIndex;
     renderOffset: Vector;

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 51.9.2
+isaacscript-common 51.11.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -18089,6 +18089,13 @@ ____exports.NUM_DIMENSIONS = getEnumLength(nil, Dimension) - 1
 ____exports.DIMENSIONS = eRange(nil, ____exports.NUM_DIMENSIONS)
 ____exports.NUM_PILL_COLORS_IN_POOL = NUM_NORMAL_PILL_COLORS
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
+____exports.QUALITIES = {
+    0,
+    1,
+    2,
+    3,
+    4
+}
 ____exports.SECOND_IN_MILLISECONDS = 1000
 ____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
 ____exports.RESOLUTION_FULL_SCREEN = Vector(480, 270)
@@ -23047,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(...) 
@@ -24579,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
@@ -24597,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
@@ -24618,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)
@@ -24632,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
@@ -24688,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)
@@ -24820,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
@@ -38266,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(...) 
@@ -38876,6 +38914,7 @@ local ____cachedClasses = require("src.core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constants = require("src.core.constants")
 local FIRST_GLITCHED_COLLECTIBLE_TYPE = ____constants.FIRST_GLITCHED_COLLECTIBLE_TYPE
+local QUALITIES = ____constants.QUALITIES
 local ____constantsVanilla = require("src.core.constantsVanilla")
 local VANILLA_CARD_TYPES = ____constantsVanilla.VANILLA_CARD_TYPES
 local VANILLA_COLLECTIBLE_TYPES = ____constantsVanilla.VANILLA_COLLECTIBLE_TYPES
@@ -38891,6 +38930,7 @@ local ____collectibleTag = require("src.functions.collectibleTag")
 local collectibleHasTag = ____collectibleTag.collectibleHasTag
 local ____collectibles = require("src.functions.collectibles")
 local collectibleHasCacheFlag = ____collectibles.collectibleHasCacheFlag
+local getCollectibleQuality = ____collectibles.getCollectibleQuality
 local isActiveCollectible = ____collectibles.isActiveCollectible
 local isHiddenCollectible = ____collectibles.isHiddenCollectible
 local isPassiveOrFamiliarCollectible = ____collectibles.isPassiveOrFamiliarCollectible
@@ -38968,6 +39008,7 @@ function ModdedElementSets.prototype.____constructor(self, moddedElementDetectio
     self.tagToCollectibleTypesMap = __TS__New(Map)
     self.edenActiveCollectibleTypesSet = __TS__New(Set)
     self.edenPassiveCollectibleTypesSet = __TS__New(Set)
+    self.qualityToCollectibleTypesMap = __TS__New(Map)
     self.itemConfigCardTypeToCardTypeMap = __TS__New(Map)
     self.cardSet = __TS__New(Set)
     self.featuresUsed = {ISCFeature.MODDED_ELEMENT_DETECTION}
@@ -38988,6 +39029,7 @@ function ModdedElementSets.prototype.lazyInit(self)
     self:lazyInitFlyingCollectibleTypesSet()
     self:lazyInitFlyingTrinketTypesSet()
     self:lazyInitEdenCollectibleTypesSet()
+    self:lazyInitQualityToCollectibleTypesMap()
     self:lazyInitCardTypes()
 end
 function ModdedElementSets.prototype.lazyInitModdedCollectibleTypes(self)
@@ -39116,24 +39158,24 @@ function ModdedElementSets.prototype.lazyInitTagToCollectibleTypesMap(self)
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToCollectibleTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local collectiblesSet = __TS__New(Set)
+        local collectibleTypeSet = __TS__New(Set)
         for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
             if collectibleHasCacheFlag(nil, collectibleType, cacheFlag) then
-                collectiblesSet:add(collectibleType)
+                collectibleTypeSet:add(collectibleType)
             end
         end
-        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectiblesSet)
+        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectibleTypeSet)
     end
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToTrinketTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local trinketsSet = __TS__New(Set)
+        local trinketTypesSet = __TS__New(Set)
         for ____, trinketType in ipairs(self:getTrinketTypes()) do
             if trinketHasCacheFlag(nil, trinketType, cacheFlag) then
-                trinketsSet:add(trinketType)
+                trinketTypesSet:add(trinketType)
             end
         end
-        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketsSet)
+        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketTypesSet)
     end
 end
 function ModdedElementSets.prototype.lazyInitFlyingCollectibleTypesSet(self)
@@ -39179,6 +39221,18 @@ function ModdedElementSets.prototype.lazyInitEdenCollectibleTypesSet(self)
         ::__continue61::
     end
 end
+function ModdedElementSets.prototype.lazyInitQualityToCollectibleTypesMap(self)
+    for ____, quality in ipairs(QUALITIES) do
+        local collectibleTypesSet = __TS__New(Set)
+        for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
+            local collectibleTypeQuality = getCollectibleQuality(nil, collectibleType)
+            if collectibleTypeQuality == quality then
+                collectibleTypesSet:add(collectibleType)
+            end
+        end
+        self.qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+    end
+end
 function ModdedElementSets.prototype.lazyInitCardTypes(self)
     for ____, itemConfigCardType in ipairs(ITEM_CONFIG_CARD_TYPE_VALUES) do
         self.itemConfigCardTypeToCardTypeMap:set(
@@ -39451,6 +39505,33 @@ function ModdedElementSets.prototype.getRandomEdenPassiveCollectibleType(self, s
     return getRandomSetElement(nil, self.edenPassiveCollectibleTypesSet, seedOrRNG, exceptions)
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getRandomEdenPassiveCollectibleType", true)
+function ModdedElementSets.prototype.getCollectibleTypesOfQuality(self, quality)
+    self:lazyInit()
+    local collectibleTypes = self.qualityToCollectibleTypesMap:get(quality)
+    assertDefined(
+        nil,
+        collectibleTypes,
+        ("The quality of " .. tostring(quality)) .. " is not a valid quality."
+    )
+    return collectibleTypes
+end
+__TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTypesOfQuality", true)
+function ModdedElementSets.prototype.getPlayerCollectiblesOfQuality(self, player, quality)
+    local collectibleTypesOfQuality = self:getCollectibleTypesOfQuality(quality)
+    local playerCollectibles = {}
+    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectibleTypesOfQuality)) do
+        local numCollectibles = player:GetCollectibleNum(collectibleType, true)
+        ____repeat(
+            nil,
+            numCollectibles,
+            function()
+                playerCollectibles[#playerCollectibles + 1] = collectibleType
+            end
+        )
+    end
+    return playerCollectibles
+end
+__TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getPlayerCollectiblesOfQuality", true)
 function ModdedElementSets.prototype.getCardTypesOfType(self, ...)
     local itemConfigCardTypes = {...}
     self:lazyInit()

package/dist/src/classes/features/other/ModdedElementSets.d.ts

@@ -35,6 +35,7 @@ export declare class ModdedElementSets extends Feature {
     private readonly tagToCollectibleTypesMap;
     private readonly edenActiveCollectibleTypesSet;
     private readonly edenPassiveCollectibleTypesSet;
+    private readonly qualityToCollectibleTypesMap;
     private readonly itemConfigCardTypeToCardTypeMap;
     /**
      * The set of card types that are not:
@@ -55,6 +56,7 @@ export declare class ModdedElementSets extends Feature {
     private lazyInitFlyingCollectibleTypesSet;
     private lazyInitFlyingTrinketTypesSet;
     private lazyInitEdenCollectibleTypesSet;
+    private lazyInitQualityToCollectibleTypesMap;
     private lazyInitCardTypes;
     /**
      * Returns an array containing every valid collectible type in the game, including modded
@@ -388,7 +390,7 @@ export declare class ModdedElementSets extends Feature {
      */
     getCollectibleTypesWithTag(itemConfigTag: ItemConfigTag): ReadonlySet<CollectibleType>;
     /**
-     * Returns the number of items that a player has towards a particular transformation.
+     * Returns an array of collectible types that a player has with a particular tag.
      *
      * This function can only be called if at least one callback has been executed. This is because
      * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -415,7 +417,8 @@ export declare class ModdedElementSets extends Feature {
      */
     getCollectibleTypesForTransformation(playerForm: PlayerForm): ReadonlySet<CollectibleType>;
     /**
-     * Returns the number of items that a player has towards a particular transformation.
+     * Returns an array of collectible types that a player has that count towards a particular
+     * transformation.
      *
      * This function can only be called if at least one callback has been executed. This is because
      * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -479,6 +482,26 @@ export declare class ModdedElementSets extends Feature {
      * @param exceptions Optional. An array of runes to not select.
      */
     getRandomEdenPassiveCollectibleType(seedOrRNG?: Seed | RNG, exceptions?: CollectibleType[] | readonly CollectibleType[]): CollectibleType;
+    /**
+     * Returns a set containing every collectible type with the given quality.
+     *
+     * This function can only be called if at least one callback has been executed. This is because
+     * not all collectible types will necessarily be present when a mod first loads (due to mod load
+     * order).
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     */
+    getCollectibleTypesOfQuality(quality: Quality): ReadonlySet<CollectibleType>;
+    /**
+     * Returns an array of collectible types that a player has that are of a particular quality.
+     *
+     * This function can only be called if at least one callback has been executed. This is because
+     * not all collectible types will necessarily be present when a mod first loads (due to mod load
+     * order).
+     *
+     * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+     */
+    getPlayerCollectiblesOfQuality(player: EntityPlayer, quality: Quality): CollectibleType[];
     /**
      * Helper function to get a set of card types matching the `ItemConfigCardType`.
      *

package/dist/src/classes/features/other/ModdedElementSets.d.ts.map

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

package/dist/src/classes/features/other/ModdedElementSets.lua

@@ -23,6 +23,7 @@ local ____cachedClasses = require("src.core.cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____constants = require("src.core.constants")
 local FIRST_GLITCHED_COLLECTIBLE_TYPE = ____constants.FIRST_GLITCHED_COLLECTIBLE_TYPE
+local QUALITIES = ____constants.QUALITIES
 local ____constantsVanilla = require("src.core.constantsVanilla")
 local VANILLA_CARD_TYPES = ____constantsVanilla.VANILLA_CARD_TYPES
 local VANILLA_COLLECTIBLE_TYPES = ____constantsVanilla.VANILLA_COLLECTIBLE_TYPES
@@ -38,6 +39,7 @@ local ____collectibleTag = require("src.functions.collectibleTag")
 local collectibleHasTag = ____collectibleTag.collectibleHasTag
 local ____collectibles = require("src.functions.collectibles")
 local collectibleHasCacheFlag = ____collectibles.collectibleHasCacheFlag
+local getCollectibleQuality = ____collectibles.getCollectibleQuality
 local isActiveCollectible = ____collectibles.isActiveCollectible
 local isHiddenCollectible = ____collectibles.isHiddenCollectible
 local isPassiveOrFamiliarCollectible = ____collectibles.isPassiveOrFamiliarCollectible
@@ -121,6 +123,7 @@ function ModdedElementSets.prototype.____constructor(self, moddedElementDetectio
     self.tagToCollectibleTypesMap = __TS__New(Map)
     self.edenActiveCollectibleTypesSet = __TS__New(Set)
     self.edenPassiveCollectibleTypesSet = __TS__New(Set)
+    self.qualityToCollectibleTypesMap = __TS__New(Map)
     self.itemConfigCardTypeToCardTypeMap = __TS__New(Map)
     self.cardSet = __TS__New(Set)
     self.featuresUsed = {ISCFeature.MODDED_ELEMENT_DETECTION}
@@ -141,6 +144,7 @@ function ModdedElementSets.prototype.lazyInit(self)
     self:lazyInitFlyingCollectibleTypesSet()
     self:lazyInitFlyingTrinketTypesSet()
     self:lazyInitEdenCollectibleTypesSet()
+    self:lazyInitQualityToCollectibleTypesMap()
     self:lazyInitCardTypes()
 end
 function ModdedElementSets.prototype.lazyInitModdedCollectibleTypes(self)
@@ -269,24 +273,24 @@ function ModdedElementSets.prototype.lazyInitTagToCollectibleTypesMap(self)
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToCollectibleTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local collectiblesSet = __TS__New(Set)
+        local collectibleTypeSet = __TS__New(Set)
         for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
             if collectibleHasCacheFlag(nil, collectibleType, cacheFlag) then
-                collectiblesSet:add(collectibleType)
+                collectibleTypeSet:add(collectibleType)
             end
         end
-        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectiblesSet)
+        self.cacheFlagToCollectibleTypesMap:set(cacheFlag, collectibleTypeSet)
     end
 end
 function ModdedElementSets.prototype.lazyInitCacheFlagToTrinketTypesMap(self)
     for ____, cacheFlag in ipairs(CACHE_FLAG_VALUES) do
-        local trinketsSet = __TS__New(Set)
+        local trinketTypesSet = __TS__New(Set)
         for ____, trinketType in ipairs(self:getTrinketTypes()) do
             if trinketHasCacheFlag(nil, trinketType, cacheFlag) then
-                trinketsSet:add(trinketType)
+                trinketTypesSet:add(trinketType)
             end
         end
-        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketsSet)
+        self.cacheFlagToTrinketTypesMap:set(cacheFlag, trinketTypesSet)
     end
 end
 function ModdedElementSets.prototype.lazyInitFlyingCollectibleTypesSet(self)
@@ -332,6 +336,18 @@ function ModdedElementSets.prototype.lazyInitEdenCollectibleTypesSet(self)
         ::__continue61::
     end
 end
+function ModdedElementSets.prototype.lazyInitQualityToCollectibleTypesMap(self)
+    for ____, quality in ipairs(QUALITIES) do
+        local collectibleTypesSet = __TS__New(Set)
+        for ____, collectibleType in ipairs(self:getCollectibleTypes()) do
+            local collectibleTypeQuality = getCollectibleQuality(nil, collectibleType)
+            if collectibleTypeQuality == quality then
+                collectibleTypesSet:add(collectibleType)
+            end
+        end
+        self.qualityToCollectibleTypesMap:set(quality, collectibleTypesSet)
+    end
+end
 function ModdedElementSets.prototype.lazyInitCardTypes(self)
     for ____, itemConfigCardType in ipairs(ITEM_CONFIG_CARD_TYPE_VALUES) do
         self.itemConfigCardTypeToCardTypeMap:set(
@@ -604,6 +620,33 @@ function ModdedElementSets.prototype.getRandomEdenPassiveCollectibleType(self, s
     return getRandomSetElement(nil, self.edenPassiveCollectibleTypesSet, seedOrRNG, exceptions)
 end
 __TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getRandomEdenPassiveCollectibleType", true)
+function ModdedElementSets.prototype.getCollectibleTypesOfQuality(self, quality)
+    self:lazyInit()
+    local collectibleTypes = self.qualityToCollectibleTypesMap:get(quality)
+    assertDefined(
+        nil,
+        collectibleTypes,
+        ("The quality of " .. tostring(quality)) .. " is not a valid quality."
+    )
+    return collectibleTypes
+end
+__TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getCollectibleTypesOfQuality", true)
+function ModdedElementSets.prototype.getPlayerCollectiblesOfQuality(self, player, quality)
+    local collectibleTypesOfQuality = self:getCollectibleTypesOfQuality(quality)
+    local playerCollectibles = {}
+    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectibleTypesOfQuality)) do
+        local numCollectibles = player:GetCollectibleNum(collectibleType, true)
+        ____repeat(
+            nil,
+            numCollectibles,
+            function()
+                playerCollectibles[#playerCollectibles + 1] = collectibleType
+            end
+        )
+    end
+    return playerCollectibles
+end
+__TS__DecorateLegacy({Exported}, ModdedElementSets.prototype, "getPlayerCollectiblesOfQuality", true)
 function ModdedElementSets.prototype.getCardTypesOfType(self, ...)
     local itemConfigCardTypes = {...}
     self:lazyInit()

package/dist/src/core/constants.d.ts

@@ -151,6 +151,11 @@ export declare const DIMENSIONS: readonly Dimension[];
  */
 export declare const NUM_PILL_COLORS_IN_POOL: number;
 export declare const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
+/**
+ * An array representing every valid collectible type quality. Specifically, this is `[0, 1, 2, 3,
+ * 4]`.
+ */
+export declare const QUALITIES: readonly Quality[];
 export declare const SECOND_IN_MILLISECONDS = 1000;
 export declare const MINUTE_IN_MILLISECONDS: number;
 /** This is equivalent to the bottom-right screen position when the game is in full screen mode. */

package/dist/src/core/constants.d.ts.map

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

package/dist/src/core/constants.lua

@@ -201,6 +201,15 @@ ____exports.DIMENSIONS = eRange(nil, ____exports.NUM_DIMENSIONS)
 -- horse pills.)
 ____exports.NUM_PILL_COLORS_IN_POOL = NUM_NORMAL_PILL_COLORS
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
+--- An array representing every valid collectible type quality. Specifically, this is `[0, 1, 2, 3,
+-- 4]`.
+____exports.QUALITIES = {
+    0,
+    1,
+    2,
+    3,
+    4
+}
 ____exports.SECOND_IN_MILLISECONDS = 1000
 ____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
 --- This is equivalent to the bottom-right screen position when the game is in full screen mode.

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.9.2",
+  "version": "51.11.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -25,6 +25,6 @@
   "main": "dist/src/index",
   "types": "dist/index.rollup.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^21.0.3"
+    "isaac-typescript-definitions": "^21.1.0"
   }
 }

package/src/classes/features/other/ModdedElementSets.ts

@@ -14,7 +14,10 @@ import {
   ITEM_CONFIG_TAG_VALUES,
 } from "../../../arrays/cachedEnumValues";
 import { itemConfig } from "../../../core/cachedClasses";
-import { FIRST_GLITCHED_COLLECTIBLE_TYPE } from "../../../core/constants";
+import {
+  FIRST_GLITCHED_COLLECTIBLE_TYPE,
+  QUALITIES,
+} from "../../../core/constants";
 import {
   VANILLA_CARD_TYPES,
   VANILLA_COLLECTIBLE_TYPES,
@@ -27,6 +30,7 @@ import { getItemConfigCardType } from "../../../functions/cards";
 import { collectibleHasTag } from "../../../functions/collectibleTag";
 import {
   collectibleHasCacheFlag,
+  getCollectibleQuality,
   isActiveCollectible,
   isHiddenCollectible,
   isPassiveOrFamiliarCollectible,
@@ -88,6 +92,10 @@ const TRANSFORMATION_TO_TAG_MAP = new ReadonlyMap<PlayerForm, ItemConfigTag>([
 export class ModdedElementSets extends Feature {
   private arraysInitialized = false;
 
+  // ----------------
+  // Main collections
+  // ----------------
+
   private readonly allCollectibleTypesArray: CollectibleType[] = [];
   private readonly allCollectibleTypesSet = new Set<CollectibleType>();
 
@@ -112,6 +120,10 @@ export class ModdedElementSets extends Feature {
   private readonly moddedPillEffectsArray: PillEffect[] = [];
   private readonly moddedPillEffectsSet = new Set<PillEffect>();
 
+  // -----------------
+  // Other collections
+  // -----------------
+
   private readonly cacheFlagToCollectibleTypesMap = new Map<
     CacheFlag,
     Set<CollectibleType>
@@ -136,6 +148,11 @@ export class ModdedElementSets extends Feature {
   private readonly edenActiveCollectibleTypesSet = new Set<CollectibleType>();
   private readonly edenPassiveCollectibleTypesSet = new Set<CollectibleType>();
 
+  private readonly qualityToCollectibleTypesMap = new Map<
+    Quality,
+    Set<CollectibleType>
+  >();
+
   private readonly itemConfigCardTypeToCardTypeMap = new Map<
     ItemConfigCardType,
     Set<CardType>
@@ -176,6 +193,7 @@ export class ModdedElementSets extends Feature {
     this.lazyInitFlyingCollectibleTypesSet();
     this.lazyInitFlyingTrinketTypesSet();
     this.lazyInitEdenCollectibleTypesSet();
+    this.lazyInitQualityToCollectibleTypesMap();
     this.lazyInitCardTypes();
   }
 
@@ -327,29 +345,29 @@ export class ModdedElementSets extends Feature {
 
   private lazyInitCacheFlagToCollectibleTypesMap() {
     for (const cacheFlag of CACHE_FLAG_VALUES) {
-      const collectiblesSet = new Set<CollectibleType>();
+      const collectibleTypeSet = new Set<CollectibleType>();
 
       for (const collectibleType of this.getCollectibleTypes()) {
         if (collectibleHasCacheFlag(collectibleType, cacheFlag)) {
-          collectiblesSet.add(collectibleType);
+          collectibleTypeSet.add(collectibleType);
         }
       }
 
-      this.cacheFlagToCollectibleTypesMap.set(cacheFlag, collectiblesSet);
+      this.cacheFlagToCollectibleTypesMap.set(cacheFlag, collectibleTypeSet);
     }
   }
 
   private lazyInitCacheFlagToTrinketTypesMap() {
     for (const cacheFlag of CACHE_FLAG_VALUES) {
-      const trinketsSet = new Set<TrinketType>();
+      const trinketTypesSet = new Set<TrinketType>();
 
       for (const trinketType of this.getTrinketTypes()) {
         if (trinketHasCacheFlag(trinketType, cacheFlag)) {
-          trinketsSet.add(trinketType);
+          trinketTypesSet.add(trinketType);
         }
       }
 
-      this.cacheFlagToTrinketTypesMap.set(cacheFlag, trinketsSet);
+      this.cacheFlagToTrinketTypesMap.set(cacheFlag, trinketTypesSet);
     }
   }
 
@@ -419,6 +437,21 @@ export class ModdedElementSets extends Feature {
     }
   }
 
+  private lazyInitQualityToCollectibleTypesMap() {
+    for (const quality of QUALITIES) {
+      const collectibleTypesSet = new Set<CollectibleType>();
+
+      for (const collectibleType of this.getCollectibleTypes()) {
+        const collectibleTypeQuality = getCollectibleQuality(collectibleType);
+        if (collectibleTypeQuality === quality) {
+          collectibleTypesSet.add(collectibleType);
+        }
+      }
+
+      this.qualityToCollectibleTypesMap.set(quality, collectibleTypesSet);
+    }
+  }
+
   private lazyInitCardTypes() {
     // The card type to cards map should be valid for every card type, so we initialize it with
     // empty sets.
@@ -1016,7 +1049,7 @@ export class ModdedElementSets extends Feature {
   }
 
   /**
-   * Returns the number of items that a player has towards a particular transformation.
+   * Returns an array of collectible types that a player has with a particular tag.
    *
    * This function can only be called if at least one callback has been executed. This is because
    * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -1074,7 +1107,8 @@ export class ModdedElementSets extends Feature {
   }
 
   /**
-   * Returns the number of items that a player has towards a particular transformation.
+   * Returns an array of collectible types that a player has that count towards a particular
+   * transformation.
    *
    * This function can only be called if at least one callback has been executed. This is because
    * not all collectible types will necessarily be present when a mod first loads (due to mod load
@@ -1193,6 +1227,65 @@ export class ModdedElementSets extends Feature {
     );
   }
 
+  // -------------------
+  // Collectible Quality
+  // -------------------
+
+  /**
+   * Returns a set containing every collectible type with the given quality.
+   *
+   * This function can only be called if at least one callback has been executed. This is because
+   * not all collectible types will necessarily be present when a mod first loads (due to mod load
+   * order).
+   *
+   * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+   */
+  @Exported
+  public getCollectibleTypesOfQuality(
+    quality: Quality,
+  ): ReadonlySet<CollectibleType> {
+    this.lazyInit();
+
+    const collectibleTypes = this.qualityToCollectibleTypesMap.get(quality);
+    assertDefined(
+      collectibleTypes,
+      `The quality of ${quality} is not a valid quality.`,
+    );
+
+    return collectibleTypes;
+  }
+
+  /**
+   * Returns an array of collectible types that a player has that are of a particular quality.
+   *
+   * This function can only be called if at least one callback has been executed. This is because
+   * not all collectible types will necessarily be present when a mod first loads (due to mod load
+   * order).
+   *
+   * In order to use this function, you must upgrade your mod with `ISCFeature.MODDED_ELEMENT_SETS`.
+   */
+  @Exported
+  public getPlayerCollectiblesOfQuality(
+    player: EntityPlayer,
+    quality: Quality,
+  ): CollectibleType[] {
+    const collectibleTypesOfQuality =
+      this.getCollectibleTypesOfQuality(quality);
+
+    const playerCollectibles: CollectibleType[] = [];
+    for (const collectibleType of getSortedSetValues(
+      collectibleTypesOfQuality,
+    )) {
+      // We specify "true" as the second argument to filter out things like Lilith's Incubus.
+      const numCollectibles = player.GetCollectibleNum(collectibleType, true);
+      repeat(numCollectibles, () => {
+        playerCollectibles.push(collectibleType);
+      });
+    }
+
+    return playerCollectibles;
+  }
+
   // ----------------------
   // Item Config Card Types
   // ----------------------

package/src/core/constants.ts

@@ -291,6 +291,13 @@ export const NUM_PILL_COLORS_IN_POOL = NUM_NORMAL_PILL_COLORS;
 
 export const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
 
+/**
+ * An array representing every valid collectible type quality. Specifically, this is `[0, 1, 2, 3,
+ * 4]`.
+ */
+// eslint-disable-next-line isaacscript/require-capital-const-assertions
+export const QUALITIES: readonly Quality[] = [0, 1, 2, 3, 4];
+
 export const SECOND_IN_MILLISECONDS = 1000;
 export const MINUTE_IN_MILLISECONDS = 60 * SECOND_IN_MILLISECONDS;
 

package/src/functions/bitwise.ts

@@ -16,7 +16,7 @@ export function arrayToBitFlags<T extends BitFlag | BitFlag128>(
 /** Helper function to convert an array of bits to the resulting decimal number. */
 export function convertBinaryToDecimal(bits: int[]): number {
   const bitsString = bits.join("");
-  return parseInt(bitsString, 2);
+  return Number.parseInt(bitsString, 2);
 }
 
 /**

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);