isaacscript-common 1.2.3 → 1.2.7

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,10 +102,14 @@ 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 MOVEMENT_ACTIONS: Set<ButtonAction>;
+export declare const SECOND_IN_MILLISECONDS = 1000;
+export declare const MINUTE_IN_MILLISECONDS: number;
+export declare const MOVEMENT_ACTIONS: ButtonAction[];
+export declare const MOVEMENT_ACTIONS_SET: Set<ButtonAction>;
 export declare const ONE_BY_ONE_ROOM_GRID_SIZE = 135;
 export declare const SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES: Set<CollectibleType>;
-export declare const SHOOTING_ACTIONS: Set<ButtonAction>;
+export declare const SHOOTING_ACTIONS: ButtonAction[];
+export declare const SHOOTING_ACTIONS_SET: Set<ButtonAction>;
 export declare const STORY_BOSSES: Set<EntityType>;
 /**
  * This is the number of draw coordinates that each heart spans on the UI in the upper left hand

package/dist/constants.lua

@@ -88,7 +88,10 @@ ____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.MOVEMENT_ACTIONS = __TS__New(Set, {ButtonAction.ACTION_LEFT, ButtonAction.ACTION_RIGHT, ButtonAction.ACTION_UP, ButtonAction.ACTION_DOWN})
+____exports.SECOND_IN_MILLISECONDS = 1000
+____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
+____exports.MOVEMENT_ACTIONS = {ButtonAction.ACTION_LEFT, ButtonAction.ACTION_RIGHT, ButtonAction.ACTION_UP, ButtonAction.ACTION_DOWN}
+____exports.MOVEMENT_ACTIONS_SET = __TS__New(Set, ____exports.MOVEMENT_ACTIONS)
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
 ____exports.SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES = __TS__New(Set, {
     CollectibleType.COLLECTIBLE_FORGET_ME_NOW,
@@ -100,7 +103,8 @@ ____exports.SINGLE_USE_ACTIVE_COLLECTIBLE_TYPES = __TS__New(Set, {
     CollectibleType.COLLECTIBLE_DEATH_CERTIFICATE,
     CollectibleType.COLLECTIBLE_R_KEY
 })
-____exports.SHOOTING_ACTIONS = __TS__New(Set, {ButtonAction.ACTION_SHOOTLEFT, ButtonAction.ACTION_SHOOTRIGHT, ButtonAction.ACTION_SHOOTUP, ButtonAction.ACTION_SHOOTDOWN})
+____exports.SHOOTING_ACTIONS = {ButtonAction.ACTION_SHOOTLEFT, ButtonAction.ACTION_SHOOTRIGHT, ButtonAction.ACTION_SHOOTUP, ButtonAction.ACTION_SHOOTDOWN}
+____exports.SHOOTING_ACTIONS_SET = __TS__New(Set, ____exports.SHOOTING_ACTIONS)
 ____exports.STORY_BOSSES = __TS__New(Set, {
     EntityType.ENTITY_MOM,
     EntityType.ENTITY_MOMS_HEART,

package/dist/features/disableInputs.lua

@@ -4,8 +4,8 @@ local Set = ____lualib.Set
 local ____exports = {}
 local isActionPressed, isActionTriggered, getActionValue, getReturnValue, v
 local ____constants = require("constants")
-local MOVEMENT_ACTIONS = ____constants.MOVEMENT_ACTIONS
-local SHOOTING_ACTIONS = ____constants.SHOOTING_ACTIONS
+local MOVEMENT_ACTIONS_SET = ____constants.MOVEMENT_ACTIONS_SET
+local SHOOTING_ACTIONS_SET = ____constants.SHOOTING_ACTIONS_SET
 local ____errors = require("errors")
 local getUpgradeErrorMsg = ____errors.getUpgradeErrorMsg
 local ____exports = require("features.saveDataManager.exports")
@@ -85,9 +85,9 @@ function ____exports.disableAllInputsExceptFor(self, whitelist)
     v.run.blacklist = nil
 end
 function ____exports.disableMovementInputs(self)
-    ____exports.enableAllInputsExceptFor(nil, MOVEMENT_ACTIONS)
+    ____exports.enableAllInputsExceptFor(nil, MOVEMENT_ACTIONS_SET)
 end
 function ____exports.disableShootingInputs(self)
-    ____exports.enableAllInputsExceptFor(nil, SHOOTING_ACTIONS)
+    ____exports.enableAllInputsExceptFor(nil, SHOOTING_ACTIONS_SET)
 end
 return ____exports

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/input.lua

@@ -1,15 +1,16 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
 local __TS__StringReplace = ____lualib.__TS__StringReplace
 local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
-local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__ArraySome = ____lualib.__TS__ArraySome
 local __TS__StringSlice = ____lualib.__TS__StringSlice
 local ____exports = {}
 local ____constants = require("constants")
 local MAX_NUM_INPUTS = ____constants.MAX_NUM_INPUTS
 local MOVEMENT_ACTIONS = ____constants.MOVEMENT_ACTIONS
 local SHOOTING_ACTIONS = ____constants.SHOOTING_ACTIONS
+local ____math = require("functions.math")
+local range = ____math.range
 local ControllerLiteral = ControllerLiteral or ({})
 ControllerLiteral.DPAD_LEFT = 0
 ControllerLiteral[ControllerLiteral.DPAD_LEFT] = "DPAD_LEFT"
@@ -72,63 +73,45 @@ function ____exports.controllerToString(self, controller)
     return "unknown"
 end
 function ____exports.isActionPressedOnAnyInput(self, buttonAction)
-    do
-        local i = 0
-        while i < MAX_NUM_INPUTS do
-            if Input.IsActionPressed(buttonAction, i) then
-                return true
-            end
-            i = i + 1
-        end
-    end
-    return false
+    local validInputs = range(nil, 0, MAX_NUM_INPUTS - 1)
+    return __TS__ArraySome(
+        validInputs,
+        function(____, input) return Input.IsActionPressed(buttonAction, input) end
+    )
 end
 function ____exports.isActionTriggeredOnAnyInput(self, buttonAction)
-    do
-        local i = 0
-        while i < MAX_NUM_INPUTS do
-            if Input.IsActionTriggered(buttonAction, i) then
-                return true
-            end
-            i = i + 1
-        end
-    end
-    return false
+    local validInputs = range(nil, 0, MAX_NUM_INPUTS - 1)
+    return __TS__ArraySome(
+        validInputs,
+        function(____, input) return Input.IsActionTriggered(buttonAction, input) end
+    )
 end
 function ____exports.isKeyboardPressed(self, key)
     return Input.IsButtonPressed(key, 0)
 end
 function ____exports.isMoveActionPressedOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(MOVEMENT_ACTIONS:values()) do
-        if ____exports.isActionPressedOnAnyInput(nil, buttonAction) then
-            return true
-        end
-    end
-    return false
+    return __TS__ArraySome(
+        MOVEMENT_ACTIONS,
+        function(____, moveAction) return ____exports.isActionPressedOnAnyInput(nil, moveAction) end
+    )
 end
 function ____exports.isMoveActionTriggeredOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(MOVEMENT_ACTIONS:values()) do
-        if ____exports.isActionTriggeredOnAnyInput(nil, buttonAction) then
-            return true
-        end
-    end
-    return false
+    return __TS__ArraySome(
+        MOVEMENT_ACTIONS,
+        function(____, moveAction) return ____exports.isActionTriggeredOnAnyInput(nil, moveAction) end
+    )
 end
 function ____exports.isShootActionPressedOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(SHOOTING_ACTIONS:values()) do
-        if ____exports.isActionPressedOnAnyInput(nil, buttonAction) then
-            return true
-        end
-    end
-    return false
+    return __TS__ArraySome(
+        SHOOTING_ACTIONS,
+        function(____, shootAction) return ____exports.isActionPressedOnAnyInput(nil, shootAction) end
+    )
 end
 function ____exports.isShootActionTriggeredOnAnyInput(self)
-    for ____, buttonAction in __TS__Iterator(SHOOTING_ACTIONS:values()) do
-        if ____exports.isActionTriggeredOnAnyInput(nil, buttonAction) then
-            return true
-        end
-    end
-    return false
+    return __TS__ArraySome(
+        SHOOTING_ACTIONS,
+        function(____, shootAction) return ____exports.isActionTriggeredOnAnyInput(nil, shootAction) end
+    )
 end
 function ____exports.keyboardToString(self, keyboard)
     for ____, ____value in ipairs(__TS__ObjectEntries(Keyboard)) do

package/dist/functions/math.d.ts

@@ -17,6 +17,8 @@ export declare function isEven(num: int): boolean;
 export declare function isOdd(num: int): boolean;
 export declare function lerp(a: number, b: number, pos: float): number;
 export declare function lerpAngleDegrees(aStart: number, aEnd: number, percent: float): number;
+/** Helper function to return an array with the elements from start to end, inclusive. */
+export declare function range(start: int, end: int): int[];
 /**
  * If rounding fails, this function returns 0.
  * From: http://lua-users.org/wiki/SimpleRound

package/dist/functions/math.lua

@@ -87,6 +87,17 @@ end
 function ____exports.lerpAngleDegrees(self, aStart, aEnd, percent)
     return aStart + ____exports.getAngleDifference(nil, aStart, aEnd) * percent
 end
+function ____exports.range(self, start, ____end)
+    local array = {}
+    do
+        local i = start
+        while i <= ____end do
+            __TS__ArrayPush(array, i)
+            i = i + 1
+        end
+    end
+    return array
+end
 function ____exports.round(self, num, numDecimalPlaces)
     if numDecimalPlaces == nil then
         numDecimalPlaces = 0

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.3",
+  "version": "1.2.7",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",
@@ -26,7 +26,7 @@
   ],
   "devDependencies": {
     "@zamiell/typescript-to-lua": "^1.4.0",
-    "isaac-typescript-definitions": "^1.0.334",
+    "isaac-typescript-definitions": "^1.0.335",
     "isaacscript-lint": "^1.0.79",
     "isaacscript-tsconfig": "^1.1.8",
     "typedoc": "^0.22.11",