isaacscript-common 9.19.0 → 9.19.3

package/dist/src/functions/characters.lua

@@ -0,0 +1,106 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local ____constantsFirstLast = require("src.core.constantsFirstLast")
+local LAST_VANILLA_CHARACTER = ____constantsFirstLast.LAST_VANILLA_CHARACTER
+local ____characterDamageMultipliers = require("src.objects.characterDamageMultipliers")
+local CHARACTER_DAMAGE_MULTIPLIERS = ____characterDamageMultipliers.CHARACTER_DAMAGE_MULTIPLIERS
+local ____characterNames = require("src.objects.characterNames")
+local CHARACTER_NAMES = ____characterNames.CHARACTER_NAMES
+local ____charactersThatStartWithAnActiveItemSet = require("src.sets.charactersThatStartWithAnActiveItemSet")
+local CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET = ____charactersThatStartWithAnActiveItemSet.CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET
+local ____charactersWithBlackHeartFromEternalHeartSet = require("src.sets.charactersWithBlackHeartFromEternalHeartSet")
+local CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET = ____charactersWithBlackHeartFromEternalHeartSet.CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET
+local ____charactersWithFreeDevilDealsSet = require("src.sets.charactersWithFreeDevilDealsSet")
+local CHARACTERS_WITH_FREE_DEVIL_DEALS_SET = ____charactersWithFreeDevilDealsSet.CHARACTERS_WITH_FREE_DEVIL_DEALS_SET
+local ____charactersWithNoRedHeartsSet = require("src.sets.charactersWithNoRedHeartsSet")
+local CHARACTERS_WITH_NO_RED_HEARTS_SET = ____charactersWithNoRedHeartsSet.CHARACTERS_WITH_NO_RED_HEARTS_SET
+local ____charactersWithNoSoulHeartsSet = require("src.sets.charactersWithNoSoulHeartsSet")
+local CHARACTERS_WITH_NO_SOUL_HEARTS_SET = ____charactersWithNoSoulHeartsSet.CHARACTERS_WITH_NO_SOUL_HEARTS_SET
+local ____lostStyleCharactersSet = require("src.sets.lostStyleCharactersSet")
+local LOST_STYLE_CHARACTERS_SET = ____lostStyleCharactersSet.LOST_STYLE_CHARACTERS_SET
+function ____exports.isModdedCharacter(self, character)
+    return not ____exports.isVanillaCharacter(nil, character)
+end
+function ____exports.isVanillaCharacter(self, character)
+    return character <= LAST_VANILLA_CHARACTER
+end
+--- Helper function to determine if the given character can have red heart containers. Returns true
+-- for characters like Isaac, Magdalene, or Cain. Returns true for Keeper and Tainted Keeper, even
+-- though coin containers are not technically the same as red heart containers. Returns false for
+-- characters like Blue Baby. Returns false for The Lost and Tainted Lost.
+function ____exports.characterCanHaveRedHearts(self, character)
+    return not CHARACTERS_WITH_NO_RED_HEARTS_SET:has(character)
+end
+--- Helper function to determine if the given character can have soul hearts. Returns true for
+-- characters like Isaac, Magdalene, or Cain. Returns false for characters like Bethany. Returns
+-- false for The Lost and Tainted Lost.
+function ____exports.characterCanHaveSoulHearts(self, character)
+    return not CHARACTERS_WITH_NO_SOUL_HEARTS_SET:has(character)
+end
+--- Helper function for determining whether the given character can take free Devil Deals. (e.g. The
+-- Lost, Tainted Lost, etc.)
+function ____exports.characterCanTakeFreeDevilDeals(self, character)
+    return CHARACTERS_WITH_FREE_DEVIL_DEALS_SET:has(character)
+end
+--- Normally, characters get a red heart container upon reaching a new floor with an eternal heart,
+-- but some characters grant a black heart instead. Returns true for Dark Judas and Tainted Judas.
+-- Otherwise, returns false.
+function ____exports.characterGetsBlackHeartFromEternalHeart(self, character)
+    return CHARACTERS_WITH_BLACK_HEART_FROM_ETERNAL_HEART_SET:has(character)
+end
+--- Helper function to determine if the specified character starts with an active item.
+-- 
+-- For the purposes of this function, the save file is considered to be fully unlocked (e.g. Isaac
+-- is considered to starts with the D6, but this is not the case on a brand new save file).
+function ____exports.characterStartsWithActiveItem(self, character)
+    return CHARACTERS_THAT_START_WITH_AN_ACTIVE_ITEM_SET:has(character)
+end
+--- Helper function to get the numerical damage multiplier for a character.
+function ____exports.getCharacterDamageMultiplier(self, character, hasWhoreOfBabylon)
+    if hasWhoreOfBabylon == nil then
+        hasWhoreOfBabylon = false
+    end
+    if character == PlayerType.EVE and hasWhoreOfBabylon then
+        return 1
+    end
+    return CHARACTER_DAMAGE_MULTIPLIERS[character]
+end
+--- - Most characters have a 56 frame death animation (i.e. the "Death" animation).
+-- - The Lost and Tainted Lost have a 38 frame death animation (i.e. the "LostDeath" animation).
+-- - Tainted Forgotten have a 20 frame death animation (i.e. the "ForgottenDeath" animation).
+function ____exports.getCharacterDeathAnimationName(self, character)
+    if LOST_STYLE_CHARACTERS_SET:has(character) then
+        return "LostDeath"
+    end
+    if character == PlayerType.THE_FORGOTTEN_B then
+        return "ForgottenDeath"
+    end
+    return "Death"
+end
+--- Returns the maximum heart containers that the provided character can have. Normally, this is 12,
+-- but with Keeper it is 3, and with Tainted Keeper it is 2. This does not account for Birthright or
+-- Mother's Kiss; use the `getPlayerMaxHeartContainers` helper function for that.
+function ____exports.getCharacterMaxHeartContainers(self, character)
+    if character == PlayerType.KEEPER then
+        return 3
+    end
+    if character == PlayerType.THE_FORGOTTEN then
+        return 6
+    end
+    if character == PlayerType.THE_SOUL then
+        return 6
+    end
+    if character == PlayerType.KEEPER_B then
+        return 2
+    end
+    return 12
+end
+--- Helper function to get the name of a character. Returns "Unknown" for modded characters.
+function ____exports.getCharacterName(self, character)
+    if ____exports.isModdedCharacter(nil, character) then
+        return "Unknown"
+    end
+    return CHARACTER_NAMES[character]
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"charge.d.ts","sourceRoot":"","sources":["../../../src/functions/charge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKX,MAAM,8BAA8B,CAAC;AAStC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,SAAI,EACd,eAAe,UAAO,GACrB,GAAG,CA2BL;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CAaN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,EACtB,mBAAmB,UAAO,EAC1B,eAAe,UAAO,GACrB,IAAI,CAkBN;AAuED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,mBAAmB,UAAO,GAAG,IAAI,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAKL;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,OAAO,CAMT;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,IAAI,CAYN"}

package/dist/src/functions/charge.lua

@@ -0,0 +1,219 @@
+local ____exports = {}
+local getClampedChargesToAdd, getChargesToAddWithAAAModifier, shouldPlayFullRechargeSound
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local ItemConfigChargeType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigChargeType
+local SoundEffect = ____isaac_2Dtypescript_2Ddefinitions.SoundEffect
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local sfxManager = ____cachedClasses.sfxManager
+local ____collectibles = require("src.functions.collectibles")
+local getCollectibleChargeType = ____collectibles.getCollectibleChargeType
+local getCollectibleMaxCharges = ____collectibles.getCollectibleMaxCharges
+local ____playerIndex = require("src.functions.playerIndex")
+local getPlayers = ____playerIndex.getPlayers
+local ____roomShape = require("src.functions.roomShape")
+local getRoomShapeCharges = ____roomShape.getRoomShapeCharges
+--- Helper function to add a charge to the player's active item. Will flash the HUD and play the
+-- appropriate sound effect, depending on whether the charge is partially full or completely full.
+-- 
+-- If the player's active item is already fully charged, then this function will return 0 and not
+-- flash the HUD or play a sound effect.
+-- 
+-- This function will take the following things into account:
+-- - The Battery
+-- - AAA Battery
+-- 
+-- @param player The player to grant the charges to.
+-- @param activeSlot The slot to grant the charges to.
+-- @param numCharges Optional. The amount of charges to grant. Default is 1.
+-- @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+-- @returns The amount of charges that were actually granted. For example, if the active item was
+-- only one away from a full charge, but the `numCharges` provided to this function was 2,
+-- then this function would return 1.
+function ____exports.addCharge(self, player, activeSlot, numCharges, playSoundEffect)
+    if numCharges == nil then
+        numCharges = 1
+    end
+    if playSoundEffect == nil then
+        playSoundEffect = true
+    end
+    local hud = game:GetHUD()
+    local chargesToAdd = getClampedChargesToAdd(nil, player, activeSlot, numCharges)
+    local modifiedChargesToAdd = getChargesToAddWithAAAModifier(nil, player, activeSlot, chargesToAdd)
+    local totalCharge = ____exports.getTotalCharge(nil, player, activeSlot)
+    local newCharge = totalCharge + modifiedChargesToAdd
+    if newCharge == totalCharge then
+        return 0
+    end
+    player:SetActiveCharge(newCharge, activeSlot)
+    hud:FlashChargeBar(player, activeSlot)
+    if playSoundEffect then
+        ____exports.playChargeSoundEffect(nil, player, activeSlot)
+    end
+    return modifiedChargesToAdd
+end
+--- Helper function to add a charge to one of a player's active items, emulating what happens when a
+-- room is cleared.
+-- 
+-- This function will take the following things into account:
+-- - L rooms and 2x2 rooms granting a double charge
+-- - The Battery
+-- - AAA Battery
+-- - Not charging active items with `chargetype="special"`
+-- 
+-- @param player The player to grant the charges to.
+-- @param activeSlot The active item slot to grant the charges to.
+-- @param bigRoomDoubleCharge Optional. If set to false, it will treat the current room as a 1x1
+-- room for the purposes of calculating how much charge to grant. Default
+-- is true.
+-- @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+function ____exports.addRoomClearChargeToSlot(self, player, activeSlot, bigRoomDoubleCharge, playSoundEffect)
+    if bigRoomDoubleCharge == nil then
+        bigRoomDoubleCharge = true
+    end
+    if playSoundEffect == nil then
+        playSoundEffect = true
+    end
+    local activeItem = player:GetActiveItem(activeSlot)
+    if activeItem == CollectibleType.NULL then
+        return
+    end
+    local chargeType = getCollectibleChargeType(nil, activeItem)
+    if chargeType == ItemConfigChargeType.SPECIAL then
+        return
+    end
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local numCharges = bigRoomDoubleCharge and getRoomShapeCharges(nil, roomShape) or 1
+    ____exports.addCharge(
+        nil,
+        player,
+        activeSlot,
+        numCharges,
+        playSoundEffect
+    )
+end
+function getClampedChargesToAdd(self, player, activeSlot, numCharges)
+    local activeItem = player:GetActiveItem(activeSlot)
+    local activeCharge = player:GetActiveCharge(activeSlot)
+    local batteryCharge = player:GetBatteryCharge(activeSlot)
+    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
+    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
+    if not hasBattery and activeCharge == maxCharges then
+        return 0
+    end
+    if hasBattery and batteryCharge == maxCharges then
+        return 0
+    end
+    if not hasBattery and activeCharge + 1 == maxCharges then
+        return 1
+    end
+    if hasBattery and batteryCharge + 1 == maxCharges then
+        return 1
+    end
+    return numCharges
+end
+function getChargesToAddWithAAAModifier(self, player, activeSlot, chargesToAdd)
+    local activeItem = player:GetActiveItem(activeSlot)
+    local activeCharge = player:GetActiveCharge(activeSlot)
+    local batteryCharge = player:GetBatteryCharge(activeSlot)
+    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
+    local hasAAABattery = player:HasTrinket(TrinketType.AAA_BATTERY)
+    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
+    if not hasAAABattery then
+        return chargesToAdd
+    end
+    if not hasBattery and activeCharge + chargesToAdd == maxCharges - 1 then
+        return chargesToAdd + 1
+    end
+    if hasBattery and batteryCharge + chargesToAdd == maxCharges - 1 then
+        return chargesToAdd + 1
+    end
+    return chargesToAdd
+end
+--- Helper function to get the combined normal charge and the battery charge for the player's active
+-- item. This is useful because you have to add these two values together when setting the active
+-- charge.
+function ____exports.getTotalCharge(self, player, activeSlot)
+    local activeCharge = player:GetActiveCharge(activeSlot)
+    local batteryCharge = player:GetBatteryCharge(activeSlot)
+    return activeCharge + batteryCharge
+end
+function ____exports.playChargeSoundEffect(self, player, activeSlot)
+    for ____, soundEffect in ipairs({SoundEffect.BATTERY_CHARGE, SoundEffect.BEEP}) do
+        sfxManager:Stop(soundEffect)
+    end
+    local chargeSoundEffect = shouldPlayFullRechargeSound(nil, player, activeSlot) and SoundEffect.BATTERY_CHARGE or SoundEffect.BEEP
+    sfxManager:Play(chargeSoundEffect)
+end
+function shouldPlayFullRechargeSound(self, player, activeSlot)
+    local activeItem = player:GetActiveItem(activeSlot)
+    local activeCharge = player:GetActiveCharge(activeSlot)
+    local batteryCharge = player:GetBatteryCharge(activeSlot)
+    local hasBattery = player:HasCollectible(CollectibleType.BATTERY)
+    local maxCharges = getCollectibleMaxCharges(nil, activeItem)
+    if not hasBattery then
+        return activeCharge == maxCharges
+    end
+    return batteryCharge == maxCharges or activeCharge == maxCharges and batteryCharge == 0
+end
+--- Helper function to add a charge to a player's active item(s), emulating what happens when a room
+-- is cleared.
+-- 
+-- This function will take the following things into account:
+-- - 2x2 rooms and L rooms granting a double charge
+-- - The Battery
+-- - AAA Battery
+-- - Not charging active items with `chargetype="special"`
+-- 
+-- @param player The player to grant the charges to.
+-- @param bigRoomDoubleCharge Optional. If set to false, it will treat the current room as a 1x1
+-- room for the purposes of calculating how much charge to grant. Default
+-- is true.
+-- @param playSoundEffect Optional. Whether to play a charge-related sound effect. Default is true.
+function ____exports.addRoomClearCharge(self, player, bigRoomDoubleCharge, playSoundEffect)
+    if bigRoomDoubleCharge == nil then
+        bigRoomDoubleCharge = true
+    end
+    if playSoundEffect == nil then
+        playSoundEffect = true
+    end
+    for ____, activeSlot in ipairs({ActiveSlot.PRIMARY, ActiveSlot.SECONDARY, ActiveSlot.POCKET}) do
+        ____exports.addRoomClearChargeToSlot(
+            nil,
+            player,
+            activeSlot,
+            bigRoomDoubleCharge,
+            playSoundEffect
+        )
+    end
+end
+--- Helper function to add a charge to every player's active item, emulating what happens when a room
+-- is cleared.
+-- 
+-- This function will take the following things into account:
+-- - L rooms and 2x2 rooms granting a double charge
+-- - The Battery
+-- - AAA Battery
+-- 
+-- @param bigRoomDoubleCharge Optional. If set to false, it will treat the current room as a 1x1
+-- room for the purposes of calculating how much charge to grant. Default
+-- is true.
+function ____exports.addRoomClearCharges(self, bigRoomDoubleCharge)
+    if bigRoomDoubleCharge == nil then
+        bigRoomDoubleCharge = true
+    end
+    for ____, player in ipairs(getPlayers(nil)) do
+        ____exports.addRoomClearCharge(nil, player, bigRoomDoubleCharge)
+    end
+end
+function ____exports.isActiveSlotDoubleCharged(self, player, activeSlot)
+    local collectibleType = player:GetActiveItem(activeSlot)
+    local batteryCharge = player:GetBatteryCharge(activeSlot)
+    local maxCharges = getCollectibleMaxCharges(nil, collectibleType)
+    return batteryCharge >= maxCharges
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"chargeBar.d.ts","sourceRoot":"","sources":["../../../src/functions/chargeBar.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,GAAG,GAAG,gBAAgB,CAwBrE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,EAClB,cAAc,EAAE,GAAG,GAClB,IAAI,CAgBN"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectibleCacheFlag.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibleCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA+B1E,iGAAiG;AACjG,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,eAAe,CAAC,CAS9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,eAAe,EAAE,CAanB"}

package/dist/src/functions/collectibleCacheFlag.lua

@@ -0,0 +1,90 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
+local ____cachedClasses = require("src.core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____collectibleSet = require("src.functions.collectibleSet")
+local getCollectibleArray = ____collectibleSet.getCollectibleArray
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____set = require("src.functions.set")
+local getSortedSetValues = ____set.getSortedSetValues
+local ____utils = require("src.functions.utils")
+local ____repeat = ____utils["repeat"]
+--- Helper function to check in the item config if a given collectible has a given cache flag.
+function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return false
+    end
+    return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
+end
+local CACHE_FLAG_TO_COLLECTIBLES_MAP = __TS__New(Map)
+local function lazyInitCacheFlagMap(self)
+    if CACHE_FLAG_TO_COLLECTIBLES_MAP.size > 0 then
+        return
+    end
+    for ____, cacheFlag in ipairs(getEnumValues(nil, CacheFlag)) do
+        local collectiblesSet = __TS__New(Set)
+        for ____, collectibleType in ipairs(getCollectibleArray(nil)) do
+            if ____exports.collectibleHasCacheFlag(nil, collectibleType, cacheFlag) then
+                collectiblesSet:add(collectibleType)
+            end
+        end
+        CACHE_FLAG_TO_COLLECTIBLES_MAP:set(cacheFlag, collectiblesSet)
+    end
+end
+--- Returns a set containing every collectible type with the given cache flag, including modded
+-- collectibles.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getCollectiblesForCacheFlag(self, cacheFlag)
+    lazyInitCacheFlagMap(nil)
+    local collectiblesSet = CACHE_FLAG_TO_COLLECTIBLES_MAP:get(cacheFlag)
+    if collectiblesSet == nil then
+        return __TS__New(Set)
+    end
+    return collectiblesSet
+end
+--- Returns an array containing every collectible type that the player has that matches the provided
+-- `CacheFlag`.
+-- 
+-- For example, if the cache flag is `CacheFlag.FLYING`, and the player has one Lord of the Pit and
+-- two Dead Doves, then this function would return:
+-- 
+-- ```ts
+-- [
+--   CollectibleType.LORD_OF_THE_PIT,
+--   CollectibleType.DEAD_DOVE,
+--   CollectibleType.DEAD_DOVE,
+-- ]
+-- ```
+-- 
+-- Note that this array will not include collectibles that the player does not really have, like
+-- Lilith's Incubus.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getPlayerCollectiblesForCacheFlag(self, player, cacheFlag)
+    local collectiblesForCacheFlag = ____exports.getCollectiblesForCacheFlag(nil, cacheFlag)
+    local playerCollectibles = {}
+    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectiblesForCacheFlag)) do
+        local numCollectibles = player:GetCollectibleNum(collectibleType, true)
+        ____repeat(
+            nil,
+            numCollectibles,
+            function()
+                playerCollectibles[#playerCollectibles + 1] = collectibleType
+            end
+        )
+    end
+    return playerCollectibles
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectibleSet.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibleSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAwD/D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,eAAe,EAAE,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,eAAe,EAAE,CAGtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGtE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,SAAS,eAAe,EAAE,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,eAAe,CAAC,CAGvE"}

package/dist/src/functions/collectibleSet.lua

@@ -0,0 +1,111 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____cachedClasses = require("src.core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____firstLast = require("src.features.firstLast")
+local getModdedCollectibleTypes = ____firstLast.getModdedCollectibleTypes
+local ____collectibles = require("src.functions.collectibles")
+local getVanillaCollectibleTypeRange = ____collectibles.getVanillaCollectibleTypeRange
+local ALL_COLLECTIBLE_TYPES_ARRAY = {}
+local ALL_COLLECTIBLE_TYPES_SET = __TS__New(Set)
+local VANILLA_COLLECTIBLE_TYPES_ARRAY = {}
+local VANILLA_COLLECTIBLE_TYPES_SET = __TS__New(Set)
+local MODDED_COLLECTIBLE_TYPES_ARRAY = {}
+local MODDED_COLLECTIBLE_TYPES_SET = __TS__New(Set)
+local function lazyInitVanillaCollectibleTypes(self)
+    if #VANILLA_COLLECTIBLE_TYPES_ARRAY > 0 then
+        return
+    end
+    local vanillaCollectibleTypeRange = getVanillaCollectibleTypeRange(nil)
+    for ____, collectibleType in ipairs(vanillaCollectibleTypeRange) do
+        local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+        if itemConfigItem ~= nil then
+            VANILLA_COLLECTIBLE_TYPES_ARRAY[#VANILLA_COLLECTIBLE_TYPES_ARRAY + 1] = collectibleType
+            VANILLA_COLLECTIBLE_TYPES_SET:add(collectibleType)
+        end
+    end
+end
+local function lazyInitModdedCollectibleTypes(self)
+    if #MODDED_COLLECTIBLE_TYPES_ARRAY > 0 then
+        return
+    end
+    lazyInitVanillaCollectibleTypes(nil)
+    for ____, collectibleType in ipairs(VANILLA_COLLECTIBLE_TYPES_ARRAY) do
+        ALL_COLLECTIBLE_TYPES_ARRAY[#ALL_COLLECTIBLE_TYPES_ARRAY + 1] = collectibleType
+        ALL_COLLECTIBLE_TYPES_SET:add(collectibleType)
+    end
+    local moddedCollectibleTypes = getModdedCollectibleTypes(nil)
+    for ____, collectibleType in ipairs(moddedCollectibleTypes) do
+        local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+        if itemConfigItem ~= nil then
+            MODDED_COLLECTIBLE_TYPES_ARRAY[#MODDED_COLLECTIBLE_TYPES_ARRAY + 1] = collectibleType
+            MODDED_COLLECTIBLE_TYPES_SET:add(collectibleType)
+            ALL_COLLECTIBLE_TYPES_ARRAY[#ALL_COLLECTIBLE_TYPES_ARRAY + 1] = collectibleType
+            ALL_COLLECTIBLE_TYPES_SET:add(collectibleType)
+        end
+    end
+end
+--- Returns an array containing every valid collectible type in the game, including modded
+-- collectibles.
+-- 
+-- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+-- then use the `getCollectibleSet` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getCollectibleArray(self)
+    lazyInitModdedCollectibleTypes(nil)
+    return ALL_COLLECTIBLE_TYPES_ARRAY
+end
+--- Returns a set containing every valid collectible type in the game, including modded collectibles.
+-- 
+-- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+-- then use the `getCollectibleArray` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getCollectibleSet(self)
+    lazyInitModdedCollectibleTypes(nil)
+    return ALL_COLLECTIBLE_TYPES_SET
+end
+--- Returns an array containing every modded collectible type in the game.
+-- 
+-- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+-- then use the `getModdedCollectibleSet` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getModdedCollectibleArray(self)
+    lazyInitModdedCollectibleTypes(nil)
+    return MODDED_COLLECTIBLE_TYPES_ARRAY
+end
+--- Returns a set containing every modded collectible type in the game.
+-- 
+-- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+-- then use the `getModdedCollectibleArray` helper function instead.
+-- 
+-- This function can only be called if at least one callback has been executed. This is because not
+-- all collectibles will necessarily be present when a mod first loads (due to mod load order).
+function ____exports.getModdedCollectibleSet(self)
+    lazyInitModdedCollectibleTypes(nil)
+    return MODDED_COLLECTIBLE_TYPES_SET
+end
+--- Returns an array containing every valid vanilla collectible type in the game.
+-- 
+-- Use this if you need to iterate over the collectibles in order. If you need to do O(1) lookups,
+-- then use the `getVanillaCollectibleSet` helper function instead.
+function ____exports.getVanillaCollectibleArray(self)
+    lazyInitVanillaCollectibleTypes(nil)
+    return VANILLA_COLLECTIBLE_TYPES_ARRAY
+end
+--- Returns a set containing every valid vanilla collectible type in the game.
+-- 
+-- Use this if you need to do O(1) lookups. If you need to iterate over the collectibles in order,
+-- then use the `getVanillaCollectibleArray` helper function instead.
+function ____exports.getVanillaCollectibleSet(self)
+    lazyInitVanillaCollectibleTypes(nil)
+    return VANILLA_COLLECTIBLE_TYPES_SET
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectibleTag.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibleTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAoC9E,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,aAAa,GACjB,OAAO,CAOT;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,GAC3B,WAAW,CAAC,eAAe,CAAC,CAc9B;AAED,yFAAyF;AACzF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,aAAa,GAC3B,GAAG,CAGL;AAED,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAE5E"}

package/dist/src/functions/collectibleTag.lua

@@ -0,0 +1,81 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Spread = ____lualib.__TS__Spread
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
+local ____cachedClasses = require("src.core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____collectibleSet = require("src.functions.collectibleSet")
+local getCollectibleArray = ____collectibleSet.getCollectibleArray
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____flag = require("src.functions.flag")
+local getFlagName = ____flag.getFlagName
+local ____players = require("src.functions.players")
+local getPlayerCollectibleCount = ____players.getPlayerCollectibleCount
+function ____exports.collectibleHasTag(self, collectibleType, tag)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    if itemConfigItem == nil then
+        return false
+    end
+    return itemConfigItem:HasTags(tag)
+end
+local TAG_TO_COLLECTIBLE_TYPES_MAP = __TS__New(Map)
+local function initTagMap(self)
+    for ____, itemConfigTag in ipairs(getEnumValues(nil, ItemConfigTag)) do
+        TAG_TO_COLLECTIBLE_TYPES_MAP:set(
+            itemConfigTag,
+            __TS__New(Set)
+        )
+    end
+    for ____, collectibleType in ipairs(getCollectibleArray(nil)) do
+        for ____, itemConfigTag in ipairs(getEnumValues(nil, ItemConfigTag)) do
+            do
+                if not ____exports.collectibleHasTag(nil, collectibleType, itemConfigTag) then
+                    goto __continue6
+                end
+                local collectibleTypesSet = TAG_TO_COLLECTIBLE_TYPES_MAP:get(itemConfigTag)
+                if collectibleTypesSet == nil then
+                    local flagName = getFlagName(nil, itemConfigTag, ItemConfigTag)
+                    error("Failed to get the collectible types for item tag: " .. tostring(flagName))
+                end
+                collectibleTypesSet:add(collectibleType)
+            end
+            ::__continue6::
+        end
+    end
+end
+--- Helper function to get all of the collectible types in the game that have a certain tag.
+-- 
+-- For example, to get all of the collectible types that count as offensive for the purposes of
+-- Tainted Lost:
+-- 
+-- ```ts
+-- const offensiveCollectibleTypes = getCollectibleTypesWithTag(ItemConfigTag.OFFENSIVE);
+-- ```
+function ____exports.getCollectibleTypesWithTag(self, itemConfigTag)
+    if TAG_TO_COLLECTIBLE_TYPES_MAP.size == 0 then
+        initTagMap(nil)
+    end
+    local collectibleTypes = TAG_TO_COLLECTIBLE_TYPES_MAP:get(itemConfigTag)
+    if collectibleTypes == nil then
+        error(("The item config tag of " .. tostring(itemConfigTag)) .. " is not a valid value of the ItemConfigTag enum.")
+    end
+    return collectibleTypes
+end
+--- Returns the number of items that a player has towards a particular transformation.
+function ____exports.getPlayerNumCollectiblesWithTag(self, player, itemConfigTag)
+    local collectibleTypesSet = ____exports.getCollectibleTypesWithTag(nil, itemConfigTag)
+    return getPlayerCollectibleCount(
+        nil,
+        player,
+        __TS__Spread(collectibleTypesSet:values())
+    )
+end
+function ____exports.isQuestCollectible(self, collectibleType)
+    return ____exports.collectibleHasTag(nil, collectibleType, ItemConfigTag.QUEST)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"collectibles.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibles.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAEvB,eAAe,EAEf,oBAAoB,EACpB,aAAa,EAEb,QAAQ,EACR,WAAW,EAGZ,MAAM,8BAA8B,CAAC;AAgBtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAwB7D,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAEtE;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAsBT;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,oBAAoB,CAOtB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,eAAe,GAC/B,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,eAAe,GAC/B,GAAG,CAYL;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,YAAY,GACnB,WAAW,CAyBb;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,eAAe,GAC/B,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,YAAY,GACxB,gBAAgB,CAsBlB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,GAAG,CAOL;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,QAAQ,CAOV;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,GAAG,CAOL;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAc3E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,GACxB,uBAAuB,CAUzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,eAAe,GAAG,GAAG,CAO3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,eAAe,GAC/B,QAAQ,CAAC,aAAa,CAAC,CAGzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,EAAE,CAElE;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAG7E;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,GAAG,OAAO,CAcrE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAKnE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAGT;AAED,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAa7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,eAAe,GAC/B,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAS5E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAUnE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAuBtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,YAAY,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAqBN;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,YAAY,EACzB,kBAAkB,EAAE,eAAe,GAClC,IAAI,CA2BN;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,IAAI,IAAI,CAK5D"}