isaacscript-common 14.2.0 → 15.0.0

package/dist/src/classes/features/other/CustomItemPools.d.ts

@@ -0,0 +1,57 @@
+import { CollectibleType, ItemPoolType } from "isaac-typescript-definitions";
+import { WeightedArray } from "../../../types/WeightedArray";
+import { Feature } from "../../private/Feature";
+export declare class CustomItemPools extends Feature {
+    private customItemPoolMap;
+    private postGameStartedReordered;
+    /**
+     * Helper function to register a custom item pool. Use this function once when your mod first
+     * loads to declare the items that you want to be in the item pools. Then, in the middle of a run,
+     * you can use `getCustomItemPoolCollectible`.
+     *
+     * For example:
+     *
+     * ```ts
+     * const ItemPoolTypeCustom = {
+     *   FOO = 0 as ItemPoolType,
+     * } as const;
+     *
+     * const FOO_ITEM_POOL = [
+     *   [CollectibleType.SAD_ONION, 1],
+     *   [CollectibleType.INNER_EYE, 0.5],
+     * ];
+     *
+     * registerCustomItemPool(ItemPoolTypeCustom.FOO, FOO_ITEM_POOL);
+     * ```
+     *
+     * Note that custom item pools do not currently support partial weight decrementation on sight.
+     *
+     * @param itemPoolTypeCustom An integer that identifies what kind of item pool you are creating.
+     *                           It should correspond to a local `ItemPoolTypeCustom` enum in your
+     *                           mod. The integer can be any unique value and can safely overlap with
+     *                           the vanilla item pool type values (or values chosen by other mods).
+     * @param collectibles An array of weighted collectible tuples that represent the item pool that
+     *                     you are creating. The first element in he tuple is the `CollectibleType`,
+     *                     and the second element in the tuple is the float that represents the weight
+     *                     of the collectible.
+     */
+    registerCustomItemPool(itemPoolTypeCustom: ItemPoolType, collectibles: WeightedArray<CollectibleType>): void;
+    /**
+     * Helper function to get a new collectible from a custom item pool created with the
+     * `registerCustomItemPool` function. This function has the same format as the
+     * `ItemPool.GetCollectible` method.
+     *
+     * By default, a collectible will not be removed from the pool once it is selected, unless the
+     * `decrease` argument is set to true (similar to how a vanilla item pool works).
+     *
+     * @param itemPoolTypeCustom An integer representing the custom item pool to use.
+     * @param decrease Optional. Whether or not to remove the selected collectible from the item pool.
+     *                 Default is true.
+     * @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided,
+     *                  the `RNG.Next` method will be called. Default is `getRandomSeed()`.
+     * @param defaultItem Optional. The collectible to return if the item pool is depleted. Default is
+     *                    `CollectibleType.NULL`.
+     */
+    getCustomItemPoolCollectible(itemPoolTypeCustom: ItemPoolType, decrease?: boolean, seedOrRNG?: Seed | RNG, defaultItem?: CollectibleType): CollectibleType;
+}
+//# sourceMappingURL=CustomItemPools.d.ts.map

package/dist/src/classes/features/other/CustomItemPools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomItemPools.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomItemPools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO7E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,qBAAa,eAAgB,SAAQ,OAAO;IAQ1C,OAAO,CAAC,iBAAiB,CAGrB;IAeJ,OAAO,CAAC,wBAAwB,CAM9B;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IAEI,sBAAsB,CAC3B,kBAAkB,EAAE,YAAY,EAChC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,GAC3C,IAAI;IAUP;;;;;;;;;;;;;;;OAeG;IAEI,4BAA4B,CACjC,kBAAkB,EAAE,YAAY,EAChC,QAAQ,UAAQ,EAChB,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,WAAW,kBAAuB,GACjC,eAAe;CAuBnB"}

package/dist/src/classes/features/other/CustomItemPools.lua

@@ -0,0 +1,72 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Decorate = ____lualib.__TS__Decorate
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____array = require("src.functions.array")
+local arrayRemoveIndexInPlace = ____array.arrayRemoveIndexInPlace
+local ____map = require("src.functions.map")
+local copyMap = ____map.copyMap
+local ____rng = require("src.functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+local ____weighted = require("src.functions.weighted")
+local getRandomIndexFromWeightedArray = ____weighted.getRandomIndexFromWeightedArray
+local ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+____exports.CustomItemPools = __TS__Class()
+local CustomItemPools = ____exports.CustomItemPools
+CustomItemPools.name = "CustomItemPools"
+__TS__ClassExtends(CustomItemPools, Feature)
+function CustomItemPools.prototype.____constructor(self)
+    Feature.prototype.____constructor(self)
+    self.v = {run = {customItemPools = __TS__New(Map)}}
+    self.customItemPoolMap = __TS__New(Map)
+    self.postGameStartedReordered = function(____, isContinued)
+        if isContinued then
+            return
+        end
+        self.v.run.customItemPools = copyMap(nil, self.customItemPoolMap)
+    end
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_GAME_STARTED_REORDERED, {self.postGameStartedReordered}}}
+end
+function CustomItemPools.prototype.registerCustomItemPool(self, itemPoolTypeCustom, collectibles)
+    if self.customItemPoolMap:has(itemPoolTypeCustom) then
+        error(("Failed to register a custom item pool since the provided type of " .. tostring(itemPoolTypeCustom)) .. " was already registered.")
+    end
+    self.customItemPoolMap:set(itemPoolTypeCustom, collectibles)
+end
+function CustomItemPools.prototype.getCustomItemPoolCollectible(self, itemPoolTypeCustom, decrease, seedOrRNG, defaultItem)
+    if decrease == nil then
+        decrease = false
+    end
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if defaultItem == nil then
+        defaultItem = CollectibleType.NULL
+    end
+    local customItemPool = self.v.run.customItemPools:get(itemPoolTypeCustom)
+    if customItemPool == nil then
+        error("Failed to find the custom item pool of: " .. tostring(itemPoolTypeCustom))
+    end
+    if #customItemPool == 0 then
+        return defaultItem
+    end
+    local randomIndex = getRandomIndexFromWeightedArray(nil, customItemPool, seedOrRNG)
+    local tuple = customItemPool[randomIndex + 1]
+    if decrease then
+        arrayRemoveIndexInPlace(nil, customItemPool, randomIndex)
+    end
+    return tuple[1]
+end
+__TS__Decorate({Exported}, CustomItemPools.prototype, "registerCustomItemPool", true)
+__TS__Decorate({Exported}, CustomItemPools.prototype, "getCustomItemPoolCollectible", true)
+return ____exports

package/dist/src/classes/features/other/CustomPickups.d.ts

@@ -0,0 +1,34 @@
+import { PickupVariant } from "isaac-typescript-definitions";
+import { Feature } from "../../private/Feature";
+export declare class CustomPickups extends Feature {
+    /** Indexed by entity ID. */
+    private customPickupFunctionsMap;
+    private prePickupCollision;
+    private postEffectRenderPickupEffect;
+    /**
+     * Helper function to register a custom pickup with the IsaacScript standard library. Use this
+     * feature for custom pickups that are intended to be picked up by the player, like bombs and
+     * keys.
+     *
+     * When IsaacScript detects that a player should be collecting the custom pickup, then the pickup
+     * will be immediately removed, and an effect showing the pickup's respective `Collect` animation
+     * will be spawned. (This emulates how a normal vanilla pickup would work.) After that, the
+     * provided `collectFunc` will be fired. In this function, you will probably want to play a sound
+     * corresponding to what kind of pickup it is (e.g. `SoundEffect.KEY_PICKUP_GAUNTLET`), as well as
+     * do things like adding something to the player's inventory.
+     *
+     * Note that when you specify your custom pickup in the "entities2.xml" file, it should have a
+     * type of "5" and be associated with an anm2 file that has a "Collect" animation.
+     *
+     * @param pickupVariantCustom The variant for the corresponding custom pickup.
+     * @param subType The sub-type for the corresponding custom pickup.
+     * @param collectFunc The function to run when the player collects this pickup.
+     * @param collisionFunc Optional. The function to run when a player collides with the pickup.
+     *                      Default is a function that always returns true, meaning that the player
+     *                      will always immediately collect the pickup when they collide with it.
+     *                      Specify this function if your pickup should only be able to be collected
+     *                      under certain conditions.
+     */
+    registerCustomPickup(pickupVariantCustom: PickupVariant, subType: int, collectFunc: (this: void, player: EntityPlayer) => void, collisionFunc?: (this: void, player: EntityPlayer) => boolean): void;
+}
+//# sourceMappingURL=CustomPickups.d.ts.map

package/dist/src/classes/features/other/CustomPickups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomPickups.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomPickups.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,aAAa,EACd,MAAM,8BAA8B,CAAC;AAStC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAkBhD,qBAAa,aAAc,SAAQ,OAAO;IACxC,4BAA4B;IAC5B,OAAO,CAAC,wBAAwB,CAA4C;IAgB5E,OAAO,CAAC,kBAAkB,CAqCxB;IAKF,OAAO,CAAC,4BAA4B,CASlC;IAEF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAEI,oBAAoB,CACzB,mBAAmB,EAAE,aAAa,EAClC,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EACvD,aAAa,GAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,KAAK,OAAoB,GACxE,IAAI;CAYR"}

package/dist/src/classes/features/other/CustomPickups.lua

@@ -0,0 +1,84 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__Decorate = ____lualib.__TS__Decorate
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____LadderSubTypeCustom = require("src.enums.LadderSubTypeCustom")
+local LadderSubTypeCustom = ____LadderSubTypeCustom.LadderSubTypeCustom
+local ____entities = require("src.functions.entities")
+local getEntityID = ____entities.getEntityID
+local getEntityIDFromConstituents = ____entities.getEntityIDFromConstituents
+local ____entitiesSpecific = require("src.functions.entitiesSpecific")
+local spawnEffect = ____entitiesSpecific.spawnEffect
+local ____types = require("src.functions.types")
+local asNumber = ____types.asNumber
+local ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+--- Normally, we would make a custom entity to represent a fading-away pickup, 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 PICKUP_EFFECT_VARIANT = EffectVariant.LADDER
+local PICKUP_EFFECT_SUB_TYPE = LadderSubTypeCustom.CUSTOM_PICKUP
+____exports.CustomPickups = __TS__Class()
+local CustomPickups = ____exports.CustomPickups
+CustomPickups.name = "CustomPickups"
+__TS__ClassExtends(CustomPickups, Feature)
+function CustomPickups.prototype.____constructor(self)
+    Feature.prototype.____constructor(self)
+    self.customPickupFunctionsMap = __TS__New(Map)
+    self.prePickupCollision = function(____, pickup, collider)
+        local entityID = getEntityID(nil, pickup)
+        local customPickupFunctions = self.customPickupFunctionsMap:get(entityID)
+        if customPickupFunctions == nil then
+            return nil
+        end
+        local player = collider:ToPlayer()
+        if player == nil then
+            return nil
+        end
+        local shouldPickup = customPickupFunctions.collisionFunc(player)
+        if not shouldPickup then
+            return nil
+        end
+        pickup:Remove()
+        local pickupSprite = pickup:GetSprite()
+        local fileName = pickupSprite:GetFilename()
+        local effect = spawnEffect(nil, PICKUP_EFFECT_VARIANT, PICKUP_EFFECT_SUB_TYPE, pickup.Position)
+        local effectSprite = effect:GetSprite()
+        effectSprite:Load(fileName, true)
+        effectSprite:Play("Collect", true)
+        customPickupFunctions.collectFunc(player)
+        return nil
+    end
+    self.postEffectRenderPickupEffect = function(____, effect)
+        if effect.SubType ~= asNumber(nil, PICKUP_EFFECT_SUB_TYPE) then
+            return
+        end
+        local sprite = effect:GetSprite()
+        if sprite:IsFinished("Collect") then
+            effect:Remove()
+        end
+    end
+    self.callbacksUsed = {{ModCallback.PRE_PICKUP_COLLISION, {self.prePickupCollision}}, {ModCallback.POST_EFFECT_RENDER, {self.postEffectRenderPickupEffect, PICKUP_EFFECT_VARIANT}}}
+end
+function CustomPickups.prototype.registerCustomPickup(self, pickupVariantCustom, subType, collectFunc, collisionFunc)
+    if collisionFunc == nil then
+        collisionFunc = function() return true end
+    end
+    local entityID = getEntityIDFromConstituents(nil, EntityType.PICKUP, pickupVariantCustom, subType)
+    local customPickupFunctions = {collectFunc = collectFunc, collisionFunc = collisionFunc}
+    self.customPickupFunctionsMap:set(entityID, customPickupFunctions)
+end
+__TS__Decorate({Exported}, CustomPickups.prototype, "registerCustomPickup", true)
+return ____exports

package/dist/src/classes/features/other/CustomStages.d.ts

@@ -0,0 +1,48 @@
+import { Feature } from "../../private/Feature";
+export declare class CustomStages extends Feature {
+    /** Indexed by custom stage name. */
+    private customStagesMap;
+    /** Indexed by room variant. */
+    private customStageCachedRoomData;
+    private customGridEntities;
+    private customTrapdoors;
+    private disableAllSound;
+    private gameReorderedCallbacks;
+    private pause;
+    private runInNFrames;
+    private initCustomStageMetadata;
+    private initRoomTypeMap;
+    private initCustomTrapdoorDestination;
+    private goToCustomStage;
+    private postRender;
+    private postCurseEval;
+    private getShaderParams;
+    private postGridEntityBrokenRockAlt;
+    private postGridEntityInit;
+    private postNewRoomReordered;
+    /** Pick a custom room for each vanilla room. */
+    private setStageRoomsData;
+    /**
+     * 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 streakText Optional. Whether to show the streak text at the top of the screen that
+     *                   announces the name of the level. Default is true.
+     * @param verbose Optional. Whether to log additional information about the rooms that are chosen.
+     *                Default is false.
+     */
+    setCustomStage(name: string, firstFloor?: boolean, streakText?: boolean, verbose?: boolean): void;
+    /**
+     * Helper function to disable the custom stage. This is typically called before taking the player
+     * to a vanilla floor.
+     */
+    disableCustomStage(): void;
+}
+//# sourceMappingURL=CustomStages.d.ts.map

package/dist/src/classes/features/other/CustomStages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomStages.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomStages.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAoChD,qBAAa,YAAa,SAAQ,OAAO;IA8BvC,oCAAoC;IACpC,OAAO,CAAC,eAAe,CAAkC;IAEzD,+BAA+B;IAC/B,OAAO,CAAC,yBAAyB,CAAwC;IAEzE,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAe;IA+CnC,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,eAAe,CAMrB;IAGF,OAAO,CAAC,UAAU,CAQhB;IAGF,OAAO,CAAC,aAAa,CAcnB;IAGF,OAAO,CAAC,eAAe,CAUrB;IAIF,OAAO,CAAC,2BAA2B,CAejC;IAGF,OAAO,CAAC,kBAAkB,CAqBxB;IAGF,OAAO,CAAC,oBAAoB,CAe1B;IAEF,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IA+FzB;;;;;;;;;;;;;;;OAeG;IAEI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI;IAoEP;;;OAGG;IAEI,kBAAkB,IAAI,IAAI;CAGlC"}

package/dist/src/classes/features/other/CustomStages.lua

@@ -0,0 +1,359 @@
+local ____lualib = require("lualib_bundle")
+local __TS__Class = ____lualib.__TS__Class
+local __TS__ClassExtends = ____lualib.__TS__ClassExtends
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local __TS__Decorate = ____lualib.__TS__Decorate
+local ____exports = {}
+local getRoomTypeMap
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlot = ____isaac_2Dtypescript_2Ddefinitions.DoorSlot
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
+local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
+local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
+local StageType = ____isaac_2Dtypescript_2Ddefinitions.StageType
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local metadataJSON = require("src.customStageMetadata")
+local ____decorators = require("src.decorators")
+local Exported = ____decorators.Exported
+local ____ISCFeature = require("src.enums.ISCFeature")
+local ISCFeature = ____ISCFeature.ISCFeature
+local ____ModCallbackCustom = require("src.enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____UIStreakAnimation = require("src.enums.private.UIStreakAnimation")
+local UIStreakAnimation = ____UIStreakAnimation.UIStreakAnimation
+local ____array = require("src.functions.array")
+local isArray = ____array.isArray
+local ____doors = require("src.functions.doors")
+local doorSlotFlagsToDoorSlots = ____doors.doorSlotFlagsToDoorSlots
+local ____flag = require("src.functions.flag")
+local hasFlag = ____flag.hasFlag
+local removeFlag = ____flag.removeFlag
+local ____logMisc = require("src.functions.logMisc")
+local logError = ____logMisc.logError
+local ____rng = require("src.functions.rng")
+local newRNG = ____rng.newRNG
+local ____rockAlt = require("src.functions.rockAlt")
+local removeUrnRewards = ____rockAlt.removeUrnRewards
+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 ____Feature = require("src.classes.private.Feature")
+local Feature = ____Feature.Feature
+local ____backdrop = require("src.classes.features.other.customStages.backdrop")
+local setCustomStageBackdrop = ____backdrop.setCustomStageBackdrop
+local ____constants = require("src.classes.features.other.customStages.constants")
+local CUSTOM_FLOOR_STAGE = ____constants.CUSTOM_FLOOR_STAGE
+local CUSTOM_FLOOR_STAGE_TYPE = ____constants.CUSTOM_FLOOR_STAGE_TYPE
+local DEFAULT_BASE_STAGE = ____constants.DEFAULT_BASE_STAGE
+local DEFAULT_BASE_STAGE_TYPE = ____constants.DEFAULT_BASE_STAGE_TYPE
+local ____gridEntities = require("src.classes.features.other.customStages.gridEntities")
+local convertVanillaTrapdoors = ____gridEntities.convertVanillaTrapdoors
+local setCustomDecorationGraphics = ____gridEntities.setCustomDecorationGraphics
+local setCustomDoorGraphics = ____gridEntities.setCustomDoorGraphics
+local setCustomPitGraphics = ____gridEntities.setCustomPitGraphics
+local setCustomRockGraphics = ____gridEntities.setCustomRockGraphics
+local ____shadows = require("src.classes.features.other.customStages.shadows")
+local setShadows = ____shadows.setShadows
+local ____streakText = require("src.classes.features.other.customStages.streakText")
+local streakTextGetShaderParams = ____streakText.streakTextGetShaderParams
+local streakTextPostRender = ____streakText.streakTextPostRender
+local topStreakTextStart = ____streakText.topStreakTextStart
+local ____utils = require("src.classes.features.other.customStages.utils")
+local getRandomBossRoomFromPool = ____utils.getRandomBossRoomFromPool
+local getRandomCustomStageRoom = ____utils.getRandomCustomStageRoom
+local ____versusScreen = require("src.classes.features.other.customStages.versusScreen")
+local playVersusScreenAnimation = ____versusScreen.playVersusScreenAnimation
+local versusScreenPostRender = ____versusScreen.versusScreenPostRender
+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
+____exports.CustomStages = __TS__Class()
+local CustomStages = ____exports.CustomStages
+CustomStages.name = "CustomStages"
+__TS__ClassExtends(CustomStages, Feature)
+function CustomStages.prototype.____constructor(self, customGridEntities, customTrapdoors, disableAllSound, gameReorderedCallbacks, pause, runInNFrames)
+    Feature.prototype.____constructor(self)
+    self.v = {run = {
+        currentCustomStage = nil,
+        firstFloor = true,
+        showingBossVersusScreen = false,
+        controllerIndexPushingMapRenderFrame = __TS__New(Map),
+        topStreakTextStartedRenderFrame = nil,
+        topStreakText = {animation = UIStreakAnimation.NONE, frame = 0, pauseFrame = false},
+        bottomStreakText = {animation = UIStreakAnimation.NONE, frame = 0, pauseFrame = false}
+    }}
+    self.customStagesMap = __TS__New(Map)
+    self.customStageCachedRoomData = __TS__New(Map)
+    self.goToCustomStage = function(____, destinationStage, _destinationStageType)
+        local firstFloor = destinationStage == LevelStage.BASEMENT_1
+        self:setCustomStage("Slaughterhouse", firstFloor)
+    end
+    self.postRender = function()
+        local customStage = self.v.run.currentCustomStage
+        if customStage == nil then
+            return
+        end
+        streakTextPostRender(nil, self.v)
+        versusScreenPostRender(nil, self.v, self.pause, self.disableAllSound)
+    end
+    self.postCurseEval = function(____, curses)
+        local customStage = self.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
+    self.getShaderParams = function(____, shaderName)
+        local customStage = self.v.run.currentCustomStage
+        if customStage == nil then
+            return
+        end
+        streakTextGetShaderParams(nil, self.v, customStage, shaderName)
+        return nil
+    end
+    self.postGridEntityBrokenRockAlt = function(____, gridEntity)
+        local customStage = self.v.run.currentCustomStage
+        if customStage == nil then
+            return
+        end
+        if customStage.rocksPNGPath == nil then
+            return
+        end
+        removeUrnRewards(nil, gridEntity)
+    end
+    self.postGridEntityInit = function(____, gridEntity)
+        local customStage = self.v.run.currentCustomStage
+        if customStage == nil then
+            return
+        end
+        if self.customGridEntities:isCustomGridEntity(gridEntity) then
+            return
+        end
+        setCustomDecorationGraphics(nil, customStage, gridEntity)
+        setCustomRockGraphics(nil, customStage, gridEntity)
+        setCustomPitGraphics(nil, customStage, gridEntity)
+        setCustomDoorGraphics(nil, customStage, gridEntity)
+        convertVanillaTrapdoors(
+            nil,
+            customStage,
+            gridEntity,
+            self.v.run.firstFloor,
+            self.customTrapdoors
+        )
+    end
+    self.postNewRoomReordered = function()
+        local customStage = self.v.run.currentCustomStage
+        if customStage == nil then
+            return
+        end
+        setCustomStageBackdrop(nil, customStage)
+        setShadows(nil, customStage)
+        playVersusScreenAnimation(
+            nil,
+            self.v,
+            customStage,
+            self.disableAllSound,
+            self.pause,
+            self.runInNFrames
+        )
+    end
+    self.featuresUsed = {
+        ISCFeature.CUSTOM_GRID_ENTITIES,
+        ISCFeature.CUSTOM_TRAPDOORS,
+        ISCFeature.DISABLE_ALL_SOUND,
+        ISCFeature.GAME_REORDERED_CALLBACKS,
+        ISCFeature.PAUSE,
+        ISCFeature.RUN_IN_N_FRAMES
+    }
+    self.callbacksUsed = {{ModCallback.POST_RENDER, {self.postRender}}, {ModCallback.POST_CURSE_EVAL, {self.postCurseEval}}, {ModCallback.GET_SHADER_PARAMS, {self.getShaderParams}}}
+    self.customCallbacksUsed = {{ModCallbackCustom.POST_GRID_ENTITY_BROKEN, {self.postGridEntityBrokenRockAlt, GridEntityType.ROCK_ALT}}, {ModCallbackCustom.POST_GRID_ENTITY_INIT, {self.postGridEntityInit}}, {ModCallbackCustom.POST_NEW_ROOM_REORDERED, {self.postNewRoomReordered}}}
+    self.customGridEntities = customGridEntities
+    self.customTrapdoors = customTrapdoors
+    self.disableAllSound = disableAllSound
+    self.gameReorderedCallbacks = gameReorderedCallbacks
+    self.pause = pause
+    self.runInNFrames = runInNFrames
+    self:initCustomStageMetadata()
+end
+function CustomStages.prototype.initCustomStageMetadata(self)
+    if not isArray(nil, metadataJSON) then
+        error("The IsaacScript standard library attempted to read the custom stage metadata from the \"customStageMetadata.lua\" file, but it was not an array.")
+    end
+    local customStagesLua = metadataJSON
+    for ____, customStageLua in ipairs(customStagesLua) do
+        self:initRoomTypeMap(customStageLua)
+        self:initCustomTrapdoorDestination(customStageLua)
+    end
+end
+function CustomStages.prototype.initRoomTypeMap(self, customStageLua)
+    local roomTypeMap = getRoomTypeMap(nil, customStageLua)
+    local customStage = __TS__ObjectAssign({}, customStageLua, {roomTypeMap = roomTypeMap})
+    self.customStagesMap:set(customStage.name, customStage)
+end
+function CustomStages.prototype.initCustomTrapdoorDestination(self, customStageLua)
+    self.customTrapdoors:registerCustomTrapdoorDestination(customStageLua.name, self.goToCustomStage)
+end
+function CustomStages.prototype.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 __continue26
+            end
+            if room.Data == nil then
+                goto __continue26
+            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 __continue26
+            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 __continue26
+            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 __continue26
+            end
+            local randomRoom
+            if roomType == RoomType.BOSS then
+                if customStage.bossPool == nil then
+                    goto __continue26
+                end
+                randomRoom = getRandomBossRoomFromPool(
+                    nil,
+                    roomsMetadata,
+                    customStage.bossPool,
+                    rng,
+                    verbose
+                )
+            else
+                randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
+            end
+            local newRoomData = self.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 __continue26
+                end
+                self.customStageCachedRoomData:set(randomRoom.variant, newRoomData)
+            end
+            room.Data = newRoomData
+        end
+        ::__continue26::
+    end
+end
+function CustomStages.prototype.setCustomStage(self, name, firstFloor, streakText, verbose)
+    if firstFloor == nil then
+        firstFloor = true
+    end
+    if streakText == nil then
+        streakText = true
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local customStage = self.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)
+    self.v.run.currentCustomStage = customStage
+    self.v.run.firstFloor = firstFloor
+    if stage == CUSTOM_FLOOR_STAGE then
+        level:SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL)
+    end
+    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+    if not firstFloor then
+        baseStage = baseStage + 1
+    end
+    local baseStageType = customStage.baseStageType == nil and DEFAULT_BASE_STAGE_TYPE or customStage.baseStageType
+    local reseed = asNumber(nil, stage) >= baseStage
+    setStage(nil, baseStage, baseStageType, reseed)
+    self:setStageRoomsData(customStage, rng, verbose)
+    local targetStage = CUSTOM_FLOOR_STAGE
+    local targetStageType = CUSTOM_FLOOR_STAGE_TYPE
+    level:SetStage(targetStage, targetStageType)
+    self.gameReorderedCallbacks:reorderedCallbacksSetStage(targetStage, targetStageType)
+    if streakText then
+        self.runInNFrames:runNextGameFrame(function()
+            topStreakTextStart(nil, self.v)
+        end)
+    end
+end
+function CustomStages.prototype.disableCustomStage(self)
+    self.v.run.currentCustomStage = nil
+end
+__TS__Decorate({Exported}, CustomStages.prototype, "setCustomStage", true)
+__TS__Decorate({Exported}, CustomStages.prototype, "disableCustomStage", true)
+return ____exports