isaacscript-common 30.12.9 → 30.12.11

package/dist/index.rollup.d.ts

@@ -2174,6 +2174,7 @@ declare class CustomStages extends Feature {
     private readonly customStagesMap;
     /** Indexed by room variant. */
     private readonly customStageCachedRoomData;
+    private usingRedKey;
     private readonly customGridEntities;
     private readonly customTrapdoors;
     private readonly disableAllSound;
@@ -2185,8 +2186,18 @@ declare class CustomStages extends Feature {
     private initCustomTrapdoorDestination;
     private readonly goToCustomStage;
     private readonly postRender;
+    /**
+     * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+     * value).
+     */
+    private readonly postUseItemRedKey;
     private readonly postCurseEval;
     private readonly getShaderParams;
+    /**
+     * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+     * value).
+     */
+    private readonly preUseItemRedKey;
     private readonly postGridEntityBrokenRockAlt;
     private readonly postGridEntityInit;
     private readonly postNewRoomReordered;
@@ -4199,6 +4210,19 @@ export declare function fillLevelWithRedRooms(): void;
  */
 export declare function filter<T>(array: T[], func: (value: T, index: number, array: T[]) => boolean): T[];
 
+/**
+ * Helper function to perform a map and a filter at the same time. Similar to `Array.map`, provide a
+ * function that transforms a value, but return `undefined` if the value should be skipped. (Thus,
+ * this function cannot be used in situations where `undefined` can be a valid array element.)
+ *
+ * This function is useful because a map will always produce an array with the same amount of
+ * elements as the original array.
+ *
+ * This is named `filterMap` after the Rust function:
+ * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
+ */
+export declare function filterMap<OldT, NewT>(array: OldT[], func: (element: OldT) => NewT | undefined): NewT[];
+
 /**
  * Helper function for non-TypeScript users to find an element in an array.
  *

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 30.12.9
+isaacscript-common 30.12.11
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -16854,6 +16854,16 @@ end
 function ____exports.emptyArray(self, array)
     __TS__ArraySplice(array, 0, #array)
 end
+function ____exports.filterMap(self, array, func)
+    local newArray = {}
+    for ____, element in ipairs(array) do
+        local newElement = func(nil, element)
+        if newElement ~= nil then
+            newArray[#newArray + 1] = newElement
+        end
+    end
+    return newArray
+end
 function ____exports.getArrayCombinations(self, array, includeEmptyArray, min, max)
     if min == nil or min <= 0 then
         min = 1
@@ -44628,6 +44638,7 @@ local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
 local ____exports = {}
 local getRoomTypeMap
 local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
@@ -44733,6 +44744,7 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
     self.v = v
     self.customStagesMap = __TS__New(Map)
     self.customStageCachedRoomData = __TS__New(Map)
+    self.usingRedKey = false
     self.goToCustomStage = function(____, destinationName, destinationStage, _destinationStageType)
         if destinationName == nil then
             error("Failed to go to a custom stage since the custom trapdoors feature did not pass a destination name to the logic function.")
@@ -44756,6 +44768,19 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
             end
         end
     end
+    self.postUseItemRedKey = function()
+        local customStage = v.run.currentCustomStage
+        if customStage == nil then
+            return nil
+        end
+        if not self.usingRedKey then
+            return
+        end
+        self.usingRedKey = false
+        local level = game:GetLevel()
+        level:SetStage(CUSTOM_FLOOR_STAGE, CUSTOM_FLOOR_STAGE_TYPE)
+        return nil
+    end
     self.postCurseEval = function(____, curses)
         local customStage = v.run.currentCustomStage
         if customStage == nil then
@@ -44774,6 +44799,18 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
         streakTextGetShaderParams(nil, customStage, shaderName)
         return nil
     end
+    self.preUseItemRedKey = function()
+        local customStage = v.run.currentCustomStage
+        if customStage == nil then
+            return nil
+        end
+        self.usingRedKey = true
+        local level = game:GetLevel()
+        local stage = customStage.baseStage or DEFAULT_BASE_STAGE
+        local stageType = customStage.baseStageType or DEFAULT_BASE_STAGE_TYPE
+        level:SetStage(stage, stageType)
+        return nil
+    end
     self.postGridEntityBrokenRockAlt = function(____, gridEntity)
         local customStage = v.run.currentCustomStage
         if customStage == nil then
@@ -44834,7 +44871,13 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
         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.callbacksUsed = {
+        {ModCallback.POST_RENDER, self.postRender},
+        {ModCallback.POST_USE_ITEM, self.postUseItemRedKey, {CollectibleType.RED_KEY}},
+        {ModCallback.POST_CURSE_EVAL, self.postCurseEval},
+        {ModCallback.GET_SHADER_PARAMS, self.getShaderParams},
+        {ModCallback.PRE_USE_ITEM, self.preUseItemRedKey, {CollectibleType.RED_KEY}}
+    }
     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
@@ -44868,10 +44911,10 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
     for ____, room in ipairs(getRoomsInsideGrid(nil)) do
         do
             if room.SafeGridIndex == startingRoomGridIndex then
-                goto __continue31
+                goto __continue36
             end
             if room.Data == nil then
-                goto __continue31
+                goto __continue36
             end
             local roomType = room.Data.Type
             local roomShapeMap = customStage.roomTypeMap:get(roomType)
@@ -44879,13 +44922,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 if roomType == RoomType.DEFAULT then
                     logError((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name)
                 end
-                goto __continue31
+                goto __continue36
             end
             local roomShape = room.Data.Shape
             local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
             if roomDoorSlotFlagMap == nil then
                 logError((((((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. RoomShape[roomShape]) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name)
-                goto __continue31
+                goto __continue36
             end
             local doorSlotFlags = room.Data.Doors
             local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
@@ -44895,13 +44938,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 roomsMetadata = roomDoorSlotFlagMap:get(allDoorSlotFlags)
                 if roomsMetadata == nil then
                     logError((((((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. RoomShape[roomShape]) .. " (") .. tostring(roomShape)) .. ") + all doors enabled for custom stage: ") .. customStage.name)
-                    goto __continue31
+                    goto __continue36
                 end
             end
             local randomRoom
             if roomType == RoomType.BOSS then
                 if customStage.bossPool == nil then
-                    goto __continue31
+                    goto __continue36
                 end
                 randomRoom = getRandomBossRoomFromPool(
                     nil,
@@ -44924,13 +44967,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 )
                 if newRoomData == nil then
                     logError((("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name)
-                    goto __continue31
+                    goto __continue36
                 end
                 self.customStageCachedRoomData:set(randomRoom.variant, newRoomData)
             end
             room.Data = newRoomData
         end
-        ::__continue31::
+        ::__continue36::
     end
 end
 function CustomStages.prototype.setCustomStage(self, name, firstFloor, streakText, verbose)

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

@@ -4,6 +4,7 @@ export declare class CustomStages extends Feature {
     private readonly customStagesMap;
     /** Indexed by room variant. */
     private readonly customStageCachedRoomData;
+    private usingRedKey;
     private readonly customGridEntities;
     private readonly customTrapdoors;
     private readonly disableAllSound;
@@ -15,8 +16,18 @@ export declare class CustomStages extends Feature {
     private initCustomTrapdoorDestination;
     private readonly goToCustomStage;
     private readonly postRender;
+    /**
+     * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+     * value).
+     */
+    private readonly postUseItemRedKey;
     private readonly postCurseEval;
     private readonly getShaderParams;
+    /**
+     * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+     * value).
+     */
+    private readonly preUseItemRedKey;
     private readonly postGridEntityBrokenRockAlt;
     private readonly postGridEntityInit;
     private readonly postNewRoomReordered;

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

@@ -1 +1 @@
-{"version":3,"file":"CustomStages.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomStages.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2ChD,qBAAa,YAAa,SAAQ,OAAO;IAIvC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA8B;IAExE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAqD5C,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAa9B;IAGF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAmBzB;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAc5B;IAGF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAU9B;IAIF,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAe1C;IAGF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAqBjC;IAGF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAwBnC;IAEF,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IAgGzB;;;;;;;;;;;;;;;;OAgBG;IAEI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI;IAkGP;;;;;OAKG;IAEI,kBAAkB,IAAI,IAAI;CAGlC"}
+{"version":3,"file":"CustomStages.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/CustomStages.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA2ChD,qBAAa,YAAa,SAAQ,OAAO;IAIvC,oCAAoC;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAElE,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA8B;IAExE,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAmE5C,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAa9B;IAGF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAmBzB;IAEF;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAehC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAc5B;IAGF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAU9B;IAEF;;;OAGG;IAEH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAc/B;IAIF,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAe1C;IAGF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAqBjC;IAGF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAwBnC;IAEF,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IAgGzB;;;;;;;;;;;;;;;;OAgBG;IAEI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,UAAO,EACjB,UAAU,UAAO,EACjB,OAAO,UAAQ,GACd,IAAI;IAkGP;;;;;OAKG;IAEI,kBAAkB,IAAI,IAAI;CAGlC"}

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

@@ -8,6 +8,7 @@ local __TS__DecorateLegacy = ____lualib.__TS__DecorateLegacy
 local ____exports = {}
 local getRoomTypeMap
 local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
 local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
 local LevelCurse = ____isaac_2Dtypescript_2Ddefinitions.LevelCurse
 local LevelStage = ____isaac_2Dtypescript_2Ddefinitions.LevelStage
@@ -115,6 +116,7 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
     self.v = v
     self.customStagesMap = __TS__New(Map)
     self.customStageCachedRoomData = __TS__New(Map)
+    self.usingRedKey = false
     self.goToCustomStage = function(____, destinationName, destinationStage, _destinationStageType)
         if destinationName == nil then
             error("Failed to go to a custom stage since the custom trapdoors feature did not pass a destination name to the logic function.")
@@ -138,6 +140,19 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
             end
         end
     end
+    self.postUseItemRedKey = function()
+        local customStage = v.run.currentCustomStage
+        if customStage == nil then
+            return nil
+        end
+        if not self.usingRedKey then
+            return
+        end
+        self.usingRedKey = false
+        local level = game:GetLevel()
+        level:SetStage(CUSTOM_FLOOR_STAGE, CUSTOM_FLOOR_STAGE_TYPE)
+        return nil
+    end
     self.postCurseEval = function(____, curses)
         local customStage = v.run.currentCustomStage
         if customStage == nil then
@@ -156,6 +171,18 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
         streakTextGetShaderParams(nil, customStage, shaderName)
         return nil
     end
+    self.preUseItemRedKey = function()
+        local customStage = v.run.currentCustomStage
+        if customStage == nil then
+            return nil
+        end
+        self.usingRedKey = true
+        local level = game:GetLevel()
+        local stage = customStage.baseStage or DEFAULT_BASE_STAGE
+        local stageType = customStage.baseStageType or DEFAULT_BASE_STAGE_TYPE
+        level:SetStage(stage, stageType)
+        return nil
+    end
     self.postGridEntityBrokenRockAlt = function(____, gridEntity)
         local customStage = v.run.currentCustomStage
         if customStage == nil then
@@ -216,7 +243,13 @@ function CustomStages.prototype.____constructor(self, customGridEntities, custom
         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.callbacksUsed = {
+        {ModCallback.POST_RENDER, self.postRender},
+        {ModCallback.POST_USE_ITEM, self.postUseItemRedKey, {CollectibleType.RED_KEY}},
+        {ModCallback.POST_CURSE_EVAL, self.postCurseEval},
+        {ModCallback.GET_SHADER_PARAMS, self.getShaderParams},
+        {ModCallback.PRE_USE_ITEM, self.preUseItemRedKey, {CollectibleType.RED_KEY}}
+    }
     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
@@ -250,10 +283,10 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
     for ____, room in ipairs(getRoomsInsideGrid(nil)) do
         do
             if room.SafeGridIndex == startingRoomGridIndex then
-                goto __continue31
+                goto __continue36
             end
             if room.Data == nil then
-                goto __continue31
+                goto __continue36
             end
             local roomType = room.Data.Type
             local roomShapeMap = customStage.roomTypeMap:get(roomType)
@@ -261,13 +294,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 if roomType == RoomType.DEFAULT then
                     logError((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") for custom stage: ") .. customStage.name)
                 end
-                goto __continue31
+                goto __continue36
             end
             local roomShape = room.Data.Shape
             local roomDoorSlotFlagMap = roomShapeMap:get(roomShape)
             if roomDoorSlotFlagMap == nil then
                 logError((((((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. RoomShape[roomShape]) .. " (") .. tostring(roomShape)) .. ") for custom stage: ") .. customStage.name)
-                goto __continue31
+                goto __continue36
             end
             local doorSlotFlags = room.Data.Doors
             local roomsMetadata = roomDoorSlotFlagMap:get(doorSlotFlags)
@@ -277,13 +310,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 roomsMetadata = roomDoorSlotFlagMap:get(allDoorSlotFlags)
                 if roomsMetadata == nil then
                     logError((((((((("Failed to find any custom rooms for RoomType." .. RoomType[roomType]) .. " (") .. tostring(roomType)) .. ") + RoomShape.") .. RoomShape[roomShape]) .. " (") .. tostring(roomShape)) .. ") + all doors enabled for custom stage: ") .. customStage.name)
-                    goto __continue31
+                    goto __continue36
                 end
             end
             local randomRoom
             if roomType == RoomType.BOSS then
                 if customStage.bossPool == nil then
-                    goto __continue31
+                    goto __continue36
                 end
                 randomRoom = getRandomBossRoomFromPool(
                     nil,
@@ -306,13 +339,13 @@ function CustomStages.prototype.setStageRoomsData(self, customStage, rng, verbos
                 )
                 if newRoomData == nil then
                     logError((("Failed to get the room data for room variant " .. tostring(randomRoom.variant)) .. " for custom stage: ") .. customStage.name)
-                    goto __continue31
+                    goto __continue36
                 end
                 self.customStageCachedRoomData:set(randomRoom.variant, newRoomData)
             end
             room.Data = newRoomData
         end
-        ::__continue31::
+        ::__continue36::
     end
 end
 function CustomStages.prototype.setCustomStage(self, name, firstFloor, streakText, verbose)

package/dist/src/functions/array.d.ts

@@ -93,6 +93,18 @@ export declare function combineArrays<T>(...arrays: Array<T[] | readonly T[]>):
 export declare function copyArray<T>(oldArray: T[] | readonly T[], numElements?: int): T[];
 /** Helper function to remove all of the elements in an array in-place. */
 export declare function emptyArray<T>(array: T[]): void;
+/**
+ * Helper function to perform a map and a filter at the same time. Similar to `Array.map`, provide a
+ * function that transforms a value, but return `undefined` if the value should be skipped. (Thus,
+ * this function cannot be used in situations where `undefined` can be a valid array element.)
+ *
+ * This function is useful because a map will always produce an array with the same amount of
+ * elements as the original array.
+ *
+ * This is named `filterMap` after the Rust function:
+ * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
+ */
+export declare function filterMap<OldT, NewT>(array: OldT[], func: (element: OldT) => NewT | undefined): NewT[];
 /**
  * Helper function to get all possible combinations of the given array. This includes the
  * combination of an empty array.

package/dist/src/functions/array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/functions/array.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/functions/array.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/array.lua

@@ -290,6 +290,25 @@ end
 function ____exports.emptyArray(self, array)
     __TS__ArraySplice(array, 0, #array)
 end
+--- Helper function to perform a map and a filter at the same time. Similar to `Array.map`, provide a
+-- function that transforms a value, but return `undefined` if the value should be skipped. (Thus,
+-- this function cannot be used in situations where `undefined` can be a valid array element.)
+-- 
+-- This function is useful because a map will always produce an array with the same amount of
+-- elements as the original array.
+-- 
+-- This is named `filterMap` after the Rust function:
+-- https://doc.rust-lang.org/std/iter/struct.FilterMap.html
+function ____exports.filterMap(self, array, func)
+    local newArray = {}
+    for ____, element in ipairs(array) do
+        local newElement = func(nil, element)
+        if newElement ~= nil then
+            newArray[#newArray + 1] = newElement
+        end
+    end
+    return newArray
+end
 --- Helper function to get all possible combinations of the given array. This includes the
 -- combination of an empty array.
 -- 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "30.12.9",
+  "version": "30.12.11",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",
@@ -25,6 +25,6 @@
   "main": "dist/src/index",
   "types": "dist/index.rollup.d.ts",
   "dependencies": {
-    "isaac-typescript-definitions": "^13.0.22"
+    "isaac-typescript-definitions": "^13.0.23"
   }
 }

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

@@ -1,5 +1,6 @@
 import type { DoorSlotFlag, Music } from "isaac-typescript-definitions";
 import {
+  CollectibleType,
   GridEntityType,
   LevelCurse,
   LevelStage,
@@ -91,6 +92,8 @@ export class CustomStages extends Feature {
   /** Indexed by room variant. */
   private readonly customStageCachedRoomData = new Map<int, RoomConfig>();
 
+  private usingRedKey = false;
+
   private readonly customGridEntities: CustomGridEntities;
   private readonly customTrapdoors: CustomTrapdoors;
   private readonly disableAllSound: DisableAllSound;
@@ -122,11 +125,25 @@ export class CustomStages extends Feature {
       // 2
       [ModCallback.POST_RENDER, this.postRender],
 
+      // 3
+      [
+        ModCallback.POST_USE_ITEM,
+        this.postUseItemRedKey,
+        [CollectibleType.RED_KEY],
+      ],
+
       // 12
       [ModCallback.POST_CURSE_EVAL, this.postCurseEval],
 
       // 21
       [ModCallback.GET_SHADER_PARAMS, this.getShaderParams],
+
+      // 23
+      [
+        ModCallback.PRE_USE_ITEM,
+        this.preUseItemRedKey,
+        [CollectibleType.RED_KEY],
+      ],
     ];
 
     this.customCallbacksUsed = [
@@ -216,6 +233,28 @@ export class CustomStages extends Feature {
     }
   };
 
+  /**
+   * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+   * value).
+   */
+  // ModCallback.POST_USE_ITEM (3)
+  private readonly postUseItemRedKey = (): boolean | undefined => {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+      return undefined;
+    }
+
+    if (!this.usingRedKey) {
+      return;
+    }
+    this.usingRedKey = false;
+
+    const level = game.GetLevel();
+    level.SetStage(CUSTOM_FLOOR_STAGE, CUSTOM_FLOOR_STAGE_TYPE);
+
+    return undefined;
+  };
+
   // ModCallback.POST_CURSE_EVAL (12)
   private readonly postCurseEval = (
     curses: BitFlags<LevelCurse>,
@@ -246,6 +285,27 @@ export class CustomStages extends Feature {
     return undefined;
   };
 
+  /**
+   * Fix the bug where Red Key will not work on custom floors (due to the stage being a bugged
+   * value).
+   */
+  // ModCallback.PRE_USE_ITEM (23)
+  private readonly preUseItemRedKey = (): boolean | undefined => {
+    const customStage = v.run.currentCustomStage;
+    if (customStage === null) {
+      return undefined;
+    }
+
+    this.usingRedKey = true;
+
+    const level = game.GetLevel();
+    const stage = customStage.baseStage ?? DEFAULT_BASE_STAGE;
+    const stageType = customStage.baseStageType ?? DEFAULT_BASE_STAGE_TYPE;
+    level.SetStage(stage, stageType); // eslint-disable-line isaacscript/strict-enums
+
+    return undefined;
+  };
+
   // ModCallbackCustom.POST_GRID_ENTITY_BROKEN
   // GridEntityType.ROCK_ALT
   private readonly postGridEntityBrokenRockAlt = (gridEntity: GridEntity) => {

package/src/functions/array.ts

@@ -232,6 +232,33 @@ export function emptyArray<T>(array: T[]): void {
   array.splice(0, array.length);
 }
 
+/**
+ * Helper function to perform a map and a filter at the same time. Similar to `Array.map`, provide a
+ * function that transforms a value, but return `undefined` if the value should be skipped. (Thus,
+ * this function cannot be used in situations where `undefined` can be a valid array element.)
+ *
+ * This function is useful because a map will always produce an array with the same amount of
+ * elements as the original array.
+ *
+ * This is named `filterMap` after the Rust function:
+ * https://doc.rust-lang.org/std/iter/struct.FilterMap.html
+ */
+export function filterMap<OldT, NewT>(
+  array: OldT[],
+  func: (element: OldT) => NewT | undefined,
+): NewT[] {
+  const newArray: NewT[] = [];
+
+  for (const element of array) {
+    const newElement = func(element);
+    if (newElement !== undefined) {
+      newArray.push(newElement);
+    }
+  }
+
+  return newArray;
+}
+
 /**
  * Helper function to get all possible combinations of the given array. This includes the
  * combination of an empty array.