isaacscript-common 9.18.4 → 9.19.2

package/dist/src/features/customStage/customStageUtils.lua

@@ -0,0 +1,102 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local getTotalWeightOfCustomStageRooms, getCustomStageRoomWithChosenWeight, getTotalWeightOfBossPool, getBossEntryWithChosenWeight
+local ____array = require("src.functions.array")
+local sumArray = ____array.sumArray
+local ____log = require("src.functions.log")
+local log = ____log.log
+local ____random = require("src.functions.random")
+local getRandomFloat = ____random.getRandomFloat
+local ____rng = require("src.functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+function getTotalWeightOfCustomStageRooms(self, roomsMetadata)
+    local weights = __TS__ArrayMap(
+        roomsMetadata,
+        function(____, roomMetadata) return roomMetadata.weight end
+    )
+    return sumArray(nil, weights)
+end
+function getCustomStageRoomWithChosenWeight(self, roomsMetadata, chosenWeight)
+    for ____, roomMetadata in ipairs(roomsMetadata) do
+        if chosenWeight < roomMetadata.weight then
+            return roomMetadata
+        end
+        chosenWeight = chosenWeight - roomMetadata.weight
+    end
+    error("Failed to get a custom stage room with chosen weight: " .. tostring(chosenWeight))
+end
+function getTotalWeightOfBossPool(self, bossPool)
+    local weights = __TS__ArrayMap(
+        bossPool,
+        function(____, bossEntry) return bossEntry.weight end
+    )
+    return sumArray(nil, weights)
+end
+function getBossEntryWithChosenWeight(self, bossPool, chosenWeight)
+    for ____, bossEntry in ipairs(bossPool) do
+        if chosenWeight < bossEntry.weight then
+            return bossEntry
+        end
+        chosenWeight = chosenWeight - bossEntry.weight
+    end
+    error("Failed to get a custom stage boss entry with chosen weight: " .. tostring(chosenWeight))
+end
+--- 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
+function ____exports.getRandomCustomStageRoom(self, roomsMetadata, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local totalWeight = getTotalWeightOfCustomStageRooms(nil, roomsMetadata)
+    if verbose then
+        log(
+            nil,
+            "Total weight of the custom stage rooms provided: " .. tostring(totalWeight)
+        )
+    end
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    if verbose then
+        log(
+            nil,
+            "Randomly chose weight for custom stage room: " .. tostring(chosenWeight)
+        )
+    end
+    return getCustomStageRoomWithChosenWeight(nil, roomsMetadata, chosenWeight)
+end
+function ____exports.getRandomBossRoomFromPool(self, roomsMetadata, bossPool, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local totalWeight = getTotalWeightOfBossPool(nil, bossPool)
+    if verbose then
+        log(
+            nil,
+            "Total weight of the custom stage boss pool provided: " .. tostring(totalWeight)
+        )
+    end
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    if verbose then
+        log(
+            nil,
+            "Randomly chose weight for custom stage boss pool: " .. tostring(chosenWeight)
+        )
+    end
+    local bossEntry = getBossEntryWithChosenWeight(nil, bossPool, chosenWeight)
+    local roomsMetadataForBoss = __TS__ArrayFilter(
+        roomsMetadata,
+        function(____, roomMetadata) return roomMetadata.subType == bossEntry.subType end
+    )
+    return ____exports.getRandomCustomStageRoom(nil, roomsMetadataForBoss, seedOrRNG, verbose)
+end
+return ____exports

package/dist/src/features/customStage/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAoBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,YAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAqDN;AAkGD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/src/features/customStage/exports.lua

@@ -0,0 +1,175 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local ____exports = {}
+local setStageRoomsData
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+local ____reorderedCallbacks = require("src.callbacks.reorderedCallbacks")
+local reorderedCallbacksSetStageInternal = ____reorderedCallbacks.reorderedCallbacksSetStageInternal
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____doors = require("src.functions.doors")
+local doorSlotFlagsToDoorSlots = ____doors.doorSlotFlagsToDoorSlots
+local ____log = require("src.functions.log")
+local logError = ____log.logError
+local ____rng = require("src.functions.rng")
+local newRNG = ____rng.newRNG
+local ____rooms = require("src.functions.rooms")
+local getRoomDataForTypeVariant = ____rooms.getRoomDataForTypeVariant
+local getRoomsInsideGrid = ____rooms.getRoomsInsideGrid
+local ____stage = require("src.functions.stage")
+local setStage = ____stage.setStage
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+local ____customStageUtils = require("src.features.customStage.customStageUtils")
+local getRandomBossRoomFromPool = ____customStageUtils.getRandomBossRoomFromPool
+local getRandomCustomStageRoom = ____customStageUtils.getRandomCustomStageRoom
+local ____v = require("src.features.customStage.v")
+local v = ____v.default
+local customStageCachedRoomData = ____v.customStageCachedRoomData
+local customStagesMap = ____v.customStagesMap
+function setStageRoomsData(self, customStage, rng, verbose)
+    local level = game:GetLevel()
+    local startingRoomGridIndex = level:GetStartingRoomIndex()
+    for ____, room in ipairs(getRoomsInsideGrid(nil)) do
+        do
+            if room.SafeGridIndex == startingRoomGridIndex then
+                goto __continue7
+            end
+            if room.Data == nil then
+                goto __continue7
+            end
+            local roomType = room.Data.Type
+            local roomShapeMap = customStage.roomTypeMap:get(roomType)
+            if roomShapeMap == nil then
+                if roomType == RoomType.DEFAULT then
+                    logError(
+                        nil,
+                        (((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name
+                    )
+                end
+                goto __continue7
+            end
+            local roomShape = room.Data.Shape
+            local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
+            if roomDoorSlotFlagMap == nil then
+                logError(
+                    nil,
+                    (((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name
+                )
+                goto __continue7
+            end
+            local doorSlotFlags = room.Data.Doors
+            local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
+            if roomsMetadata == nil then
+                logError(
+                    nil,
+                    (((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") + DoorSlotFlags ") .. tostring(doorSlotFlags)) .. " for custom stage: ") .. customStage.name
+                )
+                local header = ("For reference, a DoorSlotFlags of " .. tostring(doorSlotFlags)) .. " is equal to the following doors being enabled:\n"
+                local doorSlots = doorSlotFlagsToDoorSlots(nil, doorSlotFlags)
+                local doorSlotLines = __TS__ArrayMap(
+                    doorSlots,
+                    function(____, doorSlot) return ((("- DoorSlot." .. tostring(DoorSlot[doorSlot])) .. " (") .. tostring(doorSlot)) .. ")" end
+                )
+                local explanation = header .. table.concat(doorSlotLines, "\n")
+                logError(nil, explanation)
+                goto __continue7
+            end
+            local randomRoom
+            if roomType == RoomType.BOSS then
+                if customStage.bossPool == nil then
+                    goto __continue7
+                end
+                randomRoom = getRandomBossRoomFromPool(
+                    nil,
+                    roomsMetadata,
+                    customStage.bossPool,
+                    rng,
+                    verbose
+                )
+            else
+                randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
+            end
+            local newRoomData = customStageCachedRoomData:get(randomRoom.variant)
+            if newRoomData == nil then
+                newRoomData = getRoomDataForTypeVariant(nil, roomType, randomRoom.variant, false)
+                if newRoomData == nil then
+                    logError(
+                        nil,
+                        (("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name
+                    )
+                    goto __continue7
+                end
+                customStageCachedRoomData:set(randomRoom.variant, newRoomData)
+            end
+            room.Data = newRoomData
+        end
+        ::__continue7::
+    end
+end
+____exports.DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
+____exports.DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
+--- Equal to -1. Setting the stage to an invalid stage value is useful in that it prevents backdrops
+-- and shadows from loading.
+____exports.CUSTOM_FLOOR_STAGE = -1
+--- We must use `StageType.WRATH_OF_THE_LAMB` instead of `StageType.ORIGINAL` or else the walls will
+-- not render properly. DeadInfinity suspects that this might be because it is trying to use the
+-- Dark Room's backdrop (instead of The Chest).
+____exports.CUSTOM_FLOOR_STAGE_TYPE = StageType.WRATH_OF_THE_LAMB
+--- Helper function to warp to a custom stage/level.
+-- 
+-- Custom stages/levels must first be defined in the "tsconfig.json" file. See the documentation for
+-- more details: https://isaacscript.github.io/main/custom-stages/
+-- 
+-- @param name The name of the custom stage, corresponding to what is in the "tsconfig.json" file.
+-- @param firstFloor Optional. Whether to go to the first floor or the second floor. For example, if
+-- you have a custom stage emulating Caves, then the first floor would be Caves 1,
+-- and the second floor would be Caves 2. Default is true.
+-- @param verbose Optional. Whether to log additional information about the rooms that are chosen.
+-- Default is false.
+function ____exports.setCustomStage(self, name, firstFloor, verbose)
+    if firstFloor == nil then
+        firstFloor = true
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local customStage = customStagesMap:get(name)
+    if customStage == nil then
+        error(("Failed to set the custom stage of \"" .. name) .. "\" because it was not found in the custom stages map. (Try restarting IsaacScript / recompiling the mod / restarting the game, and try again. If that does not work, you probably forgot to define it in your \"tsconfig.json\" file.) See the website for more details on how to set up custom stages.")
+    end
+    local level = game:GetLevel()
+    local stage = level:GetStage()
+    local seeds = game:GetSeeds()
+    local startSeed = seeds:GetStartSeed()
+    local rng = newRNG(nil, startSeed)
+    v.run.currentCustomStage = customStage
+    v.run.firstFloor = firstFloor
+    if stage == ____exports.CUSTOM_FLOOR_STAGE then
+        level:SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL)
+    end
+    local baseStage = customStage.baseStage == nil and ____exports.DEFAULT_BASE_STAGE or customStage.baseStage
+    if not firstFloor then
+        baseStage = baseStage + 1
+    end
+    local baseStageType = customStage.baseStageType == nil and ____exports.DEFAULT_BASE_STAGE_TYPE or customStage.baseStageType
+    local reseed = asNumber(nil, stage) >= baseStage
+    setStage(nil, baseStage, baseStageType, reseed)
+    setStageRoomsData(nil, customStage, rng, verbose)
+    local targetStage = ____exports.CUSTOM_FLOOR_STAGE
+    local targetStageType = ____exports.CUSTOM_FLOOR_STAGE_TYPE
+    level:SetStage(targetStage, targetStageType)
+    reorderedCallbacksSetStageInternal(nil, targetStage, targetStageType)
+end
+--- Helper function to disable the custom stage. This is typically called before taking the player to
+-- a vanilla floor.
+function ____exports.disableCustomStage(self)
+    v.run.currentCustomStage = nil
+end
+return ____exports

package/dist/src/features/customStage/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA8BxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA0BtD"}

package/dist/src/features/customStage/init.lua

@@ -0,0 +1,147 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local initRoomTypeMaps, getRoomTypeMap, postRender, postCurseEval, getShaderParams, postGridEntityBrokenRockAlt, postGridEntityInit, postNewRoomReordered
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____array = require("src.functions.array")
+local isArray = ____array.isArray
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local removeFlag = ____flag.removeFlag
+local ____exports = require("src.features.saveDataManager.exports")
+local saveDataManager = ____exports.saveDataManager
+local ____backdrop = require("src.features.customStage.backdrop")
+local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
+local ____customStageConstants = require("src.features.customStage.customStageConstants")
+local CUSTOM_STAGE_FEATURE_NAME = ____customStageConstants.CUSTOM_STAGE_FEATURE_NAME
+local ____customStageGridEntities = require("src.features.customStage.customStageGridEntities")
+local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
+local removeUrnRewards = ____customStageGridEntities.removeUrnRewards
+local setCustomDecorationGraphics = ____customStageGridEntities.setCustomDecorationGraphics
+local setCustomDoorGraphics = ____customStageGridEntities.setCustomDoorGraphics
+local setCustomPitGraphics = ____customStageGridEntities.setCustomPitGraphics
+local setCustomRockGraphics = ____customStageGridEntities.setCustomRockGraphics
+local metadataJSON = require("src.features.customStage.metadata")
+local ____shadows = require("src.features.customStage.shadows")
+local setShadows = ____shadows.setShadows
+local ____streakText = require("src.features.customStage.streakText")
+local streakTextGetShaderParams = ____streakText.streakTextGetShaderParams
+local streakTextPostRender = ____streakText.streakTextPostRender
+local ____v = require("src.features.customStage.v")
+local v = ____v.default
+local customStagesMap = ____v.customStagesMap
+local ____versusScreen = require("src.features.customStage.versusScreen")
+local playVersusScreenAnimation = ____versusScreen.playVersusScreenAnimation
+local versusScreenInit = ____versusScreen.versusScreenInit
+local versusScreenPostRender = ____versusScreen.versusScreenPostRender
+function initRoomTypeMaps(self)
+    if not isArray(nil, metadataJSON) then
+        error("The IsaacScript standard library attempted to read the custom stage metadata from the \"metadata.lua\" file, but it was not an array.")
+    end
+    local customStagesLua = metadataJSON
+    for ____, customStageLua in ipairs(customStagesLua) do
+        local roomTypeMap = getRoomTypeMap(nil, customStageLua)
+        local customStage = __TS__ObjectAssign({}, customStageLua, {roomTypeMap = roomTypeMap})
+        customStagesMap:set(customStage.name, customStage)
+    end
+end
+function getRoomTypeMap(self, customStageLua)
+    local roomTypeMap = __TS__New(Map)
+    for ____, roomMetadata in ipairs(customStageLua.roomsMetadata) do
+        local roomType = roomMetadata.type
+        local roomShapeMap = roomTypeMap:get(roomType)
+        if roomShapeMap == nil then
+            roomShapeMap = __TS__New(Map)
+            roomTypeMap:set(roomType, roomShapeMap)
+        end
+        local roomShape = roomMetadata.shape
+        local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
+        if roomDoorSlotFlagMap == nil then
+            roomDoorSlotFlagMap = __TS__New(Map)
+            roomShapeMap:set(roomShape, roomDoorSlotFlagMap)
+        end
+        local doorSlotFlags = roomMetadata.doorSlotFlags
+        local rooms = roomDoorSlotFlagMap:get(doorSlotFlags)
+        if rooms == nil then
+            rooms = {}
+            roomDoorSlotFlagMap:set(doorSlotFlags, rooms)
+        end
+        rooms[#rooms + 1] = roomMetadata
+    end
+    return roomTypeMap
+end
+function postRender(self)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    streakTextPostRender(nil)
+    versusScreenPostRender(nil)
+end
+function postCurseEval(self, curses)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return nil
+    end
+    if hasFlag(nil, curses, LevelCurse.LABYRINTH) then
+        return removeFlag(nil, curses, LevelCurse.LABYRINTH)
+    end
+    return nil
+end
+function getShaderParams(self, shaderName)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    streakTextGetShaderParams(nil, customStage, shaderName)
+    return nil
+end
+function postGridEntityBrokenRockAlt(self, gridEntity)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    removeUrnRewards(nil, customStage, gridEntity)
+end
+function postGridEntityInit(self, gridEntity)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    setCustomDecorationGraphics(nil, customStage, gridEntity)
+    setCustomRockGraphics(nil, customStage, gridEntity)
+    setCustomPitGraphics(nil, customStage, gridEntity)
+    setCustomDoorGraphics(nil, customStage, gridEntity)
+    convertVanillaTrapdoors(nil, customStage, gridEntity)
+end
+function postNewRoomReordered(self)
+    local customStage = v.run.currentCustomStage
+    if customStage == nil then
+        return
+    end
+    setCustomStageBackdrop(nil, customStage)
+    setShadows(nil, customStage)
+    playVersusScreenAnimation(nil, customStage)
+end
+function ____exports.customStageInit(self, mod)
+    initRoomTypeMaps(nil)
+    if customStagesMap.size == 0 then
+        return
+    end
+    saveDataManager(nil, CUSTOM_STAGE_FEATURE_NAME, v)
+    versusScreenInit(nil)
+    mod:AddCallback(ModCallback.POST_RENDER, postRender)
+    mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
+    mod:AddCallback(ModCallback.GET_SHADER_PARAMS, getShaderParams)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_BROKEN, postGridEntityBrokenRockAlt, GridEntityType.ROCK_ALT)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_INIT, postGridEntityInit)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
+end
+return ____exports

package/dist/src/features/customStage/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/shadows.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAqCnE,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAuCzD"}

package/dist/src/features/customStage/shadows.lua

@@ -0,0 +1,72 @@
+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 ____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 ____customStageConstants = require("src.features.customStage.customStageConstants")
+local ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = ____customStageConstants.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH
+local ____v = require("src.features.customStage.v")
+local v = ____v.default
+--- 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 = 102
+--- 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)
+    v.room.showingShadows = true
+end
+return ____exports

package/dist/src/features/customStage/streakText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streakText.d.ts","sourceRoot":"","sources":["../../../../src/features/customStage/streakText.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAuEnE,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AA0FD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAYN;AA0ED,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC"}