isaacscript-common 9.19.0 → 9.19.3

package/dist/features/registerHotkey.lua

@@ -1,93 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local __TS__Iterator = ____lualib.__TS__Iterator
-local ____exports = {}
-local postRender, checkIfTriggered, staticHotkeyFunctionMap, dynamicHotkeyFunctionMap, keyPressedMap
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local Keyboard = ____isaac_2Dtypescript_2Ddefinitions.Keyboard
-local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local ____DefaultMap = require("classes.DefaultMap")
-local DefaultMap = ____DefaultMap.DefaultMap
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____input = require("functions.input")
-local isKeyboardPressed = ____input.isKeyboardPressed
-local ____types = require("functions.types")
-local isFunction = ____types.isFunction
-function postRender(self)
-    for ____, ____value in __TS__Iterator(staticHotkeyFunctionMap:entries()) do
-        local keyboard = ____value[1]
-        local triggerFunc = ____value[2]
-        checkIfTriggered(nil, keyboard, triggerFunc)
-    end
-    for ____, ____value in __TS__Iterator(dynamicHotkeyFunctionMap:entries()) do
-        local keyboardFunc = ____value[1]
-        local triggerFunc = ____value[2]
-        local keyboard = keyboardFunc(nil)
-        if keyboard ~= nil then
-            checkIfTriggered(nil, keyboard, triggerFunc)
-        end
-    end
-end
-function checkIfTriggered(self, keyboard, triggerFunc)
-    local isPressed = isKeyboardPressed(nil, keyboard)
-    local wasPreviouslyPressed = keyPressedMap:getAndSetDefault(keyboard)
-    keyPressedMap:set(keyboard, isPressed)
-    if isPressed and not wasPreviouslyPressed then
-        triggerFunc(nil)
-    end
-end
-local FEATURE_NAME = "registerHotkeys"
-staticHotkeyFunctionMap = __TS__New(Map)
-dynamicHotkeyFunctionMap = __TS__New(Map)
-keyPressedMap = __TS__New(DefaultMap, false)
----
--- @internal
-function ____exports.registerHotkeyInit(self, mod)
-    mod:AddCallback(ModCallback.POST_RENDER, postRender)
-end
---- Helper function to run arbitrary code when you press and release a specific keyboard key.
--- 
--- This can be used to easily set up custom hotkeys to facilitate custom game features or to assist
--- in debugging.
--- 
--- @param keyboardOrFunc Either the key that you want to trigger the hotkey or a function that
--- returns the key that will trigger the hotkey. Normally, you would just
--- specify the key directly, but you can use a function for situations where
--- the key can change (like if end-users can specify a custom hotkey using Mod
--- Config Menu).
--- @param triggerFunc A function containing the arbitrary code that you want to execute when the
--- hotkey is triggered.
-function ____exports.registerHotkey(self, keyboardOrFunc, triggerFunc)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if isFunction(nil, keyboardOrFunc) then
-        if dynamicHotkeyFunctionMap:has(keyboardOrFunc) then
-            error("Failed to register a hotkey due to a custom hotkey already being defined for the submitted function.")
-        end
-        dynamicHotkeyFunctionMap:set(keyboardOrFunc, triggerFunc)
-    else
-        if staticHotkeyFunctionMap:has(keyboardOrFunc) then
-            error(((("Failed to register a hotkey due to a hotkey already being defined for key: Keyboard." .. tostring(Keyboard[keyboardOrFunc])) .. " (") .. tostring(keyboardOrFunc)) .. ")")
-        end
-        staticHotkeyFunctionMap:set(keyboardOrFunc, triggerFunc)
-    end
-end
---- Helper function to remove a hotkey created with the `registerHotkey` function.
--- 
--- @param keyboardOrFunc Equal to the value that you passed when initially registering the hotkey.
-function ____exports.unregisterHotkey(self, keyboardOrFunc)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    if isFunction(nil, keyboardOrFunc) then
-        if not dynamicHotkeyFunctionMap:has(keyboardOrFunc) then
-            error("Failed to unregister a hotkey since there is no existing hotkey defined for the submitted function.")
-        end
-        dynamicHotkeyFunctionMap:delete(keyboardOrFunc)
-    else
-        if not staticHotkeyFunctionMap:has(keyboardOrFunc) then
-            error(((("Failed to unregister a hotkey since there is no existing hotkey defined for key: Keyboard." .. tostring(Keyboard[keyboardOrFunc])) .. " (") .. tostring(keyboardOrFunc)) .. ")")
-        end
-        staticHotkeyFunctionMap:delete(keyboardOrFunc)
-    end
-end
-return ____exports

package/dist/features/roomClearFrame.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"roomClearFrame.d.ts","sourceRoot":"","sources":["../../src/features/roomClearFrame.ts"],"names":[],"mappings":";AAqCA;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,SAAS,CAGvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,GAAG,SAAS,CAGvD"}

package/dist/features/roomClearFrame.lua

@@ -1,38 +0,0 @@
-local ____exports = {}
-local postRoomClearChangedTrue, v
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____ModCallbackCustom = require("enums.ModCallbackCustom")
-local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____exports = require("features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function postRoomClearChangedTrue(self)
-    local gameFrameCount = game:GetFrameCount()
-    local room = game:GetRoom()
-    local roomFrameCount = room:GetFrameCount()
-    v.room.roomClearGameFrame = gameFrameCount
-    v.room.roomClearRoomFrame = roomFrameCount
-end
-local FEATURE_NAME = "roomClearFrame"
-v = {room = {roomClearGameFrame = nil, roomClearRoomFrame = nil}}
----
--- @internal
-function ____exports.roomClearFrameInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v)
-    mod:AddCallbackCustom(ModCallbackCustom.POST_ROOM_CLEAR_CHANGED, postRoomClearChangedTrue, true)
-end
---- Helper function to get the game frame (i.e. `Game.GetFrameCount`) of the last time that this room
--- was cleared. Returns undefined if the room has never been cleared.
-function ____exports.getRoomClearGameFrame(self)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    return v.room.roomClearGameFrame
-end
---- Helper function to get the room frame (i.e. `Room.GetFrameCount`) of the last time that this room
--- was cleared. Returns undefined if the room has never been cleared.
-function ____exports.getRoomClearRoomFrame(self)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    return v.room.roomClearGameFrame
-end
-return ____exports

package/dist/features/roomHistory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"roomHistory.d.ts","sourceRoot":"","sources":["../../src/features/roomHistory.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAmDhE;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,eAAe,EAAE,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,CAe5D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,eAAe,CAS1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CASvC"}

package/dist/features/roomHistory.lua

@@ -1,102 +0,0 @@
-local ____exports = {}
-local postNewRoomEarly, v
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____ModCallbackCustom = require("enums.ModCallbackCustom")
-local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____array = require("functions.array")
-local getLastElement = ____array.getLastElement
-local ____roomData = require("functions.roomData")
-local getRoomGridIndex = ____roomData.getRoomGridIndex
-local getRoomListIndex = ____roomData.getRoomListIndex
-local getRoomName = ____roomData.getRoomName
-local getRoomStageID = ____roomData.getRoomStageID
-local getRoomSubType = ____roomData.getRoomSubType
-local getRoomVariant = ____roomData.getRoomVariant
-local getRoomVisitedCount = ____roomData.getRoomVisitedCount
-local ____exports = require("features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function postNewRoomEarly(self)
-    local level = game:GetLevel()
-    local stage = level:GetStage()
-    local stageType = level:GetStageType()
-    local room = game:GetRoom()
-    local roomType = room:GetType()
-    local stageID = getRoomStageID(nil)
-    local roomVariant = getRoomVariant(nil)
-    local roomSubType = getRoomSubType(nil)
-    local roomName = getRoomName(nil)
-    local roomGridIndex = getRoomGridIndex(nil)
-    local roomListIndex = getRoomListIndex(nil)
-    local roomVisitedCount = getRoomVisitedCount(nil)
-    local roomDescription = {
-        stage = stage,
-        stageType = stageType,
-        stageID = stageID,
-        roomType = roomType,
-        roomVariant = roomVariant,
-        roomSubType = roomSubType,
-        roomName = roomName,
-        roomGridIndex = roomGridIndex,
-        roomListIndex = roomListIndex,
-        roomVisitedCount = roomVisitedCount
-    }
-    local ____v_run_roomHistory_0 = v.run.roomHistory
-    ____v_run_roomHistory_0[#____v_run_roomHistory_0 + 1] = roomDescription
-end
-local FEATURE_NAME = "roomHistory"
-v = {run = {roomHistory = {}}}
----
--- @internal
-function ____exports.roomHistoryInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v)
-    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly)
-end
---- Helper function to get information about all of the rooms that a player has visited thus far on
--- this run.
-function ____exports.getRoomHistory(self)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    return v.run.roomHistory
-end
---- Helper function to get information about the room that was previously visited.
--- 
--- In the special case of only one room having been visited thus far (i.e. the starting room of the
--- run), the starting room will be returned.
-function ____exports.getPreviousRoomDescription(self)
-    local previousRoomDescription = v.run.roomHistory[#v.run.roomHistory - 2 + 1]
-    if previousRoomDescription ~= nil then
-        return previousRoomDescription
-    end
-    local startingRoomDescription = v.run.roomHistory[1]
-    if startingRoomDescription ~= nil then
-        return startingRoomDescription
-    end
-    error("Failed to find a room description for any rooms thus far on this run.")
-end
---- Helper function to get information about the most recent room that is stored in the room history
--- array.
--- 
--- This is useful in the `POST_ENTITY_REMOVE` callback; see the `isLeavingRoom` function.
-function ____exports.getLatestRoomDescription(self)
-    local latestRoomDescription = getLastElement(nil, v.run.roomHistory)
-    if latestRoomDescription == nil then
-        error("Failed to get the latest room description since the room history array was empty.")
-    end
-    return latestRoomDescription
-end
---- Helper function to detect if the game is in the state where the room index has changed to a new
--- room, but the entities from the previous room are currently in the process of despawning. (At
--- this point, the `POST_NEW_ROOM` callback will not have fired yet, and there will not be an entry
--- in the room history array for the current room.)
--- 
--- This function is intended to be used in the `POST_ENTITY_REMOVE` callback to detect when an
--- entity is pseudo-persistent entity such as a pickup is despawning.
-function ____exports.isLeavingRoom(self)
-    local roomListIndex = getRoomListIndex(nil)
-    local roomVisitedCount = getRoomVisitedCount(nil)
-    local latestRoomDescription = ____exports.getLatestRoomDescription(nil)
-    return roomListIndex ~= latestRoomDescription.roomListIndex or roomVisitedCount ~= latestRoomDescription.roomVisitedCount
-end
-return ____exports

package/dist/features/runInNFrames.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runInNFrames.d.ts","sourceRoot":"","sources":["../../src/features/runInNFrames.ts"],"names":[],"mappings":";AA0GA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI,CAOxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,YAAY,EAAE,GAAG,GAAG,IAAI,CAO5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAGvD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAGzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,OAAO,EACnB,UAAU,EAAE,GAAG,EACf,cAAc,EAAE,OAAO,GACtB,IAAI,CAWN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,OAAO,EACnB,YAAY,EAAE,GAAG,EACjB,cAAc,EAAE,OAAO,GACtB,IAAI,CAWN"}

package/dist/features/runInNFrames.lua

@@ -1,191 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
-local ____exports = {}
-local postUpdate, postRender, checkExecuteQueuedFunctions, checkExecuteIntervalFunctions, v
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____array = require("functions.array")
-local arrayRemoveInPlace = ____array.arrayRemoveInPlace
-local ____exports = require("features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function postUpdate(self)
-    local gameFrameCount = game:GetFrameCount()
-    checkExecuteQueuedFunctions(nil, gameFrameCount, v.run.queuedGameFunctionTuples)
-    checkExecuteIntervalFunctions(nil, gameFrameCount, v.run.intervalGameFunctionTuples)
-end
-function postRender(self)
-    local renderFrameCount = Isaac.GetFrameCount()
-    checkExecuteQueuedFunctions(nil, renderFrameCount, v.run.queuedRenderFunctionTuples)
-    checkExecuteIntervalFunctions(nil, renderFrameCount, v.run.intervalRenderFunctionTuples)
-end
-function checkExecuteQueuedFunctions(self, frameCount, functionTuples)
-    local firingFunctions = __TS__ArrayFilter(
-        functionTuples,
-        function(____, ____bindingPattern0)
-            local frameCountToFire
-            frameCountToFire = ____bindingPattern0[1]
-            return frameCount >= frameCountToFire
-        end
-    )
-    for ____, tuple in ipairs(firingFunctions) do
-        local _frameCountToFire, func = table.unpack(tuple)
-        func(nil)
-        arrayRemoveInPlace(nil, functionTuples, tuple)
-    end
-end
-function checkExecuteIntervalFunctions(self, frameCount, functionTuples)
-    local firingFunctions = __TS__ArrayFilter(
-        functionTuples,
-        function(____, ____bindingPattern0)
-            local frameCountToFire
-            frameCountToFire = ____bindingPattern0[1]
-            return frameCount >= frameCountToFire
-        end
-    )
-    for ____, tuple in ipairs(firingFunctions) do
-        local _frameCountToFire, func, numIntervalFrames = table.unpack(tuple)
-        local returnValue = func(nil)
-        arrayRemoveInPlace(nil, functionTuples, tuple)
-        if returnValue then
-            local nextFireFrame = frameCount + numIntervalFrames
-            local newTuple = {nextFireFrame, func, numIntervalFrames}
-            functionTuples[#functionTuples + 1] = newTuple
-        end
-    end
-end
-local FEATURE_NAME = "runInNFrames"
-v = {run = {queuedGameFunctionTuples = {}, queuedRenderFunctionTuples = {}, intervalGameFunctionTuples = {}, intervalRenderFunctionTuples = {}}}
----
--- @internal
-function ____exports.runInNFramesInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v, false)
-    mod:AddCallback(ModCallback.POST_UPDATE, postUpdate)
-    mod:AddCallback(ModCallback.POST_RENDER, postRender)
-end
---- Supply a function to run N game frames from now in the `POST_UPDATE` callback.
--- 
--- For a usage example, see the documentation for the `runNextGameFrame`, which is used in a similar
--- way.
--- 
--- Note that this function will not handle saving and quitting. If a player saving and quitting
--- before the deferred function fires would cause a bug in your mod, then you should handle deferred
--- functions manually using serializable data.
-function ____exports.runInNGameFrames(self, func, gameFrames)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local gameFrameCount = game:GetFrameCount()
-    local functionFireFrame = gameFrameCount + gameFrames
-    local tuple = {functionFireFrame, func}
-    local ____v_run_queuedGameFunctionTuples_0 = v.run.queuedGameFunctionTuples
-    ____v_run_queuedGameFunctionTuples_0[#____v_run_queuedGameFunctionTuples_0 + 1] = tuple
-end
---- Supply a function to run N render frames from now in the `POST_RENDER` callback.
--- 
--- For a usage example, see the documentation for the `runNextGameFrame`, which is used in a similar
--- way.
--- 
--- Note that this function will not handle saving and quitting. If a player saving and quitting
--- before the deferred function fires would cause a bug in your mod, then you should handle deferred
--- functions manually using serializable data.
-function ____exports.runInNRenderFrames(self, func, renderFrames)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local renderFrameCount = Isaac.GetFrameCount()
-    local functionFireFrame = renderFrameCount + renderFrames
-    local tuple = {functionFireFrame, func}
-    local ____v_run_queuedRenderFunctionTuples_1 = v.run.queuedRenderFunctionTuples
-    ____v_run_queuedRenderFunctionTuples_1[#____v_run_queuedRenderFunctionTuples_1 + 1] = tuple
-end
---- Supply a function to run on the next `POST_UPDATE` callback.
--- 
--- For example:
--- 
--- ```ts
--- const NUM_EXPLODER_EXPLOSIONS = 5;
--- 
--- function useItemExploder(player: EntityPlayer) {
---   playSound("exploderBegin");
---   explode(player, NUM_EXPLODER_EXPLOSIONS);
--- }
--- 
--- function explode(player: EntityPlayer, numFramesLeft: int) {
---   Isaac.Explode(player, undefined, 1);
---   numFramesLeft -= 1;
---   if (numFramesLeft === 0) {
---     runNextFrame(() => {
---       explode(player, numFramesLeft);
---     });
---   }
--- }
--- ```
--- 
--- Note that this function will not handle saving and quitting. If a player saving and quitting
--- before the deferred function fires would cause a bug in your mod, then you should handle deferred
--- functions manually using serializable data.
-function ____exports.runNextGameFrame(self, func)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    ____exports.runInNGameFrames(nil, func, 1)
-end
---- Supply a function to run on the next `POST_RENDER` callback.
--- 
--- For a usage example, see the documentation for the `runNextGameFrame`, which is used in a similar
--- way.
--- 
--- Note that this function will not handle saving and quitting.
-function ____exports.runNextRenderFrame(self, func)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    ____exports.runInNRenderFrames(nil, func, 1)
-end
---- Supply a function to be repeatedly run on an interval of N game frames in the `POST_UPDATE`
--- callback. The function will continue to be fired until `false` is returned from the function.
--- 
--- This is similar to the `setInterval` vanilla JavaScript function, except there is no
--- corresponding `clearInterval` function. (Instead, the return value from the supplied function is
--- used to stop the interval.)
--- 
--- Note that this function will not handle saving and quitting. You must manually restart any
--- intervals if the player saves and quits in the middle of a run.
--- 
--- @param func The function to repeatedly run on an interval.
--- @param gameFrames The amount of game frames to wait between each run.
--- @param runImmediately Whether or not to execute the function right now before waiting for the
--- interval.
-function ____exports.setIntervalGameFrames(self, func, gameFrames, runImmediately)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local gameFrameCount = game:GetFrameCount()
-    local functionFireFrame = gameFrameCount + gameFrames
-    local tuple = {functionFireFrame, func, gameFrames}
-    local ____v_run_intervalGameFunctionTuples_2 = v.run.intervalGameFunctionTuples
-    ____v_run_intervalGameFunctionTuples_2[#____v_run_intervalGameFunctionTuples_2 + 1] = tuple
-    if runImmediately then
-        func(nil)
-    end
-end
---- Supply a function to be repeatedly run on an interval of N render frames in the `POST_RENDER`
--- callback. The function will continue to be fired until `false` is returned from the function.
--- 
--- This is similar to the `setInterval` vanilla JavaScript function, except there is no
--- corresponding `clearInterval` function. (Instead, the return value from the supplied function is
--- used to stop the interval.)
--- 
--- Note that this function will not handle saving and quitting. You must manually restart any
--- intervals if the player saves and quits in the middle of a run.
--- 
--- @param func The function to repeatedly run on an interval.
--- @param renderFrames The amount of game frames to wait between each run.
--- @param runImmediately Whether or not to execute the function right now before waiting for the
--- interval.
-function ____exports.setIntervalRenderFrames(self, func, renderFrames, runImmediately)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local renderFrameCount = Isaac.GetFrameCount()
-    local functionFireFrame = renderFrameCount + renderFrames
-    local tuple = {functionFireFrame, func, renderFrames}
-    local ____v_run_intervalGameFunctionTuples_3 = v.run.intervalGameFunctionTuples
-    ____v_run_intervalGameFunctionTuples_3[#____v_run_intervalGameFunctionTuples_3 + 1] = tuple
-    if runImmediately then
-        func(nil)
-    end
-end
-return ____exports

package/dist/features/runNextRoom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runNextRoom.d.ts","sourceRoot":"","sources":["../../src/features/runNextRoom.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAGlD"}

package/dist/features/runNextRoom.lua

@@ -1,35 +0,0 @@
-local ____exports = {}
-local postNewRoomReordered, v
-local ____ModCallbackCustom = require("enums.ModCallbackCustom")
-local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____array = require("functions.array")
-local emptyArray = ____array.emptyArray
-local ____exports = require("features.saveDataManager.exports")
-local saveDataManager = ____exports.saveDataManager
-function postNewRoomReordered(self)
-    for ____, func in ipairs(v.run.queuedFunctions) do
-        func(nil)
-    end
-    emptyArray(nil, v.run.queuedFunctions)
-end
-local FEATURE_NAME = "runNextRoom"
-v = {run = {queuedFunctions = {}}}
----
--- @internal
-function ____exports.runNextRoomInit(self, mod)
-    saveDataManager(nil, FEATURE_NAME, v, false)
-    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_REORDERED, postNewRoomReordered)
-end
---- Supply a function to run on the next `POST_NEW_ROOM` callback.
--- 
--- Note that this function will not handle saving and quitting. If a player saving and quitting
--- before the deferred function fires would cause a bug in your mod, then you should handle deferred
--- functions manually using serializable data.
-function ____exports.runNextRoom(self, func)
-    errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local ____v_run_queuedFunctions_0 = v.run.queuedFunctions
-    ____v_run_queuedFunctions_0[#____v_run_queuedFunctions_0 + 1] = func
-end
-return ____exports

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

@@ -1 +0,0 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EACpD,GAAG,EAAE,MAAM,EAAE,qEAAqE;AAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAAC;AACR,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EAAE,kEAAkE;AAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI,CAAC;AA+CR;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAQD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,GAC1B,IAAI,CAiBN"}

package/dist/features/saveDataManager/exports.lua

@@ -1,189 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local __TS__TypeOf = ____lualib.__TS__TypeOf
-local __TS__ObjectKeys = ____lualib.__TS__ObjectKeys
-local ____exports = {}
-local ____SerializationType = require("enums.SerializationType")
-local SerializationType = ____SerializationType.SerializationType
-local ____featuresInitialized = require("featuresInitialized")
-local errorIfFeaturesNotInitialized = ____featuresInitialized.errorIfFeaturesNotInitialized
-local ____deepCopy = require("functions.deepCopy")
-local deepCopy = ____deepCopy.deepCopy
-local ____types = require("functions.types")
-local isString = ____types.isString
-local ____main = require("features.saveDataManager.main")
-local forceSaveDataManagerLoad = ____main.forceSaveDataManagerLoad
-local forceSaveDataManagerSave = ____main.forceSaveDataManagerSave
-local restoreDefaultSaveData = ____main.restoreDefaultSaveData
-local ____maps = require("features.saveDataManager.maps")
-local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
-local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
-local saveDataMap = ____maps.saveDataMap
-local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
-local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
---- This is the entry point to the save data manager, a system which provides two major features:
--- 
--- 1. automatic resetting of variables on a new run, on a new level, or on a new room (as desired)
--- 2. automatic saving and loading of all tracked data to the "save#.dat" file
--- 
--- You feed this function with an object containing your variables, and then it will automatically
--- manage them for you. (See below for an example.)
--- 
--- The save data manager is meant to be called once for each feature of your mod. In other words,
--- you should not put all of the data for your mod on the same object. Instead, scope your variables
--- locally to a single file that contains a mod feature, and then call this function to register
--- them. For example:
--- 
--- ```ts
--- // in file: feature1.ts
--- import { saveDataManager } from "isaacscript-common";
--- 
--- // Declare local variables for this file or feature.
--- const v = {
---   // These variables are never reset; manage them yourself at will.
---   persistent: {
---     foo1: 0,
---   },
--- 
---   // These variables are reset at the beginning of every run.
---   run: {
---     foo2: 0,
---   },
--- 
---   // These variables are reset at the beginning of every level.
---   level: {
---     foo3: 0,
---   },
--- 
---   // These variables are reset at the beginning of every room.
---   room: {
---     foo4: 0,
---   },
--- };
--- // Every child object is optional; only create the ones that you need.
--- 
--- // Register the variables with the save data manager. (We need to provide a string key that
--- // matches the name of this file.)
--- function feature1Init() {
---   saveDataManager("feature1", v);
--- }
--- 
--- // Elsewhere in the file, use your variables.
--- function feature1Function() {
---   if (v.run.foo1 > 0) {
---     // Insert code here.
---   }
--- }
--- ```
--- 
--- - Save data is loaded from disk in the `POST_PLAYER_INIT` callback (i.e. the first callback that
---   can possibly run).
--- - Save data is recorded to disk in the `PRE_GAME_EXIT` callback.
--- 
--- You can put lots of data types on your variable objects, but not everything is supported. For the
--- specific things that are supported, see the documentation for the `deepCopy` helper function.
--- 
--- Note that before using the save data manager, you must call the `upgradeMod` function. (Upgrade
--- your mod before registering any of your own callbacks so that the save data manager will run
--- before any of your code does.)
--- 
--- If you want the save data manager to load data before the `POST_PLAYER_INIT` callback (i.e. in
--- the main menu), then you should explicitly call the `saveDataManagerLoad` function. (The save
--- data manager cannot do this on its own because it cannot know when your mod features are finished
--- initializing.)
--- 
--- Finally, some features may have variables that need to be automatically reset per run/level, but
--- not saved to disk on game exit. (For example, if they contain functions or other non-serializable
--- data.) For these cases, set the second argument to `() => false`.
--- 
--- @param key The name of the file or feature that is submitting data to be managed by the save data
--- manager. The save data manager will throw an error if the key is already registered.
--- @param v An object that corresponds to the `SaveData` interface. The object is conventionally
--- called "v" for brevity. ("v" is short for "local variables").
--- @param conditionalFunc Optional. A function to run to check if this save data should be written
--- to disk. Default is `() => true`, meaning that this save data will always
--- be written to disk. Use a conditional function for the situations when the
--- local variables are for a feature that the end-user can disable. (If the
--- feature is disabled, then there would be no point in writing any of the
--- variables to the "save#.dat" file.) You can also specify `false` to this
--- argument in order to completely disable saving data. (Specifying `false`
--- will allow you to use non-serializable objects in your save data, such as
--- `EntityPtr`.
-function ____exports.saveDataManager(self, key, v, conditionalFunc)
-    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
-    if not isString(nil, key) then
-        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " requires that keys are strings. You tried to use a key of type: ") .. __TS__TypeOf(key))
-    end
-    if saveDataMap[key] ~= nil then
-        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " is already managing save data for a key of: ") .. key)
-    end
-    saveDataMap[key] = v
-    if conditionalFunc == false then
-        conditionalFunc = function() return false end
-    end
-    local saveDataKeys = __TS__ObjectKeys(v)
-    if #saveDataKeys == 1 and saveDataKeys[1] == "room" then
-        conditionalFunc = function() return false end
-    end
-    local saveDataCopy = deepCopy(nil, v, SerializationType.NONE, key)
-    saveDataDefaultsMap[key] = saveDataCopy
-    if conditionalFunc ~= nil then
-        saveDataConditionalFuncMap[key] = conditionalFunc
-    end
-end
---- The save data manager will automatically load variables from disk at the appropriate times (i.e.
--- when a new run is started). Use this function to explicitly force the save data manager to load
--- all of its variables from disk immediately.
--- 
--- Obviously, doing this will overwrite the current data, so using this function can potentially
--- result in lost state.
-function ____exports.saveDataManagerLoad(self)
-    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
-    forceSaveDataManagerLoad(nil)
-end
---- The save data manager will automatically save variables to disk at the appropriate times (i.e.
--- when the run is exited). Use this function to explicitly force the save data manager to write all
--- of its variables to disk immediately.
-function ____exports.saveDataManagerSave(self)
-    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
-    forceSaveDataManagerSave(nil)
-end
---- - Sets the global variable of "g" equal to all of the save data variables for this mod.
--- - Sets the global variable of "gd" equal to all of the save data default variables for this mod.
--- 
--- This can make debugging easier, as you can access the variables from the game's debug console.
--- e.g. `l print(g.feature1.foo)`
-function ____exports.saveDataManagerSetGlobal(self)
-    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
-    g = saveDataMap
-    gd = saveDataDefaultsMap
-end
---- The save data manager will automatically reset variables at the appropriate times (i.e. when a
--- player enters a new room). Use this function to explicitly force the save data manager to reset a
--- specific variable group.
--- 
--- For example:
--- 
--- ```ts
--- const v = {
---   room: {
---     foo: 123,
---   },
--- };
--- 
--- saveDataManager("file1", v);
--- 
--- // Then, later on, to explicit reset all of the "room" variables:
--- saveDataManagerReset("file1", "room");
--- ```
-function ____exports.saveDataManagerReset(self, key, childObjectKey)
-    errorIfFeaturesNotInitialized(nil, SAVE_DATA_MANAGER_FEATURE_NAME)
-    if not isString(nil, key) then
-        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " requires that keys are strings. You tried to use a key of type: ") .. __TS__TypeOf(key))
-    end
-    local saveData = saveDataMap[key]
-    if saveData == nil then
-        error((("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " is not managing save data for a key of: ") .. key)
-    end
-    restoreDefaultSaveData(nil, key, saveData, childObjectKey)
-end
-return ____exports

package/dist/features/saveDataManager/load.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/load.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AASrD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACpC,IAAI,CAqDN"}