isaacscript-common 73.1.0 → 74.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"bitwise.d.ts","sourceRoot":"","sources":["../../src/functions/bitwise.ts"],"names":[],"mappings":";;;;AAGA,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,GAAG,UAAU,EAC5D,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GACxB,QAAQ,CAAC,CAAC,CAAC,CAOb;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAG1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,CAqB1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAS1C;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,GAAG,CAE9C;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAQzC;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,UAAU,EAC1D,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAOb"}

package/dist/functions/bitwise.lua

@@ -0,0 +1,81 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ParseInt = ____lualib.__TS__ParseInt
+local __TS__NumberToString = ____lualib.__TS__NumberToString
+local __TS__Iterator = ____lualib.__TS__Iterator
+local __TS__ArrayUnshift = ____lualib.__TS__ArrayUnshift
+local ____exports = {}
+local ____flag = require("functions.flag")
+local addFlag = ____flag.addFlag
+local ____utils = require("functions.utils")
+local assertDefined = ____utils.assertDefined
+--- Helper function to convert a set of flags to a single `BitFlags` object.
+function ____exports.arrayToBitFlags(self, array)
+    local flags = 0
+    for ____, flag in ipairs(array) do
+        flags = addFlag(nil, flags, flag)
+    end
+    return flags
+end
+--- Helper function to convert an array of bits to the resulting decimal number.
+function ____exports.convertBinaryToDecimal(self, bits)
+    local bitsString = table.concat(bits, "")
+    return __TS__ParseInt(bitsString, 2)
+end
+--- Helper function to convert a number to an array of bits.
+-- 
+-- @param num The number to convert.
+-- @param minLength Optional. Equal to the minimum amount of bits that should be returned. If the
+-- converted number of bits is below this number, 0's will be padded to the left
+-- side until the minimum length is met. Default is undefined (which will not cause
+-- any padding).
+function ____exports.convertDecimalToBinary(self, num, minLength)
+    local bits = {}
+    local bitsString = __TS__NumberToString(num, 2)
+    for ____, bitString in __TS__Iterator(bitsString) do
+        local bit = tonumber(bitString)
+        assertDefined(
+            nil,
+            bit,
+            "Failed to convert the following number to binary: " .. tostring(num)
+        )
+        bits[#bits + 1] = bit
+    end
+    if minLength ~= nil then
+        while #bits < minLength do
+            __TS__ArrayUnshift(bits, 0)
+        end
+    end
+    return bits
+end
+--- Helper function to count the number of bits that are set to 1 in a binary representation of a
+-- number.
+function ____exports.countSetBits(self, num)
+    local count = 0
+    while num > 0 do
+        num = num & num - 1
+        count = count + 1
+    end
+    return count
+end
+--- Helper function to get the value of a specific but in a binary representation of a number.
+function ____exports.getKBitOfN(self, k, n)
+    return n >> k & 1
+end
+--- Helper function to get the number of bits in a binary representation of a number.
+function ____exports.getNumBitsOfN(self, n)
+    local numBits = 0
+    while n > 0 do
+        numBits = numBits + 1
+        n = n >> 1
+    end
+    return numBits
+end
+--- Helper function to convert a set of flags to a single `BitFlags` object.
+function ____exports.setToBitFlags(self, set)
+    local flags = 0
+    for ____, flag in __TS__Iterator(set:values()) do
+        flags = addFlag(nil, flags, flag)
+    end
+    return flags
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"bombs.d.ts","sourceRoot":"","sources":["../../src/functions/bombs.ts"],"names":[],"mappings":";AAAA,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAU5D"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"bosses.d.ts","sourceRoot":"","sources":["../../src/functions/bosses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EACL,MAAM,EACN,UAAU,EAGX,MAAM,8BAA8B,CAAC;AAmCtC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,UAAU,GAAE,UAAU,GAAG,CAAC,CAAM,EAChC,OAAO,SAAK,EACZ,OAAO,SAAK,EACZ,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,kBAAkB,UAAO,GACxB,WAAW,CAAC,MAAM,CAAC,CAIrB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CA0B9C;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,GACX,MAAM,GAAG,SAAS,CAGpB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,GACnB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,CAAC,EAAE,UAAU,EACvB,OAAO,CAAC,EAAE,GAAG,EACb,OAAO,CAAC,EAAE,GAAG,EACb,cAAc,UAAQ,GACrB,SAAS,EAAE,CAGb;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,GAChB,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAEjC;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,CAE5B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE7C;AAmCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,SAAS,GAAE,IAAI,GAAG,GAAG,GAAG,SAAqB,EAC7C,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAiCX;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,EACZ,mBAAmB,EAAE,MAAM,GAAG,GAAG,EACjC,SAAS,EAAE,IAAI,GAAG,GAAG,EACrB,QAAQ,GAAE,MAAmB,EAC7B,OAAO,GAAE,MAAM,GAAG,SAAqB,EACvC,WAAW,CAAC,EAAE,GAAG,GAChB,SAAS,CAYX"}

package/dist/functions/bosses.lua

@@ -0,0 +1,317 @@
+local ____lualib = require("lualib_bundle")
+local __TS__New = ____lualib.__TS__New
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local BossID = ____isaac_2Dtypescript_2Ddefinitions.BossID
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local LokiVariant = ____isaac_2Dtypescript_2Ddefinitions.LokiVariant
+local UltraGreedVariant = ____isaac_2Dtypescript_2Ddefinitions.UltraGreedVariant
+local ____cachedClasses = require("core.cachedClasses")
+local game = ____cachedClasses.game
+local ____constants = require("core.constants")
+local VectorZero = ____constants.VectorZero
+local ____entityTypeVariantToBossIDMap = require("maps.entityTypeVariantToBossIDMap")
+local ENTITY_TYPE_VARIANT_TO_BOSS_ID_MAP = ____entityTypeVariantToBossIDMap.ENTITY_TYPE_VARIANT_TO_BOSS_ID_MAP
+local ____bossIDToEntityTypeVariant = require("objects.bossIDToEntityTypeVariant")
+local BOSS_ID_TO_ENTITY_TYPE_VARIANT = ____bossIDToEntityTypeVariant.BOSS_ID_TO_ENTITY_TYPE_VARIANT
+local ____bossNames = require("objects.bossNames")
+local BOSS_NAMES = ____bossNames.BOSS_NAMES
+local DEFAULT_BOSS_NAME = ____bossNames.DEFAULT_BOSS_NAME
+local ____bossSets = require("sets.bossSets")
+local ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET = ____bossSets.ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET
+local ALL_BOSSES_SET = ____bossSets.ALL_BOSSES_SET
+local STAGE_TO_COMBINED_BOSS_SET_MAP = ____bossSets.STAGE_TO_COMBINED_BOSS_SET_MAP
+local STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP = ____bossSets.STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP
+local STORY_BOSS_ENTITY_TYPES_SET = ____bossSets.STORY_BOSS_ENTITY_TYPES_SET
+local STORY_BOSS_IDS_SET = ____bossSets.STORY_BOSS_IDS_SET
+local ____repentanceBossIDsSet = require("sets.repentanceBossIDsSet")
+local REPENTANCE_ONLY_BOSS_IDS_SET = ____repentanceBossIDsSet.REPENTANCE_ONLY_BOSS_IDS_SET
+local ____sinEntityTypesSet = require("sets.sinEntityTypesSet")
+local SIN_ENTITY_TYPES_SET = ____sinEntityTypesSet.SIN_ENTITY_TYPES_SET
+local ____ReadonlySet = require("types.ReadonlySet")
+local ReadonlySet = ____ReadonlySet.ReadonlySet
+local ____entities = require("functions.entities")
+local doesEntityExist = ____entities.doesEntityExist
+local ____entitiesSpecific = require("functions.entitiesSpecific")
+local getNPCs = ____entitiesSpecific.getNPCs
+local spawnNPC = ____entitiesSpecific.spawnNPC
+local ____npcs = require("functions.npcs")
+local getAliveNPCs = ____npcs.getAliveNPCs
+local ____rng = require("functions.rng")
+local isRNG = ____rng.isRNG
+local ____rooms = require("functions.rooms")
+local inBeastRoom = ____rooms.inBeastRoom
+local inDogmaRoom = ____rooms.inDogmaRoom
+local ____types = require("functions.types")
+local asNumber = ____types.asNumber
+local ____utils = require("functions.utils")
+local ____repeat = ____utils["repeat"]
+local BOSSES_THAT_REQUIRE_MULTIPLE_SPAWNS = __TS__New(ReadonlySet, {
+    EntityType.LARRY_JR,
+    EntityType.CHUB,
+    EntityType.LOKI,
+    EntityType.GURGLING,
+    EntityType.TURDLET
+})
+local DEFAULT_BOSS_MULTI_SEGMENTS = 4
+--- Helper function to get all of the non-dead bosses in the room.
+-- 
+-- This function will not include bosses on an internal blacklist, such as Death's scythes or Big
+-- Horn holes.
+-- 
+-- @param entityType Optional. If specified, will only get the bosses that match the type. Default
+-- is -1, which matches every type.
+-- @param variant Optional. If specified, will only get the bosses that match the variant. Default
+-- is -1, which matches every variant.
+-- @param subType Optional. If specified, will only get the bosses that match the sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param ignoreFriendly Optional. Default is false.
+function ____exports.getAliveBosses(self, entityType, variant, subType, ignoreFriendly)
+    if entityType == nil then
+        entityType = -1
+    end
+    if variant == nil then
+        variant = -1
+    end
+    if subType == nil then
+        subType = -1
+    end
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local aliveNPCs = getAliveNPCs(
+        nil,
+        entityType,
+        variant,
+        subType,
+        ignoreFriendly
+    )
+    return __TS__ArrayFilter(
+        aliveNPCs,
+        function(____, aliveNPC) return aliveNPC:IsBoss() end
+    )
+end
+--- Helper function to get the set of every boss in the game (which is derived from the `BossID`
+-- enum).
+-- 
+-- This includes:
+-- - Ultra Greed
+-- - Ultra Greedier
+-- 
+-- This does not include:
+-- - mini-bosses (e.g. Ultra Pride, Krampus)
+-- - bosses that do not appear in Boss Rooms (e.g. Uriel, Gabriel)
+-- - the second phase of multi-phase bosses (e.g. Mega Satan 2)
+-- - sub-bosses of The Beast fight (e.g. Ultra Famine, Ultra Pestilence, Ultra War, Ultra Death)
+-- - bosses that do not have any Boss Rooms defined due to being unfinished (e.g. Raglich)
+-- 
+-- Also see the `getBossSet` and `getCombinedBossSet` functions.
+-- 
+-- @param includeStoryBosses Optional. Whether to include "story" bosses like Mom and It Lives.
+-- Default is true.
+function ____exports.getAllBossesSet(self, includeStoryBosses)
+    if includeStoryBosses == nil then
+        includeStoryBosses = true
+    end
+    return includeStoryBosses and ALL_BOSSES_SET or ALL_BOSSES_EXCLUDING_STORY_BOSSES_SET
+end
+--- Helper function to get the boss ID corresponding to the current room. Returns undefined if the
+-- current room is not a Boss Room.
+-- 
+-- Use this instead of the vanilla `Room.GetBossID` method since it has a saner return type and it
+-- correctly handles Dogma, The Beast, and Ultra Greedier.
+function ____exports.getBossID(self)
+    if inDogmaRoom(nil) then
+        return BossID.DOGMA
+    end
+    if inBeastRoom(nil) then
+        return BossID.BEAST
+    end
+    local room = game:GetRoom()
+    local bossID = room:GetBossID()
+    if bossID == 0 then
+        return nil
+    end
+    if bossID == BossID.ULTRA_GREED and doesEntityExist(nil, EntityType.ULTRA_GREED, UltraGreedVariant.ULTRA_GREEDIER) then
+        return BossID.ULTRA_GREEDIER
+    end
+    return bossID
+end
+function ____exports.getBossIDFromEntityTypeVariant(self, entityType, variant)
+    local entityTypeVariant = (tostring(entityType) .. ".") .. tostring(variant)
+    return ENTITY_TYPE_VARIANT_TO_BOSS_ID_MAP:get(entityTypeVariant)
+end
+--- Helper function to get the proper English name for a boss. For example, the name for
+-- `BossID.WRETCHED` (36) is "The Wretched".
+function ____exports.getBossName(self, bossID)
+    return BOSS_NAMES[bossID] or DEFAULT_BOSS_NAME
+end
+--- Helper function to get the set of vanilla bosses for a particular stage and stage type
+-- combination.
+-- 
+-- Also see the `getAllBossesSet` and `getCombinedBossSet` functions.
+function ____exports.getBossSet(self, stage, stageType)
+    local stageTypeMap = STAGE_TO_STAGE_TYPE_TO_BOSS_SET_MAP:get(stage)
+    if stageTypeMap == nil then
+        return nil
+    end
+    return stageTypeMap:get(stageType)
+end
+--- Helper function to get all of the bosses in the room.
+-- 
+-- @param entityType Optional. If specified, will only get the bosses that match the type. Default
+-- is -1, which matches every type.
+-- @param variant Optional. If specified, will only get the bosses that match the variant. Default
+-- is -1, which matches every variant.
+-- @param subType Optional. If specified, will only get the bosses that match the sub-type. Default
+-- is -1, which matches every sub-type.
+-- @param ignoreFriendly Optional. Default is false.
+function ____exports.getBosses(self, entityType, variant, subType, ignoreFriendly)
+    if ignoreFriendly == nil then
+        ignoreFriendly = false
+    end
+    local npcs = getNPCs(
+        nil,
+        entityType,
+        variant,
+        subType,
+        ignoreFriendly
+    )
+    return __TS__ArrayFilter(
+        npcs,
+        function(____, npc) return npc:IsBoss() end
+    )
+end
+--- Helper function to get the set of vanilla bosses for a particular stage across all of the stage
+-- types. For example, specifying `LevelStage.BASEMENT_2` will return a set with all of the bosses
+-- for Basement, Cellar, Burning Basement, Downpour, and Dross.
+-- 
+-- Also see the `getAllBossesSet` and `getBossSet` functions.
+function ____exports.getCombinedBossSet(self, stage)
+    return STAGE_TO_COMBINED_BOSS_SET_MAP:get(stage)
+end
+function ____exports.getEntityTypeVariantFromBossID(self, bossID)
+    return BOSS_ID_TO_ENTITY_TYPE_VARIANT[bossID]
+end
+--- Helper function to check if a boss is only found on a Repentance floor such as Dross, Mines, and
+-- so on.
+-- 
+-- For example, The Pile is a boss that was added in Repentance, but since it can appear in
+-- Necropolis, it is not considered a Repentance boss for the purposes of this function.
+function ____exports.isRepentanceBoss(self, bossID)
+    return REPENTANCE_ONLY_BOSS_IDS_SET:has(bossID)
+end
+--- Helper function to check if the provided NPC is a Sin miniboss, such as Sloth or Lust.
+function ____exports.isSin(self, npc)
+    return SIN_ENTITY_TYPES_SET:has(npc.Type)
+end
+local function getNumBossSegments(self, entityType, variant, numSegments)
+    if numSegments ~= nil then
+        return numSegments
+    end
+    repeat
+        local ____switch22 = entityType
+        local ____cond22 = ____switch22 == EntityType.CHUB
+        if ____cond22 then
+            do
+                return 3
+            end
+        end
+        ____cond22 = ____cond22 or ____switch22 == EntityType.LOKI
+        if ____cond22 then
+            do
+                return variant == asNumber(nil, LokiVariant.LOKII) and 2 or 1
+            end
+        end
+        ____cond22 = ____cond22 or ____switch22 == EntityType.GURGLING
+        if ____cond22 then
+            do
+                return 2
+            end
+        end
+        do
+            do
+                return DEFAULT_BOSS_MULTI_SEGMENTS
+            end
+        end
+    until true
+end
+--- Helper function to determine if the specified entity type is an end-game story boss, like Isaac,
+-- Blue Baby, Mega Satan, The Beast, and so on. This is useful because certain effects should only
+-- apply to non-story bosses, like Vanishing Twin.
+function ____exports.isStoryBoss(self, entityType)
+    return STORY_BOSS_ENTITY_TYPES_SET:has(entityType)
+end
+--- Helper function to determine if the specified boss ID is an end-game story boss, like Isaac, Blue
+-- Baby, Mega Satan, The Beast, and so on. This is useful because certain effects should only apply
+-- to non-story bosses, like Vanishing Twin.
+function ____exports.isStoryBossID(self, bossID)
+    return STORY_BOSS_IDS_SET:has(bossID)
+end
+--- Helper function to spawn a boss.
+-- 
+-- Use this function instead of `spawnNPC` since it handles automatically spawning multiple segments
+-- for multi-segment bosses.
+-- 
+-- By default, this will spawn Chub (and his variants) with 3 segments, Lokii with 2 copies,
+-- Gurglings/Turdlings with 2 copies, and other multi-segment bosses with 4 segments. You can
+-- customize this via the "numSegments" argument.
+function ____exports.spawnBoss(self, entityType, variant, subType, positionOrGridIndex, velocity, spawner, seedOrRNG, numSegments)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    local seed = isRNG(nil, seedOrRNG) and seedOrRNG:Next() or seedOrRNG
+    local npc = spawnNPC(
+        nil,
+        entityType,
+        variant,
+        subType,
+        positionOrGridIndex,
+        velocity,
+        spawner,
+        seed
+    )
+    if BOSSES_THAT_REQUIRE_MULTIPLE_SPAWNS:has(entityType) then
+        local numBossSegments = getNumBossSegments(nil, entityType, variant, numSegments)
+        local remainingSegmentsToSpawn = numBossSegments - 1
+        ____repeat(
+            nil,
+            remainingSegmentsToSpawn,
+            function()
+                spawnNPC(
+                    nil,
+                    entityType,
+                    variant,
+                    subType,
+                    positionOrGridIndex,
+                    velocity,
+                    spawner,
+                    seed
+                )
+            end
+        )
+    end
+    return npc
+end
+--- Helper function to spawn a boss with a specific seed.
+-- 
+-- For more information, see the documentation for the `spawnBoss` function.
+function ____exports.spawnBossWithSeed(self, entityType, variant, subType, positionOrGridIndex, seedOrRNG, velocity, spawner, numSegments)
+    if velocity == nil then
+        velocity = VectorZero
+    end
+    local seed = isRNG(nil, seedOrRNG) and seedOrRNG:Next() or seedOrRNG
+    return ____exports.spawnBoss(
+        nil,
+        entityType,
+        variant,
+        subType,
+        positionOrGridIndex,
+        velocity,
+        spawner,
+        seed,
+        numSegments
+    )
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/functions/cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAW,MAAM,8BAA8B,CAAC;AAW3E;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAgBtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GACjB,kBAAkB,GAAG,SAAS,CAOhC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAOlD;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAET;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAG1E"}

package/dist/functions/cards.lua

@@ -0,0 +1,118 @@
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ItemConfigCardType = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigCardType
+local UseFlag = ____isaac_2Dtypescript_2Ddefinitions.UseFlag
+local ____cachedClasses = require("core.cachedClasses")
+local itemConfig = ____cachedClasses.itemConfig
+local ____constantsFirstLast = require("core.constantsFirstLast")
+local LAST_VANILLA_CARD_TYPE = ____constantsFirstLast.LAST_VANILLA_CARD_TYPE
+local ____cardDescriptions = require("objects.cardDescriptions")
+local CARD_DESCRIPTIONS = ____cardDescriptions.CARD_DESCRIPTIONS
+local DEFAULT_CARD_DESCRIPTION = ____cardDescriptions.DEFAULT_CARD_DESCRIPTION
+local ____cardNames = require("objects.cardNames")
+local CARD_NAMES = ____cardNames.CARD_NAMES
+local DEFAULT_CARD_NAME = ____cardNames.DEFAULT_CARD_NAME
+local ____itemConfigCardTypesForCardsSet = require("sets.itemConfigCardTypesForCardsSet")
+local ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET = ____itemConfigCardTypesForCardsSet.ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET
+local ____flag = require("functions.flag")
+local addFlag = ____flag.addFlag
+function ____exports.isVanillaCardType(self, cardType)
+    return cardType <= LAST_VANILLA_CARD_TYPE
+end
+--- Helper function to get a card description from a `CardType` value. Returns "Unknown" if the
+-- provided card type is not valid.
+-- 
+-- This function works for both vanilla and modded trinkets.
+-- 
+-- For example, `getCardDescription(CardType.FOOL)` would return "Where journey begins".
+function ____exports.getCardDescription(self, cardType)
+    local cardDescription = CARD_DESCRIPTIONS[cardType]
+    if cardDescription ~= nil then
+        return cardDescription
+    end
+    local itemConfigCard = itemConfig:GetCard(cardType)
+    if itemConfigCard ~= nil then
+        return itemConfigCard.Description
+    end
+    return DEFAULT_CARD_DESCRIPTION
+end
+--- Helper function to get the name of a card. Returns "Unknown" if the provided card type is not
+-- valid.
+-- 
+-- This function works for both vanilla and modded trinkets.
+-- 
+-- For example, `getCardName(Card.FOOL)` would return "0 - The Fool".
+function ____exports.getCardName(self, cardType)
+    local cardName = CARD_NAMES[cardType]
+    if cardName ~= nil then
+        return cardName
+    end
+    local itemConfigCard = itemConfig:GetCard(cardType)
+    if itemConfigCard ~= nil then
+        return itemConfigCard.Name
+    end
+    return DEFAULT_CARD_NAME
+end
+--- Helper function to get the item config card type of a particular card, rune, or object. For
+-- example, the item config card type of `CardType.FOOL` is equal to `ItemConfigCardType.TAROT`.
+-- 
+-- Returns undefined if the provided card type was not valid.
+function ____exports.getItemConfigCardType(self, cardType)
+    local itemConfigCard = itemConfig:GetCard(cardType)
+    if itemConfigCard == nil then
+        return nil
+    end
+    return itemConfigCard.CardType
+end
+--- Returns true for card types that have the following item config card type:
+-- 
+-- - `ItemConfigCardType.TAROT` (0)
+-- - `ItemConfigCardType.SUIT` (1)
+-- - `ItemConfigCardType.SPECIAL` (3)
+-- - `ItemConfigCardType.TAROT_REVERSE` (5)
+function ____exports.isCard(self, cardType)
+    local itemConfigCardType = ____exports.getItemConfigCardType(nil, cardType)
+    if itemConfigCardType == nil then
+        return false
+    end
+    return ITEM_CONFIG_CARD_TYPES_FOR_CARDS_SET:has(itemConfigCardType)
+end
+--- Returns whether the given card type matches the specified item config card type.
+function ____exports.isCardType(self, cardType, itemConfigCardType)
+    return itemConfigCardType == ____exports.getItemConfigCardType(nil, cardType)
+end
+--- Returns true for any card type added by a mod.
+function ____exports.isModdedCardType(self, cardType)
+    return not ____exports.isVanillaCardType(nil, cardType)
+end
+--- Returns true for card types that have `ItemConfigCardType.SPECIAL_OBJECT`.
+function ____exports.isPocketItemObject(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.SPECIAL_OBJECT)
+end
+--- Returns true for card types that have `ItemConfigCardType.TAROT_REVERSE`.
+function ____exports.isReverseTarotCard(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.TAROT_REVERSE)
+end
+--- Returns true for card types that have `ItemConfigCardType.RUNE`.
+function ____exports.isRune(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.RUNE)
+end
+--- Returns true for card types that have `ItemConfigCardType.SPECIAL`.
+function ____exports.isSpecialCard(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.SPECIAL)
+end
+--- Returns true for card types that have `ItemConfigCardType.SUIT`.
+function ____exports.isSuitCard(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.SUIT)
+end
+--- Returns true for card types that have `ItemConfigCardType.TAROT`.
+function ____exports.isTarotCard(self, cardType)
+    return ____exports.isCardType(nil, cardType, ItemConfigCardType.TAROT)
+end
+--- Helper function to use a card without showing an animation and without the announcer voice
+-- playing.
+function ____exports.useCardTemp(self, player, cardType)
+    local useFlags = addFlag(nil, UseFlag.NO_ANIMATION, UseFlag.NO_ANNOUNCER_VOICE)
+    player:UseCard(cardType, useFlags)
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"challenges.d.ts","sourceRoot":"","sources":["../../src/functions/challenges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EACf,UAAU,EACV,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAiBzD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAQrC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,GACnB,SAAS,eAAe,EAAE,CAE5B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAK7D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,WAAW,GAAG,SAAS,CAEzB;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAQvD"}

package/dist/functions/challenges.lua

@@ -0,0 +1,98 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayIncludes = ____lualib.__TS__ArrayIncludes
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local Challenge = ____isaac_2Dtypescript_2Ddefinitions.Challenge
+local ____challengeBosses = require("objects.challengeBosses")
+local CHALLENGE_BOSSES = ____challengeBosses.CHALLENGE_BOSSES
+local DEFAULT_CHALLENGE_BOSS_ID = ____challengeBosses.DEFAULT_CHALLENGE_BOSS_ID
+local ____challengeCharacters = require("objects.challengeCharacters")
+local CHALLENGE_CHARACTERS = ____challengeCharacters.CHALLENGE_CHARACTERS
+local DEFAULT_CHALLENGE_CHARACTER = ____challengeCharacters.DEFAULT_CHALLENGE_CHARACTER
+local ____challengeCollectibleTypes = require("objects.challengeCollectibleTypes")
+local CHALLENGE_COLLECTIBLE_TYPES = ____challengeCollectibleTypes.CHALLENGE_COLLECTIBLE_TYPES
+local ____challengeNames = require("objects.challengeNames")
+local CHALLENGE_NAMES = ____challengeNames.CHALLENGE_NAMES
+local DEFAULT_CHALLENGE_NAME = ____challengeNames.DEFAULT_CHALLENGE_NAME
+local ____challengeTrinketType = require("objects.challengeTrinketType")
+local CHALLENGE_TRINKET_TYPE = ____challengeTrinketType.CHALLENGE_TRINKET_TYPE
+local ____log = require("functions.log")
+local log = ____log.log
+--- Helper function to see if the player is playing any challenge.
+function ____exports.onAnyChallenge(self)
+    local challenge = Isaac.GetChallenge()
+    return challenge ~= Challenge.NULL
+end
+--- Helper function to clear the current challenge, which will restart the run on a new random
+-- non-challenge seed with the current character.
+-- 
+-- If the player is not in a challenge already, this function will do nothing.
+-- 
+-- Under the hood, this function executes the `challenge 0` console command.
+function ____exports.clearChallenge(self)
+    if ____exports.onAnyChallenge(nil) then
+        local command = "challenge " .. tostring(Challenge.NULL)
+        log("Restarting the run to clear the current challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
+    end
+end
+--- Get the final boss of a challenge. This will only work for vanilla challenges.
+-- 
+-- For modded challenges, `BossID.MOM` (6) will be returned.
+-- 
+-- Note that for `Challenge.BACKASSWARDS` (31), this function will return `BossID.MEGA_SATAN` (55),
+-- but this is not actually the final boss. (There is no final boss for this challenge.)
+function ____exports.getChallengeBoss(self, challenge)
+    local challengeBossID = CHALLENGE_BOSSES[challenge]
+    return challengeBossID or DEFAULT_CHALLENGE_BOSS_ID
+end
+--- Get the starting character of a challenge. This will only work for vanilla challenges.
+-- 
+-- For modded challenges, `PlayerType.ISAAC` (0) will be returned.
+function ____exports.getChallengeCharacter(self, challenge)
+    local challengeCharacter = CHALLENGE_CHARACTERS[challenge]
+    return challengeCharacter or DEFAULT_CHALLENGE_CHARACTER
+end
+--- Get the extra starting collectibles for a challenge. This will only work for vanilla challenges.
+-- 
+-- For modded challenges, an empty array will be returned.
+function ____exports.getChallengeCollectibleTypes(self, challenge)
+    return CHALLENGE_COLLECTIBLE_TYPES[challenge]
+end
+--- Get the proper name for a `Challenge` enum. This will only work for vanilla challenges.
+-- 
+-- For modded challenges, "Unknown" will be returned.
+function ____exports.getChallengeName(self, challenge)
+    local challengeName = CHALLENGE_NAMES[challenge]
+    return challengeName or DEFAULT_CHALLENGE_NAME
+end
+--- Get the extra starting trinket for a challenge. This will only work for vanilla challenges.
+-- 
+-- If a challenge does not grant a starting trinket, `undefined` will be returned.
+-- 
+-- For modded challenges, `undefined` will be returned.
+function ____exports.getChallengeTrinketType(self, challenge)
+    return CHALLENGE_TRINKET_TYPE[challenge]
+end
+--- Helper function to check to see if the player is playing a particular challenge.
+-- 
+-- This function is variadic, meaning that you can specify as many challenges as you want to check
+-- for.
+function ____exports.onChallenge(self, ...)
+    local challenges = {...}
+    local challenge = Isaac.GetChallenge()
+    return __TS__ArrayIncludes(challenges, challenge)
+end
+--- Helper function to restart the run on a particular challenge.
+-- 
+-- If the player is already in the particular challenge, this function will do nothing.
+-- 
+-- Under the hood, this function executes the `challenge 0` console command.
+function ____exports.setChallenge(self, challenge)
+    if not ____exports.onChallenge(nil, challenge) then
+        local command = "challenge " .. tostring(challenge)
+        log("Restarting the run to set a challenge with a console command of: " .. command)
+        Isaac.ExecuteCommand(command)
+    end
+end
+return ____exports

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

@@ -0,0 +1 @@
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../../src/functions/characters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAqB1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,UAAU,GACpB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE5E;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,UAAU,EACrB,iBAAiB,UAAQ,GACxB,KAAK,CAMP;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CAsBzE;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,UAAU,GACpB,SAAS,eAAe,EAAE,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,UAAU,GACpB,WAAW,GAAG,SAAS,CAEzB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAEjE"}