isaacscript-common 6.6.0 → 6.6.1-dev.2

package/features/saveDataManager/exports.js

@@ -0,0 +1,183 @@
+import { SerializationType } from "../../enums/SerializationType";
+import { errorIfFeaturesNotInitialized } from "../../featuresInitialized";
+import { deepCopy } from "../../functions/deepCopy";
+import { isString } from "../../functions/types";
+import { forceSaveDataManagerLoad, forceSaveDataManagerSave, restoreDefaultSaveData, } from "./main";
+import { saveDataConditionalFuncMap, saveDataDefaultsMap, saveDataMap, } from "./maps";
+import { SAVE_DATA_MANAGER_FEATURE_NAME } from "./saveDataManagerConstants";
+/**
+ * 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 function saveDataManager(key, v, conditionalFunc) {
+    errorIfFeaturesNotInitialized(SAVE_DATA_MANAGER_FEATURE_NAME);
+    if (!isString(key)) {
+        error(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} requires that keys are strings. You tried to use a key of type: ${typeof key}`);
+    }
+    if (saveDataMap.has(key)) {
+        error(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} is already managing save data for a key of: ${key}`);
+    }
+    // Add the new save data to the map.
+    saveDataMap.set(key, v);
+    // If the only key in the save data is "room", then we don't have to worry about saving this data
+    // to disk (because the room would be reloaded upon resuming a continued run).
+    const saveDataKeys = Object.keys(v);
+    if (saveDataKeys.length === 1 && saveDataKeys[0] === "room") {
+        conditionalFunc = () => false;
+    }
+    // Make a copy of the initial save data so that we can use it to restore the default values later
+    // on.
+    const saveDataTable = v;
+    const saveDataCopy = deepCopy(saveDataTable, SerializationType.NONE, key);
+    saveDataDefaultsMap.set(key, saveDataCopy);
+    // Store the conditional function for later, if present.
+    if (conditionalFunc !== undefined) {
+        saveDataConditionalFuncMap.set(key, conditionalFunc);
+    }
+}
+/**
+ * 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 function saveDataManagerLoad() {
+    errorIfFeaturesNotInitialized(SAVE_DATA_MANAGER_FEATURE_NAME);
+    forceSaveDataManagerLoad();
+}
+/**
+ * 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 function saveDataManagerSave() {
+    errorIfFeaturesNotInitialized(SAVE_DATA_MANAGER_FEATURE_NAME);
+    forceSaveDataManagerSave();
+}
+/**
+ * - 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 function saveDataManagerSetGlobal() {
+    errorIfFeaturesNotInitialized(SAVE_DATA_MANAGER_FEATURE_NAME);
+    g = saveDataMap; // eslint-disable-line @typescript-eslint/no-unused-vars
+    gd = saveDataDefaultsMap; // eslint-disable-line @typescript-eslint/no-unused-vars
+}
+/**
+ * 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 function saveDataManagerReset(key, childObjectKey) {
+    errorIfFeaturesNotInitialized(SAVE_DATA_MANAGER_FEATURE_NAME);
+    if (!isString(key)) {
+        error(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} requires that keys are strings. You tried to use a key of type: ${typeof key}`);
+    }
+    const saveData = saveDataMap.get(key);
+    if (saveData === undefined) {
+        error(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} is not managing save data for a key of: ${key}`);
+    }
+    restoreDefaultSaveData(key, saveData, childObjectKey);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhwb3J0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL2V4cG9ydHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbEUsT0FBTyxFQUFFLDZCQUE2QixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDMUUsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVqRCxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLHdCQUF3QixFQUN4QixzQkFBc0IsR0FDdkIsTUFBTSxRQUFRLENBQUM7QUFDaEIsT0FBTyxFQUNMLDBCQUEwQixFQUMxQixtQkFBbUIsRUFDbkIsV0FBVyxHQUNaLE1BQU0sUUFBUSxDQUFDO0FBQ2hCLE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBRTVFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FvRkc7QUFDSCxNQUFNLFVBQVUsZUFBZSxDQUM3QixHQUFXLEVBQ1gsQ0FBVyxFQUNYLGVBQStCO0lBRS9CLDZCQUE2QixDQUFDLDhCQUE4QixDQUFDLENBQUM7SUFFOUQsSUFBSSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsRUFBRTtRQUNsQixLQUFLLENBQ0gsT0FBTyw4QkFBOEIsb0VBQW9FLE9BQU8sR0FBRyxFQUFFLENBQ3RILENBQUM7S0FDSDtJQUVELElBQUksV0FBVyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRTtRQUN4QixLQUFLLENBQ0gsT0FBTyw4QkFBOEIsZ0RBQWdELEdBQUcsRUFBRSxDQUMzRixDQUFDO0tBQ0g7SUFFRCxvQ0FBb0M7SUFDcEMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFFeEIsaUdBQWlHO0lBQ2pHLDhFQUE4RTtJQUM5RSxNQUFNLFlBQVksR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3BDLElBQUksWUFBWSxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksWUFBWSxDQUFDLENBQUMsQ0FBQyxLQUFLLE1BQU0sRUFBRTtRQUMzRCxlQUFlLEdBQUcsR0FBRyxFQUFFLENBQUMsS0FBSyxDQUFDO0tBQy9CO0lBRUQsaUdBQWlHO0lBQ2pHLE1BQU07SUFDTixNQUFNLGFBQWEsR0FBRyxDQUFpQyxDQUFDO0lBQ3hELE1BQU0sWUFBWSxHQUFHLFFBQVEsQ0FDM0IsYUFBYSxFQUNiLGlCQUFpQixDQUFDLElBQUksRUFDdEIsR0FBRyxDQUNRLENBQUM7SUFDZCxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLFlBQVksQ0FBQyxDQUFDO0lBRTNDLHdEQUF3RDtJQUN4RCxJQUFJLGVBQWUsS0FBSyxTQUFTLEVBQUU7UUFDakMsMEJBQTBCLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxlQUFlLENBQUMsQ0FBQztLQUN0RDtBQUNILENBQUM7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQjtJQUNqQyw2QkFBNkIsQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO0lBQzlELHdCQUF3QixFQUFFLENBQUM7QUFDN0IsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsbUJBQW1CO0lBQ2pDLDZCQUE2QixDQUFDLDhCQUE4QixDQUFDLENBQUM7SUFDOUQsd0JBQXdCLEVBQUUsQ0FBQztBQUM3QixDQUFDO0FBS0Q7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLHdCQUF3QjtJQUN0Qyw2QkFBNkIsQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO0lBRTlELENBQUMsR0FBRyxXQUFXLENBQUMsQ0FBQyx3REFBd0Q7SUFDekUsRUFBRSxHQUFHLG1CQUFtQixDQUFDLENBQUMsd0RBQXdEO0FBQ3BGLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE1BQU0sVUFBVSxvQkFBb0IsQ0FDbEMsR0FBVyxFQUNYLGNBQXNCO0lBRXRCLDZCQUE2QixDQUFDLDhCQUE4QixDQUFDLENBQUM7SUFFOUQsSUFBSSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsRUFBRTtRQUNsQixLQUFLLENBQ0gsT0FBTyw4QkFBOEIsb0VBQW9FLE9BQU8sR0FBRyxFQUFFLENBQ3RILENBQUM7S0FDSDtJQUVELE1BQU0sUUFBUSxHQUFHLFdBQVcsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUF3QyxDQUFDO0lBQzdFLElBQUksUUFBUSxLQUFLLFNBQVMsRUFBRTtRQUMxQixLQUFLLENBQ0gsT0FBTyw4QkFBOEIsNENBQTRDLEdBQUcsRUFBRSxDQUN2RixDQUFDO0tBQ0g7SUFFRCxzQkFBc0IsQ0FBQyxHQUFHLEVBQUUsUUFBUSxFQUFFLGNBQTZCLENBQUMsQ0FBQztBQUN2RSxDQUFDIn0=

package/features/saveDataManager/exports.lua

@@ -181,3 +181,5 @@ function ____exports.saveDataManagerReset(self, key, childObjectKey)
     restoreDefaultSaveData(nil, key, saveData, childObjectKey)
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL2V4cG9ydHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFDQSw4QkFBa0M7QUFBekI7QUFDVCxnQ0FBOEM7QUFBckM7QUFDVCxxQkFBeUI7QUFBaEI7QUFDVCxrQkFBeUI7QUFBaEI7QUFFVCxpQkFJTztBQUhMO0FBQ0E7QUFDQTtBQUVGLGlCQUlPO0FBSEw7QUFDQTtBQUNBO0FBRUYscUNBQStDO0FBQXRDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUF1RlQsMkNBQ0UsS0FDQSxHQUNBO0lBRUEsbUNBQThCO1dBRXpCLGNBQVM7UUFDWixRQUNFLFVBQU8sbUNBQThCLHdFQUFvRSxhQUFPOztPQUloSCxZQUFnQjtRQUNsQixRQUNFLFVBQU8sbUNBQThCLG9EQUFnRDs7QUFLekYsZ0JBQWdCLE9BQUs7QUFJZix5QkFBZSxpQkFBWTtPQUM3QixpQkFBd0IsTUFBSyxhQUFhLE1BQU87QUFDbkQsMEJBQWtCLFdBQU0sWUFBTjs7QUFLZCwwQkFBZ0I7QUFDaEIseUJBQWUsY0FDbkIsZUFDQSx3QkFDQTtBQUVGLHdCQUF3QixPQUFLO09BR3pCO1FBQ0YsMkJBQTJCLElBQUksS0FBSzs7QUF6Q3hDOzs7Ozs7O0FBcURBO0lBQ0UsbUNBQThCO0lBQzlCO0FBRkY7Ozs7QUFVQTtJQUNFLG1DQUE4QjtJQUM5QjtBQUZGOzs7Ozs7QUFlQTtJQUNFLG1DQUE4QjtBQUU5QixRQUFJO0FBQ0osU0FBSztBQUpQOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBMkJBLGdEQUNFLEtBQ0E7SUFFQSxtQ0FBOEI7V0FFekIsY0FBUztRQUNaLFFBQ0UsVUFBTyxtQ0FBOEIsd0VBQW9FLGFBQU87O0FBSTlHLHFCQUFXLFlBQWdCO09BQzdCO1FBQ0YsUUFDRSxVQUFPLG1DQUE4QixnREFBNEM7O0lBSXJGLDRCQUF1QixLQUFLLFVBQVU7QUFuQnhDIiwiZmlsZSI6ImV4cG9ydHMubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/saveDataManager/load.js

@@ -0,0 +1,69 @@
+import { jsonDecode } from "../../functions/jsonHelpers";
+import { log, logError } from "../../functions/log";
+import { iterateTableInOrder } from "../../functions/table";
+import { isString, isTable } from "../../functions/types";
+import { merge } from "./merge";
+import { SAVE_DATA_MANAGER_DEBUG, SAVE_DATA_MANAGER_FEATURE_NAME, } from "./saveDataManagerConstants";
+const DEFAULT_MOD_DATA = "{}";
+export function loadFromDisk(mod, oldSaveData) {
+    if (!mod.HasData()) {
+        // There is no "save#.dat" file for this save slot.
+        return;
+    }
+    // First, read the "save#.dat" file into a Lua table.
+    const jsonString = readSaveDatFile(mod);
+    const newSaveData = jsonDecode(jsonString);
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (SAVE_DATA_MANAGER_DEBUG) {
+        log('Converted data from the "save#.dat" to a Lua table.');
+    }
+    // Second, iterate over all the fields of the new table.)
+    iterateTableInOrder(newSaveData, (key, value) => {
+        // All elements of loaded save data should have keys that are strings equal to the name of the
+        // subscriber/feature. Ignore elements with other types of keys.
+        if (!isString(key)) {
+            return;
+        }
+        // All elements of loaded save data should be tables that contain fields corresponding to the
+        // SaveData interface. Ignore elements that are not tables.
+        if (!isTable(value)) {
+            return;
+        }
+        // Ignore elements that represent subscriptions that no longer exist in the current save data.
+        const oldSaveDataForSubscriber = oldSaveData.get(key);
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (oldSaveDataForSubscriber === undefined) {
+            return;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (SAVE_DATA_MANAGER_DEBUG) {
+            log(`Merging in stored data for feature: ${key}`);
+        }
+        // We do not want to blow away the child tables of the existing map, because save data could
+        // contain out-of-date fields. Instead, merge it one field at a time in a recursive way (and
+        // convert Lua tables back to TypeScriptToLua Maps, if necessary).
+        merge(oldSaveDataForSubscriber, value, key);
+    }, SAVE_DATA_MANAGER_DEBUG);
+    log(`The ${SAVE_DATA_MANAGER_FEATURE_NAME} loaded data from the "save#.dat" file.`);
+}
+function readSaveDatFile(mod) {
+    const renderFrameCount = Isaac.GetFrameCount();
+    const [ok, jsonStringOrErrMsg] = pcall(tryLoadModData, mod);
+    if (!ok) {
+        logError(`Failed to read from the "save#.dat" file on render frame ${renderFrameCount}: ${jsonStringOrErrMsg}`);
+        return DEFAULT_MOD_DATA;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (jsonStringOrErrMsg === undefined) {
+        return DEFAULT_MOD_DATA;
+    }
+    const jsonStringTrimmed = jsonStringOrErrMsg.trim();
+    if (jsonStringTrimmed === "") {
+        return DEFAULT_MOD_DATA;
+    }
+    return jsonStringTrimmed;
+}
+function tryLoadModData(mod) {
+    return mod.LoadData();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL2xvYWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ3pELE9BQU8sRUFBRSxHQUFHLEVBQUUsUUFBUSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDcEQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDNUQsT0FBTyxFQUFFLFFBQVEsRUFBRSxPQUFPLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUUxRCxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ2hDLE9BQU8sRUFDTCx1QkFBdUIsRUFDdkIsOEJBQThCLEdBQy9CLE1BQU0sNEJBQTRCLENBQUM7QUFFcEMsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLENBQUM7QUFFOUIsTUFBTSxVQUFVLFlBQVksQ0FDMUIsR0FBUSxFQUNSLFdBQXVDO0lBRXZDLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLEVBQUU7UUFDbEIsbURBQW1EO1FBQ25ELE9BQU87S0FDUjtJQUVELHFEQUFxRDtJQUNyRCxNQUFNLFVBQVUsR0FBRyxlQUFlLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDeEMsTUFBTSxXQUFXLEdBQUcsVUFBVSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBRTNDLHVFQUF1RTtJQUN2RSxJQUFJLHVCQUF1QixFQUFFO1FBQzNCLEdBQUcsQ0FBQyxxREFBcUQsQ0FBQyxDQUFDO0tBQzVEO0lBRUQseURBQXlEO0lBQ3pELG1CQUFtQixDQUNqQixXQUFXLEVBQ1gsQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLEVBQUU7UUFDYiw4RkFBOEY7UUFDOUYsZ0VBQWdFO1FBQ2hFLElBQUksQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEVBQUU7WUFDbEIsT0FBTztTQUNSO1FBRUQsNkZBQTZGO1FBQzdGLDJEQUEyRDtRQUMzRCxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFO1lBQ25CLE9BQU87U0FDUjtRQUVELDhGQUE4RjtRQUM5RixNQUFNLHdCQUF3QixHQUFHLFdBQVcsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdEQsdUVBQXVFO1FBQ3ZFLElBQUksd0JBQXdCLEtBQUssU0FBUyxFQUFFO1lBQzFDLE9BQU87U0FDUjtRQUVELHVFQUF1RTtRQUN2RSxJQUFJLHVCQUF1QixFQUFFO1lBQzNCLEdBQUcsQ0FBQyx1Q0FBdUMsR0FBRyxFQUFFLENBQUMsQ0FBQztTQUNuRDtRQUVELDRGQUE0RjtRQUM1Riw0RkFBNEY7UUFDNUYsa0VBQWtFO1FBQ2xFLEtBQUssQ0FBQyx3QkFBb0MsRUFBRSxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDMUQsQ0FBQyxFQUNELHVCQUF1QixDQUN4QixDQUFDO0lBRUYsR0FBRyxDQUNELE9BQU8sOEJBQThCLHlDQUF5QyxDQUMvRSxDQUFDO0FBQ0osQ0FBQztBQUVELFNBQVMsZUFBZSxDQUFDLEdBQVE7SUFDL0IsTUFBTSxnQkFBZ0IsR0FBRyxLQUFLLENBQUMsYUFBYSxFQUFFLENBQUM7SUFFL0MsTUFBTSxDQUFDLEVBQUUsRUFBRSxrQkFBa0IsQ0FBQyxHQUFHLEtBQUssQ0FBQyxjQUFjLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDNUQsSUFBSSxDQUFDLEVBQUUsRUFBRTtRQUNQLFFBQVEsQ0FDTiw0REFBNEQsZ0JBQWdCLEtBQUssa0JBQWtCLEVBQUUsQ0FDdEcsQ0FBQztRQUNGLE9BQU8sZ0JBQWdCLENBQUM7S0FDekI7SUFFRCx1RUFBdUU7SUFDdkUsSUFBSSxrQkFBa0IsS0FBSyxTQUFTLEVBQUU7UUFDcEMsT0FBTyxnQkFBZ0IsQ0FBQztLQUN6QjtJQUVELE1BQU0saUJBQWlCLEdBQUcsa0JBQWtCLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDcEQsSUFBSSxpQkFBaUIsS0FBSyxFQUFFLEVBQUU7UUFDNUIsT0FBTyxnQkFBZ0IsQ0FBQztLQUN6QjtJQUVELE9BQU8saUJBQWlCLENBQUM7QUFDM0IsQ0FBQztBQUVELFNBQVMsY0FBYyxDQUFhLEdBQVE7SUFDMUMsT0FBTyxHQUFHLENBQUMsUUFBUSxFQUFFLENBQUM7QUFDeEIsQ0FBQyJ9

package/features/saveDataManager/load.lua

@@ -70,3 +70,5 @@ function ____exports.loadFromDisk(self, mod, oldSaveData)
     log(("The " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " loaded data from the \"save#.dat\" file.")
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL2xvYWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O01Bd0VTLGlCQXdCQSxnQkFyRkg7QUFYTix3QkFBMkI7QUFBbEI7QUFDVCxnQkFBOEI7QUFBckI7QUFBSztBQUNkLGtCQUFvQztBQUEzQjtBQUNULGtCQUFrQztBQUF6QjtBQUFVO0FBRW5CLGtCQUFzQjtBQUFiO0FBQ1QscUNBR087QUFGTDtBQUNBO0FBZ0VGLFNBQVMsc0JBQWdCO0FBQ2pCLDZCQUFtQjtBQUVRLFVBQTFCLElBQUkscUJBQXNCLE1BQU0sZ0JBQWdCO1dBQ2xEO1FBQ0gsV0FDRSwwRUFBNEQsc0JBQWdCLFNBQUs7QUFFbkYsZUFBTzs7T0FJTDtBQUNGLGVBQU87O0FBR0gsOEJBQW9CO09BQ3RCLHFCQUFzQjtBQUN4QixlQUFPOztBQUdULFdBQU87O0FBR1QsU0FBUyxlQUEyQjtBQUNsQyxXQUFPLElBQUk7O0FBdEZQLG1CQUFtQjtBQUV6Qix3Q0FDRSxLQUNBO1dBRUssSUFBSTtBQUVQOztBQUlJLHVCQUFhLHFCQUFnQjtBQUM3Qix3QkFBYyxnQkFBVztPQUczQjtRQUNGLElBQUk7O0lBSU47O1FBQ0U7UUFDQSxlQUFDLEtBQUs7bUJBR0MsY0FBUztBQUNaOzttQkFLRyxhQUFRO0FBQ1g7O0FBSUksNkNBQTJCLFlBQWdCO2VBRTdDO0FBQ0Y7O2VBSUU7Z0JBQ0YsSUFBSSwwQ0FBdUM7O1lBTTdDLFdBQU0sMEJBQXNDLE9BQU87UUE1QnJEO1FBOEJBOztJQUdGLEtBQ0UsVUFBTyxtQ0FBOEI7QUF2RHpDIiwiZmlsZSI6ImxvYWQubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/saveDataManager/main.js

@@ -0,0 +1,131 @@
+import { ModCallback } from "isaac-typescript-definitions";
+import { game } from "../../cachedClasses";
+import { ModCallbackCustom } from "../../enums/ModCallbackCustom";
+import { SaveDataKey } from "../../enums/private/SaveDataKey";
+import { SerializationType } from "../../enums/SerializationType";
+import { deepCopy } from "../../functions/deepCopy";
+import { logError } from "../../functions/log";
+import { clearTable, iterateTableInOrder } from "../../functions/table";
+import { loadFromDisk } from "./load";
+import { saveDataConditionalFuncMap, saveDataDefaultsMap, saveDataMap, } from "./maps";
+import { saveToDisk } from "./save";
+import { SAVE_DATA_MANAGER_DEBUG, SAVE_DATA_MANAGER_FEATURE_NAME, } from "./saveDataManagerConstants";
+const RESETTABLE_SAVE_DATA_KEYS = new Set([
+    SaveDataKey.RUN,
+    SaveDataKey.LEVEL,
+    SaveDataKey.ROOM,
+]);
+let mod = null;
+let loadedDataOnThisRun = false;
+/** @internal */
+export function saveDataManagerInit(incomingMod) {
+    mod = incomingMod;
+    mod.AddCallback(ModCallback.POST_PLAYER_INIT, postPlayerInit); // 9
+    mod.AddCallback(ModCallback.PRE_GAME_EXIT, preGameExit); // 17
+    mod.AddCallback(ModCallback.POST_NEW_LEVEL, postNewLevel); // 18
+    mod.AddCallbackCustom(ModCallbackCustom.POST_NEW_ROOM_EARLY, postNewRoomEarly); // 19
+}
+// ModCallback.POST_PLAYER_INIT (9)
+function postPlayerInit() {
+    if (mod === null) {
+        error(`The mod for the ${SAVE_DATA_MANAGER_FEATURE_NAME} was not initialized.`);
+    }
+    if (loadedDataOnThisRun) {
+        return;
+    }
+    loadedDataOnThisRun = true;
+    // We want to unconditionally load save data on every new run since there might be persistent data
+    // that is not tied to an individual run.
+    loadFromDisk(mod, saveDataMap);
+    const gameFrameCount = game.GetFrameCount();
+    const isContinued = gameFrameCount !== 0;
+    if (!isContinued) {
+        restoreDefaultsAll();
+    }
+    // On continued runs, the PostNewLevel callback will not fire, so we do not have to worry about
+    // saved data based on level getting overwritten.
+}
+// ModCallback.PRE_GAME_EXIT (17)
+function preGameExit() {
+    if (mod === null) {
+        error(`The mod for the ${SAVE_DATA_MANAGER_FEATURE_NAME} was not initialized.`);
+    }
+    // We unconditionally save variables to disk (because regardless of a save & quit or a death,
+    // persistent variables should be recorded).
+    saveToDisk(mod, saveDataMap, saveDataConditionalFuncMap);
+    restoreDefaultsAll();
+    loadedDataOnThisRun = false;
+}
+// ModCallback.POST_NEW_LEVEL (18)
+function postNewLevel() {
+    restoreDefaults(SaveDataKey.LEVEL);
+}
+// ModCallbackCustom.POST_NEW_ROOM_EARLY
+function postNewRoomEarly() {
+    restoreDefaults(SaveDataKey.ROOM);
+}
+function restoreDefaultsAll() {
+    restoreDefaults(SaveDataKey.RUN);
+    restoreDefaults(SaveDataKey.LEVEL);
+    restoreDefaults(SaveDataKey.ROOM);
+}
+function restoreDefaults(saveDataKey) {
+    iterateTableInOrder(saveDataMap, (subscriberName, saveData) => {
+        restoreDefaultSaveData(subscriberName, saveData, saveDataKey);
+    }, SAVE_DATA_MANAGER_DEBUG);
+}
+export function restoreDefaultSaveData(subscriberName, saveData, saveDataKey) {
+    // Only allow certain save data keys to be reset.
+    if (!RESETTABLE_SAVE_DATA_KEYS.has(saveDataKey)) {
+        error(`Unknown save data key name of: ${saveDataKey}`);
+    }
+    const childTable = saveData[saveDataKey];
+    if (childTable === undefined) {
+        // This feature does not happen to store any variables on this particular child table.
+        return;
+    }
+    // Get the default values for this feature.
+    const saveDataDefaults = saveDataDefaultsMap.get(subscriberName);
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (saveDataDefaults === undefined) {
+        logError(`Failed to find the default copy of the save data for subscriber: ${subscriberName}`);
+        return;
+    }
+    // Get the default values for the specific sub-table of this feature.
+    const childTableDefaults = saveDataDefaults[saveDataKey];
+    if (childTableDefaults === undefined) {
+        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;
+    }
+    // Make a new copy of the default child table.
+    const childTableDefaultsCopy = deepCopy(childTableDefaults, SerializationType.NONE, `${subscriberName} --> ${saveDataKey}`);
+    // We do not want to blow away the existing child table because we don't want to break any
+    // existing references. Instead, empty the table and copy all of the elements from the copy of the
+    // defaults table.
+    clearAndCopyAllElements(childTable, childTableDefaultsCopy);
+}
+/**
+ * Will empty the old table of all elements, and then shallow copy all the elements from the new
+ * table to the old table.
+ */
+function clearAndCopyAllElements(oldTable, newTable) {
+    clearTable(oldTable);
+    for (const [key, value] of pairs(newTable)) {
+        oldTable.set(key, value);
+    }
+}
+/** @internal */
+export function forceSaveDataManagerSave() {
+    if (mod === null) {
+        return;
+    }
+    saveToDisk(mod, saveDataMap, saveDataConditionalFuncMap);
+}
+/** @internal */
+export function forceSaveDataManagerLoad() {
+    if (mod === null) {
+        return;
+    }
+    loadFromDisk(mod, saveDataMap);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWFpbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL21haW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzNELE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUUzQyxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNsRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDOUQsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUMvQyxPQUFPLEVBQUUsVUFBVSxFQUFFLG1CQUFtQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFeEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLFFBQVEsQ0FBQztBQUN0QyxPQUFPLEVBQ0wsMEJBQTBCLEVBQzFCLG1CQUFtQixFQUNuQixXQUFXLEdBQ1osTUFBTSxRQUFRLENBQUM7QUFDaEIsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFFBQVEsQ0FBQztBQUNwQyxPQUFPLEVBQ0wsdUJBQXVCLEVBQ3ZCLDhCQUE4QixHQUMvQixNQUFNLDRCQUE0QixDQUFDO0FBRXBDLE1BQU0seUJBQXlCLEdBQTZCLElBQUksR0FBRyxDQUFDO0lBQ2xFLFdBQVcsQ0FBQyxHQUFHO0lBQ2YsV0FBVyxDQUFDLEtBQUs7SUFDakIsV0FBVyxDQUFDLElBQUk7Q0FDakIsQ0FBQyxDQUFDO0FBRUgsSUFBSSxHQUFHLEdBQXVCLElBQUksQ0FBQztBQUNuQyxJQUFJLG1CQUFtQixHQUFH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

package/features/saveDataManager/main.lua

@@ -132,3 +132,5 @@ function ____exports.forceSaveDataManagerLoad(self)
     loadFromDisk(nil, mod, saveDataMap)
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL21haW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7TUE2Q1MsZ0JBMkJBLGFBZ0JBLGNBS0Esa0JBSUEsb0JBTUEsaUJBaUVBLHlCQWxKSCwyQkFNRixLQUNBO0FBN0JKLDZDQUE0QjtBQUFuQjtBQUNULDBCQUFxQjtBQUFaO0FBRVQsOEJBQWtDO0FBQXpCO0FBQ1Qsd0JBQTRCO0FBQW5CO0FBQ1QsOEJBQWtDO0FBQXpCO0FBQ1QscUJBQXlCO0FBQWhCO0FBQ1QsZ0JBQXlCO0FBQWhCO0FBQ1Qsa0JBQWdEO0FBQXZDO0FBQVk7QUFFckIsaUJBQTZCO0FBQXBCO0FBQ1QsaUJBSU87QUFITDtBQUNBO0FBQ0E7QUFFRixpQkFBMkI7QUFBbEI7QUFDVCxxQ0FHTztBQUZMO0FBQ0E7QUEwQkYsU0FBUztPQUNILE9BQVE7UUFDVixPQUNFLHNCQUFtQixtQ0FBOEI7O09BSWpEO0FBQ0Y7O0FBRUYsMEJBQXNCO0lBSXRCLGtCQUFhLEtBQUs7QUFFWiwyQkFBaUIsS0FBSztBQUN0Qix3QkFBYyxrQkFBbUI7V0FDbEM7UUFDSDs7O0FBUUosU0FBUztPQUNILE9BQVE7UUFDVixPQUNFLHNCQUFtQixtQ0FBOEI7O0lBTXJELGdCQUFXLEtBQUssYUFBYTtJQUU3QjtBQUNBLDBCQUFzQjs7QUFJeEIsU0FBUztJQUNQLHFCQUFnQjs7QUFJbEIsU0FBUztJQUNQLHFCQUFnQjs7QUFHbEIsU0FBUztJQUNQLHFCQUFnQjtJQUNoQixxQkFBZ0I7SUFDaEIscUJBQWdCOztBQUdsQixTQUFTLHNCQUFnQjtJQUN2Qjs7UUFDRTtRQUNBLGVBQUMsZ0JBQWdCO1lBQ2Ysd0NBQXVCLGdCQUFnQixVQUFVO1FBRG5EO1FBR0E7OztBQUlKLGtEQUNFLGdCQUNBLFVBQ0E7V0FHSywwQkFBMEIsSUFBSTtRQUNqQyxNQUFNLHFDQUFrQzs7QUFHcEMsdUJBQWEsU0FBUztPQUN4QjtBQUVGOztBQUlJLDZCQUFtQixvQkFBd0I7T0FFN0M7UUFDRixTQUNFLHVFQUFvRTtBQUV0RTs7QUFJSSwrQkFBcUIsaUJBQWlCO09BQ3hDO1FBQ0YsWUFDRSwyREFBdUQsZ0JBQVcsMkJBQXFCLG1CQUFjO0FBRXZHOztBQUlJLG1DQUF5QixjQUM3QixvQkFDQSx5QkFDRyxrQkFBYyxZQUFRO0lBTTNCLDZCQUNFLFlBQ0E7QUEvQ0o7QUF1REEsU0FBUyw4QkFDUCxVQUNBO0lBRUEsZ0JBQVc7QUFFWCxRQUFZLEtBQUssU0FBVSxNQUFNO0FBQy9CLGlCQUFhLE9BQUs7OztBQXpKaEIsNEJBQXNELFVBQUksS0FBSSxDQUNsRSxpQkFDQSxtQkFDQTtBQUdFLE1BQTBCO0FBQzFCLHNCQUFzQjs7O0FBRzFCLCtDQUFvQztBQUNsQyxVQUFNO0lBRU4sSUFBSSxZQUFZLDhCQUE4QjtJQUM5QyxJQUFJLFlBQVksMkJBQTJCO0lBQzNDLElBQUksWUFBWSw0QkFBNEI7SUFDNUMsSUFBSSxrQkFDRix1Q0FDQTtBQVJKOzs7QUFvSkE7T0FDTSxPQUFRO0FBQ1Y7O0lBR0YsZ0JBQVcsS0FBSyxhQUFhO0FBTC9COzs7QUFTQTtPQUNNLE9BQVE7QUFDVjs7SUFHRixrQkFBYSxLQUFLO0FBTHBCIiwiZmlsZSI6Im1haW4ubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/saveDataManager/maps.js

@@ -0,0 +1,9 @@
+/**
+ * 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 const saveDataMap = new LuaTable();
+export const saveDataDefaultsMap = new LuaTable();
+export const saveDataConditionalFuncMap = new Map();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWFwcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL21hcHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUE7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLFdBQVcsR0FBRyxJQUFJLFFBQVEsRUFBb0IsQ0FBQztBQUU1RCxNQUFNLENBQUMsTUFBTSxtQkFBbUIsR0FBRyxJQUFJLFFBQVEsRUFBb0IsQ0FBQztBQUNwRSxNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyxJQUFJLEdBQUcsRUFBeUIsQ0FBQyJ9

package/features/saveDataManager/maps.lua

@@ -9,3 +9,5 @@ ____exports.saveDataMap = {}
 ____exports.saveDataDefaultsMap = {}
 ____exports.saveDataConditionalFuncMap = __TS__New(Map)
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL21hcHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7OztBQU9hLDBCQUFjO0FBRWQsa0NBQXNCO0FBQ3RCLHlDQUE2QixVQUFJIiwiZmlsZSI6Im1hcHMubHVhIiwic291cmNlUm9vdCI6IiJ9

package/features/saveDataManager/merge.js

@@ -0,0 +1,139 @@
+import { SerializationBrand } from "../../enums/private/SerializationBrand";
+import { SerializationType } from "../../enums/SerializationType";
+import { isArray } from "../../functions/array";
+import { deepCopy } from "../../functions/deepCopy";
+import { log } from "../../functions/log";
+import { deserializeIsaacAPIClass, isSerializedIsaacAPIClass, } from "../../functions/serialization";
+import { clearTable, iterateTableInOrder } from "../../functions/table";
+import { isTSTLMap, isTSTLSet } from "../../functions/tstlClass";
+import { isTable } from "../../functions/types";
+import { getTraversalDescription } from "../../functions/utils";
+import { SAVE_DATA_MANAGER_DEBUG } from "./saveDataManagerConstants";
+import { isSerializationBrand } from "./serializationBrand";
+/**
+ * `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 function merge(oldObject, newTable, traversalDescription) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (SAVE_DATA_MANAGER_DEBUG) {
+        log(`merge is traversing: ${traversalDescription}`);
+    }
+    if (!isTable(oldObject)) {
+        error("The first argument given to the merge function is not a table.");
+    }
+    if (!isTable(newTable)) {
+        error("The second argument given to the merge function is not a table.");
+    }
+    // First, handle the special case of an array with a shallow copy.
+    if (isArray(oldObject) && isArray(newTable)) {
+        mergeArray(oldObject, newTable);
+        return;
+    }
+    // Depending on whether we are working on a Lua table or a TypeScriptToLua object, we need to
+    // iterate in a specific way.
+    if (isTSTLMap(oldObject) || isTSTLSet(oldObject)) {
+        mergeTSTLObject(oldObject, newTable, traversalDescription);
+    }
+    else {
+        mergeTable(oldObject, newTable, traversalDescription);
+    }
+}
+function mergeArray(oldArray, newArray) {
+    // Assume that we should blow away all array values with whatever is present in the incoming
+    // array.
+    clearTable(oldArray);
+    iterateTableInOrder(newArray, (key, value) => {
+        oldArray.set(key, value);
+    }, SAVE_DATA_MANAGER_DEBUG);
+}
+function mergeTSTLObject(oldObject, newTable, traversalDescription) {
+    // We blow away the old object and recursively copy over all of the incoming values.
+    oldObject.clear();
+    // During serialization, we brand some Lua tables with a special identifier to signify that it has
+    // keys that should be deserialized to numbers.
+    const convertStringKeysToNumbers = newTable.has(SerializationBrand.OBJECT_WITH_NUMBER_KEYS);
+    iterateTableInOrder(newTable, (key, value) => {
+        if (isSerializationBrand(key)) {
+            return;
+        }
+        let keyToUse = key;
+        if (convertStringKeysToNumbers) {
+            const numberKey = tonumber(key);
+            if (numberKey === undefined) {
+                return;
+            }
+            keyToUse = numberKey;
+        }
+        if (isTSTLMap(oldObject)) {
+            let valueCopy;
+            if (isTable(value)) {
+                valueCopy = deepCopy(value, SerializationType.DESERIALIZE, traversalDescription);
+            }
+            else {
+                valueCopy = value;
+            }
+            oldObject.set(keyToUse, valueCopy);
+        }
+        else if (isTSTLSet(oldObject)) {
+            oldObject.add(keyToUse);
+        }
+    }, SAVE_DATA_MANAGER_DEBUG);
+}
+function mergeTable(oldTable, newTable, traversalDescription) {
+    iterateTableInOrder(newTable, (key, value) => {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (SAVE_DATA_MANAGER_DEBUG) {
+            const valueToPrint = value === "" ? "(empty string)" : `${value}`;
+            log(`merge is merging: ${traversalDescription} --> ${valueToPrint}`);
+        }
+        if (isSerializationBrand(key)) {
+            return;
+        }
+        // Handle the special case of serialized Isaac API classes.
+        if (isSerializedIsaacAPIClass(value)) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (SAVE_DATA_MANAGER_DEBUG) {
+                log("merge found a serialized Isaac API class.");
+            }
+            const deserializedObject = deserializeIsaacAPIClass(value);
+            oldTable.set(key, deserializedObject);
+            return;
+        }
+        if (isTable(value)) {
+            let oldValue = oldTable.get(key);
+            if (!isTable(oldValue)) {
+                // The child table does not exist on the old table. However, we still need to copy over
+                // the new table, because we need to handle data types like "Foo | null". Thus, set up a
+                // blank sub-table on the old table, and continue to recursively merge..
+                oldValue = new LuaTable();
+                oldTable.set(key, oldValue);
+            }
+            traversalDescription = getTraversalDescription(key, traversalDescription);
+            merge(oldValue, value, traversalDescription);
+        }
+        else {
+            // Base case: copy the value
+            oldTable.set(key, value);
+        }
+    }, SAVE_DATA_MANAGER_DEBUG);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVyZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9wYWNrYWdlcy9pc2FhY3NjcmlwdC1jb21tb24vc3JjL2ZlYXR1cmVzL3NhdmVEYXRhTWFuYWdlci9tZXJnZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3Q0FBd0MsQ0FBQztBQUM1RSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNsRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDaEQsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUMxQyxPQUFPLEVBQ0wsd0JBQXdCLEVBQ3hCLHlCQUF5QixHQUMxQixNQUFNLCtCQUErQixDQUFDO0FBQ3ZDLE9BQU8sRUFBRSxVQUFVLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUN4RSxPQUFPLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNoRCxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNoRSxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUNyRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUU1RDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBcUJHO0FBQ0gsTUFBTSxVQUFVLEtBQUssQ0FDbkIsU0FHa0IsRUFDbEIsUUFBc0MsRUFDdEMsb0JBQTRCO0lBRTVCLHVFQUF1RTtJQUN2RSxJQUFJLHVCQUF1QixFQUFFO1FBQzNCLEdBQUcsQ0FBQyx3QkFBd0Isb0JBQW9CLEVBQUUsQ0FBQyxDQUFDO0tB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

package/features/saveDataManager/merge.lua

@@ -150,3 +150,5 @@ function mergeTable(self, oldTable, newTable, traversalDescription)
     )
 end
 return ____exports
+
+--# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3BhY2thZ2VzL2lzYWFjc2NyaXB0LWNvbW1vbi9zcmMvZmVhdHVyZXMvc2F2ZURhdGFNYW5hZ2VyL21lcmdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7TUEwRVMsWUFnQkEsaUJBbURBO0FBN0lULCtCQUFtQztBQUExQjtBQUNULDhCQUFrQztBQUF6QjtBQUNULGtCQUF3QjtBQUFmO0FBQ1QscUJBQXlCO0FBQWhCO0FBQ1QsZ0JBQW9CO0FBQVg7QUFDVCwwQkFHTztBQUZMO0FBQ0E7QUFFRixrQkFBZ0Q7QUFBdkM7QUFBWTtBQUNyQixzQkFBcUM7QUFBNUI7QUFBVztBQUNwQixrQkFBd0I7QUFBZjtBQUNULGtCQUF3QztBQUEvQjtBQUNULHFDQUF3QztBQUEvQjtBQUNULCtCQUFxQztBQUE1Qjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBd0JULGlDQUNFLFdBSUEsVUFDQTtPQUdJO1FBQ0YsSUFBSSwyQkFBd0I7O1dBR3pCLGFBQVE7UUFDWCxNQUFNOztXQUdILGFBQVE7UUFDWCxNQUFNOztPQUlKLGFBQVEsZUFBYyxhQUFRO1FBQ2hDLGdCQUFXLFdBQVc7QUFDdEI7O09BS0UsZUFBVSxjQUFjLGVBQVU7UUFDcEMscUJBQWdCLFdBQVcsVUFBVTs7UUFFckMsZ0JBQVcsV0FBVyxVQUFVOztBQWhDcEM7QUFvQ0EsU0FBUyxpQkFDUCxVQUNBO0lBSUEsZ0JBQVc7SUFDWDs7UUFDRTtRQUNBLGVBQUMsS0FBSztBQUNKLHFCQUFhLE9BQUs7UUFEcEI7UUFHQTs7O0FBSUosU0FBUyxzQkFDUCxXQUNBLFVBQ0E7SUFHQSxVQUFVO0FBSUosdUNBQTZCLFNBQ2pDO0lBR0Y7O1FBQ0U7UUFDQSxlQUFDLEtBQUs7ZUFDQSwwQkFBcUI7QUFDdkI7O0FBR0UsNkJBQVc7ZUFDWDtBQUNJLGtDQUFZLFNBQVM7bUJBQ3ZCO0FBQ0Y7O0FBRUYsMkJBQVc7O2VBR1QsZUFBVTtBQUNSO21CQUNBLGFBQVE7QUFDVixnQ0FBWSxjQUNWLE9BQ0EsK0JBQ0E7O0FBR0YsZ0NBQVk7O2dCQUdkLFVBQVUsSUFBSSxVQUFVO21CQUNmLGVBQVU7Z0JBQ25CLFVBQVUsSUFBSTs7UUE1QmxCO1FBK0JBOzs7QUFJSixTQUFTLGlCQUNQLFVBQ0EsVUFDQTtJQUVBOztRQUNFO1FBQ0EsZUFBQyxLQUFLO2VBRUE7QUFDSSxxQ0FBZSxTQUFVLE9BQUssNkJBQXNCO2dCQUMxRCxNQUFJLHdCQUFxQix5QkFBb0IsWUFBUTs7ZUFHbkQsMEJBQXFCO0FBQ3ZCOztlQUlFLCtCQUEwQjttQkFFeEI7b0JBQ0YsSUFBSTs7QUFHQSwyQ0FBcUIsOEJBQXlCO0FBQ3BELHlCQUFhLE9BQUs7QUFDbEI7O2VBR0UsYUFBUTtBQUNOLGlDQUFXLFNBQWE7dUJBQ3ZCLGFBQVE7QUFJWCwrQkFBVztBQUNYLDZCQUFhLE9BQUs7O0FBR3BCLHVDQUF1Qiw2QkFDckIsS0FDQTtnQkFFRix1QkFBTSxVQUFVLE9BQU87O0FBR3ZCLHlCQUFhLE9BQUs7O1FBeEN0QjtRQTJDQSIsImZpbGUiOiJtZXJnZS5sdWEiLCJzb3VyY2VSb290IjoiIn0=