isaacscript-common 12.3.6 → 12.3.8

package/dist/src/features/fadeInRemover.lua

@@ -28,12 +28,7 @@ v = {run = {removedFadeIn = false}}
 ---
 -- @internal
 function ____exports.fadeInRemoverInit(self, mod)
-    saveDataManager(
-        nil,
-        FEATURE_NAME,
-        v,
-        function() return false end
-    )
+    saveDataManager(nil, FEATURE_NAME, v, false)
     mod:AddCallback(ModCallback.POST_RENDER, postRender)
 end
 --- Removes the fade-in that occurs at the beginning of a run. If this behavior is desired, call this

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

@@ -74,7 +74,7 @@ import { SaveData } from "../../interfaces/SaveData";
  *
  * 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`.
+ * For these cases, set the second argument to `false`.
  *
  * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
  * restore any variables on a "run" or "level" object with a backup that was created when the room

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

@@ -93,7 +93,7 @@ local saveDataMap = ____maps.saveDataMap
 -- 
 -- 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`.
+-- For these cases, set the second argument to `false`.
 -- 
 -- Note that when the player uses Glowing Hour Glass, the save data manager will automatically
 -- restore any variables on a "run" or "level" object with a backup that was created when the room

package/dist/src/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;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AA2BrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAelE;AA0LD,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;AA2BrD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAelE;AAkND,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/src/features/saveDataManager/main.lua

@@ -89,15 +89,22 @@ function makeGlowingHourGlassBackup(self)
         nil,
         saveDataMap,
         function(____, subscriberName, saveData)
+            local conditionalFunc = saveDataConditionalFuncMap[subscriberName]
+            if conditionalFunc ~= nil then
+                local shouldSave = conditionalFunc(nil)
+                if not shouldSave then
+                    return
+                end
+            end
             for ____, saveDataKey in ipairs(SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) do
                 do
                     local childTable = saveData[saveDataKey]
                     if childTable == nil then
-                        goto __continue18
+                        goto __continue20
                     end
                     local childTableLuaMap = childTable
                     if childTableLuaMap[SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY] ~= nil then
-                        goto __continue18
+                        goto __continue20
                     end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
@@ -107,7 +114,7 @@ function makeGlowingHourGlassBackup(self)
                     local copiedChildTable = deepCopy(nil, childTable, SerializationType.SERIALIZE)
                     saveDataGlowingHourGlass[saveDataKey] = copiedChildTable
                 end
-                ::__continue18::
+                ::__continue20::
             end
         end,
         SAVE_DATA_MANAGER_DEBUG
@@ -118,27 +125,34 @@ function restoreGlowingHourGlassBackup(self)
         nil,
         saveDataMap,
         function(____, subscriberName, saveData)
+            local conditionalFunc = saveDataConditionalFuncMap[subscriberName]
+            if conditionalFunc ~= nil then
+                local shouldSave = conditionalFunc(nil)
+                if not shouldSave then
+                    return
+                end
+            end
             for ____, saveDataKey in ipairs(SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) do
                 do
                     local childTable = saveData[saveDataKey]
                     if childTable == nil then
-                        goto __continue25
+                        goto __continue29
                     end
                     local childTableLuaMap = childTable
                     if childTableLuaMap[SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_IGNORE_KEY] ~= nil then
-                        goto __continue25
+                        goto __continue29
                     end
                     local saveDataGlowingHourGlass = saveDataGlowingHourGlassMap[subscriberName]
                     if saveDataGlowingHourGlass == nil then
-                        goto __continue25
+                        goto __continue29
                     end
                     local childTableBackup = saveDataGlowingHourGlass[saveDataKey]
                     if childTableBackup == nil then
-                        goto __continue25
+                        goto __continue29
                     end
                     merge(nil, childTable, childTableBackup, subscriberName .. "__glowingHourGlass")
                 end
-                ::__continue25::
+                ::__continue29::
             end
         end,
         SAVE_DATA_MANAGER_DEBUG

package/dist/src/functions/collectibles.d.ts

@@ -143,7 +143,12 @@ export declare function getCollectibleTags(collectibleType: CollectibleType): Bi
 export declare function getVanillaCollectibleTypeRange(): CollectibleType[];
 /** Returns true if the item type in the item config is equal to `ItemType.ITEM_ACTIVE`. */
 export declare function isActiveCollectible(collectibleType: CollectibleType): boolean;
-/** Returns true if the collectible has a red question mark sprite. */
+/**
+ * Returns true if the collectible has a red question mark sprite.
+ *
+ * Note that this function will not work properly in a render callback with the `RenderMode` set to
+ * `RenderMode.WATER_REFLECT`. If this is detected, this function will throw a run-time error.
+ */
 export declare function isBlindCollectible(collectible: EntityPickup): boolean;
 /**
  * Returns whether or not the given collectible is a "glitched" item. All items are replaced by

package/dist/src/functions/collectibles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collectibles.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collectibles.d.ts","sourceRoot":"","sources":["../../../src/functions/collectibles.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/collectibles.lua

@@ -9,6 +9,7 @@ local ItemConfigTagZero = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTagZero
 local ItemType = ____isaac_2Dtypescript_2Ddefinitions.ItemType
 local PickupPrice = ____isaac_2Dtypescript_2Ddefinitions.PickupPrice
 local PickupVariant = ____isaac_2Dtypescript_2Ddefinitions.PickupVariant
+local RenderMode = ____isaac_2Dtypescript_2Ddefinitions.RenderMode
 local RoomType = ____isaac_2Dtypescript_2Ddefinitions.RoomType
 local ____cachedClasses = require("src.core.cachedClasses")
 local game = ____cachedClasses.game
@@ -356,11 +357,19 @@ function ____exports.isActiveCollectible(self, collectibleType)
     return itemType == ItemType.ACTIVE
 end
 --- Returns true if the collectible has a red question mark sprite.
+-- 
+-- Note that this function will not work properly in a render callback with the `RenderMode` set to
+-- `RenderMode.WATER_REFLECT`. If this is detected, this function will throw a run-time error.
 function ____exports.isBlindCollectible(self, collectible)
     if not isCollectible(nil, collectible) then
         local entityID = getEntityID(nil, collectible)
         error("The \"isBlindCollectible\" function was given a non-collectible: " .. entityID)
     end
+    local room = game:GetRoom()
+    local renderMode = room:GetRenderMode()
+    if renderMode == RenderMode.WATER_REFLECT then
+        error("The \"isBlindCollectible\" function will not work properly in a render callback with the render mode equal to \"RenderMode.WATER_REFLECT\". Make sure that you properly account for this case if you are calling this function in a render callback.")
+    end
     local sprite = collectible:GetSprite()
     local animation = sprite:GetAnimation()
     local frame = sprite:GetFrame()

package/package.json

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

package/src/features/fadeInRemover.ts

@@ -16,7 +16,7 @@ const v = {
 
 /** @internal */
 export function fadeInRemoverInit(mod: Mod): void {
-  saveDataManager(FEATURE_NAME, v, () => false);
+  saveDataManager(FEATURE_NAME, v, false);
 
   mod.AddCallback(ModCallback.POST_RENDER, postRender); // 2
 }

package/src/features/saveDataManager/exports.ts

@@ -90,7 +90,7 @@ import {
  *
  * 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`.
+ * For these cases, set the second argument to `false`.
  *
  * Note that when the player uses Glowing Hour Glass, the save data manager will automatically
  * restore any variables on a "run" or "level" object with a backup that was created when the room

package/src/features/saveDataManager/main.ts

@@ -138,6 +138,18 @@ function makeGlowingHourGlassBackup() {
   iterateTableInOrder(
     saveDataMap,
     (subscriberName, saveData) => {
+      // We make the Glowing Hour Glass backup using `SerializationType.SERIALIZE`, which means that
+      // we cannot operate on unserializable data, such as functions. Save data that utilizes
+      // unserializable data will typically be marked using a conditional function that evaluates to
+      // false, so we skip all save data that matches this criteria.
+      const conditionalFunc = saveDataConditionalFuncMap.get(subscriberName);
+      if (conditionalFunc !== undefined) {
+        const shouldSave = conditionalFunc();
+        if (!shouldSave) {
+          return;
+        }
+      }
+
       for (const saveDataKey of SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) {
         const childTable = saveData[saveDataKey];
         if (childTable === undefined) {
@@ -180,6 +192,18 @@ function restoreGlowingHourGlassBackup() {
   iterateTableInOrder(
     saveDataMap,
     (subscriberName, saveData) => {
+      // We make the Glowing Hour Glass backup using `SerializationType.SERIALIZE`, which means that
+      // we cannot operate on unserializable data, such as functions. Save data that utilizes
+      // unserializable data will typically be marked using a conditional function that evaluates to
+      // false, so we skip all save data that matches this criteria.
+      const conditionalFunc = saveDataConditionalFuncMap.get(subscriberName);
+      if (conditionalFunc !== undefined) {
+        const shouldSave = conditionalFunc();
+        if (!shouldSave) {
+          return;
+        }
+      }
+
       for (const saveDataKey of SAVE_DATA_MANAGER_GLOWING_HOUR_GLASS_BACKUP_KEYS) {
         const childTable = saveData[saveDataKey];
         if (childTable === undefined) {

package/src/functions/collectibles.ts

@@ -9,6 +9,7 @@ import {
   ItemType,
   PickupPrice,
   PickupVariant,
+  RenderMode,
   RoomType,
 } from "isaac-typescript-definitions";
 import { game, itemConfig } from "../core/cachedClasses";
@@ -408,7 +409,12 @@ export function isActiveCollectible(collectibleType: CollectibleType): boolean {
   return itemType === ItemType.ACTIVE;
 }
 
-/** Returns true if the collectible has a red question mark sprite. */
+/**
+ * Returns true if the collectible has a red question mark sprite.
+ *
+ * Note that this function will not work properly in a render callback with the `RenderMode` set to
+ * `RenderMode.WATER_REFLECT`. If this is detected, this function will throw a run-time error.
+ */
 export function isBlindCollectible(collectible: EntityPickup): boolean {
   if (!isCollectible(collectible)) {
     const entityID = getEntityID(collectible);
@@ -417,6 +423,14 @@ export function isBlindCollectible(collectible: EntityPickup): boolean {
     );
   }
 
+  const room = game.GetRoom();
+  const renderMode = room.GetRenderMode();
+  if (renderMode === RenderMode.WATER_REFLECT) {
+    error(
+      'The "isBlindCollectible" function will not work properly in a render callback with the render mode equal to "RenderMode.WATER_REFLECT". Make sure that you properly account for this case if you are calling this function in a render callback.',
+    );
+  }
+
   const sprite = collectible.GetSprite();
   const animation = sprite.GetAnimation();
   const frame = sprite.GetFrame();