isaacscript-common 87.4.0 → 87.5.1

package/dist/index.rollup.d.ts

@@ -1,7 +1,3 @@
-/// <reference types="@typescript-to-lua/language-extensions" />
-/// <reference types="isaac-typescript-definitions" />
-/// <reference types="lua-types/5.3" />
-
 import { ActiveSlot } from 'isaac-typescript-definitions';
 import type { BackdropType } from 'isaac-typescript-definitions';
 import type { BatterySubType } from 'isaac-typescript-definitions';
@@ -84,7 +80,11 @@ import type { TrapdoorVariant } from 'isaac-typescript-definitions';
 import { TrinketType } from 'isaac-typescript-definitions';
 import { UseFlag } from 'isaac-typescript-definitions';
 
-/** From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468 */
+/**
+ * Helper type to add two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
 export declare type Add<A extends number, B extends number> = Length<[
 ...BuildTuple<A>,
 ...BuildTuple<B>
@@ -725,12 +725,14 @@ declare interface AddCallbackParametersCustom {
     playerVariant?: PlayerVariant,
     character?: PlayerType
     ];
-    [ModCallbackCustom.PRE_ITEM_PICKUP]: [callback: (player: EntityPlayer, pickingUpItem: PickingUpItem) => void] | [
-    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemCollectible) => void,
+    [ModCallbackCustom.PRE_ITEM_PICKUP]: [
+    callback: (player: EntityPlayer, pickingUpItem: PickingUpItem) => boolean | undefined
+    ] | [
+    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemCollectible) => boolean | undefined,
     itemType: ItemType.PASSIVE | ItemType.ACTIVE | ItemType.FAMILIAR,
     collectibleType?: CollectibleType
     ] | [
-    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemTrinket) => void,
+    callback: (player: EntityPlayer, pickingUpItem: PickingUpItemTrinket) => boolean | undefined,
     itemType: ItemType.TRINKET,
     trinketType?: TrinketType
     ];
@@ -1154,7 +1156,7 @@ export declare function arrayToString(array: readonly unknown[]): string;
  * Helper function to safely cast an `int` to a `CardType`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asCardType(num: int): CardType;
 
@@ -1162,7 +1164,7 @@ export declare function asCardType(num: int): CardType;
  * Helper function to safely cast an `int` to a `CollectibleType`. (This is better than using the
  * `as` TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asCollectibleType(num: int): CollectibleType;
 
@@ -1170,7 +1172,7 @@ export declare function asCollectibleType(num: int): CollectibleType;
  * Helper function to safely cast an enum to an `int`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asFloat(num: number): float;
 
@@ -1178,7 +1180,7 @@ export declare function asFloat(num: number): float;
  * Helper function to safely cast an enum to an `int`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asInt(num: number): int;
 
@@ -1186,7 +1188,7 @@ export declare function asInt(num: number): int;
  * Helper function to safely cast an `int` to a `LevelStage`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asLevelStage(num: int): LevelStage;
 
@@ -1194,7 +1196,7 @@ export declare function asLevelStage(num: int): LevelStage;
  * Helper function to safely cast an `int` to a `NPCState`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asNPCState(num: int): NPCState;
 
@@ -1202,7 +1204,7 @@ export declare function asNPCState(num: int): NPCState;
  * Helper function to safely cast an enum to a `number`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asNumber(num: number): number;
 
@@ -1210,7 +1212,7 @@ export declare function asNumber(num: number): number;
  * Helper function to safely cast an `int` to a `PillColor`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asPillColor(num: int): PillColor;
 
@@ -1218,7 +1220,7 @@ export declare function asPillColor(num: int): PillColor;
  * Helper function to safely cast an `int` to a `PillEffect`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asPillEffect(num: int): PillEffect;
 
@@ -1226,7 +1228,7 @@ export declare function asPillEffect(num: int): PillEffect;
  * Helper function to safely cast an `int` to a `PlayerType`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asPlayerType(num: int): PlayerType;
 
@@ -1234,7 +1236,7 @@ export declare function asPlayerType(num: int): PlayerType;
  * Helper function to safely cast an `int` to a `RoomType`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asRoomType(num: int): RoomType;
 
@@ -1262,7 +1264,7 @@ export declare function assertNotNull<T>(value: T, ...[msg]: [null] extends [T]
  * Helper function to safely cast an enum to a `string`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asString(str: string): string;
 
@@ -1270,7 +1272,7 @@ export declare function asString(str: string): string;
  * Helper function to safely cast an `int` to a `TrinketType`. (This is better than using the `as`
  * TypeScript keyword to do a type assertion, since that can obfuscate compiler errors. )
  *
- * This is useful to satisfy the "isaacscript/strict-enums" ESLint rule.
+ * This is useful to satisfy the "complete/strict-enums" ESLint rule.
  */
 export declare function asTrinketType(num: int): TrinketType;
 
@@ -1342,7 +1344,7 @@ export declare function calculateStageTypeRepentance(stage: LevelStage): StageTy
  * @allowEmptyVariadic
  * @ignore
  */
-export declare function Callback<T extends ModCallback>(modCallback: T, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+export declare function Callback<T extends ModCallback>(modCallback: T, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Fn extends AddCallbackParameters[T][0]>(target: ModFeature, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 /**
  * A decorator function that signifies that the decorated class method should be automatically
@@ -1351,7 +1353,7 @@ export declare function Callback<T extends ModCallback>(modCallback: T, ...optio
  * @allowEmptyVariadic
  * @ignore
  */
-export declare function CallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+export declare function CallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Fn extends AddCallbackParametersCustom[T][0]>(target: ModFeature, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 /**
  * Helper function to determine if the given character can have red heart containers. Returns true
@@ -1994,7 +1996,7 @@ declare class CustomGridEntities extends Feature {
      *
      * @public
      */
-    getCustomGridEntities(): Array<{
+    getCustomGridEntities(): ReadonlyArray<{
         gridEntity: GridEntity;
         data: GridEntityCustomData;
     }>;
@@ -3702,6 +3704,8 @@ declare class DeployJSONRoom extends Feature {
  *
  * Under the hood, this clones the `QueuedItemData`, since directly setting the `Item` field to
  * `undefined` does not work for some reason.
+ *
+ * This method was discovered by im_tem.
  */
 export declare function dequeueItem(player: EntityPlayer): boolean;
 
@@ -4287,7 +4291,7 @@ declare class EdenStartingStatsHealth extends Feature {
      *
      * @public
      */
-    getEdenStartingCollectibles(player: EntityPlayer): CollectibleType[];
+    getEdenStartingCollectibles(player: EntityPlayer): readonly CollectibleType[];
     /**
      * Helper function to get the health that Eden started with at the beginning of the run before any
      * of the random collectibles were added.
@@ -4348,7 +4352,7 @@ export declare const EGGY_STATE_FRAME_OF_FINAL_SPIDER = 45;
 export declare const EMPTY_PNG_PATH = "gfx/none.png";
 
 /** Helper function to remove all of the elements in an array in-place. */
-export declare function emptyArray<T>(array: T[]): void;
+export declare function emptyArray(array: unknown[]): void;
 
 /**
  * Helper function to remove all naturally spawning entities and grid entities from a room. Notably,
@@ -4442,7 +4446,8 @@ export declare function every<T>(array: readonly T[], func: (value: T, index: nu
 
 /**
  * When you enable this feature, many custom commands will be added to the in-game console. See the
- * [dedicated command list](ExtraConsoleCommandsList) for more information about them.
+ * [dedicated command list](/isaacscript-common/features/ExtraConsoleCommandsList) for more
+ * information about them.
  *
  * Note that in order to avoid conflicts, if two or more mods enable this feature, then the first
  * loaded one will control all of the command logic. When this occurs, a global variable of
@@ -4466,10 +4471,11 @@ declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to add a custom console command.
      *
-     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
-     * are useful for debugging, but you can also add your own commands that are useful for your
-     * particular mod. It's easier to add commands to the existing command system than to add your own
-     * logic manually to the `EXECUTE_CMD` callback.
+     * The standard library comes with [many existing console
+     * commands](/isaacscript-common/features/ExtraConsoleCommandsList) that are useful for debugging,
+     * but you can also add your own commands that are useful for your particular mod. It's easier to
+     * add commands to the existing command system than to add your own logic manually to the
+     * `EXECUTE_CMD` callback.
      *
      * This function is intended to be called when your mod is first loading.
      *
@@ -4482,8 +4488,9 @@ declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to remove a custom console command.
      *
-     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
-     * are useful for debugging. If you want to disable one of them, use this function.
+     * The standard library comes with [many existing console
+     * commands](/isaacscript-common/features/ExtraConsoleCommandsList) that are useful for debugging.
+     * If you want to disable one of them, use this function.
      *
      * This function is intended to be called when your mod is first loading.
      *
@@ -4496,9 +4503,10 @@ declare class ExtraConsoleCommands extends Feature {
     /**
      * Helper function to remove all custom console commands.
      *
-     * The standard library comes with [many existing console commands](ExtraConsoleCommandsList) that
-     * are useful for debugging. If you want to disable all of them after this feature has already
-     * been initialized, use this function.
+     * The standard library comes with [many existing console
+     * commands](/isaacscript-common/features/ExtraConsoleCommandsList) that are useful for debugging.
+     * If you want to disable all of them after this feature has already been initialized, use this
+     * function.
      *
      * In order to use this function, you must upgrade your mod with
      * `ISCFeature.EXTRA_CONSOLE_COMMANDS`.
@@ -4510,7 +4518,11 @@ declare class ExtraConsoleCommands extends Feature {
 
 /**
  * A function that creates the default value for your `DefaultMap`. For example, if it was a
- * `DefaultMap` containing maps, the factory function would be: `() => new Map()`
+ * `DefaultMap` containing maps, the factory function would be:
+ *
+ * ```ts
+ * () => new Map()
+ * ```
  */
 export declare type FactoryFunction<V, Args extends unknown[]> = (...args: Args) => V;
 
@@ -5058,7 +5070,7 @@ export declare function getArrayDuplicateElements<T extends number | string>(arr
  * due to implementation details of TypeScriptToLua, this results in an array of 1 through N
  * (instead of an array of 0 through N -1).
  */
-export declare function getArrayIndexes<T>(array: readonly T[]): readonly int[];
+export declare function getArrayIndexes(array: readonly unknown[]): readonly int[];
 
 /**
  * Helper function to get how long Azazel's Brimstone laser should be. You can pass either an
@@ -7083,7 +7095,7 @@ export declare function getRandomArrayElementAndRemove<T>(array: T[], seedOrRNG:
  * @param exceptions Optional. An array of indexes that will be skipped over when getting the random
  *                   index. Default is an empty array.
  */
-export declare function getRandomArrayIndex<T>(array: readonly T[], seedOrRNG: Seed | RNG | undefined, exceptions?: readonly int[]): int;
+export declare function getRandomArrayIndex(array: readonly unknown[], seedOrRNG: Seed | RNG | undefined, exceptions?: readonly int[]): int;
 
 /**
  * Helper function to get a random `Color` object.
@@ -9470,10 +9482,10 @@ export declare function isDeadEnd(roomGridIndex?: int): boolean;
 export declare function isDeathCertificateArea(roomData: RoomConfig): boolean;
 
 /**
- * Helper function to determine if a given object is a TypeScriptToLua `Map`.
+ * Helper function to determine if a given object is a `DefaultMap` from `isaacscript-common`.
  *
  * It is not reliable to use the `instanceof` operator to determine this because each Lua module has
- * their own copies of the entire lualib and thus their own instantiated version of a `Map`.
+ * their own copies of the entire lualib and thus their own instantiated version of a `DefaultMap`.
  */
 export declare function isDefaultMap(object: unknown): object is DefaultMap<AnyNotNil, unknown>;
 
@@ -9584,7 +9596,7 @@ export declare function isEffect(variable: unknown): variable is EntityEffect;
  * (This is equivalent to checking if the flag is equal to 0, but this is not possible without
  * casting the flag to a number.)
  */
-export declare function isEmptyFlag<T extends BitFlag | BitFlag128>(flag: T): boolean;
+export declare function isEmptyFlag(flag: BitFlag | BitFlag128): boolean;
 
 /**
  * Helper function to detect if a variable is of type `Entity`. This will return false for child
@@ -10539,20 +10551,20 @@ export declare function iterateTableInOrder<K extends AnyNotNil, V>(luaMap: LuaM
  *
  * Internally, this just calls `Array.join`.
  */
-export declare function join<T>(array: readonly T[], separator: string): string;
+export declare function join(array: readonly unknown[], separator: string): string;
 
 /**
  * Converts a JSON string to a Lua table.
  *
  * In most cases, this function will be used for reading data from a "save#.dat" file. If decoding
- * fails, it will return a blank Lua table instead of throwing an error. (This allows execution to
- * continue in cases where users have no current save data or have manually removed their existing
- * save data.)
+ * fails, it will return undefined instead of throwing an error. (This allows execution to continue
+ * in cases where users have no current save data or have manually removed their existing save
+ * data.)
  *
  * Under the hood, this uses a custom JSON parser that was measured to be 11.8 times faster than the
  * vanilla JSON parser.
  */
-export declare function jsonDecode(jsonString: string): LuaMap<AnyNotNil, unknown>;
+export declare function jsonDecode(jsonString: string): LuaMap<AnyNotNil, unknown> | undefined;
 
 /** Part of `JSONRoomsFile`. */
 export declare interface JSONDoor {
@@ -10845,7 +10857,7 @@ export declare function logAndPrint(msg: string): void;
  * @param array The array to log.
  * @param name Optional. The name of the array, which will be logged before the elements.
  */
-export declare function logArray<T>(this: void, array: readonly T[], name?: string): void;
+export declare function logArray(this: void, array: readonly unknown[], name?: string): void;
 
 /**
  * Helper function to log the names of a collectible type array.
@@ -12830,8 +12842,8 @@ export declare enum ModCallbackCustom {
      */
     POST_PLAYER_COLLECTIBLE_REMOVED = 88,
     /**
-     * Fires from the `ENTITY_TAKE_DMG` callback when a player takes fatal damage. Return false to
-     * prevent the fatal damage.
+     * Fires from the `ENTITY_TAKE_DMG` callback when a player takes fatal damage. You can optionally
+     * return false to prevent the fatal damage.
      *
      * Note that this function does properly take into account Guppy's Collar, Broken Ankh, Spirit
      * Shackles, and Mysterious Paper. It also takes into account using The Bible on Satan.
@@ -13588,7 +13600,8 @@ export declare enum ModCallbackCustom {
     PRE_GET_PEDESTAL = 132,
     /**
      * Fires from the `POST_PEFFECT_UPDATE_REORDERED` callback when an item becomes queued (i.e. when
-     * the player begins to hold the item above their head).
+     * the player begins to hold the item above their head). You can optionally return false if you
+     * want the item to not be granted to the player.
      *
      * Note that this callback will only fire once per Forgotten/Soul pair.
      *
@@ -13602,7 +13615,7 @@ export declare enum ModCallbackCustom {
      * function preItemPickup(
      *   player: EntityPlayer,
      *   pickingUpItem: PickingUpItem,
-     * ): void {}
+     * ): boolean | undefined {}
      * ```
      */
     PRE_ITEM_PICKUP = 133,
@@ -14122,7 +14135,7 @@ declare class ModdedElementSets extends Feature {
      *
      * @public
      */
-    getPlayerCollectibleMap(player: EntityPlayer): Map<CollectibleType, int>;
+    getPlayerCollectibleMap(player: EntityPlayer): ReadonlyMap<CollectibleType, int>;
     /**
      * Returns an array containing every modded trinket type in the game.
      *
@@ -14364,7 +14377,7 @@ declare class ModdedElementSets extends Feature {
      *
      * @public
      */
-    getPlayerTrinketsWithCacheFlag(player: EntityPlayer, cacheFlag: CacheFlag): Map<TrinketType, int>;
+    getPlayerTrinketsWithCacheFlag(player: EntityPlayer, cacheFlag: CacheFlag): ReadonlyMap<TrinketType, int>;
     /**
      * Returns a set of all of the collectibles that grant flight. This is derived from collectibles
      * that have `CacheFlag.FLYING` set in the "items.xml" file.
@@ -15371,7 +15384,7 @@ export declare function parseEntityTypeVariantString(entityTypeVariantString: st
  *
  * Under the hood, this uses the built-in `tonumber` and `math.floor` functions.
  *
- * This is named `parseIntSafe` in order to match the helper function in `isaacscript-common-ts`.
+ * This is named `parseIntSafe` in order to match the helper function from `complete-common`.
  */
 export declare function parseIntSafe(string: string): int | undefined;
 
@@ -15848,7 +15861,7 @@ export declare type PossibleStatType = number | boolean | BitFlags<TearFlag> | C
 
 declare class PostCustomRevive extends CustomCallback<ModCallbackCustom.POST_CUSTOM_REVIVE> {
     constructor();
-    protected shouldFire: (fireArgs: [player: EntityPlayer, revivalType: int], optionalArgs: OptionalArgs<T>) => boolean;
+    protected shouldFire: (fireArgs: FireArgs<T>, optionalArgs: OptionalArgs<T>) => boolean;
 }
 
 declare class PostEsauJr extends CustomCallback<ModCallbackCustom.POST_ESAU_JR> {
@@ -15874,7 +15887,7 @@ declare class PostGridEntityBroken extends CustomCallback<ModCallbackCustom.POST
 
 declare class PostGridEntityCollision extends CustomCallback<T_2> {
     constructor();
-    protected shouldFire: (fireArgs: [gridEntity: GridEntity, entity: Entity], optionalArgs: [gridEntityType?: GridEntityType | undefined, gridEntityVariant?: int | undefined, entityType?: EntityType | undefined, entityVariant?: int | undefined, entitySubType?: int | undefined]) => boolean;
+    protected shouldFire: (fireArgs: FireArgs<T_2>, optionalArgs: OptionalArgs<T_2>) => boolean;
 }
 
 declare class PostGridEntityCustomBroken extends CustomCallback<ModCallbackCustom.POST_GRID_ENTITY_CUSTOM_BROKEN> {
@@ -15884,7 +15897,7 @@ declare class PostGridEntityCustomBroken extends CustomCallback<ModCallbackCusto
 
 declare class PostGridEntityCustomCollision extends CustomCallback<T_3> {
     constructor();
-    protected shouldFire: (fireArgs: [gridEntity: GridEntity, gridEntityTypeCustom: GridEntityType, entity: Entity], optionalArgs: [gridEntityTypeCustom?: GridEntityType | undefined, entityType?: EntityType | undefined, entityVariant?: int | undefined, entitySubType?: int | undefined]) => boolean;
+    protected shouldFire: (fireArgs: FireArgs<T_3>, optionalArgs: OptionalArgs<T_3>) => boolean;
 }
 
 declare class PostGridEntityCustomInit extends CustomCallback<ModCallbackCustom.POST_GRID_ENTITY_CUSTOM_INIT> {
@@ -15894,7 +15907,7 @@ declare class PostGridEntityCustomInit extends CustomCallback<ModCallbackCustom.
 
 declare class PostGridEntityCustomRemove extends CustomCallback<T_5> {
     constructor();
-    protected shouldFire: (fireArgs: [gridIndex: int, gridEntityTypeCustom: GridEntityType], optionalArgs: OptionalArgs<T_5>) => boolean;
+    protected shouldFire: (fireArgs: FireArgs<T_5>, optionalArgs: OptionalArgs<T_5>) => boolean;
 }
 
 declare class PostGridEntityCustomRender extends CustomCallback<ModCallbackCustom.POST_GRID_ENTITY_CUSTOM_RENDER> {
@@ -15919,7 +15932,7 @@ declare class PostGridEntityInit extends CustomCallback<ModCallbackCustom.POST_G
 
 declare class PostGridEntityRemove extends CustomCallback<T_4> {
     constructor();
-    protected shouldFire: (fireArgs: [gridIndex: int, gridEntityType: GridEntityType, variant: int], optionalArgs: [gridEntityType?: GridEntityType | undefined, variant?: int | undefined]) => boolean;
+    protected shouldFire: (fireArgs: FireArgs<T_4>, optionalArgs: OptionalArgs<T_4>) => boolean;
 }
 
 declare class PostGridEntityRender extends CustomCallback<ModCallbackCustom.POST_GRID_ENTITY_RENDER> {
@@ -16091,7 +16104,7 @@ export declare function printEnabled(enabled: boolean, description: string): voi
  * @allowEmptyVariadic
  * @ignore
  */
-export declare function PriorityCallback<T extends ModCallback>(modCallback: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+export declare function PriorityCallback<T extends ModCallback>(modCallback: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Fn extends AddCallbackParameters[T][0]>(target: ModFeature, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 /**
  * A decorator function that signifies that the decorated class method should be automatically
@@ -16100,7 +16113,7 @@ export declare function PriorityCallback<T extends ModCallback>(modCallback: T,
  * @allowEmptyVariadic
  * @ignore
  */
-export declare function PriorityCallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+export declare function PriorityCallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Fn extends AddCallbackParametersCustom[T][0]>(target: ModFeature, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 
 /** Helper type to extract only the public interface of a class. */
 export declare type PublicInterface<T> = Pick<T, keyof T>;
@@ -18150,7 +18163,7 @@ export declare function shuffleArray<T>(originalArray: readonly T[], seedOrRNG:
  *                  `RNG.Next` method will be called. If `undefined` is provided, it will default to
  *                  a random seed.
  */
-export declare function shuffleArrayInPlace<T>(array: T[], seedOrRNG: Seed | RNG | undefined): void;
+export declare function shuffleArrayInPlace(array: unknown[], seedOrRNG: Seed | RNG | undefined): void;
 
 /** @returns 1 if n is positive, -1 if n is negative, or 0 if n is 0. */
 export declare function sign(n: number): int;
@@ -18302,8 +18315,8 @@ export declare function sortTwoDimensionalArray<T>(a: readonly T[], b: readonly
 export declare type SoulHeartType = HeartSubType.SOUL | HeartSubType.BLACK | HeartSubType.BONE;
 
 /**
- * Helper function to spawn an entity. Use this instead of the `Isaac.Spawn` method if you do not
- * need to specify the velocity or spawner.
+ * Helper function to spawn an entity. Always use this instead of the `Isaac.Spawn` method, since
+ * using that method can crash the game.
  *
  * Also see the `spawnWithSeed` helper function.
  *
@@ -18315,7 +18328,7 @@ export declare type SoulHeartType = HeartSubType.SOUL | HeartSubType.BLACK | Hea
  * @param spawner Optional. The entity that will be the `SpawnerEntity`. Default is undefined.
  * @param seedOrRNG Optional. The seed or RNG object to use to generate the `InitSeed` of the
  *                  entity. Default is undefined, which will make the entity spawn with a random
- *                  seed using the `Isaac.Spawn` method.
+ *                  seed.
  */
 export declare function spawn(entityType: EntityType, variant: int, subType: int, positionOrGridIndex: Vector | int, velocity?: Vector, spawner?: Entity | undefined, seedOrRNG?: Seed | RNG | undefined): Entity;
 
@@ -18934,7 +18947,11 @@ declare const STORY_BOSS_IDS: readonly [BossID.MOM, BossID.MOMS_HEART, BossID.SA
  */
 export declare type StoryBossID = (typeof STORY_BOSS_IDS)[number];
 
-/** From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468 */
+/**
+ * Helper type to subtract two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
 export declare type Subtract<A extends number, B extends number> = A extends A ? BuildTuple<A> extends [...infer U, ...BuildTuple<B>] ? Length<U> : never : never;
 
 /** Helper function to sum every value in an array together. */
@@ -18949,7 +18966,7 @@ export declare function sumSet(set: ReadonlySet<number>): number;
 /**
  * Helper function to swap two different array elements. (The elements will be swapped in-place.)
  */
-export declare function swapArrayElements<T>(array: T[], i: number, j: number): void;
+export declare function swapArrayElements(array: unknown[], i: number, j: number): void;
 
 declare type T = ModCallbackCustom.POST_CUSTOM_REVIVE;
 
@@ -19276,7 +19293,7 @@ export declare function validateCustomEnum(transpiledEnumName: string, transpile
  *
  * This is useful to automate checking large enums for typos.
  */
-export declare function validateEnumContiguous<T extends TranspiledEnum>(transpiledEnumName: string, transpiledEnum: T): void;
+export declare function validateEnumContiguous(transpiledEnumName: string, transpiledEnum: TranspiledEnum): void;
 
 /**
  * An array that represents the range from the first vanilla card type to the last vanilla card