isaacscript-common 6.20.2 → 6.22.1

package/dist/features/customStage/backdrop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/backdrop.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA0E3D,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAc1D"}
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/backdrop.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AA2EnE,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAc1D"}

package/dist/features/customStage/backdrop.lua

@@ -2,15 +2,15 @@ local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local getBackdropPNGPath, spawnWallEntity, spawnSecondWallEntity, spawnFloorEntity, getNumFloorLayers, BackdropKind, DEFAULT_BACKDROP, ROOM_SHAPE_WALL_ANM2_LAYERS, ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS, WALL_OFFSET, L_FLOOR_ANM2_LAYERS, N_FLOOR_ANM2_LAYERS, BACKDROP_EFFECT_VARIANT
+local getBackdropPNGPath, spawnWallEntity, spawnSecondWallEntity, spawnFloorEntity, getNumFloorLayers, BackdropKind, DEFAULT_BACKDROP, ROOM_SHAPE_WALL_ANM2_LAYERS, ROOM_SHAPE_WALL_EXTRA_ANM2_LAYERS, WALL_OFFSET, L_FLOOR_ANM2_LAYERS, N_FLOOR_ANM2_LAYERS, BACKDROP_EFFECT_VARIANT, BACKDROP_EFFECT_SUBTYPE
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
 local EntityFlag = ____isaac_2Dtypescript_2Ddefinitions.EntityFlag
 local RoomShape = ____isaac_2Dtypescript_2Ddefinitions.RoomShape
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
-local ____cachedClasses = require("cachedClasses")
+local ____cachedClasses = require("core.cachedClasses")
 local game = ____cachedClasses.game
-local ____constants = require("constants")
+local ____constants = require("core.constants")
 local VectorZero = ____constants.VectorZero
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
@@ -39,7 +39,7 @@ function spawnWallEntity(self, customStage, rng, isExtraWall)
     local wallEffect = spawnEffectWithSeed(
         nil,
         BACKDROP_EFFECT_VARIANT,
-        0,
+        BACKDROP_EFFECT_SUBTYPE,
         VectorZero,
         1
     )
@@ -177,6 +177,7 @@ WALL_OFFSET = Vector(-80, -80)
 L_FLOOR_ANM2_LAYERS = {16, 17}
 N_FLOOR_ANM2_LAYERS = {18, 19}
 BACKDROP_EFFECT_VARIANT = EffectVariant.LADDER
+BACKDROP_EFFECT_SUBTYPE = 101
 local BACKDROP_ROOM_TYPE_SET = __TS__New(Set, {RoomType.DEFAULT, RoomType.BOSS, RoomType.MINI_BOSS})
 function ____exports.setBackdrop(self, customStage)
     local room = game:GetRoom()

package/dist/features/customStage/customStageConstants.d.ts

@@ -1,2 +1,13 @@
+/// <reference types="isaac-typescript-definitions" />
 export declare const ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage";
+/** Corresponds to "ui_streak.anm2". */
+export declare enum UIStreakAnimation {
+    NONE = 0,
+    TEXT = 1,
+    TEXT_STAY = 2
+}
+/** Corresponds to "ui_streak.anm2". */
+export declare const UI_STREAK_ANIMATION_END_FRAMES: {
+    readonly [key in UIStreakAnimation]: int;
+};
 //# sourceMappingURL=customStageConstants.d.ts.map

package/dist/features/customStage/customStageConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,iCAAiC,CAAC"}
+{"version":3,"file":"customStageConstants.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageConstants.ts"],"names":[],"mappings":";AAAA,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,oBAAY,iBAAiB;IAC3B,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,SAAS,IAAA;CACV;AAED,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,EAAE;IAC3C,QAAQ,EAAE,GAAG,IAAI,iBAAiB,GAAG,GAAG;CAKhC,CAAC"}

package/dist/features/customStage/customStageConstants.lua

@@ -1,3 +1,13 @@
 local ____exports = {}
 ____exports.ISAACSCRIPT_CUSTOM_STAGE_GFX_PATH = "gfx/isaacscript-custom-stage"
+--- Corresponds to "ui_streak.anm2".
+____exports.UIStreakAnimation = {}
+____exports.UIStreakAnimation.NONE = 0
+____exports.UIStreakAnimation[____exports.UIStreakAnimation.NONE] = "NONE"
+____exports.UIStreakAnimation.TEXT = 1
+____exports.UIStreakAnimation[____exports.UIStreakAnimation.TEXT] = "TEXT"
+____exports.UIStreakAnimation.TEXT_STAY = 2
+____exports.UIStreakAnimation[____exports.UIStreakAnimation.TEXT_STAY] = "TEXT_STAY"
+--- Corresponds to "ui_streak.anm2".
+____exports.UI_STREAK_ANIMATION_END_FRAMES = {[____exports.UIStreakAnimation.NONE] = 0, [____exports.UIStreakAnimation.TEXT] = 69, [____exports.UIStreakAnimation.TEXT_STAY] = 1}
 return ____exports

package/dist/features/customStage/customStageGridEntities.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="isaac-typescript-definitions" />
-import { CustomStage } from "../../interfaces/CustomStage";
+import { CustomStage } from "../../interfaces/private/CustomStage";
 /** For `GridEntityType.DECORATION` (1) */
 export declare function setCustomDecorationGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
 /** For `GridEntityType.ROCK` (2) */
@@ -8,6 +8,7 @@ export declare function setCustomRockGraphics(customStage: CustomStage, gridEnti
 export declare function setCustomPitGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
 /** For GridEntityType.DOOR (16) */
 export declare function setCustomDoorGraphics(customStage: CustomStage, gridEntity: GridEntity): void;
+export declare function convertVanillaTrapdoors(customStage: CustomStage, gridEntity: GridEntity): void;
 /**
  * The rewards are based on the ones from the wiki:
  * https://bindingofisaacrebirth.fandom.com/wiki/Rocks#Urns

package/dist/features/customStage/customStageGridEntities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAoBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAgBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAaN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAQN;AAuDD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}
+{"version":3,"file":"customStageGridEntities.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/customStageGridEntities.ts"],"names":[],"mappings":";AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMnE,0CAA0C;AAC1C,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAyBN;AAED,oCAAoC;AACpC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAqBN;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAkBN;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAmBN;AAuDD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN"}

package/dist/features/customStage/customStageGridEntities.lua

@@ -5,6 +5,7 @@ local getNewDoorPNGPath, removeEntitiesSpawnedFromGridEntity
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____DecorationVariant = require("enums.DecorationVariant")
 local DecorationVariant = ____DecorationVariant.DecorationVariant
@@ -12,17 +13,27 @@ local ____entities = require("functions.entities")
 local removeEntities = ____entities.removeEntities
 local ____entitiesSpecific = require("functions.entitiesSpecific")
 local getNPCs = ____entitiesSpecific.getNPCs
+local ____gridEntities = require("functions.gridEntities")
+local removeGridEntity = ____gridEntities.removeGridEntity
 local ____pickupsSpecific = require("functions.pickupsSpecific")
 local getCoins = ____pickupsSpecific.getCoins
 local getCollectibles = ____pickupsSpecific.getCollectibles
 local getTrinkets = ____pickupsSpecific.getTrinkets
+local ____stage = require("functions.stage")
+local calculateStageType = ____stage.calculateStageType
 local ____vector = require("functions.vector")
 local vectorEquals = ____vector.vectorEquals
+local ____exports = require("features.customTrapdoor.exports")
+local spawnCustomTrapdoor = ____exports.spawnCustomTrapdoor
+local ____exports = require("features.customStage.exports")
+local DEFAULT_BASE_STAGE = ____exports.DEFAULT_BASE_STAGE
+local ____v = require("features.customStage.v")
+local v = ____v.default
 function getNewDoorPNGPath(self, customStage, fileName)
     repeat
-        local ____switch16 = fileName
-        local ____cond16 = ____switch16 == "gfx/grid/door_01_normaldoor.anm2"
-        if ____cond16 then
+        local ____switch21 = fileName
+        local ____cond21 = ____switch21 == "gfx/grid/door_01_normaldoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_normal_0 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_normal_0 ~= nil then
@@ -31,8 +42,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_normal_0
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_02_treasureroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_02_treasureroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_treasureRoom_2 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_treasureRoom_2 ~= nil then
@@ -41,8 +52,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_treasureRoom_2
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_03_ambushroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_03_ambushroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_normalChallengeRoom_4 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_normalChallengeRoom_4 ~= nil then
@@ -51,8 +62,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_normalChallengeRoom_4
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_04_selfsacrificeroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_04_selfsacrificeroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_curseRoom_6 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_curseRoom_6 ~= nil then
@@ -61,8 +72,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_curseRoom_6
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_05_arcaderoomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_05_arcaderoomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_arcade_8 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_arcade_8 ~= nil then
@@ -71,8 +82,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_arcade_8
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_07_devilroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_07_devilroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_devilRoom_10 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_devilRoom_10 ~= nil then
@@ -81,8 +92,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_devilRoom_10
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_07_holyroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_07_holyroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_angelRoom_12 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_angelRoom_12 ~= nil then
@@ -91,8 +102,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_angelRoom_12
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_08_holeinwall.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_08_holeinwall.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_secretRoom_14 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_secretRoom_14 ~= nil then
@@ -101,8 +112,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_secretRoom_14
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_09_bossambushroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_09_bossambushroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_bossChallengeRoom_16 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_bossChallengeRoom_16 ~= nil then
@@ -111,8 +122,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_bossChallengeRoom_16
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_10_bossroomdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_10_bossroomdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_bossRoom_18 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_bossRoom_18 ~= nil then
@@ -121,8 +132,8 @@ function getNewDoorPNGPath(self, customStage, fileName)
                 return ____customStage_doorPNGPaths_bossRoom_18
             end
         end
-        ____cond16 = ____cond16 or ____switch16 == "gfx/grid/door_15_bossrushdoor.anm2"
-        if ____cond16 then
+        ____cond21 = ____cond21 or ____switch21 == "gfx/grid/door_15_bossrushdoor.anm2"
+        if ____cond21 then
             do
                 local ____customStage_doorPNGPaths_bossRush_20 = customStage.doorPNGPaths
                 if ____customStage_doorPNGPaths_bossRush_20 ~= nil then
@@ -146,6 +157,10 @@ function ____exports.setCustomDecorationGraphics(self, customStage, gridEntity)
     if customStage.decorationsPNGPath == nil then
         return
     end
+    local gridEntityType = gridEntity:GetType()
+    if gridEntityType ~= GridEntityType.DECORATION then
+        return
+    end
     local variant = gridEntity:GetVariant()
     if variant ~= DecorationVariant.VANILLA_DECORATION then
         return
@@ -162,6 +177,10 @@ function ____exports.setCustomRockGraphics(self, customStage, gridEntity)
     if customStage.rocksPNGPath == nil then
         return
     end
+    local gridEntityRock = gridEntity:ToRock()
+    if gridEntityRock == nil then
+        return
+    end
     local sprite = gridEntity:GetSprite()
     local fileName = sprite:GetFilename()
     if fileName == "gfx/grid/grid_rock.anm2" then
@@ -177,6 +196,10 @@ function ____exports.setCustomPitGraphics(self, customStage, gridEntity)
     if customStage.pitsPNGPath == nil then
         return
     end
+    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
@@ -186,6 +209,13 @@ function ____exports.setCustomPitGraphics(self, customStage, gridEntity)
 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)
@@ -194,6 +224,18 @@ function ____exports.setCustomDoorGraphics(self, customStage, gridEntity)
         sprite:LoadGraphics()
     end
 end
+function ____exports.convertVanillaTrapdoors(self, customStage, gridEntity)
+    local gridEntityType = gridEntity:GetType()
+    if gridEntityType ~= GridEntityType.TRAPDOOR then
+        return
+    end
+    removeGridEntity(nil, gridEntity, true)
+    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
+    local vanillaNextStage = baseStage + 2
+    local vanillaNextStageType = calculateStageType(nil, vanillaNextStage)
+    local destination = v.run.firstFloor and ({customStage.name, 2}) or ({vanillaNextStage, vanillaNextStageType})
+    spawnCustomTrapdoor(nil, gridEntity.Position, destination)
+end
 --- The rewards are based on the ones from the wiki:
 -- https://bindingofisaacrebirth.fandom.com/wiki/Rocks#Urns
 -- 

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

@@ -1,4 +1,14 @@
-import { EntityType } from "isaac-typescript-definitions";
+/**
+ * These are helper functions relating to creating custom stages with the built-in standard library.
+ * For more information about custom stages, see the [main
+ * documentation page](https://isaacscript.github.io/main/custom-stages).
+ *
+ * @module
+ */
+import { EntityType, LevelStage, StageType } from "isaac-typescript-definitions";
+export declare const DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2;
+export declare const DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL;
+export declare const INVALID_STAGE_VALUE: LevelStage;
 /**
  * Helper function to warp to a custom stage/level.
  *
@@ -6,12 +16,13 @@ import { EntityType } from "isaac-typescript-definitions";
  * 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 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.
+ * @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.
  */
-export declare function setCustomStage(name: string, _firstFloor?: boolean, verbose?: boolean): void;
-export declare function setCustomStageDebug(): void;
+export declare function setCustomStage(name: string, firstFloor?: boolean, verbose?: boolean): void;
 /**
  * By default, unknown bosses will be drawn on the boss "versus" screen as "???". If your custom
  * stage has custom bosses, you can use this function to register the corresponding graphic file
@@ -38,4 +49,9 @@ export declare function setCustomStageDebug(): void;
  *                        will be displayed on the right side of the boss "versus" screen.
  */
 export declare function registerCustomBoss(entityType: EntityType, variant: int, subType: int, namePNGPath: string, portraitPNGPath: string): void;
+/**
+ * Helper function to disable the custom stage. This is typically called before taking the player to
+ * a vanilla floor.
+ */
+export declare function disableCustomStage(): void;
 //# sourceMappingURL=exports.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAKX,MAAM,8BAA8B,CAAC;AAsBtC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,UAAO,EAClB,OAAO,UAAQ,GACd,IAAI,CAyGN;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,IAAI,CAGN"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customStage/exports.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EAGV,SAAS,EACV,MAAM,8BAA8B,CAAC;AAmBtC,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,YAAmB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI,CAwDN;AA4ED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,IAAI,CAGN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/features/customStage/exports.lua

@@ -1,19 +1,19 @@
 local ____lualib = require("lualib_bundle")
 local Map = ____lualib.Map
 local ____exports = {}
+local setStageRoomsData
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
 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 ____cachedClasses = require("cachedClasses")
-local game = ____cachedClasses.game
 local ____reorderedCallbacks = require("callbacks.reorderedCallbacks")
-local reorderedCallbacksSetStage = ____reorderedCallbacks.reorderedCallbacksSetStage
+local reorderedCallbacksSetStageInternal = ____reorderedCallbacks.reorderedCallbacksSetStageInternal
+local ____cachedClasses = require("core.cachedClasses")
+local game = ____cachedClasses.game
 local ____entities = require("functions.entities")
 local getEntityIDFromConstituents = ____entities.getEntityIDFromConstituents
 local ____log = require("functions.log")
-local log = ____log.log
 local logError = ____log.logError
 local ____rng = require("functions.rng")
 local newRNG = ____rng.newRNG
@@ -24,98 +24,104 @@ local ____stage = require("functions.stage")
 local setStage = ____stage.setStage
 local ____customStageUtils = require("features.customStage.customStageUtils")
 local getRandomCustomStageRoom = ____customStageUtils.getRandomCustomStageRoom
-local ____streakText = require("features.customStage.streakText")
-local topStreakTextStart = ____streakText.topStreakTextStart
 local ____v = require("features.customStage.v")
 local v = ____v.default
 local customBossPNGPaths = ____v.customBossPNGPaths
 local customStageCachedRoomData = ____v.customStageCachedRoomData
 local customStagesMap = ____v.customStagesMap
-local DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
-local DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
---- 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 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.
-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
+function setStageRoomsData(self, customStage, rng, verbose)
     local level = game:GetLevel()
     local startingRoomGridIndex = level:GetStartingRoomIndex()
-    local seeds = game:GetSeeds()
-    local startSeed = seeds:GetStartSeed()
-    local rng = newRNG(nil, startSeed)
-    v.run.currentCustomStage = customStage
-    local baseStage = customStage.baseStage == nil and DEFAULT_BASE_STAGE or customStage.baseStage
-    local baseStageType = customStage.baseStageType == nil and DEFAULT_BASE_STAGE_TYPE or customStage.baseStageType
-    setStage(nil, baseStage, baseStageType)
     for ____, room in ipairs(getRoomsInGrid(nil)) do
         do
             if room.SafeGridIndex == startingRoomGridIndex then
-                goto __continue4
+                goto __continue7
             end
             if room.Data == nil then
-                goto __continue4
+                goto __continue7
             end
             local roomType = room.Data.Type
             local roomShapeMap = customStage.roomTypeMap:get(roomType)
             if roomShapeMap == nil then
                 if roomType == RoomType.DEFAULT then
-                    logError((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. name)
+                    logError((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name)
                 end
-                goto __continue4
+                goto __continue7
             end
             local roomShape = room.Data.Shape
             local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
             if roomDoorSlotFlagMap == nil then
-                logError((((((((("Failed to find any custom rooms for RoomType." .. tostring(RoomType[roomType])) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. tostring(RoomShape[roomShape])) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. name)
-                goto __continue4
+                logError((((((((("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((((((((((("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: ") .. name)
-                goto __continue4
+                logError((((((((((("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)
+                goto __continue7
             end
             local randomRoom = getRandomCustomStageRoom(nil, roomsMetadata, rng, verbose)
             local newRoomData = customStageCachedRoomData:get(randomRoom.variant)
             if newRoomData == nil then
                 newRoomData = getRoomDataForTypeVariant(nil, roomType, randomRoom.variant, false)
                 if newRoomData == nil then
-                    logError((("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. name)
-                    goto __continue4
+                    logError((("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
-        ::__continue4::
+        ::__continue7::
     end
-    local stage = -1
-    local stageType = StageType.WRATH_OF_THE_LAMB
-    level:SetStage(stage, stageType)
-    reorderedCallbacksSetStage(nil, stage, stageType)
 end
-function ____exports.setCustomStageDebug(self)
-    local customStage = v.run.currentCustomStage
+____exports.DEFAULT_BASE_STAGE = LevelStage.BASEMENT_2
+____exports.DEFAULT_BASE_STAGE_TYPE = StageType.ORIGINAL
+____exports.INVALID_STAGE_VALUE = -1
+--- 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
-        log("No custom stage is currently loaded.")
-        return
+        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.INVALID_STAGE_VALUE then
+        level:SetStage(LevelStage.BASEMENT_1, StageType.ORIGINAL)
     end
-    topStreakTextStart(nil)
+    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 = stage >= baseStage
+    setStage(nil, baseStage, baseStageType, reseed)
+    setStageRoomsData(nil, customStage, rng, verbose)
+    local targetStage = ____exports.INVALID_STAGE_VALUE
+    local targetStageType = StageType.WRATH_OF_THE_LAMB
+    level:SetStage(targetStage, targetStageType)
+    reorderedCallbacksSetStageInternal(nil, targetStage, targetStageType)
 end
 --- By default, unknown bosses will be drawn on the boss "versus" screen as "???". If your custom
 -- stage has custom bosses, you can use this function to register the corresponding graphic file
@@ -144,4 +150,9 @@ function ____exports.registerCustomBoss(self, entityType, variant, subType, name
     local entityID = getEntityIDFromConstituents(nil, entityType, variant, subType)
     customBossPNGPaths:set(entityID, {namePNGPath, portraitPNGPath})
 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/features/customStage/init.d.ts.map

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

package/dist/features/customStage/init.lua

@@ -3,7 +3,7 @@ local Map = ____lualib.Map
 local __TS__ObjectAssign = ____lualib.__TS__ObjectAssign
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initRoomTypeMaps, getRoomTypeMap, postRender, postCurseEval, postGameStarted, getShaderParams, postGridEntityBrokenRockAlt, postGridEntityBrokenInit, postNewRoomReordered
+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
@@ -20,6 +20,7 @@ local saveDataManager = ____exports.saveDataManager
 local ____backdrop = require("features.customStage.backdrop")
 local setBackdrop = ____backdrop.setBackdrop
 local ____customStageGridEntities = require("features.customStage.customStageGridEntities")
+local convertVanillaTrapdoors = ____customStageGridEntities.convertVanillaTrapdoors
 local removeUrnRewards = ____customStageGridEntities.removeUrnRewards
 local setCustomDecorationGraphics = ____customStageGridEntities.setCustomDecorationGraphics
 local setCustomDoorGraphics = ____customStageGridEntities.setCustomDoorGraphics
@@ -30,8 +31,6 @@ local ____shadows = require("features.customStage.shadows")
 local setShadows = ____shadows.setShadows
 local ____streakText = require("features.customStage.streakText")
 local streakTextGetShaderParams = ____streakText.streakTextGetShaderParams
-local streakTextInit = ____streakText.streakTextInit
-local streakTextPostGameStarted = ____streakText.streakTextPostGameStarted
 local streakTextPostRender = ____streakText.streakTextPostRender
 local ____v = require("features.customStage.v")
 local v = ____v.default
@@ -89,14 +88,11 @@ function postCurseEval(self, curses)
     if customStage == nil then
         return nil
     end
-    if hasFlag(nil, curses, LevelCurse.MAZE) then
-        return removeFlag(nil, curses, LevelCurse.MAZE)
+    if hasFlag(nil, curses, LevelCurse.LABYRINTH) then
+        return removeFlag(nil, curses, LevelCurse.LABYRINTH)
     end
     return nil
 end
-function postGameStarted(self)
-    streakTextPostGameStarted(nil)
-end
 function getShaderParams(self, shaderName)
     local customStage = v.run.currentCustomStage
     if customStage == nil then
@@ -112,7 +108,7 @@ function postGridEntityBrokenRockAlt(self, gridEntity)
     end
     removeUrnRewards(nil, customStage, gridEntity)
 end
-function postGridEntityBrokenInit(self, gridEntity)
+function postGridEntityInit(self, gridEntity)
     local customStage = v.run.currentCustomStage
     if customStage == nil then
         return
@@ -121,6 +117,7 @@ function postGridEntityBrokenInit(self, 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
@@ -137,14 +134,12 @@ function ____exports.customStageInit(self, mod)
         return
     end
     saveDataManager(nil, "customStage", v)
-    streakTextInit(nil)
     versusScreenInit(nil)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
     mod:AddCallback(ModCallback.POST_CURSE_EVAL, postCurseEval)
-    mod:AddCallback(ModCallback.POST_GAME_STARTED, postGameStarted)
     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, postGridEntityBrokenInit)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_GRID_ENTITY_INIT, postGridEntityInit)
     mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
 end
 return ____exports

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

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

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

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