isaacscript-common 18.3.1 → 18.4.0

package/dist/index.d.ts

@@ -1320,6 +1320,8 @@ declare class CollectibleItemPoolType extends Feature {
 export declare function collectibleSpriteEquals(sprite1: Sprite, sprite2: Sprite): boolean;
 
 /**
+ * Equal to `Color(1, 1, 1)`.
+ *
  * This is a safe version of the `Color.Default` constant. (Other mods can mutate `Color.Default`,
  * so it is not safe to use.)
  *
@@ -3088,6 +3090,10 @@ export declare const DICE_FLOOR_TRIGGER_SQUARE_SIZE = 75;
 
 export declare function directionToDegrees(direction: Direction): int;
 
+export declare function directionToMoveAction(direction: Direction): ButtonAction | undefined;
+
+export declare function directionToShootAction(direction: Direction): ButtonAction | undefined;
+
 export declare function directionToVector(direction: Direction): Readonly<Vector>;
 
 declare class DisableAllSound extends Feature {
@@ -11226,8 +11232,18 @@ export declare class ModFeature {
      * conditional logic and early returning at the beginning of every callback function).
      *
      * By default, this is set to null. Override this property in your class if you need to use it.
+     *
+     * The function has the following signature:
+     *
+     * ```ts
+     * (
+     *   vanilla: boolean, // Whether or not this is a vanilla or custom callback.
+     *   modCallback: ModCallback | ModCallbackCustom,
+     *   ...callbackArgs: unknown[]
+     * ) => boolean;
+     * ```
      */
-    protected callbackConditionalFunc: (() => boolean) | null;
+    protected callbackConditionalFunc: ((vanilla: boolean, modCallback: ModCallback | ModCallbackCustom, ...callbackArgs: unknown[]) => boolean) | null;
     /**
      * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
      * save data manager, if any).
@@ -14937,6 +14953,8 @@ export declare function validateInterfaceMatchesEnum<T extends Record<Enum, unkn
 export declare function vectorEquals(vector1: Vector, vector2: Vector): boolean;
 
 /**
+ * Equal to `Vector(1, 1)`.
+ *
  * This is a safe version of the `Vector.One` constant. (Other mods can mutate `Vector.One`, so it
  * is not safe to use.)
  */
@@ -14948,6 +14966,8 @@ export declare function vectorToDirection(vector: Vector): Direction;
 export declare function vectorToString(vector: Vector, round?: boolean): string;
 
 /**
+ * Equal to `Vector(0, 0)`.
+ *
  * This is a safe version of the `Vector.Zero` constant. (Other mods can mutate `Vector.Zero`, so it
  * is not safe to use.)
  */

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 18.3.1
+isaacscript-common 18.4.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -16352,6 +16352,34 @@ ____exports.DIRECTION_TO_DEGREES = {
     [Direction.RIGHT] = 0,
     [Direction.DOWN] = 90
 }
+return ____exports
+ end,
+["src.objects.directionToMoveAction"] = function(...) 
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
+____exports.DIRECTION_TO_MOVE_ACTION = {
+    [Direction.NO_DIRECTION] = nil,
+    [Direction.LEFT] = ButtonAction.LEFT,
+    [Direction.UP] = ButtonAction.UP,
+    [Direction.RIGHT] = ButtonAction.RIGHT,
+    [Direction.DOWN] = ButtonAction.DOWN
+}
+return ____exports
+ end,
+["src.objects.directionToShootAction"] = function(...) 
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("lua_modules.isaac-typescript-definitions.dist.src.index")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
+____exports.DIRECTION_TO_SHOOT_ACTION = {
+    [Direction.NO_DIRECTION] = nil,
+    [Direction.LEFT] = ButtonAction.SHOOT_LEFT,
+    [Direction.UP] = ButtonAction.SHOOT_UP,
+    [Direction.RIGHT] = ButtonAction.SHOOT_RIGHT,
+    [Direction.DOWN] = ButtonAction.SHOOT_DOWN
+}
 return ____exports
  end,
 ["src.functions.array"] = function(...) 
@@ -16995,6 +17023,10 @@ local ____directionNames = require("src.objects.directionNames")
 local DIRECTION_NAMES = ____directionNames.DIRECTION_NAMES
 local ____directionToDegrees = require("src.objects.directionToDegrees")
 local DIRECTION_TO_DEGREES = ____directionToDegrees.DIRECTION_TO_DEGREES
+local ____directionToMoveAction = require("src.objects.directionToMoveAction")
+local DIRECTION_TO_MOVE_ACTION = ____directionToMoveAction.DIRECTION_TO_MOVE_ACTION
+local ____directionToShootAction = require("src.objects.directionToShootAction")
+local DIRECTION_TO_SHOOT_ACTION = ____directionToShootAction.DIRECTION_TO_SHOOT_ACTION
 local ____directionToVector = require("src.objects.directionToVector")
 local DIRECTION_TO_VECTOR = ____directionToVector.DIRECTION_TO_VECTOR
 function ____exports.angleToDirection(self, angleDegrees)
@@ -17020,6 +17052,12 @@ end
 function ____exports.directionToDegrees(self, direction)
     return DIRECTION_TO_DEGREES[direction]
 end
+function ____exports.directionToMoveAction(self, direction)
+    return DIRECTION_TO_MOVE_ACTION[direction]
+end
+function ____exports.directionToShootAction(self, direction)
+    return DIRECTION_TO_SHOOT_ACTION[direction]
+end
 function ____exports.directionToVector(self, direction)
     return DIRECTION_TO_VECTOR[direction]
 end
@@ -49339,7 +49377,7 @@ function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback,
     local function wrappedCallback(____, ...)
         local conditionalFunc = modFeature.callbackConditionalFunc
         if conditionalFunc ~= nil then
-            local shouldRun = conditionalFunc(nil)
+            local shouldRun = conditionalFunc(nil, vanilla, modCallback, ...)
             if not shouldRun then
                 return nil
             end

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

@@ -1,3 +1,5 @@
+import { ModCallback } from "isaac-typescript-definitions";
+import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { ModUpgradedBase } from "./ModUpgradedBase";
 export declare const MOD_FEATURE_CALLBACKS_KEY = "__callbacks";
 export declare const MOD_FEATURE_CUSTOM_CALLBACKS_KEY = "__customCallbacks";
@@ -45,8 +47,18 @@ export declare class ModFeature {
      * conditional logic and early returning at the beginning of every callback function).
      *
      * By default, this is set to null. Override this property in your class if you need to use it.
+     *
+     * The function has the following signature:
+     *
+     * ```ts
+     * (
+     *   vanilla: boolean, // Whether or not this is a vanilla or custom callback.
+     *   modCallback: ModCallback | ModCallbackCustom,
+     *   ...callbackArgs: unknown[]
+     * ) => boolean;
+     * ```
      */
-    protected callbackConditionalFunc: (() => boolean) | null;
+    protected callbackConditionalFunc: ((vanilla: boolean, modCallback: ModCallback | ModCallbackCustom, ...callbackArgs: unknown[]) => boolean) | null;
     /**
      * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
      * save data manager, if any).

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

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAUA,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;;;;;;;;;OASG;IACH,SAAS,CAAC,uBAAuB,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAQ;IAEjE;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAkB;IAE7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,uBAAuB,EAC7B,CAAC,CACC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,GAAG,iBAAiB,EAC5C,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"}

package/dist/src/classes/ModFeature.lua

@@ -66,7 +66,7 @@ function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback,
     local function wrappedCallback(____, ...)
         local conditionalFunc = modFeature.callbackConditionalFunc
         if conditionalFunc ~= nil then
-            local shouldRun = conditionalFunc(nil)
+            local shouldRun = conditionalFunc(nil, vanilla, modCallback, ...)
             if not shouldRun then
                 return nil
             end

package/dist/src/core/constants.d.ts

@@ -133,16 +133,22 @@ export declare const TELEPORTER_ACTIVATION_DISTANCE: number;
  */
 export declare const UI_HEART_WIDTH = 12;
 /**
+ * Equal to `Vector(1, 1)`.
+ *
  * This is a safe version of the `Vector.One` constant. (Other mods can mutate `Vector.One`, so it
  * is not safe to use.)
  */
 export declare const VectorOne: Readonly<Vector>;
 /**
+ * Equal to `Vector(0, 0)`.
+ *
  * This is a safe version of the `Vector.Zero` constant. (Other mods can mutate `Vector.Zero`, so it
  * is not safe to use.)
  */
 export declare const VectorZero: Readonly<Vector>;
 /**
+ * Equal to `Color(1, 1, 1)`.
+ *
  * This is a safe version of the `Color.Default` constant. (Other mods can mutate `Color.Default`,
  * so it is not safe to use.)
  *

package/dist/src/core/constants.d.ts.map

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

package/dist/src/core/constants.lua

@@ -115,13 +115,19 @@ ____exports.TELEPORTER_ACTIVATION_DISTANCE = ____exports.DISTANCE_OF_GRID_TILE /
 --- This is the number of draw coordinates that each heart spans on the UI in the upper left hand
 -- corner.
 ____exports.UI_HEART_WIDTH = 12
---- This is a safe version of the `Vector.One` constant. (Other mods can mutate `Vector.One`, so it
+--- Equal to `Vector(1, 1)`.
+-- 
+-- This is a safe version of the `Vector.One` constant. (Other mods can mutate `Vector.One`, so it
 -- is not safe to use.)
 ____exports.VectorOne = Vector(1, 1)
---- This is a safe version of the `Vector.Zero` constant. (Other mods can mutate `Vector.Zero`, so it
+--- Equal to `Vector(0, 0)`.
+-- 
+-- This is a safe version of the `Vector.Zero` constant. (Other mods can mutate `Vector.Zero`, so it
 -- is not safe to use.)
 ____exports.VectorZero = Vector(0, 0)
---- This is a safe version of the `Color.Default` constant. (Other mods can mutate `Color.Default`,
+--- Equal to `Color(1, 1, 1)`.
+-- 
+-- This is a safe version of the `Color.Default` constant. (Other mods can mutate `Color.Default`,
 -- so it is not safe to use.)
 -- 
 -- If you need to mutate this, make a copy first with the `copyColor` helper function.

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

@@ -1,4 +1,4 @@
-import { Direction } from "isaac-typescript-definitions";
+import { ButtonAction, Direction } from "isaac-typescript-definitions";
 /**
  * Helper function to convert the degrees of an angle to the `Direction` enum.
  *
@@ -8,6 +8,8 @@ import { Direction } from "isaac-typescript-definitions";
  */
 export declare function angleToDirection(angleDegrees: int): Direction;
 export declare function directionToDegrees(direction: Direction): int;
+export declare function directionToMoveAction(direction: Direction): ButtonAction | undefined;
+export declare function directionToShootAction(direction: Direction): ButtonAction | undefined;
 export declare function directionToVector(direction: Direction): Readonly<Vector>;
 export declare function getDirectionName(direction: Direction): string | undefined;
 //# sourceMappingURL=direction.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/functions/direction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAKzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,GAAG,SAAS,CAwB7D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,CAE5D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAExE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzE"}
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/functions/direction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,GAAG,SAAS,CAwB7D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,CAE5D;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,GACnB,YAAY,GAAG,SAAS,CAE1B;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAExE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEzE"}

package/dist/src/functions/direction.lua

@@ -5,6 +5,10 @@ local ____directionNames = require("src.objects.directionNames")
 local DIRECTION_NAMES = ____directionNames.DIRECTION_NAMES
 local ____directionToDegrees = require("src.objects.directionToDegrees")
 local DIRECTION_TO_DEGREES = ____directionToDegrees.DIRECTION_TO_DEGREES
+local ____directionToMoveAction = require("src.objects.directionToMoveAction")
+local DIRECTION_TO_MOVE_ACTION = ____directionToMoveAction.DIRECTION_TO_MOVE_ACTION
+local ____directionToShootAction = require("src.objects.directionToShootAction")
+local DIRECTION_TO_SHOOT_ACTION = ____directionToShootAction.DIRECTION_TO_SHOOT_ACTION
 local ____directionToVector = require("src.objects.directionToVector")
 local DIRECTION_TO_VECTOR = ____directionToVector.DIRECTION_TO_VECTOR
 --- Helper function to convert the degrees of an angle to the `Direction` enum.
@@ -35,6 +39,12 @@ end
 function ____exports.directionToDegrees(self, direction)
     return DIRECTION_TO_DEGREES[direction]
 end
+function ____exports.directionToMoveAction(self, direction)
+    return DIRECTION_TO_MOVE_ACTION[direction]
+end
+function ____exports.directionToShootAction(self, direction)
+    return DIRECTION_TO_SHOOT_ACTION[direction]
+end
 function ____exports.directionToVector(self, direction)
     return DIRECTION_TO_VECTOR[direction]
 end

package/dist/src/objects/directionToMoveAction.d.ts

@@ -0,0 +1,9 @@
+import { ButtonAction } from "isaac-typescript-definitions";
+export declare const DIRECTION_TO_MOVE_ACTION: {
+    readonly [-1]: undefined;
+    readonly 0: ButtonAction.LEFT;
+    readonly 1: ButtonAction.UP;
+    readonly 2: ButtonAction.RIGHT;
+    readonly 3: ButtonAction.DOWN;
+};
+//# sourceMappingURL=directionToMoveAction.d.ts.map

package/dist/src/objects/directionToMoveAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directionToMoveAction.d.ts","sourceRoot":"","sources":["../../../src/objects/directionToMoveAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,8BAA8B,CAAC;AAGvE,eAAO,MAAM,wBAAwB;;;;;;CAMmC,CAAC"}

package/dist/src/objects/directionToMoveAction.lua

@@ -0,0 +1,12 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
+____exports.DIRECTION_TO_MOVE_ACTION = {
+    [Direction.NO_DIRECTION] = nil,
+    [Direction.LEFT] = ButtonAction.LEFT,
+    [Direction.UP] = ButtonAction.UP,
+    [Direction.RIGHT] = ButtonAction.RIGHT,
+    [Direction.DOWN] = ButtonAction.DOWN
+}
+return ____exports

package/dist/src/objects/directionToShootAction.d.ts

@@ -0,0 +1,9 @@
+import { ButtonAction } from "isaac-typescript-definitions";
+export declare const DIRECTION_TO_SHOOT_ACTION: {
+    readonly [-1]: undefined;
+    readonly 0: ButtonAction.SHOOT_LEFT;
+    readonly 1: ButtonAction.SHOOT_UP;
+    readonly 2: ButtonAction.SHOOT_RIGHT;
+    readonly 3: ButtonAction.SHOOT_DOWN;
+};
+//# sourceMappingURL=directionToShootAction.d.ts.map

package/dist/src/objects/directionToShootAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directionToShootAction.d.ts","sourceRoot":"","sources":["../../../src/objects/directionToShootAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,8BAA8B,CAAC;AAGvE,eAAO,MAAM,yBAAyB;;;;;;CAMkC,CAAC"}

package/dist/src/objects/directionToShootAction.lua

@@ -0,0 +1,12 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local Direction = ____isaac_2Dtypescript_2Ddefinitions.Direction
+____exports.DIRECTION_TO_SHOOT_ACTION = {
+    [Direction.NO_DIRECTION] = nil,
+    [Direction.LEFT] = ButtonAction.SHOOT_LEFT,
+    [Direction.UP] = ButtonAction.SHOOT_UP,
+    [Direction.RIGHT] = ButtonAction.SHOOT_RIGHT,
+    [Direction.DOWN] = ButtonAction.SHOOT_DOWN
+}
+return ____exports

package/package.json

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

package/src/classes/ModFeature.ts

@@ -82,8 +82,24 @@ export class ModFeature {
    * conditional logic and early returning at the beginning of every callback function).
    *
    * By default, this is set to null. Override this property in your class if you need to use it.
+   *
+   * The function has the following signature:
+   *
+   * ```ts
+   * (
+   *   vanilla: boolean, // Whether or not this is a vanilla or custom callback.
+   *   modCallback: ModCallback | ModCallbackCustom,
+   *   ...callbackArgs: unknown[]
+   * ) => boolean;
+   * ```
    */
-  protected callbackConditionalFunc: (() => boolean) | null = null;
+  protected callbackConditionalFunc:
+    | ((
+        vanilla: boolean,
+        modCallback: ModCallback | ModCallbackCustom,
+        ...callbackArgs: unknown[]
+      ) => boolean)
+    | null = null;
 
   /**
    * Whether or not the feature has registered its callbacks yet (and submitted its variables to the
@@ -205,13 +221,18 @@ function initDecoratedCallbacks(
         modFeature,
         modFeatureConstructor,
         mod,
-        modCallback,
+        modCallback, // eslint-disable-line isaacscript/strict-enums
         callback,
         parameters,
         vanilla,
       );
     } else {
-      removeCallback(modFeatureConstructor, mod, modCallback, vanilla);
+      removeCallback(
+        modFeatureConstructor,
+        mod,
+        modCallback, // eslint-disable-line isaacscript/strict-enums
+        vanilla,
+      );
     }
   }
 }
@@ -220,9 +241,8 @@ function addCallback(
   modFeature: ModFeature,
   modFeatureConstructor: ModFeatureConstructor,
   mod: ModUpgradedBase,
-  modCallback: unknown,
-  // eslint-disable-next-line @typescript-eslint/ban-types
-  callback: Function,
+  modCallback: ModCallback | ModCallbackCustom,
+  callback: Function, // eslint-disable-line @typescript-eslint/ban-types
   parameters: unknown[],
   vanilla: boolean,
 ) {
@@ -232,7 +252,7 @@ function addCallback(
     // eslint-disable-next-line @typescript-eslint/dot-notation
     const conditionalFunc = modFeature["callbackConditionalFunc"];
     if (conditionalFunc !== null) {
-      const shouldRun = conditionalFunc();
+      const shouldRun = conditionalFunc(vanilla, modCallback, ...callbackArgs);
       if (!shouldRun) {
         return undefined;
       }
@@ -284,7 +304,7 @@ function addCallback(
 function removeCallback(
   modFeatureConstructor: ModFeatureConstructor,
   mod: ModUpgradedBase,
-  modCallback: unknown,
+  modCallback: ModCallback | ModCallbackCustom,
   vanilla: boolean,
 ) {
   if (vanilla) {

package/src/core/constants.ts

@@ -190,18 +190,24 @@ export const TELEPORTER_ACTIVATION_DISTANCE = DISTANCE_OF_GRID_TILE / 2;
 export const UI_HEART_WIDTH = 12;
 
 /**
+ * Equal to `Vector(1, 1)`.
+ *
  * This is a safe version of the `Vector.One` constant. (Other mods can mutate `Vector.One`, so it
  * is not safe to use.)
  */
 export const VectorOne: Readonly<Vector> = Vector(1, 1);
 
 /**
+ * Equal to `Vector(0, 0)`.
+ *
  * This is a safe version of the `Vector.Zero` constant. (Other mods can mutate `Vector.Zero`, so it
  * is not safe to use.)
  */
 export const VectorZero: Readonly<Vector> = Vector(0, 0);
 
 /**
+ * Equal to `Color(1, 1, 1)`.
+ *
  * This is a safe version of the `Color.Default` constant. (Other mods can mutate `Color.Default`,
  * so it is not safe to use.)
  *

package/src/functions/direction.ts

@@ -1,6 +1,8 @@
-import { Direction } from "isaac-typescript-definitions";
+import { ButtonAction, Direction } from "isaac-typescript-definitions";
 import { DIRECTION_NAMES } from "../objects/directionNames";
 import { DIRECTION_TO_DEGREES } from "../objects/directionToDegrees";
+import { DIRECTION_TO_MOVE_ACTION } from "../objects/directionToMoveAction";
+import { DIRECTION_TO_SHOOT_ACTION } from "../objects/directionToShootAction";
 import { DIRECTION_TO_VECTOR } from "../objects/directionToVector";
 
 /**
@@ -40,6 +42,18 @@ export function directionToDegrees(direction: Direction): int {
   return DIRECTION_TO_DEGREES[direction];
 }
 
+export function directionToMoveAction(
+  direction: Direction,
+): ButtonAction | undefined {
+  return DIRECTION_TO_MOVE_ACTION[direction];
+}
+
+export function directionToShootAction(
+  direction: Direction,
+): ButtonAction | undefined {
+  return DIRECTION_TO_SHOOT_ACTION[direction];
+}
+
 export function directionToVector(direction: Direction): Readonly<Vector> {
   return DIRECTION_TO_VECTOR[direction];
 }

package/src/objects/directionToMoveAction.ts

@@ -0,0 +1,10 @@
+import { ButtonAction, Direction } from "isaac-typescript-definitions";
+import { HasAllEnumKeys } from "../types/HasAllEnumKeys";
+
+export const DIRECTION_TO_MOVE_ACTION = {
+  [Direction.NO_DIRECTION]: undefined, // -1
+  [Direction.LEFT]: ButtonAction.LEFT, // 0
+  [Direction.UP]: ButtonAction.UP, // 1
+  [Direction.RIGHT]: ButtonAction.RIGHT, // 2
+  [Direction.DOWN]: ButtonAction.DOWN, // 3
+} as const satisfies HasAllEnumKeys<Direction, ButtonAction | undefined>;

package/src/objects/directionToShootAction.ts

@@ -0,0 +1,10 @@
+import { ButtonAction, Direction } from "isaac-typescript-definitions";
+import { HasAllEnumKeys } from "../types/HasAllEnumKeys";
+
+export const DIRECTION_TO_SHOOT_ACTION = {
+  [Direction.NO_DIRECTION]: undefined, // -1
+  [Direction.LEFT]: ButtonAction.SHOOT_LEFT, // 0
+  [Direction.UP]: ButtonAction.SHOOT_UP, // 1
+  [Direction.RIGHT]: ButtonAction.SHOOT_RIGHT, // 2
+  [Direction.DOWN]: ButtonAction.SHOOT_DOWN, // 3
+} as const satisfies HasAllEnumKeys<Direction, ButtonAction | undefined>;