isaacscript-common 1.2.200 → 1.2.203

package/dist/functions/random.d.ts

@@ -3,48 +3,48 @@
  * This returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on
  * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
  * will never return a value of exactly 1.)
+ *
+ * Note that this function will invoke the `Next` method on the `RNG` object before returning the
+ * random number.
  */
-export declare function getRandom(seed?: Seed): float;
+export declare function getRandom(rng?: RNG): float;
 /**
  * This returns a random float between min and max. It is inclusive on the low end, but exclusive on
  * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
  * will never return a value of exactly 1.)
  *
+ * Note that this function will invoke the `Next` method on the `RNG` object before returning the
+ * random number.
+ *
  * Example:
  * ```ts
- * const realNumberBetweenOneAndThree = getRandomFloat(1, 3, seed);
+ * const realNumberBetweenOneAndThree = getRandomFloat(1, 3);
  * ```
  */
-export declare function getRandomFloat(min: int, max: int, seed?: Seed): float;
+export declare function getRandomFloat(min: int, max: int, rng?: RNG): float;
 /**
- * This returns a random integer between min and max, inclusive.
- *
- * Example:
- * ```ts
- * const oneTwoOrThree = getRandomInt(1, 3, seed);
- * ```
+ * This returns a random float between min and max. It is inclusive on the low end, but exclusive on
+ * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
+ * will never return a value of exactly 1.)
+ */
+export declare function getRandomFloatFromSeed(min: int, max: int, seed: Seed): float;
+/**
+ * This returns a random float between 0 and 1. It is inclusive on the low end, but exclusive on
+ * the high end. (This is because the `RNG.RandomFloat` method can return a value of 0.999, but it
+ * will never return a value of exactly 1.)
  */
-export declare function getRandomInt(min: int, max: int, seed?: Seed): int;
+export declare function getRandomFromSeed(seed: Seed): float;
 /**
- * Helper function to initialize an RNG object.
+ * This returns a random integer between min and max. It is inclusive on both ends.
+ *
+ * Note that this function will invoke the `Next` method on the `RNG` object before returning the
+ * random number.
  *
  * Example:
  * ```ts
- * const startSeed = Game():GetSeeds():GetStartSeed();
- * const rng = initRNG(startSeed);
- * const fiftyFiftyChance = rng.RandomInt(2) === 0;
+ * const oneTwoOrThree = getRandomInt(1, 3);
  * ```
- *
- * It is recommended to not deal with RNG objects directly and instead use seeds. Also see the
- * `getRandom`, `getRandomInt`, and `getRandomFloat` helper functions.
- *
- * @param seed The seed to initialize it with. Default is `Random()`.
- */
-export declare function initRNG(seed?: Seed): RNG;
-/**
- * Helper function to get the next seed value.
- *
- * This function is useful because it is standard practice to work with seed values directly over
- * RNG objects, since the latter are not serializable.
  */
-export declare function nextSeed(seed: Seed): Seed;
+export declare function getRandomInt(min: int, max: int, rng?: RNG): int;
+/** This returns a random integer between min and max. It is inclusive on both ends. */
+export declare function getRandomIntFromSeed(min: int, max: int, seed: Seed): int;

package/dist/functions/random.lua

@@ -1,41 +1,47 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
-local RECOMMENDED_SHIFT_IDX
-function ____exports.initRNG(self, seed)
-    if seed == nil then
-        seed = Random()
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
+function ____exports.getRandom(self, rng)
+    if rng == nil then
+        rng = newRNG(nil)
     end
-    if seed == 0 then
-        error("You cannot initialize an RNG object with a seed of 0, or the game will crash.")
-    end
-    local rng = RNG()
-    rng:SetSeed(seed, RECOMMENDED_SHIFT_IDX)
-    return rng
-end
-RECOMMENDED_SHIFT_IDX = 35
-function ____exports.getRandom(self, seed)
-    if seed == nil then
-        seed = Random()
-    end
-    local rng = ____exports.initRNG(nil, seed)
     return rng:RandomFloat()
 end
-function ____exports.getRandomFloat(self, min, max, seed)
-    if seed == nil then
-        seed = Random()
+function ____exports.getRandomFloat(self, min, max, rng)
+    if rng == nil then
+        rng = newRNG(nil)
+    end
+    if min > max then
+        local oldMin = min
+        local oldMax = max
+        min = oldMax
+        max = oldMin
     end
-    return min + ____exports.getRandom(nil, seed) * (max - min)
+    return min + ____exports.getRandom(nil, rng) * (max - min)
 end
-function ____exports.getRandomInt(self, min, max, seed)
-    if seed == nil then
-        seed = Random()
+function ____exports.getRandomFloatFromSeed(self, min, max, seed)
+    local rng = newRNG(nil, seed)
+    return ____exports.getRandomFloat(nil, min, max, rng)
+end
+function ____exports.getRandomFromSeed(self, seed)
+    local rng = newRNG(nil, seed)
+    return ____exports.getRandom(nil, rng)
+end
+function ____exports.getRandomInt(self, min, max, rng)
+    if rng == nil then
+        rng = newRNG(nil)
+    end
+    if min > max then
+        local oldMin = min
+        local oldMax = max
+        min = oldMax
+        max = oldMin
     end
-    local rng = ____exports.initRNG(nil, seed)
     return rng:RandomInt(max - min + 1) + min
 end
-function ____exports.nextSeed(self, seed)
-    local rng = ____exports.initRNG(nil, seed)
-    rng:Next()
-    return rng:GetSeed()
+function ____exports.getRandomIntFromSeed(self, min, max, seed)
+    local rng = newRNG(nil, seed)
+    return ____exports.getRandomInt(nil, min, max, rng)
 end
 return ____exports

package/dist/functions/revive.lua

@@ -2,6 +2,9 @@
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local ____constants = require("constants")
+local MAX_TAINTED_SAMSON_BERSERK_CHARGE = ____constants.MAX_TAINTED_SAMSON_BERSERK_CHARGE
+local TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = ____constants.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
 local ____character = require("functions.character")
 local getCharacterDeathAnimationName = ____character.getCharacterDeathAnimationName
 local ____player = require("functions.player")
@@ -44,6 +47,10 @@ function ____exports.isDamageToPlayerFatal(self, player, damageAmount, damageSou
     if isBerserk then
         return false
     end
+    local berserkChargeAfterHit = player.SamsonBerserkCharge + TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE
+    if character == PlayerType.PLAYER_SAMSON_B and berserkChargeAfterHit >= MAX_TAINTED_SAMSON_BERSERK_CHARGE then
+        return false
+    end
     if ____exports.willReviveFromSpiritShackles(nil, player) then
         return false
     end

package/dist/functions/rng.d.ts

@@ -0,0 +1,44 @@
+/// <reference types="isaac-typescript-definitions" />
+/// <reference types="typescript-to-lua/language-extensions" />
+import { SerializationType } from "../enums/SerializationType";
+declare type SerializedRNG = LuaTable<string, string | number>;
+interface CopyRNGReturn {
+    [SerializationType.NONE]: RNG;
+    [SerializationType.SERIALIZE]: SerializedRNG;
+    [SerializationType.DESERIALIZE]: RNG;
+}
+/**
+ * Helper function to copy an `RNG` object.
+ *
+ * @param rng The RNG object to copy. In the case of deserialization, this will actually be a Lua
+ * table instead of an instantiated RNG class.
+ * @param serializationType Default is `SerializationType.NONE`.
+ */
+export declare function copyRNG<R extends RNG | SerializedRNG, S extends SerializationType>(rng: R, serializationType: S): CopyRNGReturn[S];
+/**
+ * Helper function to get a random `Seed` value to be used in spawning entities and so on. Use this
+ * instead of calling the `Random` function directly since that can return a value of 0 and crash
+ * the game.
+ */
+export declare function getRandomSeed(): Seed;
+/** Helper function to check if something is an instantiated RNG object. */
+export declare function isRNG(object: unknown): object is RNG;
+/**
+ * Used to determine is the given table is a serialized Vector created by the save data manager
+ * and/or the `deepCopy` function.
+ */
+export declare function isSerializedRNG(object: unknown): object is SerializedRNG;
+/**
+ * Helper function to initialize an RNG object using Blade's recommended shift index.
+ *
+ * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
+ */
+export declare function newRNG(seed?: Seed): RNG;
+/**
+ * Helper function to get the next seed value.
+ *
+ * This function is useful if you are working with data structures that store seed values instead of
+ * RNG objects.
+ */
+export declare function nextSeed(seed: Seed): Seed;
+export {};

package/dist/functions/rng.lua

@@ -0,0 +1,106 @@
+--[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____exports = {}
+local RECOMMENDED_SHIFT_IDX, OBJECT_NAME
+local ____SerializationBrand = require("enums.private.SerializationBrand")
+local SerializationBrand = ____SerializationBrand.SerializationBrand
+local ____SerializationType = require("enums.SerializationType")
+local SerializationType = ____SerializationType.SerializationType
+local ____table = require("functions.table")
+local getNumbersFromTable = ____table.getNumbersFromTable
+local tableHasKeys = ____table.tableHasKeys
+local ____utils = require("functions.utils")
+local ensureAllCases = ____utils.ensureAllCases
+local isUserdataObject = ____utils.isUserdataObject
+function ____exports.getRandomSeed(self)
+    local randomNumber = Random()
+    local safeRandomNumber = randomNumber == 0 and 1 or randomNumber
+    return safeRandomNumber
+end
+function ____exports.isRNG(self, object)
+    return isUserdataObject(nil, object, OBJECT_NAME)
+end
+function ____exports.newRNG(self, seed)
+    if seed == nil then
+        seed = ____exports.getRandomSeed(nil)
+    end
+    if seed == 0 then
+        error("You cannot initialize an RNG object with a seed of 0, or the game will crash.")
+    end
+    local rng = RNG()
+    rng:SetSeed(seed, RECOMMENDED_SHIFT_IDX)
+    return rng
+end
+RECOMMENDED_SHIFT_IDX = 35
+local KEYS = {"seed"}
+OBJECT_NAME = "RNG"
+function ____exports.copyRNG(self, rng, serializationType)
+    if serializationType == nil then
+        serializationType = SerializationType.NONE
+    end
+    repeat
+        local ____switch3 = serializationType
+        local ____cond3 = ____switch3 == SerializationType.NONE
+        if ____cond3 then
+            do
+                if not ____exports.isRNG(nil, rng) then
+                    error(((("Failed to copy a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                local seed = rng:GetSeed()
+                return ____exports.newRNG(nil, seed)
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.SERIALIZE
+        if ____cond3 then
+            do
+                if not ____exports.isRNG(nil, rng) then
+                    error(((("Failed to serialize a " .. OBJECT_NAME) .. " object since the provided object was not a userdata ") .. OBJECT_NAME) .. " class.")
+                end
+                local seed = rng:GetSeed()
+                local rngTable = {}
+                rngTable.seed = seed
+                rngTable[SerializationBrand.RNG] = ""
+                return rngTable
+            end
+        end
+        ____cond3 = ____cond3 or ____switch3 == SerializationType.DESERIALIZE
+        if ____cond3 then
+            do
+                local rngType = type(rng)
+                if ____exports.isRNG(nil, rng) or rngType ~= "table" then
+                    error(("Failed to deserialize a " .. OBJECT_NAME) .. " object since the provided object was not a Lua table.")
+                end
+                local seedNumber = table.unpack(getNumbersFromTable(
+                    nil,
+                    rng,
+                    OBJECT_NAME,
+                    table.unpack(KEYS)
+                ))
+                local seed = seedNumber
+                return ____exports.newRNG(nil, seed)
+            end
+        end
+        do
+            do
+                return ensureAllCases(nil, serializationType)
+            end
+        end
+    until true
+end
+function ____exports.isSerializedRNG(self, object)
+    local objectType = type(object)
+    if objectType ~= "table" then
+        return false
+    end
+    local ____table = object
+    return tableHasKeys(
+        nil,
+        ____table,
+        table.unpack(KEYS)
+    ) and ____table[SerializationBrand.RNG] ~= nil
+end
+function ____exports.nextSeed(self, seed)
+    local rng = ____exports.newRNG(nil, seed)
+    rng:Next()
+    return rng:GetSeed()
+end
+return ____exports

package/dist/functions/roomData.d.ts

@@ -4,6 +4,11 @@
  * `RoomDescriptor` object that you are retrieving.
  */
 export declare function getCurrentRoomDescriptorReadOnly(): RoomDescriptorReadOnly;
+/**
+ * Helper function to get the set of allowed door slots for the room at the supplied grid index.
+ * This corresponds to the doors that are enabled in the STB/XML file for the room.
+ */
+export declare function getRoomAllowedDoors(roomGridIndex?: int): Set<DoorSlot>;
 /**
  * Helper function to get the room data for the provided room.
  *

package/dist/functions/roomData.lua

@@ -1,11 +1,21 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local Set = ____lualib.Set
+local __TS__New = ____lualib.__TS__New
 local ____exports = {}
 local ____cachedClasses = require("cachedClasses")
 local game = ____cachedClasses.game
+local ____flag = require("functions.flag")
+local hasFlag = ____flag.hasFlag
+local ____utils = require("functions.utils")
+local getEnumValues = ____utils.getEnumValues
 function ____exports.getCurrentRoomDescriptorReadOnly(self)
     local level = game:GetLevel()
     return level:GetCurrentRoomDesc()
 end
+function ____exports.getRoomData(self, roomGridIndex)
+    local roomDescriptor = ____exports.getRoomDescriptor(nil, roomGridIndex)
+    return roomDescriptor.Data
+end
 function ____exports.getRoomDescriptor(self, roomGridIndex)
     local level = game:GetLevel()
     if roomGridIndex == nil then
@@ -22,9 +32,26 @@ function ____exports.getRoomGridIndex(self)
     local roomDescriptor = ____exports.getCurrentRoomDescriptorReadOnly(nil)
     return roomDescriptor.SafeGridIndex
 end
-function ____exports.getRoomData(self, roomGridIndex)
-    local roomDescriptor = ____exports.getRoomDescriptor(nil, roomGridIndex)
-    return roomDescriptor.Data
+function ____exports.getRoomAllowedDoors(self, roomGridIndex)
+    local allowedDoors = __TS__New(Set)
+    local roomData = ____exports.getRoomData(nil, roomGridIndex)
+    if roomData == nil then
+        return allowedDoors
+    end
+    local doorSlots = getEnumValues(nil, DoorSlot)
+    for ____, doorSlot in ipairs(doorSlots) do
+        do
+            if doorSlot == DoorSlot.NO_DOOR_SLOT or doorSlot == DoorSlot.NUM_DOOR_SLOTS then
+                goto __continue5
+            end
+            local doorSlotFlag = 1 << doorSlot
+            if hasFlag(nil, roomData.Doors, doorSlotFlag) then
+                allowedDoors:add(doorSlot)
+            end
+        end
+        ::__continue5::
+    end
+    return allowedDoors
 end
 function ____exports.getRoomListIndex(self, roomGridIndex)
     local roomDescriptor = ____exports.getRoomDescriptor(nil, roomGridIndex)

package/dist/functions/set.d.ts

@@ -25,10 +25,10 @@ export declare function deleteSetsFromSet<T>(mainSet: Set<T>, ...setsToRemove: A
  * Helper function to get a random element from the provided set.
  *
  * @param set The set to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `Random()`.
+ * @param rng Optional. The RNG object used to select the random element. Default is `newRNG()`.
  * @param exceptions Optional. An array of elements to skip over if selected.
  */
-export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, seed?: Seed, exceptions?: T[] | readonly T[]): T;
+export declare function getRandomSetElement<T>(set: Set<T> | ReadonlySet<T>, rng?: RNG, exceptions?: T[] | readonly T[]): T;
 /**
  * Helper function to get a sorted array based on the contents of a set.
  *

package/dist/functions/set.lua

@@ -7,6 +7,8 @@ local __TS__ArraySort = ____lualib.__TS__ArraySort
 local ____exports = {}
 local ____array = require("functions.array")
 local getRandomArrayElement = ____array.getRandomArrayElement
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
 function ____exports.getSortedSetValues(self, set)
     local values = set:values()
     local array = {__TS__Spread(values)}
@@ -46,14 +48,14 @@ function ____exports.deleteSetsFromSet(self, mainSet, ...)
         end
     end
 end
-function ____exports.getRandomSetElement(self, set, seed, exceptions)
-    if seed == nil then
-        seed = Random()
+function ____exports.getRandomSetElement(self, set, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local array = ____exports.getSortedSetValues(nil, set)
-    return getRandomArrayElement(nil, array, seed, exceptions)
+    return getRandomArrayElement(nil, array, rng, exceptions)
 end
 return ____exports

package/dist/functions/spawnCollectible.d.ts

@@ -7,13 +7,13 @@
  *
  * @param collectibleType The collectible type to spawn.
  * @param position The position to spawn the collectible at.
- * @param seed Optional. Default is `Random()`.
+ * @param rng Optional. Default is `newRNG()`.
  * @param options Optional. Set to true to make the collectible a "There's Options" style
  * collectible. Default is false.
  * @param forceFreeItem Optional. Set to true to disable the logic that gives the item a price for
  * Tainted Keeper. Default is false.
  */
-export declare function spawnCollectible(collectibleType: CollectibleType | int, position: Vector, seed?: Seed, options?: boolean, forceFreeItem?: boolean): EntityPickup;
+export declare function spawnCollectible(collectibleType: CollectibleType | int, position: Vector, rng?: RNG, options?: boolean, forceFreeItem?: boolean): EntityPickup;
 /**
  * Helper function to spawn an empty collectible. Doing this is tricky since spawning a collectible
  * with `CollectibleType.COLLECTIBLE_NULL` will result in spawning a collectible with a random type
@@ -22,4 +22,4 @@ export declare function spawnCollectible(collectibleType: CollectibleType | int,
  * Instead, this function arbitrarily spawns a collectible with
  * `CollectibleType.COLLECTIBLE_SAD_ONION`, and then converts it to an empty pedestal afterward.
  */
-export declare function spawnEmptyCollectible(position: Vector, seed?: Seed): EntityPickup;
+export declare function spawnEmptyCollectible(position: Vector, rng?: RNG): EntityPickup;

package/dist/functions/spawnCollectible.lua

@@ -11,9 +11,11 @@ local isQuestCollectible = ____collectibles.isQuestCollectible
 local setCollectibleEmpty = ____collectibles.setCollectibleEmpty
 local ____player = require("functions.player")
 local anyPlayerIs = ____player.anyPlayerIs
-function ____exports.spawnCollectible(self, collectibleType, position, seed, options, forceFreeItem)
-    if seed == nil then
-        seed = Random()
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
+function ____exports.spawnCollectible(self, collectibleType, position, rng, options, forceFreeItem)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if options == nil then
         options = false
@@ -21,9 +23,8 @@ function ____exports.spawnCollectible(self, collectibleType, position, seed, opt
     if forceFreeItem == nil then
         forceFreeItem = false
     end
-    if seed == 0 then
-        error("Failed to spawn a collectible since the provided seed was 0, which is not allowed. (It will cause the game to crash.)")
-    end
+    rng:Next()
+    local seed = rng:GetSeed()
     local collectible = game:Spawn(
         EntityType.ENTITY_PICKUP,
         100,
@@ -48,15 +49,15 @@ function ____exports.spawnCollectible(self, collectibleType, position, seed, opt
     end
     return collectible
 end
-function ____exports.spawnEmptyCollectible(self, position, seed)
-    if seed == nil then
-        seed = Random()
+function ____exports.spawnEmptyCollectible(self, position, rng)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     local collectible = ____exports.spawnCollectible(
         nil,
         CollectibleType.COLLECTIBLE_SAD_ONION,
         position,
-        seed,
+        rng,
         false,
         true
     )

package/dist/functions/table.d.ts

@@ -4,3 +4,33 @@
  * `clear` method does not exist. Use this helper function as a drop-in replacement for this.
  */
 export declare function clearTable(table: LuaTable): void;
+/** Helper function to copy specific values from a object to a table. */
+export declare function copyValuesToTable(object: unknown, keys: string[], table: LuaTable<string, string | number>): void;
+/**
+ * Helper function to safely get boolean values from a Lua table. Will throw an error if the
+ * specific value does not exist on the table.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export declare function getBooleansFromTable(table: LuaTable<string, string | number>, objectName: string, ...keys: string[]): boolean[];
+/**
+ * Helper function to safely get number values from a Lua table. Will throw an error if the specific
+ * value does not exist on the table or if it cannot be converted to a number.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export declare function getNumbersFromTable(table: LuaTable<string, string | number>, objectName: string, ...keys: string[]): number[];
+/**
+ * Helper function to safely get string values from a Lua table. Will throw an error if the specific
+ * value does not exist on the table.
+ *
+ * This function is variadic, meaning that you can specify N arguments to get N values.
+ */
+export declare function getStringsFromTable(table: LuaTable<string, string | number>, objectName: string, ...keys: string[]): string[];
+/**
+ * Helper function to check if a Lua table has all of the provided keys.
+ *
+ * This function is variadic, meaning that you can specify as many arguments as you want to check
+ * for.
+ */
+export declare function tableHasKeys(table: LuaTable, ...keys: string[]): boolean;

package/dist/functions/table.lua

@@ -1,8 +1,80 @@
---[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
+local ____lualib = require("lualib_bundle")
+local __TS__ArrayPush = ____lualib.__TS__ArrayPush
+local __TS__TypeOf = ____lualib.__TS__TypeOf
+local __TS__ArrayEvery = ____lualib.__TS__ArrayEvery
 local ____exports = {}
 function ____exports.clearTable(self, ____table)
     for key in pairs(____table) do
         ____table[key] = nil
     end
 end
+function ____exports.copyValuesToTable(self, object, keys, ____table)
+    local otherTable = object
+    for ____, key in ipairs(keys) do
+        local value = otherTable[key]
+        ____table[key] = value
+    end
+end
+function ____exports.getBooleansFromTable(self, ____table, objectName, ...)
+    local keys = {...}
+    local booleans = {}
+    for ____, key in ipairs(keys) do
+        local value = ____table[key]
+        if value == nil then
+            error(((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        end
+        if type(value) == "boolean" then
+            __TS__ArrayPush(booleans, value)
+        else
+            error((((("Failed to get the boolean for the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object because the type was: ") .. __TS__TypeOf(value))
+        end
+    end
+    return booleans
+end
+function ____exports.getNumbersFromTable(self, ____table, objectName, ...)
+    local keys = {...}
+    local numbers = {}
+    for ____, key in ipairs(keys) do
+        local value = ____table[key]
+        if value == nil then
+            error(((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        end
+        if type(value) == "number" then
+            __TS__ArrayPush(numbers, value)
+        elseif type(value) == "string" then
+            local number = tonumber(value)
+            if number == nil then
+                error((((("Failed to convert the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object to a number: ") .. value)
+            end
+            __TS__ArrayPush(numbers, number)
+        else
+            error((((("Failed to get the number for the \"" .. key) .. "\" value of a table representing a \"") .. objectName) .. "\" object because the type was: ") .. __TS__TypeOf(value))
+        end
+    end
+    return numbers
+end
+function ____exports.getStringsFromTable(self, ____table, objectName, ...)
+    local keys = {...}
+    local strings = {}
+    for ____, key in ipairs(keys) do
+        local value = ____table[key]
+        if value == nil then
+            error(((("Failed to find a value for \"" .. key) .. "\" in a table representing a \"") .. objectName) .. "\" object.")
+        end
+        if type(value) == "string" then
+            __TS__ArrayPush(strings, value)
+        else
+            local ____string = tostring(value)
+            __TS__ArrayPush(strings, ____string)
+        end
+    end
+    return strings
+end
+function ____exports.tableHasKeys(self, ____table, ...)
+    local keys = {...}
+    return __TS__ArrayEvery(
+        keys,
+        function(____, key) return ____table[key] ~= nil end
+    )
+end
 return ____exports

package/dist/functions/utils.d.ts

@@ -93,6 +93,11 @@ export declare function hexToKColor(hexString: string, alpha: float): KColor;
  * is enabled or not.
  */
 export declare function isLuaDebugEnabled(): boolean;
+/**
+ * Helper function to check if the something is an instantiated class from the Isaac API. (All
+ * classes from the Isaac API have a type of "userdata" in Lua.)
+ */
+export declare function isUserdataObject(object: unknown, objectName: string): boolean;
 /**
  * Helper function to print something to the in-game console. Use this instead of invoking the
  * `Isaac.ConsoleOutput` method directly because it will automatically insert a newline at the end

package/dist/functions/utils.lua

@@ -66,6 +66,18 @@ end
 function ____exports.isLuaDebugEnabled(self)
     return package ~= nil
 end
+function ____exports.isUserdataObject(self, object, objectName)
+    local objectType = type(object)
+    if objectType ~= "userdata" then
+        return false
+    end
+    local metatable = getmetatable(object)
+    if metatable == nil then
+        return false
+    end
+    local vectorMetatable = metatable
+    return vectorMetatable.__type == objectName
+end
 function ____exports.printConsole(self, msg)
     Isaac.ConsoleOutput(msg .. "\n")
 end