isaacscript-common 1.2.281 → 1.2.284

package/dist/enums/ItemConfigTag.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Matches the ItemConfig.TAG_* members of the ItemConfig class.
+ *
+ * In IsaacScript, we re-implement this as an enum, since it is cleaner.
+ */
+export declare enum ItemConfigTag {
+    /**
+     * Dead things (for the Parasite unlock).
+     *
+     * Equal to "dead" in "items_metadata.xml".
+     *
+     * 1 << 0
+     */
+    DEAD = 1,
+    /**
+     * Syringes (for Little Baggy and the Spun! transformation).
+     *
+     * Equal to "syringe" in "items_metadata.xml".
+     * 1 << 1
+     */
+    SYRINGE = 2,
+    /**
+     * Mom's things (for Mom's Contact and the Yes Mother? transformation).
+     *
+     * Equal to "mom" in "items_metadata.xml".
+     *
+     * 1 << 2
+     */
+    MOM = 4,
+    /**
+     * Technology items (for the Technology Zero unlock).
+     *
+     * Equal to "tech" in "items_metadata.xml".
+     *
+     * 1 << 3
+     */
+    TECH = 8,
+    /**
+     * Battery items (for the Jumper Cables unlock).
+     *
+     * Equal to "battery" in "items_metadata.xml".
+     *
+     * 1 << 4
+     */
+    BATTERY = 16,
+    /**
+     * Guppy items (Guppy transformation).
+     *
+     * Equal to "guppy" in "items_metadata.xml".
+     *
+     * 1 << 5
+     */
+    GUPPY = 32,
+    /**
+     * Fly items (Beelzebub transformation).
+     *
+     * Equal to "fly" in "items_metadata.xml".
+     *
+     * 1 << 6
+     */
+    FLY = 64,
+    /**
+     * Bob items (Bob transformation).
+     *
+     * Equal to "bob" in "items_metadata.xml".
+     *
+     * 1 << 7
+     */
+    BOB = 128,
+    /**
+     * Mushroom items (Fun Guy transformation).
+     *
+     * Equal to "mushroom" in "items_metadata.xml".
+     *
+     * 1 << 8
+     */
+    MUSHROOM = 256,
+    /**
+     * Baby items (Conjoined transformation).
+     *
+     * Equal to "mushroom" in "items_metadata.xml".
+     *
+     * 1 << 9
+     */
+    BABY = 512,
+    /**
+     * Angel items (Seraphim transformation).
+     *
+     * Equal to "angel" in "items_metadata.xml".
+     *
+     * 1 << 10
+     */
+    ANGEL = 1024,
+    /**
+     * Devil items (Leviathan transformation).
+     *
+     * Equal to "devil" in "items_metadata.xml".
+     *
+     * 1 << 11
+     */
+    DEVIL = 2048,
+    /**
+     * Poop items (Oh Shit transformation).
+     *
+     * Equal to "poop" in "items_metadata.xml".
+     *
+     * 1 << 12
+     */
+    POOP = 4096,
+    /**
+     * Book items (Book Worm transformation).
+     *
+     * Equal to "book" in "items_metadata.xml".
+     *
+     * 1 << 13
+     */
+    BOOK = 8192,
+    /**
+     * Spider items (Spider Baby transformation).
+     *
+     * Equal to "spider" in "items_metadata.xml".
+     *
+     * 1 << 14
+     */
+    SPIDER = 16384,
+    /**
+     * Quest item (cannot be rerolled or randomly obtained).
+     *
+     * Equal to "quest" in "items_metadata.xml".
+     *
+     * 1 << 15
+     */
+    QUEST = 32768,
+    /**
+     * Can be spawned by Monster Manual.
+     *
+     * Equal to "monstermanual" in "items_metadata.xml".
+     *
+     * 1 << 16
+     */
+    MONSTER_MANUAL = 65536,
+    /**
+     * Cannot appear in Greed Mode.
+     *
+     * Equal to "nogreed" in "items_metadata.xml".
+     *
+     * 1 << 17
+     */
+    NO_GREED = 131072,
+    /**
+     * Food item (for Binge Eater).
+     *
+     * Equal to "food" in "items_metadata.xml".
+     *
+     * 1 << 18
+     */
+    FOOD = 262144,
+    /**
+     * Tears up item (for Lachryphagy unlock detection).
+     *
+     * Equal to "tearsup" in "items_metadata.xml".
+     *
+     * 1 << 19
+     */
+    TEARS_UP = 524288,
+    /**
+     * Whitelisted item for Tainted Lost.
+     *
+     * Equal to "offensive" in "items_metadata.xml".
+     *
+     * 1 << 20
+     */
+    OFFENSIVE = 1048576,
+    /**
+     * Blacklisted item for Keeper & Tainted Keeper.
+     *
+     * Equal to "nokeeper" in "items_metadata.xml".
+     *
+     * 1 << 21
+     */
+    NO_KEEPER = 2097152,
+    /**
+     * Blacklisted item for The Lost's Birthright.
+     *
+     * Equal to "nolostbr" in "items_metadata.xml".
+     *
+     * 1 << 22
+     */
+    NO_LOST_BR = 4194304,
+    /**
+     * Star themed items (for the Planetarium unlock).
+     *
+     * Equal to "stars" in "items_metadata.xml".
+     *
+     * 1 << 23
+     */
+    STARS = 8388608,
+    /**
+     * Summonable items (for Tainted Bethany).
+     *
+     * Equal to "summonable" in "items_metadata.xml".
+     *
+     * 1 << 24
+     */
+    SUMMONABLE = 16777216,
+    /**
+     * Can't be obtained in Cantripped challenge.
+     *
+     * Equal to "nocantrip" in "items_metadata.xml".
+     *
+     * 1 << 25
+     */
+    NO_CANTRIP = 33554432,
+    /**
+     * Active items that have wisps attached to them (automatically set).
+     *
+     * Not equal to any particular tag in "items_metadata.xml". Instead, this is set for all of the
+     * items in the "wisps.xml" file.
+     *
+     * 1 << 26
+     */
+    WISP = 67108864,
+    /**
+     * Unique familiars that cannot be duplicated.
+     *
+     * Equal to "uniquefamiliar" in "items_metadata.xml".
+     *
+     * 1 << 27
+     */
+    UNIQUE_FAMILIAR = 134217728,
+    /**
+     * Items that should not be obtainable in challenges.
+     *
+     * Equal to "nochallenge" in "items_metadata.xml".
+     *
+     * 1 << 28
+     */
+    NO_CHALLENGE = 268435456,
+    /**
+     * Items that should not be obtainable in daily runs.
+     *
+     * Equal to "nodaily" in "items_metadata.xml".
+     *
+     * 1 << 29
+     */
+    NO_DAILY = 536870912,
+    /**
+     * Items that should be shared between Tainted Lazarus' forms.
+     *
+     * This is different from `LAZ_SHARED_GLOBAL` in that it does apply stat changes from the item for
+     * both characters.
+     *
+     * Equal to "lazarusshared" in "items_metadata.xml".
+     *
+     * 1 << 30
+     */
+    LAZ_SHARED = 1073741824,
+    /**
+     * Items that should be shared between Tainted Lazarus' forms but only through global checks (such
+     * as `PlayerManager::HasCollectible`).
+     *
+     * This is different from `LAZ_SHARED` in that it does not apply stat changes from the item for
+     * both characters.
+     *
+     * Equal to "lazarussharedglobal" in "items_metadata.xml".
+     *
+     * 1 << 31
+     */
+    LAZ_SHARED_GLOBAL = 2147483648,
+    /**
+     * Items that will not be a random starting item for Eden and Tainted Eden.
+     *
+     * Equal to "noeden" in "items_metadata.xml".
+     *
+     * 1 << 32
+     */
+    NO_EDEN = 4294967296
+}

package/dist/enums/ItemConfigTag.lua

@@ -0,0 +1,70 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+____exports.ItemConfigTag = ItemConfigTag or ({})
+____exports.ItemConfigTag.DEAD = 1
+____exports.ItemConfigTag[____exports.ItemConfigTag.DEAD] = "DEAD"
+____exports.ItemConfigTag.SYRINGE = 2
+____exports.ItemConfigTag[____exports.ItemConfigTag.SYRINGE] = "SYRINGE"
+____exports.ItemConfigTag.MOM = 4
+____exports.ItemConfigTag[____exports.ItemConfigTag.MOM] = "MOM"
+____exports.ItemConfigTag.TECH = 8
+____exports.ItemConfigTag[____exports.ItemConfigTag.TECH] = "TECH"
+____exports.ItemConfigTag.BATTERY = 16
+____exports.ItemConfigTag[____exports.ItemConfigTag.BATTERY] = "BATTERY"
+____exports.ItemConfigTag.GUPPY = 32
+____exports.ItemConfigTag[____exports.ItemConfigTag.GUPPY] = "GUPPY"
+____exports.ItemConfigTag.FLY = 64
+____exports.ItemConfigTag[____exports.ItemConfigTag.FLY] = "FLY"
+____exports.ItemConfigTag.BOB = 128
+____exports.ItemConfigTag[____exports.ItemConfigTag.BOB] = "BOB"
+____exports.ItemConfigTag.MUSHROOM = 256
+____exports.ItemConfigTag[____exports.ItemConfigTag.MUSHROOM] = "MUSHROOM"
+____exports.ItemConfigTag.BABY = 512
+____exports.ItemConfigTag[____exports.ItemConfigTag.BABY] = "BABY"
+____exports.ItemConfigTag.ANGEL = 1024
+____exports.ItemConfigTag[____exports.ItemConfigTag.ANGEL] = "ANGEL"
+____exports.ItemConfigTag.DEVIL = 2048
+____exports.ItemConfigTag[____exports.ItemConfigTag.DEVIL] = "DEVIL"
+____exports.ItemConfigTag.POOP = 4096
+____exports.ItemConfigTag[____exports.ItemConfigTag.POOP] = "POOP"
+____exports.ItemConfigTag.BOOK = 8192
+____exports.ItemConfigTag[____exports.ItemConfigTag.BOOK] = "BOOK"
+____exports.ItemConfigTag.SPIDER = 16384
+____exports.ItemConfigTag[____exports.ItemConfigTag.SPIDER] = "SPIDER"
+____exports.ItemConfigTag.QUEST = 32768
+____exports.ItemConfigTag[____exports.ItemConfigTag.QUEST] = "QUEST"
+____exports.ItemConfigTag.MONSTER_MANUAL = 65536
+____exports.ItemConfigTag[____exports.ItemConfigTag.MONSTER_MANUAL] = "MONSTER_MANUAL"
+____exports.ItemConfigTag.NO_GREED = 131072
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_GREED] = "NO_GREED"
+____exports.ItemConfigTag.FOOD = 262144
+____exports.ItemConfigTag[____exports.ItemConfigTag.FOOD] = "FOOD"
+____exports.ItemConfigTag.TEARS_UP = 524288
+____exports.ItemConfigTag[____exports.ItemConfigTag.TEARS_UP] = "TEARS_UP"
+____exports.ItemConfigTag.OFFENSIVE = 1048576
+____exports.ItemConfigTag[____exports.ItemConfigTag.OFFENSIVE] = "OFFENSIVE"
+____exports.ItemConfigTag.NO_KEEPER = 2097152
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_KEEPER] = "NO_KEEPER"
+____exports.ItemConfigTag.NO_LOST_BR = 4194304
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_LOST_BR] = "NO_LOST_BR"
+____exports.ItemConfigTag.STARS = 8388608
+____exports.ItemConfigTag[____exports.ItemConfigTag.STARS] = "STARS"
+____exports.ItemConfigTag.SUMMONABLE = 16777216
+____exports.ItemConfigTag[____exports.ItemConfigTag.SUMMONABLE] = "SUMMONABLE"
+____exports.ItemConfigTag.NO_CANTRIP = 33554432
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_CANTRIP] = "NO_CANTRIP"
+____exports.ItemConfigTag.WISP = 67108864
+____exports.ItemConfigTag[____exports.ItemConfigTag.WISP] = "WISP"
+____exports.ItemConfigTag.UNIQUE_FAMILIAR = 134217728
+____exports.ItemConfigTag[____exports.ItemConfigTag.UNIQUE_FAMILIAR] = "UNIQUE_FAMILIAR"
+____exports.ItemConfigTag.NO_CHALLENGE = 268435456
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_CHALLENGE] = "NO_CHALLENGE"
+____exports.ItemConfigTag.NO_DAILY = 536870912
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_DAILY] = "NO_DAILY"
+____exports.ItemConfigTag.LAZ_SHARED = 1073741824
+____exports.ItemConfigTag[____exports.ItemConfigTag.LAZ_SHARED] = "LAZ_SHARED"
+____exports.ItemConfigTag.LAZ_SHARED_GLOBAL = 2147483648
+____exports.ItemConfigTag[____exports.ItemConfigTag.LAZ_SHARED_GLOBAL] = "LAZ_SHARED_GLOBAL"
+____exports.ItemConfigTag.NO_EDEN = 4294967296
+____exports.ItemConfigTag[____exports.ItemConfigTag.NO_EDEN] = "NO_EDEN"
+return ____exports

package/dist/features/characterHealthConversion.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="isaac-typescript-definitions" />
+declare type ConversionHeartSubType = HeartSubType.HEART_SOUL | HeartSubType.HEART_BLACK;
+/**
+ * Helper function to make a character that has the same health mechanic as Blue Baby (red heart
+ * containers --> soul hearts) or Dark Judas (red heart containers --> black hearts).
+ *
+ * Call this function once at the beginning of your mod to declare the health conversion type.
+ */
+export declare function registerCharacterHealthConversion(playerType: PlayerType | int, conversionHeartSubType: ConversionHeartSubType): void;
+export {};

package/dist/features/characterHealthConversion.lua

@@ -0,0 +1,81 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postPEffectUpdate, convertRedHeartContainers, removeRedHearts, prePickupCollisionHeart, characterHealthReplacementMap
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____pickups = require("functions.pickups")
+local isRedHeart = ____pickups.isRedHeart
+local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
+function postPEffectUpdate(self, player)
+    local character = player:GetPlayerType()
+    local conversionHeartSubType = characterHealthReplacementMap:get(character)
+    if conversionHeartSubType == nil then
+        return
+    end
+    convertRedHeartContainers(nil, player, conversionHeartSubType)
+    removeRedHearts(nil, player)
+end
+function convertRedHeartContainers(self, player, heartSubType)
+    local maxHearts = player:GetMaxHearts()
+    if maxHearts == 0 then
+        return
+    end
+    player:AddMaxHearts(maxHearts * -1, false)
+    repeat
+        local ____switch7 = heartSubType
+        local ____cond7 = ____switch7 == HeartSubType.HEART_SOUL
+        if ____cond7 then
+            do
+                player:AddSoulHearts(maxHearts)
+                return
+            end
+        end
+        ____cond7 = ____cond7 or ____switch7 == HeartSubType.HEART_BLACK
+        if ____cond7 then
+            do
+                player:AddBlackHearts(maxHearts)
+                return
+            end
+        end
+        do
+            do
+                ensureAllCases(nil, heartSubType)
+            end
+        end
+    until true
+end
+function removeRedHearts(self, player)
+    local hearts = player:GetHearts()
+    if hearts > 0 then
+        player:AddHearts(hearts * -1)
+    end
+end
+function prePickupCollisionHeart(self, pickup, collider)
+    if not isRedHeart(nil, pickup) then
+        return nil
+    end
+    local player = collider:ToPlayer()
+    if player == nil then
+        return nil
+    end
+    local character = player:GetPlayerType()
+    local conversionHeartSubType = characterHealthReplacementMap:get(character)
+    if conversionHeartSubType == nil then
+        return nil
+    end
+    return false
+end
+local FEATURE_NAME = "character health manager"
+characterHealthReplacementMap = __TS__New(Map)
+function ____exports.characterHealthConversionInit(self, mod)
+    mod:AddCallback(ModCallbacks.MC_POST_PEFFECT_UPDATE, postPEffectUpdate)
+    mod:AddCallback(ModCallbacks.MC_PRE_PICKUP_COLLISION, prePickupCollisionHeart, 10)
+end
+function ____exports.registerCharacterHealthConversion(self, playerType, conversionHeartSubType)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    characterHealthReplacementMap:set(playerType, conversionHeartSubType)
+end
+return ____exports

package/dist/functions/collectibleTag.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="isaac-typescript-definitions" />
+import { ItemConfigTag } from "../enums/ItemConfigTag";
+export declare function collectibleHasTag(collectibleType: CollectibleType | int, tag: ItemConfigTag): boolean;
+/**
+ * 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);
+ * ```
+ */
+export declare function getCollectibleTypesWithTag(itemConfigTag: ItemConfigTag): Set<CollectibleType | int>;
+/** Returns the number of items that a player has towards a particular transformation. */
+export declare function getPlayerNumCollectiblesWithTag(player: EntityPlayer, itemConfigTag: ItemConfigTag): int;
+export declare function isQuestCollectible(collectibleType: CollectibleType | int): boolean;

package/dist/functions/collectibleTag.lua

@@ -0,0 +1,74 @@
+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 ____cachedClasses = require("cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____ItemConfigTag = require("enums.ItemConfigTag")
+local ItemConfigTag = ____ItemConfigTag.ItemConfigTag
+local ____collectibles = require("functions.collectibles")
+local getMaxCollectibleType = ____collectibles.getMaxCollectibleType
+local ____math = require("functions.math")
+local range = ____math.range
+local ____player = require("functions.player")
+local getPlayerCollectibleCount = ____player.getPlayerCollectibleCount
+local ____set = require("functions.set")
+local copySet = ____set.copySet
+local ____utils = require("functions.utils")
+local getEnumValues = ____utils.getEnumValues
+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)
+    local maxCollectibleType = getMaxCollectibleType(nil)
+    for ____, itemConfigTag in ipairs(getEnumValues(nil, ItemConfigTag)) do
+        TAG_TO_COLLECTIBLE_TYPES_MAP:set(
+            itemConfigTag,
+            __TS__New(Set)
+        )
+    end
+    for ____, collectibleType in ipairs(range(nil, 1, maxCollectibleType)) 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
+                    error("Failed to get the collectible types for item tag: " .. ItemConfigTag[itemConfigTag])
+                end
+                collectibleTypesSet:add(collectibleType)
+            end
+            ::__continue6::
+        end
+    end
+end
+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 copySet(nil, collectibleTypes)
+end
+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/functions/collectibles.d.ts

@@ -3,7 +3,6 @@ import { CollectiblePedestalType } from "../enums/CollectiblePedestalType";
 import { CollectibleIndex } from "../types/CollectibleIndex";
 export declare function clearCollectibleSprite(collectible: EntityPickup): void;
 export declare function collectibleHasCacheFlag(collectibleType: CollectibleType | int, cacheFlag: CacheFlag): boolean;
-export declare function collectibleHasTag(collectibleType: CollectibleType | int, tag: ItemConfigTag): boolean;
 /** Helper function to check if two collectible sprites have the same sprite sheet loaded. */
 export declare function collectibleSpriteEquals(sprite1: Sprite, sprite2: Sprite): boolean;
 /**
@@ -90,6 +89,17 @@ export declare function getCollectiblePedestalType(collectible: EntityPickup): C
  * type was not valid.
  */
 export declare function getCollectibleQuality(collectibleType: CollectibleType | int): int;
+/**
+ * Helper function to get the tags of a collectible (which is the composition of zero or more
+ * `ItemConfigTag`). Returns 0 if the provided collectible type is not valid.
+ *
+ * Example:
+ * ```ts
+ * const collectibleType = CollectibleType.COLLECTIBLE_SAD_ONION;
+ * const itemConfigTags = getCollectibleTags(collectibleType); // itemConfigTags is "18350080"
+ * ```
+ */
+export declare function getCollectibleTags(collectibleType: CollectibleType | int): int;
 /**
  * Helper function to get the final collectible type in the game.
  *
@@ -112,7 +122,6 @@ export declare function isGlitchedCollectible(pickup: EntityPickup): boolean;
  * `ItemType.ITEM_FAMILIAR`.
  */
 export declare function isPassiveCollectible(collectibleType: CollectibleType | int): boolean;
-export declare function isQuestCollectible(collectibleType: CollectibleType | int): boolean;
 /**
  * Helper function to determine if a particular collectible will disappear from the player's
  * inventory upon use. Note that this will not work will modded items, as there is no way to

package/dist/functions/collectibles.lua

@@ -54,13 +54,6 @@ function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
     end
     return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
 end
-function ____exports.collectibleHasTag(self, collectibleType, tag)
-    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-    if itemConfigItem == nil then
-        return false
-    end
-    return itemConfigItem:HasTags(tag)
-end
 function ____exports.collectibleSpriteEquals(self, sprite1, sprite2)
     local xStart = -1
     local xFinish = 1
@@ -177,6 +170,10 @@ function ____exports.getCollectibleQuality(self, collectibleType)
     end
     return itemConfigItem.Quality
 end
+function ____exports.getCollectibleTags(self, collectibleType)
+    local itemConfigItem = itemConfig:GetCollectible(collectibleType)
+    return itemConfigItem == nil and 0 or itemConfigItem.Tags
+end
 function ____exports.getMaxCollectibleType(self)
     return itemConfig:GetCollectibles().Size - 1
 end
@@ -201,9 +198,6 @@ function ____exports.isPassiveCollectible(self, collectibleType)
     local itemType = ____exports.getCollectibleItemType(nil, collectibleType)
     return itemType == ItemType.ITEM_PASSIVE or itemType == ItemType.ITEM_FAMILIAR
 end
-function ____exports.isQuestCollectible(self, collectibleType)
-    return ____exports.collectibleHasTag(nil, collectibleType, 32768)
-end
 function ____exports.isSingleUseCollectible(self, collectibleType)
     return SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES_SET:has(collectibleType)
 end

package/dist/functions/player.d.ts

@@ -88,6 +88,13 @@ export declare function getPlayerBlackHearts(player: EntityPlayer): int;
  * @returns The first player found when iterating upwards from index 0.
  */
 export declare function getPlayerCloserThan(position: Vector, distance: float): EntityPlayer | undefined;
+/**
+ * Helper function to return the total amount of collectibles that a player has that match the
+ * collectible type(s) provided.
+ *
+ * This function is variadic, meaning that you can specify N collectible types.
+ */
+export declare function getPlayerCollectibleCount(player: EntityPlayer, ...collectibleTypes: Array<CollectibleType | int>): int;
 /**
  * Iterates over every item in the game and returns a map containing the number of each item that
  * the player has.

package/dist/functions/player.lua

@@ -280,6 +280,14 @@ function ____exports.getPlayerCloserThan(self, position, distance)
         function(____, player) return player.Position:Distance(position) <= distance end
     )
 end
+function ____exports.getPlayerCollectibleCount(self, player, ...)
+    local collectibleTypes = {...}
+    local numCollectibles = 0
+    for ____, collectibleType in ipairs(collectibleTypes) do
+        numCollectibles = numCollectibles + player:GetCollectibleNum(collectibleType, true)
+    end
+    return numCollectibles
+end
 function ____exports.getPlayerCollectibleMap(self, player)
     local collectibleSet = getCollectibleSet(nil)
     local collectibleMap = __TS__New(Map)
@@ -495,9 +503,9 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
         itemPool:RemoveCollectible(collectibleType)
     end
     repeat
-        local ____switch106 = activeSlot
-        local ____cond106 = ____switch106 == ActiveSlot.SLOT_PRIMARY
-        if ____cond106 then
+        local ____switch109 = activeSlot
+        local ____cond109 = ____switch109 == ActiveSlot.SLOT_PRIMARY
+        if ____cond109 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -506,8 +514,8 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond106 = ____cond106 or ____switch106 == ActiveSlot.SLOT_SECONDARY
-        if ____cond106 then
+        ____cond109 = ____cond109 or ____switch109 == ActiveSlot.SLOT_SECONDARY
+        if ____cond109 then
             do
                 if primaryCollectibleType ~= CollectibleType.COLLECTIBLE_NULL then
                     player:RemoveCollectible(primaryCollectibleType)
@@ -522,16 +530,16 @@ function ____exports.setActiveItem(self, player, collectibleType, activeSlot, ch
                 break
             end
         end
-        ____cond106 = ____cond106 or ____switch106 == ActiveSlot.SLOT_POCKET
-        if ____cond106 then
+        ____cond109 = ____cond109 or ____switch109 == ActiveSlot.SLOT_POCKET
+        if ____cond109 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 player:SetActiveCharge(charge, activeSlot)
                 break
             end
         end
-        ____cond106 = ____cond106 or ____switch106 == ActiveSlot.SLOT_POCKET2
-        if ____cond106 then
+        ____cond109 = ____cond109 or ____switch109 == ActiveSlot.SLOT_POCKET2
+        if ____cond109 then
             do
                 player:SetPocketActiveItem(collectibleType, activeSlot, keepInPools)
                 break

package/dist/functions/spawnCollectible.lua

@@ -5,8 +5,9 @@ local preventCollectibleRotate = ____preventCollectibleRotate.preventCollectible
 local ____featuresInitialized = require("featuresInitialized")
 local areFeaturesInitialized = ____featuresInitialized.areFeaturesInitialized
 local ____collectibles = require("functions.collectibles")
-local isQuestCollectible = ____collectibles.isQuestCollectible
 local setCollectibleEmpty = ____collectibles.setCollectibleEmpty
+local ____collectibleTag = require("functions.collectibleTag")
+local isQuestCollectible = ____collectibleTag.isQuestCollectible
 local ____entitySpecific = require("functions.entitySpecific")
 local spawnPickupWithSeed = ____entitySpecific.spawnPickupWithSeed
 local ____player = require("functions.player")

package/dist/functions/transformations.d.ts

@@ -1,7 +1,17 @@
 /// <reference types="isaac-typescript-definitions" />
-export declare function getCollectibleTypesForTransformation(playerForm: PlayerForm): Set<PlayerForm>;
+/**
+ * Helper function to get all of the collectible types in the game that count towards a particular
+ * transformation.
+ *
+ * For example, to get all of the collectible types that count towards Guppy:
+ *
+ * ```ts
+ * const guppyCollectibleTypes = getCollectibleTypesForTransformation(PlayerForm.PLAYERFORM_GUPPY);
+ * ```
+ */
+export declare function getCollectibleTypesForTransformation(playerForm: PlayerForm): Set<CollectibleType | int>;
 /** Returns the number of items that a player has towards a particular transformation. */
-export declare function getPlayerNumTransformationCollectibles(player: EntityPlayer, playerForm: PlayerForm): int;
+export declare function getPlayerNumCollectiblesForTransformation(player: EntityPlayer, playerForm: PlayerForm): int;
 /**
  * Helper function to get a transformation name from a PlayerForm enum.
  *

package/dist/functions/transformations.lua

@@ -2,103 +2,74 @@ 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 __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
-local ____DefaultMap = require("classes.DefaultMap")
-local DefaultMap = ____DefaultMap.DefaultMap
+local ____ItemConfigTag = require("enums.ItemConfigTag")
+local ItemConfigTag = ____ItemConfigTag.ItemConfigTag
 local ____transformationNames = require("objects.transformationNames")
 local DEFAULT_TRANSFORMATION_NAME = ____transformationNames.DEFAULT_TRANSFORMATION_NAME
 local TRANSFORMATION_NAMES = ____transformationNames.TRANSFORMATION_NAMES
 local ____collectibles = require("functions.collectibles")
-local collectibleHasTag = ____collectibles.collectibleHasTag
-local getMaxCollectibleType = ____collectibles.getMaxCollectibleType
+local getCollectibleTags = ____collectibles.getCollectibleTags
+local ____collectibleTag = require("functions.collectibleTag")
+local getCollectibleTypesWithTag = ____collectibleTag.getCollectibleTypesWithTag
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
 local ____math = require("functions.math")
 local range = ____math.range
-local ____set = require("functions.set")
-local copySet = ____set.copySet
+local ____player = require("functions.player")
+local getPlayerCollectibleCount = ____player.getPlayerCollectibleCount
 local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
-    {PlayerForm.PLAYERFORM_GUPPY, 32},
-    {PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES, 64},
-    {PlayerForm.PLAYERFORM_MUSHROOM, 256},
-    {PlayerForm.PLAYERFORM_ANGEL, 1024},
-    {PlayerForm.PLAYERFORM_BOB, 128},
-    {PlayerForm.PLAYERFORM_DRUGS, 2},
-    {PlayerForm.PLAYERFORM_MOM, 4},
-    {PlayerForm.PLAYERFORM_BABY, 512},
-    {PlayerForm.PLAYERFORM_EVIL_ANGEL, 2048},
-    {PlayerForm.PLAYERFORM_POOP, 4096},
-    {PlayerForm.PLAYERFORM_BOOK_WORM, 8192},
-    {PlayerForm.PLAYERFORM_SPIDERBABY, 16384}
+    {PlayerForm.PLAYERFORM_GUPPY, ItemConfigTag.GUPPY},
+    {PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES, ItemConfigTag.FLY},
+    {PlayerForm.PLAYERFORM_MUSHROOM, ItemConfigTag.MUSHROOM},
+    {PlayerForm.PLAYERFORM_ANGEL, ItemConfigTag.ANGEL},
+    {PlayerForm.PLAYERFORM_BOB, ItemConfigTag.BOB},
+    {PlayerForm.PLAYERFORM_DRUGS, ItemConfigTag.SYRINGE},
+    {PlayerForm.PLAYERFORM_MOM, ItemConfigTag.MOM},
+    {PlayerForm.PLAYERFORM_BABY, ItemConfigTag.BABY},
+    {PlayerForm.PLAYERFORM_EVIL_ANGEL, ItemConfigTag.DEVIL},
+    {PlayerForm.PLAYERFORM_POOP, ItemConfigTag.POOP},
+    {PlayerForm.PLAYERFORM_BOOK_WORM, ItemConfigTag.BOOK},
+    {PlayerForm.PLAYERFORM_SPIDERBABY, ItemConfigTag.SPIDER}
 })
-local TRANSFORMATIONS_NOT_BASED_ON_ITEMS = __TS__New(Set, {PlayerForm.PLAYERFORM_ADULTHOOD, PlayerForm.PLAYERFORM_STOMPY, PlayerForm.PLAYERFORM_FLIGHT})
 local TRANSFORMATIONS_THAT_GRANT_FLYING = __TS__New(Set, {PlayerForm.PLAYERFORM_GUPPY, PlayerForm.PLAYERFORM_LORD_OF_THE_FLIES, PlayerForm.PLAYERFORM_ANGEL, PlayerForm.PLAYERFORM_EVIL_ANGEL})
-local TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP = __TS__New(Map)
-local COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP = __TS__New(
-    DefaultMap,
-    function() return __TS__New(Set) end
-)
-local function initTransformationMaps(self)
-    local maxCollectibleType = getMaxCollectibleType(nil)
-    for ____, playerForm in __TS__Iterator(TRANSFORMATION_TO_TAG_MAP:keys()) do
-        TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:set(
-            playerForm,
-            __TS__New(Set)
-        )
-    end
-    for ____, collectibleType in ipairs(range(nil, 1, maxCollectibleType)) do
-        for ____, ____value in __TS__Iterator(TRANSFORMATION_TO_TAG_MAP:entries()) do
-            local playerForm = ____value[1]
-            local tag = ____value[2]
-            do
-                if not collectibleHasTag(nil, collectibleType, tag) then
-                    goto __continue7
-                end
-                local collectibleTypesSet = TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:get(playerForm)
-                if collectibleTypesSet == nil then
-                    error("Failed to get the collectible types for transformation: " .. tostring(playerForm))
-                end
-                collectibleTypesSet:add(collectibleType)
-                local transformations = COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP:getAndSetDefault(collectibleType)
-                transformations:add(playerForm)
-            end
-            ::__continue7::
-        end
-    end
-end
 function ____exports.getCollectibleTypesForTransformation(self, playerForm)
-    if TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP.size == 0 then
-        initTransformationMaps(nil)
+    local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+    if itemConfigTag == nil then
+        error(("Failed to get the collectible types for the transformation of " .. tostring(playerForm)) .. " because that transformation is not based on collectibles.")
     end
-    local collectibleTypes = TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:get(playerForm)
-    return collectibleTypes == nil and __TS__New(Set) or copySet(nil, collectibleTypes)
+    return getCollectibleTypesWithTag(nil, itemConfigTag)
 end
-function ____exports.getPlayerNumTransformationCollectibles(self, player, playerForm)
-    if TRANSFORMATIONS_NOT_BASED_ON_ITEMS:has(playerForm) then
-        error(("The transformation of " .. tostring(playerForm)) .. " cannot be tracked by this function.")
-    end
-    if TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP.size == 0 then
-        initTransformationMaps(nil)
-    end
-    local itemsForTransformation = TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:get(playerForm)
-    if itemsForTransformation == nil then
-        error(("The transformation of " .. tostring(playerForm)) .. " is not a valid value of the PlayerForm enum.")
-    end
-    local numCollectibles = 0
-    for ____, collectibleType in __TS__Iterator(itemsForTransformation:values()) do
-        numCollectibles = numCollectibles + player:GetCollectibleNum(collectibleType)
-    end
-    return numCollectibles
+function ____exports.getPlayerNumCollectiblesForTransformation(self, player, playerForm)
+    local collectibleTypes = ____exports.getCollectibleTypesForTransformation(nil, playerForm)
+    return getPlayerCollectibleCount(
+        nil,
+        player,
+        __TS__Spread(collectibleTypes:values())
+    )
 end
 function ____exports.getTransformationName(self, playerForm)
     local transformationName = TRANSFORMATION_NAMES[playerForm]
     return transformationName == nil and DEFAULT_TRANSFORMATION_NAME or transformationName
 end
 function ____exports.getTransformationsForCollectibleType(self, collectibleType)
-    if COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP.size == 0 then
-        initTransformationMaps(nil)
+    local itemConfigTags = getCollectibleTags(nil, collectibleType)
+    local transformationSet = __TS__New(Set)
+    for ____, playerForm in ipairs(range(nil, 0, PlayerForm.NUM_PLAYER_FORMS - 1)) do
+        do
+            local itemConfigTag = TRANSFORMATION_TO_TAG_MAP:get(playerForm)
+            if itemConfigTag == nil then
+                goto __continue7
+            end
+            if hasFlag(nil, itemConfigTags, itemConfigTag) then
+                transformationSet:add(playerForm)
+            end
+        end
+        ::__continue7::
     end
-    local transformations = COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP:get(collectibleType)
-    return transformations == nil and __TS__New(Set) or copySet(nil, transformations)
+    return transformationSet
 end
 function ____exports.hasFlyingTransformation(self, player)
     for ____, playerForm in __TS__Iterator(TRANSFORMATIONS_THAT_GRANT_FLYING:values()) do

package/dist/index.d.ts

@@ -7,12 +7,14 @@ export * from "./constants";
 export * from "./enums/CardType";
 export * from "./enums/CollectiblePedestalType";
 export * from "./enums/HealthType";
+export * from "./enums/ItemConfigTag";
 export * from "./enums/ModCallbacksCustom";
 export * from "./enums/PillEffectClass";
 export * from "./enums/PillEffectType";
 export * from "./enums/PocketItemType";
 export * from "./enums/SerializationType";
-export * from "./features/characterStats";
+export { registerCharacterHealthConversion } from "./features/characterHealthConversion";
+export { registerCharacterStats } from "./features/characterStats";
 export { deployJSONRoom, deployRandomJSONRoom, emptyRoom, } from "./features/deployJSONRoom";
 export { disableAllInputs, disableAllInputsExceptFor, disableMovementInputs, disableShootingInputs, enableAllInputs, enableAllInputsExceptFor, } from "./features/disableInputs";
 export { disableAllSound, enableAllSound } from "./features/disableSound";
@@ -41,6 +43,7 @@ export * from "./functions/chargeBar";
 export * from "./functions/collectibleCacheFlag";
 export * from "./functions/collectibles";
 export * from "./functions/collectibleSet";
+export * from "./functions/collectibleTag";
 export * from "./functions/color";
 export * from "./functions/debug";
 export { deepCopy } from "./functions/deepCopy";

package/dist/index.lua

@@ -71,7 +71,7 @@ do
     end
 end
 do
-    local ____export = require("enums.ModCallbacksCustom")
+    local ____export = require("enums.ItemConfigTag")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -79,7 +79,7 @@ do
     end
 end
 do
-    local ____export = require("enums.PillEffectClass")
+    local ____export = require("enums.ModCallbacksCustom")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -87,7 +87,7 @@ do
     end
 end
 do
-    local ____export = require("enums.PillEffectType")
+    local ____export = require("enums.PillEffectClass")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -95,7 +95,7 @@ do
     end
 end
 do
-    local ____export = require("enums.PocketItemType")
+    local ____export = require("enums.PillEffectType")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -103,7 +103,7 @@ do
     end
 end
 do
-    local ____export = require("enums.SerializationType")
+    local ____export = require("enums.PocketItemType")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
@@ -111,13 +111,23 @@ do
     end
 end
 do
-    local ____export = require("features.characterStats")
+    local ____export = require("enums.SerializationType")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue
         end
     end
 end
+do
+    local ____characterHealthConversion = require("features.characterHealthConversion")
+    local registerCharacterHealthConversion = ____characterHealthConversion.registerCharacterHealthConversion
+    ____exports.registerCharacterHealthConversion = registerCharacterHealthConversion
+end
+do
+    local ____characterStats = require("features.characterStats")
+    local registerCharacterStats = ____characterStats.registerCharacterStats
+    ____exports.registerCharacterStats = registerCharacterStats
+end
 do
     local ____deployJSONRoom = require("features.deployJSONRoom")
     local deployJSONRoom = ____deployJSONRoom.deployJSONRoom
@@ -337,6 +347,14 @@ do
         end
     end
 end
+do
+    local ____export = require("functions.collectibleTag")
+    for ____exportKey, ____exportValue in pairs(____export) do
+        if ____exportKey ~= "default" then
+            ____exports[____exportKey] = ____exportValue
+        end
+    end
+end
 do
     local ____export = require("functions.color")
     for ____exportKey, ____exportValue in pairs(____export) do

package/dist/upgradeMod.lua

@@ -78,6 +78,8 @@ local ____roomClearChange = require("callbacks.roomClearChange")
 local roomClearChangeCallbackInit = ____roomClearChange.roomClearChangeCallbackInit
 local ____ModUpgraded = require("classes.ModUpgraded")
 local ModUpgraded = ____ModUpgraded.ModUpgraded
+local ____characterHealthConversion = require("features.characterHealthConversion")
+local characterHealthConversionInit = ____characterHealthConversion.characterHealthConversionInit
 local ____characterStats = require("features.characterStats")
 local characterStatsInit = ____characterStats.characterStatsInit
 local ____deployJSONRoom = require("features.deployJSONRoom")
@@ -166,6 +168,7 @@ function initFeatures(self, mod)
     fastResetInit(nil, mod)
     fadeInRemoverInit(nil, mod)
     characterStatsInit(nil, mod)
+    characterHealthConversionInit(nil, mod)
 end
 function ____exports.upgradeMod(self, modVanilla)
     patchErrorFunction(nil)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.281",
+  "version": "1.2.284",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -25,7 +25,7 @@
     "dist/**/*.d.ts"
   ],
   "devDependencies": {
-    "isaac-typescript-definitions": "^1.0.393",
+    "isaac-typescript-definitions": "^1.0.395",
     "isaacscript-lint": "^1.0.99",
     "isaacscript-tsconfig": "^1.1.9",
     "typedoc": "^0.22.15",