isaacscript-common 8.4.6 → 8.5.0

package/dist/functions/players.lua

@@ -1,7 +1,7 @@
 local ____lualib = require("lualib_bundle")
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__ArrayFind = ____lualib.__TS__ArrayFind
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
 local Map = ____lualib.Map
@@ -11,7 +11,6 @@ local ____exports = {}
 local isTaintedModded
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
-local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local FamiliarVariant = ____isaac_2Dtypescript_2Ddefinitions.FamiliarVariant
@@ -23,17 +22,10 @@ local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
 local itemConfig = ____cachedClasses.itemConfig
-local ____HealthType = require("enums.HealthType")
-local HealthType = ____HealthType.HealthType
 local ____array = require("functions.array")
 local getLastElement = ____array.getLastElement
 local sumArray = ____array.sumArray
-local ____bitwise = require("functions.bitwise")
-local countSetBits = ____bitwise.countSetBits
-local getKBitOfN = ____bitwise.getKBitOfN
-local getNumBitsOfN = ____bitwise.getNumBitsOfN
 local ____characters = require("functions.characters")
-local getCharacterMaxHeartContainers = ____characters.getCharacterMaxHeartContainers
 local getCharacterName = ____characters.getCharacterName
 local isVanillaCharacter = ____characters.isVanillaCharacter
 local ____collectibles = require("functions.collectibles")
@@ -46,8 +38,6 @@ local ____playerIndex = require("functions.playerIndex")
 local getAllPlayers = ____playerIndex.getAllPlayers
 local getPlayerIndexVanilla = ____playerIndex.getPlayerIndexVanilla
 local getPlayers = ____playerIndex.getPlayers
-local ____tears = require("functions.tears")
-local addTearsStat = ____tears.addTearsStat
 local ____types = require("functions.types")
 local isNumber = ____types.isNumber
 local ____utils = require("functions.utils")
@@ -60,47 +50,6 @@ function ____exports.getCharacters(self)
         function(____, player) return player:GetPlayerType() end
     )
 end
---- Returns the number of black hearts that the player has, excluding any soul hearts. For example,
--- if the player has one full black heart, one full soul heart, and one half black heart, this
--- function returns 3.
--- 
--- This is different from the `EntityPlayer.GetBlackHearts` method, since that returns a bitmask.
-function ____exports.getPlayerBlackHearts(self, player)
-    local blackHeartsBitmask = player:GetBlackHearts()
-    local blackHeartBits = countSetBits(nil, blackHeartsBitmask)
-    return blackHeartBits * 2
-end
---- Returns the maximum heart containers that the provided player can have. Normally, this is 12, but
--- it can change depending on the character (e.g. Keeper) and other things (e.g. Mother's Kiss).
--- This function does not account for Broken Hearts; use the `getPlayerAvailableHeartSlots` helper
--- function for that.
-function ____exports.getPlayerMaxHeartContainers(self, player)
-    local character = player:GetPlayerType()
-    local characterMaxHeartContainers = getCharacterMaxHeartContainers(nil, character)
-    if character == PlayerType.MAGDALENE and player:HasCollectible(CollectibleType.BIRTHRIGHT) then
-        local extraMaxHeartContainersFromBirthright = 6
-        return characterMaxHeartContainers + extraMaxHeartContainersFromBirthright
-    end
-    if ____exports.isKeeper(nil, player) then
-        local numMothersKisses = player:GetTrinketMultiplier(TrinketType.MOTHERS_KISS)
-        local hasGreedsGullet = player:HasCollectible(CollectibleType.GREEDS_GULLET)
-        local coins = player:GetNumCoins()
-        local greedsGulletCoinContainers = hasGreedsGullet and math.floor(coins / 25) or 0
-        return characterMaxHeartContainers + numMothersKisses + greedsGulletCoinContainers
-    end
-    return characterMaxHeartContainers
-end
---- Returns the number of soul hearts that the player has, excluding any black hearts. For example,
--- if the player has one full black heart, one full soul heart, and one half black heart, this
--- function returns 2.
--- 
--- This is different from the `EntityPlayer.GetSoulHearts` method, since that returns the combined
--- number of soul hearts and black hearts.
-function ____exports.getPlayerSoulHearts(self, player)
-    local soulHearts = player:GetSoulHearts()
-    local blackHearts = ____exports.getPlayerBlackHearts(nil, player)
-    return soulHearts - blackHearts
-end
 --- Helper function to check if a player is a specific character (i.e. `PlayerType`).
 -- 
 -- This function is variadic, meaning that you can supply as many characters as you want to check
@@ -111,12 +60,6 @@ function ____exports.isCharacter(self, player, ...)
     local character = player:GetPlayerType()
     return characterSet:has(character)
 end
---- Helper function for detecting when a player is Keeper or Tainted Keeper. Useful for situations
--- where you want to know if the health is coin hearts, for example.
-function ____exports.isKeeper(self, player)
-    local character = player:GetPlayerType()
-    return character == PlayerType.KEEPER or character == PlayerType.KEEPER_B
-end
 function ____exports.isModdedPlayer(self, player)
     return not ____exports.isVanillaPlayer(nil, player)
 end
@@ -130,14 +73,6 @@ function ____exports.isVanillaPlayer(self, player)
     local character = player:GetPlayerType()
     return isVanillaCharacter(nil, character)
 end
-local STAT_CACHE_FLAGS_SET = __TS__New(Set, {
-    CacheFlag.DAMAGE,
-    CacheFlag.FIRE_DELAY,
-    CacheFlag.SHOT_SPEED,
-    CacheFlag.RANGE,
-    CacheFlag.SPEED,
-    CacheFlag.LUCK
-})
 function ____exports.addCollectibleCostume(self, player, collectibleType)
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
     if itemConfigItem == nil then
@@ -145,69 +80,6 @@ function ____exports.addCollectibleCostume(self, player, collectibleType)
     end
     player:AddCostume(itemConfigItem, false)
 end
---- Helper function to add a stat to a player based on the `CacheFlag` provided. Call this function
--- from the `EVALUATE_CACHE` callback.
--- 
--- Note that for `CacheFlag.FIRE_DELAY`, the "amount" argument will be interpreted as the tear stat
--- to add (and not the amount to mutate `EntityPlayer.MaxFireDelay` by).
--- 
--- This function supports the following cache flags:
--- - CacheFlag.DAMAGE (1 << 0)
--- - CacheFlag.FIRE_DELAY (1 << 1)
--- - CacheFlag.SHOT_SPEED (1 << 2)
--- - CacheFlag.RANGE (1 << 3)
--- - CacheFlag.SPEED (1 << 4)
--- - CacheFlag.LUCK (1 << 10)
-function ____exports.addStat(self, player, cacheFlag, amount)
-    if not STAT_CACHE_FLAGS_SET:has(cacheFlag) then
-        error("You cannot add a stat to a player with the cache flag of: " .. tostring(cacheFlag))
-    end
-    repeat
-        local ____switch6 = cacheFlag
-        local ____cond6 = ____switch6 == CacheFlag.DAMAGE
-        if ____cond6 then
-            do
-                player.Damage = player.Damage + amount
-                break
-            end
-        end
-        ____cond6 = ____cond6 or ____switch6 == CacheFlag.FIRE_DELAY
-        if ____cond6 then
-            do
-                addTearsStat(nil, player, amount)
-                break
-            end
-        end
-        ____cond6 = ____cond6 or ____switch6 == CacheFlag.SHOT_SPEED
-        if ____cond6 then
-            do
-                player.ShotSpeed = player.ShotSpeed + amount
-                break
-            end
-        end
-        ____cond6 = ____cond6 or ____switch6 == CacheFlag.RANGE
-        if ____cond6 then
-            do
-                player.TearHeight = player.TearHeight + amount
-                break
-            end
-        end
-        ____cond6 = ____cond6 or ____switch6 == CacheFlag.SPEED
-        if ____cond6 then
-            do
-                player.MoveSpeed = player.MoveSpeed + amount
-                break
-            end
-        end
-        ____cond6 = ____cond6 or ____switch6 == CacheFlag.LUCK
-        if ____cond6 then
-            do
-                player.Luck = player.Luck + amount
-                break
-            end
-        end
-    until true
-end
 function ____exports.addTrinketCostume(self, player, trinketType)
     local itemConfigTrinket = itemConfig:GetTrinket(trinketType)
     if itemConfigTrinket == nil then
@@ -253,37 +125,6 @@ function ____exports.canPlayerCrushRocks(self, player)
     local effects = player:GetEffects()
     return player:HasCollectible(CollectibleType.LEO) or player:HasCollectible(CollectibleType.THUNDER_THIGHS) or effects:HasCollectibleEffect(CollectibleType.MEGA_MUSH) or player:HasPlayerForm(PlayerForm.STOMPY)
 end
---- Returns whether or not all of the player's soul-heart-type hearts are black hearts.
--- 
--- Note that this function does not consider red heart containers.
--- 
--- For example:
--- 
--- - If the player has one black heart, this function would return true.
--- - If the player has one soul heart and two black hearts, this function would return false.
--- - If the player has no black hearts, this function will return false.
--- - If the player has one red heart container and three black hearts, this function would return
---   true.
-function ____exports.doesPlayerHaveAllBlackHearts(self, player)
-    local soulHearts = ____exports.getPlayerSoulHearts(nil, player)
-    local blackHearts = ____exports.getPlayerBlackHearts(nil, player)
-    return blackHearts > 0 and soulHearts == 0
-end
---- Returns whether or not all of the player's soul-heart-type hearts are soul hearts.
--- 
--- Note that this function does not consider red heart containers.
--- 
--- For example:
--- 
--- - If the player has two soul hearts and one black heart, this function would return false.
--- - If the player has no soul hearts, this function will return false.
--- - If the player has one red heart container and three soul hearts, this function would return
---   true.
-function ____exports.doesPlayerHaveAllSoulHearts(self, player)
-    local soulHearts = ____exports.getPlayerSoulHearts(nil, player)
-    local blackHearts = ____exports.getPlayerBlackHearts(nil, player)
-    return soulHearts > 0 and blackHearts == 0
-end
 --- Helper function to find the active slot that the player has the corresponding collectible type
 -- in. Returns undefined if the player does not have the collectible in any active slot.
 function ____exports.getActiveItemSlot(self, player, collectibleType)
@@ -364,20 +205,6 @@ function ____exports.getNewestPlayer(self)
     end
     return newestPlayer
 end
---- Returns the number of slots that the player has remaining for new heart containers, accounting
--- for broken hearts. For example, if the player is Judas and has 1 red heart containers and 2 full
--- soul hearts and 3 broken hearts, then this function would return 6 (i.e. 12 - 1 - 2 - 3).
-function ____exports.getPlayerAvailableHeartSlots(self, player)
-    local maxHeartContainers = ____exports.getPlayerMaxHeartContainers(nil, player)
-    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
-    local normalAndBoneHeartContainers = effectiveMaxHearts / 2
-    local soulHearts = player:GetSoulHearts()
-    local soulHeartContainers = math.ceil(soulHearts / 2)
-    local totalHeartContainers = normalAndBoneHeartContainers + soulHeartContainers
-    local brokenHearts = player:GetBrokenHearts()
-    local totalOccupiedHeartSlots = totalHeartContainers + brokenHearts
-    return maxHeartContainers - totalOccupiedHeartSlots
-end
 --- Iterates over all players and checks if any are close enough to the specified position.
 -- 
 -- @returns The first player found when iterating upwards from index 0.
@@ -437,60 +264,6 @@ function ____exports.getPlayerFromTear(self, entity)
     end
     return nil
 end
---- Returns the number of red hearts that the player has, excluding any rotten hearts. For example,
--- if the player has one full black heart, one full soul heart, and one half black heart, this
--- function returns 3.
--- 
--- This is different from the `EntityPlayer.GetHearts` method, since that returns a value that
--- includes rotten hearts.
-function ____exports.getPlayerHearts(self, player)
-    local rottenHearts = player:GetRottenHearts()
-    local hearts = player:GetHearts()
-    return hearts - rottenHearts * 2
-end
---- Helper function that returns the type of the rightmost heart. This does not including golden
--- hearts or broken hearts, since they cannot be damaged directly.
-function ____exports.getPlayerLastHeart(self, player)
-    local hearts = player:GetHearts()
-    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
-    local soulHearts = player:GetSoulHearts()
-    local blackHearts = player:GetBlackHearts()
-    local eternalHearts = player:GetEternalHearts()
-    local boneHearts = player:GetBoneHearts()
-    local rottenHearts = player:GetRottenHearts()
-    local soulHeartSlots = soulHearts / 2
-    local lastHeartIndex = boneHearts + soulHeartSlots - 1
-    local isLastHeartBone = player:IsBoneHeart(lastHeartIndex)
-    if isLastHeartBone then
-        local isLastContainerEmpty = hearts <= effectiveMaxHearts - 2
-        if isLastContainerEmpty then
-            return HealthType.BONE
-        end
-        if rottenHearts > 0 then
-            return HealthType.ROTTEN
-        end
-        if eternalHearts > 0 then
-            return HealthType.ETERNAL
-        end
-        return HealthType.RED
-    end
-    if soulHearts > 0 then
-        local numBits = getNumBitsOfN(nil, blackHearts)
-        local finalBit = getKBitOfN(nil, numBits - 1, blackHearts)
-        local isBlack = finalBit == 1
-        if isBlack then
-            return HealthType.BLACK
-        end
-        return HealthType.SOUL
-    end
-    if eternalHearts > 0 then
-        return HealthType.ETERNAL
-    end
-    if rottenHearts > 0 then
-        return HealthType.ROTTEN
-    end
-    return HealthType.RED
-end
 --- Helper function to get the proper name of the player. Use this instead of the
 -- `EntityPlayer.GetName` method because it accounts for Blue Baby, Lazarus II, and Tainted
 -- characters.
@@ -559,20 +332,6 @@ function ____exports.getPlayersWithTrinket(self, ...)
         ) end
     )
 end
---- Helper function to determine how many heart containers that Tainted Magdalene has that will not
--- be automatically depleted over time. By default, this is 2, but this function will return 4 so
--- that it is consistent with the `player.GetHearts` and `player.GetMaxHearts` methods.
--- 
--- If Tainted Magdalene has Birthright, she will gained an additional non-temporary heart container.
--- 
--- This function does not validate whether or not the provided player is Tainted Magdalene; that
--- should be accomplished before invoking this function.
-function ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(self, player)
-    local maxHearts = player:GetMaxHearts()
-    local hasBirthright = player:HasCollectible(CollectibleType.BIRTHRIGHT)
-    local maxNonTemporaryMaxHearts = hasBirthright and 6 or 4
-    return math.min(maxHearts, maxNonTemporaryMaxHearts)
-end
 --- Returns the total number of collectibles amongst all players. For example, if player 1 has 1 Sad
 -- Onion and player 2 has 2 Sad Onions, then this function would return 3.
 function ____exports.getTotalPlayerCollectibles(self, collectibleType)
@@ -641,6 +400,12 @@ function ____exports.isJacobOrEsau(self, player)
     local character = player:GetPlayerType()
     return character == PlayerType.JACOB or character == PlayerType.ESAU
 end
+--- Helper function for detecting when a player is Keeper or Tainted Keeper. Useful for situations
+-- where you want to know if the health is coin hearts, for example.
+function ____exports.isKeeper(self, player)
+    local character = player:GetPlayerType()
+    return character == PlayerType.KEEPER or character == PlayerType.KEEPER_B
+end
 --- Helper function for detecting when a player is The Lost or Tainted Lost.
 function ____exports.isLost(self, player)
     local character = player:GetPlayerType()
@@ -690,7 +455,7 @@ function ____exports.removeAllActiveItems(self, player)
         do
             local collectibleType = player:GetActiveItem(activeSlot)
             if collectibleType == CollectibleType.NULL then
-                goto __continue114
+                goto __continue86
             end
             local hasCollectible
             repeat
@@ -700,7 +465,7 @@ function ____exports.removeAllActiveItems(self, player)
                 end
             until not hasCollectible
         end
-        ::__continue114::
+        ::__continue86::
     end
 end
 --- Helper function to remove all of the held trinkets from a player.
@@ -712,7 +477,7 @@ function ____exports.removeAllPlayerTrinkets(self, player)
         do
             local trinketType = player:GetTrinket(trinketSlot)
             if trinketType == TrinketType.NULL then
-                goto __continue119
+                goto __continue91
             end
             local hasTrinket
             repeat
@@ -722,7 +487,7 @@ function ____exports.removeAllPlayerTrinkets(self, player)
                 end
             until not hasTrinket
         end
-        ::__continue119::
+        ::__continue91::
     end
 end
 --- Helper function to remove a collectible costume from a player. Use this helper function to avoid
@@ -785,9 +550,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch132 = activeSlot
-        local ____cond132 = ____switch132 == ActiveSlot.PRIMARY
-        if ____cond132 then
+        local ____switch104 = activeSlot
+        local ____cond104 = ____switch104 == ActiveSlot.PRIMARY
+        if ____cond104 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -796,8 +561,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.SECONDARY
-        if ____cond132 then
+        ____cond104 = ____cond104 or ____switch104 == ActiveSlot.SECONDARY
+        if ____cond104 then
             do
                 if primaryCollectibleType ~= CollectibleType.NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -812,16 +577,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.POCKET
-        if ____cond132 then
+        ____cond104 = ____cond104 or ____switch104 == ActiveSlot.POCKET
+        if ____cond104 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond132 = ____cond132 or ____switch132 == ActiveSlot.POCKET_SINGLE_USE
-        if ____cond132 then
+        ____cond104 = ____cond104 or ____switch104 == ActiveSlot.POCKET_SINGLE_USE
+        if ____cond104 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break
@@ -870,28 +635,4 @@ function ____exports.useActiveItemTemp(self, player, collectibleType)
         -1
     )
 end
---- Helper function to see if a certain damage amount would deal "permanent" damage to Tainted
--- Magdalene.
--- 
--- Tainted Magdalene has "permanent" health and "temporary" health. When standing still and doing
--- nothing, all of Tainted Magdalene's temporary health will eventually go away.
--- 
--- Before using this function, it is expected that you check to see if the player is Tainted
--- Magdalene first, or else it will give a nonsensical result.
-function ____exports.wouldDamageTaintedMagdaleneNonTemporaryHeartContainers(self, player, damageAmount)
-    local soulHearts = player:GetSoulHearts()
-    if soulHearts > 0 then
-        return false
-    end
-    local boneHearts = player:GetBoneHearts()
-    if boneHearts > 0 then
-        return false
-    end
-    local hearts = player:GetHearts()
-    local rottenHearts = player:GetRottenHearts()
-    local effectiveDamageAmount = damageAmount + math.min(rottenHearts, damageAmount)
-    local heartsAfterDamage = hearts - effectiveDamageAmount
-    local nonTemporaryMaxHearts = ____exports.getTaintedMagdaleneNonTemporaryMaxHearts(nil, player)
-    return heartsAfterDamage < nonTemporaryMaxHearts
-end
 return ____exports

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

@@ -1 +1 @@
-{"version":3,"file":"revive.d.ts","sourceRoot":"","sources":["../../src/functions/revive.ts"],"names":[],"mappings":";;;AAsBA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,GAAG,GAAG,SAAS,GACnC,OAAO,CAuFT;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAavE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAYtE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAe1E"}
+{"version":3,"file":"revive.d.ts","sourceRoot":"","sources":["../../src/functions/revive.ts"],"names":[],"mappings":";;;AAkBA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,GAAG,GAAG,SAAS,GACnC,OAAO,CAuFT;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAavE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAYtE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAe1E"}

package/dist/functions/revive.lua

@@ -12,8 +12,9 @@ local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSE
 local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
 local ____characters = require("functions.characters")
 local getCharacterDeathAnimationName = ____characters.getCharacterDeathAnimationName
+local ____playerHealth = require("functions.playerHealth")
+local getPlayerMaxHeartContainers = ____playerHealth.getPlayerMaxHeartContainers
 local ____players = require("functions.players")
-local getPlayerMaxHeartContainers = ____players.getPlayerMaxHeartContainers
 local getPlayerNumHitsRemaining = ____players.getPlayerNumHitsRemaining
 local hasLostCurse = ____players.hasLostCurse
 local isKeeper = ____players.isKeeper

package/dist/functions/stats.d.ts

@@ -1,4 +1,20 @@
 import { CacheFlag } from "isaac-typescript-definitions";
+/**
+ * Helper function to add a stat to a player based on the `CacheFlag` provided. Call this function
+ * from the `EVALUATE_CACHE` callback.
+ *
+ * Note that for `CacheFlag.FIRE_DELAY`, the "amount" argument will be interpreted as the tear stat
+ * to add (and not the amount to mutate `EntityPlayer.MaxFireDelay` by).
+ *
+ * This function supports the following cache flags:
+ * - CacheFlag.DAMAGE (1 << 0)
+ * - CacheFlag.FIRE_DELAY (1 << 1)
+ * - CacheFlag.SHOT_SPEED (1 << 2)
+ * - CacheFlag.RANGE (1 << 3)
+ * - CacheFlag.SPEED (1 << 4)
+ * - CacheFlag.LUCK (1 << 10)
+ */
+export declare function addStat(player: EntityPlayer, cacheFlag: CacheFlag, amount: number): void;
 /**
  * Returns the starting stat that Isaac (the default character) starts with. For example, if you
  * pass this function `CacheFlag.DAMAGE`, it will return 3.5.

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

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/functions/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/functions/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAazD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,CA4CN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAE7E"}

package/dist/functions/stats.lua

@@ -1,6 +1,84 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
 local ____defaultPlayerStatMap = require("maps.defaultPlayerStatMap")
 local DEFAULT_PLAYER_STAT_MAP = ____defaultPlayerStatMap.DEFAULT_PLAYER_STAT_MAP
+local ____tears = require("functions.tears")
+local addTearsStat = ____tears.addTearsStat
+local STAT_CACHE_FLAGS_SET = __TS__New(Set, {
+    CacheFlag.DAMAGE,
+    CacheFlag.FIRE_DELAY,
+    CacheFlag.SHOT_SPEED,
+    CacheFlag.RANGE,
+    CacheFlag.SPEED,
+    CacheFlag.LUCK
+})
+--- Helper function to add a stat to a player based on the `CacheFlag` provided. Call this function
+-- from the `EVALUATE_CACHE` callback.
+-- 
+-- Note that for `CacheFlag.FIRE_DELAY`, the "amount" argument will be interpreted as the tear stat
+-- to add (and not the amount to mutate `EntityPlayer.MaxFireDelay` by).
+-- 
+-- This function supports the following cache flags:
+-- - CacheFlag.DAMAGE (1 << 0)
+-- - CacheFlag.FIRE_DELAY (1 << 1)
+-- - CacheFlag.SHOT_SPEED (1 << 2)
+-- - CacheFlag.RANGE (1 << 3)
+-- - CacheFlag.SPEED (1 << 4)
+-- - CacheFlag.LUCK (1 << 10)
+function ____exports.addStat(self, player, cacheFlag, amount)
+    if not STAT_CACHE_FLAGS_SET:has(cacheFlag) then
+        error("You cannot add a stat to a player with the cache flag of: " .. tostring(cacheFlag))
+    end
+    repeat
+        local ____switch4 = cacheFlag
+        local ____cond4 = ____switch4 == CacheFlag.DAMAGE
+        if ____cond4 then
+            do
+                player.Damage = player.Damage + amount
+                break
+            end
+        end
+        ____cond4 = ____cond4 or ____switch4 == CacheFlag.FIRE_DELAY
+        if ____cond4 then
+            do
+                addTearsStat(nil, player, amount)
+                break
+            end
+        end
+        ____cond4 = ____cond4 or ____switch4 == CacheFlag.SHOT_SPEED
+        if ____cond4 then
+            do
+                player.ShotSpeed = player.ShotSpeed + amount
+                break
+            end
+        end
+        ____cond4 = ____cond4 or ____switch4 == CacheFlag.RANGE
+        if ____cond4 then
+            do
+                player.TearHeight = player.TearHeight + amount
+                break
+            end
+        end
+        ____cond4 = ____cond4 or ____switch4 == CacheFlag.SPEED
+        if ____cond4 then
+            do
+                player.MoveSpeed = player.MoveSpeed + amount
+                break
+            end
+        end
+        ____cond4 = ____cond4 or ____switch4 == CacheFlag.LUCK
+        if ____cond4 then
+            do
+                player.Luck = player.Luck + amount
+                break
+            end
+        end
+    until true
+end
 --- Returns the starting stat that Isaac (the default character) starts with. For example, if you
 -- pass this function `CacheFlag.DAMAGE`, it will return 3.5.
 -- 

package/dist/functions/transformations.d.ts

@@ -9,7 +9,7 @@ import { CollectibleType, PlayerForm } from "isaac-typescript-definitions";
  * const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.GUPPY);
  * ```
  */
-export declare function getCollectibleTypesForTransformation(playerForm: PlayerForm): Set<CollectibleType>;
+export declare function getCollectibleTypesForTransformation(playerForm: PlayerForm): ReadonlySet<CollectibleType>;
 /** Returns the number of items that a player has towards a particular transformation. */
 export declare function getPlayerNumCollectiblesForTransformation(player: EntityPlayer, playerForm: PlayerForm): int;
 /** Returns a set of the player's current transformations. */

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

@@ -1 +1 @@
-{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../src/functions/transformations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,8BAA8B,CAAC;AAiCtC;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,UAAU,GACrB,GAAG,CAAC,eAAe,CAAC,CAStB;AAED,yFAAyF;AACzF,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAGL;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,UAAU,CAAC,CASjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEpE;AAED,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,eAAe,GAC/B,GAAG,CAAC,UAAU,CAAC,CAiBjB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAQrE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtE"}
+{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../src/functions/transformations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,UAAU,EACX,MAAM,8BAA8B,CAAC;AAiCtC;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,UAAU,GACrB,WAAW,CAAC,eAAe,CAAC,CAS9B;AAED,yFAAyF;AACzF,wBAAgB,yCAAyC,CACvD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACrB,GAAG,CAGL;AAED,6DAA6D;AAC7D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GACnB,GAAG,CAAC,UAAU,CAAC,CASjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEpE;AAED,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,eAAe,GAC/B,GAAG,CAAC,UAAU,CAAC,CAiBjB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAQrE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtE"}

package/dist/functions/trinketCacheFlag.d.ts

@@ -13,7 +13,7 @@ export declare function getPlayerTrinketsForCacheFlag(player: EntityPlayer, cach
  * This function can only be called if at least one callback has been executed. This is because not
  * all trinkets will necessarily be present when a mod first loads (due to mod load order).
  */
-export declare function getTrinketsForCacheFlag(cacheFlag: CacheFlag): Set<TrinketType>;
+export declare function getTrinketsForCacheFlag(cacheFlag: CacheFlag): ReadonlySet<TrinketType>;
 /** Helper function to check in the item config if a given trinket has a given cache flag. */
 export declare function trinketHasCacheFlag(trinketType: TrinketType, cacheFlag: CacheFlag): boolean;
 //# sourceMappingURL=trinketCacheFlag.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"trinketCacheFlag.d.ts","sourceRoot":"","sources":["../../src/functions/trinketCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA2BtE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAYvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,CAAC,CASlB;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}
+{"version":3,"file":"trinketCacheFlag.d.ts","sourceRoot":"","sources":["../../src/functions/trinketCacheFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA0BtE;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAYvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,WAAW,CAAC,CAS1B;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,GACnB,OAAO,CAOT"}

package/dist/functions/trinketCacheFlag.lua

@@ -15,8 +15,6 @@ local ____enums = require("functions.enums")
 local getEnumValues = ____enums.getEnumValues
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
-local ____set = require("functions.set")
-local copySet = ____set.copySet
 function lazyInitCacheFlagMap(self)
     if CACHE_FLAG_TO_TRINKETS_MAP.size > 0 then
         return
@@ -41,7 +39,7 @@ function ____exports.getTrinketsForCacheFlag(self, cacheFlag)
     if trinketsSet == nil then
         return __TS__New(Set)
     end
-    return copySet(nil, trinketsSet)
+    return trinketsSet
 end
 --- Helper function to check in the item config if a given trinket has a given cache flag.
 function ____exports.trinketHasCacheFlag(self, trinketType, cacheFlag)