isaacscript-common 6.6.1-dev.2 → 6.6.1

package/dist/features/runNextRoom.lua

@@ -0,0 +1,40 @@
+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,
+        function() return false end
+    )
+    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

@@ -0,0 +1,132 @@
+import { SaveData } from "../../interfaces/SaveData";
+/**
+ * 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 anonymous 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.
+ *
+ * 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 An optional function to run upon saving this key to disk. For example,
+ *                        this allows features to only save data to disk if the feature is enabled.
+ *                        Specify a value of `() => false` to completely disable saving this feature
+ *                        to disk. Disabling saving to disk is useful if you are using data that is
+ *                        not serializable. Alternatively, it could be useful if you want to use the
+ *                        save data manager to automatically reset variables on run/level/room, but
+ *                        not clutter the the "save#.dat" file with unnecessary keys.
+ */
+export declare function saveDataManager(key: string, v: SaveData, conditionalFunc?: () => boolean): void;
+/**
+ * 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.
+ */
+export declare function saveDataManagerLoad(): void;
+/**
+ * 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.
+ */
+export declare function saveDataManagerSave(): void;
+/**
+ * - 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)`
+ */
+export declare function saveDataManagerSetGlobal(): void;
+/**
+ * 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");
+ * ```
+ */
+export declare function saveDataManagerReset(key: string, childObjectKey: string): void;
+//# sourceMappingURL=exports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/exports.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAarD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,QAAQ,EACX,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI,CAuCN;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAKD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GACrB,IAAI,CAiBN"}

package/dist/features/saveDataManager/exports.lua

@@ -0,0 +1,183 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+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 anonymous 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.
+-- 
+-- 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 An optional function to run upon saving this key to disk. For example,
+-- this allows features to only save data to disk if the feature is enabled.
+-- Specify a value of `() => false` to completely disable saving this feature
+-- to disk. Disabling saving to disk is useful if you are using data that is
+-- not serializable. Alternatively, it could be useful if you want to use the
+-- save data manager to automatically reset variables on run/level/room, but
+-- not clutter the the "save#.dat" file with unnecessary keys.
+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
+    local saveDataKeys = __TS__ObjectKeys(v)
+    if #saveDataKeys == 1 and saveDataKeys[1] == "room" then
+        conditionalFunc = function() return false end
+    end
+    local saveDataTable = v
+    local saveDataCopy = deepCopy(nil, saveDataTable, SerializationType.NONE, key)
+    saveDataDefaultsMap[key] = saveDataCopy
+    if conditionalFunc ~= nil then
+        saveDataConditionalFuncMap:set(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

@@ -0,0 +1,5 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="typescript-to-lua/language-extensions" />
+import { SaveData } from "../../interfaces/SaveData";
+export declare function loadFromDisk(mod: Mod, oldSaveData: LuaTable<string, SaveData>): void;
+//# sourceMappingURL=load.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/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,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,GACtC,IAAI,CAsDN"}

package/dist/features/saveDataManager/load.lua

@@ -0,0 +1,72 @@
+local ____lualib = require("lualib_bundle")
+local __TS__StringTrim = ____lualib.__TS__StringTrim
+local ____exports = {}
+local readSaveDatFile, tryLoadModData, DEFAULT_MOD_DATA
+local ____jsonHelpers = require("functions.jsonHelpers")
+local jsonDecode = ____jsonHelpers.jsonDecode
+local ____log = require("functions.log")
+local log = ____log.log
+local logError = ____log.logError
+local ____table = require("functions.table")
+local iterateTableInOrder = ____table.iterateTableInOrder
+local ____types = require("functions.types")
+local isString = ____types.isString
+local isTable = ____types.isTable
+local ____merge = require("features.saveDataManager.merge")
+local merge = ____merge.merge
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
+function readSaveDatFile(self, mod)
+    local renderFrameCount = Isaac.GetFrameCount()
+    local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)
+    if not ok then
+        logError((("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
+        return DEFAULT_MOD_DATA
+    end
+    if jsonStringOrErrMsg == nil then
+        return DEFAULT_MOD_DATA
+    end
+    local jsonStringTrimmed = __TS__StringTrim(jsonStringOrErrMsg)
+    if jsonStringTrimmed == "" then
+        return DEFAULT_MOD_DATA
+    end
+    return jsonStringTrimmed
+end
+function tryLoadModData(mod)
+    return mod:LoadData()
+end
+DEFAULT_MOD_DATA = "{}"
+function ____exports.loadFromDisk(self, mod, oldSaveData)
+    if not mod:HasData() then
+        return
+    end
+    local jsonString = readSaveDatFile(nil, mod)
+    local newSaveData = jsonDecode(nil, jsonString)
+    if SAVE_DATA_MANAGER_DEBUG then
+        log("Converted data from the \"save#.dat\" to a Lua table.")
+    end
+    iterateTableInOrder(
+        nil,
+        newSaveData,
+        function(____, key, value)
+            if not isString(nil, key) then
+                return
+            end
+            if not isTable(nil, value) then
+                return
+            end
+            local oldSaveDataForSubscriber = oldSaveData[key]
+            if oldSaveDataForSubscriber == nil then
+                return
+            end
+            if SAVE_DATA_MANAGER_DEBUG then
+                log("Merging in stored data for feature: " .. key)
+            end
+            merge(nil, oldSaveDataForSubscriber, value, key)
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+    log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " loaded data from the \"save#.dat\" file.")
+end
+return ____exports

package/dist/features/saveDataManager/main.d.ts

@@ -0,0 +1,4 @@
+import { SaveDataKey } from "../../enums/private/SaveDataKey";
+import { SaveData } from "../../interfaces/SaveData";
+export declare function restoreDefaultSaveData(subscriberName: string, saveData: SaveData, saveDataKey: SaveDataKey): void;
+//# sourceMappingURL=main.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/main.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAK9D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAwGrD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA6CN"}

package/dist/features/saveDataManager/main.lua

@@ -0,0 +1,134 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local postPlayerInit, preGameExit, postNewLevel, postNewRoomEarly, restoreDefaultsAll, restoreDefaults, clearAndCopyAllElements, RESETTABLE_SAVE_DATA_KEYS, mod, loadedDataOnThisRun
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ModCallback = ____isaac_2Dtypescript_2Ddefinitions.ModCallback
+local ____cachedClasses = require("cachedClasses")
+local game = ____cachedClasses.game
+local ____ModCallbackCustom = require("enums.ModCallbackCustom")
+local ModCallbackCustom = ____ModCallbackCustom.ModCallbackCustom
+local ____SaveDataKey = require("enums.private.SaveDataKey")
+local SaveDataKey = ____SaveDataKey.SaveDataKey
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____deepCopy = require("functions.deepCopy")
+local deepCopy = ____deepCopy.deepCopy
+local ____log = require("functions.log")
+local logError = ____log.logError
+local ____table = require("functions.table")
+local clearTable = ____table.clearTable
+local iterateTableInOrder = ____table.iterateTableInOrder
+local ____load = require("features.saveDataManager.load")
+local loadFromDisk = ____load.loadFromDisk
+local ____maps = require("features.saveDataManager.maps")
+local saveDataConditionalFuncMap = ____maps.saveDataConditionalFuncMap
+local saveDataDefaultsMap = ____maps.saveDataDefaultsMap
+local saveDataMap = ____maps.saveDataMap
+local ____save = require("features.saveDataManager.save")
+local saveToDisk = ____save.saveToDisk
+local ____saveDataManagerConstants = require("features.saveDataManager.saveDataManagerConstants")
+local SAVE_DATA_MANAGER_DEBUG = ____saveDataManagerConstants.SAVE_DATA_MANAGER_DEBUG
+local SAVE_DATA_MANAGER_FEATURE_NAME = ____saveDataManagerConstants.SAVE_DATA_MANAGER_FEATURE_NAME
+function postPlayerInit(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
+    if loadedDataOnThisRun then
+        return
+    end
+    loadedDataOnThisRun = true
+    loadFromDisk(nil, mod, saveDataMap)
+    local gameFrameCount = game:GetFrameCount()
+    local isContinued = gameFrameCount ~= 0
+    if not isContinued then
+        restoreDefaultsAll(nil)
+    end
+end
+function preGameExit(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
+    saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+    restoreDefaultsAll(nil)
+    loadedDataOnThisRun = false
+end
+function postNewLevel(self)
+    restoreDefaults(nil, SaveDataKey.LEVEL)
+end
+function postNewRoomEarly(self)
+    restoreDefaults(nil, SaveDataKey.ROOM)
+end
+function restoreDefaultsAll(self)
+    restoreDefaults(nil, SaveDataKey.RUN)
+    restoreDefaults(nil, SaveDataKey.LEVEL)
+    restoreDefaults(nil, SaveDataKey.ROOM)
+end
+function restoreDefaults(self, saveDataKey)
+    iterateTableInOrder(
+        nil,
+        saveDataMap,
+        function(____, subscriberName, saveData)
+            ____exports.restoreDefaultSaveData(nil, subscriberName, saveData, saveDataKey)
+        end,
+        SAVE_DATA_MANAGER_DEBUG
+    )
+end
+function ____exports.restoreDefaultSaveData(self, subscriberName, saveData, saveDataKey)
+    if not RESETTABLE_SAVE_DATA_KEYS:has(saveDataKey) then
+        error("Unknown save data key name of: " .. saveDataKey)
+    end
+    local childTable = saveData[saveDataKey]
+    if childTable == nil then
+        return
+    end
+    local saveDataDefaults = saveDataDefaultsMap[subscriberName]
+    if saveDataDefaults == nil then
+        logError("Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+        return
+    end
+    local childTableDefaults = saveDataDefaults[saveDataKey]
+    if childTableDefaults == nil then
+        logError(((("Failed to find the default copy of the child table \"" .. saveDataKey) .. "\" for subscriber \"") .. subscriberName) .. "\". This error usually means that your save data is out of date. You can try purging all of your save data by deleting the following directory: C:\\Program Files (x86)\\Steam\\steamapps\\common\\The Binding of Isaac Rebirth\\data")
+        return
+    end
+    local childTableDefaultsCopy = deepCopy(nil, childTableDefaults, SerializationType.NONE, (subscriberName .. " --> ") .. saveDataKey)
+    clearAndCopyAllElements(nil, childTable, childTableDefaultsCopy)
+end
+function clearAndCopyAllElements(self, oldTable, newTable)
+    clearTable(nil, oldTable)
+    for key, value in pairs(newTable) do
+        oldTable[key] = value
+    end
+end
+RESETTABLE_SAVE_DATA_KEYS = __TS__New(Set, {SaveDataKey.RUN, SaveDataKey.LEVEL, SaveDataKey.ROOM})
+mod = nil
+loadedDataOnThisRun = false
+---
+-- @internal
+function ____exports.saveDataManagerInit(self, incomingMod)
+    mod = incomingMod
+    mod:AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit)
+    mod:AddCallback(ModCallback.PRE_GAME_EXIT, preGameExit)
+    mod:AddCallback(ModCallback.POST_NEW_LEVEL, postNewLevel)
+    mod:AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly)
+end
+---
+-- @internal
+function ____exports.forceSaveDataManagerSave(self)
+    if mod == nil then
+        return
+    end
+    saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+end
+---
+-- @internal
+function ____exports.forceSaveDataManagerLoad(self)
+    if mod == nil then
+        return
+    end
+    loadFromDisk(nil, mod, saveDataMap)
+end
+return ____exports

package/dist/features/saveDataManager/maps.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="typescript-to-lua/language-extensions" />
+import { SaveData } from "../../interfaces/SaveData";
+/**
+ * The save data map is indexed by subscriber name. We use Lua tables instead of TypeScriptToLua
+ * Maps for the master map so that we can access the variables via the in-game console when
+ * debugging. (TSTL Maps don't expose the map keys as normal keys.)
+ */
+export declare const saveDataMap: LuaTable<string, SaveData>;
+export declare const saveDataDefaultsMap: LuaTable<string, SaveData>;
+export declare const saveDataConditionalFuncMap: Map<string, () => boolean>;
+//# sourceMappingURL=maps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maps.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/maps.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,WAAW,4BAAmC,CAAC;AAE5D,eAAO,MAAM,mBAAmB,4BAAmC,CAAC;AACpE,eAAO,MAAM,0BAA0B,oBAAyB,OAAO,CAAG,CAAC"}

package/dist/features/saveDataManager/maps.lua

@@ -0,0 +1,11 @@
+local ____lualib = require("lualib_bundle")
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+--- The save data map is indexed by subscriber name. We use Lua tables instead of TypeScriptToLua
+-- Maps for the master map so that we can access the variables via the in-game console when
+-- debugging. (TSTL Maps don't expose the map keys as normal keys.)
+____exports.saveDataMap = {}
+____exports.saveDataDefaultsMap = {}
+____exports.saveDataConditionalFuncMap = __TS__New(Map)
+return ____exports

package/dist/features/saveDataManager/merge.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="typescript-to-lua/language-extensions" />
+/**
+ * `merge` takes the values from a new table and recursively merges them into an old object (while
+ * performing appropriate deserialization).
+ *
+ * It supports the following object types:
+ *
+ * - `LuaTable` / basic TSTL objects
+ * - TSTL `Map`
+ * - TSTL `Set`
+ * - TSTL classes
+ * - `DefaultMap`
+ * - Isaac `Color` objects
+ * - Isaac `KColor` objects
+ * - Isaac `RNG` objects
+ * - Isaac `Vector` objects
+ *
+ * Since it is common for a variable to have a type of `something | null`, we must iterate over the
+ * new object and copy over all of the values. (A value of null transpiles to nil, which means the
+ * table key does not exist.) The consequence of this is that it can copy over old variables that
+ * are no longer used in the code, or copy over old variables of a different type, which can cause
+ * run-time errors. In such cases, users will have to manually delete their save data.
+ */
+export declare function merge(oldObject: LuaTable<AnyNotNil, unknown> | Map<AnyNotNil, unknown> | Set<AnyNotNil>, newTable: LuaTable<AnyNotNil, unknown>, traversalDescription: string): void;
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../../../../packages/isaacscript-common/src/features/saveDataManager/merge.ts"],"names":[],"mappings":";AAgBA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CACnB,SAAS,EACL,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,GAC5B,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GACvB,GAAG,CAAC,SAAS,CAAC,EAClB,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,EACtC,oBAAoB,EAAE,MAAM,GAC3B,IAAI,CA2BN"}