isaacscript-common 20.5.0 → 20.6.1

package/dist/index.d.ts

@@ -7664,8 +7664,12 @@ export declare function isModifierKeyPressed(): boolean;
 
 export declare function isMoveAction(buttonAction: ButtonAction): boolean;
 
+export declare function isMoveActionPressed(controllerIndex: ControllerIndex): boolean;
+
 export declare function isMoveActionPressedOnAnyInput(): boolean;
 
+export declare function isMoveActionTriggered(controllerIndex: ControllerIndex): boolean;
+
 export declare function isMoveActionTriggeredOnAnyInput(): boolean;
 
 export declare function isNarrowRoom(roomShape: RoomShape): boolean;
@@ -7868,8 +7872,12 @@ export declare function isSerializedVector(object: unknown): object is Serialize
 
 export declare function isShootAction(buttonAction: ButtonAction): boolean;
 
+export declare function isShootActionPressed(controllerIndex: ControllerIndex): boolean;
+
 export declare function isShootActionPressedOnAnyInput(): boolean;
 
+export declare function isShootActionTriggered(controllerIndex: ControllerIndex): boolean;
+
 export declare function isShootActionTriggeredOnAnyInput(): boolean;
 
 /** Helper function to check if the provided NPC is a Sin miniboss, such as Sloth or Lust. */
@@ -8476,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;
 
@@ -11378,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
@@ -11619,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()`.
  */

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 20.5.0
+isaacscript-common 20.6.1
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -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(
@@ -37423,12 +37425,26 @@ end
 function ____exports.isMoveAction(self, buttonAction)
     return ____exports.MOVEMENT_ACTIONS_SET:has(buttonAction)
 end
+function ____exports.isMoveActionPressed(self, controllerIndex)
+    return ____exports.isActionPressed(
+        nil,
+        controllerIndex,
+        table.unpack(MOVEMENT_ACTIONS)
+    )
+end
 function ____exports.isMoveActionPressedOnAnyInput(self)
     return __TS__ArraySome(
         MOVEMENT_ACTIONS,
         function(____, moveAction) return ____exports.isActionPressedOnAnyInput(nil, moveAction) end
     )
 end
+function ____exports.isMoveActionTriggered(self, controllerIndex)
+    return ____exports.isActionTriggered(
+        nil,
+        controllerIndex,
+        table.unpack(MOVEMENT_ACTIONS)
+    )
+end
 function ____exports.isMoveActionTriggeredOnAnyInput(self)
     return __TS__ArraySome(
         MOVEMENT_ACTIONS,
@@ -37438,12 +37454,26 @@ end
 function ____exports.isShootAction(self, buttonAction)
     return ____exports.SHOOTING_ACTIONS_SET:has(buttonAction)
 end
+function ____exports.isShootActionPressed(self, controllerIndex)
+    return ____exports.isActionPressed(
+        nil,
+        controllerIndex,
+        table.unpack(SHOOTING_ACTIONS)
+    )
+end
 function ____exports.isShootActionPressedOnAnyInput(self)
     return __TS__ArraySome(
         SHOOTING_ACTIONS,
         function(____, shootAction) return ____exports.isActionPressedOnAnyInput(nil, shootAction) end
     )
 end
+function ____exports.isShootActionTriggered(self, controllerIndex)
+    return ____exports.isActionTriggered(
+        nil,
+        controllerIndex,
+        table.unpack(SHOOTING_ACTIONS)
+    )
+end
 function ____exports.isShootActionTriggeredOnAnyInput(self)
     return __TS__ArraySome(
         SHOOTING_ACTIONS,
@@ -49767,7 +49797,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")
@@ -49776,7 +49806,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
@@ -49888,30 +49917,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"
@@ -49962,7 +49967,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/functions/input.d.ts

@@ -56,10 +56,14 @@ export declare function isKeyboardPressed(...keys: Keyboard[]): boolean;
  */
 export declare function isModifierKeyPressed(): boolean;
 export declare function isMoveAction(buttonAction: ButtonAction): boolean;
+export declare function isMoveActionPressed(controllerIndex: ControllerIndex): boolean;
 export declare function isMoveActionPressedOnAnyInput(): boolean;
+export declare function isMoveActionTriggered(controllerIndex: ControllerIndex): boolean;
 export declare function isMoveActionTriggeredOnAnyInput(): boolean;
 export declare function isShootAction(buttonAction: ButtonAction): boolean;
+export declare function isShootActionPressed(controllerIndex: ControllerIndex): boolean;
 export declare function isShootActionPressedOnAnyInput(): boolean;
+export declare function isShootActionTriggered(controllerIndex: ControllerIndex): boolean;
 export declare function isShootActionTriggeredOnAnyInput(): boolean;
 /**
  * Helper function to get the string that would be typed if someone pressed the corresponding key.

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

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,eAAe,EACf,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuBtC,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AASF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,YAAY,CAAC,CAE1D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/functions/input.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,eAAe,EACf,QAAQ,EACT,MAAM,8BAA8B,CAAC;AAuBtC,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AASF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,YAAY,CAE1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,YAAY,CAAC,CAE1D;AAED,wBAAgB,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,eAAe,EAChC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,aAAa,EAAE,YAAY,EAAE,GAC/B,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAE7E;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAIvD;AAED,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,GAC/B,OAAO,CAET;AAED,wBAAgB,gCAAgC,IAAI,OAAO,CAI1D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/src/functions/input.lua

@@ -126,12 +126,26 @@ end
 function ____exports.isMoveAction(self, buttonAction)
     return ____exports.MOVEMENT_ACTIONS_SET:has(buttonAction)
 end
+function ____exports.isMoveActionPressed(self, controllerIndex)
+    return ____exports.isActionPressed(
+        nil,
+        controllerIndex,
+        table.unpack(MOVEMENT_ACTIONS)
+    )
+end
 function ____exports.isMoveActionPressedOnAnyInput(self)
     return __TS__ArraySome(
         MOVEMENT_ACTIONS,
         function(____, moveAction) return ____exports.isActionPressedOnAnyInput(nil, moveAction) end
     )
 end
+function ____exports.isMoveActionTriggered(self, controllerIndex)
+    return ____exports.isActionTriggered(
+        nil,
+        controllerIndex,
+        table.unpack(MOVEMENT_ACTIONS)
+    )
+end
 function ____exports.isMoveActionTriggeredOnAnyInput(self)
     return __TS__ArraySome(
         MOVEMENT_ACTIONS,
@@ -141,12 +155,26 @@ end
 function ____exports.isShootAction(self, buttonAction)
     return ____exports.SHOOTING_ACTIONS_SET:has(buttonAction)
 end
+function ____exports.isShootActionPressed(self, controllerIndex)
+    return ____exports.isActionPressed(
+        nil,
+        controllerIndex,
+        table.unpack(SHOOTING_ACTIONS)
+    )
+end
 function ____exports.isShootActionPressedOnAnyInput(self)
     return __TS__ArraySome(
         SHOOTING_ACTIONS,
         function(____, shootAction) return ____exports.isActionPressedOnAnyInput(nil, shootAction) end
     )
 end
+function ____exports.isShootActionTriggered(self, controllerIndex)
+    return ____exports.isActionTriggered(
+        nil,
+        controllerIndex,
+        table.unpack(SHOOTING_ACTIONS)
+    )
+end
 function ____exports.isShootActionTriggeredOnAnyInput(self)
     return __TS__ArraySome(
         SHOOTING_ACTIONS,

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "20.5.0",
+  "version": "20.6.1",
   "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/functions/input.ts

@@ -154,12 +154,22 @@ export function isMoveAction(buttonAction: ButtonAction): boolean {
   return MOVEMENT_ACTIONS_SET.has(buttonAction);
 }
 
+export function isMoveActionPressed(controllerIndex: ControllerIndex): boolean {
+  return isActionPressed(controllerIndex, ...MOVEMENT_ACTIONS);
+}
+
 export function isMoveActionPressedOnAnyInput(): boolean {
   return MOVEMENT_ACTIONS.some((moveAction) =>
     isActionPressedOnAnyInput(moveAction),
   );
 }
 
+export function isMoveActionTriggered(
+  controllerIndex: ControllerIndex,
+): boolean {
+  return isActionTriggered(controllerIndex, ...MOVEMENT_ACTIONS);
+}
+
 export function isMoveActionTriggeredOnAnyInput(): boolean {
   return MOVEMENT_ACTIONS.some((moveAction) =>
     isActionTriggeredOnAnyInput(moveAction),
@@ -170,12 +180,24 @@ export function isShootAction(buttonAction: ButtonAction): boolean {
   return SHOOTING_ACTIONS_SET.has(buttonAction);
 }
 
+export function isShootActionPressed(
+  controllerIndex: ControllerIndex,
+): boolean {
+  return isActionPressed(controllerIndex, ...SHOOTING_ACTIONS);
+}
+
 export function isShootActionPressedOnAnyInput(): boolean {
   return SHOOTING_ACTIONS.some((shootAction) =>
     isActionPressedOnAnyInput(shootAction),
   );
 }
 
+export function isShootActionTriggered(
+  controllerIndex: ControllerIndex,
+): boolean {
+  return isActionTriggered(controllerIndex, ...SHOOTING_ACTIONS);
+}
+
 export function isShootActionTriggeredOnAnyInput(): boolean {
   return SHOOTING_ACTIONS.some((shootAction) =>
     isActionTriggeredOnAnyInput(shootAction),

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()`.
  */