isaacscript-common 11.2.4 → 12.0.0

package/src/features/saveDataManager/main.ts

@@ -9,17 +9,20 @@ import { logError } from "../../functions/log";
 import { onFirstFloor } from "../../functions/stage";
 import { clearTable, iterateTableInOrder } from "../../functions/table";
 import { SaveData } from "../../interfaces/SaveData";
+import {
+  SAVE_DATA_MANAGER_DEBUG,
+  SAVE_DATA_MANAGER_FEATURE_NAME,
+  SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS,
+} from "./constants";
 import { loadFromDisk } from "./load";
 import {
   saveDataConditionalFuncMap,
   saveDataDefaultsMap,
+  saveDataGlowingHourGlassMap,
   saveDataMap,
 } from "./maps";
+import { merge } from "./merge";
 import { saveToDisk } from "./save";
-import {
-  SAVE_DATA_MANAGER_DEBUG,
-  SAVE_DATA_MANAGER_FEATURE_NAME,
-} from "./saveDataManagerConstants";
 
 const RESETTABLE_SAVE_DATA_KEYS: ReadonlySet<SaveDataKey> = new Set([
   SaveDataKey.RUN,
@@ -29,6 +32,7 @@ const RESETTABLE_SAVE_DATA_KEYS: ReadonlySet<SaveDataKey> = new Set([
 
 let mod: ModUpgraded | null = null;
 let loadedDataOnThisRun = false;
+let restoreGlowingHourGlassDataOnNextRoom = false;
 
 export function saveDataManagerInit(incomingMod: ModUpgraded): void {
   mod = incomingMod;
@@ -50,6 +54,7 @@ export function saveDataManagerInit(incomingMod: ModUpgraded): void {
 // ModCallback.POST_USE_ITEM (3)
 // CollectibleType.GLOWING_HOUR_GLASS (422)
 function postUseItemGlowingHourGlass() {
+  restoreGlowingHourGlassDataOnNextRoom = true;
   return undefined;
 }
 
@@ -118,6 +123,75 @@ function postNewLevel() {
 // ModCallbackCustom.POST_NEW_ROOM_EARLY
 function postNewRoomEarly() {
   restoreDefaults(SaveDataKey.ROOM);
+
+  // Handle the Glowing Hour Glass.
+  if (restoreGlowingHourGlassDataOnNextRoom) {
+    restoreGlowingHourGlassDataOnNextRoom = false;
+    restoreGlowingHourGlassBackup();
+  } else {
+    makeGlowingHourGlassBackup();
+  }
+}
+
+function makeGlowingHourGlassBackup() {
+  iterateTableInOrder(
+    saveDataMap,
+    (subscriberName, saveData) => {
+      for (const saveDataKey of SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) {
+        const childTable = saveData[saveDataKey];
+        if (childTable === undefined) {
+          // This feature does not happen to store any variables on this particular child table.
+          continue;
+        }
+
+        let saveDataGlowingHourGlass =
+          saveDataGlowingHourGlassMap.get(subscriberName);
+        if (saveDataGlowingHourGlass === undefined) {
+          saveDataGlowingHourGlass = new LuaMap<string, unknown>() as SaveData;
+        }
+
+        const copiedChildTable = deepCopy(childTable);
+        saveDataGlowingHourGlass[saveDataKey] = copiedChildTable;
+      }
+    },
+    SAVE_DATA_MANAGER_DEBUG,
+  );
+}
+
+function restoreGlowingHourGlassBackup() {
+  iterateTableInOrder(
+    saveDataMap,
+    (subscriberName, saveData) => {
+      for (const saveDataKey of SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) {
+        const childTable = saveData[saveDataKey];
+        if (childTable === undefined) {
+          // This feature does not happen to store any variables on this particular child table.
+          continue;
+        }
+
+        const saveDataGlowingHourGlass =
+          saveDataGlowingHourGlassMap.get(subscriberName);
+        if (saveDataGlowingHourGlass === undefined) {
+          // This should never happen.
+          continue;
+        }
+
+        const childTableBackup = saveDataGlowingHourGlass[saveDataKey];
+        if (childTableBackup === undefined) {
+          // This should never happen.
+          continue;
+        }
+
+        merge(
+          childTable as LuaMap<AnyNotNil, unknown>,
+          childTableBackup as LuaMap<AnyNotNil, unknown>,
+          // Append an arbitrary suffix for better error messages.
+          `${subscriberName}__glowingHourGlass`,
+        );
+      }
+    },
+    SAVE_DATA_MANAGER_DEBUG,
+  );
 }
 
 function restoreDefaultsAll() {

package/src/features/saveDataManager/maps.ts

@@ -9,3 +9,9 @@ export const saveDataMap = new LuaMap<string, SaveData>();
 
 export const saveDataDefaultsMap = new LuaMap<string, SaveData>();
 export const saveDataConditionalFuncMap = new LuaMap<string, () => boolean>();
+
+/**
+ * We backup some save data keys on every new room for the purposes of restoring it when Glowing
+ * Hour Glass is used.
+ */
+export const saveDataGlowingHourGlassMap = new LuaMap<string, SaveData>();

package/src/features/saveDataManager/merge.ts

@@ -11,7 +11,7 @@ import { clearTable, iterateTableInOrder } from "../../functions/table";
 import { isDefaultMap, isTSTLMap, isTSTLSet } from "../../functions/tstlClass";
 import { isTable } from "../../functions/types";
 import { getTraversalDescription } from "../../functions/utils";
-import { SAVE_DATA_MANAGER_DEBUG } from "./saveDataManagerConstants";
+import { SAVE_DATA_MANAGER_DEBUG } from "./constants";
 import { isSerializationBrand } from "./serializationBrands";
 
 /**

package/src/features/saveDataManager/save.ts

@@ -7,7 +7,7 @@ import { SaveData } from "../../interfaces/SaveData";
 import {
   SAVE_DATA_MANAGER_DEBUG,
   SAVE_DATA_MANAGER_FEATURE_NAME,
-} from "./saveDataManagerConstants";
+} from "./constants";
 
 export function saveToDisk(
   mod: Mod,

package/src/functions/deepCopy.ts

@@ -1,7 +1,7 @@
 import { DefaultMap } from "../classes/DefaultMap";
 import { SerializationBrand } from "../enums/private/SerializationBrand";
 import { SerializationType } from "../enums/SerializationType";
-import { SAVE_DATA_MANAGER_DEBUG } from "../features/saveDataManager/saveDataManagerConstants";
+import { SAVE_DATA_MANAGER_DEBUG } from "../features/saveDataManager/constants";
 import { isSerializationBrand } from "../features/saveDataManager/serializationBrands";
 import { TSTLClass } from "../types/TSTLClass";
 import { isArray } from "./array";

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

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

package/dist/src/features/customTrapdoor/customTrapdoorConstants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"customTrapdoorConstants.d.ts","sourceRoot":"","sources":["../../../../src/features/customTrapdoor/customTrapdoorConstants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;CAEK,CAAC;AAEX,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,iCAAiC,QAA+B,CAAC;AAC9E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,eAAO,MAAM,oCAAoC,EAAE,WAAW,CAAC,MAAM,CAClC,CAAC;AAEpC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,eAAO,MAAM,4CAA4C,IAAI,CAAC;AAC9D,eAAO,MAAM,+CAA+C,IAAI,CAAC"}

package/dist/src/features/saveDataManager/saveDataManagerConstants.d.ts

@@ -1,4 +0,0 @@
-/** Set this to true to enable more verbosity in the save data manger. */
-export declare const SAVE_DATA_MANAGER_DEBUG: boolean;
-export declare const SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager";
-//# sourceMappingURL=saveDataManagerConstants.d.ts.map

package/dist/src/features/saveDataManager/saveDataManagerConstants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"saveDataManagerConstants.d.ts","sourceRoot":"","sources":["../../../../src/features/saveDataManager/saveDataManagerConstants.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,SAAmB,CAAC;AAExD,eAAO,MAAM,8BAA8B,sBAAsB,CAAC"}

package/dist/src/features/saveDataManager/saveDataManagerConstants.lua

@@ -1,5 +0,0 @@
-local ____exports = {}
---- Set this to true to enable more verbosity in the save data manger.
-____exports.SAVE_DATA_MANAGER_DEBUG = false
-____exports.SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager"
-return ____exports

package/src/features/saveDataManager/saveDataManagerConstants.ts

@@ -1,4 +0,0 @@
-/** Set this to true to enable more verbosity in the save data manger. */
-export const SAVE_DATA_MANAGER_DEBUG = false as boolean;
-
-export const SAVE_DATA_MANAGER_FEATURE_NAME = "save data manager";