isaacscript-common 51.9.2 → 51.10.0

package/dist/index.rollup.d.ts

@@ -13287,6 +13287,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 +13308,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 +13642,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 +13669,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 +13734,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 +15104,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.10.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)
@@ -38876,6 +38883,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 +38899,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 +38977,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 +38998,7 @@ function ModdedElementSets.prototype.lazyInit(self)
     self:lazyInitFlyingCollectibleTypesSet()
     self:lazyInitFlyingTrinketTypesSet()
     self:lazyInitEdenCollectibleTypesSet()
+    self:lazyInitQualityToCollectibleTypesMap()
     self:lazyInitCardTypes()
 end
 function ModdedElementSets.prototype.lazyInitModdedCollectibleTypes(self)
@@ -39116,24 +39127,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 +39190,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 +39474,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":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,SAAS,EACT,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,WAAW,EACZ,MAAM,8BAA8B,CAAC;AA2CtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2BhD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAyB;IAClE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA8B;IAErE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAyB;IACrE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA8B;IAExE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;IAE7D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAqB;IAC7D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0B;IAEhE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IAEvD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkB;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuB;IAE1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAyB;IAE3D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoB;IAC3D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAyB;IAE9D,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAG3C;IAEJ,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAGvC;IAEJ,OAAO,CAAC,yBAAyB,CAA8B;IAC/D,OAAO,CAAC,QAAQ,CAAC,kCAAkC,CACtB;IAE7B,OAAO,CAAC,qBAAqB,CAA0B;IAEvD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAGrC;IAEJ,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAA8B;IAC5E,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAA8B;IAE7E,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAG5C;IAEJ;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAWhE,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,8BAA8B;IAiCtC,OAAO,CAAC,0BAA0B;IA6BlC,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,yBAAyB;IA6BjC,OAAO,CAAC,gCAAgC;IA0BxC,OAAO,CAAC,sCAAsC;IAc9C,OAAO,CAAC,kCAAkC;IAc1C,OAAO,CAAC,iCAAiC;IA+BzC,OAAO,CAAC,6BAA6B;IAgBrC,OAAO,CAAC,+BAA+B;IAmBvC,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;;;;;;OAYG;IAEI,mBAAmB,IAAI,SAAS,eAAe,EAAE;IAKxD;;;;;;;;;;;;OAYG;IAEI,qBAAqB,IAAI,WAAW,CAAC,eAAe,CAAC;IAK5D;;;;;;;;;;;OAWG;IAEI,yBAAyB,IAAI,SAAS,eAAe,EAAE;IAK9D;;;;;;;;;;;OAWG;IAEI,4BAA4B,IAAI,WAAW,CAAC,eAAe,CAAC;IAKnE;;;;;;;;;;;OAWG;IAEI,uBAAuB,CAC5B,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC;IAwC5B;;;;;;;;;;;OAWG;IAEI,eAAe,IAAI,SAAS,WAAW,EAAE;IAKhD;;;;;;;;;;;OAWG;IAEI,kBAAkB,IAAI,WAAW,CAAC,WAAW,CAAC;IAKrD;;;;;;;;;;;OAWG;IAEI,qBAAqB,IAAI,SAAS,WAAW,EAAE;IAKtD;;;;;;;;;;;OAWG;IAEI,wBAAwB,IAAI,WAAW,CAAC,WAAW,CAAC;IAS3D;;;;;;;;;;OAUG;IAEI,YAAY,IAAI,SAAS,QAAQ,EAAE;IAK1C;;;;;;;;;;OAUG;IAEI,eAAe,IAAI,WAAW,CAAC,QAAQ,CAAC;IAK/C;;;;;;;;;;OAUG;IAEI,kBAAkB,IAAI,SAAS,QAAQ,EAAE;IAKhD;;;;;;;;;;OAUG;IAEI,qBAAqB,IAAI,WAAW,CAAC,QAAQ,CAAC;IASrD;;;;;;;;;;;OAWG;IAEI,cAAc,IAAI,SAAS,UAAU,EAAE;IAK9C;;;;;;;;;;;OAWG;IAEI,iBAAiB,IAAI,WAAW,CAAC,UAAU,CAAC;IAKnD;;;;;;;;;;;OAWG;IAEI,oBAAoB,IAAI,SAAS,UAAU,EAAE;IAKpD;;;;;;;;;;;OAWG;IAEI,uBAAuB,IAAI,WAAW,CAAC,UAAU,CAAC;IASzD;;;;;;;;;OASG;IAEI,gCAAgC,CACrC,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,eAAe,CAAC;IAW/B;;;;;;;;;OASG;IAEI,6BAA6B,CAClC,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,WAAW,CAAC;IAW3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEI,kCAAkC,CACvC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,eAAe,EAAE;IAkBpB;;;;;;;;;OASG;IAEI,8BAA8B,CACnC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;IAexB;;;;;;;;;;;;;;;;;;;;OAoBG;IAEI,yBAAyB,CAC9B,uBAAuB,EAAE,OAAO,GAC/B,WAAW,CAAC,eAAe,CAAC;IAQ/B;;;;;;;;;;;;;OAaG;IAEI,qBAAqB,IAAI,WAAW,CAAC,WAAW,CAAC;IASxD;;;;;;;;;;;;;;;OAeG;IAEI,0BAA0B,CAC/B,aAAa,EAAE,aAAa,GAC3B,WAAW,CAAC,eAAe,CAAC;IAY/B;;;;;;;;OAQG;IAEI,4BAA4B,CACjC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,aAAa,GAC3B,eAAe,EAAE;IAgBpB;;;;;;;;;;;;;;;OAeG;IAEI,oCAAoC,CACzC,UAAU,EAAE,UAAU,GACrB,WAAW,CAAC,eAAe,CAAC;IAU/B;;;;;;;;OAQG;IAEI,sCAAsC,CAC3C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,eAAe,EAAE;IAkBpB;;;;;;;;;;;OAWG;IAEI,6BAA6B,IAAI,WAAW,CAAC,eAAe,CAAC;IAKpE;;;;;;;;;;;OAWG;IAEI,8BAA8B,IAAI,WAAW,CAAC,eAAe,CAAC;IAKrE;;;;;;;;;;;;OAYG;IAEI,kCAAkC,CACvC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,eAAe,EAAE,GAAG,SAAS,eAAe,EAAO,GAC9D,eAAe;IASlB;;;;;;;;;;;;;OAaG;IAEI,mCAAmC,CACxC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,eAAe,EAAE,GAAG,SAAS,eAAe,EAAO,GAC9D,eAAe;IAalB;;;;;;;;;;OAUG;IAEI,kBAAkB,CACvB,GAAG,mBAAmB,EAAE,kBAAkB,EAAE,GAC3C,GAAG,CAAC,QAAQ,CAAC;IAoBhB;;;;;;;;;;;;;OAaG;IAEI,uBAAuB,CAC5B,kBAAkB,EAAE,kBAAkB,EACtC,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,QAAQ,EAAO,GAC1B,QAAQ;IAKX;;;;;;;;;;;;;;;OAeG;IAEI,aAAa,CAClB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,QAAQ,EAAO,GAC1B,QAAQ;IAKX;;;;;;;;;;;;OAYG;IAEI,aAAa,CAClB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,QAAQ,EAAO,GAC1B,QAAQ;CAKZ"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "51.9.2",
+  "version": "51.10.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);
 }
 
 /**