isaacscript-common 1.2.291 → 2.0.1

package/dist/functions/flag.lua

@@ -1,29 +1,47 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local DamageFlag = ____isaac_2Dtypescript_2Ddefinitions.DamageFlag
 function ____exports.addFlag(self, flags, ...)
-    local flag = {...}
-    for ____, f in ipairs(flag) do
-        flags = flags | f
+    local flagsToAdd = {...}
+    local flagsAsInt = flags
+    for ____, flagToAdd in ipairs(flagsToAdd) do
+        flagsAsInt = flagsAsInt | flagToAdd
     end
-    return flags
+    return flagsAsInt
+end
+function ____exports.bitFlags(self, flag)
+    return flag
+end
+function ____exports.getFlagName(self, flag, flagEnum)
+    for key, value in pairs(flagEnum) do
+        if value == flag then
+            return key
+        end
+    end
+    return nil
 end
 function ____exports.hasFlag(self, flags, ...)
-    local flag = {...}
-    for ____, f in ipairs(flag) do
-        if not (flags & f == f) then
+    local flagsToCheck = {...}
+    local flagsAsInt = flags
+    for ____, flagToCheck in ipairs(flagsToCheck) do
+        if not (flagsAsInt & flagToCheck == flagToCheck) then
             return false
         end
     end
     return true
 end
+function ____exports.isEmptyFlag(self, flag)
+    return flag == 0
+end
 function ____exports.isSelfDamage(self, damageFlags)
-    return ____exports.hasFlag(nil, damageFlags, DamageFlag.DAMAGE_NO_PENALTIES) or ____exports.hasFlag(nil, damageFlags, DamageFlag.DAMAGE_RED_HEARTS)
+    return ____exports.hasFlag(nil, damageFlags, DamageFlag.NO_PENALTIES) or ____exports.hasFlag(nil, damageFlags, DamageFlag.RED_HEARTS)
 end
 function ____exports.removeFlag(self, flags, ...)
-    local flag = {...}
-    for ____, f in ipairs(flag) do
-        flags = flags & ~f
+    local flagsToRemove = {...}
+    local flagsAsInt = flags
+    for ____, flagToRemove in ipairs(flagsToRemove) do
+        flagsAsInt = flagsAsInt & ~flagToRemove
     end
-    return flags
+    return flagsAsInt
 end
 return ____exports

package/dist/functions/flying.d.ts

@@ -1,7 +1,7 @@
-/// <reference types="isaac-typescript-definitions" />
+import { CollectibleType } from "isaac-typescript-definitions";
 /**
  * Returns a set of all of the collectibles that grant flight. This is derived from collectibles
- * that have `CacheFlag.CACHE_FLYING` set in the "items.xml" file.
+ * that have `CacheFlag.FLYING` set in the "items.xml" file.
  *
  * Collectibles that only grant flight conditionally are manually pruned. Collectibles such as Empty
  * Vessel should be checked for via the `hasFlyingTemporaryEffect` function.

package/dist/functions/flying.lua

@@ -3,30 +3,36 @@ local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
 local __TS__Iterator = ____lualib.__TS__Iterator
 local ____exports = {}
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local CacheFlag = ____isaac_2Dtypescript_2Ddefinitions.CacheFlag
+local CollectibleType = ____isaac_2Dtypescript_2Ddefinitions.CollectibleType
+local NullItemID = ____isaac_2Dtypescript_2Ddefinitions.NullItemID
+local PlayerType = ____isaac_2Dtypescript_2Ddefinitions.PlayerType
+local TrinketType = ____isaac_2Dtypescript_2Ddefinitions.TrinketType
 local ____collectibleCacheFlag = require("functions.collectibleCacheFlag")
 local getCollectiblesForCacheFlag = ____collectibleCacheFlag.getCollectiblesForCacheFlag
 local ____set = require("functions.set")
 local copySet = ____set.copySet
 local deleteSetsFromSet = ____set.deleteSetsFromSet
 local FLYING_CHARACTERS = __TS__New(Set, {
-    PlayerType.PLAYER_AZAZEL,
-    PlayerType.PLAYER_THELOST,
-    PlayerType.PLAYER_THESOUL,
-    PlayerType.PLAYER_THELOST_B,
-    PlayerType.PLAYER_JACOB2_B,
-    PlayerType.PLAYER_THESOUL_B
+    PlayerType.AZAZEL,
+    PlayerType.THE_LOST,
+    PlayerType.THE_SOUL,
+    PlayerType.THE_LOST_B,
+    PlayerType.JACOB_2_B,
+    PlayerType.THE_SOUL_B
 })
-local FLYING_TRINKETS = __TS__New(Set, {TrinketType.TRINKET_BAT_WING, TrinketType.TRINKET_AZAZELS_STUMP})
-local FLYING_NULL_ITEMS = {NullItemID.ID_REVERSE_SUN, NullItemID.ID_SPIRIT_SHACKLES_SOUL, NullItemID.ID_LOST_CURSE}
+local FLYING_TRINKETS = __TS__New(Set, {TrinketType.BAT_WING, TrinketType.AZAZELS_STUMP})
+local FLYING_NULL_ITEMS = {NullItemID.REVERSE_SUN, NullItemID.SPIRIT_SHACKLES_SOUL, NullItemID.LOST_CURSE}
+local CONDITIONAL_FLYING_COLLECTIBLE_TYPES = {CollectibleType.BIBLE, CollectibleType.EMPTY_VESSEL, CollectibleType.ASTRAL_PROJECTION, CollectibleType.RECALL}
 function ____exports.getFlyingCollectibles(self, pruneConditionalItems)
-    local collectiblesWithFlyingCacheFlag = getCollectiblesForCacheFlag(nil, CacheFlag.CACHE_FLYING)
-    local collectiblesWithAllCacheFlag = getCollectiblesForCacheFlag(nil, CacheFlag.CACHE_ALL)
+    local collectiblesWithFlyingCacheFlag = getCollectiblesForCacheFlag(nil, CacheFlag.FLYING)
+    local collectiblesWithAllCacheFlag = getCollectiblesForCacheFlag(nil, CacheFlag.ALL)
     deleteSetsFromSet(nil, collectiblesWithFlyingCacheFlag, collectiblesWithAllCacheFlag)
     if pruneConditionalItems then
-        collectiblesWithFlyingCacheFlag:delete(CollectibleType.COLLECTIBLE_BIBLE)
-        collectiblesWithFlyingCacheFlag:delete(CollectibleType.COLLECTIBLE_EMPTY_VESSEL)
-        collectiblesWithFlyingCacheFlag:delete(CollectibleType.COLLECTIBLE_ASTRAL_PROJECTION)
-        collectiblesWithFlyingCacheFlag:delete(CollectibleType.COLLECTIBLE_RECALL)
+        for ____, collectibleType in ipairs(CONDITIONAL_FLYING_COLLECTIBLE_TYPES) do
+            collectiblesWithFlyingCacheFlag:delete(collectibleType)
+        end
     end
     return collectiblesWithFlyingCacheFlag
 end

package/dist/functions/globals.lua

@@ -5,14 +5,17 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local __TS__ArrayForEach = ____lualib.__TS__ArrayForEach
 local ____exports = {}
 local twoDimensionalSort
+local ____debug = require("functions.debug")
+local isLuaDebugEnabled = ____debug.isLuaDebugEnabled
 local ____log = require("functions.log")
 local log = ____log.log
 local ____set = require("functions.set")
 local addSetsToSet = ____set.addSetsToSet
 local copySet = ____set.copySet
-local ____utils = require("functions.utils")
-local isLuaDebugEnabled = ____utils.isLuaDebugEnabled
 function twoDimensionalSort(self, a, b)
+    if a[1] == nil or b[1] == nil then
+        error("Failed to two-dimensional sort since the first element of the array was undefined.")
+    end
     if a[1] == b[1] then
         return 0
     end

package/dist/functions/gridEntity.d.ts

@@ -1,8 +1,8 @@
-/// <reference types="isaac-typescript-definitions" />
+import { GridEntityType } from "isaac-typescript-definitions";
 /**
  * Helper function to convert the grid entity type found in a room XML file to the corresponding
  * grid entity type and variant normally used by the game. For example, a rock is represented as
- * 1000.0 in a room XML file, but `GridEntityType.GRID_ROCK` is equal to 2.
+ * 1000.0 in a room XML file, but `GridEntityType.ROCK` is equal to 2.
  */
 export declare function convertXMLGridEntityType(gridEntityXMLType: int, gridEntityXMLVariant: int): [int, int] | undefined;
 /**
@@ -29,9 +29,9 @@ export declare function getCollidingEntitiesWithGridEntity(gridEntity: GridEntit
  * Example:
  * ```ts
  * const rocks = getGridEntities(
- *   GridEntityType.GRID_ROCK,
- *   GridEntityType.GRID_ROCKB,
- *   GridEntityType.GRID_ROCKT,
+ *   GridEntityType.ROCK,
+ *   GridEntityType.BLOCK,
+ *   GridEntityType.ROCK_TINTED,
  * );
  * ```
  */
@@ -44,11 +44,13 @@ export declare function getGridEntities(...gridEntityTypes: GridEntityType[]): G
  * arguments to match specific grid entity types.
  */
 export declare function getGridEntitiesMap(...gridEntityTypes: GridEntityType[]): Map<int, GridEntity>;
+/** Helper function to return a string containing the grid entity's type and variant. */
+export declare function getGridEntityID(gridEntity: GridEntity): string;
 export declare function getSurroundingGridEntities(gridEntity: GridEntity): GridEntity[];
 export declare function getTopLeftWall(): GridEntity | undefined;
 /**
- * Helper function to get the grid index of the top left wall.
- * (This will depend on what the current room shape is.)
+ * Helper function to get the grid index of the top left wall. (This will depend on what the current
+ * room shape is.)
  */
 export declare function getTopLeftWallGridIndex(): int;
 /**
@@ -61,8 +63,8 @@ export declare function isGridEntityBreakableByExplosion(gridEntity: GridEntity)
  * Helper function to see if the provided gridEntity is in its respective broken state. See the
  * `GRID_ENTITY_TYPE_TO_BROKEN_STATE_MAP` constant for more details.
  *
- * Note that in the case of `GridEntityType.GRID_LOCK` (11), the state will turn to being broken
- * before the actual collision for the entity is removed.
+ * Note that in the case of `GridEntityType.LOCK` (11), the state will turn to being broken before
+ * the actual collision for the entity is removed.
  */
 export declare function isGridEntityBroken(gridEntity: GridEntity): boolean;
 /**
@@ -78,8 +80,8 @@ export declare function isPostBossVoidPortal(gridEntity: GridEntity): boolean;
  * Example:
  * ```ts
  * removeAllGridEntitiesExceptFor(
- *   GridEntityType.GRID_WALL,
- *   GridEntityType.GRID_DOOR,
+ *   GridEntityType.WALL,
+ *   GridEntityType.DOOR,
  * );
  * ```
  *
@@ -93,9 +95,9 @@ export declare function removeAllGridExcept(...gridEntityTypes: GridEntityType[]
  * Example:
  * ```ts
  * removeAllMatchingGridEntities(
- *   GridEntityType.GRID_ROCK,
- *   GridEntityType.GRID_ROCKB,
- *   GridEntityType.GRID_ROCKT,
+ *   GridEntityType.ROCK,
+ *   GridEntityType.BLOCK,
+ *   GridEntityType.ROCK_TINTED,
  * );
  * ```
  *
@@ -114,8 +116,8 @@ export declare function removeAllMatchingGridEntities(...gridEntityType: GridEnt
  */
 export declare function removeGrid(gridEntity: GridEntity, updateRoom?: boolean): void;
 /**
- * Helper function to make a grid entity invisible. This is accomplished by setting its sprite to
- * an empty/missing PNG file.
+ * Helper function to make a grid entity invisible. This is accomplished by setting its sprite to an
+ * empty/missing PNG file.
  *
  * For more information, see the documentation for the `clearSprite` helper function.
  */

package/dist/functions/gridEntity.lua

@@ -6,6 +6,14 @@ local Map = ____lualib.Map
 local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
 local getAllGridEntities
+local ____isaac_2Dtypescript_2Ddefinitions = require("isaac-typescript-definitions")
+local EntityType = ____isaac_2Dtypescript_2Ddefinitions.EntityType
+local GridCollisionClass = ____isaac_2Dtypescript_2Ddefinitions.GridCollisionClass
+local GridEntityType = ____isaac_2Dtypescript_2Ddefinitions.GridEntityType
+local PoopGridEntityVariant = ____isaac_2Dtypescript_2Ddefinitions.PoopGridEntityVariant
+local PressurePlateState = ____isaac_2Dtypescript_2Ddefinitions.PressurePlateState
+local StatueVariant = ____isaac_2Dtypescript_2Ddefinitions.StatueVariant
+local TrapdoorVariant = ____isaac_2Dtypescript_2Ddefinitions.TrapdoorVariant
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
 local ____constants = require("constants")
@@ -18,8 +26,8 @@ local ____roomShapeToTopLeftWallGridIndexMap = require("maps.roomShapeToTopLeftW
 local DEFAULT_TOP_LEFT_WALL_GRID_INDEX = ____roomShapeToTopLeftWallGridIndexMap.DEFAULT_TOP_LEFT_WALL_GRID_INDEX
 local ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP = ____roomShapeToTopLeftWallGridIndexMap.ROOM_SHAPE_TO_TOP_LEFT_WALL_GRID_INDEX_MAP
 local ____math = require("functions.math")
+local erange = ____math.erange
 local isCircleIntersectingRectangle = ____math.isCircleIntersectingRectangle
-local range = ____math.range
 local ____rooms = require("functions.rooms")
 local roomUpdateSafe = ____rooms.roomUpdateSafe
 local ____sprite = require("functions.sprite")
@@ -30,7 +38,7 @@ function getAllGridEntities(self)
     local room = game:GetRoom()
     local gridSize = room:GetGridSize()
     local gridEntities = {}
-    for ____, gridIndex in ipairs(range(nil, gridSize - 1)) do
+    for ____, gridIndex in ipairs(erange(nil, gridSize)) do
         local gridEntity = room:GetGridEntity(gridIndex)
         if gridEntity ~= nil then
             gridEntities[#gridEntities + 1] = gridEntity
@@ -72,35 +80,35 @@ function ____exports.spawnGridWithVariant(self, gridEntityType, variant, gridInd
     if gridEntity == nil then
         return gridEntity
     end
-    if gridEntityType == GridEntityType.GRID_PIT then
+    if gridEntityType == GridEntityType.PIT then
         local pit = gridEntity:ToPit()
         if pit ~= nil then
             pit:UpdateCollision()
         end
-    elseif gridEntityType == GridEntityType.GRID_WALL then
-        gridEntity.CollisionClass = GridCollisionClass.COLLISION_WALL
+    elseif gridEntityType == GridEntityType.WALL then
+        gridEntity.CollisionClass = GridCollisionClass.WALL
     end
     return gridEntity
 end
 local BREAKABLE_GRID_ENTITY_TYPES_BY_EXPLOSIONS = __TS__New(Set, {
-    GridEntityType.GRID_ROCK,
-    GridEntityType.GRID_ROCKT,
-    GridEntityType.GRID_ROCK_BOMB,
-    GridEntityType.GRID_ROCK_ALT,
-    GridEntityType.GRID_SPIDERWEB,
-    GridEntityType.GRID_TNT,
-    GridEntityType.GRID_POOP,
-    GridEntityType.GRID_ROCK_SS,
-    GridEntityType.GRID_ROCK_SPIKED,
-    GridEntityType.GRID_ROCK_ALT2,
-    GridEntityType.GRID_ROCK_GOLD
+    GridEntityType.ROCK,
+    GridEntityType.ROCK_TINTED,
+    GridEntityType.ROCK_BOMB,
+    GridEntityType.ROCK_ALT,
+    GridEntityType.SPIDER_WEB,
+    GridEntityType.TNT,
+    GridEntityType.POOP,
+    GridEntityType.ROCK_SUPER_SPECIAL,
+    GridEntityType.ROCK_SPIKED,
+    GridEntityType.ROCK_ALT_2,
+    GridEntityType.ROCK_GOLD
 })
 local BREAKABLE_GRID_ENTITY_TYPES_VARIANTS_BY_EXPLOSIONS = __TS__New(
     Set,
-    {(tostring(GridEntityType.GRID_STATUE) .. ".") .. 1}
+    {(tostring(GridEntityType.STATUE) .. ".") .. tostring(StatueVariant.ANGEL)}
 )
 function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntityXMLVariant)
-    if gridEntityXMLType == EntityType.ENTITY_TRIGGER_OUTPUT then
+    if gridEntityXMLType == EntityType.TRIGGER_OUTPUT then
         return nil
     end
     local gridEntityArray = GRID_ENTITY_XML_MAP:get(gridEntityXMLType)
@@ -109,7 +117,7 @@ function ____exports.convertXMLGridEntityType(self, gridEntityXMLType, gridEntit
     end
     local gridEntityType = gridEntityArray[1]
     local gridEntityVariant = gridEntityArray[2]
-    if gridEntityType == GridEntityType.GRID_SPIKES_ONOFF or gridEntityType == GridEntityType.GRID_PRESSURE_PLATE or gridEntityType == GridEntityType.GRID_TELEPORTER then
+    if gridEntityType == GridEntityType.SPIKES_ON_OFF or gridEntityType == GridEntityType.PRESSURE_PLATE or gridEntityType == GridEntityType.TELEPORTER then
         gridEntityVariant = gridEntityXMLVariant
     end
     return {gridEntityType, gridEntityVariant}
@@ -153,6 +161,11 @@ function ____exports.getGridEntitiesMap(self, ...)
     end
     return gridEntityMap
 end
+function ____exports.getGridEntityID(self, gridEntity)
+    local gridEntityType = gridEntity:GetType()
+    local gridEntityVariant = gridEntity:GetVariant()
+    return (tostring(gridEntityType) .. ".") .. tostring(gridEntityVariant)
+end
 function ____exports.getSurroundingGridEntities(self, gridEntity)
     local room = game:GetRoom()
     local gridWidth = room:GetGridWidth()
@@ -187,10 +200,10 @@ function ____exports.isAllPressurePlatesPushed(self)
     if not hasPressurePlates then
         return true
     end
-    local pressurePlates = ____exports.getGridEntities(nil, GridEntityType.GRID_PRESSURE_PLATE)
+    local pressurePlates = ____exports.getGridEntities(nil, GridEntityType.PRESSURE_PLATE)
     return __TS__ArrayEvery(
         pressurePlates,
-        function(____, pressurePlate) return pressurePlate.State == 3 end
+        function(____, pressurePlate) return pressurePlate.State == PressurePlateState.PRESSURE_PLATE_PRESSED end
     )
 end
 function ____exports.isGridEntityBreakableByExplosion(self, gridEntity)
@@ -246,16 +259,16 @@ function ____exports.spawnGiantPoop(self, topLeftGridIndex)
     local topRightGridIndex = topLeftGridIndex + 1
     local bottomLeftGridIndex = topLeftGridIndex + gridWidth
     local bottomRightGridIndex = bottomLeftGridIndex + 1
-    ____exports.spawnGridWithVariant(nil, GridEntityType.GRID_POOP, 7, topLeftGridIndex)
-    ____exports.spawnGridWithVariant(nil, GridEntityType.GRID_POOP, 8, topRightGridIndex)
-    ____exports.spawnGridWithVariant(nil, GridEntityType.GRID_POOP, 9, bottomLeftGridIndex)
-    ____exports.spawnGridWithVariant(nil, GridEntityType.GRID_POOP, 10, bottomRightGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_TOP_LEFT, topLeftGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_TOP_RIGHT, topRightGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_BOTTOM_LEFT, bottomLeftGridIndex)
+    ____exports.spawnGridWithVariant(nil, GridEntityType.POOP, PoopGridEntityVariant.GIGA_BOTTOM_RIGHT, bottomRightGridIndex)
 end
 function ____exports.spawnGrid(self, gridEntityType, gridIndexOrPosition)
     return ____exports.spawnGridWithVariant(nil, gridEntityType, 0, gridIndexOrPosition)
 end
 function ____exports.spawnVoidPortal(self, gridIndex)
-    local voidPortal = ____exports.spawnGridWithVariant(nil, GridEntityType.GRID_TRAPDOOR, 1, gridIndex)
+    local voidPortal = ____exports.spawnGridWithVariant(nil, GridEntityType.TRAPDOOR, TrapdoorVariant.VOID_PORTAL, gridIndex)
     if voidPortal == nil then
         return voidPortal
     end

package/dist/functions/input.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="isaac-typescript-definitions" />
+import { ButtonAction, Controller, Keyboard } from "isaac-typescript-definitions";
 /** Helper function to get the enum name for the specified `Controller` value. */
 export declare function controllerToString(controller: Controller): string;
 export declare function getMoveActions(): Set<ButtonAction>;
@@ -10,12 +10,22 @@ export declare function isActionPressedOnAnyInput(buttonAction: ButtonAction): b
  * then released).
  */
 export declare function isActionTriggeredOnAnyInput(buttonAction: ButtonAction): boolean;
-export declare function isKeyboardPressed(key: Keyboard): boolean;
+/**
+ * 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.
+ */
+export declare function isKeyboardPressed(...keys: Keyboard[]): boolean;
+/**
+ * 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.
+ */
+export declare function isModifierKeyPressed(): boolean;
 export declare function isMoveAction(buttonAction: ButtonAction): boolean;
 export declare function isMoveActionPressedOnAnyInput(): boolean;
 export declare function isMoveActionTriggeredOnAnyInput(): boolean;
 export declare function isShootAction(buttonAction: ButtonAction): boolean;
 export declare function isShootActionPressedOnAnyInput(): boolean;
 export declare function isShootActionTriggeredOnAnyInput(): boolean;
-/** Helper function to get the enum name for the specified `Keyboard` value. */
-export declare function keyboardToString(keyboard: Keyboard): string;

package/dist/functions/input.lua

@@ -1,81 +1,41 @@
 local ____lualib = require("lualib_bundle")
 local Set = ____lualib.Set
 local __TS__New = ____lualib.__TS__New
-local __TS__StringReplace = ____lualib.__TS__StringReplace
-local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local __TS__ArraySome = ____lualib.__TS__ArraySome
-local __TS__StringSlice = ____lualib.__TS__StringSlice
 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 ____constants = require("constants")
 local MAX_NUM_INPUTS = ____constants.MAX_NUM_INPUTS
 local ____math = require("functions.math")
-local range = ____math.range
+local erange = ____math.erange
 local ____set = require("functions.set")
 local copySet = ____set.copySet
-local ControllerLiteral = ControllerLiteral or ({})
-ControllerLiteral.DPAD_LEFT = 0
-ControllerLiteral[ControllerLiteral.DPAD_LEFT] = "DPAD_LEFT"
-ControllerLiteral.DPAD_RIGHT = 1
-ControllerLiteral[ControllerLiteral.DPAD_RIGHT] = "DPAD_RIGHT"
-ControllerLiteral.DPAD_UP = 2
-ControllerLiteral[ControllerLiteral.DPAD_UP] = "DPAD_UP"
-ControllerLiteral.DPAD_DOWN = 3
-ControllerLiteral[ControllerLiteral.DPAD_DOWN] = "DPAD_DOWN"
-ControllerLiteral.BUTTON_A = 4
-ControllerLiteral[ControllerLiteral.BUTTON_A] = "BUTTON_A"
-ControllerLiteral.BUTTON_B = 5
-ControllerLiteral[ControllerLiteral.BUTTON_B] = "BUTTON_B"
-ControllerLiteral.BUTTON_X = 6
-ControllerLiteral[ControllerLiteral.BUTTON_X] = "BUTTON_X"
-ControllerLiteral.BUTTON_Y = 7
-ControllerLiteral[ControllerLiteral.BUTTON_Y] = "BUTTON_Y"
-ControllerLiteral.BUMPER_LEFT = 8
-ControllerLiteral[ControllerLiteral.BUMPER_LEFT] = "BUMPER_LEFT"
-ControllerLiteral.TRIGGER_LEFT = 9
-ControllerLiteral[ControllerLiteral.TRIGGER_LEFT] = "TRIGGER_LEFT"
-ControllerLiteral.STICK_LEFT = 10
-ControllerLiteral[ControllerLiteral.STICK_LEFT] = "STICK_LEFT"
-ControllerLiteral.BUMPER_RIGHT = 11
-ControllerLiteral[ControllerLiteral.BUMPER_RIGHT] = "BUMPER_RIGHT"
-ControllerLiteral.TRIGGER_RIGHT = 12
-ControllerLiteral[ControllerLiteral.TRIGGER_RIGHT] = "TRIGGER_RIGHT"
-ControllerLiteral.STICK_RIGHT = 13
-ControllerLiteral[ControllerLiteral.STICK_RIGHT] = "STICK_RIGHT"
-ControllerLiteral.BUTTON_BACK = 14
-ControllerLiteral[ControllerLiteral.BUTTON_BACK] = "BUTTON_BACK"
-ControllerLiteral.BUTTON_START = 15
-ControllerLiteral[ControllerLiteral.BUTTON_START] = "BUTTON_START"
-local MOVEMENT_ACTIONS = {ButtonAction.ACTION_LEFT, ButtonAction.ACTION_RIGHT, ButtonAction.ACTION_UP, ButtonAction.ACTION_DOWN}
+local ____string = require("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.ACTION_SHOOTLEFT, ButtonAction.ACTION_SHOOTRIGHT, ButtonAction.ACTION_SHOOTUP, ButtonAction.ACTION_SHOOTDOWN}
+local SHOOTING_ACTIONS = {ButtonAction.SHOOT_LEFT, ButtonAction.SHOOT_RIGHT, ButtonAction.SHOOT_UP, ButtonAction.SHOOT_DOWN}
 local SHOOTING_ACTIONS_SET = __TS__New(Set, SHOOTING_ACTIONS)
 function ____exports.controllerToString(self, controller)
-    for ____, ____value in ipairs(__TS__ObjectEntries(ControllerLiteral)) do
-        local key = ____value[1]
-        local controllerLiteralCode = ____value[2]
-        do
-            if type(key) ~= "string" then
-                goto __continue3
-            end
-            local controllerCode = controllerLiteralCode
-            if controllerCode ~= controller then
-                goto __continue3
-            end
-            local controllerName = key
-            for ____, prefix in ipairs({
-                "DPAD_",
-                "BUTTON_",
-                "BUMPER_",
-                "TRIGGER_",
-                "STICK_"
-            }) do
-                controllerName = __TS__StringReplace(controllerName, prefix, "")
-            end
-            return controllerName
-        end
-        ::__continue3::
+    local key = Controller[controller]
+    if key == nil then
+        return "unknown"
     end
-    return "unknown"
+    return trimPrefix(nil, key, "BUTTON_")
 end
 function ____exports.getMoveActions(self)
     return copySet(nil, MOVEMENT_ACTIONS_SET)
@@ -84,21 +44,31 @@ function ____exports.getShootActions(self)
     return copySet(nil, SHOOTING_ACTIONS_SET)
 end
 function ____exports.isActionPressedOnAnyInput(self, buttonAction)
-    local validInputs = range(nil, MAX_NUM_INPUTS - 1)
+    local validInputs = erange(nil, MAX_NUM_INPUTS)
     return __TS__ArraySome(
         validInputs,
         function(____, input) return Input.IsActionPressed(buttonAction, input) end
     )
 end
 function ____exports.isActionTriggeredOnAnyInput(self, buttonAction)
-    local validInputs = range(nil, MAX_NUM_INPUTS - 1)
+    local validInputs = erange(nil, MAX_NUM_INPUTS)
     return __TS__ArraySome(
         validInputs,
         function(____, input) return Input.IsActionTriggered(buttonAction, input) end
     )
 end
-function ____exports.isKeyboardPressed(self, key)
-    return Input.IsButtonPressed(key, 0)
+function ____exports.isKeyboardPressed(self, ...)
+    local keys = {...}
+    return __TS__ArraySome(
+        keys,
+        function(____, key) return Input.IsButtonPressed(key, ControllerIndex.KEYBOARD) end
+    )
+end
+function ____exports.isModifierKeyPressed(self)
+    return ____exports.isKeyboardPressed(
+        nil,
+        table.unpack(MODIFIER_KEYS)
+    )
 end
 function ____exports.isMoveAction(self, buttonAction)
     return MOVEMENT_ACTIONS_SET:has(buttonAction)
@@ -130,16 +100,4 @@ function ____exports.isShootActionTriggeredOnAnyInput(self)
         function(____, shootAction) return ____exports.isActionTriggeredOnAnyInput(nil, shootAction) end
     )
 end
-function ____exports.keyboardToString(self, keyboard)
-    for ____, ____value in ipairs(__TS__ObjectEntries(Keyboard)) do
-        local keyName = ____value[1]
-        local keyCode = ____value[2]
-        if keyCode == keyboard then
-            local withoutPrefix = __TS__StringSlice(keyName, #"KEY_")
-            local withoutUnderscores = string.gsub(withoutPrefix, "_", " ")
-            return withoutUnderscores
-        end
-    end
-    return "unknown"
-end
 return ____exports

package/dist/functions/jsonHelpers.d.ts

@@ -1,16 +1,18 @@
 /// <reference types="typescript-to-lua/language-extensions" />
 /**
  * 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.)
+ *
+ * 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.)
  */
 export declare function jsonDecode(jsonString: string): LuaTable<AnyNotNil, unknown>;
 /**
  * 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.
+ *
+ * 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.
  */
 export declare function jsonEncode(table: unknown): string;

package/dist/functions/jsonHelpers.lua

@@ -1,4 +1,3 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local json = require("@NoResolution:json")
 local ____log = require("functions.log")

package/dist/functions/kColor.lua

@@ -1,4 +1,3 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local OBJECT_NAME
 local ____SerializationBrand = require("enums.private.SerializationBrand")
@@ -42,7 +41,7 @@ function ____exports.copyKColor(self, kColor, serializationType)
                 end
                 local kColorTable = {}
                 copyValuesToTable(nil, kColor, KEYS, kColorTable)
-                kColorTable[SerializationBrand.KCOLOR] = ""
+                kColorTable[SerializationBrand.K_COLOR] = ""
                 return kColorTable
             end
         end
@@ -59,6 +58,18 @@ function ____exports.copyKColor(self, kColor, serializationType)
                     OBJECT_NAME,
                     table.unpack(KEYS)
                 ))
+                if r == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: r")
+                end
+                if g == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: g")
+                end
+                if b == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: b")
+                end
+                if a == nil then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object did not have a value for: a")
+                end
                 return KColor(r, g, b, a)
             end
         end
@@ -82,7 +93,7 @@ function ____exports.isSerializedKColor(self, object)
         nil,
         ____table,
         table.unpack(KEYS)
-    ) and ____table[SerializationBrand.KCOLOR] ~= nil
+    ) and ____table[SerializationBrand.K_COLOR] ~= nil
 end
 function ____exports.kColorEquals(self, kColor1, kColor2)
     return isaacAPIClassEquals(nil, kColor1, kColor2, KEYS)