isaacscript-common 2.3.0 → 2.3.1

package/functions/trinketCacheFlag.lua

@@ -0,0 +1,50 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local Set = ____lualib.Set
+local __TS__Iterator = ____lualib.__TS__Iterator
+local ____exports = {}
+local initCacheFlagMap, CACHE_FLAG_TO_TRINKETS_MAP
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
+local ____enums = require("functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____set = require("functions.set")
+local copySet = ____set.copySet
+local ____trinkets = require("functions.trinkets")
+local getTrinketTypes = ____trinkets.getTrinketTypes
+local trinketHasCacheFlag = ____trinkets.trinketHasCacheFlag
+function initCacheFlagMap(self)
+    for ____, cacheFlag in ipairs(getEnumValues(nil, CacheFlag)) do
+        local trinketsSet = __TS__New(Set)
+        for ____, trinketType in ipairs(getTrinketTypes(nil)) do
+            if trinketHasCacheFlag(nil, trinketType, cacheFlag) then
+                trinketsSet:add(trinketType)
+            end
+        end
+        CACHE_FLAG_TO_TRINKETS_MAP:set(cacheFlag, trinketsSet)
+    end
+end
+function ____exports.getTrinketsForCacheFlag(self, cacheFlag)
+    if CACHE_FLAG_TO_TRINKETS_MAP.size == 0 then
+        initCacheFlagMap(nil)
+    end
+    local trinketsSet = CACHE_FLAG_TO_TRINKETS_MAP:get(cacheFlag)
+    if trinketsSet == nil then
+        return __TS__New(Set)
+    end
+    return copySet(nil, trinketsSet)
+end
+CACHE_FLAG_TO_TRINKETS_MAP = __TS__New(Map)
+function ____exports.getPlayerTrinketsForCacheFlag(self, player, cacheFlag)
+    local trinketsForCacheFlag = ____exports.getTrinketsForCacheFlag(nil, cacheFlag)
+    local playerTrinkets = __TS__New(Map)
+    for ____, trinketType in __TS__Iterator(trinketsForCacheFlag:values()) do
+        local trinketMultiplier = player:GetTrinketMultiplier(trinketType)
+        if trinketMultiplier > 0 then
+            playerTrinkets:set(trinketType, trinketMultiplier)
+        end
+    end
+    return playerTrinkets
+end
+return ____exports

package/functions/trinketGive.d.ts

@@ -0,0 +1,38 @@
+import { TrinketType } from "isaac-typescript-definitions";
+import { TrinketSituation } from "../interfaces/TrinketSituation";
+/**
+ * Helper function to restore the player's trinkets back to the way they were before the
+ * `temporarilyRemoveTrinket` function was used. It will re-smelt any smelted trinkets that were
+ * removed.
+ */
+export declare function giveTrinketsBack(player: EntityPlayer, trinketSituation: TrinketSituation | undefined): void;
+/**
+ * Helper function to smelt a trinket. Before smelting, this function will automatically remove the
+ * trinkets that the player is holding, if any, and then give them back after the new trinket is
+ * smelted.
+ *
+ * @param player The player to smelt the trinkets to.
+ * @param trinketType The trinket type to smelt.
+ * @param numTrinkets Optional. If specified, will smelt the given number of trinkets. Use this to
+ *                    avoid calling this function multiple times. Default is 1.
+ */
+export declare function smeltTrinket(player: EntityPlayer, trinketType: TrinketType, numTrinkets?: number): void;
+/**
+ * Helper function to temporarily remove a specific kind of trinket from the player. Use this in
+ * combination with the `giveTrinketsBack` function to take away and give back a trinket on the same
+ * frame. This function correctly handles multiple trinket slots and ensures that all copies of the
+ * trinket are removed, including smelted trinkets.
+ *
+ * Note that one smelted golden trinket is the same as two smelted normal trinkets.
+ *
+ * @returns Undefined if the player does not have the trinket, or TrinketSituation if they do.
+ */
+export declare function temporarilyRemoveTrinket(player: EntityPlayer, trinketType: TrinketType): TrinketSituation | undefined;
+/**
+ * Helper function to temporarily removes a player's held trinkets, if any. This will not remove any
+ * smelted trinkets. Use this in combination with the `giveTrinketsBack` function to take away and
+ * give back trinkets on the same frame.
+ *
+ * @returns Undefined if the player does not have any trinkets, or TrinketSituation if they do.
+ */
+export declare function temporarilyRemoveTrinkets(player: EntityPlayer): TrinketSituation | undefined;

package/functions/trinketGive.lua

@@ -0,0 +1,90 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____player = require("functions.player")
+local useActiveItemTemp = ____player.useActiveItemTemp
+local ____trinkets = require("functions.trinkets")
+local getGoldenTrinketType = ____trinkets.getGoldenTrinketType
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+function ____exports.temporarilyRemoveTrinkets(self, player)
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    if trinketType1 == TrinketType.NULL and trinketType2 == TrinketType.NULL then
+        return nil
+    end
+    if trinketType1 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType1)
+    end
+    if trinketType2 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType2)
+    end
+    return {trinketTypeRemoved = TrinketType.NULL, trinketType1 = trinketType1, trinketType2 = trinketType2, numSmeltedTrinkets = 0}
+end
+function ____exports.giveTrinketsBack(self, player, trinketSituation)
+    if trinketSituation == nil then
+        return
+    end
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    if trinketType1 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType1)
+    end
+    if trinketType2 ~= TrinketType.NULL then
+        player:TryRemoveTrinket(trinketType2)
+    end
+    ____repeat(
+        nil,
+        trinketSituation.numSmeltedTrinkets,
+        function()
+            player:AddTrinket(trinketSituation.trinketTypeRemoved, false)
+            useActiveItemTemp(nil, player, CollectibleType.SMELTER)
+        end
+    )
+    if trinketSituation.trinketType1 ~= TrinketType.NULL then
+        player:AddTrinket(trinketSituation.trinketType1, false)
+    end
+    if trinketSituation.trinketType2 ~= TrinketType.NULL then
+        player:AddTrinket(trinketSituation.trinketType2, false)
+    end
+end
+function ____exports.smeltTrinket(self, player, trinketType, numTrinkets)
+    if numTrinkets == nil then
+        numTrinkets = 1
+    end
+    local trinketSituation = ____exports.temporarilyRemoveTrinkets(nil, player)
+    ____repeat(
+        nil,
+        numTrinkets,
+        function()
+            player:AddTrinket(trinketType)
+            useActiveItemTemp(nil, player, CollectibleType.SMELTER)
+        end
+    )
+    ____exports.giveTrinketsBack(nil, player, trinketSituation)
+end
+function ____exports.temporarilyRemoveTrinket(self, player, trinketType)
+    if not player:HasTrinket(trinketType) then
+        return nil
+    end
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    local numTrinkets = 0
+    while player:HasTrinket(trinketType) do
+        player:TryRemoveTrinket(trinketType)
+        numTrinkets = numTrinkets + 1
+    end
+    local numSmeltedTrinkets = numTrinkets
+    local trinketWasInSlot1 = trinketType1 == trinketType or trinketType1 == getGoldenTrinketType(nil, trinketType)
+    if trinketWasInSlot1 then
+        numSmeltedTrinkets = numSmeltedTrinkets - 1
+    end
+    local trinketWasInSlot2 = trinketType2 == trinketType or trinketType2 == getGoldenTrinketType(nil, trinketType)
+    if trinketWasInSlot2 then
+        numSmeltedTrinkets = numSmeltedTrinkets - 1
+    end
+    return {trinketTypeRemoved = trinketType, trinketType1 = trinketType1, trinketType2 = trinketType2, numSmeltedTrinkets = numSmeltedTrinkets}
+end
+return ____exports

package/functions/trinkets.d.ts

@@ -0,0 +1,73 @@
+import { CacheFlag, TrinketType } from "isaac-typescript-definitions";
+/**
+ * Helper function to get the corresponding golden trinket type from a normal trinket type.
+ *
+ * For example, passing `TrinketType.SWALLOWED_PENNY` would result in 32769, which is the value that
+ * corresponds to the golden trinket sub-type for Swallowed Penny.
+ */
+export declare function getGoldenTrinketType(trinketType: TrinketType): TrinketType;
+/**
+ * Helper function to get an array that represents every modded trinket type.
+ *
+ * Returns an empty array if there are no modded trinket types.
+ */
+export declare function getModdedTrinketTypes(): TrinketType[];
+/**
+ * Returns the slot number corresponding to where a trinket can be safely inserted.
+ *
+ * For example:
+ *
+ * ```ts
+ * const player = Isaac.GetPlayer();
+ * const trinketSlot = getOpenTrinketSlotNum(player);
+ * if (trinketSlot !== undefined) {
+ *   // They have one or more open trinket slots
+ *   player.AddTrinket(TrinketType.SWALLOWED_PENNY);
+ * }
+ * ```
+ */
+export declare function getOpenTrinketSlot(player: EntityPlayer): int | undefined;
+/**
+ * Helper function to get the in-game description for a trinket. Returns "Unknown" if the provided
+ * trinket type was not valid.
+ */
+export declare function getTrinketDescription(trinketType: TrinketType): string;
+/**
+ * Helper function to get the name of a trinket. Returns "Unknown" if the provided trinket type is
+ * not valid.
+ *
+ * For example:
+ *
+ * ```ts
+ * const trinketType = TrinketType.SWALLOWED_PENNY;
+ * const trinketName = getTrinketName(trinketType); // trinketName is "Swallowed Penny"
+ * ```
+ */
+export declare function getTrinketName(trinketType: TrinketType): string;
+/** Helper function to get an array that contains every trinket type. */
+export declare function getTrinketTypes(): TrinketType[];
+/** Helper function to get an array that represents every vanilla trinket type. */
+export declare function getVanillaTrinketTypes(): TrinketType[];
+/**
+ * Returns whether or not the player can hold an additional trinket, beyond what they are currently
+ * carrying. This takes into account items that modify the max number of trinkets, like Mom's Purse.
+ *
+ * If the player is the Tainted Soul, this always returns false, since that character cannot pick up
+ * items. (Only Tainted Forgotten can pick up items.)
+ */
+export declare function hasOpenTrinketSlot(player: EntityPlayer): boolean;
+export declare function isGoldenTrinket(trinketType: TrinketType): boolean;
+/**
+ * Helper function to change the sprite of a trinket entity.
+ *
+ * For more information about removing the trinket sprite, see the documentation for the
+ * "clearSprite" helper function.
+ *
+ * @param trinket The trinket whose sprite you want to modify.
+ * @param pngPath Equal to either the spritesheet path to load (e.g.
+ *                "gfx/items/trinkets/trinket_001_swallowedpenny.png") or undefined. If undefined,
+ *                the sprite will be removed, making it appear like the collectible has already been
+ *                taken by the player.
+ */
+export declare function setTrinketSprite(trinket: EntityPickup, pngPath: string | undefined): void;
+export declare function trinketHasCacheFlag(trinketType: TrinketType, cacheFlag: CacheFlag): boolean;

package/functions/trinkets.lua

@@ -0,0 +1,115 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local TrinketSlot = ____isaac_2Dtypescript_2Ddefinitions.TrinketSlot
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____cachedClasses = require("cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____constantsFirstLast = require("constantsFirstLast")
+local FIRST_MODDED_TRINKET_TYPE = ____constantsFirstLast.FIRST_MODDED_TRINKET_TYPE
+local FIRST_TRINKET_TYPE = ____constantsFirstLast.FIRST_TRINKET_TYPE
+local LAST_TRINKET_TYPE = ____constantsFirstLast.LAST_TRINKET_TYPE
+local LAST_VANILLA_TRINKET_TYPE = ____constantsFirstLast.LAST_VANILLA_TRINKET_TYPE
+local ____trinketDescriptionMap = require("maps.trinketDescriptionMap")
+local DEFAULT_TRINKET_DESCRIPTION = ____trinketDescriptionMap.DEFAULT_TRINKET_DESCRIPTION
+local TRINKET_DESCRIPTION_MAP = ____trinketDescriptionMap.TRINKET_DESCRIPTION_MAP
+local ____trinketNameMap = require("maps.trinketNameMap")
+local DEFAULT_TRINKET_NAME = ____trinketNameMap.DEFAULT_TRINKET_NAME
+local TRINKET_NAME_MAP = ____trinketNameMap.TRINKET_NAME_MAP
+local ____entity = require("functions.entity")
+local getEntityID = ____entity.getEntityID
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____pickupVariants = require("functions.pickupVariants")
+local isTrinket = ____pickupVariants.isTrinket
+local ____player = require("functions.player")
+local isCharacter = ____player.isCharacter
+local ____sprite = require("functions.sprite")
+local clearSprite = ____sprite.clearSprite
+local ____utils = require("functions.utils")
+local irange = ____utils.irange
+local GOLDEN_TRINKET_ADJUSTMENT = 32768
+local TRINKET_SPRITE_LAYER = 0
+function ____exports.getGoldenTrinketType(self, trinketType)
+    return trinketType + GOLDEN_TRINKET_ADJUSTMENT
+end
+function ____exports.getModdedTrinketTypes(self)
+    if LAST_VANILLA_TRINKET_TYPE == LAST_TRINKET_TYPE then
+        return {}
+    end
+    return irange(nil, FIRST_MODDED_TRINKET_TYPE, LAST_TRINKET_TYPE)
+end
+function ____exports.getOpenTrinketSlot(self, player)
+    local maxTrinkets = player:GetMaxTrinkets()
+    local trinketType1 = player:GetTrinket(TrinketSlot.SLOT_1)
+    local trinketType2 = player:GetTrinket(TrinketSlot.SLOT_2)
+    if maxTrinkets == 1 then
+        return trinketType1 == TrinketType.NULL and 0 or nil
+    end
+    if maxTrinkets == 2 then
+        if trinketType1 == TrinketType.NULL then
+            return 0
+        end
+        return trinketType2 == TrinketType.NULL and 1 or nil
+    end
+    return error("The player has an unknown number of trinket slots: " .. tostring(maxTrinkets))
+end
+function ____exports.getTrinketDescription(self, trinketType)
+    local trinketDescription = TRINKET_DESCRIPTION_MAP:get(trinketType)
+    if trinketDescription ~= nil then
+        return trinketDescription
+    end
+    local itemConfigItem = itemConfig:GetTrinket(trinketType)
+    if itemConfigItem ~= nil then
+        return itemConfigItem.Description
+    end
+    return DEFAULT_TRINKET_DESCRIPTION
+end
+function ____exports.getTrinketName(self, trinketType)
+    local trinketName = TRINKET_NAME_MAP:get(trinketType)
+    if trinketName ~= nil then
+        return trinketName
+    end
+    local itemConfigItem = itemConfig:GetTrinket(trinketType)
+    if itemConfigItem ~= nil then
+        return itemConfigItem.Name
+    end
+    return DEFAULT_TRINKET_NAME
+end
+function ____exports.getTrinketTypes(self)
+    return irange(nil, FIRST_TRINKET_TYPE, LAST_TRINKET_TYPE)
+end
+function ____exports.getVanillaTrinketTypes(self)
+    return irange(nil, FIRST_TRINKET_TYPE, LAST_VANILLA_TRINKET_TYPE)
+end
+function ____exports.hasOpenTrinketSlot(self, player)
+    if isCharacter(nil, player, PlayerType.THE_SOUL_B) then
+        return false
+    end
+    local openTrinketSlot = ____exports.getOpenTrinketSlot(nil, player)
+    return openTrinketSlot ~= nil
+end
+function ____exports.isGoldenTrinket(self, trinketType)
+    return trinketType > GOLDEN_TRINKET_ADJUSTMENT
+end
+function ____exports.setTrinketSprite(self, trinket, pngPath)
+    if not isTrinket(nil, trinket) then
+        local entityID = getEntityID(nil, trinket)
+        error("The \"setTrinketSprite\" function was given a non-trinket: " .. entityID)
+    end
+    local sprite = trinket:GetSprite()
+    if pngPath == nil then
+        clearSprite(nil, sprite, TRINKET_SPRITE_LAYER)
+    else
+        sprite:ReplaceSpritesheet(TRINKET_SPRITE_LAYER, pngPath)
+        sprite:LoadGraphics()
+    end
+end
+function ____exports.trinketHasCacheFlag(self, trinketType, cacheFlag)
+    local itemConfigItem = itemConfig:GetTrinket(trinketType)
+    if itemConfigItem == nil then
+        return false
+    end
+    return hasFlag(nil, itemConfigItem.CacheFlags, cacheFlag)
+end
+return ____exports

package/functions/tstlClass.d.ts

@@ -0,0 +1,20 @@
+import { TSTLClass } from "../types/private/TSTLClass";
+/**
+ * Returns whether or not this is a class that is provided by the `isaacscript-common` library, such
+ * as a `DefaultMap`.
+ */
+export declare function isIsaacScriptCommonClass(object: unknown): boolean;
+/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
+export declare function isUserDefinedTSTLClass(object: unknown): object is TSTLClass;
+/**
+ * Returns whether or not this is a class that is provided as part of the TypeScriptToLua
+ * transpiler, such as a `Map` or a `Set`.
+ */
+export declare function isVanillaTSTLClass(object: unknown): boolean;
+/**
+ * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
+ * it is. This function requires that you provide an instantiated class of the same type, as it will
+ * use the class constructor that is present on the other object's metatable to initialize the new
+ * class.
+ */
+export declare function newTSTLClass(oldClass: TSTLClass): TSTLClass;

package/functions/tstlClass.lua

@@ -0,0 +1,56 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__InstanceOf = ____lualib.__TS__InstanceOf
+local Map = ____lualib.Map
+local WeakMap = ____lualib.WeakMap
+local WeakSet = ____lualib.WeakSet
+local ____exports = {}
+local newTSTLClassFromMetatable
+local ____DefaultMap = require("classes.DefaultMap")
+local DefaultMap = ____DefaultMap.DefaultMap
+function ____exports.isVanillaTSTLClass(self, object)
+    return __TS__InstanceOf(object, Map) or __TS__InstanceOf(object, Set) or __TS__InstanceOf(object, WeakMap) or __TS__InstanceOf(object, WeakSet)
+end
+function newTSTLClassFromMetatable(self, metatable)
+    local newClass = {}
+    local newClassMetatable = setmetatable(newClass, metatable.constructor.prototype)
+    newClassMetatable:____constructor()
+    return newClass
+end
+local TSTL_CLASS_METATABLE_KEYS = __TS__New(Set, {"____constructor", "__index", "constructor"})
+function ____exports.isIsaacScriptCommonClass(self, object)
+    return __TS__InstanceOf(object, DefaultMap)
+end
+function ____exports.isUserDefinedTSTLClass(self, object)
+    if ____exports.isVanillaTSTLClass(nil, object) or ____exports.isIsaacScriptCommonClass(nil, object) then
+        return false
+    end
+    local objectType = type(object)
+    if objectType ~= "table" then
+        return false
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return false
+    end
+    local numKeys = 0
+    for key in pairs(metatable) do
+        numKeys = numKeys + 1
+        if type(key) ~= "string" then
+            return false
+        end
+        if not TSTL_CLASS_METATABLE_KEYS:has(key) then
+            return false
+        end
+    end
+    return numKeys == TSTL_CLASS_METATABLE_KEYS.size
+end
+function ____exports.newTSTLClass(self, oldClass)
+    local metatable = getmetatable(oldClass)
+    if metatable == nil then
+        error("Failed to instantiate a new TypeScriptToLua class since the provided old class does not have a metatable.")
+    end
+    return newTSTLClassFromMetatable(nil, metatable)
+end
+return ____exports

package/functions/ui.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="isaac-typescript-definitions" />
+/**
+ * In the options menu, players have the ability to set a HUD offset. However, mods do not have
+ * access to this value. To get around this, Mod Config Menu provides a separate HUD offset setting
+ * on the first page of the menu. This is intended to be set by end-users to match their vanilla HUD
+ * offset setting so that mods can render UI elements to the screen in the correct position.
+ *
+ * @returns If the user does not have Mod Config Menu enabled, or does not have this option set,
+ *          then this function will return `Vector.Zero.` Otherwise, it will return a Vector that
+ *          represents a HUD offset that should be added to the position of a UI element.
+ */
+export declare function getHUDOffsetVector(): Vector;
+/**
+ * Returns how many hearts are in the heart UI row. If the player has more than 6 hearts, this
+ * function will return 6.
+ */
+export declare function getHeartRowLength(player: EntityPlayer): int;
+/**
+ * Helper function to get the width of the first player's hearts on the UI. This is useful for
+ * drawing UI elements to the right of where the player's hearts are. Make sure to use this in
+ * combination with the the `getHUDOffsetVector` helper function.
+ */
+export declare function getHeartsUIWidth(): int;
+export declare function getScreenBottomLeftPos(): Vector;
+export declare function getScreenBottomRightPos(): Vector;
+export declare function getScreenCenterPos(): Vector;
+export declare function getScreenTopLeftPos(): Vector;
+export declare function getScreenTopRightPos(): Vector;
+/**
+ * Get how many hearts are currently being shown on the hearts UI.
+ *
+ * This function is originally from piber20 Helper.
+ */
+export declare function getVisibleHearts(player: EntityPlayer): int;

package/functions/ui.lua

@@ -0,0 +1,95 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("constants")
+local UI_HEART_WIDTH = ____constants.UI_HEART_WIDTH
+local VectorZero = ____constants.VectorZero
+local ____vector = require("functions.vector")
+local copyVector = ____vector.copyVector
+function ____exports.getScreenBottomRightPos(self)
+    local screenWidth = Isaac.GetScreenWidth()
+    local screenHeight = Isaac.GetScreenHeight()
+    return Vector(screenWidth, screenHeight)
+end
+function ____exports.getHUDOffsetVector(self)
+    local defaultVector = copyVector(nil, VectorZero)
+    local hudOffset = math.floor(Options.HUDOffset * 10)
+    if hudOffset < 1 or hudOffset > 10 then
+        return defaultVector
+    end
+    local x = hudOffset * 2
+    local y = hudOffset
+    if y >= 4 then
+        y = y + 1
+    end
+    if y >= 9 then
+        y = y + 1
+    end
+    return Vector(x, y)
+end
+function ____exports.getHeartRowLength(self, player)
+    local maxHearts = player:GetMaxHearts()
+    local soulHearts = player:GetSoulHearts()
+    local boneHearts = player:GetBoneHearts()
+    local combinedHearts = maxHearts + soulHearts + boneHearts * 2
+    local heartRowLength = combinedHearts / 2
+    return math.min(heartRowLength, 6)
+end
+function ____exports.getHeartsUIWidth(self)
+    local level = game:GetLevel()
+    local curses = level:GetCurses()
+    local player = Isaac.GetPlayer()
+    local extraLives = player:GetExtraLives()
+    local effects = player:GetEffects()
+    local hasHolyMantleEffect = effects:HasCollectibleEffect(CollectibleType.HOLY_MANTLE)
+    local heartRowLength = ____exports.getHeartRowLength(nil, player)
+    if hasHolyMantleEffect then
+        heartRowLength = heartRowLength + 1
+    end
+    if curses == LevelCurse.UNKNOWN then
+        heartRowLength = 1
+    end
+    local width = heartRowLength * UI_HEART_WIDTH
+    if extraLives > 9 then
+        width = width + 20
+        if player:HasCollectible(CollectibleType.GUPPYS_COLLAR) then
+            width = width + 6
+        end
+    elseif extraLives > 0 then
+        width = width + 16
+        if player:HasCollectible(CollectibleType.GUPPYS_COLLAR) then
+            width = width + 4
+        end
+    end
+    return width
+end
+function ____exports.getScreenBottomLeftPos(self)
+    local bottomRight = ____exports.getScreenBottomRightPos(nil)
+    return Vector(0, bottomRight.Y)
+end
+function ____exports.getScreenCenterPos(self)
+    local bottomRight = ____exports.getScreenBottomRightPos(nil)
+    return bottomRight / 2
+end
+function ____exports.getScreenTopLeftPos(self)
+    return copyVector(nil, VectorZero)
+end
+function ____exports.getScreenTopRightPos(self)
+    local bottomRight = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRight.X, 0)
+end
+function ____exports.getVisibleHearts(self, player)
+    local effectiveMaxHearts = player:GetEffectiveMaxHearts()
+    local soulHearts = player:GetSoulHearts()
+    local boneHearts = player:GetBoneHearts()
+    local maxHearts = math.max(effectiveMaxHearts, boneHearts * 2)
+    local visibleHearts = math.ceil((maxHearts + soulHearts) / 2)
+    if visibleHearts < 1 then
+        visibleHearts = 1
+    end
+    return visibleHearts
+end
+return ____exports