isaacscript-common 20.6.0 → 20.7.0

package/dist/index.d.ts

@@ -7971,6 +7971,9 @@ export declare function isTransformationFlying(playerForm: PlayerForm): boolean;
 /** For `PickupVariant.TRINKET` (350). */
 export declare function isTrinket(pickup: EntityPickup): pickup is EntityPickupTrinket;
 
+/** Helper function to check if a given table is a class table created by TypeScriptToLua. */
+export declare function isTSTLClass(object: unknown): object is TSTLClass;
+
 /**
  * Helper function to determine if a given object is a TypeScriptToLua `Map`.
  *
@@ -7991,9 +7994,6 @@ export declare function isTSTLSet(object: unknown): object is Set<AnyNotNil>;
 
 export declare function isUserdata(variable: unknown): variable is LuaUserdata;
 
-/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
-export declare function isUserDefinedTSTLClass(object: unknown): object is TSTLClass;
-
 export declare function isValidCollectibleType(collectibleType: CollectibleType): boolean;
 
 /**
@@ -8484,10 +8484,12 @@ export declare function logSounds(): void;
 
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export declare function logTable(luaTable: unknown, parentTables?: number): void;
 
@@ -11386,29 +11388,12 @@ declare class ModdedElementSets extends Feature {
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
- *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -11627,7 +11612,7 @@ export declare function newPickingUpItem(): PickingUpItem;
 export declare function newPlayerHealth(): PlayerHealth;
 
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */
@@ -13533,7 +13518,8 @@ declare class SaveDataManager extends Feature {
      *
      * @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.
+     *            registered. Note that you can also pass a TSTL class instead of a string and the
+     *            save data manager will use the name of the class as the key.
      * @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 Optional. A function to run to check if this save data should be written
@@ -13546,9 +13532,9 @@ declare class SaveDataManager extends Feature {
      *                        data. (Specifying `false` will allow you to use non-serializable objects
      *                        in your save data, such as `EntityPtr`.
      */
-    saveDataManager<Persistent, Run, Level>(key: string, // This is the overload for the standard case with serializable data.
+    saveDataManager<Persistent, Run, Level>(key: unknown, // This is the overload for the standard case with serializable data.
     v: SaveData<Persistent, Run, Level>, conditionalFunc?: () => boolean): void;
-    saveDataManager(key: string, // This is the overload for the case when saving data is disabled.
+    saveDataManager(key: unknown, // This is the overload for the case when saving data is disabled.
     v: SaveData, conditionalFunc: false): void;
     /**
      * Recursively traverses an object, collecting all of the class constructors that it encounters.

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.6.0
+isaacscript-common 20.7.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -20541,6 +20541,10 @@ function ____exports.isDefaultMap(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "DefaultMap"
 end
+function ____exports.isTSTLClass(self, object)
+    local tstlClassName = ____exports.getTSTLClassName(nil, object)
+    return tstlClassName ~= nil
+end
 function ____exports.isTSTLMap(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "Map"
@@ -20549,10 +20553,6 @@ function ____exports.isTSTLSet(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "Set"
 end
-function ____exports.isUserDefinedTSTLClass(self, object)
-    local tstlClassName = ____exports.getTSTLClassName(nil, object)
-    return tstlClassName ~= nil
-end
 function ____exports.newTSTLClass(self, oldClass)
     local constructor = ____exports.getTSTLClassConstructor(nil, oldClass)
     if constructor == nil then
@@ -28091,6 +28091,8 @@ function ____exports.logTable(self, luaTable, parentTables)
     end
     if parentTables == 0 then
         log(nil, "Printing out a Lua table:")
+    elseif parentTables > 10 then
+        return
     end
     local numSpaces = (parentTables + 1) * 2
     local indentation = string.rep(
@@ -36832,6 +36834,7 @@ local ____stage = require("src.functions.stage")
 local onFirstFloor = ____stage.onFirstFloor
 local ____tstlClass = require("src.functions.tstlClass")
 local getTSTLClassName = ____tstlClass.getTSTLClassName
+local isTSTLClass = ____tstlClass.isTSTLClass
 local ____types = require("src.functions.types")
 local isString = ____types.isString
 local isTable = ____types.isTable
@@ -36909,8 +36912,15 @@ function SaveDataManager.prototype.____constructor(self, mod)
     self.mod = mod
 end
 function SaveDataManager.prototype.saveDataManager(self, key, v, conditionalFunc)
+    if isTSTLClass(nil, key) then
+        local className = getTSTLClassName(nil, key)
+        if className == nil then
+            error("Failed to get the class name for the submitted class (as part of the \"key\" parameter) when registering new data with the save data manager.")
+        end
+        key = className
+    end
     if not isString(nil, key) then
-        error("The save data manager requires that keys are strings. You tried to use a key of type: " .. __TS__TypeOf(key))
+        error("The save data manager requires that keys are strings or TSTL classes. You tried to use a key of type: " .. __TS__TypeOf(key))
     end
     if self.saveDataMap[key] ~= nil then
         error("The save data manager is already managing save data for a key of: " .. key)
@@ -49795,7 +49805,7 @@ local __TS__Class = ____lualib.__TS__Class
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initDecoratedCallbacks, addCallback, removeCallback, initSaveDataManager, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
+local initDecoratedCallbacks, addCallback, removeCallback, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
 local ____array = require("src.functions.array")
 local isArray = ____array.isArray
 local ____tstlClass = require("src.functions.tstlClass")
@@ -49804,7 +49814,6 @@ local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____types = require("src.functions.types")
 local isFunction = ____types.isFunction
 local isNumber = ____types.isNumber
-local isTable = ____types.isTable
 function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, vanilla, init)
     local modFeatureConstructor = constructor
     local callbackTuplesKey = vanilla and ____exports.MOD_FEATURE_CALLBACKS_KEY or ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
@@ -49916,30 +49925,6 @@ function removeCallback(self, modFeatureConstructor, mod, modCallback, vanilla)
         mod:RemoveCallbackCustom(modCallback, wrappedCallback)
     end
 end
-function initSaveDataManager(self, modFeature, tstlClassName, init)
-    local ____modFeature_0 = modFeature
-    local v = ____modFeature_0.v
-    if v == nil then
-        return
-    end
-    if not isTable(nil, v) then
-        error("Failed to initialize a mod feature class due to having a \"v\" property that is not an object. (The \"v\" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)")
-    end
-    local mod = modFeature.mod
-    local saveDataManagerMethodName = init and "saveDataManager" or "saveDataManagerRemove"
-    local saveDataManagerMethod = mod[saveDataManagerMethodName]
-    if saveDataManagerMethod == nil then
-        error("Failed to initialize a mod feature class due to having a \"v\" object and not having the save data manager initialized. You must pass \"ISCFeature.SAVE_DATA_MANAGER\" to the \"upgradeMod\" function.")
-    end
-    if type(saveDataManagerMethod) ~= "function" then
-        error(("The \"" .. saveDataManagerMethodName) .. "\" property of the \"ModUpgraded\" object was not a function.")
-    end
-    if init then
-        saveDataManagerMethod(nil, tstlClassName, v)
-    else
-        saveDataManagerMethod(nil, tstlClassName)
-    end
-end
 ____exports.MOD_FEATURE_CALLBACKS_KEY = "__callbacks"
 ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks"
 WRAPPED_CALLBACK_METHODS_KEY = "__wrappedCallbackMethods"
@@ -49990,7 +49975,6 @@ function ModFeature.prototype.init(self, init)
         false,
         init
     )
-    initSaveDataManager(nil, self, tstlClassName, init)
 end
 function ModFeature.prototype.uninit(self)
     self:init(false)

package/dist/src/classes/ModFeature.d.ts

@@ -8,29 +8,12 @@ export declare const MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks";
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
- *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional

package/dist/src/classes/ModFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}
+{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;GAeG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;;OAMG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,eAAe,EAAE,IAAI,UAAO;IAQ7C;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAoB9B;;;;;;OAMG;IACI,MAAM,IAAI,IAAI;CAGtB"}

package/dist/src/classes/ModFeature.lua

@@ -3,7 +3,7 @@ local __TS__Class = ____lualib.__TS__Class
 local Map = ____lualib.Map
 local __TS__New = ____lualib.__TS__New
 local ____exports = {}
-local initDecoratedCallbacks, addCallback, removeCallback, initSaveDataManager, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
+local initDecoratedCallbacks, addCallback, removeCallback, WRAPPED_CALLBACK_METHODS_KEY, WRAPPED_CUSTOM_CALLBACK_METHODS_KEY
 local ____array = require("src.functions.array")
 local isArray = ____array.isArray
 local ____tstlClass = require("src.functions.tstlClass")
@@ -12,7 +12,6 @@ local getTSTLClassName = ____tstlClass.getTSTLClassName
 local ____types = require("src.functions.types")
 local isFunction = ____types.isFunction
 local isNumber = ____types.isNumber
-local isTable = ____types.isTable
 function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, vanilla, init)
     local modFeatureConstructor = constructor
     local callbackTuplesKey = vanilla and ____exports.MOD_FEATURE_CALLBACKS_KEY or ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
@@ -124,30 +123,6 @@ function removeCallback(self, modFeatureConstructor, mod, modCallback, vanilla)
         mod:RemoveCallbackCustom(modCallback, wrappedCallback)
     end
 end
-function initSaveDataManager(self, modFeature, tstlClassName, init)
-    local ____modFeature_0 = modFeature
-    local v = ____modFeature_0.v
-    if v == nil then
-        return
-    end
-    if not isTable(nil, v) then
-        error("Failed to initialize a mod feature class due to having a \"v\" property that is not an object. (The \"v\" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)")
-    end
-    local mod = modFeature.mod
-    local saveDataManagerMethodName = init and "saveDataManager" or "saveDataManagerRemove"
-    local saveDataManagerMethod = mod[saveDataManagerMethodName]
-    if saveDataManagerMethod == nil then
-        error("Failed to initialize a mod feature class due to having a \"v\" object and not having the save data manager initialized. You must pass \"ISCFeature.SAVE_DATA_MANAGER\" to the \"upgradeMod\" function.")
-    end
-    if type(saveDataManagerMethod) ~= "function" then
-        error(("The \"" .. saveDataManagerMethodName) .. "\" property of the \"ModUpgraded\" object was not a function.")
-    end
-    if init then
-        saveDataManagerMethod(nil, tstlClassName, v)
-    else
-        saveDataManagerMethod(nil, tstlClassName)
-    end
-end
 ____exports.MOD_FEATURE_CALLBACKS_KEY = "__callbacks"
 ____exports.MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks"
 WRAPPED_CALLBACK_METHODS_KEY = "__wrappedCallbackMethods"
@@ -156,29 +131,12 @@ WRAPPED_CUSTOM_CALLBACK_METHODS_KEY = "__wrappedCustomCallbacksMethods"
 -- mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
 -- that automatically subscribe to callbacks.
 -- 
--- If your feature has variables that are managed by the save data manager, put them as a `v` class
--- member and they will automatically be registered with the save data manager when the class is
--- instantiated.
--- 
--- For example:
--- 
--- ```ts
--- export class MyFeature extends ModFeature {
---   v = {
---     run: {
---       foo: 123,
---     }
---   }
--- 
--- @Callback (ModCallback.POST_GAME_STARTED)
--- postGameStarted(isContinued: boolean): void {
--- Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
--- }
--- }
--- ```
+-- When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+-- the constructor.
 -- 
--- When instantiating a feature class, you must pass your upgraded mod as the first argument to the
--- constructor.
+-- If your feature has variables that are managed by the save data manager, you need to explicitly
+-- register them with the save data manager yourself in your class constructor. (It can't be
+-- automatically done because parent classes don't have access to child class properties.)
 -- 
 -- In almost all cases, you will want the callback functions to be immediately subscribed after
 -- instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -229,7 +187,6 @@ function ModFeature.prototype.init(self, init)
         false,
         init
     )
-    initSaveDataManager(nil, self, tstlClassName, init)
 end
 function ModFeature.prototype.uninit(self)
     self:init(false)

package/dist/src/classes/features/other/SaveDataManager.d.ts

@@ -130,7 +130,8 @@ export declare class SaveDataManager extends Feature {
      *
      * @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.
+     *            registered. Note that you can also pass a TSTL class instead of a string and the
+     *            save data manager will use the name of the class as the key.
      * @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 Optional. A function to run to check if this save data should be written
@@ -143,9 +144,9 @@ export declare class SaveDataManager extends Feature {
      *                        data. (Specifying `false` will allow you to use non-serializable objects
      *                        in your save data, such as `EntityPtr`.
      */
-    saveDataManager<Persistent, Run, Level>(key: string, // This is the overload for the standard case with serializable data.
+    saveDataManager<Persistent, Run, Level>(key: unknown, // This is the overload for the standard case with serializable data.
     v: SaveData<Persistent, Run, Level>, conditionalFunc?: () => boolean): void;
-    saveDataManager(key: string, // This is the overload for the case when saving data is disabled.
+    saveDataManager(key: unknown, // This is the overload for the case when saving data is disabled.
     v: SaveData, conditionalFunc: false): void;
     /**
      * Recursively traverses an object, collecting all of the class constructors that it encounters.

package/dist/src/classes/features/other/SaveDataManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SaveDataManager.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/SaveDataManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAMzD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAsBhD,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;;OAGG;IACH,OAAO,CAAC,GAAG,CAAM;IAEjB;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAkC;IAErD;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAkC;IAE7D;;;OAGG;IACH,OAAO,CAAC,0BAA0B,CAAuC;IAEzE;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B,CAAkC;IAErE;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAkC;IAG3D,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,qCAAqC,CAAS;IAiCtD,OAAO,CAAC,2BAA2B,CAUjC;IAGF,OAAO,CAAC,cAAc,CA0BpB;IAGF,OAAO,CAAC,WAAW,CAajB;IAGF,OAAO,CAAC,YAAY,CAYlB;IAGF,OAAO,CAAC,gBAAgB,CAuBtB;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkGG;IACI,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAC3C,GAAG,EAAE,MAAM,EAAE,qEAAqE;IAClF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI;IACA,eAAe,CACpB,GAAG,EAAE,MAAM,EAAE,kEAAkE;IAC/E,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI;IAkDP;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAgBxC;;;;;;;;;OASG;IAEI,mBAAmB,IAAI,IAAI;IAIlC;;;;;;OAMG;IAEI,mBAAmB,IAAI,IAAI;IAIlC;;;;;;;OAOG;IAEI,wBAAwB,IAAI,IAAI;IAIvC;;;;;;;;;;;OAWG;IAEI,4BAA4B,CAAC,GAAG,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI;IAcrE;;;;;OAKG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB/C;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEI,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,GAAG,IAAI;IAsB3E;;;;;;;;;;;;OAYG;IAEI,qBAAqB,IAAI,OAAO;CAGxC"}
+{"version":3,"file":"SaveDataManager.d.ts","sourceRoot":"","sources":["../../../../../src/classes/features/other/SaveDataManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAMzD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAsBhD,qBAAa,eAAgB,SAAQ,OAAO;IAC1C;;;OAGG;IACH,OAAO,CAAC,GAAG,CAAM;IAEjB;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAkC;IAErD;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAkC;IAE7D;;;OAGG;IACH,OAAO,CAAC,0BAA0B,CAAuC;IAEzE;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B,CAAkC;IAErE;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAkC;IAG3D,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,qCAAqC,CAAS;IAiCtD,OAAO,CAAC,2BAA2B,CAUjC;IAGF,OAAO,CAAC,cAAc,CA0BpB;IAGF,OAAO,CAAC,WAAW,CAajB;IAGF,OAAO,CAAC,YAAY,CAYlB;IAGF,OAAO,CAAC,gBAAgB,CAuBtB;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmGG;IACI,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,EAC3C,GAAG,EAAE,OAAO,EAAE,qEAAqE;IACnF,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,EACnC,eAAe,CAAC,EAAE,MAAM,OAAO,GAC9B,IAAI;IACA,eAAe,CACpB,GAAG,EAAE,OAAO,EAAE,kEAAkE;IAChF,CAAC,EAAE,QAAQ,EACX,eAAe,EAAE,KAAK,GACrB,IAAI;IA6DP;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAgBxC;;;;;;;;;OASG;IAEI,mBAAmB,IAAI,IAAI;IAIlC;;;;;;OAMG;IAEI,mBAAmB,IAAI,IAAI;IAIlC;;;;;;;OAOG;IAEI,wBAAwB,IAAI,IAAI;IAIvC;;;;;;;;;;;OAWG;IAEI,4BAA4B,CAAC,GAAG,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAI;IAcrE;;;;;OAKG;IAEI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB/C;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEI,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,GAAG,IAAI;IAsB3E;;;;;;;;;;;;OAYG;IAEI,qBAAqB,IAAI,OAAO;CAGxC"}

package/dist/src/classes/features/other/SaveDataManager.lua

@@ -26,6 +26,7 @@ local ____stage = require("src.functions.stage")
 local onFirstFloor = ____stage.onFirstFloor
 local ____tstlClass = require("src.functions.tstlClass")
 local getTSTLClassName = ____tstlClass.getTSTLClassName
+local isTSTLClass = ____tstlClass.isTSTLClass
 local ____types = require("src.functions.types")
 local isString = ____types.isString
 local isTable = ____types.isTable
@@ -103,8 +104,15 @@ function SaveDataManager.prototype.____constructor(self, mod)
     self.mod = mod
 end
 function SaveDataManager.prototype.saveDataManager(self, key, v, conditionalFunc)
+    if isTSTLClass(nil, key) then
+        local className = getTSTLClassName(nil, key)
+        if className == nil then
+            error("Failed to get the class name for the submitted class (as part of the \"key\" parameter) when registering new data with the save data manager.")
+        end
+        key = className
+    end
     if not isString(nil, key) then
-        error("The save data manager requires that keys are strings. You tried to use a key of type: " .. __TS__TypeOf(key))
+        error("The save data manager requires that keys are strings or TSTL classes. You tried to use a key of type: " .. __TS__TypeOf(key))
     end
     if self.saveDataMap[key] ~= nil then
         error("The save data manager is already managing save data for a key of: " .. key)

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

@@ -46,10 +46,12 @@ export declare function logSet(set: Set<AnyNotNil> | ReadonlySet<AnyNotNil>): vo
 export declare function logSounds(): void;
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export declare function logTable(luaTable: unknown, parentTables?: number): void;
 /**

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

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

package/dist/src/functions/logMisc.lua

@@ -388,16 +388,20 @@ function ____exports.logSounds(self)
     end
 end
 --- Helper function for logging every key and value of a Lua table. This is a deep log; the function
--- will recursively call itself if it counters a table within a table.
+-- will recursively call itself if it encounters a table within a table.
 -- 
 -- This function will only work on tables that have string keys (because it logs the keys in order,
 -- instead of randomly). It will throw a run-time error if it encounters a non-string key.
+-- 
+-- In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
 function ____exports.logTable(self, luaTable, parentTables)
     if parentTables == nil then
         parentTables = 0
     end
     if parentTables == 0 then
         log(nil, "Printing out a Lua table:")
+    elseif parentTables > 10 then
+        return
     end
     local numSpaces = (parentTables + 1) * 2
     local indentation = string.rep(

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

@@ -25,7 +25,7 @@ export declare function isRNG(object: unknown): object is RNG;
  */
 export declare function isSerializedRNG(object: unknown): object is SerializedRNG;
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */

package/dist/src/functions/rng.lua

@@ -26,7 +26,7 @@ end
 function ____exports.isRNG(self, object)
     return isIsaacAPIClassOfType(nil, object, OBJECT_NAME)
 end
---- Helper function to initialize an RNG object using Blade's recommended shift index.
+--- Helper function to initialize a new RNG object using Blade's recommended shift index.
 -- 
 -- @param seed The seed to initialize it with. Default is `getRandomSeed()`.
 function ____exports.newRNG(self, seed)

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

@@ -27,6 +27,8 @@ export declare function getTSTLClassName(object: unknown): string | undefined;
  * their own copies of the entire lualib and thus their own instantiated version of a `Map`.
  */
 export declare function isDefaultMap(object: unknown): object is DefaultMap<AnyNotNil, unknown>;
+/** Helper function to check if a given table is a class table created by TypeScriptToLua. */
+export declare function isTSTLClass(object: unknown): object is TSTLClass;
 /**
  * Helper function to determine if a given object is a TypeScriptToLua `Map`.
  *
@@ -43,8 +45,6 @@ export declare function isTSTLMap(object: unknown): object is Map<AnyNotNil, unk
  * `Set`.
  */
 export declare function isTSTLSet(object: unknown): object is Set<AnyNotNil>;
-/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
-export declare function isUserDefinedTSTLClass(object: unknown): object is TSTLClass;
 /**
  * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
  * it is. This function requires that you provide an instantiated class of the same type, as it will

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

@@ -1 +1 @@
-{"version":3,"file":"tstlClass.d.ts","sourceRoot":"","sources":["../../../src/functions/tstlClass.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GACd,kBAAkB,CAAC,aAAa,CAAC,GAAG,SAAS,CAW/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAG1C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAGnE;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAiB3D"}
+{"version":3,"file":"tstlClass.d.ts","sourceRoot":"","sources":["../../../src/functions/tstlClass.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GACd,kBAAkB,CAAC,aAAa,CAAC,GAAG,SAAS,CAW/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAG1C;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAiB3D"}

package/dist/src/functions/tstlClass.lua

@@ -38,6 +38,11 @@ function ____exports.isDefaultMap(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "DefaultMap"
 end
+--- Helper function to check if a given table is a class table created by TypeScriptToLua.
+function ____exports.isTSTLClass(self, object)
+    local tstlClassName = ____exports.getTSTLClassName(nil, object)
+    return tstlClassName ~= nil
+end
 --- Helper function to determine if a given object is a TypeScriptToLua `Map`.
 -- 
 -- It is not reliable to use the `instanceof` operator to determine this because each Lua module
@@ -56,11 +61,6 @@ function ____exports.isTSTLSet(self, object)
     local className = ____exports.getTSTLClassName(nil, object)
     return className == "Set"
 end
---- TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys.
-function ____exports.isUserDefinedTSTLClass(self, object)
-    local tstlClassName = ____exports.getTSTLClassName(nil, object)
-    return tstlClassName ~= nil
-end
 --- Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
 -- it is. This function requires that you provide an instantiated class of the same type, as it will
 -- use the class constructor that is present on the other object's metatable to initialize the new

package/package.json

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

package/src/classes/ModFeature.ts

@@ -5,7 +5,7 @@ import {
   getTSTLClassConstructor,
   getTSTLClassName,
 } from "../functions/tstlClass";
-import { isFunction, isNumber, isTable } from "../functions/types";
+import { isFunction, isNumber } from "../functions/types";
 import { TSTLClassMetatable } from "../interfaces/TSTLClassMetatable";
 import { AnyFunction } from "../types/AnyFunction";
 import { ModUpgradedBase } from "./ModUpgradedBase";
@@ -41,29 +41,12 @@ type ModFeatureConstructor = TSTLClassMetatable["constructor"] & {
  * mod features from this class in order to enable the `@Callback` and `@CustomCallback` decorators
  * that automatically subscribe to callbacks.
  *
- * If your feature has variables that are managed by the save data manager, put them as a `v` class
- * member and they will automatically be registered with the save data manager when the class is
- * instantiated.
+ * When instantiating a mod feature class, you must pass your upgraded mod as the first argument to
+ * the constructor.
  *
- * For example:
- *
- * ```ts
- * export class MyFeature extends ModFeature {
- *   v = {
- *     run: {
- *       foo: 123,
- *     }
- *   }
- *
- *   @Callback(ModCallback.POST_GAME_STARTED)
- *   postGameStarted(isContinued: boolean): void {
- *     Isaac.DebugString(`Callback fired: POST_GAME_STARTED`);
- *   }
- * }
- * ```
- *
- * When instantiating a feature class, you must pass your upgraded mod as the first argument to the
- * constructor.
+ * If your feature has variables that are managed by the save data manager, you need to explicitly
+ * register them with the save data manager yourself in your class constructor. (It can't be
+ * automatically done because parent classes don't have access to child class properties.)
  *
  * In almost all cases, you will want the callback functions to be immediately subscribed after
  * instantiating the class. However, if this is not the case, you can pass `false` as the optional
@@ -147,7 +130,6 @@ export class ModFeature {
 
     initDecoratedCallbacks(this, constructor, tstlClassName, true, init);
     initDecoratedCallbacks(this, constructor, tstlClassName, false, init);
-    initSaveDataManager(this, tstlClassName, init);
   }
 
   /**
@@ -334,46 +316,3 @@ function removeCallback(
     (mod.RemoveCallbackCustom as AnyFunction)(modCallback, wrappedCallback);
   }
 }
-
-function initSaveDataManager(
-  modFeature: ModFeature,
-  tstlClassName: string,
-  init: boolean,
-) {
-  // Do nothing if this class does not have any variables.
-  const { v } = modFeature as unknown as Record<string, unknown>;
-  if (v === undefined) {
-    return;
-  }
-
-  if (!isTable(v)) {
-    error(
-      'Failed to initialize a mod feature class due to having a "v" property that is not an object. (The "v" property is supposed to be an object that holds the variables for the class, managed by the save data manager.)',
-    );
-  }
-
-  // Do nothing if we have not enabled the save data manager.
-  // eslint-disable-next-line @typescript-eslint/dot-notation
-  const mod = modFeature["mod"] as unknown as Record<string, unknown>;
-  const saveDataManagerMethodName = init
-    ? "saveDataManager"
-    : "saveDataManagerRemove";
-  const saveDataManagerMethod = mod[saveDataManagerMethodName];
-  if (saveDataManagerMethod === undefined) {
-    error(
-      'Failed to initialize a mod feature class due to having a "v" object and not having the save data manager initialized. You must pass "ISCFeature.SAVE_DATA_MANAGER" to the "upgradeMod" function.',
-    );
-  }
-
-  if (typeof saveDataManagerMethod !== "function") {
-    error(
-      `The "${saveDataManagerMethodName}" property of the "ModUpgraded" object was not a function.`,
-    );
-  }
-
-  if (init) {
-    saveDataManagerMethod(tstlClassName, v);
-  } else {
-    saveDataManagerMethod(tstlClassName);
-  }
-}

package/src/classes/features/other/SaveDataManager.ts

@@ -11,7 +11,7 @@ import { SaveDataKey } from "../../../enums/SaveDataKey";
 import { SerializationType } from "../../../enums/SerializationType";
 import { deepCopy } from "../../../functions/deepCopy";
 import { onFirstFloor } from "../../../functions/stage";
-import { getTSTLClassName } from "../../../functions/tstlClass";
+import { getTSTLClassName, isTSTLClass } from "../../../functions/tstlClass";
 import { isString, isTable } from "../../../functions/types";
 import { SaveData } from "../../../interfaces/SaveData";
 import { AnyClass } from "../../../types/AnyClass";
@@ -297,7 +297,8 @@ export class SaveDataManager extends Feature {
    *
    * @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.
+   *            registered. Note that you can also pass a TSTL class instead of a string and the
+   *            save data manager will use the name of the class as the key.
    * @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 Optional. A function to run to check if this save data should be written
@@ -311,24 +312,35 @@ export class SaveDataManager extends Feature {
    *                        in your save data, such as `EntityPtr`.
    */
   public saveDataManager<Persistent, Run, Level>(
-    key: string, // This is the overload for the standard case with serializable data.
+    key: unknown, // This is the overload for the standard case with serializable data.
     v: SaveData<Persistent, Run, Level>,
     conditionalFunc?: () => boolean,
   ): void;
   public saveDataManager(
-    key: string, // This is the overload for the case when saving data is disabled.
+    key: unknown, // This is the overload for the case when saving data is disabled.
     v: SaveData,
     conditionalFunc: false,
   ): void;
   @Exported
   public saveDataManager<Persistent, Run, Level>(
-    key: string,
+    key: unknown,
     v: SaveData<Persistent, Run, Level>,
     conditionalFunc?: (() => boolean) | false,
   ): void {
+    if (isTSTLClass(key)) {
+      const className = getTSTLClassName(key);
+      if (className === undefined) {
+        error(
+          'Failed to get the class name for the submitted class (as part of the "key" parameter) when registering new data with the save data manager.',
+        );
+      }
+
+      key = className;
+    }
+
     if (!isString(key)) {
       error(
-        `The save data manager requires that keys are strings. You tried to use a key of type: ${typeof key}`,
+        `The save data manager requires that keys are strings or TSTL classes. You tried to use a key of type: ${typeof key}`,
       );
     }
 

package/src/functions/logMisc.ts

@@ -326,14 +326,18 @@ export function logSounds(): void {
 
 /**
  * Helper function for logging every key and value of a Lua table. This is a deep log; the function
- * will recursively call itself if it counters a table within a table.
+ * will recursively call itself if it encounters a table within a table.
  *
  * This function will only work on tables that have string keys (because it logs the keys in order,
  * instead of randomly). It will throw a run-time error if it encounters a non-string key.
+ *
+ * In order to prevent infinite recursion, this function will not log deeper than 10 nested tables.
  */
 export function logTable(luaTable: unknown, parentTables = 0): void {
   if (parentTables === 0) {
     log("Printing out a Lua table:");
+  } else if (parentTables > 10) {
+    return;
   }
 
   const numSpaces = (parentTables + 1) * 2; // 2, 4, 6, etc.

package/src/functions/rng.ts

@@ -83,7 +83,7 @@ export function isSerializedRNG(object: unknown): object is SerializedRNG {
 }
 
 /**
- * Helper function to initialize an RNG object using Blade's recommended shift index.
+ * Helper function to initialize a new RNG object using Blade's recommended shift index.
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */

package/src/functions/tstlClass.ts

@@ -56,6 +56,12 @@ export function isDefaultMap(
   return className === "DefaultMap";
 }
 
+/** Helper function to check if a given table is a class table created by TypeScriptToLua. */
+export function isTSTLClass(object: unknown): object is TSTLClass {
+  const tstlClassName = getTSTLClassName(object);
+  return tstlClassName !== undefined;
+}
+
 /**
  * Helper function to determine if a given object is a TypeScriptToLua `Map`.
  *
@@ -80,12 +86,6 @@ export function isTSTLSet(object: unknown): object is Set<AnyNotNil> {
   return className === "Set";
 }
 
-/** TypeScriptToLua classes are Lua tables that have a metatable with a certain amount of keys. */
-export function isUserDefinedTSTLClass(object: unknown): object is TSTLClass {
-  const tstlClassName = getTSTLClassName(object);
-  return tstlClassName !== undefined;
-}
-
 /**
  * Initializes a new TypeScriptToLua class in the situation where you do not know what kind of class
  * it is. This function requires that you provide an instantiated class of the same type, as it will