isaacscript-common 6.3.0 → 6.4.0

package/features/saveDataManager/save.lua

@@ -13,9 +13,9 @@ local ____log = require("functions.log")
 local log = ____log.log
 local ____table = require("functions.table")
 local iterateTableInOrder = ____table.iterateTableInOrder
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
 function getAllSaveDataToWriteToDisk(self, saveDataMap, saveDataConditionalFuncMap)
     local allSaveData = {}
     iterateTableInOrder(

package/functions/color.d.ts

@@ -19,8 +19,6 @@ export declare function colorEquals(color1: Color, color2: Color): boolean;
  */
 export declare function copyColor<C extends Color | SerializedColor, S extends SerializationType>(color: C, serializationType: S): CopyColorReturn[S];
 export declare function copyColor<C extends Color | SerializedColor>(color: C): CopyColorReturn[SerializationType.NONE];
-/** Returns `Color(1, 1, 1)`. */
-export declare function getDefaultColor(): Color;
 /** Helper function to check if something is an instantiated Color object. */
 export declare function isColor(object: unknown): object is Color;
 /**

package/functions/color.lua

@@ -104,10 +104,6 @@ function ____exports.copyColor(self, color, serializationType)
         end
     until true
 end
---- Returns `Color(1, 1, 1)`.
-function ____exports.getDefaultColor(self)
-    return Color(1, 1, 1)
-end
 --- Used to determine is the given table is a serialized `Color` object created by the save data
 -- manager and/or the `deepCopy` function.
 function ____exports.isSerializedColor(self, object)

package/functions/deepCopy.lua

@@ -15,8 +15,8 @@ local ____SerializationBrand = require("enums.private.SerializationBrand")
 local SerializationBrand = ____SerializationBrand.SerializationBrand
 local ____SerializationType = require("enums.SerializationType")
 local SerializationType = ____SerializationType.SerializationType
-local ____constants = require("features.saveDataManager.constants")
-local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
 local ____serializationBrand = require("features.saveDataManager.serializationBrand")
 local isSerializationBrand = ____serializationBrand.isSerializationBrand
 local ____array = require("functions.array")

package/functions/entity.d.ts

@@ -72,6 +72,11 @@ export declare function getEntities(entityType?: EntityType, variant?: number, s
 export declare function getEntityFields(entity: Entity): LuaTable<string, boolean | number | string>;
 /** Helper function to return a string containing the entity's type, variant, and sub-type. */
 export declare function getEntityID(entity: Entity): string;
+/**
+ * Helper function to return a formatted string in the format returned by the `getEntityID`
+ * function.
+ */
+export declare function getEntityIDFromConstituents(entityType: EntityType, variant: int, subType: int): string;
 /**
  * Helper function to compare two different arrays of entities. Returns the entities that are in the
  * second array but not in the first array.

package/functions/entity.lua

@@ -202,6 +202,11 @@ end
 function ____exports.getEntityID(self, entity)
     return (((tostring(entity.Type) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType)
 end
+--- Helper function to return a formatted string in the format returned by the `getEntityID`
+-- function.
+function ____exports.getEntityIDFromConstituents(self, entityType, variant, subType)
+    return (((tostring(entityType) .. ".") .. tostring(variant)) .. ".") .. tostring(subType)
+end
 --- Helper function to compare two different arrays of entities. Returns the entities that are in the
 -- second array but not in the first array.
 function ____exports.getFilteredNewEntities(self, oldEntities, newEntities)
@@ -349,6 +354,14 @@ function ____exports.spawn(self, entityType, variant, subType, position, velocit
     if seedOrRNG == nil then
         seedOrRNG = nil
     end
+    if position == nil then
+        local entityID = ____exports.getEntityIDFromConstituents(nil, entityType, variant, subType)
+        error(("Failed to spawn entity " .. entityID) .. " since an undefined position was passed to the \"spawn\" function.")
+    end
+    if velocity == nil then
+        local entityID = ____exports.getEntityIDFromConstituents(nil, entityType, variant, subType)
+        error(("Failed to spawn entity " .. entityID) .. " since an undefined velocity was passed to the \"spawn\" function.")
+    end
     if seedOrRNG == nil then
         return Isaac.Spawn(
             entityType,

package/functions/gridEntity.d.ts

@@ -61,6 +61,11 @@ export declare function getGridEntitiesExcept(...gridEntityTypes: GridEntityType
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
 /** Helper function to return a string containing the grid entity's type and variant. */
 export declare function getGridEntityID(gridEntity: GridEntity): string;
+/**
+ * Helper function to return a formatted string in the format returned by the `getGridEntityID`
+ * function.
+ */
+export declare function getGridEntityIDFromConstituents(gridEntityType: GridEntityType, variant: int): string;
 /**
  * Helper function to get all of the grid entities in the room that specifically match the type and
  * variant provided.

package/functions/gridEntity.lua

@@ -238,8 +238,13 @@ end
 --- Helper function to return a string containing the grid entity's type and variant.
 function ____exports.getGridEntityID(self, gridEntity)
     local gridEntityType = gridEntity:GetType()
-    local gridEntityVariant = gridEntity:GetVariant()
-    return (tostring(gridEntityType) .. ".") .. tostring(gridEntityVariant)
+    local variant = gridEntity:GetVariant()
+    return (tostring(gridEntityType) .. ".") .. tostring(variant)
+end
+--- Helper function to return a formatted string in the format returned by the `getGridEntityID`
+-- function.
+function ____exports.getGridEntityIDFromConstituents(self, gridEntityType, variant)
+    return (tostring(gridEntityType) .. ".") .. tostring(variant)
 end
 --- Helper function to get all of the grid entities in the room that specifically match the type and
 -- variant provided.

package/functions/kColor.d.ts

@@ -18,8 +18,6 @@ interface CopyKColorReturn {
  */
 export declare function copyKColor<K extends KColor | SerializedKColor, S extends SerializationType>(kColor: K, serializationType: S): CopyKColorReturn[S];
 export declare function copyKColor<K extends KColor | SerializedKColor>(kColor: K): CopyKColorReturn[SerializationType.NONE];
-/** Returns `KColor(1, 1, 1, 1)`. */
-export declare function getDefaultKColor(): KColor;
 /** Helper function to check if something is an instantiated KColor object. */
 export declare function isKColor(object: unknown): object is KColor;
 /**

package/functions/kColor.lua

@@ -80,10 +80,6 @@ function ____exports.copyKColor(self, kColor, serializationType)
         end
     until true
 end
---- Returns `KColor(1, 1, 1, 1)`.
-function ____exports.getDefaultKColor(self)
-    return KColor(1, 1, 1, 1)
-end
 --- Used to determine is the given table is a serialized `KColor` object created by the save data
 -- manager and/or the `deepCopy` function.
 function ____exports.isSerializedKColor(self, object)

package/functions/log.lua

@@ -247,7 +247,8 @@ function ____exports.logEntityFlags(flags)
     ____exports.logFlags(flags, EntityFlag, "entity")
 end
 function ____exports.logEntityID(entity)
-    ____exports.log((((("Entity: " .. tostring(entity.Type)) .. ".") .. tostring(entity.Variant)) .. ".") .. tostring(entity.SubType))
+    local entityID = getEntityID(nil, entity)
+    ____exports.log("Entity: " .. entityID)
 end
 --- Helper function to log an error message and also print it to the console for better visibility.
 -- 

package/functions/ui.d.ts

@@ -23,9 +23,11 @@ export declare function getHeartRowLength(player: EntityPlayer): int;
  * combination with the the `getHUDOffsetVector` helper function.
  */
 export declare function getHeartsUIWidth(): int;
+export declare function getScreenBottomCenterPos(): Vector;
 export declare function getScreenBottomLeftPos(): Vector;
 export declare function getScreenBottomRightPos(): Vector;
 export declare function getScreenCenterPos(): Vector;
+export declare function getScreenTopCenterPos(): Vector;
 export declare function getScreenTopLeftPos(): Vector;
 export declare function getScreenTopRightPos(): Vector;
 /**

package/functions/ui.lua

@@ -79,6 +79,10 @@ function ____exports.getHeartsUIWidth(self)
     end
     return width
 end
+function ____exports.getScreenBottomCenterPos(self)
+    local bottomRight = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRight.X / 2, bottomRight.Y)
+end
 function ____exports.getScreenBottomLeftPos(self)
     local bottomRight = ____exports.getScreenBottomRightPos(nil)
     return Vector(0, bottomRight.Y)
@@ -87,6 +91,10 @@ function ____exports.getScreenCenterPos(self)
     local bottomRight = ____exports.getScreenBottomRightPos(nil)
     return bottomRight / 2
 end
+function ____exports.getScreenTopCenterPos(self)
+    local bottomRight = ____exports.getScreenBottomRightPos(nil)
+    return Vector(bottomRight.X / 2, 0)
+end
 function ____exports.getScreenTopLeftPos(self)
     return copyVector(nil, VectorZero)
 end

package/functions/utils.d.ts

@@ -4,9 +4,10 @@
  * Helper function to return an array with the elements from start to end. It is inclusive at the
  * start and exclusive at the end. (The "e" stands for exclusive.)
  *
- * For example, `erange(1, 3)` will return `[1, 2]`.
- *
  * If only one argument is specified, then it will assume that the start is 0.
+ *
+ * - For example, `erange(1, 3)` will return `[1, 2]`.
+ * - For example, `erange(2)` will return `[0, 1]`.
  */
 export declare function erange(start: int, end?: int): int[];
 /**
@@ -24,9 +25,10 @@ export declare function hexToKColor(hexString: string, alpha: float): KColor;
  * Helper function to return an array with the elements from start to end, inclusive. (The "i"
  * stands for inclusive.)
  *
- * For example, `irange(1, 3)` will return `[1, 2, 3]`.
- *
  * If only one argument is specified, then it will assume that the start is 0.
+ *
+ * - For example, `irange(1, 3)` will return `[1, 2, 3]`.
+ * - For example, `irange(2)` will return `[0, 1, 2]`.
  */
 export declare function irange(start: int, end?: int): int[];
 /**

package/functions/utils.lua

@@ -12,9 +12,10 @@ local HEX_STRING_LENGTH = 6
 --- Helper function to return an array with the elements from start to end. It is inclusive at the
 -- start and exclusive at the end. (The "e" stands for exclusive.)
 -- 
--- For example, `erange(1, 3)` will return `[1, 2]`.
--- 
 -- If only one argument is specified, then it will assume that the start is 0.
+-- 
+-- - For example, `erange(1, 3)` will return `[1, 2]`.
+-- - For example, `erange(2)` will return `[0, 1]`.
 function ____exports.erange(self, start, ____end)
     if ____end == nil then
         ____end = start
@@ -68,9 +69,10 @@ end
 --- Helper function to return an array with the elements from start to end, inclusive. (The "i"
 -- stands for inclusive.)
 -- 
--- For example, `irange(1, 3)` will return `[1, 2, 3]`.
--- 
 -- If only one argument is specified, then it will assume that the start is 0.
+-- 
+-- - For example, `irange(1, 3)` will return `[1, 2, 3]`.
+-- - For example, `irange(2)` will return `[0, 1, 2]`.
 function ____exports.irange(self, start, ____end)
     if ____end == nil then
         ____end = start

package/interfaces/CustomStageLua.d.ts

@@ -39,6 +39,31 @@ export interface CustomStageTSConfig {
      * the walls and floor.) Mandatory.
      */
     readonly backdrop: CustomStageBackdrop;
+    /**
+     * Optional. An object representing the color to use for the background of the boss "versus"
+     * screen. If not specified, the color for Basement 1 will be used.
+     *
+     * For a list of the colors that correspond to the vanilla stages, see
+     * `versusScreenBackgroundColors.ts`.
+     */
+    readonly versusScreenBackgroundColor?: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    /**
+     * Optional. An object representing the color to use for the dirt spots in the boss "versus"
+     * screen. (There are two dirt spots; one for the player and one for the boss.) If not specified,
+     * the color for Basement 1 will be used.
+     *
+     * For a list of the colors that correspond to the vanilla stages, see
+     * `versusScreenDirtSpotColors.ts`.
+     */
+    readonly versusScreenDirtSpotColor?: {
+        r: number;
+        g: number;
+        b: number;
+    };
 }
 interface CustomStageBackdrop {
     /**

package/objects/bossNamePNGFileNames.d.ts

@@ -0,0 +1,5 @@
+import { BossID } from "isaac-typescript-definitions";
+/** Used when rendering the "versusscreen.anm2" sprite. */
+export declare const BOSS_NAME_PNG_FILE_NAMES: {
+    readonly [key in BossID]: string;
+};

package/objects/bossNamePNGFileNames.lua

@@ -0,0 +1,108 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
+--- Used when rendering the "versusscreen.anm2" sprite.
+____exports.BOSS_NAME_PNG_FILE_NAMES = {
+    [BossID.MONSTRO] = "bossname_20.0_monstro.png",
+    [BossID.LARRY_JR] = "bossname_19.0_larryjr.png",
+    [BossID.CHUB] = "bossname_28.0_chub.png",
+    [BossID.GURDY] = "bossname_36.0_gurdy.png",
+    [BossID.MONSTRO_II] = "bossname_43.0_monstro2.png",
+    [BossID.MOM] = "bossname_45.0_mom.png",
+    [BossID.SCOLEX] = "bossname_62.1_scolex.png",
+    [BossID.MOMS_HEART] = "bossname_78.0_momsheart.png",
+    [BossID.FAMINE] = "bossname_63.0_famine.png",
+    [BossID.PESTILENCE] = "bossname_64.0_pestilence.png",
+    [BossID.WAR] = "bossname_65.0_war.png",
+    [BossID.DEATH] = "bossname_66.0_death.png",
+    [BossID.DUKE_OF_FLIES] = "bossname_67.0_dukeofflies.png",
+    [BossID.PEEP] = "bossname_68.0_peep.png",
+    [BossID.LOKI] = "bossname_69.0_loki.png",
+    [BossID.BLASTOCYST] = "bossname_74.0_blastocyst.png",
+    [BossID.GEMINI] = "bossname_79.0_gemini.png",
+    [BossID.FISTULA] = "bossname_71.0_fistula.png",
+    [BossID.GISH] = "bossname_43.1_gish.png",
+    [BossID.STEVEN] = "bossname_79.1_steven.png",
+    [BossID.CHAD] = "bossname_28.1_chad.png",
+    [BossID.HEADLESS_HORSEMAN] = "bossname_82.0_headlesshorseman.png",
+    [BossID.THE_FALLEN] = "bossname_81.0_thefallen.png",
+    [BossID.SATAN] = "bossname_84.0_satan.png",
+    [BossID.IT_LIVES] = "bossname_78.1_itlives.png",
+    [BossID.THE_HOLLOW] = "bossname_19.1_thehollow.png",
+    [BossID.THE_CARRION_QUEEN] = "bossname_28.2_carrionqueen.png",
+    [BossID.GURDY_JR] = "bossname_99.0_gurdyjr.png",
+    [BossID.THE_HUSK] = "bossname_67.1_thehusk.png",
+    [BossID.THE_BLOAT] = "bossname_68.1_bloat.png",
+    [BossID.LOKII] = "bossname_69.1_lokii.png",
+    [BossID.THE_BLIGHTED_OVUM] = "bossname_79.2_blightedovum.png",
+    [BossID.TERATOMA] = "bossname_71.1_teratoma.png",
+    [BossID.THE_WIDOW] = "bossname_100.0_widow.png",
+    [BossID.MASK_OF_INFAMY] = "bossname_97.0_maskofinfamy.png",
+    [BossID.THE_WRETCHED] = "bossname_100.1_thewretched.png",
+    [BossID.PIN] = "bossname_62.0_pin.png",
+    [BossID.CONQUEST] = "bossname_65.1_conquest.png",
+    [BossID.ISAAC] = "playername_01_isaac.png",
+    [BossID.BLUE_BABY] = "bossname_102.1_bluebaby.png",
+    [BossID.DADDY_LONG_LEGS] = "bossname_101.0_daddylonglegs.png",
+    [BossID.TRIACHNID] = "bossname_101.1_triachnid.png",
+    [BossID.THE_HAUNT] = "bossname_260.0_thehaunt.png",
+    [BossID.DINGLE] = "bossname_261.0_dingle.png",
+    [BossID.MEGA_MAW] = "bossname_262.0_megamaw.png",
+    [BossID.THE_GATE] = "bossname_263.0_megamaw2.png",
+    [BossID.MEGA_FATTY] = "bossname_264.0_megafatty.png",
+    [BossID.THE_CAGE] = "bossname_265.0_fatty2.png",
+    [BossID.MAMA_GURDY] = "bossname_266.0_mamagurdy.png",
+    [BossID.DARK_ONE] = "bossname_267.0_darkone.png",
+    [BossID.THE_ADVERSARY] = "bossname_268.0_darkone2.png",
+    [BossID.POLYCEPHALUS] = "bossname_269.0_polycephalus.png",
+    [BossID.MR_FRED] = "bossname_270.0_megafred.png",
+    [BossID.THE_LAMB] = "bossname_273.0_thelamb.png",
+    [BossID.MEGA_SATAN] = "bossname_274.0_megasatan.png",
+    [BossID.GURGLINGS] = "bossname_276.0_gurglings.png",
+    [BossID.THE_STAIN] = "bossname_401.0_thestain.png",
+    [BossID.BROWNIE] = "bossname_402.0_brownie.png",
+    [BossID.THE_FORSAKEN] = "bossname_403.0_theforsaken.png",
+    [BossID.LITTLE_HORN] = "bossname_404.0_littlehorn.png",
+    [BossID.RAG_MAN] = "bossname_405.0_ragman.png",
+    [BossID.ULTRA_GREED] = "bossname_406.0_ultragreed.png",
+    [BossID.HUSH] = "bossname_407.0_hush.png",
+    [BossID.DANGLE] = "bossname_dangle.png",
+    [BossID.TURDLING] = "bossname_turdlings.png",
+    [BossID.THE_FRAIL] = "bossname_thefrail.png",
+    [BossID.RAG_MEGA] = "bossname_ragmega.png",
+    [BossID.SISTERS_VIS] = "bossname_sisterssvis.png",
+    [BossID.BIG_HORN] = "bossname_bighorn.png",
+    [BossID.DELIRIUM] = "bossname_delirium.png",
+    [BossID.THE_MATRIARCH] = "bossname_matriarch.png",
+    [BossID.THE_PILE] = "bossname_polycephalus2.png",
+    [BossID.REAP_CREEP] = "bossname_reapcreep.png",
+    [BossID.LIL_BLUB] = "bossname_beelzeblub.png",
+    [BossID.WORMWOOD] = "bossname_wormwood.png",
+    [BossID.RAINMAKER] = "bossname_rainmaker.png",
+    [BossID.THE_VISAGE] = "bossname_visage.png",
+    [BossID.THE_SIREN] = "bossname_siren.png",
+    [BossID.TUFF_TWINS] = "bossname_tufftwins.png",
+    [BossID.THE_HERETIC] = "bossname_heretic.png",
+    [BossID.HORNFEL] = "bossname_hornfel.png",
+    [BossID.GREAT_GIDEON] = "bossname_gideon.png",
+    [BossID.BABY_PLUM] = "bossname_babyplum.png",
+    [BossID.THE_SCOURGE] = "bossname_scourge.png",
+    [BossID.CHIMERA] = "bossname_chimera.png",
+    [BossID.ROTGUT] = "bossname_rotgut.png",
+    [BossID.MOTHER] = "bossname_mother.png",
+    [BossID.MAUSOLEUM_MOM] = "bossname_45.0_mom.png",
+    [BossID.MAUSOLEUM_MOMS_HEART] = "bossname_78.0_momsheart.png",
+    [BossID.MIN_MIN] = "bossname_minmin.png",
+    [BossID.CLOG] = "bossname_clog.png",
+    [BossID.SINGE] = "bossname_singe.png",
+    [BossID.BUMBINO] = "bossname_bumbino.png",
+    [BossID.COLOSTOMIA] = "bossname_colostomia.png",
+    [BossID.THE_SHELL] = "bossname_shell.png",
+    [BossID.TURDLET] = "bossname_turdlet.png",
+    [BossID.RAGLICH] = "bossname_raglich.png",
+    [BossID.DOGMA] = "bossname_dogma.png",
+    [BossID.BEAST] = "bossname_dogma.png",
+    [BossID.HORNY_BOYS] = "bossname_hornyboys.png",
+    [BossID.CLUTCH] = "bossname_clutch.png"
+}
+return ____exports

package/objects/bossPortraitPNGFileNames.d.ts

@@ -0,0 +1,5 @@
+import { BossID } from "isaac-typescript-definitions";
+/** Used when rendering the "versusscreen.anm2" sprite. */
+export declare const BOSS_PORTRAIT_PNG_FILE_NAMES: {
+    readonly [key in BossID]: string;
+};

package/objects/bossPortraitPNGFileNames.lua

@@ -0,0 +1,108 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
+--- Used when rendering the "versusscreen.anm2" sprite.
+____exports.BOSS_PORTRAIT_PNG_FILE_NAMES = {
+    [BossID.MONSTRO] = "portrait_20.0_monstro.png",
+    [BossID.LARRY_JR] = "portrait_19.0_larryjr.png",
+    [BossID.CHUB] = "portrait_28.0_chub.png",
+    [BossID.GURDY] = "portrait_36.0_gurdy.png",
+    [BossID.MONSTRO_II] = "portrait_43.0_monstro2.png",
+    [BossID.MOM] = "portrait_45.0_mom.png",
+    [BossID.SCOLEX] = "portrait_62.1_scolex.png",
+    [BossID.MOMS_HEART] = "portrait_78.0_momsheart.png",
+    [BossID.FAMINE] = "portrait_63.0_famine.png",
+    [BossID.PESTILENCE] = "portrait_64.0_pestilence.png",
+    [BossID.WAR] = "portrait_65.0_war.png",
+    [BossID.DEATH] = "portrait_66.0_death.png",
+    [BossID.DUKE_OF_FLIES] = "portrait_67.0_dukeofflies.png",
+    [BossID.PEEP] = "portrait_68.0_peep.png",
+    [BossID.LOKI] = "portrait_69.0_loki.png",
+    [BossID.BLASTOCYST] = "portrait_74.0_blastocyst.png",
+    [BossID.GEMINI] = "portrait_79.0_gemini.png",
+    [BossID.FISTULA] = "portrait_71.0_fistula.png",
+    [BossID.GISH] = "portrait_43.1_gish.png",
+    [BossID.STEVEN] = "portrait_79.1_steven.png",
+    [BossID.CHAD] = "portrait_28.1_chad.png",
+    [BossID.HEADLESS_HORSEMAN] = "portrait_82.0_headlesshorseman.png",
+    [BossID.THE_FALLEN] = "portrait_81.0_thefallen.png",
+    [BossID.SATAN] = "portrait_84.0_satan.png",
+    [BossID.IT_LIVES] = "portrait_78.1_itlives.png",
+    [BossID.THE_HOLLOW] = "portrait_19.1_thehollow.png",
+    [BossID.THE_CARRION_QUEEN] = "portrait_28.2_carrionqueen.png",
+    [BossID.GURDY_JR] = "portrait_99.0_gurdyjr.png",
+    [BossID.THE_HUSK] = "portrait_67.1_thehusk.png",
+    [BossID.THE_BLOAT] = "portrait_68.1_bloat.png",
+    [BossID.LOKII] = "portrait_69.1_lokii.png",
+    [BossID.THE_BLIGHTED_OVUM] = "portrait_79.2_blightedovum.png",
+    [BossID.TERATOMA] = "portrait_71.1_teratoma.png",
+    [BossID.THE_WIDOW] = "portrait_100.0_widow.png",
+    [BossID.MASK_OF_INFAMY] = "portrait_97.0_maskofinfamy.png",
+    [BossID.THE_WRETCHED] = "portrait_100.1_thewretched.png",
+    [BossID.PIN] = "portrait_62.0_pin.png",
+    [BossID.CONQUEST] = "portrait_65.1_conquest.png",
+    [BossID.ISAAC] = "portrait_102.0_isaac.png",
+    [BossID.BLUE_BABY] = "portrait_102.1_bluebaby.png",
+    [BossID.DADDY_LONG_LEGS] = "portrait_101.0_daddylonglegs.png",
+    [BossID.TRIACHNID] = "portrait_101.1_triachnid.png",
+    [BossID.THE_HAUNT] = "portrait_260.0_thehaunt.png",
+    [BossID.DINGLE] = "portrait_261.0_dingle.png",
+    [BossID.MEGA_MAW] = "portrait_262.0_megamaw.png",
+    [BossID.THE_GATE] = "portrait_263.0_megamaw2.png",
+    [BossID.MEGA_FATTY] = "portrait_264.0_megafatty.png",
+    [BossID.THE_CAGE] = "portrait_265.0_fatty2.png",
+    [BossID.MAMA_GURDY] = "portrait_266.0_mamagurdy.png",
+    [BossID.DARK_ONE] = "portrait_267.0_darkone.png",
+    [BossID.THE_ADVERSARY] = "portrait_268.0_darkone2.png",
+    [BossID.POLYCEPHALUS] = "portrait_269.0_polycephalus.png",
+    [BossID.MR_FRED] = "portrait_270.0_megafred.png",
+    [BossID.THE_LAMB] = "portrait_273.0_thelamb.png",
+    [BossID.MEGA_SATAN] = "portrait_274.0_megasatan.png",
+    [BossID.GURGLINGS] = "portrait_276.0_gurglings.png",
+    [BossID.THE_STAIN] = "portrait_401.0_thestain.png",
+    [BossID.BROWNIE] = "portrait_402.0_brownie.png",
+    [BossID.THE_FORSAKEN] = "portrait_403.0_theforsaken.png",
+    [BossID.LITTLE_HORN] = "portrait_404.0_littlehorn.png",
+    [BossID.RAG_MAN] = "portrait_405.0_ragman.png",
+    [BossID.ULTRA_GREED] = "portrait_406.0_ultragreed.png",
+    [BossID.HUSH] = "portrait_407.0_hush.png",
+    [BossID.DANGLE] = "portrait_dangle.png",
+    [BossID.TURDLING] = "portrait_turdlings.png",
+    [BossID.THE_FRAIL] = "portrait_thefrail.png",
+    [BossID.RAG_MEGA] = "portrait_ragmega.png",
+    [BossID.SISTERS_VIS] = "portrait_sistersvis.png",
+    [BossID.BIG_HORN] = "portrait_bighorn.png",
+    [BossID.DELIRIUM] = "portrait_delirium.png",
+    [BossID.THE_MATRIARCH] = "portrait_matriarch.png",
+    [BossID.THE_PILE] = "portrait_269.1_polycephalus2.png",
+    [BossID.REAP_CREEP] = "portrait_900.0_reapcreep.png",
+    [BossID.LIL_BLUB] = "portrait_901.0_beelzeblub.png",
+    [BossID.WORMWOOD] = "portrait_902.0_wormwood.png",
+    [BossID.RAINMAKER] = "portrait_902.0_rainmaker.png",
+    [BossID.THE_VISAGE] = "portrait_903.0_visage.png",
+    [BossID.THE_SIREN] = "portrait_904.0_siren.png",
+    [BossID.TUFF_TWINS] = "portrait_19.100_tufftwins.png",
+    [BossID.THE_HERETIC] = "portrait_905.0_heretic.png",
+    [BossID.HORNFEL] = "portrait_906.0_hornfel.png",
+    [BossID.GREAT_GIDEON] = "portrait_907.0_gideon.png",
+    [BossID.BABY_PLUM] = "portrait_908.0_babyplum.png",
+    [BossID.THE_SCOURGE] = "portrait_909.0_scourge.png",
+    [BossID.CHIMERA] = "portrait_910.0_chimera.png",
+    [BossID.ROTGUT] = "portrait_911.0_rotgut.png",
+    [BossID.MOTHER] = "portrait_mother.png",
+    [BossID.MAUSOLEUM_MOM] = "portrait_45.0_mom.png",
+    [BossID.MAUSOLEUM_MOMS_HEART] = "portrait_78.0_momsheart.png",
+    [BossID.MIN_MIN] = "portrait_minmin.png",
+    [BossID.CLOG] = "portrait_clog.png",
+    [BossID.SINGE] = "portrait_singe.png",
+    [BossID.BUMBINO] = "portrait_bumbino.png",
+    [BossID.COLOSTOMIA] = "portrait_colostomia.png",
+    [BossID.THE_SHELL] = "portrait_shell.png",
+    [BossID.TURDLET] = "portrait_turdlet.png",
+    [BossID.RAGLICH] = "portrait_raglich.png",
+    [BossID.DOGMA] = "portrait_dogma.png",
+    [BossID.BEAST] = "portrait_dogma.png",
+    [BossID.HORNY_BOYS] = "portrait_hornyboys.png",
+    [BossID.CLUTCH] = "portrait_clutch.png"
+}
+return ____exports

package/objects/colors.d.ts

@@ -3,14 +3,21 @@
  *
  * Note that if you want to further modify these colors, you should copy them first with the
  * `copyColor` function.
+ *
+ * The non-standard colors come from:
+ * https://htmlcolorcodes.com/color-names/
  */
 export declare const COLORS: {
-    readonly Black: Color;
-    readonly Red: Color;
-    readonly Green: Color;
-    readonly Blue: Color;
-    readonly Yellow: Color;
-    readonly Pink: Color;
-    readonly Cyan: Color;
-    readonly White: Color;
+    readonly Black: Readonly<Color>;
+    readonly Red: Readonly<Color>;
+    readonly Green: Readonly<Color>;
+    readonly Blue: Readonly<Color>;
+    readonly Yellow: Readonly<Color>;
+    readonly Pink: Readonly<Color>;
+    readonly Cyan: Readonly<Color>;
+    readonly White: Readonly<Color>;
+    readonly Brown: Readonly<Color>;
+    readonly Gray: Readonly<Color>;
+    readonly Orange: Readonly<Color>;
+    readonly Purple: Readonly<Color>;
 };

package/objects/colors.lua

@@ -3,14 +3,21 @@ local ____exports = {}
 -- 
 -- Note that if you want to further modify these colors, you should copy them first with the
 -- `copyColor` function.
+-- 
+-- The non-standard colors come from:
+-- https://htmlcolorcodes.com/color-names/
 ____exports.COLORS = {
-    Black = Color(1, 1, 1),
+    Black = Color(0, 0, 0),
     Red = Color(1, 0, 0),
     Green = Color(0, 1, 0),
     Blue = Color(0, 0, 1),
     Yellow = Color(1, 1, 0),
     Pink = Color(1, 0, 1),
     Cyan = Color(0, 1, 1),
-    White = Color(1, 1, 1)
+    White = Color(1, 1, 1),
+    Brown = Color(0.588, 0.294, 0),
+    Gray = Color(0.5, 0.5, 0.5),
+    Orange = Color(1, 0.647, 0),
+    Purple = Color(0.5, 0, 0.5)
 }
 return ____exports

package/objects/playerNamePNGFileNames.d.ts

@@ -0,0 +1,5 @@
+import { PlayerType } from "isaac-typescript-definitions";
+/** Used when rendering the "versusscreen.anm2" sprite. */
+export declare const PLAYER_NAME_PNG_FILE_NAMES: {
+    readonly [key in PlayerType]: string | undefined;
+};

package/objects/playerNamePNGFileNames.lua

@@ -0,0 +1,49 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+--- Used when rendering the "versusscreen.anm2" sprite.
+____exports.PLAYER_NAME_PNG_FILE_NAMES = {
+    [PlayerType.POSSESSOR] = nil,
+    [PlayerType.ISAAC] = "playername_01_isaac.png",
+    [PlayerType.MAGDALENE] = "playername_02_magdalene.png",
+    [PlayerType.CAIN] = "playername_03_cain.png",
+    [PlayerType.JUDAS] = "playername_04_judas.png",
+    [PlayerType.BLUE_BABY] = "playername_06_bluebaby.png",
+    [PlayerType.EVE] = "playername_05_eve.png",
+    [PlayerType.SAMSON] = "playername_07_samson.png",
+    [PlayerType.AZAZEL] = "playername_08_azazel.png",
+    [PlayerType.LAZARUS] = "playername_10_lazarus.png",
+    [PlayerType.EDEN] = "playername_09_eden.png",
+    [PlayerType.THE_LOST] = "playername_12_thelost.png",
+    [PlayerType.LAZARUS_2] = "playername_10_lazarus.png",
+    [PlayerType.BLACK_JUDAS] = "playername_04_judas.png",
+    [PlayerType.LILITH] = "playername_13_lilith.png",
+    [PlayerType.KEEPER] = "playername_14_thekeeper.png",
+    [PlayerType.APOLLYON] = "playername_15_apollyon.png",
+    [PlayerType.THE_FORGOTTEN] = "playername_16_theforgotten.png",
+    [PlayerType.THE_SOUL] = "playername_16_theforgotten.png",
+    [PlayerType.BETHANY] = "playername_01x_bethany.png",
+    [PlayerType.JACOB] = "playername_02x_jacob_esau.png",
+    [PlayerType.ESAU] = "playername_02x_jacob_esau.png",
+    [PlayerType.ISAAC_B] = "playername_01_isaac.png",
+    [PlayerType.MAGDALENE_B] = "playername_02_magdalene.png",
+    [PlayerType.CAIN_B] = "playername_03_cain.png",
+    [PlayerType.JUDAS_B] = "playername_04_judas.png",
+    [PlayerType.BLUE_BABY_B] = "playername_06_bluebaby.png",
+    [PlayerType.EVE_B] = "playername_05_eve.png",
+    [PlayerType.SAMSON_B] = "playername_07_samson.png",
+    [PlayerType.AZAZEL_B] = "playername_08_azazel.png",
+    [PlayerType.LAZARUS_B] = "playername_10_lazarus.png",
+    [PlayerType.EDEN_B] = "playername_09_eden.png",
+    [PlayerType.THE_LOST_B] = "playername_12_thelost.png",
+    [PlayerType.LILITH_B] = "playername_13_lilith.png",
+    [PlayerType.KEEPER_B] = "playername_14_thekeeper.png",
+    [PlayerType.APOLLYON_B] = "playername_15_apollyon.png",
+    [PlayerType.THE_FORGOTTEN_B] = "playername_16_theforgotten.png",
+    [PlayerType.BETHANY_B] = "playername_01x_bethany.png",
+    [PlayerType.JACOB_B] = "playername_02x_jacob.png",
+    [PlayerType.LAZARUS_2_B] = "playername_10_lazarus.png",
+    [PlayerType.JACOB_2_B] = "playername_02x_jacob.png",
+    [PlayerType.THE_SOUL_B] = "playername_16_theforgotten.png"
+}
+return ____exports

package/objects/playerPortraitPNGFileNames.d.ts

@@ -0,0 +1,5 @@
+import { PlayerType } from "isaac-typescript-definitions";
+/** Used when rendering the "versusscreen.anm2" sprite. */
+export declare const PLAYER_PORTRAIT_PNG_FILE_NAMES: {
+    readonly [key in PlayerType]: string | undefined;
+};