isaacscript-common 1.2.139 → 1.2.142

package/dist/callbacks/postSlotRender.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/callbacks/postSlotRender.lua

@@ -0,0 +1,73 @@
+--[[ 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 hasSubscriptions, postRender, checkSlotAnimationChanged, checkSlotBroken, BROKEN_ANIMATIONS, v
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local ____entitySpecific = require("functions.entitySpecific")
+local getSlots = ____entitySpecific.getSlots
+local ____DefaultMap = require("types.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
+local ____postSlotAnimationChanged = require("callbacks.subscriptions.postSlotAnimationChanged")
+local postSlotAnimationChangedFire = ____postSlotAnimationChanged.postSlotAnimationChangedFire
+local postSlotAnimationChangedHasSubscriptions = ____postSlotAnimationChanged.postSlotAnimationChangedHasSubscriptions
+local ____postSlotDestroyed = require("callbacks.subscriptions.postSlotDestroyed")
+local postSlotDestroyedFire = ____postSlotDestroyed.postSlotDestroyedFire
+local postSlotDestroyedHasSubscriptions = ____postSlotDestroyed.postSlotDestroyedHasSubscriptions
+local ____postSlotRender = require("callbacks.subscriptions.postSlotRender")
+local postSlotRenderFire = ____postSlotRender.postSlotRenderFire
+local postSlotRenderHasSubscriptions = ____postSlotRender.postSlotRenderHasSubscriptions
+function hasSubscriptions(self)
+    return postSlotRenderHasSubscriptions(nil) or postSlotDestroyedHasSubscriptions(nil) or postSlotAnimationChangedHasSubscriptions(nil)
+end
+function postRender(self)
+    if not hasSubscriptions(nil) then
+        return
+    end
+    for ____, slot in ipairs(getSlots(nil)) do
+        postSlotRenderFire(nil, slot)
+        checkSlotAnimationChanged(nil, slot)
+        checkSlotBroken(nil, slot)
+    end
+end
+function checkSlotAnimationChanged(self, slot)
+    local sprite = slot:GetSprite()
+    local currentAnimation = sprite:GetAnimation()
+    local ptrHash = GetPtrHash(slot)
+    local previousAnimation = v.room.slotAnimations:getAndSetDefault(ptrHash, slot)
+    v.room.slotAnimations:set(ptrHash, currentAnimation)
+    if currentAnimation ~= previousAnimation then
+        postSlotAnimationChangedFire(nil, slot, previousAnimation, currentAnimation)
+    end
+end
+function checkSlotBroken(self, slot)
+    local ptrHash = GetPtrHash(slot)
+    local alreadyBroken = v.room.brokenSlots:has(ptrHash)
+    if alreadyBroken then
+        return
+    end
+    local sprite = slot:GetSprite()
+    local animation = sprite:GetAnimation()
+    if BROKEN_ANIMATIONS:has(animation) then
+        v.room.brokenSlots:add(ptrHash)
+        postSlotDestroyedFire(nil, slot)
+    end
+end
+BROKEN_ANIMATIONS = __TS__New(Set, {"Broken", "Death"})
+v = {room = {
+    slotAnimations = __TS__New(
+        DefaultMap,
+        function(____, _key, slot)
+            local sprite = slot:GetSprite()
+            return sprite:GetAnimation()
+        end
+    ),
+    brokenSlots = __TS__New(Set)
+}}
+function ____exports.postSlotRenderCallbacksInit(self, mod)
+    saveDataManager(nil, "postSlotRender", v, hasSubscriptions)
+    mod:AddCallback(ModCallbacks.MC_POST_RENDER, postRender)
+end
+return ____exports

package/dist/callbacks/subscriptions/postSlotAnimationChanged.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="isaac-typescript-definitions" />
+export declare type PostSlotAnimationChangedCallbackType = (slot: Entity, previousAnimation: string, currentAnimation: string) => void;

package/dist/callbacks/subscriptions/postSlotAnimationChanged.lua

@@ -0,0 +1,25 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
+local ____exports = {}
+local subscriptions = {}
+function ____exports.postSlotAnimationChangedHasSubscriptions(self)
+    return #subscriptions > 0
+end
+function ____exports.postSlotAnimationChangedRegister(self, callback, slotVariant)
+    __TS__ArrayPush(subscriptions, {callback, slotVariant})
+end
+function ____exports.postSlotAnimationChangedFire(self, slot, previousAnimation, currentAnimation)
+    for ____, ____value in ipairs(subscriptions) do
+        local callback = ____value[1]
+        local slotVariant = ____value[2]
+        do
+            if slotVariant ~= nil and slotVariant ~= slot.Variant then
+                goto __continue5
+            end
+            callback(nil, slot, previousAnimation, currentAnimation)
+        end
+        ::__continue5::
+    end
+end
+return ____exports

package/dist/features/extraConsoleCommands/commands.lua

@@ -11,6 +11,8 @@ local sfxManager = ____cachedClasses.sfxManager
 local ____constants = require("constants")
 local PILL_GIANT_FLAG = ____constants.PILL_GIANT_FLAG
 local TRINKET_GOLDEN_FLAG = ____constants.TRINKET_GOLDEN_FLAG
+local ____cards = require("functions.cards")
+local getCardName = ____cards.getCardName
 local ____gridEntity = require("functions.gridEntity")
 local spawnGridEntityWithVariant = ____gridEntity.spawnGridEntityWithVariant
 local ____log = require("functions.log")
@@ -24,7 +26,10 @@ local ____map = require("functions.map")
 local getMapPartialMatch = ____map.getMapPartialMatch
 local ____npc = require("functions.npc")
 local getNPCs = ____npc.getNPCs
+local ____pills = require("functions.pills")
+local getPillEffectName = ____pills.getPillEffectName
 local ____player = require("functions.player")
+local getCharacterName = ____player.getCharacterName
 local getPlayers = ____player.getPlayers
 local useActiveItemTemp = ____player.useActiveItemTemp
 local ____playerHealth = require("functions.playerHealth")
@@ -49,6 +54,7 @@ local PILL_EFFECT_MAP = ____pillEffectMap.PILL_EFFECT_MAP
 local ____roomTypeMap = require("maps.roomTypeMap")
 local ROOM_TYPE_MAP = ____roomTypeMap.ROOM_TYPE_MAP
 local ____roomTypeNameMap = require("maps.roomTypeNameMap")
+local DEFAULT_ROOM_TYPE_NAME = ____roomTypeNameMap.DEFAULT_ROOM_TYPE_NAME
 local ROOM_TYPE_NAME_MAP = ____roomTypeNameMap.ROOM_TYPE_NAME_MAP
 local ____HealthType = require("types.HealthType")
 local HealthType = ____HealthType.HealthType
@@ -176,8 +182,8 @@ function spawnTrapdoorOrCrawlspace(self, trapdoor)
     spawnGridEntityWithVariant(nil, gridEntityType, 0, gridIndex)
 end
 function warpToRoomType(self, roomType)
-    local roomTypeName = ROOM_TYPE_NAME_MAP:get(roomType)
-    if roomTypeName == nil then
+    local roomTypeName = ROOM_TYPE_NAME_MAP[roomType]
+    if roomTypeName == nil or roomTypeName == DEFAULT_ROOM_TYPE_NAME then
         printConsole(
             nil,
             "Invalid room type: " .. tostring(roomType)
@@ -185,17 +191,14 @@ function warpToRoomType(self, roomType)
     end
     local gridIndexes = getRoomGridIndexesForType(nil, roomType)
     if #gridIndexes == 0 then
-        printConsole(
-            nil,
-            ("There are no " .. tostring(roomTypeName)) .. "s on this floor."
-        )
+        printConsole(nil, ("There are no " .. roomTypeName) .. "s on this floor.")
         return
     end
     local firstGridIndex = gridIndexes[1]
     changeRoom(nil, firstGridIndex)
     printConsole(
         nil,
-        ((("Warped to room type: " .. tostring(roomTypeName)) .. " (") .. tostring(roomType)) .. ")"
+        ((("Warped to room type: " .. roomTypeName) .. " (") .. tostring(roomType)) .. ")"
     )
 end
 DEFAULT_MOVE_UNITS = 0.5
@@ -322,28 +325,30 @@ function ____exports.card(self, params)
         printConsole(nil, "You must specify a card name or number.")
         return
     end
+    local cardNum
     local num = tonumber(params)
-    if num ~= nil then
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, CARD_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown card: " .. params)
+            return
+        end
+        cardNum = match[2]
+    else
         if num < 1 or num >= Card.NUM_CARDS then
-            printConsole(nil, "That is an invalid card sub-type.")
+            printConsole(
+                nil,
+                "Invalid card sub-type: " .. tostring(num)
+            )
             return
         end
-        Isaac.ExecuteCommand("g k" .. tostring(num))
-        printConsole(
-            nil,
-            "Gave card: " .. tostring(num)
-        )
-        return
-    end
-    local match = getMapPartialMatch(nil, params, CARD_MAP)
-    if match == nil then
-        printConsole(nil, "Unknown card: " .. params)
-        return
+        cardNum = num
     end
-    Isaac.ExecuteCommand("g k" .. tostring(match))
+    local cardName = getCardName(nil, cardNum)
+    Isaac.ExecuteCommand("g k" .. tostring(cardNum))
     printConsole(
         nil,
-        "Gave card: " .. tostring(match)
+        ((("Gave card: " .. cardName) .. " (") .. tostring(cardNum)) .. ")"
     )
 end
 function ____exports.cards(self)
@@ -382,28 +387,30 @@ function ____exports.characterCommand(self, params)
         printConsole(nil, "You must specify a character name or number.")
         return
     end
+    local character
     local num = tonumber(params)
-    if num ~= nil then
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, CHARACTER_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown character: " .. params)
+            return
+        end
+        character = match[2]
+    else
         if num < 0 or num >= PlayerType.NUM_PLAYER_TYPES then
-            printConsole(nil, "That is an invalid player sub-type.")
+            printConsole(
+                nil,
+                "Invalid player sub-type: " .. tostring(num)
+            )
             return
         end
-        printConsole(
-            nil,
-            "Restarting as character: " .. tostring(num)
-        )
-        restart(nil, num)
-        return
-    end
-    local match = getMapPartialMatch(nil, params, CHARACTER_MAP)
-    if match == nil then
-        printConsole(nil, "Unknown character: " .. params)
-        return
+        character = num
     end
-    restart(nil, match)
+    local characterName = getCharacterName(nil, character)
+    restart(nil, character)
     printConsole(
         nil,
-        "Restarting as character: " .. tostring(match)
+        ((("Restarting as character: " .. characterName) .. " (") .. tostring(character)) .. ")"
     )
 end
 function ____exports.charge(self, params)
@@ -600,28 +607,30 @@ function ____exports.pill(self, params)
         printConsole(nil, "You must specify a pill name or number.")
         return
     end
+    local pillEffect
     local num = tonumber(params)
-    if num ~= nil then
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, PILL_EFFECT_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown pill effect: " .. params)
+            return
+        end
+        pillEffect = match[2]
+    else
         if num < 1 or num >= PillEffect.NUM_PILL_EFFECTS then
-            printConsole(nil, "That is an invalid pill effect ID.")
+            printConsole(
+                nil,
+                "Invalid pill effect ID: " .. tostring(num)
+            )
             return
         end
-        Isaac.ExecuteCommand("g p" .. tostring(num))
-        printConsole(
-            nil,
-            "Gave pill: " .. tostring(num)
-        )
-        return
-    end
-    local match = getMapPartialMatch(nil, params, PILL_EFFECT_MAP)
-    if match == nil then
-        printConsole(nil, "Unknown pill effect: " .. params)
-        return
+        pillEffect = num
     end
-    Isaac.ExecuteCommand("g p" .. tostring(match))
+    local pillEffectName = getPillEffectName(nil, pillEffect)
+    Isaac.ExecuteCommand("g p" .. tostring(pillEffect))
     printConsole(
         nil,
-        "Gave pill: " .. tostring(match)
+        ((("Gave pill: " .. pillEffectName) .. " (") .. tostring(pillEffect)) .. ")"
     )
 end
 function ____exports.pills(self)
@@ -911,20 +920,25 @@ function ____exports.warp(self, params)
         printConsole(nil, "You must specify a room type name or number.")
         return
     end
+    local roomType
     local num = tonumber(params)
-    if num ~= nil then
+    if num == nil then
+        local match = getMapPartialMatch(nil, params, ROOM_TYPE_MAP)
+        if match == nil then
+            printConsole(nil, "Unknown room type: " .. params)
+            return
+        end
+        roomType = match[2]
+    else
         if num < 1 or num >= RoomType.NUM_ROOMTYPES then
-            printConsole(nil, "That is an invalid room type.")
+            printConsole(
+                nil,
+                "Invalid room type: " .. tostring(num)
+            )
             return
         end
-        warpToRoomType(nil, num)
-        return
-    end
-    local match = getMapPartialMatch(nil, params, ROOM_TYPE_MAP)
-    if match == nil then
-        printConsole(nil, "Unknown room type: " .. params)
-        return
+        roomType = num
     end
-    warpToRoomType(nil, match)
+    warpToRoomType(nil, roomType)
 end
 return ____exports

package/dist/features/extraConsoleCommands/init.lua

@@ -44,12 +44,14 @@ function postCurseEval(self, curses)
     return v.persistent.disableCurses and LevelCurse.CURSE_NONE or curses
 end
 function executeCmd(self, command, params)
-    local commandFunction = getMapPartialMatch(nil, command, commandFunctionsMap)
-    if commandFunction == nil then
+    local resultTuple = getMapPartialMatch(nil, command, commandFunctionsMap)
+    if resultTuple == nil then
         printConsole(nil, "That is an invalid console command.")
-    else
-        commandFunction(nil, params)
+        return
     end
+    local commandName, commandFunction = table.unpack(resultTuple)
+    printConsole(nil, "Command: " .. commandName)
+    commandFunction(nil, params)
 end
 function postFireTear(self, tear)
     if v.run.chaosCardTears then

package/dist/features/playerInventory.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * Helper function to get all of the collectibles that the player has gotten so far on this run, in
+ * order. This does not include active items.
+ */
+export declare function getPlayerInventory(player: EntityPlayer): CollectibleType[];

package/dist/features/playerInventory.lua

@@ -0,0 +1,73 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+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 newPlayerInventory, useItemD4, postPlayerInit, postItemPickup, v
+local ____featuresInitialized = require("featuresInitialized")
+local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
+local ____collectibleSet = require("functions.collectibleSet")
+local getCollectibleSet = ____collectibleSet.getCollectibleSet
+local ____player = require("functions.player")
+local getPlayerIndex = ____player.getPlayerIndex
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+local ____DefaultMap = require("types.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
+local ____ModCallbacksCustom = require("types.ModCallbacksCustom")
+local ModCallbacksCustom = ____ModCallbacksCustom.ModCallbacksCustom
+local ____exports = require("features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+function newPlayerInventory(self, player)
+    local inventory = {}
+    local collectibleSet = getCollectibleSet(nil)
+    for ____, collectibleType in __TS__Iterator(collectibleSet:values()) do
+        local numCollectibles = player:GetCollectibleNum(collectibleType, true)
+        ____repeat(
+            nil,
+            numCollectibles,
+            function()
+                __TS__ArrayPush(inventory, collectibleType)
+            end
+        )
+    end
+    return inventory
+end
+function useItemD4(self, _collectibleType, _rng, player)
+    local playerIndex = getPlayerIndex(nil, player)
+    local inventory = newPlayerInventory(nil, player)
+    v.run.playersInventory:set(playerIndex, inventory)
+end
+function postPlayerInit(self, player)
+    local playerIndex = getPlayerIndex(nil, player)
+    if not v.run.playersInventory:has(playerIndex) then
+        local inventory = newPlayerInventory(nil, player)
+        v.run.playersInventory:set(playerIndex, inventory)
+    end
+end
+function postItemPickup(self, player, pickingUpItem)
+    if pickingUpItem.itemType == ItemType.ITEM_PASSIVE or pickingUpItem.itemType == ItemType.ITEM_FAMILIAR then
+        local playerIndex = getPlayerIndex(nil, player)
+        local inventory = v.run.playersInventory:getAndSetDefault(playerIndex, player)
+        __TS__ArrayPush(inventory, pickingUpItem.subType)
+    end
+end
+local FEATURE_NAME = "player inventory tracker"
+v = {run = {playersInventory = __TS__New(
+    DefaultMap,
+    function(____, _key, player) return newPlayerInventory(nil, player) end
+)}}
+function ____exports.playerInventoryInit(self, mod)
+    saveDataManager(nil, "playerInventory", v)
+    mod:AddCallback(ModCallbacks.MC_USE_ITEM, useItemD4, CollectibleType.COLLECTIBLE_D4)
+    mod:AddCallback(ModCallbacks.MC_POST_PLAYER_INIT, postPlayerInit)
+    mod:AddCallbackCustom(ModCallbacksCustom.MC_POST_ITEM_PICKUP, postItemPickup)
+end
+function ____exports.getPlayerInventory(self, player)
+    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
+    local playerIndex = getPlayerIndex(nil, player)
+    return v.run.playersInventory:getAndSetDefault(playerIndex, player)
+end
+return ____exports

package/dist/functions/cards.lua

@@ -10,8 +10,10 @@ local ____cachedClasses = require("cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____cardDescriptionMap = require("maps.cardDescriptionMap")
 local CARD_DESCRIPTION_MAP = ____cardDescriptionMap.CARD_DESCRIPTION_MAP
+local DEFAULT_CARD_DESCRIPTION = ____cardDescriptionMap.DEFAULT_CARD_DESCRIPTION
 local ____cardNameMap = require("maps.cardNameMap")
 local CARD_NAME_MAP = ____cardNameMap.CARD_NAME_MAP
+local DEFAULT_CARD_NAME = ____cardNameMap.DEFAULT_CARD_NAME
 local ____cardTypeMap = require("maps.cardTypeMap")
 local CARD_TYPE_MAP = ____cardTypeMap.CARD_TYPE_MAP
 local DEFAULT_CARD_TYPE = ____cardTypeMap.DEFAULT_CARD_TYPE
@@ -67,7 +69,7 @@ function ____exports.getCardsOfType(self, ...)
     return matchingCards
 end
 function ____exports.getCardType(self, card)
-    local cardType = CARD_TYPE_MAP:get(card)
+    local cardType = CARD_TYPE_MAP[card]
     return cardType == nil and DEFAULT_CARD_TYPE or cardType
 end
 function ____exports.getMaxCards(self)
@@ -76,34 +78,26 @@ end
 CARD_TYPE_TO_CARDS_MAP = __TS__New(Map)
 CARD_SET = __TS__New(Set)
 function ____exports.getCardDescription(self, card)
-    local defaultDescription = "Unknown"
-    if type(card) ~= "number" then
-        return defaultDescription
-    end
-    local cardDescription = CARD_DESCRIPTION_MAP:get(card)
+    local cardDescription = CARD_DESCRIPTION_MAP[card]
     if cardDescription ~= nil then
         return cardDescription
     end
     local itemConfigCard = itemConfig:GetCard(card)
-    if itemConfigCard == nil then
-        return defaultDescription
+    if itemConfigCard ~= nil then
+        return itemConfigCard.Description
     end
-    return itemConfigCard.Description
+    return DEFAULT_CARD_DESCRIPTION
 end
 function ____exports.getCardName(self, card)
-    local defaultName = "Unknown"
-    if type(card) ~= "number" then
-        return defaultName
-    end
-    local cardName = CARD_NAME_MAP:get(card)
-    if cardName ~= nil then
+    local cardName = CARD_NAME_MAP[card]
+    if cardName ~= nil and cardName ~= DEFAULT_CARD_NAME then
         return cardName
     end
     local itemConfigCard = itemConfig:GetCard(card)
-    if itemConfigCard == nil then
-        return defaultName
+    if itemConfigCard ~= nil then
+        return itemConfigCard.Name
     end
-    return itemConfigCard.Name
+    return DEFAULT_CARD_NAME
 end
 function ____exports.getRandomCard(self, seed, exceptions)
     if seed == nil then

package/dist/functions/challenges.lua

@@ -2,8 +2,9 @@
 local ____exports = {}
 local ____challengeNameMap = require("maps.challengeNameMap")
 local CHALLENGE_NAME_MAP = ____challengeNameMap.CHALLENGE_NAME_MAP
+local DEFAULT_CHALLENGE_NAME = ____challengeNameMap.DEFAULT_CHALLENGE_NAME
 function ____exports.getChallengeName(self, challenge)
-    local challengeName = CHALLENGE_NAME_MAP:get(challenge)
-    return challengeName == nil and "Unknown" or challengeName
+    local challengeName = CHALLENGE_NAME_MAP[challenge]
+    return challengeName == nil and DEFAULT_CHALLENGE_NAME or challengeName
 end
 return ____exports

package/dist/functions/collectibles.lua

@@ -8,8 +8,10 @@ local BLIND_ITEM_PNG_PATH = ____constants.BLIND_ITEM_PNG_PATH
 local SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES = ____constants.SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES
 local ____collectibleDescriptionMap = require("maps.collectibleDescriptionMap")
 local COLLECTIBLE_DESCRIPTION_MAP = ____collectibleDescriptionMap.COLLECTIBLE_DESCRIPTION_MAP
+local DEFAULT_COLLECTIBLE_DESCRIPTION = ____collectibleDescriptionMap.DEFAULT_COLLECTIBLE_DESCRIPTION
 local ____collectibleNameMap = require("maps.collectibleNameMap")
 local COLLECTIBLE_NAME_MAP = ____collectibleNameMap.COLLECTIBLE_NAME_MAP
+local DEFAULT_COLLECTIBLE_NAME = ____collectibleNameMap.DEFAULT_COLLECTIBLE_NAME
 local ____flag = require("functions.flag")
 local hasFlag = ____flag.hasFlag
 local ____pickups = require("functions.pickups")
@@ -50,19 +52,15 @@ function ____exports.collectibleHasCacheFlag(self, collectibleType, cacheFlag)
     return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
 end
 function ____exports.getCollectibleDescription(self, collectibleType)
-    local defaultDescription = "Unknown"
-    if type(collectibleType) ~= "number" then
-        return defaultDescription
-    end
     local collectibleDescription = COLLECTIBLE_DESCRIPTION_MAP:get(collectibleType)
     if collectibleDescription ~= nil then
         return collectibleDescription
     end
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-    if itemConfigItem == nil then
-        return defaultDescription
+    if itemConfigItem ~= nil then
+        return itemConfigItem.Description
     end
-    return itemConfigItem.Description
+    return DEFAULT_COLLECTIBLE_DESCRIPTION
 end
 function ____exports.getCollectibleDevilHeartPrice(self, collectibleType, player)
     local maxHearts = player:GetMaxHearts()
@@ -116,19 +114,15 @@ function ____exports.getCollectibleMaxCharges(self, collectibleType)
     return itemConfigItem.MaxCharges
 end
 function ____exports.getCollectibleName(self, collectibleType)
-    local defaultName = "Unknown"
-    if type(collectibleType) ~= "number" then
-        return defaultName
-    end
     local collectibleName = COLLECTIBLE_NAME_MAP:get(collectibleType)
     if collectibleName ~= nil then
         return collectibleName
     end
     local itemConfigItem = itemConfig:GetCollectible(collectibleType)
-    if itemConfigItem == nil then
-        return defaultName
+    if itemConfigItem ~= nil then
+        return itemConfigItem.Name
     end
-    return itemConfigItem.Name
+    return DEFAULT_COLLECTIBLE_NAME
 end
 function ____exports.getCollectiblePedestalType(self, collectible)
     if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then

package/dist/functions/map.d.ts

@@ -20,9 +20,12 @@ export declare function defaultMapGetNextSeed<K, A extends unknown[]>(map: Defau
  * ]);
  * const searchText = "f";
  * const match = getMapPartialMatch(map, searchText); // match is now equal to 123
+ *
+ * @returns If a match was found, returns a tuple of the map key and value. If a match was not
+ * found, returns undefined.
  * ```
  */
-export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): T | undefined;
+export declare function getMapPartialMatch<T>(searchText: string, map: ReadonlyMap<string, T>): [string, T] | undefined;
 /**
  * Helper function to make using maps with `Seed` values easier. Use this instead of manually
  * getting the current value, incrementing it, and then setting it.

package/dist/functions/map.lua

@@ -46,7 +46,11 @@ function ____exports.getMapPartialMatch(self, searchText, map)
     if matchingKey == nil then
         return nil
     end
-    return map:get(matchingKey)
+    local value = map:get(matchingKey)
+    if value == nil then
+        return nil
+    end
+    return {matchingKey, value}
 end
 function ____exports.mapGetNextSeed(self, map, key)
     local seed = map:get(key)

package/dist/functions/pills.lua

@@ -3,39 +3,34 @@ local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local itemConfig = ____cachedClasses.itemConfig
 local ____pillEffectClassMap = require("maps.pillEffectClassMap")
+local DEFAULT_PILL_EFFECT_CLASS = ____pillEffectClassMap.DEFAULT_PILL_EFFECT_CLASS
 local PILL_EFFECT_CLASS_MAP = ____pillEffectClassMap.PILL_EFFECT_CLASS_MAP
 local ____pillEffectNameMap = require("maps.pillEffectNameMap")
+local DEFAULT_PILL_EFFECT_NAME = ____pillEffectNameMap.DEFAULT_PILL_EFFECT_NAME
 local PILL_EFFECT_NAME_MAP = ____pillEffectNameMap.PILL_EFFECT_NAME_MAP
 local ____pillEffectTypeMap = require("maps.pillEffectTypeMap")
+local DEFAULT_PILL_EFFECT_TYPE = ____pillEffectTypeMap.DEFAULT_PILL_EFFECT_TYPE
 local PILL_EFFECT_TYPE_MAP = ____pillEffectTypeMap.PILL_EFFECT_TYPE_MAP
-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)
     return itemConfig:GetPillEffects().Size - 1
 end
 function ____exports.getPillEffectClass(self, pillEffect)
-    local pillEffectClass = PILL_EFFECT_CLASS_MAP:get(pillEffect)
+    local pillEffectClass = PILL_EFFECT_CLASS_MAP[pillEffect]
     return pillEffectClass == nil and DEFAULT_PILL_EFFECT_CLASS or pillEffectClass
 end
 function ____exports.getPillEffectName(self, pillEffect)
-    local defaultName = "Unknown"
-    if type(pillEffect) ~= "number" then
-        return defaultName
-    end
-    local pillEffectName = PILL_EFFECT_NAME_MAP:get(pillEffect)
-    if pillEffectName ~= nil then
+    local pillEffectName = PILL_EFFECT_NAME_MAP[pillEffect]
+    if pillEffectName ~= nil and pillEffectName ~= DEFAULT_PILL_EFFECT_NAME then
         return pillEffectName
     end
     local itemConfigPillEffect = itemConfig:GetPillEffect(pillEffect)
-    if itemConfigPillEffect == nil then
-        return defaultName
+    if itemConfigPillEffect ~= nil then
+        return itemConfigPillEffect.Name
     end
-    return itemConfigPillEffect.Name
+    return DEFAULT_PILL_EFFECT_NAME
 end
 function ____exports.getPillEffectType(self, pillEffect)
-    local pillEffectClass = PILL_EFFECT_TYPE_MAP:get(pillEffect)
+    local pillEffectClass = PILL_EFFECT_TYPE_MAP[pillEffect]
     return pillEffectClass == nil and DEFAULT_PILL_EFFECT_TYPE or pillEffectClass
 end
 return ____exports

package/dist/functions/player.d.ts

@@ -72,6 +72,8 @@ export declare function getBlackHearts(player: EntityPlayer): int;
  * Mother's Kiss; use the `getPlayerMaxHeartContainers` helper function for that.
  */
 export declare function getCharacterMaxHeartContainers(character: PlayerType | int): int;
+/** Helper function to get the name of a character. Returns "unknown" for modded characters. */
+export declare function getCharacterName(character: PlayerType | int): string;
 /** Helper function to get an array containing the characters of all of the current players. */
 export declare function getCharacters(): PlayerType[];
 export declare function getClosestPlayer(position: Vector): EntityPlayer;