isaacscript-common 9.18.4 → 9.19.2

package/dist/functions/pocketItems.lua

@@ -1,106 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local __TS__ArrayFind = ____lualib.__TS__ArrayFind
-local __TS__ArraySome = ____lualib.__TS__ArraySome
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local ActiveSlot = ____isaac_2Dtypescript_2Ddefinitions.ActiveSlot
-local CardType = ____isaac_2Dtypescript_2Ddefinitions.CardType
-local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
-local PillColor = ____isaac_2Dtypescript_2Ddefinitions.PillColor
-local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
-local PocketItemSlot = ____isaac_2Dtypescript_2Ddefinitions.PocketItemSlot
-local ____PocketItemType = require("enums.PocketItemType")
-local PocketItemType = ____PocketItemType.PocketItemType
-local ____enums = require("functions.enums")
-local getEnumValues = ____enums.getEnumValues
-local ____players = require("functions.players")
-local isCharacter = ____players.isCharacter
-local ____types = require("functions.types")
-local asNumber = ____types.asNumber
---- Use this helper function as a workaround for the `EntityPlayer.GetPocketItem` method not working
--- correctly.
--- 
--- Note that due to API limitations, there is no way to determine the location of a Dice Bag trinket
--- dice. Furthermore, when the player has a Dice Bag trinket dice and a pocket active at the same
--- time, there is no way to determine the location of the pocket active item. If this function
--- cannot determine the identity of a particular slot, it will mark the type of the slot as
--- `PocketItemType.UNDETERMINABLE`.
-function ____exports.getPocketItems(self, player)
-    local pocketItem = player:GetActiveItem(ActiveSlot.POCKET)
-    local hasPocketItem = pocketItem ~= CollectibleType.NULL
-    local pocketItem2 = player:GetActiveItem(ActiveSlot.POCKET_SINGLE_USE)
-    local hasPocketItem2 = pocketItem2 ~= CollectibleType.NULL
-    local maxPocketItems = player:GetMaxPocketItems()
-    local pocketItemSlots = getEnumValues(nil, PocketItemSlot)
-    local pocketItems = {}
-    local pocketItemIdentified = false
-    local pocketItem2Identified = false
-    for ____, slot in ipairs(pocketItemSlots) do
-        local cardType = player:GetCard(slot)
-        local pillColor = player:GetPill(slot)
-        if cardType ~= CardType.NULL then
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.CARD, subType = cardType}
-        elseif pillColor ~= PillColor.NULL then
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.PILL, subType = pillColor}
-        elseif hasPocketItem and not hasPocketItem2 and not pocketItemIdentified then
-            pocketItemIdentified = true
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.ACTIVE_ITEM, subType = pocketItem}
-        elseif not hasPocketItem and hasPocketItem2 and not pocketItem2Identified then
-            pocketItem2Identified = true
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.DICE_BAG_DICE, subType = pocketItem2}
-        elseif hasPocketItem and hasPocketItem2 then
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.UNDETERMINABLE, subType = 0}
-        else
-            pocketItems[#pocketItems + 1] = {slot = slot, type = PocketItemType.EMPTY, subType = 0}
-        end
-        if asNumber(nil, slot) + 1 == maxPocketItems then
-            break
-        end
-    end
-    return pocketItems
-end
---- Helper function to get the `PocketItemSlot` that the player's pocket active collectible item is
--- in, if any. Returns undefined if the player does not have a pocket active item.
-function ____exports.getActivePocketItemSlot(self, player)
-    local pocketItems = ____exports.getPocketItems(nil, player)
-    for ____, pocketItem in ipairs(pocketItems) do
-        if pocketItem.type == PocketItemType.ACTIVE_ITEM then
-            return pocketItem.slot
-        end
-    end
-    return nil
-end
-function ____exports.getFirstCardOrPill(self, player)
-    local pocketItems = ____exports.getPocketItems(nil, player)
-    return __TS__ArrayFind(
-        pocketItems,
-        function(____, pocketItem) return pocketItem.type == PocketItemType.CARD or pocketItem.type == PocketItemType.PILL end
-    )
-end
---- Returns whether or not the player can hold an additional pocket item, beyond what they are
--- currently carrying. This takes into account items that modify the max number of pocket items,
--- like Starter Deck.
--- 
--- If the player is the Tainted Soul, this always returns false, since that character cannot pick up
--- items. (Only Tainted Forgotten can pick up items.)
-function ____exports.hasOpenPocketItemSlot(self, player)
-    if isCharacter(nil, player, PlayerType.THE_SOUL_B) then
-        return false
-    end
-    local pocketItems = ____exports.getPocketItems(nil, player)
-    return __TS__ArraySome(
-        pocketItems,
-        function(____, pocketItem) return pocketItem.type == PocketItemType.EMPTY end
-    )
-end
---- Helper function to determine whether or not the player's "active" pocket item slot is set to
--- their pocket active item.
-function ____exports.isFirstSlotPocketActiveItem(self, player)
-    local pocketItems = ____exports.getPocketItems(nil, player)
-    local firstPocketItem = pocketItems[1]
-    if firstPocketItem == nil then
-        return false
-    end
-    return firstPocketItem.type == PocketItemType.ACTIVE_ITEM
-end
-return ____exports

package/dist/functions/positionVelocity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"positionVelocity.d.ts","sourceRoot":"","sources":["../../src/functions/positionVelocity.ts"],"names":[],"mappings":";;;;AAaA,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,GACZ,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,GACd,OAAO,CAKT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,UAAQ,GAC1B,MAAM,CAiCR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAY5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAY7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,IAAI,CAYN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,IAAI,CAYN"}

package/dist/functions/positionVelocity.lua

@@ -1,157 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local __TS__ArraySome = ____lualib.__TS__ArraySome
-local Map = ____lualib.Map
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local EffectVariant = ____isaac_2Dtypescript_2Ddefinitions.EffectVariant
-local HeavenLightDoorSubType = ____isaac_2Dtypescript_2Ddefinitions.HeavenLightDoorSubType
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____constants = require("core.constants")
-local DISTANCE_OF_GRID_TILE = ____constants.DISTANCE_OF_GRID_TILE
-local ____entities = require("functions.entities")
-local getEntities = ____entities.getEntities
-local ____entitiesSpecific = require("functions.entitiesSpecific")
-local getEffects = ____entitiesSpecific.getEffects
-local ____playerIndex = require("functions.playerIndex")
-local getPlayers = ____playerIndex.getPlayers
-local ____players = require("functions.players")
-local getPlayerCloserThan = ____players.getPlayerCloserThan
-local MAX_FIND_FREE_POSITION_ATTEMPTS = 100
-function ____exports.anyEntityCloserThan(self, entities, position, distance)
-    return __TS__ArraySome(
-        entities,
-        function(____, entity) return position:Distance(entity.Position) <= distance end
-    )
-end
---- Iterates over all players and checks if any player is close enough to the specified position.
--- 
--- Note that this function does not consider players with a non-undefined parent, since they are not
--- real players (e.g. the Strawman Keeper).
-function ____exports.anyPlayerCloserThan(self, position, distance)
-    local players = getPlayers(nil)
-    return __TS__ArraySome(
-        players,
-        function(____, player) return player.Position:Distance(position) <= distance end
-    )
-end
---- Helper function to get a room position that is not overlapping with a grid entity, a heaven door,
--- or a player. The `Room.FindFreePickupSpawnPosition` method will return locations that overlap
--- with heaven doors and partially overlap with players, if the thing being spawned is bigger than a
--- tile (like a Blood Donation Machine). Use this function instead if you want to account for those
--- specific situations.
--- 
--- @param startingPosition The position to start searching from. If this position is not overlapping
--- with anything, then it will be returned.
--- @param avoidActiveEntities Optional. Default is false.
-function ____exports.findFreePosition(self, startingPosition, avoidActiveEntities)
-    if avoidActiveEntities == nil then
-        avoidActiveEntities = false
-    end
-    local room = game:GetRoom()
-    local heavenDoors = getEffects(nil, EffectVariant.HEAVEN_LIGHT_DOOR, HeavenLightDoorSubType.HEAVEN_DOOR)
-    do
-        local i = 0
-        while i < MAX_FIND_FREE_POSITION_ATTEMPTS do
-            do
-                local position = room:FindFreePickupSpawnPosition(startingPosition, i, avoidActiveEntities)
-                local closePlayer = getPlayerCloserThan(nil, position, DISTANCE_OF_GRID_TILE)
-                if closePlayer ~= nil then
-                    goto __continue7
-                end
-                local isCloseHeavenDoor = ____exports.anyEntityCloserThan(nil, heavenDoors, position, DISTANCE_OF_GRID_TILE)
-                if isCloseHeavenDoor then
-                    goto __continue7
-                end
-                return position
-            end
-            ::__continue7::
-            i = i + 1
-        end
-    end
-    return room:FindFreePickupSpawnPosition(startingPosition)
-end
---- Helper function to get a map containing the positions of every entity in the current room.
--- 
--- This is useful for rewinding entity positions at a later time. Also see `setEntityPositions`.
--- 
--- @param entities Optional. If provided, will only get the positions of the provided entities. Use
--- this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
--- multiple times.
-function ____exports.getEntityPositions(self, entities)
-    if entities == nil then
-        entities = getEntities(nil)
-    end
-    local entityPositions = __TS__New(Map)
-    for ____, entity in ipairs(entities) do
-        local ptrHash = GetPtrHash(entity)
-        entityPositions:set(ptrHash, entity.Position)
-    end
-    return entityPositions
-end
---- Helper function to get a map containing the velocities of every entity in the current room.
--- 
--- This is useful for rewinding entity velocities at a later time. Also see `setEntityVelocities`.
--- 
--- @param entities Optional. If provided, will only get the velocities of the provided entities. Use
--- this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
--- multiple times.
-function ____exports.getEntityVelocities(self, entities)
-    if entities == nil then
-        entities = getEntities(nil)
-    end
-    local entityVelocities = __TS__New(Map)
-    for ____, entity in ipairs(entities) do
-        local ptrHash = GetPtrHash(entity)
-        entityVelocities:set(ptrHash, entity.Velocity)
-    end
-    return entityVelocities
-end
---- Helper function to set the position of every entity in the room based on a map of positions. If
--- an entity is found that does not have matching element in the provided map, then that entity will
--- be skipped.
--- 
--- This function is useful for rewinding entity positions at a later time. Also see
--- `getEntityPositions`.
--- 
--- @param entityPositions The map providing the positions for every entity.
--- @param entities Optional. If provided, will only set the positions of the provided entities. Use
--- this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
--- multiple times.
-function ____exports.setEntityPositions(self, entityPositions, entities)
-    if entities == nil then
-        entities = getEntities(nil)
-    end
-    for ____, entity in ipairs(entities) do
-        local ptrHash = GetPtrHash(entity)
-        local entityPosition = entityPositions:get(ptrHash)
-        if entityPosition ~= nil then
-            entity.Position = entityPosition
-        end
-    end
-end
---- Helper function to set the velocity of every entity in the room based on a map of velocities. If
--- an entity is found that does not have matching element in the provided map, then that entity will
--- be skipped.
--- 
--- This function is useful for rewinding entity velocities at a later time. Also see
--- `getEntityVelocities`.
--- 
--- @param entityVelocities The map providing the velocities for every entity.
--- @param entities Optional. If provided, will only set the velocities of the provided entities. Use
--- this with cached entities to avoid invoking the `Isaac.GetRoomEntities` method
--- multiple times.
-function ____exports.setEntityVelocities(self, entityVelocities, entities)
-    if entities == nil then
-        entities = getEntities(nil)
-    end
-    for ____, entity in ipairs(entities) do
-        local ptrHash = GetPtrHash(entity)
-        local entityVelocity = entityVelocities:get(ptrHash)
-        if entityVelocity ~= nil then
-            entity.Velocity = entityVelocity
-        end
-    end
-end
-return ____exports

package/dist/functions/pressurePlate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pressurePlate.d.ts","sourceRoot":"","sources":["../../src/functions/pressurePlate.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAanD"}

package/dist/functions/pressurePlate.lua

@@ -1,29 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local PressurePlateState = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateState
-local PressurePlateVariant = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateVariant
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____gridEntitiesSpecific = require("functions.gridEntitiesSpecific")
-local getPressurePlates = ____gridEntitiesSpecific.getPressurePlates
---- Helper function to check if all of the pressure plates in the room are pushed.
--- 
--- In this context, "pressure plates" refers to the grid entities that you have to press down in
--- order for the room to be cleared. This function ignores other types of pressure plates, such as
--- the ones that you press to get a reward, the ones that you press to start a Greed Mode wave, and
--- so on.
-function ____exports.isAllPressurePlatesPushed(self)
-    local room = game:GetRoom()
-    local hasPressurePlates = room:HasTriggerPressurePlates()
-    if not hasPressurePlates then
-        return true
-    end
-    local pressurePlates = getPressurePlates(nil, PressurePlateVariant.PRESSURE_PLATE)
-    return __TS__ArrayEvery(
-        pressurePlates,
-        function(____, pressurePlate) return pressurePlate.State == PressurePlateState.PRESSURE_PLATE_PRESSED end
-    )
-end
-return ____exports

package/dist/functions/projectiles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"projectiles.d.ts","sourceRoot":"","sources":["../../src/functions/projectiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAItC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,GAAE,eAAgD,EACjE,gBAAgB,GAAE,gBAAqC,GACtD,gBAAgB,EAAE,CAoBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,GAAG,GAClB,gBAAgB,EAAE,CAQpB"}

package/dist/functions/projectiles.lua

@@ -1,73 +0,0 @@
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local EntityFlag = ____isaac_2Dtypescript_2Ddefinitions.EntityFlag
-local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
-local ProjectilesMode = ____isaac_2Dtypescript_2Ddefinitions.ProjectilesMode
-local ____entities = require("functions.entities")
-local getFilteredNewEntities = ____entities.getFilteredNewEntities
-local ____entitiesSpecific = require("functions.entitiesSpecific")
-local getProjectiles = ____entitiesSpecific.getProjectiles
-local spawnNPC = ____entitiesSpecific.spawnNPC
---- Helper function to make an NPC fire one or more projectiles. Returns the fired projectile(s).
--- 
--- Use this function instead of the `EntityNPC.FireProjectiles` method if you need to modify or
--- access the `EntityProjectile` objects after they are fired, since this function returns the
--- objects in an array.
--- 
--- @param npc The NPC to fire the projectile(s) from. You can also pass undefined if you do not want
--- the projectile(s) to come from anything in particular.
--- @param position The staring position of the projectile(s).
--- @param velocity The starting velocity of the projectile(s).
--- @param projectilesMode Optional. The mode of the projectile(s). Default is
--- `ProjectilesMode.ONE_PROJECTILE`.
--- @param projectileParams Optional. The parameters of the projectile(s). Default is
--- `ProjectileParams()`.
--- @returns The fired projectile(s).
-function ____exports.fireProjectiles(self, npc, position, velocity, projectilesMode, projectileParams)
-    if projectilesMode == nil then
-        projectilesMode = ProjectilesMode.ONE_PROJECTILE
-    end
-    if projectileParams == nil then
-        projectileParams = ProjectileParams()
-    end
-    local oldProjectiles = getProjectiles(nil, projectileParams.Variant)
-    local spawnedFly = false
-    if npc == nil then
-        spawnedFly = true
-        npc = spawnNPC(
-            nil,
-            EntityType.FLY,
-            0,
-            0,
-            position
-        )
-        npc.Visible = false
-        npc:ClearEntityFlags(EntityFlag.APPEAR)
-    end
-    npc:FireProjectiles(position, velocity, projectilesMode, projectileParams)
-    local newProjectiles = getProjectiles(nil, projectileParams.Variant)
-    if spawnedFly then
-        npc:Remove()
-    end
-    return getFilteredNewEntities(nil, oldProjectiles, newProjectiles)
-end
---- Helper function to spawn projectiles in a circle around a position. Under the hood, this
--- leverages `ProjectileMode.N_PROJECTILES_IN_CIRCLE`.
--- 
--- @param npc The NPC to fire the projectile(s) from. You can also pass undefined if you do not want
--- the projectile(s) to come from anything in particular.
--- @param position The staring position of the projectile(s).
--- @param speed The speed of the projectile(s).
--- @param numProjectiles The amount of projectiles to spawn.
--- @returns The fired projectile(s).
-function ____exports.fireProjectilesInCircle(self, npc, position, speed, numProjectiles)
-    local velocity = Vector(speed, numProjectiles)
-    return ____exports.fireProjectiles(
-        nil,
-        npc,
-        position,
-        velocity,
-        ProjectilesMode.N_PROJECTILES_IN_CIRCLE
-    )
-end
-return ____exports

package/dist/functions/random.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/functions/random.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,IAAI,GAAG,GAAqB,GAAG,KAAK,CAGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,GACtC,KAAK,CAUP;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,UAAU,GAAE,GAAG,EAAE,GAAG,SAAS,GAAG,EAAO,GACtC,GAAG,CAqBL"}

package/dist/functions/random.lua

@@ -1,89 +0,0 @@
-local ____lualib = require("lualib_bundle")
-local Set = ____lualib.Set
-local __TS__New = ____lualib.__TS__New
-local ____exports = {}
-local ____rng = require("functions.rng")
-local getRandomSeed = ____rng.getRandomSeed
-local isRNG = ____rng.isRNG
-local newRNG = ____rng.newRNG
---- This returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on the
--- high end. (This is because the `RNG.RandomFloat` method will never return a value of exactly 1.)
--- 
--- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
--- `RNG.Next` method will be called. Default is `getRandomSeed()`.
-function ____exports.getRandom(self, seedOrRNG)
-    if seedOrRNG == nil then
-        seedOrRNG = getRandomSeed(nil)
-    end
-    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
-    return rng:RandomFloat()
-end
---- This returns a random float between min and max.
--- 
--- For example:
--- 
--- ```ts
--- const realNumberBetweenOneAndThree = getRandomFloat(1, 3);
--- ```
--- 
--- @param min The lower bound for the random number (inclusive).
--- @param max The upper bound for the random number (exclusive).
--- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
--- `RNG.Next` method will be called. Default is `getRandomSeed()`.
-function ____exports.getRandomFloat(self, min, max, seedOrRNG)
-    if seedOrRNG == nil then
-        seedOrRNG = getRandomSeed(nil)
-    end
-    if min > max then
-        local oldMin = min
-        local oldMax = max
-        min = oldMax
-        max = oldMin
-    end
-    return min + ____exports.getRandom(nil, seedOrRNG) * (max - min)
-end
---- This returns a random integer between min and max. It is inclusive on both ends.
--- 
--- Note that this function will run the `Next` method on the `RNG` object before returning the
--- random number.
--- 
--- For example:
--- 
--- ```ts
--- const oneTwoOrThree = getRandomInt(1, 3);
--- ```
--- 
--- @param min The lower bound for the random number (inclusive).
--- @param max The upper bound for the random number (inclusive).
--- @param seedOrRNG Optional. The `Seed` or `RNG` object to use. If an `RNG` object is provided, the
--- `RNG.Next` method will be called. Default is `getRandomSeed()`.
--- @param exceptions Optional. An array of elements that will be skipped over when getting the
--- random integer. For example, a min of 1, a max of 4, and an exceptions array of
--- `[2]` would cause the function to return either 1, 3, or 4. Default is an empty
--- array.
-function ____exports.getRandomInt(self, min, max, seedOrRNG, exceptions)
-    if seedOrRNG == nil then
-        seedOrRNG = getRandomSeed(nil)
-    end
-    if exceptions == nil then
-        exceptions = {}
-    end
-    local rng = isRNG(nil, seedOrRNG) and seedOrRNG or newRNG(nil, seedOrRNG)
-    min = math.ceil(min)
-    max = math.floor(max)
-    if min > max then
-        local oldMin = min
-        local oldMax = max
-        min = oldMax
-        max = oldMin
-    end
-    local exceptionsSet = __TS__New(Set, exceptions)
-    local randomInt
-    repeat
-        do
-            randomInt = rng:RandomInt(max - min + 1) + min
-        end
-    until not exceptionsSet:has(randomInt)
-    return randomInt
-end
-return ____exports

package/dist/functions/reorderedCallbacks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reorderedCallbacks.d.ts","sourceRoot":"","sources":["../../src/functions/reorderedCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOrE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,GACnB,IAAI,CAEN"}

package/dist/functions/reorderedCallbacks.lua

@@ -1,34 +0,0 @@
-local ____exports = {}
-local ____reorderedCallbacks = require("callbacks.reorderedCallbacks")
-local forceNewLevelCallbackInternal = ____reorderedCallbacks.forceNewLevelCallbackInternal
-local forceNewRoomCallbackInternal = ____reorderedCallbacks.forceNewRoomCallbackInternal
-local reorderedCallbacksSetStageInternal = ____reorderedCallbacks.reorderedCallbacksSetStageInternal
---- This is a utility function for users of the `ModCallbackCustom.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 `POST_NEW_LEVEL` callback
--- will never fire on the 0th frame. To get around this, call this function before changing levels
--- to temporarily force the callback to fire.
-function ____exports.forceNewLevelCallback(self)
-    forceNewLevelCallbackInternal(nil)
-end
---- This is a utility function for users of the `ModCallbackCustom.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 `POST_NEW_ROOM` callback
--- will never fire on the 0th frame. To get around this, call this function before changing rooms to
--- temporarily force the callback to fire.
-function ____exports.forceNewRoomCallback(self)
-    forceNewRoomCallbackInternal(nil)
-end
---- Helper function to manually set the variable that the reordered callback logic uses to track the
--- current stage and stage type.
--- 
--- This is useful because if the stage is changed with the `Game.SetStage` method, the reordered
--- callbacks will stop working.
-function ____exports.reorderedCallbacksSetStage(self, stage, stageType)
-    reorderedCallbacksSetStageInternal(nil, stage, stageType)
-end
-return ____exports

package/dist/functions/revive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"revive.d.ts","sourceRoot":"","sources":["../../src/functions/revive.ts"],"names":[],"mappings":";;;AAkBA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,GAAG,GAAG,SAAS,GACnC,OAAO,CAuFT;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAavE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAa9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAYtE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAe1E"}

package/dist/functions/revive.lua

@@ -1,118 +0,0 @@
-local ____exports = {}
-local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
-local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
-local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
-local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
-local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
-local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
-local ____cachedClasses = require("core.cachedClasses")
-local game = ____cachedClasses.game
-local ____constants = require("core.constants")
-local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSERK_CHARGE
-local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
-local ____characters = require("functions.characters")
-local getCharacterDeathAnimationName = ____characters.getCharacterDeathAnimationName
-local ____playerHealth = require("functions.playerHealth")
-local getPlayerMaxHeartContainers = ____playerHealth.getPlayerMaxHeartContainers
-local ____players = require("functions.players")
-local getPlayerNumHitsRemaining = ____players.getPlayerNumHitsRemaining
-local hasLostCurse = ____players.hasLostCurse
-local isKeeper = ____players.isKeeper
-local ____sprites = require("functions.sprites")
-local getLastFrameOfAnimation = ____sprites.getLastFrameOfAnimation
-local ____trinketGive = require("functions.trinketGive")
-local giveTrinketsBack = ____trinketGive.giveTrinketsBack
-local temporarilyRemoveTrinket = ____trinketGive.temporarilyRemoveTrinket
---- Helper function to determine if the player will be revived by the Heartbreak collectible if they
--- take fatal damage. This is contingent on the character that they are playing as and the amount of
--- broken hearts that they already have.
-function ____exports.willReviveFromHeartbreak(self, player)
-    if not player:HasCollectible(CollectibleType.HEARTBREAK) then
-        return false
-    end
-    local maxHeartContainers = getPlayerMaxHeartContainers(nil, player)
-    local numBrokenHeartsThatWillBeAdded = isKeeper(nil, player) and 1 or 2
-    local brokenHearts = player:GetBrokenHearts()
-    local numBrokenHeartsAfterRevival = numBrokenHeartsThatWillBeAdded + brokenHearts
-    return maxHeartContainers > numBrokenHeartsAfterRevival
-end
---- Helper function to determine if the Spirit Shackles item is in an enabled state. (It can be
--- either enabled or disabled.)
-function ____exports.willReviveFromSpiritShackles(self, player)
-    if not player:HasCollectible(CollectibleType.SPIRIT_SHACKLES) then
-        return false
-    end
-    local effects = player:GetEffects()
-    local spiritShacklesEnabled = not effects:HasNullEffect(NullItemID.SPIRIT_SHACKLES_DISABLED)
-    local playerInSoulForm = effects:HasNullEffect(NullItemID.SPIRIT_SHACKLES_SOUL)
-    return spiritShacklesEnabled and not playerInSoulForm
-end
---- Uses the player's current health and other miscellaneous things to determine if incoming damage
--- will be fatal.
-function ____exports.isDamageToPlayerFatal(self, player, amount, source, lastDamageGameFrame)
-    local gameFrameCount = game:GetFrameCount()
-    local character = player:GetPlayerType()
-    local effects = player:GetEffects()
-    local isBerserk = effects:HasCollectibleEffect(CollectibleType.BERSERK)
-    if character == PlayerType.JACOB_B and source.Type == EntityType.DARK_ESAU then
-        return false
-    end
-    if isBerserk then
-        return false
-    end
-    local berserkChargeAfterHit = player.SamsonBerserkCharge + TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
-    if character == PlayerType.SAMSON_B and berserkChargeAfterHit >= MAX_TAINTED_SAMSON_BERSERK_CHARGE then
-        return false
-    end
-    if ____exports.willReviveFromSpiritShackles(nil, player) then
-        return false
-    end
-    if character == PlayerType.JACOB_2_B then
-        return true
-    end
-    if hasLostCurse(nil, player) then
-        return true
-    end
-    local playerNumAllHearts = getPlayerNumHitsRemaining(nil, player)
-    if amount < playerNumAllHearts then
-        return false
-    end
-    if ____exports.willReviveFromHeartbreak(nil, player) then
-        return false
-    end
-    if player:HasCollectible(CollectibleType.BROKEN_GLASS_CANNON) and gameFrameCount == lastDamageGameFrame then
-        return false
-    end
-    local hearts = player:GetHearts()
-    local eternalHearts = player:GetEternalHearts()
-    local soulHearts = player:GetSoulHearts()
-    local boneHearts = player:GetBoneHearts()
-    if hearts > 0 and soulHearts > 0 or hearts > 0 and boneHearts > 0 or soulHearts > 0 and boneHearts > 0 or soulHearts > 0 and eternalHearts > 0 or boneHearts >= 2 then
-        return false
-    end
-    return true
-end
---- Assuming that we are on the frame of fatal damage, this function returns whether or not
--- Mysterious Paper would rotate to Missing Poster on the frame that the "Game Over" screen would
--- appear (which would subsequently save the player from fatal damage).
--- 
--- Mysterious Paper rotates between the 4 items on every frame, in order. The formula for whether
--- Mysterious Paper be Missing Power is: `gameFrameCount % 4 === 3`
-function ____exports.willMysteriousPaperRevive(self, player)
-    local gameFrameCount = game:GetFrameCount()
-    local sprite = player:GetSprite()
-    local character = player:GetPlayerType()
-    local animation = getCharacterDeathAnimationName(nil, character)
-    local deathAnimationFrames = getLastFrameOfAnimation(nil, sprite, animation)
-    local frameOfDeath = gameFrameCount + deathAnimationFrames + 1
-    return frameOfDeath % 4 == 3
-end
---- The `EntityPlayer.WillPlayerRevive` method does not properly account for Mysterious Paper, so use
--- this helper function instead for more robust revival detection.
-function ____exports.willPlayerRevive(self, player)
-    local trinketSituation = temporarilyRemoveTrinket(nil, player, TrinketType.MYSTERIOUS_PAPER)
-    local willRevive = player:WillPlayerRevive() or trinketSituation ~= nil and ____exports.willMysteriousPaperRevive(nil, player)
-    giveTrinketsBack(nil, player, trinketSituation)
-    return willRevive
-end
-return ____exports

package/dist/functions/rng.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rng.d.ts","sourceRoot":"","sources":["../../src/functions/rng.ts"],"names":[],"mappings":";;;AAMA,oBAAY,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACpD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC,CAAC;AAYF,wDAAwD;AACxD,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CASrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,CAgBtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,6EAA6E;AAC7E,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,GAAG,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAMxE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,OAAkB,GAAG,GAAG,CAIlD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAYpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAK1D;AAED,4FAA4F;AAC5F,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CASlD"}