isaacscript-common 9.18.4 → 9.19.2

package/dist/src/functions/input.lua

@@ -0,0 +1,127 @@
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
+local __TS__ArraySome = ____lualib.__TS__ArraySome
+local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local ButtonAction = ____isaac_2Dtypescript_2Ddefinitions.ButtonAction
+local Controller = ____isaac_2Dtypescript_2Ddefinitions.Controller
+local ControllerIndex = ____isaac_2Dtypescript_2Ddefinitions.ControllerIndex
+local Keyboard = ____isaac_2Dtypescript_2Ddefinitions.Keyboard
+local ____keyboardToString = require("src.maps.keyboardToString")
+local KEYBOARD_TO_STRING = ____keyboardToString.KEYBOARD_TO_STRING
+local ____enums = require("src.functions.enums")
+local getEnumValues = ____enums.getEnumValues
+local ____string = require("src.functions.string")
+local trimPrefix = ____string.trimPrefix
+local MODIFIER_KEYS = {
+    Keyboard.LEFT_SHIFT,
+    Keyboard.LEFT_CONTROL,
+    Keyboard.LEFT_ALT,
+    Keyboard.LEFT_SUPER,
+    Keyboard.RIGHT_SHIFT,
+    Keyboard.RIGHT_CONTROL,
+    Keyboard.RIGHT_ALT,
+    Keyboard.RIGHT_SUPER
+}
+local MOVEMENT_ACTIONS = {ButtonAction.LEFT, ButtonAction.RIGHT, ButtonAction.UP, ButtonAction.DOWN}
+local MOVEMENT_ACTIONS_SET = __TS__New(Set, MOVEMENT_ACTIONS)
+local SHOOTING_ACTIONS = {ButtonAction.SHOOT_LEFT, ButtonAction.SHOOT_RIGHT, ButtonAction.SHOOT_UP, ButtonAction.SHOOT_DOWN}
+local SHOOTING_ACTIONS_SET = __TS__New(Set, SHOOTING_ACTIONS)
+--- Helper function to get the enum name for the specified `Controller` value. Note that this will
+-- trim off the "BUTTON_" prefix.
+function ____exports.controllerToString(self, controller)
+    local key = Controller[controller]
+    if key == nil then
+        return nil
+    end
+    return trimPrefix(nil, key, "BUTTON_")
+end
+function ____exports.getMoveActions(self)
+    return MOVEMENT_ACTIONS_SET
+end
+function ____exports.getShootActions(self)
+    return SHOOTING_ACTIONS_SET
+end
+--- Iterates over all inputs to determine if a particular button is pressed (i.e. held down).
+function ____exports.isActionPressedOnAnyInput(self, buttonAction)
+    local controllerIndexes = getEnumValues(nil, ControllerIndex)
+    return __TS__ArraySome(
+        controllerIndexes,
+        function(____, controllerIndex) return Input.IsActionPressed(buttonAction, controllerIndex) end
+    )
+end
+--- Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
+-- then released).
+function ____exports.isActionTriggeredOnAnyInput(self, buttonAction)
+    local controllerIndexes = getEnumValues(nil, ControllerIndex)
+    return __TS__ArraySome(
+        controllerIndexes,
+        function(____, controllerIndex) return Input.IsActionTriggered(buttonAction, controllerIndex) end
+    )
+end
+--- Helper function to see if a particular keyboard key is being pressed down by the player.
+-- 
+-- This function is variadic, meaning you can pass as many keyboard values as you want to check for.
+-- This function will return true if any of the values are pressed.
+function ____exports.isKeyboardPressed(self, ...)
+    local keys = {...}
+    return __TS__ArraySome(
+        keys,
+        function(____, key) return Input.IsButtonPressed(key, ControllerIndex.KEYBOARD) end
+    )
+end
+--- Helper function to check if one or more modifier keys are being pressed down on the keyboard.
+-- 
+-- A modifier key is defined as shift, control, alt, or Windows.
+function ____exports.isModifierKeyPressed(self)
+    return ____exports.isKeyboardPressed(
+        nil,
+        table.unpack(MODIFIER_KEYS)
+    )
+end
+function ____exports.isMoveAction(self, buttonAction)
+    return MOVEMENT_ACTIONS_SET:has(buttonAction)
+end
+function ____exports.isMoveActionPressedOnAnyInput(self)
+    return __TS__ArraySome(
+        MOVEMENT_ACTIONS,
+        function(____, moveAction) return ____exports.isActionPressedOnAnyInput(nil, moveAction) end
+    )
+end
+function ____exports.isMoveActionTriggeredOnAnyInput(self)
+    return __TS__ArraySome(
+        MOVEMENT_ACTIONS,
+        function(____, moveAction) return ____exports.isActionTriggeredOnAnyInput(nil, moveAction) end
+    )
+end
+function ____exports.isShootAction(self, buttonAction)
+    return SHOOTING_ACTIONS_SET:has(buttonAction)
+end
+function ____exports.isShootActionPressedOnAnyInput(self)
+    return __TS__ArraySome(
+        SHOOTING_ACTIONS,
+        function(____, shootAction) return ____exports.isActionPressedOnAnyInput(nil, shootAction) end
+    )
+end
+function ____exports.isShootActionTriggeredOnAnyInput(self)
+    return __TS__ArraySome(
+        SHOOTING_ACTIONS,
+        function(____, shootAction) return ____exports.isActionTriggeredOnAnyInput(nil, shootAction) end
+    )
+end
+--- Helper function to get the string that would be typed if someone pressed the corresponding key.
+-- This is useful for creating in-game chat.
+-- 
+-- Note that this function will only work for the keyboard values that are printable. Thus, it will
+-- return undefined for e.g. `Keyboard.LEFT_SHIFT` (340). If all you want is the corresponding name
+-- of the key, then simply use the enum reverse mapping (e.g. `Keyboard[keyboard]`).
+function ____exports.keyboardToString(self, keyboard, uppercase)
+    local tuple = KEYBOARD_TO_STRING:get(keyboard)
+    if tuple == nil then
+        return nil
+    end
+    local lowercaseCharacter, uppercaseCharacter = table.unpack(tuple)
+    return uppercase and uppercaseCharacter or lowercaseCharacter
+end
+return ____exports

package/dist/src/functions/isaacAPIClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isaacAPIClass.d.ts","sourceRoot":"","sources":["../../../src/functions/isaacAPIClass.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkBxE;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,UAAU,CAEhE;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAEpE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAEpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,MAAM,CAE9D;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAExE;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,UAAU,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAGxE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,WAAW,CAElE;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,WAAW,CAElE;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,SAAS,CAE9D;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAEpE;AAED,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,aAAa,CAElE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,YAAY,CAEpE;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAEpE;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,uBAAuB,CAErC;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,gBAAgB,CAE5E;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,gBAAgB,CAExE;AAED,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,aAAa,CAElE;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,UAAU,CAEhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAKT"}

package/dist/src/functions/isaacAPIClass.lua

@@ -0,0 +1,132 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
+local ____exports = {}
+local ____string = require("src.functions.string")
+local trimPrefix = ____string.trimPrefix
+local ____types = require("src.functions.types")
+local isString = ____types.isString
+local isUserdata = ____types.isUserdata
+--- Helper function to get the name of a class from the Isaac API. This is contained within the
+-- "__type" metatable key.
+-- 
+-- For example, a `Vector` class is has a name of "Vector".
+-- 
+-- Returns undefined if the object is not of type `userdata` or if the "__type" metatable key does
+-- not exist.
+-- 
+-- In some cases, Isaac classes can be a read-only. If this is the case, the "__type" field will be
+-- prepended with "const ". This function will always strip this prefix, if it exists. For example,
+-- the class name returned for "const Vector" will be "Vector".
+function ____exports.getIsaacAPIClassName(self, object)
+    if not isUserdata(nil, object) then
+        return nil
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return nil
+    end
+    local classType = metatable.__type
+    if not isString(nil, classType) then
+        return nil
+    end
+    return trimPrefix(nil, classType, "const ")
+end
+--- Helper function to detect if a variable is of type `EntityBomb`.
+function ____exports.isBomb(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityBomb"
+end
+--- Helper function to detect if a variable is of type `GridEntityDoor`.
+function ____exports.isDoor(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityDoor"
+end
+--- Helper function to detect if a variable is of type `EntityEffect`.
+function ____exports.isEffect(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityEffect"
+end
+--- Helper function to detect if a variable is of type `Entity`. This will return false for child
+-- classes such as `EntityPlayer` or `EntityTear`.
+function ____exports.isEntity(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "Entity"
+end
+--- Helper function to detect if a variable is of type `EntityEffect`.
+function ____exports.isFamiliar(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityEffect"
+end
+--- Helper function to detect if a variable is of type `GridEntity`.
+function ____exports.isGridEntity(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntity"
+end
+--- Helper function to check if something is an instantiated class from the Isaac API. (All classes
+-- from the Isaac API have a type of "userdata" in Lua with a metatable key of "__type" equal to the
+-- name of the class.)
+function ____exports.isIsaacAPIClass(self, object)
+    local isaacAPIClassType = ____exports.getIsaacAPIClassName(nil, object)
+    return isaacAPIClassType ~= nil
+end
+function ____exports.isIsaacAPIClassOfType(self, object, classType)
+    local isaacAPIClassType = ____exports.getIsaacAPIClassName(nil, object)
+    return isaacAPIClassType == classType or isaacAPIClassType == "const " .. classType
+end
+--- Helper function to detect if a variable is of type `EntityKnife`.
+function ____exports.isKnife(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityKnife"
+end
+--- Helper function to detect if a variable is of type `EntityLaser`.
+function ____exports.isLaser(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityLaser"
+end
+--- Helper function to detect if a variable is of type `EntityNPC`.
+function ____exports.isNPC(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityNPC"
+end
+--- Helper function to detect if a variable is of type `EntityPickup`.
+function ____exports.isPickup(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityPickup"
+end
+--- Helper function to detect if a variable is of type `GridEntityPit`.
+function ____exports.isPit(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityPit"
+end
+--- Helper function to detect if a variable is of type `EntityPlayer`.
+function ____exports.isPlayer(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityPlayer"
+end
+--- Helper function to detect if a variable is of type `GridEntityPoop`.
+function ____exports.isPoop(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityPoop"
+end
+--- Helper function to detect if a variable is of type `GridEntityPressurePlate`.
+function ____exports.isPressurePlate(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityPressurePlate"
+end
+--- Helper function to detect if a variable is of type `EntityProjectile`.
+function ____exports.isProjectile(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityProjectile"
+end
+--- Helper function to detect if a variable is of type `GridEntityRock`.
+function ____exports.isRock(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityRock"
+end
+--- Helper function to detect if a variable is of type `GridEntitySpikes`.
+function ____exports.isSpikes(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntitySpikes"
+end
+--- Helper function to detect if a variable is of type `GridEntityTNT`.
+function ____exports.isTNT(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "GridEntityTNT"
+end
+--- Helper function to detect if a variable is of type `EntityTear`.
+function ____exports.isTear(self, variable)
+    return ____exports.getIsaacAPIClassName(nil, variable) == "EntityTear"
+end
+--- Helper function to check if an instantiated Isaac API class is equal to another one of the same
+-- type. You must provide the list of keys to check for.
+function ____exports.isaacAPIClassEquals(self, object1, object2, keys)
+    local table1 = object1
+    local table2 = object2
+    return __TS__ArrayEvery(
+        keys,
+        function(____, key) return table1[key] == table2[key] end
+    )
+end
+return ____exports

package/dist/src/functions/itemPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemPool.d.ts","sourceRoot":"","sources":["../../../src/functions/itemPool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,YAAY,EAGb,MAAM,8BAA8B,CAAC;AAsBtC;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,GACzB,eAAe,EAAE,CAKnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,GACzB,OAAO,CA6DT"}

package/dist/src/functions/itemPool.lua

@@ -0,0 +1,131 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local Map = ____lualib.Map
+local __TS__New = ____lualib.__TS__New
+local ____exports = {}
+local removeItemsAndTrinketsThatAffectItemPools, restoreItemsAndTrinketsThatAffectItemPools, COLLECTIBLES_THAT_AFFECT_ITEM_POOLS, TRINKETS_THAT_AFFECT_ITEM_POOLS, COLLECTIBLE_TYPE_THAT_IS_NOT_IN_ANY_POOLS
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local ItemConfigTag = ____isaac_2Dtypescript_2Ddefinitions.ItemConfigTag
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
+local ____cachedClasses = require("src.core.cachedClasses")
+local game = ____cachedClasses.game
+local ____collectibleSet = require("src.functions.collectibleSet")
+local getCollectibleArray = ____collectibleSet.getCollectibleArray
+local ____collectibleTag = require("src.functions.collectibleTag")
+local collectibleHasTag = ____collectibleTag.collectibleHasTag
+local ____playerDataStructures = require("src.functions.playerDataStructures")
+local mapGetPlayer = ____playerDataStructures.mapGetPlayer
+local mapSetPlayer = ____playerDataStructures.mapSetPlayer
+local ____playerIndex = require("src.functions.playerIndex")
+local getPlayers = ____playerIndex.getPlayers
+local ____players = require("src.functions.players")
+local getPlayersOfType = ____players.getPlayersOfType
+local ____utils = require("src.functions.utils")
+local ____repeat = ____utils["repeat"]
+--- Helper function to see if the given collectible is still present in the given item pool.
+-- 
+-- If the collectible is non-offensive, any Tainted Losts will be temporarily changed to Isaac and
+-- then changed back. (This is because Tainted Lost is not able to retrieve non-offensive
+-- collectibles from item pools).
+-- 
+-- Under the hood, this function works by using the `ItemPool.AddRoomBlacklist` method to blacklist
+-- every collectible except for the one provided.
+function ____exports.isCollectibleInItemPool(self, collectibleType, itemPoolType)
+    if collectibleType == COLLECTIBLE_TYPE_THAT_IS_NOT_IN_ANY_POOLS then
+        return false
+    end
+    local taintedLosts = getPlayersOfType(nil, PlayerType.THE_LOST_B)
+    local isOffensive = collectibleHasTag(nil, collectibleType, ItemConfigTag.OFFENSIVE)
+    local changedPlayerTypes = false
+    if not isOffensive then
+        changedPlayerTypes = true
+        for ____, player in ipairs(taintedLosts) do
+            player:ChangePlayerType(PlayerType.ISAAC)
+        end
+    end
+    local removedItemsMap, removedTrinketsMap = table.unpack(removeItemsAndTrinketsThatAffectItemPools(nil))
+    local itemPool = game:GetItemPool()
+    itemPool:ResetRoomBlacklist()
+    for ____, collectibleTypeInSet in ipairs(getCollectibleArray(nil)) do
+        if collectibleTypeInSet ~= collectibleType then
+            itemPool:AddRoomBlacklist(collectibleTypeInSet)
+        end
+    end
+    local seed = 1
+    local retrievedCollectibleType = itemPool:GetCollectible(itemPoolType, false, seed, COLLECTIBLE_TYPE_THAT_IS_NOT_IN_ANY_POOLS)
+    local collectibleUnlocked = retrievedCollectibleType == collectibleType
+    itemPool:ResetRoomBlacklist()
+    restoreItemsAndTrinketsThatAffectItemPools(nil, removedItemsMap, removedTrinketsMap)
+    if changedPlayerTypes then
+        for ____, player in ipairs(taintedLosts) do
+            player:ChangePlayerType(PlayerType.THE_LOST_B)
+        end
+    end
+    return collectibleUnlocked
+end
+function removeItemsAndTrinketsThatAffectItemPools(self)
+    local removedItemsMap = __TS__New(Map)
+    local removedTrinketsMap = __TS__New(Map)
+    for ____, player in ipairs(getPlayers(nil)) do
+        local removedItems = {}
+        for ____, itemToRemove in ipairs(COLLECTIBLES_THAT_AFFECT_ITEM_POOLS) do
+            local numCollectibles = player:GetCollectibleNum(itemToRemove)
+            ____repeat(
+                nil,
+                numCollectibles,
+                function()
+                    player:RemoveCollectible(itemToRemove)
+                    removedItems[#removedItems + 1] = itemToRemove
+                end
+            )
+        end
+        mapSetPlayer(nil, removedItemsMap, player, removedItems)
+        local removedTrinkets = {}
+        for ____, trinketToRemove in ipairs(TRINKETS_THAT_AFFECT_ITEM_POOLS) do
+            if player:HasTrinket(trinketToRemove) then
+                local numTrinkets = player:GetTrinketMultiplier(trinketToRemove)
+                ____repeat(
+                    nil,
+                    numTrinkets,
+                    function()
+                        player:TryRemoveTrinket(trinketToRemove)
+                        removedTrinkets[#removedTrinkets + 1] = trinketToRemove
+                    end
+                )
+            end
+        end
+        mapSetPlayer(nil, removedTrinketsMap, player, removedTrinkets)
+    end
+    return {removedItemsMap, removedTrinketsMap}
+end
+function restoreItemsAndTrinketsThatAffectItemPools(self, removedItemsMap, removedTrinketsMap)
+    for ____, player in ipairs(getPlayers(nil)) do
+        local removedItems = mapGetPlayer(nil, removedItemsMap, player)
+        if removedItems ~= nil then
+            for ____, collectibleType in ipairs(removedItems) do
+                player:AddCollectible(collectibleType, 0, false)
+            end
+        end
+        local removedTrinkets = mapGetPlayer(nil, removedTrinketsMap, player)
+        if removedTrinkets ~= nil then
+            for ____, trinketType in ipairs(removedTrinkets) do
+                player:AddTrinket(trinketType, false)
+            end
+        end
+    end
+end
+COLLECTIBLES_THAT_AFFECT_ITEM_POOLS = {CollectibleType.CHAOS, CollectibleType.SACRED_ORB, CollectibleType.TMTRAINER}
+TRINKETS_THAT_AFFECT_ITEM_POOLS = {TrinketType.NO}
+COLLECTIBLE_TYPE_THAT_IS_NOT_IN_ANY_POOLS = CollectibleType.KEY_PIECE_1
+--- Helper function to get the remaining collectibles in a given item pool. This function is
+-- expensive, so only use it in situations where the lag is acceptable.
+function ____exports.getCollectiblesInItemPool(self, itemPoolType)
+    local collectibleArray = getCollectibleArray(nil)
+    return __TS__ArrayFilter(
+        collectibleArray,
+        function(____, collectibleType) return ____exports.isCollectibleInItemPool(nil, collectibleType, itemPoolType) end
+    )
+end
+return ____exports

package/dist/src/functions/jsonHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonHelpers.d.ts","sourceRoot":"","sources":["../../../src/functions/jsonHelpers.ts"],"names":[],"mappings":";AAWA;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CASzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAOpD"}

package/dist/src/functions/jsonHelpers.lua

@@ -0,0 +1,43 @@
+local ____exports = {}
+local jsonLua = require("src.lib.jsonLua")
+local ____log = require("src.functions.log")
+local logError = ____log.logError
+local function tryDecode(jsonString)
+    return jsonLua.decode(jsonString)
+end
+local function tryEncode(luaTable)
+    return jsonLua.encode(luaTable)
+end
+--- Converts a JSON string to a Lua table.
+-- 
+-- In most cases, this function will be used for reading data from a "save#.dat" file. If decoding
+-- fails, it will return a blank Lua table instead of throwing an error. (This allows execution to
+-- continue in cases where users have no current save data or have manually removed their existing
+-- save data.)
+-- 
+-- Under the hood, this uses a custom JSON parser that was measured to be 11.8 times faster than the
+-- vanilla JSON parser.
+function ____exports.jsonDecode(self, jsonString)
+    local ok, luaTableOrErrMsg = pcall(tryDecode, jsonString)
+    if not ok then
+        logError(nil, "Failed to convert the JSON string to a Lua table: " .. jsonString)
+        return {}
+    end
+    return luaTableOrErrMsg
+end
+--- Converts a Lua table to a JSON string.
+-- 
+-- In most cases, this function will be used for writing data to a "save#.dat" file. If encoding
+-- fails, it will throw an error to prevent writing a blank string or corrupted data to a user's
+-- "save#.dat" file.
+-- 
+-- Under the hood, this uses a custom JSON parser that was measured to be 11.8 times faster than the
+-- vanilla JSON parser.
+function ____exports.jsonEncode(self, luaTable)
+    local ok, jsonStringOrErrMsg = pcall(tryEncode, luaTable)
+    if not ok then
+        error("Failed to convert the Lua table to JSON: " .. jsonStringOrErrMsg)
+    end
+    return jsonStringOrErrMsg
+end
+return ____exports

package/dist/src/functions/jsonRoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRoom.d.ts","sourceRoot":"","sources":["../../../src/functions/jsonRoom.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAQvD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,YAAY,CAAC,CAgDxB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAAE,EAC3C,OAAO,EAAE,GAAG,GACX,QAAQ,GAAG,SAAS,CAoBtB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAAE,EAC3C,OAAO,EAAE,GAAG,GACX,QAAQ,EAAE,CAMZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,QAAQ,EAAE,EAC3C,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,OAAO,UAAQ,GACd,QAAQ,CAYV"}

package/dist/src/functions/jsonRoom.lua

@@ -0,0 +1,159 @@
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayFilter = ____lualib.__TS__ArrayFilter
+local __TS__ArrayMap = ____lualib.__TS__ArrayMap
+local ____exports = {}
+local getTotalWeightOfJSONRooms, getJSONRoomWithChosenWeight
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DoorSlotFlagZero = ____isaac_2Dtypescript_2Ddefinitions.DoorSlotFlagZero
+local ____array = require("src.functions.array")
+local sumArray = ____array.sumArray
+local ____doors = require("src.functions.doors")
+local doorSlotToDoorSlotFlag = ____doors.doorSlotToDoorSlotFlag
+local getRoomShapeDoorSlot = ____doors.getRoomShapeDoorSlot
+local ____flag = require("src.functions.flag")
+local addFlag = ____flag.addFlag
+local ____log = require("src.functions.log")
+local log = ____log.log
+local ____random = require("src.functions.random")
+local getRandomFloat = ____random.getRandomFloat
+local ____rng = require("src.functions.rng")
+local getRandomSeed = ____rng.getRandomSeed
+function getTotalWeightOfJSONRooms(self, jsonRooms)
+    local weights = __TS__ArrayMap(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomWeightString = jsonRoom["$"].weight
+            local roomWeight = tonumber(roomWeightString)
+            if roomWeight == nil then
+                error(("Failed to parse the weight of a JSON room: " .. roomWeightString) .. ".")
+            end
+            return roomWeight
+        end
+    )
+    return sumArray(nil, weights)
+end
+function getJSONRoomWithChosenWeight(self, jsonRooms, chosenWeight)
+    for ____, jsonRoom in ipairs(jsonRooms) do
+        local roomWeightString = jsonRoom["$"].weight
+        local roomWeight = tonumber(roomWeightString)
+        if roomWeight == nil then
+            error("Failed to parse the weight of a JSON room: " .. roomWeightString)
+        end
+        if chosenWeight < roomWeight then
+            return jsonRoom
+        end
+        chosenWeight = chosenWeight - roomWeight
+    end
+    error("Failed to get a JSON room with chosen weight: " .. tostring(chosenWeight))
+end
+--- Helper function to calculate what the resulting `BitFlags<DoorSlotFlag>` value would be for a
+-- given JSON room.
+function ____exports.getJSONRoomDoorSlotFlags(self, jsonRoom)
+    local roomShapeString = jsonRoom["$"].shape
+    local roomShapeNumber = tonumber(roomShapeString)
+    if roomShapeNumber == nil then
+        error("Failed to parse the \"shape\" field of a JSON room: " .. roomShapeString)
+    end
+    local roomShape = roomShapeNumber
+    local doorSlotFlags = DoorSlotFlagZero
+    for ____, door in ipairs(jsonRoom.door) do
+        do
+            local existsString = door["$"].exists
+            if existsString ~= "True" and existsString ~= "False" then
+                error("Failed to parse the \"exists\" field of a JSON room door: " .. existsString)
+            end
+            if existsString == "False" then
+                goto __continue4
+            end
+            local xString = door["$"].x
+            local x = tonumber(xString)
+            if x == nil then
+                error("Failed to parse the \"x\" field of a JSON room door: " .. xString)
+            end
+            local yString = door["$"].y
+            local y = tonumber(yString)
+            if y == nil then
+                error("Failed to parse the \"y\" field of a JSON room door: " .. yString)
+            end
+            local doorSlot = getRoomShapeDoorSlot(nil, roomShape, x, y)
+            if doorSlot == nil then
+                error(((("Failed to retrieve the door slot for a JSON room door at coordinates: [" .. tostring(x)) .. ", ") .. tostring(y)) .. "]")
+            end
+            local doorSlotFlag = doorSlotToDoorSlotFlag(nil, doorSlot)
+            doorSlotFlags = addFlag(nil, doorSlotFlags, doorSlotFlag)
+        end
+        ::__continue4::
+    end
+    return doorSlotFlags
+end
+--- Helper function to find a specific room from an array of JSON rooms.
+-- 
+-- @param jsonRooms The array of rooms to search through.
+-- @param variant The room variant to select. (The room variant can be thought of as the ID of the
+-- room.)
+function ____exports.getJSONRoomOfVariant(self, jsonRooms, variant)
+    local jsonRoomsOfVariant = __TS__ArrayFilter(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomVariantString = jsonRoom["$"].variant
+            local roomVariant = tonumber(roomVariantString)
+            return roomVariant == variant
+        end
+    )
+    if #jsonRoomsOfVariant == 0 then
+        return nil
+    end
+    if #jsonRoomsOfVariant == 1 then
+        return jsonRoomsOfVariant[1]
+    end
+    error(((("Found " .. tostring(#jsonRoomsOfVariant)) .. " JSON rooms with a variant of ") .. tostring(variant)) .. ", when there should only be 1.")
+end
+--- Helper function to find all of the JSON rooms that match the sub-type provided.
+-- 
+-- @param jsonRooms The array of rooms to search through.
+-- @param subType The sub-type to match.
+function ____exports.getJSONRoomsOfSubType(self, jsonRooms, subType)
+    return __TS__ArrayFilter(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomSubTypeString = jsonRoom["$"].subtype
+            local roomSubType = tonumber(roomSubTypeString)
+            return roomSubType == subType
+        end
+    )
+end
+--- Helper function to get a random JSON room from an array of JSON rooms.
+-- 
+-- Note that this function does not simply choose a random element in the provided array; it will
+-- properly account for each room weight using the algorithm from:
+-- https://stackoverflow.com/questions/1761626/weighted-random-numbers
+-- 
+-- @param jsonRooms The array of rooms to random choose between.
+-- @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 verbose Optional. If specified, will write entries to the "log.txt" file that describe
+-- what the function is doing. Default is false.
+function ____exports.getRandomJSONRoom(self, jsonRooms, seedOrRNG, verbose)
+    if seedOrRNG == nil then
+        seedOrRNG = getRandomSeed(nil)
+    end
+    if verbose == nil then
+        verbose = false
+    end
+    local totalWeight = getTotalWeightOfJSONRooms(nil, jsonRooms)
+    if verbose then
+        log(
+            nil,
+            "Total weight of the JSON rooms provided: " .. tostring(totalWeight)
+        )
+    end
+    local chosenWeight = getRandomFloat(nil, 0, totalWeight, seedOrRNG)
+    if verbose then
+        log(
+            nil,
+            "Randomly chose weight for JSON room: " .. tostring(chosenWeight)
+        )
+    end
+    return getJSONRoomWithChosenWeight(nil, jsonRooms, chosenWeight)
+end
+return ____exports

package/dist/src/functions/kColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kColor.d.ts","sourceRoot":"","sources":["../../../src/functions/kColor.ts"],"names":[],"mappings":";;;;AAOA,oBAAY,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvD,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C,CAAC;AAKF,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA+BlE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,IAAI,GAAG,GAAqB,EACvC,KAAK,SAAI,GACR,MAAM,CAQR;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,gBAAgB,CAQ5B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhE"}