isaacscript-common 14.2.0 → 15.0.0

package/dist/src/classes/features/other/customStages/gridEntities.lua

@@ -0,0 +1,243 @@
+local ____exports = {}
+local getNewDoorPNGPath
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local ____gridEntities = require("src.functions.gridEntities")
+local removeGridEntity = ____gridEntities.removeGridEntity
+local ____stage = require("src.functions.stage")
+local calculateStageType = ____stage.calculateStageType
+local ____string = require("src.functions.string")
+local removeCharactersBefore = ____string.removeCharactersBefore
+local ____constants = require("src.classes.features.other.customStages.constants")
+local DEFAULT_BASE_STAGE = ____constants.DEFAULT_BASE_STAGE
+function getNewDoorPNGPath(self, customStage, fileName)
+    repeat
+        local ____switch26 = fileName
+        local ____cond26 = ____switch26 == "gfx/grid/door_01_normaldoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_normal_0 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_normal_0 ~= nil then
+                    ____customStage_doorPNGPaths_normal_0 = ____customStage_doorPNGPaths_normal_0.normal
+                end
+                return ____customStage_doorPNGPaths_normal_0
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_02_treasureroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_treasureRoom_2 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_treasureRoom_2 ~= nil then
+                    ____customStage_doorPNGPaths_treasureRoom_2 = ____customStage_doorPNGPaths_treasureRoom_2.treasureRoom
+                end
+                return ____customStage_doorPNGPaths_treasureRoom_2
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_03_ambushroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_normalChallengeRoom_4 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_normalChallengeRoom_4 ~= nil then
+                    ____customStage_doorPNGPaths_normalChallengeRoom_4 = ____customStage_doorPNGPaths_normalChallengeRoom_4.normalChallengeRoom
+                end
+                return ____customStage_doorPNGPaths_normalChallengeRoom_4
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_04_selfsacrificeroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_curseRoom_6 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_curseRoom_6 ~= nil then
+                    ____customStage_doorPNGPaths_curseRoom_6 = ____customStage_doorPNGPaths_curseRoom_6.curseRoom
+                end
+                return ____customStage_doorPNGPaths_curseRoom_6
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_05_arcaderoomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_arcade_8 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_arcade_8 ~= nil then
+                    ____customStage_doorPNGPaths_arcade_8 = ____customStage_doorPNGPaths_arcade_8.arcade
+                end
+                return ____customStage_doorPNGPaths_arcade_8
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_07_devilroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_devilRoom_10 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_devilRoom_10 ~= nil then
+                    ____customStage_doorPNGPaths_devilRoom_10 = ____customStage_doorPNGPaths_devilRoom_10.devilRoom
+                end
+                return ____customStage_doorPNGPaths_devilRoom_10
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_07_holyroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_angelRoom_12 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_angelRoom_12 ~= nil then
+                    ____customStage_doorPNGPaths_angelRoom_12 = ____customStage_doorPNGPaths_angelRoom_12.angelRoom
+                end
+                return ____customStage_doorPNGPaths_angelRoom_12
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_08_holeinwall.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_secretRoom_14 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_secretRoom_14 ~= nil then
+                    ____customStage_doorPNGPaths_secretRoom_14 = ____customStage_doorPNGPaths_secretRoom_14.secretRoom
+                end
+                return ____customStage_doorPNGPaths_secretRoom_14
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_09_bossambushroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_bossChallengeRoom_16 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossChallengeRoom_16 ~= nil then
+                    ____customStage_doorPNGPaths_bossChallengeRoom_16 = ____customStage_doorPNGPaths_bossChallengeRoom_16.bossChallengeRoom
+                end
+                return ____customStage_doorPNGPaths_bossChallengeRoom_16
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_10_bossroomdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_bossRoom_18 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossRoom_18 ~= nil then
+                    ____customStage_doorPNGPaths_bossRoom_18 = ____customStage_doorPNGPaths_bossRoom_18.bossRoom
+                end
+                return ____customStage_doorPNGPaths_bossRoom_18
+            end
+        end
+        ____cond26 = ____cond26 or ____switch26 == "gfx/grid/door_15_bossrushdoor.anm2"
+        if ____cond26 then
+            do
+                local ____customStage_doorPNGPaths_bossRush_20 = customStage.doorPNGPaths
+                if ____customStage_doorPNGPaths_bossRush_20 ~= nil then
+                    ____customStage_doorPNGPaths_bossRush_20 = ____customStage_doorPNGPaths_bossRush_20.bossRush
+                end
+                return ____customStage_doorPNGPaths_bossRush_20
+            end
+        end
+    until true
+    return nil
+end
+--- For `GridEntityType.DECORATION` (1).
+function ____exports.setCustomDecorationGraphics(self, customStage, gridEntity)
+    if customStage.decorationsPNGPath == nil and customStage.decorationsANM2Path == nil then
+        return
+    end
+    local gridEntityType = gridEntity:GetType()
+    if gridEntityType ~= GridEntityType.DECORATION then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    if string.lower(fileName) ~= "gfx/grid/props_01_basement.anm2" then
+        return
+    end
+    if customStage.decorationsANM2Path ~= nil then
+        local anm2Path = removeCharactersBefore(nil, customStage.decorationsANM2Path, "gfx/")
+        sprite:Load(anm2Path, true)
+    elseif customStage.decorationsPNGPath ~= nil then
+        local pngPath = removeCharactersBefore(nil, customStage.decorationsPNGPath, "gfx/")
+        sprite:ReplaceSpritesheet(0, pngPath)
+        sprite:LoadGraphics()
+    end
+end
+--- For `GridEntityType.ROCK` (2).
+function ____exports.setCustomRockGraphics(self, customStage, gridEntity)
+    if customStage.rocksPNGPath == nil and customStage.rocksANM2Path == nil then
+        return
+    end
+    local gridEntityRock = gridEntity:ToRock()
+    if gridEntityRock == nil then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    repeat
+        local ____switch11 = fileName
+        local ____cond11 = ____switch11 == "gfx/grid/grid_rock.anm2"
+        if ____cond11 then
+            do
+                if customStage.rocksANM2Path ~= nil then
+                    local anm2Path = removeCharactersBefore(nil, customStage.rocksANM2Path, "gfx/")
+                    sprite:Load(anm2Path, true)
+                elseif customStage.rocksPNGPath ~= nil then
+                    local pngPath = removeCharactersBefore(nil, customStage.rocksPNGPath, "gfx/")
+                    sprite:ReplaceSpritesheet(0, pngPath)
+                    sprite:LoadGraphics()
+                end
+                break
+            end
+        end
+        ____cond11 = ____cond11 or ____switch11 == "gfx/grid/grid_pit.anm2"
+        if ____cond11 then
+            do
+                if customStage.rocksPNGPath ~= nil then
+                    local pngPath = removeCharactersBefore(nil, customStage.rocksPNGPath, "gfx/")
+                    sprite:ReplaceSpritesheet(1, pngPath)
+                    sprite:LoadGraphics()
+                end
+                break
+            end
+        end
+    until true
+end
+--- For `GridEntityType.PIT` (7).
+function ____exports.setCustomPitGraphics(self, customStage, gridEntity)
+    if customStage.pitsPNGPath == nil then
+        return
+    end
+    local pngPath = removeCharactersBefore(nil, customStage.pitsPNGPath, "gfx/")
+    local gridEntityPit = gridEntity:ToPit()
+    if gridEntityPit == nil then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    if fileName == "gfx/grid/grid_pit.anm2" then
+        sprite:ReplaceSpritesheet(0, pngPath)
+        sprite:LoadGraphics()
+    end
+end
+--- For `GridEntityType.DOOR` (16).
+function ____exports.setCustomDoorGraphics(self, customStage, gridEntity)
+    if customStage.doorPNGPaths == nil then
+        return
+    end
+    local gridEntityDoor = gridEntity:ToDoor()
+    if gridEntityDoor == nil then
+        return
+    end
+    local sprite = gridEntity:GetSprite()
+    local fileName = sprite:GetFilename()
+    local doorPNGPath = getNewDoorPNGPath(nil, customStage, fileName)
+    if doorPNGPath ~= nil then
+        local fixedPath = removeCharactersBefore(nil, doorPNGPath, "gfx/")
+        sprite:ReplaceSpritesheet(0, fixedPath)
+        sprite:LoadGraphics()
+    end
+end
+function ____exports.convertVanillaTrapdoors(self, customStage, gridEntity, isFirstFloor, customTrapdoors)
+    local gridEntityType = gridEntity:GetType()
+    if gridEntityType ~= GridEntityType.TRAPDOOR then
+        return
+    end
+    removeGridEntity(nil, gridEntity, true)
+    if isFirstFloor then
+        customTrapdoors:spawnCustomTrapdoor(gridEntity.Position, customStage.name, LevelStage.BASEMENT_2)
+    else
+        local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+        local destinationStage = baseStage + 2
+        local destinationStageType = calculateStageType(nil, destinationStage)
+        customTrapdoors:spawnCustomTrapdoor(gridEntity.Position, nil, destinationStage, destinationStageType)
+    end
+end
+return ____exports

package/dist/src/classes/features/other/customStages/shadows.d.ts

@@ -0,0 +1,3 @@
+import { CustomStage } from "../../../../interfaces/private/CustomStage";
+export declare function setShadows(customStage: CustomStage): void;
+//# sourceMappingURL=shadows.d.ts.map

package/dist/src/classes/features/other/customStages/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/shadows.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAoCzE,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAqCzD"}

package/dist/src/classes/features/other/customStages/shadows.lua

@@ -0,0 +1,71 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____LadderSubTypeCustom = require("src.enums.LadderSubTypeCustom")
+local LadderSubTypeCustom = ____LadderSubTypeCustom.LadderSubTypeCustom
+local ____array = require("src.functions.array")
+local getRandomArrayElement = ____array.getRandomArrayElement
+local ____entitiesSpecific = require("src.functions.entitiesSpecific")
+local spawnEffectWithSeed = ____entitiesSpecific.spawnEffectWithSeed
+local ____string = require("src.functions.string")
+local removeCharactersBefore = ____string.removeCharactersBefore
+local ____constants = require("src.classes.features.other.customStages.constants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____constants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+--- Normally, we would make a custom entity to represent a shadow effect, but we don't want to
+-- interfere with the "entities2.xml" file in end-user mods. Thus, we must select a vanilla effect
+-- to masquerade as a backdrop effect.
+-- 
+-- We arbitrarily choose a ladder for this purpose because it will not automatically despawn after
+-- time passes, like most other effects.
+local SHADOW_EFFECT_VARIANT = EffectVariant.LADDER
+local SHADOW_EFFECT_SUB_TYPE = LadderSubTypeCustom.CUSTOM_SHADOW
+--- The animation comes from StageAPI.
+local ROOM_SHAPE_TO_SHADOW_ANIMATION = {
+    [RoomShape.SHAPE_1x1] = "1x1",
+    [RoomShape.IH] = "1x1",
+    [RoomShape.IV] = "1x1",
+    [RoomShape.SHAPE_1x2] = "1x2",
+    [RoomShape.IIV] = "1x2",
+    [RoomShape.SHAPE_2x1] = "2x1",
+    [RoomShape.IIH] = "2x1",
+    [RoomShape.SHAPE_2x2] = "2x2",
+    [RoomShape.LTL] = "2x2",
+    [RoomShape.LTR] = "2x2",
+    [RoomShape.LBL] = "2x2",
+    [RoomShape.LBR] = "2x2"
+}
+local FADED_BLACK = Color(0, 0, 0, 0.25)
+function ____exports.setShadows(self, customStage)
+    if customStage.shadows == nil then
+        return
+    end
+    local room = game:GetRoom()
+    local roomShape = room:GetRoomShape()
+    local centerPos = room:GetCenterPos()
+    local animation = ROOM_SHAPE_TO_SHADOW_ANIMATION[roomShape]
+    local shadows = customStage.shadows[animation]
+    if shadows == nil then
+        return
+    end
+    local seed = 1
+    local shadowEffect = spawnEffectWithSeed(
+        nil,
+        SHADOW_EFFECT_VARIANT,
+        SHADOW_EFFECT_SUB_TYPE,
+        centerPos,
+        seed
+    )
+    local sprite = shadowEffect:GetSprite()
+    sprite:Load(ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH .. "/stage-shadow.anm2", false)
+    local decorationSeed = room:GetDecorationSeed()
+    local shadow = getRandomArrayElement(nil, shadows, decorationSeed)
+    local pngPath = removeCharactersBefore(nil, shadow.pngPath, "gfx/")
+    sprite:ReplaceSpritesheet(0, pngPath)
+    sprite:LoadGraphics()
+    sprite:SetFrame(animation, 0)
+    sprite.Color = shadow.color == nil and FADED_BLACK or Color(shadow.color.r, shadow.color.g, shadow.color.b, shadow.color.a)
+end
+return ____exports

package/dist/src/classes/features/other/customStages/streakText.d.ts

@@ -0,0 +1,27 @@
+import { ControllerIndex } from "isaac-typescript-definitions";
+import { UIStreakAnimation } from "../../../../enums/private/UIStreakAnimation";
+import { CustomStage } from "../../../../interfaces/private/CustomStage";
+interface StreakTextVars {
+    run: {
+        /** Whether we are on e.g. Caves 1 or Caves 2. */
+        firstFloor: boolean;
+        /** Values are the render frame that the controller first pressed the map button. */
+        controllerIndexPushingMapRenderFrame: Map<ControllerIndex, int>;
+        topStreakTextStartedRenderFrame: int | null;
+        topStreakText: {
+            animation: UIStreakAnimation;
+            frame: int;
+            pauseFrame: boolean;
+        };
+        bottomStreakText: {
+            animation: UIStreakAnimation;
+            frame: int;
+            pauseFrame: boolean;
+        };
+    };
+}
+export declare function streakTextPostRender(v: StreakTextVars): void;
+export declare function streakTextGetShaderParams(v: StreakTextVars, customStage: CustomStage, shaderName: string): void;
+export declare function topStreakTextStart(v: StreakTextVars): void;
+export {};
+//# sourceMappingURL=streakText.d.ts.map

package/dist/src/classes/features/other/customStages/streakText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/streakText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAMhF,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AA0EzE,UAAU,cAAc;IACtB,GAAG,EAAE;QACH,iDAAiD;QACjD,UAAU,EAAE,OAAO,CAAC;QAEpB,oFAAoF;QACpF,oCAAoC,EAAE,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAEhE,+BAA+B,EAAE,GAAG,GAAG,IAAI,CAAC;QAE5C,aAAa,EAAE;YACb,SAAS,EAAE,iBAAiB,CAAC;YAC7B,KAAK,EAAE,GAAG,CAAC;YACX,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;QAEF,gBAAgB,EAAE;YAChB,SAAS,EAAE,iBAAiB,CAAC;YAC7B,KAAK,EAAE,GAAG,CAAC;YACX,UAAU,EAAE,OAAO,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAGD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAS5D;AA0FD,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,cAAc,EACjB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAiBN;AA2ED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAW1D"}

package/dist/src/classes/features/other/customStages/streakText.lua

@@ -0,0 +1,220 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Spread = ____lualib.__TS__Spread
+local ____exports = {}
+local checkEndTopStreakText, trackMapInputPressed, checkStartBottomStreakText, checkEndBottomStreakText, renderStreakText, UI_STREAK_ANIMATION_END_FRAMES, TEXT_STAY_FRAME, TEXT_OUT_FRAME, STREAK_TEXT_BOTTOM_Y_OFFSET, NUM_RENDER_FRAMES_MAP_HELD_BEFORE_STREAK_TEXT, TEXT_IN_ADJUSTMENTS, TEXT_OUT_ADJUSTMENTS, TEXT_IN_SCALES, TEXT_OUT_SCALES
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local ControllerIndex = ____isaac_2Dtypescript_2Ddefinitions.ControllerIndex
+local ____cachedClasses = require("src.core.cachedClasses")
+local fonts = ____cachedClasses.fonts
+local game = ____cachedClasses.game
+local ____constants = require("src.core.constants")
+local KColorDefault = ____constants.KColorDefault
+local VectorOne = ____constants.VectorOne
+local ____UIStreakAnimation = require("src.enums.private.UIStreakAnimation")
+local UIStreakAnimation = ____UIStreakAnimation.UIStreakAnimation
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____ui = require("src.functions.ui")
+local getScreenBottomCenterPos = ____ui.getScreenBottomCenterPos
+local getScreenTopCenterPos = ____ui.getScreenTopCenterPos
+function checkEndTopStreakText(self, v)
+    if v.run.topStreakTextStartedRenderFrame == nil or v.run.topStreakText.animation ~= UIStreakAnimation.TEXT_STAY then
+        return
+    end
+    local renderFrameCount = Isaac.GetFrameCount()
+    local elapsedFrames = renderFrameCount - v.run.topStreakTextStartedRenderFrame
+    if elapsedFrames >= 115 then
+        v.run.topStreakText.animation = UIStreakAnimation.TEXT
+        v.run.topStreakText.frame = TEXT_OUT_FRAME - 2
+    end
+end
+function trackMapInputPressed(self, v)
+    for ____, controllerIndex in ipairs(getEnumValues(nil, ControllerIndex)) do
+        local gameFrameCount = game:GetFrameCount()
+        local oldPushedMapFrame = v.run.controllerIndexPushingMapRenderFrame:get(controllerIndex)
+        local isPushingMap = Input.IsActionPressed(ButtonAction.MAP, controllerIndex)
+        if isPushingMap then
+            if oldPushedMapFrame == nil then
+                v.run.controllerIndexPushingMapRenderFrame:set(controllerIndex, gameFrameCount)
+            end
+        else
+            v.run.controllerIndexPushingMapRenderFrame:delete(controllerIndex)
+        end
+    end
+end
+function checkStartBottomStreakText(self, v)
+    if v.run.bottomStreakText.animation ~= UIStreakAnimation.NONE then
+        return
+    end
+    local pushedMapFrames = {__TS__Spread(v.run.controllerIndexPushingMapRenderFrame:values())}
+    if #pushedMapFrames == 0 then
+        return
+    end
+    local earliestFrame = math.min(table.unpack(pushedMapFrames))
+    local gameFrameCount = game:GetFrameCount()
+    local elapsedFrames = gameFrameCount - earliestFrame
+    if elapsedFrames >= NUM_RENDER_FRAMES_MAP_HELD_BEFORE_STREAK_TEXT then
+        v.run.bottomStreakText.animation = UIStreakAnimation.TEXT
+        v.run.bottomStreakText.frame = 0
+    end
+end
+function checkEndBottomStreakText(self, v)
+    if v.run.bottomStreakText.animation ~= UIStreakAnimation.TEXT_STAY then
+        return
+    end
+    local pushedMapFrames = {__TS__Spread(v.run.controllerIndexPushingMapRenderFrame:values())}
+    if #pushedMapFrames == 0 then
+        v.run.bottomStreakText.animation = UIStreakAnimation.TEXT
+        v.run.bottomStreakText.frame = TEXT_OUT_FRAME - 2
+    end
+end
+function renderStreakText(self, v, customStage, streakText, position)
+    if streakText.animation == UIStreakAnimation.NONE then
+        return
+    end
+    if streakText.animation ~= UIStreakAnimation.TEXT_STAY then
+        local ____streakText_0 = streakText
+        local pauseFrame = ____streakText_0.pauseFrame
+        streakText.pauseFrame = not streakText.pauseFrame
+        if not pauseFrame then
+            streakText.frame = streakText.frame + 1
+        end
+    end
+    local endFrame = UI_STREAK_ANIMATION_END_FRAMES[streakText.animation]
+    if streakText.frame > endFrame then
+        streakText.animation = UIStreakAnimation.NONE
+        streakText.frame = 0
+        return
+    end
+    if streakText.animation == UIStreakAnimation.TEXT and streakText.frame == TEXT_STAY_FRAME then
+        streakText.animation = UIStreakAnimation.TEXT_STAY
+        streakText.frame = 0
+    end
+    local isPaused = game:IsPaused()
+    if isPaused then
+        return
+    end
+    local font = fonts.upheaval
+    local ____customStage_1 = customStage
+    local name = ____customStage_1.name
+    local numberSuffix = v.run.firstFloor and "I" or "II"
+    local nameWithNumberSuffix = (name .. " ") .. numberSuffix
+    local length = font:GetStringWidthUTF8(nameWithNumberSuffix)
+    local centeredX = position.X - length / 2
+    local adjustment = 0
+    local scale = VectorOne
+    if streakText.animation == UIStreakAnimation.TEXT then
+        if streakText.frame < TEXT_STAY_FRAME then
+            adjustment = TEXT_IN_ADJUSTMENTS[streakText.frame + 1] or 0
+            scale = TEXT_IN_SCALES[streakText.frame + 1] or VectorOne
+        else
+            local adjustedFrame = streakText.frame - TEXT_OUT_FRAME
+            adjustment = TEXT_OUT_ADJUSTMENTS[adjustedFrame + 1] or 0
+            scale = TEXT_OUT_SCALES[adjustedFrame + 1] or VectorOne
+        end
+    end
+    local adjustedX = centeredX + adjustment
+    local adjustedY = position.Y + STREAK_TEXT_BOTTOM_Y_OFFSET
+    font:DrawStringScaled(
+        nameWithNumberSuffix,
+        adjustedX,
+        adjustedY,
+        scale.X,
+        scale.Y,
+        KColorDefault
+    )
+end
+UI_STREAK_ANIMATION_END_FRAMES = {[UIStreakAnimation.NONE] = 0, [UIStreakAnimation.TEXT] = 69, [UIStreakAnimation.TEXT_STAY] = 1}
+--- This must match the name of the shader in "shaders.xml".
+local EMPTY_SHADER_NAME = "IsaacScript-RenderAboveHUD"
+TEXT_STAY_FRAME = 8
+TEXT_OUT_FRAME = 60
+--- This matches the offset that the vanilla game uses; determined via trial and error.
+local STREAK_SPRITE_TOP_OFFSET = Vector(0, 47)
+--- This matches the offset that the vanilla game uses; determined via trial and error.
+local STREAK_SPRITE_BOTTOM_OFFSET = Vector(0, -48.25)
+STREAK_TEXT_BOTTOM_Y_OFFSET = -9
+NUM_RENDER_FRAMES_MAP_HELD_BEFORE_STREAK_TEXT = 11
+TEXT_IN_ADJUSTMENTS = {
+    -800,
+    -639,
+    -450,
+    -250,
+    -70,
+    10,
+    6,
+    3
+}
+TEXT_OUT_ADJUSTMENTS = {
+    0,
+    -5,
+    -10,
+    -15,
+    -20,
+    144,
+    308,
+    472,
+    636,
+    800
+}
+TEXT_IN_SCALES = {
+    Vector(3, 0.2),
+    Vector(2.6, 0.36),
+    Vector(2.2, 0.52),
+    Vector(1.8, 0.68),
+    Vector(1.4, 0.84),
+    Vector(0.95, 1.05),
+    Vector(0.97, 1.03),
+    Vector(0.98, 1.02)
+}
+TEXT_OUT_SCALES = {
+    Vector(1, 1),
+    Vector(0.99, 1.03),
+    Vector(0.98, 1.05),
+    Vector(0.96, 1.08),
+    Vector(0.95, 1.1),
+    Vector(1.36, 0.92),
+    Vector(1.77, 0.74),
+    Vector(2.18, 0.56),
+    Vector(2.59, 0.38),
+    Vector(3, 0.2)
+}
+function ____exports.streakTextPostRender(self, v)
+    checkEndTopStreakText(nil, v)
+    trackMapInputPressed(nil, v)
+    checkStartBottomStreakText(nil, v)
+    checkEndBottomStreakText(nil, v)
+end
+function ____exports.streakTextGetShaderParams(self, v, customStage, shaderName)
+    if shaderName ~= EMPTY_SHADER_NAME then
+        return
+    end
+    local topCenterPos = getScreenTopCenterPos(nil)
+    local topStreakPosition = topCenterPos + STREAK_SPRITE_TOP_OFFSET
+    renderStreakText(
+        nil,
+        v,
+        customStage,
+        v.run.topStreakText,
+        topStreakPosition
+    )
+    local bottomCenterPos = getScreenBottomCenterPos(nil)
+    local bottomStreakPosition = bottomCenterPos + STREAK_SPRITE_BOTTOM_OFFSET
+    renderStreakText(
+        nil,
+        v,
+        customStage,
+        v.run.bottomStreakText,
+        bottomStreakPosition
+    )
+end
+function ____exports.topStreakTextStart(self, v)
+    local level = game:GetLevel()
+    local renderFrameCount = Isaac.GetFrameCount()
+    level:ShowName(false)
+    v.run.topStreakText.animation = UIStreakAnimation.TEXT
+    v.run.topStreakText.frame = 0
+    v.run.topStreakTextStartedRenderFrame = renderFrameCount
+end
+return ____exports

package/dist/src/classes/features/other/customStages/utils.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="isaac-typescript-definitions" />
+import { CustomStageBossPoolEntry, CustomStageRoomMetadata } from "../../../../interfaces/CustomStageTSConfig";
+/**
+ * Helper function to get a random custom stage room from an array of custom stage rooms.
+ *
+ * Note that this function does not simply choose a random element in the provided array; it will
+ * properly account for each room weight using the algorithm from:
+ * https://stackoverflow.com/questions/1761626/weighted-random-numbers
+ */
+export declare function getRandomCustomStageRoom(roomsMetadata: readonly CustomStageRoomMetadata[], seedOrRNG?: Seed | RNG, verbose?: boolean): CustomStageRoomMetadata;
+export declare function getRandomBossRoomFromPool(roomsMetadata: readonly CustomStageRoomMetadata[], bossPool: readonly CustomStageBossPoolEntry[], seedOrRNG?: Seed | RNG, verbose?: boolean): CustomStageRoomMetadata;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/classes/features/other/customStages/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/utils.ts"],"names":[],"mappings":";;AAIA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,4CAA4C,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,SAAS,uBAAuB,EAAE,EACjD,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,uBAAuB,CAYzB;AA0BD,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,SAAS,uBAAuB,EAAE,EACjD,QAAQ,EAAE,SAAS,wBAAwB,EAAE,EAC7C,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,uBAAuB,CAiBzB"}

package/dist/src/classes/features/other/customStages/versusScreen.d.ts

@@ -0,0 +1,13 @@
+import { CustomStage } from "../../../../interfaces/private/CustomStage";
+import { DisableAllSound } from "../DisableAllSound";
+import { Pause } from "../Pause";
+import { RunInNFrames } from "../RunInNFrames";
+interface VersusScreenVars {
+    run: {
+        showingBossVersusScreen: boolean;
+    };
+}
+export declare function playVersusScreenAnimation(v: VersusScreenVars, customStage: CustomStage, disableAllSound: DisableAllSound, pause: Pause, runInNFrames: RunInNFrames): void;
+export declare function versusScreenPostRender(v: VersusScreenVars, pause: Pause, disableAllSound: DisableAllSound): void;
+export {};
+//# sourceMappingURL=versusScreen.d.ts.map

package/dist/src/classes/features/other/customStages/versusScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versusScreen.d.ts","sourceRoot":"","sources":["../../../../../../src/classes/features/other/customStages/versusScreen.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAOzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C,UAAU,gBAAgB;IACxB,GAAG,EAAE;QACH,uBAAuB,EAAE,OAAO,CAAC;KAClC,CAAC;CACH;AAgFD,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,gBAAgB,EACnB,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,GACzB,IAAI,CA0GN;AAuGD,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,gBAAgB,EACnB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,eAAe,GAC/B,IAAI,CAwCN"}