isaacscript-common 1.2.102 → 1.2.105

package/dist/constants.d.ts

@@ -63,8 +63,6 @@ export declare const FINAL_STAGE: number;
  * second TMTRAINER item subtracts one from that, and so on.
  */
 export declare const FIRST_GLITCHED_COLLECTIBLE_TYPE: number;
-export declare const GENESIS_ROOM_VARIANT = -1;
-export declare const GENESIS_ROOM_SUBTYPE = -1;
 export declare const GOLDEN_TRINKET_SHIFT: number;
 export declare const GRID_INDEX_CENTER_OF_1X1_ROOM = 67;
 export declare const GAME_FRAMES_PER_SECOND = 30;

package/dist/constants.lua

@@ -79,8 +79,6 @@ ____exports.FAMILIARS_THAT_SHOOT_PLAYER_TEARS = __TS__New(Set, {
 })
 ____exports.FINAL_STAGE = LevelStage.NUM_STAGES - 1
 ____exports.FIRST_GLITCHED_COLLECTIBLE_TYPE = (1 << 32) - 1
-____exports.GENESIS_ROOM_VARIANT = -1
-____exports.GENESIS_ROOM_SUBTYPE = -1
 ____exports.GOLDEN_TRINKET_SHIFT = 1 << 15
 ____exports.GRID_INDEX_CENTER_OF_1X1_ROOM = 67
 ____exports.GAME_FRAMES_PER_SECOND = 30

package/dist/features/saveDataManager/exports.d.ts

@@ -1,4 +1,4 @@
-import { SaveData } from "../../types/SaveData";
+import { SaveData } from "../../types/private/SaveData";
 /**
  * This is the entry point to the save data manager, a system which provides two major features:
  *

package/dist/features/saveDataManager/load.d.ts

@@ -1,4 +1,4 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="typescript-to-lua/language-extensions" />
-import { SaveData } from "../../types/SaveData";
+import { SaveData } from "../../types/private/SaveData";
 export declare function loadFromDisk(mod: Mod, oldSaveData: LuaTable<string, SaveData>): void;

package/dist/features/saveDataManager/main.lua

@@ -12,7 +12,7 @@ local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local ____ModCallbacksCustom = require("types.ModCallbacksCustom")
 local ModCallbacksCustom = ____ModCallbacksCustom.ModCallbacksCustom
-local ____SaveData = require("types.SaveData")
+local ____SaveData = require("types.private.SaveData")
 local SaveDataKeys = ____SaveData.SaveDataKeys
 local ____load = require("features.saveDataManager.load")
 local loadFromDisk = ____load.loadFromDisk

package/dist/features/saveDataManager/maps.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="typescript-to-lua/language-extensions" />
-import { SaveData } from "../../types/SaveData";
+import { SaveData } from "../../types/private/SaveData";
 export declare const saveDataMap: LuaTable<string, SaveData>;
 export declare const saveDataDefaultsMap: LuaTable<string, SaveData>;
 export declare const saveDataConditionalFuncMap: Map<string, () => boolean>;

package/dist/features/saveDataManager/merge.lua

@@ -17,7 +17,7 @@ local ____log = require("functions.log")
 local log = ____log.log
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
-local ____SerializationBrand = require("types.SerializationBrand")
+local ____SerializationBrand = require("types.private.SerializationBrand")
 local isSerializationBrand = ____SerializationBrand.isSerializationBrand
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____debug = require("features.saveDataManager.debug")

package/dist/features/saveDataManager/save.d.ts

@@ -1,4 +1,4 @@
 /// <reference types="isaac-typescript-definitions" />
 /// <reference types="typescript-to-lua/language-extensions" />
-import { SaveData } from "../../types/SaveData";
+import { SaveData } from "../../types/private/SaveData";
 export declare function saveToDisk(mod: Mod, saveDataMap: LuaTable<string, SaveData>, saveDataConditionalFuncMap: Map<string, () => boolean>): void;

package/dist/functions/array.d.ts

@@ -7,10 +7,12 @@
 export declare function arrayEquals<T>(array1: T[] | readonly T[], array2: T[] | readonly T[]): boolean;
 /**
  * Helper function to combine two or more arrays. Returns a new array that is the composition of all
- * of the specified arrays. This function is variadic, meaning that you can specify N arguments to
- * combine N arrays. Note that this will only perform a shallow copy of the array elements.
+ * of the specified arrays.
+ *
+ * This function is variadic, meaning that you can specify N arguments to combine N arrays. Note
+ * that this will only perform a shallow copy of the array elements.
  */
-export declare function combineArray<T>(...arrays: Array<T[] | readonly T[]>): T[];
+export declare function combineArrays<T>(...arrays: Array<T[] | readonly T[]>): T[];
 /**
  * Helper function to perform a shallow copy.
  *
@@ -53,14 +55,14 @@ export declare function arrayToString<T>(array: T[]): string;
  *
  * This function is variadic, meaning that you can specify N arguments to remove N elements.
  */
-export declare function arrayRemove<T>(originalArray: T[] | readonly T[], ...elements: T[]): T[];
+export declare function arrayRemove<T>(originalArray: T[] | readonly T[], ...elementsToRemove: T[]): T[];
 /**
  * Removes the specified element(s) from the array. If the specified element(s) are not found in the
  * array, this function will do nothing. Returns whether or not one or more elements were removed.
  *
  * This function is variadic, meaning that you can specify N arguments to remove N elements.
  */
-export declare function arrayRemoveInPlace<T>(array: T[], ...elements: T[] | readonly T[]): boolean;
+export declare function arrayRemoveInPlace<T>(array: T[], ...elementsToRemove: T[]): boolean;
 /**
  * Helper function to get a random element from the provided array.
  *

package/dist/functions/array.lua

@@ -6,6 +6,8 @@ local __TS__ArraySplice = ____lualib.__TS__ArraySplice
 local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__ArrayReduce = ____lualib.__TS__ArrayReduce
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
 local __TS__ArrayIndexOf = ____lualib.__TS__ArrayIndexOf
 local ____exports = {}
 local ____random = require("functions.random")
@@ -49,7 +51,7 @@ function ____exports.arrayEquals(self, array1, array2)
         end
     )
 end
-function ____exports.combineArray(self, ...)
+function ____exports.combineArrays(self, ...)
     local arrays = {...}
     local elements = {}
     for ____, array in ipairs(arrays) do
@@ -124,20 +126,20 @@ function ____exports.arrayToString(self, array)
     return ("[" .. commaSeparatedStrings) .. "]"
 end
 function ____exports.arrayRemove(self, originalArray, ...)
-    local elements = {...}
-    local array = ____exports.copyArray(nil, originalArray)
-    for ____, element in ipairs(elements) do
-        local index = __TS__ArrayIndexOf(array, element)
-        if index > -1 then
-            __TS__ArraySplice(array, index, 1)
+    local elementsToRemove = {...}
+    local elementsToRemoveSet = __TS__New(Set, elementsToRemove)
+    local array = {}
+    for ____, element in ipairs(originalArray) do
+        if not elementsToRemoveSet:has(element) then
+            __TS__ArrayPush(array, element)
         end
     end
     return array
 end
 function ____exports.arrayRemoveInPlace(self, array, ...)
-    local elements = {...}
+    local elementsToRemove = {...}
     local removedOneOrMoreElements = false
-    for ____, element in ipairs(elements) do
+    for ____, element in ipairs(elementsToRemove) do
         local index = __TS__ArrayIndexOf(array, element)
         if index > -1 then
             removedOneOrMoreElements = true

package/dist/functions/cards.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
+import { CardType } from "../types/CardType";
 /**
  * Helper function to get a card description from a Card enum value.
  *
@@ -20,13 +21,32 @@ export declare function getCardDescription(card: Card | int): string;
  */
 export declare function getCardName(card: Card | int): string;
 /**
- * Has an equal chance of returning any card (e.g. Fool, Reverse Fool, Wild Card, etc.). This will
- * not return any runes or objects like Dice Shard.
+ * Helper function to get a set of cards matching the type. Also see the [[`CardType`]] enum.
+ *
+ * This function is variadic, meaning that you can you can specify N card types to get a set
+ * containing cards that match any of the specified types.
+ */
+export declare function getCardsOfType(...cardTypes: CardType[]): Set<Card>;
+export declare function getCardType(card: Card | int): CardType;
+export declare function getMaxCards(): int;
+/**
+ * Has an equal chance of returning any card (e.g. Fool, Reverse Fool, Wild Card, etc.).
+ *
+ * This will not return:
+ * - any runes
+ * - any objects like Dice Shard
+ * - any modded cards.
  *
  * @param seed Optional. The seed with which to select the random card. `Random()` by default.
  * @param exceptions Optional. An array of cards to not select.
  */
 export declare function getRandomCard(seed?: number, exceptions?: Card[]): Card;
+/**
+ * @param cardType The card type that represents the pool of cards to select from.
+ * @param seed Optional. The seed with which to select the random card. `Random()` by default.
+ * @param exceptions Optional. An array of cards to not select.
+ */
+export declare function getRandomCardOfType(cardType: CardType, seed?: number, exceptions?: Card[]): Card;
 /**
  * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul of
  * Isaac, etc.). This will never return a Rune Shard.
@@ -36,16 +56,26 @@ export declare function getRandomCard(seed?: number, exceptions?: Card[]): Card;
  */
 export declare function getRandomRune(seed?: number, exceptions?: Card[]): Card;
 /**
- * Returns true for entries in the Card enum that are not a rune and not an object (e.g. Fool,
- * Reverse Fool, Wild Card, etc.).
+ * Returns true for cards that have the following card type:
+ * - CardType.TAROT
+ * - CardType.SUIT
+ * - CardType.SPECIAL
+ * - CardType.TAROT_REVERSE
  */
 export declare function isCard(card: Card): boolean;
-/**
- * Returns true for entries in the Card enum that are an object (like Dice Shard).
- */
+/** Returns whether or not the given card matches the specified card type. */
+export declare function isCardType(card: Card, cardType: CardType): boolean;
+/** Returns true for cards that have `CardType.MODDED`. */
+export declare function isModdedCard(card: Card): boolean;
+/** Returns true for cards that have `CardType.OBJECT`. */
 export declare function isPocketItemObject(card: Card): boolean;
-/**
- * Returns true for entries in the Card enum that are a rune (e.g. Rune of Hagalaz, Blank Rune,
- * Black Rune, Rune Shard, Soul of Isaac, etc.).
- */
+/** Returns true for cards that have `CardType.TAROT`. */
+export declare function isTarotCard(card: Card): boolean;
+/** Returns true for cards that have `CardType.TAROT_REVERSE`. */
+export declare function isReverseTarotCard(card: Card): boolean;
+/** Returns true for cards that have `CardType.RUNE`. */
 export declare function isRune(card: Card): boolean;
+/** Returns true for cards that have `CardType.SPECIAL`. */
+export declare function isSpecialCard(card: Card): boolean;
+/** Returns true for cards that have `CardType.SUIT`. */
+export declare function isSuitCard(card: Card): boolean;

package/dist/functions/cards.lua

@@ -1,20 +1,79 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
-local __TS__ArrayPush = ____lualib.__TS__ArrayPush
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
+local initCardObjects, CARD_TYPE_TO_CARDS_MAP, CARD_SET
 local ____cardDescriptionMap = require("maps.cardDescriptionMap")
 local CARD_DESCRIPTION_MAP = ____cardDescriptionMap.CARD_DESCRIPTION_MAP
 local ____cardNameMap = require("maps.cardNameMap")
 local CARD_NAME_MAP = ____cardNameMap.CARD_NAME_MAP
-local ____cards = require("sets.cards")
-local CARDS = ____cards.CARDS
-local CARD_SET = ____cards.CARD_SET
-local POCKET_ITEM_OBJECT_SET = ____cards.POCKET_ITEM_OBJECT_SET
-local RUNES = ____cards.RUNES
-local RUNE_SET = ____cards.RUNE_SET
-local ____array = require("functions.array")
-local arrayRemove = ____array.arrayRemove
-local getRandomArrayElement = ____array.getRandomArrayElement
+local ____cardTypeMap = require("maps.cardTypeMap")
+local CARD_TYPE_MAP = ____cardTypeMap.CARD_TYPE_MAP
+local DEFAULT_CARD_TYPE = ____cardTypeMap.DEFAULT_CARD_TYPE
+local ____CardType = require("types.CardType")
+local CardType = ____CardType.CardType
+local ____math = require("functions.math")
+local range = ____math.range
+local ____set = require("functions.set")
+local addSetsToSet = ____set.addSetsToSet
+local getRandomSetElement = ____set.getRandomSetElement
+local ____utils = require("functions.utils")
+local getEnumValues = ____utils.getEnumValues
+function initCardObjects(self)
+    local maxCards = ____exports.getMaxCards(nil)
+    for ____, cardType in ipairs(getEnumValues(nil, CardType)) do
+        CARD_TYPE_TO_CARDS_MAP:set(
+            cardType,
+            __TS__New(Set)
+        )
+    end
+    for ____, card in ipairs(range(nil, 1, maxCards)) do
+        local cardType = ____exports.getCardType(nil, card)
+        local cardTypeSet = CARD_TYPE_TO_CARDS_MAP:get(cardType)
+        if cardTypeSet == nil then
+            error("Failed to get the card set for card type: " .. tostring(cardType))
+        end
+        cardTypeSet:add(card)
+    end
+    local cards = ____exports.getCardsOfType(
+        nil,
+        CardType.TAROT,
+        CardType.SUIT,
+        CardType.SPECIAL,
+        CardType.TAROT_REVERSE
+    )
+    addSetsToSet(nil, CARD_SET, cards)
+end
+function ____exports.getCardsOfType(self, ...)
+    local cardTypes = {...}
+    if CARD_TYPE_TO_CARDS_MAP.size == 0 then
+        initCardObjects(nil)
+    end
+    local matchingCards = __TS__New(Set)
+    for ____, cardType in ipairs(cardTypes) do
+        local cardSet = CARD_TYPE_TO_CARDS_MAP:get(cardType)
+        if cardSet == nil then
+            error("Failed to get the cards for type: " .. tostring(cardType))
+        end
+        for ____, card in __TS__Iterator(cardSet:values()) do
+            matchingCards:add(card)
+        end
+    end
+    return matchingCards
+end
+function ____exports.getCardType(self, card)
+    local cardType = CARD_TYPE_MAP:get(card)
+    return cardType == nil and DEFAULT_CARD_TYPE or cardType
+end
+function ____exports.getMaxCards(self)
+    local itemConfig = Isaac.GetItemConfig()
+    return itemConfig:GetCards().Size - 1
+end
+CARD_TYPE_TO_CARDS_MAP = __TS__New(Map)
+CARD_SET = __TS__New(Set)
 function ____exports.getCardDescription(self, card)
     local itemConfig = Isaac.GetItemConfig()
     local defaultDescription = "Unknown"
@@ -54,12 +113,17 @@ function ____exports.getRandomCard(self, seed, exceptions)
     if exceptions == nil then
         exceptions = {}
     end
-    local cardsWithoutExceptions = arrayRemove(
-        nil,
-        CARDS,
-        table.unpack(exceptions)
-    )
-    return getRandomArrayElement(nil, cardsWithoutExceptions, seed)
+    return getRandomSetElement(nil, CARD_SET, seed, exceptions)
+end
+function ____exports.getRandomCardOfType(self, cardType, seed, exceptions)
+    if seed == nil then
+        seed = Random()
+    end
+    if exceptions == nil then
+        exceptions = {}
+    end
+    local cardSet = ____exports.getCardsOfType(nil, cardType)
+    return getRandomSetElement(nil, cardSet, seed, exceptions)
 end
 function ____exports.getRandomRune(self, seed, exceptions)
     if seed == nil then
@@ -68,21 +132,35 @@ function ____exports.getRandomRune(self, seed, exceptions)
     if exceptions == nil then
         exceptions = {}
     end
-    __TS__ArrayPush(exceptions, Card.RUNE_SHARD)
-    local runesWithoutExceptions = arrayRemove(
-        nil,
-        RUNES,
-        table.unpack(exceptions)
-    )
-    return getRandomArrayElement(nil, runesWithoutExceptions, seed)
+    local runesSet = ____exports.getCardsOfType(nil, CardType.RUNE)
+    runesSet:delete(Card.RUNE_SHARD)
+    return getRandomSetElement(nil, runesSet, seed, exceptions)
 end
 function ____exports.isCard(self, card)
     return CARD_SET:has(card)
 end
+function ____exports.isCardType(self, card, cardType)
+    return cardType == ____exports.getCardType(nil, card)
+end
+function ____exports.isModdedCard(self, card)
+    return ____exports.isCardType(nil, card, CardType.MODDED)
+end
 function ____exports.isPocketItemObject(self, card)
-    return POCKET_ITEM_OBJECT_SET:has(card)
+    return ____exports.isCardType(nil, card, CardType.OBJECT)
+end
+function ____exports.isTarotCard(self, card)
+    return ____exports.isCardType(nil, card, CardType.TAROT)
+end
+function ____exports.isReverseTarotCard(self, card)
+    return ____exports.isCardType(nil, card, CardType.TAROT_REVERSE)
 end
 function ____exports.isRune(self, card)
-    return RUNE_SET:has(card)
+    return ____exports.isCardType(nil, card, CardType.RUNE)
+end
+function ____exports.isSpecialCard(self, card)
+    return ____exports.isCardType(nil, card, CardType.SPECIAL)
+end
+function ____exports.isSuitCard(self, card)
+    return ____exports.isCardType(nil, card, CardType.SUIT)
 end
 return ____exports

package/dist/functions/collectibleCacheFlag.lua

@@ -4,7 +4,6 @@ local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local Set = ____lualib.Set
 local __TS__ArrayPush = ____lualib.__TS__ArrayPush
-local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
 local ____collectibles = require("functions.collectibles")
 local collectibleHasCacheFlag = ____collectibles.collectibleHasCacheFlag
@@ -13,6 +12,7 @@ local ____math = require("functions.math")
 local range = ____math.range
 local ____set = require("functions.set")
 local copySet = ____set.copySet
+local getSortedSetValues = ____set.getSortedSetValues
 local ____utils = require("functions.utils")
 local getEnumValues = ____utils.getEnumValues
 local ____repeat = ____utils["repeat"]
@@ -42,7 +42,7 @@ end
 function ____exports.getPlayerCollectiblesForCacheFlag(self, player, cacheFlag)
     local collectiblesForCacheFlag = ____exports.getCollectiblesForCacheFlag(nil, cacheFlag)
     local playerCollectibles = {}
-    for ____, collectibleType in __TS__Iterator(collectiblesForCacheFlag:values()) do
+    for ____, collectibleType in ipairs(getSortedSetValues(nil, collectiblesForCacheFlag)) do
         local numCollectibles = player:GetCollectibleNum(collectibleType)
         ____repeat(
             nil,

package/dist/functions/deepCopy.lua

@@ -11,7 +11,7 @@ local ____debug = require("features.saveDataManager.debug")
 local SAVE_DATA_MANAGER_DEBUG = ____debug.SAVE_DATA_MANAGER_DEBUG
 local ____DefaultMap = require("types.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
-local ____SerializationBrand = require("types.SerializationBrand")
+local ____SerializationBrand = require("types.private.SerializationBrand")
 local isSerializationBrand = ____SerializationBrand.isSerializationBrand
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____log = require("functions.log")

package/dist/functions/deepCopyTests.lua

@@ -8,7 +8,7 @@ local ____exports = {}
 local copiedObjectIsTable, copiedObjectHasKeyAndValueString, copiedTableHasKeyAndValueNumber, copiedTableDoesNotCoerceTypes, copiedObjectHasNoReferencesForPrimitivesForward, copiedObjectHasNoReferencesForPrimitivesBackward, copiedObjectHasNoReferencesForArray, copiedObjectHasChildObject, copiedMapIsMap, copiedMapHasValue, copiedSetIsSet, copiedSetHasValue, copiedMapHasChildMap, copiedDefaultMapHasChildDefaultMap, copiedDefaultMapHasBrand
 local ____DefaultMap = require("types.DefaultMap")
 local DefaultMap = ____DefaultMap.DefaultMap
-local ____SerializationBrand = require("types.SerializationBrand")
+local ____SerializationBrand = require("types.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____array = require("functions.array")
 local arrayEquals = ____array.arrayEquals

package/dist/functions/entity.d.ts

@@ -1,6 +1,17 @@
 /// <reference types="isaac-typescript-definitions" />
 import { AnyEntity } from "../types/AnyEntity";
 export declare function anyEntityCloserThan(entities: Entity[], position: Vector, distance: int): boolean;
+/**
+ * Helper function to count the number of entities in room. Use this over the vanilla
+ * `Isaac.CountEntities` method to avoid having to specify a spawner and to handle ignoring charmed
+ * enemies.
+ *
+ * @param entityType -1 by default.
+ * @param variant -1 by default.
+ * @param subType -1 by default.
+ * @param ignoreFriendly False by default.
+ */
+export declare function countEntities(entityType?: EntityType | int, variant?: number, subType?: number, ignoreFriendly?: boolean): number;
 /**
  * Given an array of entities, this helper function returns the closest one to a provided reference
  * entity.

package/dist/functions/entity.lua

@@ -19,6 +19,31 @@ function ____exports.anyEntityCloserThan(self, entities, position, distance)
         function(____, entity) return position:Distance(entity.Position) <= distance end
     )
 end
+function ____exports.countEntities(self, entityType, variant, subType, ignoreFriendly)
+    if entityType == nil then
+        entityType = -1
+    end
+    if variant == nil then
+        variant = -1
+    end
+    if subType == nil then
+        subType = -1
+    end
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    if not ignoreFriendly then
+        return Isaac.CountEntities(nil, entityType, variant, subType)
+    end
+    local entities = Isaac.FindByType(
+        entityType,
+        variant,
+        subType,
+        false,
+        ignoreFriendly
+    )
+    return #entities
+end
 function ____exports.getClosestEntityTo(self, referenceEntity, entities)
     local closestEntity = nil
     local closestDistance = math.huge

package/dist/functions/log.lua

@@ -15,10 +15,11 @@ local hasFlag = ____flag.hasFlag
 local ____player = require("functions.player")
 local getEffectsList = ____player.getEffectsList
 local ____rooms = require("functions.rooms")
+local getRoomData = ____rooms.getRoomData
 local getRoomGridIndex = ____rooms.getRoomGridIndex
 local getRoomListIndex = ____rooms.getRoomListIndex
-local getRoomSubType = ____rooms.getRoomSubType
-local getRoomVariant = ____rooms.getRoomVariant
+local ____set = require("functions.set")
+local getSortedSetValues = ____set.getSortedSetValues
 local ____trinkets = require("functions.trinkets")
 local getTrinketName = ____trinkets.getTrinketName
 function ____exports.getDebugPrependString(self, msg, numParentFunctions)
@@ -130,14 +131,14 @@ function ____exports.logMap(map)
     ____exports.log("The size of the map was: " .. tostring(map.size))
 end
 function ____exports.logRoom()
-    local game = Game()
-    local room = game:GetRoom()
-    local roomType = room:GetType()
-    local roomVariant = getRoomVariant(nil)
-    local roomSubType = getRoomSubType(nil)
     local roomGridIndex = getRoomGridIndex(nil)
     local roomListIndex = getRoomListIndex(nil)
-    ____exports.log((((("Current room type/variant/sub-type: " .. tostring(roomType)) .. ".") .. tostring(roomVariant)) .. ".") .. tostring(roomSubType))
+    local roomData = getRoomData(nil)
+    if roomData == nil then
+        ____exports.log("Current room data is undefined.")
+    else
+        ____exports.log((((("Current room type/variant/sub-type: " .. tostring(roomData.Type)) .. ".") .. tostring(roomData.Variant)) .. ".") .. tostring(roomData.Subtype))
+    end
     ____exports.log("Current room grid index: " .. tostring(roomGridIndex))
     ____exports.log("Current room list index: " .. tostring(roomListIndex))
 end
@@ -190,8 +191,7 @@ function ____exports.logTemporaryEffects(player)
 end
 function ____exports.logSet(set)
     ____exports.log("Printing out a TSTL Set:")
-    local setValues = {__TS__Spread(set:values())}
-    __TS__ArraySort(setValues)
+    local setValues = getSortedSetValues(nil, set)
     for ____, value in ipairs(setValues) do
         ____exports.log("  Value: " .. tostring(value))
     end

package/dist/functions/pickups.d.ts

@@ -11,13 +11,6 @@
  * ```
  */
 export declare function getPickups(matchingVariant?: PickupVariant | int, matchingSubType?: number): EntityPickup[];
-/**
- * Has as an equal chance of returning any value in the `HeartSubType` enum. Useful for spawning a random type of heart.
- *
- * @param seed Optional. The seed with which to select the random sub-type. `Random()` by default.
- * @param exceptions Optional. An array of sub-types to not select.
- */
-export declare function getRandomHeartSubType(seed?: number, exceptions?: HeartSubType[]): HeartSubType;
 export declare function isChest(pickup: EntityPickup): boolean;
 /**
  * Helper function to remove all of the pickups in the room.

package/dist/functions/pickups.lua

@@ -4,13 +4,9 @@ local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local ____exports = {}
 local ____constants = require("constants")
 local CHEST_PICKUP_VARIANTS = ____constants.CHEST_PICKUP_VARIANTS
-local ____array = require("functions.array")
-local getRandomArrayElement = ____array.getRandomArrayElement
 local ____entity = require("functions.entity")
 local getEntities = ____entity.getEntities
 local removeEntities = ____entity.removeEntities
-local ____utils = require("functions.utils")
-local getEnumValues = ____utils.getEnumValues
 function ____exports.getPickups(self, matchingVariant, matchingSubType)
     if matchingVariant == nil then
         matchingVariant = -1
@@ -28,16 +24,6 @@ function ____exports.getPickups(self, matchingVariant, matchingSubType)
     end
     return pickups
 end
-function ____exports.getRandomHeartSubType(self, seed, exceptions)
-    if seed == nil then
-        seed = Random()
-    end
-    if exceptions == nil then
-        exceptions = {}
-    end
-    local heartSubTypes = getEnumValues(nil, HeartSubType)
-    return getRandomArrayElement(nil, heartSubTypes, seed, exceptions)
-end
 function ____exports.isChest(self, pickup)
     return CHEST_PICKUP_VARIANTS:has(pickup.Variant)
 end

package/dist/functions/pills.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="isaac-typescript-definitions" />
 import { PillEffectClass } from "../types/PillEffectClass";
 import { PillEffectType } from "../types/PillEffectType";
+export declare function getMaxPillEffects(): int;
 /**
  * Helper function to get a pill effect class from a PillEffect enum value. In this context, the
  * class is equal to the numerical prefix in the "class" tag in the "pocketitems.xml" file. Use the

package/dist/functions/pills.lua

@@ -10,6 +10,10 @@ local ____PillEffectClass = require("types.PillEffectClass")
 local DEFAULT_PILL_EFFECT_CLASS = ____PillEffectClass.DEFAULT_PILL_EFFECT_CLASS
 local ____PillEffectType = require("types.PillEffectType")
 local DEFAULT_PILL_EFFECT_TYPE = ____PillEffectType.DEFAULT_PILL_EFFECT_TYPE
+function ____exports.getMaxPillEffects(self)
+    local itemConfig = Isaac.GetItemConfig()
+    return itemConfig:GetPillEffects().Size - 1
+end
 function ____exports.getPillEffectClass(self, pillEffect)
     local pillEffectClass = PILL_EFFECT_CLASS_MAP:get(pillEffect)
     return pillEffectClass == nil and DEFAULT_PILL_EFFECT_CLASS or pillEffectClass

package/dist/functions/rooms.d.ts

@@ -14,7 +14,10 @@ export declare function getAllRoomGridIndexes(): int[];
  * tricky to properly detect.
  */
 export declare function getCurrentDimension(): Dimension;
-/** Alias for the `Level.GetCurrentRoomDesc()` method. */
+/**
+ * Alias for the `Level.GetCurrentRoomDesc()` method. Use this to make it more clear what type of
+ * `RoomDescriptor` object that you are retrieving.
+ */
 export declare function getCurrentRoomDescriptorReadOnly(): RoomDescriptorReadOnly;
 /**
  * Helper function to get the room data for the provided room.
@@ -25,9 +28,10 @@ export declare function getRoomData(roomGridIndex?: int): RoomConfig | undefined
 /**
  * Helper function for getting the type of the room with the given grid index.
  *
+ * @param roomGridIndex Optional. Equal to the current room index by default.
  * @returns The room data type. Returns -1 if the type was not found.
  */
-export declare function getRoomType(roomGridIndex: int): RoomType;
+export declare function getRoomType(roomGridIndex?: int): RoomType;
 /**
  * Helper function to get the descriptor for a room.
  *
@@ -167,6 +171,7 @@ export declare function inDimension(dimension: Dimension): boolean;
 /** Helper function to determine if the current room shape is one of the four L room shapes. */
 export declare function inLRoom(): boolean;
 export declare function inGenesisRoom(): boolean;
+export declare function inMegaSatanRoom(): boolean;
 /**
  * Helper function to check if the current room is a miniboss room for a particular miniboss. This
  * will only work for minibosses that have dedicated boss rooms in the "00.special rooms.stb" file.

package/dist/functions/rooms.lua

@@ -1,17 +1,14 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
 local __TS__ArrayMap = ____lualib.__TS__ArrayMap
-local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
-local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
-local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local Map = ____lualib.Map
 local ____exports = {}
 local ____constants = require("constants")
-local GENESIS_ROOM_SUBTYPE = ____constants.GENESIS_ROOM_SUBTYPE
-local GENESIS_ROOM_VARIANT = ____constants.GENESIS_ROOM_VARIANT
 local MAX_ROOM_INDEX = ____constants.MAX_ROOM_INDEX
 local NUM_DIMENSIONS = ____constants.NUM_DIMENSIONS
 local ____doors = require("functions.doors")
@@ -43,11 +40,20 @@ function ____exports.getRoomDescriptor(self, roomGridIndex)
     local game = Game()
     local level = game:GetLevel()
     if roomGridIndex == nil then
-        local currentRoomDescriptor = ____exports.getCurrentRoomDescriptorReadOnly(nil)
-        roomGridIndex = currentRoomDescriptor.SafeGridIndex
+        roomGridIndex = ____exports.getRoomGridIndex(nil)
     end
     return level:GetRoomByIdx(roomGridIndex)
 end
+function ____exports.getRoomGridIndex(self)
+    local game = Game()
+    local level = game:GetLevel()
+    local currentRoomIndex = level:GetCurrentRoomIndex()
+    if currentRoomIndex < 0 then
+        return currentRoomIndex
+    end
+    local roomDescriptor = ____exports.getCurrentRoomDescriptorReadOnly(nil)
+    return roomDescriptor.SafeGridIndex
+end
 function ____exports.getRoomStageID(self, roomGridIndex)
     local roomData = ____exports.getRoomData(nil, roomGridIndex)
     return roomData == nil and -1 or roomData.StageID
@@ -133,22 +139,12 @@ function ____exports.getRoomType(self, roomGridIndex)
     local roomData = ____exports.getRoomData(nil, roomGridIndex)
     return roomData == nil and -1 or roomData.Type
 end
-function ____exports.getRoomGridIndex(self)
-    local game = Game()
-    local level = game:GetLevel()
-    local currentRoomIndex = level:GetCurrentRoomIndex()
-    if currentRoomIndex < 0 then
-        return currentRoomIndex
-    end
-    local roomDescriptor = ____exports.getCurrentRoomDescriptorReadOnly(nil)
-    return roomDescriptor.SafeGridIndex
-end
 function ____exports.getRoomGridIndexesForType(self, ...)
-    local roomTypes = {...}
+    local roomTypesSet = __TS__New(Set, {...})
     local rooms = ____exports.getRooms(nil)
     local matchingRooms = __TS__ArrayFilter(
         rooms,
-        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and __TS__ArrayIncludes(roomTypes, roomDescriptor.Data.Type) end
+        function(____, roomDescriptor) return roomDescriptor.Data ~= nil and roomTypesSet:has(roomDescriptor.Data.Type) end
     )
     return __TS__ArrayMap(
         matchingRooms,
@@ -239,9 +235,12 @@ function ____exports.inGenesisRoom(self)
     local game = Game()
     local room = game:GetRoom()
     local roomType = room:GetType()
-    local roomVariant = ____exports.getRoomVariant(nil)
     local roomSubType = ____exports.getRoomSubType(nil)
-    return roomType == RoomType.ROOM_ISAACS and roomVariant == GENESIS_ROOM_VARIANT and roomSubType == GENESIS_ROOM_SUBTYPE
+    return roomType == RoomType.ROOM_ISAACS and roomSubType == 99
+end
+function ____exports.inMegaSatanRoom(self)
+    local roomGridIndex = ____exports.getRoomGridIndex(nil)
+    return roomGridIndex == GridRooms.ROOM_MEGA_SATAN_IDX
 end
 function ____exports.inMinibossRoomOf(self, minibossID)
     local game = Game()
@@ -311,12 +310,12 @@ function ____exports.setRoomCleared(self)
     for ____, door in ipairs(getDoors(nil)) do
         do
             if isHiddenSecretRoomDoor(nil, door) then
-                goto __continue58
+                goto __continue59
             end
             openDoorFast(nil, door)
             door.ExtraVisible = false
         end
-        ::__continue58::
+        ::__continue59::
     end
     sfx:Stop(SoundEffect.SOUND_DOOR_HEAVY_OPEN)
     game:ShakeScreen(0)

package/dist/functions/set.d.ts

@@ -20,3 +20,18 @@ export declare function combineSets<T>(...sets: Array<Set<T> | ReadonlySet<T>>):
  * This function is variadic, meaning that you can specify N sets to remove from the first set.
  */
 export declare function deleteSetsFromSet<T>(mainSet: Set<T>, ...setsToRemove: Array<Set<T> | ReadonlySet<T>>): void;
+/**
+ * Helper function to get a random element from the provided set.
+ *
+ * @param set The set to get an element from.
+ * @param seed Optional. The seed used to select the random element. `Random()` by default.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, seed?: number, exceptions?: T[] | readonly T[]): T;
+/**
+ * Helper function to get a sorted array based on the contents of a set.
+ *
+ * Normally, set values are returned in a random order, so use this function when the ordering of
+ * the contents is important.
+ */
+export declare function getSortedSetValues<T>(set: Set<T> | ReadonlySet<T>): T[];

package/dist/functions/set.lua

@@ -3,7 +3,17 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__Iterator = ____lualib.__TS__Iterator
 local __TS__New = ____lualib.__TS__New
+local __TS__Spread = ____lualib.__TS__Spread
+local __TS__ArraySort = ____lualib.__TS__ArraySort
 local ____exports = {}
+local ____array = require("functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+function ____exports.getSortedSetValues(self, set)
+    local values = set:values()
+    local array = {__TS__Spread(values)}
+    __TS__ArraySort(array)
+    return array
+end
 function ____exports.addSetsToSet(self, mainSet, ...)
     local setsToAdd = {...}
     for ____, set in ipairs(setsToAdd) do
@@ -37,4 +47,14 @@ function ____exports.deleteSetsFromSet(self, mainSet, ...)
         end
     end
 end
+function ____exports.getRandomSetElement(self, set, seed, exceptions)
+    if seed == nil then
+        seed = Random()
+    end
+    if exceptions == nil then
+        exceptions = {}
+    end
+    local array = ____exports.getSortedSetValues(nil, set)
+    return getRandomArrayElement(nil, array, seed, exceptions)
+end
 return ____exports

package/dist/functions/sprite.d.ts

@@ -1,7 +1,9 @@
 /// <reference types="isaac-typescript-definitions" />
 /**
- * Helper function to clear a specific layer from a sprite. This function is variadic, so pass as
- * many layer IDs as you want to clear. If no specific layers are passed, it will clear every layer.
+ * Helper function to clear a specific layer from a sprite.
+ *
+ * This function is variadic, so pass as many layer IDs as you want to clear. If no specific layers
+ * are passed, it will clear every layer.
  *
  * Since there is no official API method to "clear" a sprite, we can work around it by setting the
  * spritesheet to a non-existent or completely transparent file. If the path to the spritesheet does

package/dist/functions/transformations.lua

@@ -7,6 +7,8 @@ local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
 local ____transformationNameMap = require("maps.transformationNameMap")
 local TRANSFORMATION_NAME_MAP = ____transformationNameMap.TRANSFORMATION_NAME_MAP
+local ____DefaultMap = require("types.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
 local ____collectibles = require("functions.collectibles")
 local collectibleHasTag = ____collectibles.collectibleHasTag
 local getMaxCollectibleType = ____collectibles.getMaxCollectibleType
@@ -31,8 +33,11 @@ local TRANSFORMATION_TO_TAG_MAP = __TS__New(Map, {
 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(Map)
-local function initMaps(self)
+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(
@@ -46,27 +51,23 @@ local function initMaps(self)
             local tag = ____value[2]
             do
                 if not collectibleHasTag(nil, collectibleType, tag) then
-                    goto __continue6
+                    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:get(collectibleType)
-                if transformations == nil then
-                    transformations = __TS__New(Set)
-                    COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP:set(collectibleType, transformations)
-                end
+                local transformations = COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP:getAndSetDefault(collectibleType)
                 transformations:add(playerForm)
             end
-            ::__continue6::
+            ::__continue7::
         end
     end
 end
 function ____exports.getCollectibleTypesForTransformation(self, playerForm)
     if TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP.size == 0 then
-        initMaps(nil)
+        initTransformationMaps(nil)
     end
     local collectibleTypes = TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:get(playerForm)
     return collectibleTypes == nil and __TS__New(Set) or copySet(nil, collectibleTypes)
@@ -76,7 +77,7 @@ function ____exports.getPlayerNumTransformationCollectibles(self, player, player
         error(("The transformation of " .. tostring(playerForm)) .. " cannot be tracked by this function.")
     end
     if TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP.size == 0 then
-        initMaps(nil)
+        initTransformationMaps(nil)
     end
     local itemsForTransformation = TRANSFORMATION_TO_COLLECTIBLE_TYPES_MAP:get(playerForm)
     if itemsForTransformation == nil then
@@ -95,7 +96,7 @@ function ____exports.getTransformationName(self, playerForm)
 end
 function ____exports.getTransformationsForCollectibleType(self, collectibleType)
     if COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP.size == 0 then
-        initMaps(nil)
+        initTransformationMaps(nil)
     end
     local transformations = COLLECTIBLE_TYPE_TO_TRANSFORMATION_MAP:get(collectibleType)
     return transformations == nil and __TS__New(Set) or copySet(nil, transformations)

package/dist/index.d.ts

@@ -77,9 +77,9 @@ export * from "./maps/roomShapeToTopLeftWallGridIndexMap";
 export * from "./maps/transformationNameMap";
 export * from "./maps/trinketDescriptionMap";
 export * from "./maps/trinketNameMap";
-export * from "./sets/cards";
 export * from "./types/AnyEntity";
 export * from "./types/CallbackParametersCustom";
+export * from "./types/CardType";
 export * from "./types/DefaultMap";
 export * from "./types/HealthType";
 export * from "./types/JSONDoor";

package/dist/index.lua

@@ -627,7 +627,7 @@ do
     end
 end
 do
-    local ____export = require("sets.cards")
+    local ____export = require("types.CardType")
     for ____exportKey, ____exportValue in pairs(____export) do
         if ____exportKey ~= "default" then
             ____exports[____exportKey] = ____exportValue

package/dist/maps/cardTypeMap.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="isaac-typescript-definitions" />
+import { CardType } from "../types/CardType";
+export declare const CARD_TYPE_MAP: ReadonlyMap<Card, CardType>;
+export declare const DEFAULT_CARD_TYPE = CardType.MODDED;

package/dist/maps/cardTypeMap.lua

@@ -0,0 +1,108 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____CardType = require("types.CardType")
+local CardType = ____CardType.CardType
+____exports.CARD_TYPE_MAP = __TS__New(Map, {
+    {Card.CARD_FOOL, CardType.TAROT},
+    {Card.CARD_MAGICIAN, CardType.TAROT},
+    {Card.CARD_HIGH_PRIESTESS, CardType.TAROT},
+    {Card.CARD_EMPRESS, CardType.TAROT},
+    {Card.CARD_EMPEROR, CardType.TAROT},
+    {Card.CARD_HIEROPHANT, CardType.TAROT},
+    {Card.CARD_LOVERS, CardType.TAROT},
+    {Card.CARD_CHARIOT, CardType.TAROT},
+    {Card.CARD_JUSTICE, CardType.TAROT},
+    {Card.CARD_HERMIT, CardType.TAROT},
+    {Card.CARD_WHEEL_OF_FORTUNE, CardType.TAROT},
+    {Card.CARD_STRENGTH, CardType.TAROT},
+    {Card.CARD_HANGED_MAN, CardType.TAROT},
+    {Card.CARD_DEATH, CardType.TAROT},
+    {Card.CARD_TEMPERANCE, CardType.TAROT},
+    {Card.CARD_DEVIL, CardType.TAROT},
+    {Card.CARD_TOWER, CardType.TAROT},
+    {Card.CARD_STARS, CardType.TAROT},
+    {Card.CARD_MOON, CardType.TAROT},
+    {Card.CARD_SUN, CardType.TAROT},
+    {Card.CARD_JUDGEMENT, CardType.TAROT},
+    {Card.CARD_WORLD, CardType.TAROT},
+    {Card.CARD_CLUBS_2, CardType.SUIT},
+    {Card.CARD_DIAMONDS_2, CardType.SUIT},
+    {Card.CARD_SPADES_2, CardType.SUIT},
+    {Card.CARD_HEARTS_2, CardType.SUIT},
+    {Card.CARD_ACE_OF_CLUBS, CardType.SUIT},
+    {Card.CARD_ACE_OF_DIAMONDS, CardType.SUIT},
+    {Card.CARD_ACE_OF_SPADES, CardType.SUIT},
+    {Card.CARD_ACE_OF_HEARTS, CardType.SUIT},
+    {Card.CARD_JOKER, CardType.SUIT},
+    {Card.RUNE_HAGALAZ, CardType.RUNE},
+    {Card.RUNE_JERA, CardType.RUNE},
+    {Card.RUNE_EHWAZ, CardType.RUNE},
+    {Card.RUNE_DAGAZ, CardType.RUNE},
+    {Card.RUNE_ANSUZ, CardType.RUNE},
+    {Card.RUNE_PERTHRO, CardType.RUNE},
+    {Card.RUNE_BERKANO, CardType.RUNE},
+    {Card.RUNE_ALGIZ, CardType.RUNE},
+    {Card.RUNE_BLANK, CardType.RUNE},
+    {Card.RUNE_BLACK, CardType.RUNE},
+    {Card.CARD_CHAOS, CardType.SPECIAL},
+    {Card.CARD_CREDIT, CardType.SPECIAL},
+    {Card.CARD_RULES, CardType.SPECIAL},
+    {Card.CARD_HUMANITY, CardType.SPECIAL},
+    {Card.CARD_SUICIDE_KING, CardType.SPECIAL},
+    {Card.CARD_GET_OUT_OF_JAIL, CardType.SPECIAL},
+    {Card.CARD_QUESTIONMARK, CardType.SPECIAL},
+    {Card.CARD_DICE_SHARD, CardType.OBJECT},
+    {Card.CARD_EMERGENCY_CONTACT, CardType.OBJECT},
+    {Card.CARD_HOLY, CardType.SPECIAL},
+    {Card.CARD_HUGE_GROWTH, CardType.SPECIAL},
+    {Card.CARD_ANCIENT_RECALL, CardType.SPECIAL},
+    {Card.CARD_ERA_WALK, CardType.SPECIAL},
+    {Card.RUNE_SHARD, CardType.RUNE},
+    {Card.CARD_REVERSE_FOOL, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_MAGICIAN, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_HIGH_PRIESTESS, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_EMPRESS, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_EMPEROR, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_HIEROPHANT, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_LOVERS, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_CHARIOT, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_JUSTICE, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_HERMIT, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_WHEEL_OF_FORTUNE, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_STRENGTH, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_HANGED_MAN, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_DEATH, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_TEMPERANCE, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_DEVIL, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_TOWER, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_STARS, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_MOON, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_SUN, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_JUDGEMENT, CardType.TAROT_REVERSE},
+    {Card.CARD_REVERSE_WORLD, CardType.TAROT_REVERSE},
+    {Card.CARD_CRACKED_KEY, CardType.OBJECT},
+    {Card.CARD_QUEEN_OF_HEARTS, CardType.SUIT},
+    {Card.CARD_WILD, CardType.SPECIAL},
+    {Card.CARD_SOUL_ISAAC, CardType.RUNE},
+    {Card.CARD_SOUL_MAGDALENE, CardType.RUNE},
+    {Card.CARD_SOUL_CAIN, CardType.RUNE},
+    {Card.CARD_SOUL_JUDAS, CardType.RUNE},
+    {Card.CARD_SOUL_BLUEBABY, CardType.RUNE},
+    {Card.CARD_SOUL_EVE, CardType.RUNE},
+    {Card.CARD_SOUL_SAMSON, CardType.RUNE},
+    {Card.CARD_SOUL_AZAZEL, CardType.RUNE},
+    {Card.CARD_SOUL_LAZARUS, CardType.RUNE},
+    {Card.CARD_SOUL_EDEN, CardType.RUNE},
+    {Card.CARD_SOUL_LOST, CardType.RUNE},
+    {Card.CARD_SOUL_LILITH, CardType.RUNE},
+    {Card.CARD_SOUL_KEEPER, CardType.RUNE},
+    {Card.CARD_SOUL_APOLLYON, CardType.RUNE},
+    {Card.CARD_SOUL_FORGOTTEN, CardType.RUNE},
+    {Card.CARD_SOUL_BETHANY, CardType.RUNE},
+    {Card.CARD_SOUL_JACOB, CardType.RUNE}
+})
+____exports.DEFAULT_CARD_TYPE = CardType.MODDED
+return ____exports

package/dist/types/CardType.d.ts

@@ -0,0 +1,38 @@
+/** Matches the "type" attribute in the "pocketitems.xml" file. */
+export declare enum CardType {
+    /** A normal card with a brown back, like "0 - The Fool". */
+    TAROT = 0,
+    /** A playing card with a red back, like 2 of Clubs. This includes the Queen of Hearts. */
+    SUIT = 1,
+    /**
+     * A left-facing rune like Hagalaz, a right-facing rune like Ansuz, a Black Rune, a Blank Rune, a
+     * a Rune Shard, or a "soul" rune like Soul of Isaac.
+     */
+    RUNE = 2,
+    /**
+     * A card that does not fall into any of the other categories, like a Chaos Card (42).
+     *
+     * Most of these have unique backs.
+     *
+     * 4 cards share the Magic the Gathering back:
+     * - Chaos Card (42)
+     * - Huge Growth (52)
+     * - Ancient Recall (53)
+     * - Era Walk (54)
+     *
+     * 3 cards have a red playing card back:
+     * - Rules Card (44)
+     * - Suicide King (46)
+     * - ? Card (48)
+     */
+    SPECIAL = 3,
+    /** A Dice Shard, an Emergency Contact, or a Cracked Key. */
+    OBJECT = 4,
+    /** A reverse tarot card with a reddish-brown back, like "0 - The Fool?". */
+    TAROT_REVERSE = 5,
+    /**
+     * This is not a real CardType. Due to limitations in the API, getting the real type of modded
+     * cards is not possible, so this value is returned instead.
+     */
+    MODDED = 6
+}

package/dist/types/CardType.lua

@@ -0,0 +1,18 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+____exports.CardType = CardType or ({})
+____exports.CardType.TAROT = 0
+____exports.CardType[____exports.CardType.TAROT] = "TAROT"
+____exports.CardType.SUIT = 1
+____exports.CardType[____exports.CardType.SUIT] = "SUIT"
+____exports.CardType.RUNE = 2
+____exports.CardType[____exports.CardType.RUNE] = "RUNE"
+____exports.CardType.SPECIAL = 3
+____exports.CardType[____exports.CardType.SPECIAL] = "SPECIAL"
+____exports.CardType.OBJECT = 4
+____exports.CardType[____exports.CardType.OBJECT] = "OBJECT"
+____exports.CardType.TAROT_REVERSE = 5
+____exports.CardType[____exports.CardType.TAROT_REVERSE] = "TAROT_REVERSE"
+____exports.CardType.MODDED = 6
+____exports.CardType[____exports.CardType.MODDED] = "MODDED"
+return ____exports

package/dist/types/private/SaveData.d.ts

@@ -0,0 +1,18 @@
+export interface SaveData {
+    persistent?: Record<string, unknown>;
+    run?: Record<string, unknown>;
+    level?: Record<string, unknown>;
+    room?: Record<string, unknown>;
+    dontSave?: boolean;
+}
+export interface SaveDataWithoutRoom {
+    persistent?: Record<string, unknown>;
+    run?: Record<string, unknown>;
+    level?: Record<string, unknown>;
+}
+export declare enum SaveDataKeys {
+    Persistent = "persistent",
+    Run = "run",
+    Level = "level",
+    Room = "room"
+}

package/dist/types/private/SaveData.lua

@@ -0,0 +1,8 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+____exports.SaveDataKeys = SaveDataKeys or ({})
+____exports.SaveDataKeys.Persistent = "persistent"
+____exports.SaveDataKeys.Run = "run"
+____exports.SaveDataKeys.Level = "level"
+____exports.SaveDataKeys.Room = "room"
+return ____exports

package/dist/types/private/SerializationBrand.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="typescript-to-lua/language-extensions" />
+export declare enum SerializationBrand {
+    DEFAULT_MAP = "__TSTL_DEFAULT_MAP",
+    /**
+     * This is set to the value that represents the default value (instead of an empty string like the
+     * other brands are).
+     */
+    DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE",
+    MAP = "__TSTL_MAP",
+    SET = "__TSTL_SET",
+    CLASS = "__TSTL_CLASS",
+    OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS",
+    VECTOR = "__VECTOR"
+}
+export declare function isSerializationBrand(key: AnyNotNil): boolean;

package/dist/types/private/SerializationBrand.lua

@@ -0,0 +1,24 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local ____utils = require("functions.utils")
+local getEnumValues = ____utils.getEnumValues
+____exports.SerializationBrand = SerializationBrand or ({})
+____exports.SerializationBrand.DEFAULT_MAP = "__TSTL_DEFAULT_MAP"
+____exports.SerializationBrand.DEFAULT_MAP_VALUE = "__TSTL_DEFAULT_MAP_VALUE"
+____exports.SerializationBrand.MAP = "__TSTL_MAP"
+____exports.SerializationBrand.SET = "__TSTL_SET"
+____exports.SerializationBrand.CLASS = "__TSTL_CLASS"
+____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
+____exports.SerializationBrand.VECTOR = "__VECTOR"
+local SERIALIZATION_BRANDS = getEnumValues(nil, ____exports.SerializationBrand)
+local SERIALIZATION_BRAND_SET = __TS__New(Set, SERIALIZATION_BRANDS)
+function ____exports.isSerializationBrand(self, key)
+    if type(key) ~= "string" then
+        return false
+    end
+    return SERIALIZATION_BRAND_SET:has(key)
+end
+return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.102",
+  "version": "1.2.105",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",