isaacscript-common 9.1.1 → 9.2.0

package/dist/features/customTrapdoor/exports.d.ts

@@ -4,12 +4,6 @@ import { LevelStage, StageType } from "isaac-typescript-definitions";
  * want to create a custom trapdoor that goes to a vanilla stage instead, use the
  * `spawnCustomTrapdoorToVanilla` helper function.
  *
- * Custom trapdoors can have one or more of the following attributes:
- *
- * - custom destination (or custom logic for after the player enters)
- * - custom graphics
- * - custom logic for opening/closing
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOrE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,GAAG,EACxB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAcZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,KAAK,CAAC,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,SAAS,EACrB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAkBZ"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../../src/features/customTrapdoor/exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOrE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,eAAe,EAAE,MAAM,EACvB,mBAAmB,EAAE,GAAG,EACxB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAcZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,4BAA4B,CAC1C,mBAAmB,EAAE,GAAG,GAAG,MAAM,EACjC,KAAK,CAAC,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,SAAS,EACrB,QAAQ,SAAmC,EAC3C,SAAS,CAAC,EAAE,OAAO,GAClB,UAAU,CAkBZ"}

package/dist/features/customTrapdoor/exports.lua

@@ -12,12 +12,6 @@ local spawnCustomTrapdoorToDestination = ____spawn.spawnCustomTrapdoorToDestinat
 -- want to create a custom trapdoor that goes to a vanilla stage instead, use the
 -- `spawnCustomTrapdoorToVanilla` helper function.
 -- 
--- Custom trapdoors can have one or more of the following attributes:
--- 
--- - custom destination (or custom logic for after the player enters)
--- - custom graphics
--- - custom logic for opening/closing
--- 
 -- Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
 -- respawned every time the player re-enters the room.
 -- 

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAsBrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAUlE;AAuED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA4CN;AAiBD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/features/saveDataManager/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAsBrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAUlE;AAqFD,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,GACvB,IAAI,CA4CN;AAiBD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}

package/dist/features/saveDataManager/main.lua

@@ -17,6 +17,8 @@ local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local ____log = require("functions.log")
 local logError = ____log.logError
+local ____stage = require("functions.stage")
+local onFirstFloor = ____stage.onFirstFloor
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local iterateTableInOrder = ____table.iterateTableInOrder
@@ -55,7 +57,13 @@ function preGameExit(self)
     loadedDataOnThisRun = false
 end
 function postNewLevel(self)
+    if mod == nil then
+        error(("The mod for the " .. SAVE_DATA_MANAGER_FEATURE_NAME) .. " was not initialized.")
+    end
     restoreDefaults(nil, SaveDataKey.LEVEL)
+    if not onFirstFloor(nil) then
+        saveToDisk(nil, mod, saveDataMap, saveDataConditionalFuncMap)
+    end
 end
 function postNewRoomEarly(self)
     restoreDefaults(nil, SaveDataKey.ROOM)

package/dist/functions/stage.d.ts

@@ -40,6 +40,13 @@ export declare function onDarkRoom(): boolean;
  * I AM ERROR room is never entered into the list of possibilities.
  */
 export declare function onFinalFloor(): boolean;
+/**
+ * Returns whether or not the player is on the first floor of the particular run.
+ *
+ * This is tricky to determine because we have to handle the cases of Downpour/Dross 1 not being the
+ * first floor and The Ascent.
+ */
+export declare function onFirstFloor(): boolean;
 export declare function onRepentanceStage(): boolean;
 export declare function onSheol(): boolean;
 /**

package/dist/functions/stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/functions/stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,QAAQ,EACR,SAAS,EACV,MAAM,8BAA8B,CAAC;AAOtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CA6B/D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAmBzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CASvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,MAAM,CAG3E;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,IAAI,UAAU,CAIrC;AAED,iDAAiD;AACjD,wBAAgB,YAAY,IAAI,SAAS,CAIxC;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAI/D;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED,wBAAgB,OAAO,IAAI,OAAO,CASjC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAQpC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAUtC;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,MAAM,UAAQ,GACb,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE9D"}
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/functions/stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,UAAU,EACV,QAAQ,EACR,SAAS,EACV,MAAM,8BAA8B,CAAC;AAOtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CA6B/D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAmBzE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CASvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,MAAM,CAG3E;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,IAAI,UAAU,CAIrC;AAED,iDAAiD;AACjD,wBAAgB,YAAY,IAAI,SAAS,CAIxC;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAIvE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAI/D;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,WAAW,IAAI,OAAO,CASrC;AAED,wBAAgB,OAAO,IAAI,OAAO,CASjC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAQpC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAUtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAKtC;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED,wBAAgB,OAAO,IAAI,OAAO,CAQjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,MAAM,UAAQ,GACb,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE9D"}

package/dist/functions/stage.lua

@@ -125,6 +125,15 @@ function ____exports.onFinalFloor(self)
     local stage = level:GetStage()
     return stage == LevelStage.DARK_ROOM_CHEST or stage == LevelStage.THE_VOID or stage == LevelStage.HOME or stage == LevelStage.WOMB_2 and ____exports.onRepentanceStage(nil)
 end
+--- Returns whether or not the player is on the first floor of the particular run.
+-- 
+-- This is tricky to determine because we have to handle the cases of Downpour/Dross 1 not being the
+-- first floor and The Ascent.
+function ____exports.onFirstFloor(self)
+    local effectiveStage = ____exports.getEffectiveStage(nil)
+    local isOnAscent = ____exports.onAscent(nil)
+    return effectiveStage == 1 and not isOnAscent
+end
 function ____exports.onSheol(self)
     local level = game:GetLevel()
     local stage = level:GetStage()

package/dist/index.d.ts

@@ -8255,6 +8255,14 @@ export declare const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
  */
 export declare function onFinalFloor(): boolean;
 
+/**
+ * Returns whether or not the player is on the first floor of the particular run.
+ *
+ * This is tricky to determine because we have to handle the cases of Downpour/Dross 1 not being the
+ * first floor and The Ascent.
+ */
+export declare function onFirstFloor(): boolean;
+
 export declare function onRepentanceStage(): boolean;
 
 /**
@@ -10863,12 +10871,6 @@ export declare function spawnCustomGridEntity(gridEntityTypeCustom: GridEntityTy
  * want to create a custom trapdoor that goes to a vanilla stage instead, use the
  * `spawnCustomTrapdoorToVanilla` helper function.
  *
- * Custom trapdoors can have one or more of the following attributes:
- *
- * - custom destination (or custom logic for after the player enters)
- * - custom graphics
- * - custom logic for opening/closing
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "9.1.1",
+  "version": "9.2.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/features/customTrapdoor/exports.ts

@@ -10,12 +10,6 @@ import { spawnCustomTrapdoorToDestination } from "./spawn";
  * want to create a custom trapdoor that goes to a vanilla stage instead, use the
  * `spawnCustomTrapdoorToVanilla` helper function.
  *
- * Custom trapdoors can have one or more of the following attributes:
- *
- * - custom destination (or custom logic for after the player enters)
- * - custom graphics
- * - custom logic for opening/closing
- *
  * Under the hood, the custom trapdoor is represented by a decoration grid entity and is manually
  * respawned every time the player re-enters the room.
  *

package/src/features/saveDataManager/main.ts

@@ -6,6 +6,7 @@ import { SaveDataKey } from "../../enums/SaveDataKey";
 import { SerializationType } from "../../enums/SerializationType";
 import { deepCopy } from "../../functions/deepCopy";
 import { logError } from "../../functions/log";
+import { onFirstFloor } from "../../functions/stage";
 import { clearTable, iterateTableInOrder } from "../../functions/table";
 import { SaveData } from "../../interfaces/SaveData";
 import { loadFromDisk } from "./load";
@@ -49,6 +50,8 @@ function postPlayerInit() {
     );
   }
 
+  // We want to only load data once per run to handle the case of a player using Genesis, a second
+  // player joining the run, and so on.
   if (loadedDataOnThisRun) {
     return;
   }
@@ -86,7 +89,19 @@ function preGameExit() {
 
 // ModCallback.POST_NEW_LEVEL (18)
 function postNewLevel() {
+  if (mod === null) {
+    error(
+      `The mod for the ${SAVE_DATA_MANAGER_FEATURE_NAME} was not initialized.`,
+    );
+  }
+
   restoreDefaults(SaveDataKey.LEVEL);
+
+  // We save data to disk at the beginning of every floor (for the 2nd floor and beyond) to emulate
+  // what the game does internally. (This mitigates data loss in the event of a crash).
+  if (!onFirstFloor()) {
+    saveToDisk(mod, saveDataMap, saveDataConditionalFuncMap);
+  }
 }
 
 // ModCallbackCustom.POST_NEW_ROOM_EARLY

package/src/functions/stage.ts

@@ -178,6 +178,19 @@ export function onFinalFloor(): boolean {
   );
 }
 
+/**
+ * Returns whether or not the player is on the first floor of the particular run.
+ *
+ * This is tricky to determine because we have to handle the cases of Downpour/Dross 1 not being the
+ * first floor and The Ascent.
+ */
+export function onFirstFloor(): boolean {
+  const effectiveStage = getEffectiveStage();
+  const isOnAscent = onAscent();
+
+  return effectiveStage === 1 && !isOnAscent;
+}
+
 export function onRepentanceStage(): boolean {
   const level = game.GetLevel();
   const stageType = level.GetStageType();