isaacscript-common 1.0.600 → 1.0.604

package/dist/functions/globals.lua

@@ -0,0 +1,205 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+require("lualib_bundle");
+local ____exports = {}
+local ____log = require("functions.log")
+local log = ____log.log
+local ____util = require("functions.util")
+local combineSets = ____util.combineSets
+local isLuaDebugEnabled = ____util.isLuaDebugEnabled
+local DEFAULT_GLOBALS = __TS__New(Set, {
+    "ActionTriggers",
+    "ActiveSlot",
+    "BabySubType",
+    "BackdropType",
+    "BatterySubType",
+    "BedSubType",
+    "BitSet128",
+    "BombSubType",
+    "BombVariant",
+    "ButtonAction",
+    "CacheFlag",
+    "Card",
+    "Challenge",
+    "ChampionColor",
+    "ChestSubType",
+    "CoinSubType",
+    "CollectibleType",
+    "Color",
+    "CppContainer",
+    "DamageFlag",
+    "Difficulty",
+    "Direction",
+    "DoorSlot",
+    "DoorState",
+    "DoorVariant",
+    "EffectVariant",
+    "Entity",
+    "EntityBomb",
+    "EntityCollisionClass",
+    "EntityEffect",
+    "EntityFamiliar",
+    "EntityFlag",
+    "EntityGridCollisionClass",
+    "EntityKnife",
+    "EntityLaser",
+    "EntityNPC",
+    "EntityPartition",
+    "EntityPickup",
+    "EntityPlayer",
+    "EntityProjectile",
+    "EntityPtr",
+    "EntityRef",
+    "EntityTear",
+    "EntityType",
+    "FamiliarVariant",
+    "Font",
+    "Game",
+    "GameStateFlag",
+    "GetPtrHash",
+    "GridCollisionClass",
+    "GridEntity",
+    "GridEntityDesc",
+    "GridEntityDoor",
+    "GridEntityPit",
+    "GridEntityPoop",
+    "GridEntityPressurePlate",
+    "GridEntityRock",
+    "GridEntitySpikes",
+    "GridEntityTNT",
+    "GridEntityType",
+    "GridRooms",
+    "HUD",
+    "HeartSubType",
+    "Input",
+    "InputHook",
+    "Isaac",
+    "ItemConfig",
+    "ItemPool",
+    "ItemPoolType",
+    "ItemType",
+    "KColor",
+    "KeySubType",
+    "Keyboard",
+    "LaserOffset",
+    "LaserSubType",
+    "Level",
+    "LevelCurse",
+    "LevelStage",
+    "LevelStateFlag",
+    "LocustSubtypes",
+    "ModCallbacks",
+    "Mouse",
+    "Music",
+    "MusicManager",
+    "NpcState",
+    "NullItemID",
+    "Options",
+    "PathFinder",
+    "PickupPrice",
+    "PickupVariant",
+    "PillColor",
+    "PillEffect",
+    "PlayerForm",
+    "PlayerSpriteLayer",
+    "PlayerType",
+    "PlayerTypes",
+    "PoopPickupSubType",
+    "PoopSpellType",
+    "ProjectileFlags",
+    "ProjectileParams",
+    "ProjectileVariant",
+    "QueueItemData",
+    "REPENTANCE",
+    "RNG",
+    "Random",
+    "RandomVector",
+    "RegisterMod",
+    "RenderMode",
+    "Room",
+    "RoomConfig",
+    "RoomDescriptor",
+    "RoomShape",
+    "RoomTransitionAnim",
+    "RoomType",
+    "SFXManager",
+    "SackSubType",
+    "SeedEffect",
+    "Seeds",
+    "ShockwaveParams",
+    "SortingLayer",
+    "SoundEffect",
+    "Sprite",
+    "StageType",
+    "StartDebug",
+    "TearFlags",
+    "TearParams",
+    "TearVariant",
+    "TemporaryEffect",
+    "TemporaryEffects",
+    "TrinketType",
+    "UseFlag",
+    "Vector",
+    "WeaponType",
+    "_G",
+    "_VERSION",
+    "assert",
+    "collectgarbage",
+    "coroutine",
+    "dofile",
+    "error",
+    "getmetatable",
+    "include",
+    "ipairs",
+    "load",
+    "loadfile",
+    "math",
+    "next",
+    "pairs",
+    "pcall",
+    "print",
+    "rawequal",
+    "rawget",
+    "rawlen",
+    "rawset",
+    "require",
+    "select",
+    "setmetatable",
+    "string",
+    "table",
+    "tonumber",
+    "tostring",
+    "type",
+    "utf8",
+    "xpcall"
+})
+local LUA_DEBUG_ADDED_GLOBALS = __TS__New(Set, {"debug", "io", "os", "package"})
+function ____exports.getDefaultGlobals(self)
+    return isLuaDebugEnabled(nil) and combineSets(nil, DEFAULT_GLOBALS, LUA_DEBUG_ADDED_GLOBALS) or DEFAULT_GLOBALS
+end
+function ____exports.getNewGlobals(self)
+    local defaultGlobals = ____exports.getDefaultGlobals(nil)
+    local newGlobals = {}
+    for key, value in pairs(_G) do
+        if not defaultGlobals:has(key) then
+            local keyValueTuple = {key, value}
+            __TS__ArrayPush(newGlobals, keyValueTuple)
+        end
+    end
+    return newGlobals
+end
+function ____exports.logNewGlobals(self)
+    local newGlobals = ____exports.getNewGlobals(nil)
+    log("List of added global variables in the Isaac environment:")
+    if #newGlobals == 0 then
+        log("- n/a (no extra global variables found)")
+    end
+    do
+        local i = 0
+        while i < #newGlobals do
+            local key, value = table.unpack(newGlobals[i + 1])
+            log((((tostring(i + 1) .. ") ") .. tostring(key)) .. " - ") .. tostring(value))
+            i = i + 1
+        end
+    end
+end
+return ____exports

package/dist/functions/gridEntity.lua

@@ -130,13 +130,14 @@ function ____exports.isAllPressurePlatesPushed(self)
     if not hasPressurePlates then
         return true
     end
-    for ____, gridEntity in ipairs(____exports.getGridEntities(nil, GridEntityType.GRID_PRESSURE_PLATE)) do
-        local gridEntityDesc = gridEntity:GetSaveState()
-        if gridEntityDesc.State ~= 3 then
-            return false
+    local pressurePlates = ____exports.getGridEntities(nil, GridEntityType.GRID_PRESSURE_PLATE)
+    return __TS__ArrayEvery(
+        pressurePlates,
+        function(____, pressurePlate)
+            local gridEntityDesc = pressurePlate:GetSaveState()
+            return gridEntityDesc.State == 3
         end
-    end
-    return true
+    )
 end
 function ____exports.isPostBossVoidPortal(self, gridEntity)
     local saveState = gridEntity:GetSaveState()

package/dist/functions/input.d.ts

@@ -1,10 +1,10 @@
 /// <reference types="isaac-typescript-definitions" />
 /** Helper function to get the enum name for the specified `Controller` value. */
 export declare function controllerToString(controller: Controller): string;
-/** Iterates over all 4 inputs to determine if a particular button is pressed (i.e. held down). */
+/** Iterates over all inputs to determine if a particular button is pressed (i.e. held down). */
 export declare function isActionPressedOnAnyInput(buttonAction: ButtonAction): boolean;
 /**
- * Iterates over all 4 inputs to determine if a particular button is triggered (i.e. held down and
+ * Iterates over all inputs to determine if a particular button is triggered (i.e. held down and
  * then released).
  */
 export declare function isActionTriggeredOnAnyInput(buttonAction: ButtonAction): boolean;

package/dist/functions/jsonRoom.lua

@@ -2,57 +2,66 @@
 require("lualib_bundle");
 local ____exports = {}
 local getTotalWeightOfJSONRooms, getJSONRoomWithChosenWeight
+local ____array = require("functions.array")
+local arraySum = ____array.arraySum
 local ____log = require("functions.log")
 local log = ____log.log
 local ____random = require("functions.random")
 local getRandomFloat = ____random.getRandomFloat
 function getTotalWeightOfJSONRooms(self, jsonRooms)
-    local totalWeight = 0
-    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 room: " .. roomWeightString) .. ".")
+    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
-        totalWeight = totalWeight + roomWeight
-    end
-    return totalWeight
+    )
+    return arraySum(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 room: " .. roomWeightString)
+            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 room with chosen weight: " .. tostring(chosenWeight))
-    return jsonRooms[1]
+    return error("Failed to get a JSON room with chosen weight: " .. tostring(chosenWeight))
 end
 function ____exports.getJSONRoomOfVariant(self, jsonRooms, variant)
-    for ____, jsonRoom in ipairs(jsonRooms) do
-        local roomVariantString = jsonRoom["$"].variant
-        local roomVariant = tonumber(roomVariantString)
-        if roomVariant == variant then
-            return jsonRoom
+    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
-    return nil
+    return error(((("Found " .. tostring(#jsonRoomsOfVariant)) .. " JSON rooms with a variant of ") .. tostring(variant)) .. ", when there should only be 1.")
 end
 function ____exports.getJSONRoomsOfSubType(self, jsonRooms, subType)
-    local jsonRoomsOfSubType = {}
-    for ____, jsonRoom in ipairs(jsonRooms) do
-        local roomSubTypeString = jsonRoom["$"].subtype
-        local roomSubType = tonumber(roomSubTypeString)
-        if roomSubType == subType then
-            __TS__ArrayPush(jsonRoomsOfSubType, jsonRoom)
+    return __TS__ArrayFilter(
+        jsonRooms,
+        function(____, jsonRoom)
+            local roomSubTypeString = jsonRoom["$"].subtype
+            local roomSubType = tonumber(roomSubTypeString)
+            return roomSubType == subType
         end
-    end
-    return jsonRoomsOfSubType
+    )
 end
 function ____exports.getRandomJSONRoom(self, jsonRooms, seed, verbose)
     if seed == nil then
@@ -67,7 +76,7 @@ function ____exports.getRandomJSONRoom(self, jsonRooms, seed, verbose)
     end
     local chosenWeight = getRandomFloat(nil, 0, totalWeight, seed)
     if verbose then
-        log("Randomly chose weight: " .. tostring(chosenWeight))
+        log("Randomly chose weight for JSON room: " .. tostring(chosenWeight))
     end
     return getJSONRoomWithChosenWeight(nil, jsonRooms, chosenWeight)
 end

package/dist/functions/log.d.ts

@@ -24,15 +24,15 @@ export declare function logAllGameStateFlags(this: void): void;
  * Helper function for printing out every projectile flag that is turned on. Helpful when debugging.
  */
 export declare function logAllProjectileFlags(this: void, flags: int): void;
-/** Helper function for printing out every use flag that is turned on. Helpful when debugging. */
-export declare function logAllTearFlags(this: void, flags: int): void;
-/** Helper function for printing out every use flag that is turned on. Helpful when debugging. */
-export declare function logAllUseFlags(this: void, flags: int): void;
 /**
  * Helper function for printing out every seed effect (i.e. Easter Egg) that is turned on for the
  * particular run.
  */
 export declare function logAllSeedEffects(this: void): void;
+/** Helper function for printing out every use flag that is turned on. Helpful when debugging. */
+export declare function logAllTearFlags(this: void, flags: int): void;
+/** Helper function for printing out every use flag that is turned on. Helpful when debugging. */
+export declare function logAllUseFlags(this: void, flags: int): void;
 export declare function logArray<T>(this: void, array: T[]): void;
 export declare function logColor(this: void, color: Color): void;
 export declare function logEntity(this: void, entity: Entity): void;

package/dist/functions/log.lua

@@ -38,11 +38,9 @@ function ____exports.logAllFlags(flags, flagEnum, description)
     ____exports.log(("Logging all " .. description) .. "flags:")
     local hasNoFlags = true
     local i = 1
-    for ____, ____value in ipairs(__TS__ObjectEntries(flagEnum)) do
-        local key = ____value[1]
-        local value = ____value[2]
+    for key, value in pairs(flagEnum) do
         if hasFlag(nil, flags, value) then
-            ____exports.log(((((("  " .. tostring(i)) .. ") Has flag: ") .. key) .. " (") .. tostring(value)) .. ")")
+            ____exports.log(((((("  " .. tostring(i)) .. ") Has flag: ") .. tostring(key)) .. " (") .. tostring(value)) .. ")")
             hasNoFlags = false
         end
         i = i + 1
@@ -62,9 +60,7 @@ function ____exports.logAllGameStateFlags()
     ____exports.log("Logging all game state flags:")
     local hasNoFlags = true
     local i = 1
-    for ____, ____value in ipairs(__TS__ObjectEntries(GameStateFlag)) do
-        local key = ____value[1]
-        local value = ____value[2]
+    for key, value in pairs(GameStateFlag) do
         local gameStateFlag = value
         local flagValue = game:GetStateFlag(gameStateFlag)
         if flagValue then
@@ -80,21 +76,13 @@ end
 function ____exports.logAllProjectileFlags(flags)
     ____exports.logAllFlags(flags, ProjectileFlags, "projectile")
 end
-function ____exports.logAllTearFlags(flags)
-    ____exports.logAllFlags(flags, TearFlags, "tear")
-end
-function ____exports.logAllUseFlags(flags)
-    ____exports.logAllFlags(flags, UseFlag, "use")
-end
 function ____exports.logAllSeedEffects()
     local game = Game()
     local seeds = game:GetSeeds()
     ____exports.log("Logging all seed effects:")
     local hasNoSeedEffects = true
     local i = 1
-    for ____, ____value in ipairs(__TS__ObjectEntries(SeedEffect)) do
-        local key = ____value[1]
-        local value = ____value[2]
+    for key, value in pairs(SeedEffect) do
         local seedEffect = value
         if seeds:HasSeedEffect(seedEffect) then
             ____exports.log(((((("  " .. tostring(i)) .. ") ") .. key) .. " (") .. tostring(value)) .. ")")
@@ -106,6 +94,12 @@ function ____exports.logAllSeedEffects()
         ____exports.log("  n/a (no seed effects)")
     end
 end
+function ____exports.logAllTearFlags(flags)
+    ____exports.logAllFlags(flags, TearFlags, "tear")
+end
+function ____exports.logAllUseFlags(flags)
+    ____exports.logAllFlags(flags, UseFlag, "use")
+end
 function ____exports.logArray(array)
     local arrayString = arrayToString(nil, array)
     ____exports.log("Array: " .. arrayString)
@@ -148,7 +142,7 @@ function ____exports.logTemporaryEffects(player)
             do
                 local effect = effectsList:Get(i)
                 if effect == nil then
-                    goto __continue39
+                    goto __continue36
                 end
                 if effect.Item:IsCollectible() then
                     local collectibleName = getCollectibleName(nil, effect.Item.ID)
@@ -162,7 +156,7 @@ function ____exports.logTemporaryEffects(player)
                     ____exports.log((("  " .. tostring(i + 1)) .. ") Unknown type of temporary effect: ") .. tostring(effect.Item.ID))
                 end
             end
-            ::__continue39::
+            ::__continue36::
             i = i + 1
         end
     end
@@ -185,6 +179,8 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logAllFlags = ____exports.logAllFlags
     globals.logAllGameStateFlags = ____exports.logAllGameStateFlags
     globals.logAllProjectileFlags = ____exports.logAllProjectileFlags
+    globals.logAllSeedEffects = ____exports.logAllSeedEffects
+    globals.logAllTearFlags = ____exports.logAllTearFlags
     globals.logAllUseFlags = ____exports.logAllUseFlags
     globals.logArray = ____exports.logArray
     globals.logColor = ____exports.logColor
@@ -192,6 +188,7 @@ function ____exports.setLogFunctionsGlobal(self)
     globals.logKColor = ____exports.logKColor
     globals.logMap = ____exports.logMap
     globals.logTable = ____exports.logTable
+    globals.logTemporaryEffects = ____exports.logTemporaryEffects
     globals.logSet = ____exports.logSet
     globals.logVector = ____exports.logVector
 end

package/dist/functions/npc.lua

@@ -9,14 +9,12 @@ local getEntities = ____entity.getEntities
 local getFilteredNewEntities = ____entity.getFilteredNewEntities
 local getProjectiles = ____entity.getProjectiles
 local removeEntities = ____entity.removeEntities
-function ____exports.getBosses(self)
-    local bosses = {}
-    for ____, npc in ipairs(____exports.getNPCs(nil)) do
-        if npc:IsBoss() then
-            __TS__ArrayPush(bosses, npc)
-        end
-    end
-    return bosses
+function ____exports.getAliveNPCs(self)
+    local npcs = ____exports.getNPCs(nil)
+    return __TS__ArrayFilter(
+        npcs,
+        function(____, npc) return not npc:IsDead() and not ____exports.isAliveExceptionNPC(nil, npc) end
+    )
 end
 function ____exports.getNPCs(self, matchingEntityType, matchingVariant, matchingSubType, ignoreFriendly)
     if ignoreFriendly == nil then
@@ -92,22 +90,18 @@ function ____exports.fireProjectiles(self, npc, position, velocity, projectilesM
     return getFilteredNewEntities(nil, oldProjectiles, newProjectiles)
 end
 function ____exports.getAliveBosses(self)
-    local aliveBosses = {}
-    for ____, boss in ipairs(____exports.getBosses(nil)) do
-        if not boss:IsDead() and not ____exports.isAliveExceptionNPC(nil, boss) then
-            __TS__ArrayPush(aliveBosses, boss)
-        end
-    end
-    return aliveBosses
+    local aliveNPCs = ____exports.getAliveNPCs(nil)
+    return __TS__ArrayFilter(
+        aliveNPCs,
+        function(____, aliveNPC) return aliveNPC:IsBoss() end
+    )
 end
-function ____exports.getAliveNPCs(self)
-    local aliveNPCs = {}
-    for ____, npc in ipairs(____exports.getNPCs(nil)) do
-        if not npc:IsDead() and not ____exports.isAliveExceptionNPC(nil, npc) then
-            __TS__ArrayPush(aliveNPCs, npc)
-        end
-    end
-    return aliveNPCs
+function ____exports.getBosses(self)
+    local npcs = ____exports.getNPCs(nil)
+    return __TS__ArrayFilter(
+        npcs,
+        function(____, npc) return npc:IsBoss() end
+    )
 end
 function ____exports.removeAllNPCs(self, cap)
     local npcs = ____exports.getNPCs(nil)

package/dist/functions/player.d.ts

@@ -25,7 +25,7 @@ export declare function anyPlayerHasTrinket(trinketType: TrinketType | int): boo
  * This function is variadic, meaning that you can supply as many characters as you want to check
  * for. Returns true if any of the characters supplied are present.
  */
-export declare function anyPlayerIs(...characters: PlayerType[]): boolean;
+export declare function anyPlayerIs(...matchingCharacters: PlayerType[]): boolean;
 /**
  * Helper function to determine if the provided character can have red heart containers. Returns
  * true for characters like Isaac, Magdalene, or Cain. Returns true for Keeper and Tainted Keeper,
@@ -83,6 +83,8 @@ export declare function getPlayerAvailableHeartSlots(player: EntityPlayer): int;
  * Kiss; use the `getPlayerMaxHeartContainers()` function for that.
  */
 export declare function getCharacterMaxHeartContainers(character: PlayerType): int;
+/** Helper function to get an array containing the characters of all of the current players. */
+export declare function getCharacters(): number[];
 /**
  * Iterates over all players and checks if any are close enough to the specified position.
  *