isaacscript-common 1.2.2 → 1.2.6

package/dist/callbacks/postPlayerFatalDamage.lua

@@ -18,7 +18,7 @@ local postPlayerFatalDamageHasSubscriptions = ____postPlayerFatalDamage.postPlay
 function hasSubscriptions(self)
     return postPlayerFatalDamageHasSubscriptions(nil)
 end
-function entityTakeDmgPlayer(self, tookDamage, damageAmount, _damageFlags, damageSource, _damageCountdownFrames)
+function entityTakeDmgPlayer(self, tookDamage, damageAmount, damageFlags, damageSource, damageCountdownFrames)
     if not hasSubscriptions(nil) then
         return nil
     end
@@ -46,7 +46,14 @@ function entityTakeDmgPlayer(self, tookDamage, damageAmount, _damageFlags, damag
     ) then
         return nil
     end
-    local shouldSustainDeath = postPlayerFatalDamageFire(nil, player)
+    local shouldSustainDeath = postPlayerFatalDamageFire(
+        nil,
+        player,
+        damageAmount,
+        damageFlags,
+        damageSource,
+        damageCountdownFrames
+    )
     if shouldSustainDeath ~= nil then
         return shouldSustainDeath
     end

package/dist/callbacks/reorderedCallbacks.d.ts

@@ -1,4 +1,7 @@
 /**
+ * This is a utility function for users of the `ModCallbacksCustom.POST_NEW_LEVEL_REORDERED` custom
+ * callback.
+ *
  * If some specific cases, mods can change the current level during run initialization on the 0th
  * frame. However, due to how the callback reordering works, the custom PostNewLevel callback will
  * never fire on the 0th frame. To get around this, call this function before changing levels to
@@ -6,6 +9,9 @@
  */
 export declare function forceNewLevelCallback(): void;
 /**
+ * This is a utility function for users of the `ModCallbacksCustom.POST_NEW_ROOM_REORDERED` custom
+ * callback.
+ *
  * If some specific cases, mods can change the current room during run initialization on the 0th
  * frame. However, due to how the callback reordering works, the custom PostNewRoom callback will
  * never fire on the 0th frame. To get around this, call this function before changing rooms to

package/dist/callbacks/subscriptions/postPlayerFatalDamage.d.ts

@@ -1,2 +1,2 @@
 /// <reference types="isaac-typescript-definitions" />
-export declare type PostPlayerFatalDamageCallbackType = (player: EntityPlayer) => boolean | void;
+export declare type PostPlayerFatalDamageCallbackType = (player: EntityPlayer, damageAmount: float, damageFlags: int, damageSource: EntityRef, damageCountdownFrames: int) => boolean | void;

package/dist/callbacks/subscriptions/postPlayerFatalDamage.lua

@@ -9,7 +9,7 @@ end
 function ____exports.postPlayerFatalDamageRegister(self, callback, playerVariant)
     __TS__ArrayPush(subscriptions, {callback, playerVariant})
 end
-function ____exports.postPlayerFatalDamageFire(self, player)
+function ____exports.postPlayerFatalDamageFire(self, player, damageAmount, damageFlags, damageSource, damageCountdownFrames)
     for ____, ____value in ipairs(subscriptions) do
         local callback = ____value[1]
         local playerVariant = ____value[2]
@@ -17,7 +17,14 @@ function ____exports.postPlayerFatalDamageFire(self, player)
             if playerVariant ~= nil and playerVariant ~= player.Variant then
                 goto __continue5
             end
-            local shouldSustainDeath = callback(nil, player)
+            local shouldSustainDeath = callback(
+                nil,
+                player,
+                damageAmount,
+                damageFlags,
+                damageSource,
+                damageCountdownFrames
+            )
             if shouldSustainDeath ~= nil then
                 return shouldSustainDeath
             end

package/dist/constants.d.ts

@@ -102,6 +102,8 @@ export declare const MAX_PLAYER_TRINKET_SLOTS = 2;
 export declare const MAX_ROOM_INDEX = 168;
 export declare const MAX_VANILLA_CHARACTER = PlayerType.PLAYER_THESOUL_B;
 export declare const MAX_VANILLA_COLLECTIBLE_TYPE = CollectibleType.COLLECTIBLE_MOMS_RING;
+export declare const SECOND_IN_MILLISECONDS = 1000;
+export declare const MINUTE_IN_MILLISECONDS: number;
 export declare const MOVEMENT_ACTIONS: Set<ButtonAction>;
 export declare const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
 export declare const SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES: Set<CollectibleType>;

package/dist/constants.lua

@@ -88,6 +88,8 @@ ____exports.MAX_PLAYER_TRINKET_SLOTS = 2
 ____exports.MAX_ROOM_INDEX = 168
 ____exports.MAX_VANILLA_CHARACTER = PlayerType.PLAYER_THESOUL_B
 ____exports.MAX_VANILLA_COLLECTIBLE_TYPE = CollectibleType.COLLECTIBLE_MOMS_RING
+____exports.SECOND_IN_MILLISECONDS = 1000
+____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
 ____exports.MOVEMENT_ACTIONS = __TS__New(Set, {ButtonAction.ACTION_LEFT, ButtonAction.ACTION_RIGHT, ButtonAction.ACTION_UP, ButtonAction.ACTION_DOWN})
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
 ____exports.SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES = __TS__New(Set, {

package/dist/functions/array.d.ts

@@ -61,6 +61,15 @@ export declare function arrayRemoveInPlace<T>(array: T[], ...elements: T[]): boo
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
 export declare function getRandomArrayElement<T>(array: T[], seed?: number, exceptions?: T[]): T;
+/**
+ * Helper function to get a random element from the provided array. Once the random element is
+ * decided, it is then removed from the array (in-place).
+ *
+ * @param array The array to get an element from.
+ * @param seed Optional. The seed used to select the random element. `Random()` by default.
+ * @param exceptions Optional. An array of elements to skip over if selected.
+ */
+export declare function getRandomArrayElementAndRemove<T>(array: T[], seed?: number, exceptions?: T[]): T;
 export declare function getRandomArrayIndex<T>(array: T[], seed?: number): int;
 /**
  * Since Lua uses tables for every non-primitive data structure, it is non-trivial to determine if a

package/dist/functions/array.lua

@@ -145,6 +145,17 @@ function ____exports.getRandomArrayElement(self, array, seed, exceptions)
     local randomIndex = ____exports.getRandomArrayIndex(nil, arrayWithoutExceptions, seed)
     return arrayWithoutExceptions[randomIndex + 1]
 end
+function ____exports.getRandomArrayElementAndRemove(self, array, seed, exceptions)
+    if seed == nil then
+        seed = Random()
+    end
+    if exceptions == nil then
+        exceptions = {}
+    end
+    local randomArrayElement = ____exports.getRandomArrayElement(nil, array, seed, exceptions)
+    ____exports.arrayRemoveInPlace(nil, array, randomArrayElement)
+    return randomArrayElement
+end
 function ____exports.isArray(self, ____table)
     local metatable = getmetatable(____table)
     if metatable ~= nil then

package/dist/functions/collectibles.d.ts

@@ -89,6 +89,11 @@ export declare function removeCollectiblePickupDelay(collectible: EntityPickup):
  * Python program located at: https://github.com/Rchardon/RebirthItemTracker
  */
 export declare function removeCollectibleFromItemTracker(collectibleType: CollectibleType | int): void;
+/**
+ * Helper function to put a message in the log.txt file to let the Rebirth Item Tracker know that
+ * the build has been rerolled.
+ */
+export declare function setCollectiblesRerolledForItemTracker(): void;
 export declare function setCollectibleBlind(collectible: EntityPickup): void;
 /**
  * Helper function to remove the collectible from a collectible pedestal and make it appear as if a

package/dist/functions/collectibles.lua

@@ -164,6 +164,9 @@ function ____exports.removeCollectibleFromItemTracker(self, collectibleType)
     local collectibleName = ____exports.getCollectibleName(nil, collectibleType)
     Isaac.DebugString(((("Removing collectible " .. tostring(collectibleType)) .. " (") .. collectibleName) .. ") on player 0 (Player)")
 end
+function ____exports.setCollectiblesRerolledForItemTracker(self)
+    Isaac.DebugString("Added 3 Collectibles")
+end
 function ____exports.setCollectibleBlind(self, collectible)
     if collectible.Variant ~= PickupVariant.PICKUP_COLLECTIBLE then
         error("You cannot set a collectible to be blind for pickups of variant: " .. tostring(collectible.Variant))

package/dist/functions/player.lua

@@ -541,7 +541,8 @@ function ____exports.useActiveItemTemp(self, player, collectibleType)
         false,
         false,
         true,
-        false
+        false,
+        -1
     )
 end
 return ____exports

package/dist/maps/roomShapeToTopLeftWallGridIndexMap.d.ts

@@ -1,3 +1,7 @@
 /// <reference types="isaac-typescript-definitions" />
+/**
+ * Only used for special room shapes where the top left wall grid index is not equal to
+ * `DEFAULT_TOP_LEFT_WALL_GRID_INDEX`.
+ */
 export declare const ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP: Map<RoomShape, number>;
 export declare const DEFAULT_TOP_LEFT_WALL_GRID_INDEX = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.2",
+  "version": "1.2.6",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",