isaacscript-common 1.2.202 → 1.2.203

package/dist/classes/ModUpgraded.d.ts

@@ -6,9 +6,7 @@ export declare class ModUpgraded implements Mod {
     Name: string;
     /** We store a copy of the original mod object so that we can re-implement its functions. */
     Mod: Mod;
-    /** End-users can optionally enable verbose-mode, which helps troubleshoot crashes. */
-    Verbose: boolean;
-    constructor(mod: Mod, verbose: boolean);
+    constructor(mod: Mod);
     AddCallback<T extends ModCallbacks>(modCallbacks: T, ...args: AddCallbackParameters[T]): void;
     HasData(): boolean;
     LoadData(): string;

package/dist/classes/ModUpgraded.lua

@@ -1,51 +1,17 @@
 local ____lualib = require("lualib_bundle")
 local __TS__Class = ____lualib.__TS__Class
-local __TS__Spread = ____lualib.__TS__Spread
-local __TS__ObjectEntries = ____lualib.__TS__ObjectEntries
 local ____exports = {}
-local getCallbackName
-local ____log = require("functions.log")
-local getDebugPrependString = ____log.getDebugPrependString
 local ____callbackRegisterFunctions = require("objects.callbackRegisterFunctions")
 local CALLBACK_REGISTER_FUNCTIONS = ____callbackRegisterFunctions.CALLBACK_REGISTER_FUNCTIONS
-function getCallbackName(self, callbackID)
-    for ____, ____value in ipairs(__TS__ObjectEntries(ModCallbacks)) do
-        local key = ____value[1]
-        local value = ____value[2]
-        if value == callbackID then
-            return key
-        end
-    end
-    return "MC_UNKNOWN"
-end
 ____exports.ModUpgraded = __TS__Class()
 local ModUpgraded = ____exports.ModUpgraded
 ModUpgraded.name = "ModUpgraded"
-function ModUpgraded.prototype.____constructor(self, mod, verbose)
+function ModUpgraded.prototype.____constructor(self, mod)
     self.Name = mod.Name
     self.Mod = mod
-    self.Verbose = verbose
 end
 function ModUpgraded.prototype.AddCallback(self, modCallbacks, ...)
-    local args = {...}
-    if self.Verbose then
-        local callback = args[1]
-        local optionalArg = args[2]
-        local callbackName = getCallbackName(nil, modCallbacks)
-        local debugMsg = getDebugPrependString(nil, callbackName)
-        local function callbackWithLogger(____, ...)
-            Isaac.DebugString(debugMsg .. " - START")
-            local value = callback(nil, ...)
-            Isaac.DebugString((debugMsg .. " - END - ") .. tostring(value))
-            return value
-        end
-        self.Mod:AddCallback(modCallbacks, callbackWithLogger, optionalArg)
-    else
-        self.Mod:AddCallback(
-            modCallbacks,
-            __TS__Spread(args)
-        )
-    end
+    self.Mod:AddCallback(modCallbacks, ...)
 end
 function ModUpgraded.prototype.HasData(self)
     return self.Mod:HasData()

package/dist/enums/private/SerializationBrand.d.ts

@@ -10,6 +10,8 @@ export declare enum SerializationBrand {
     SET = "__TSTL_SET",
     CLASS = "__TSTL_CLASS",
     OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS",
+    COLOR = "__COLOR",
+    RNG = "__RNG",
     VECTOR = "__VECTOR"
 }
 export declare function isSerializationBrand(key: AnyNotNil): boolean;

package/dist/enums/private/SerializationBrand.lua

@@ -11,6 +11,8 @@ ____exports.SerializationBrand.MAP = "__TSTL_MAP"
 ____exports.SerializationBrand.SET = "__TSTL_SET"
 ____exports.SerializationBrand.CLASS = "__TSTL_CLASS"
 ____exports.SerializationBrand.OBJECT_WITH_NUMBER_KEYS = "__TSTL_OBJECT_WITH_NUMBER_KEYS"
+____exports.SerializationBrand.COLOR = "__COLOR"
+____exports.SerializationBrand.RNG = "__RNG"
 ____exports.SerializationBrand.VECTOR = "__VECTOR"
 local SERIALIZATION_BRANDS = getEnumValues(nil, ____exports.SerializationBrand)
 local SERIALIZATION_BRAND_SET = __TS__New(Set, SERIALIZATION_BRANDS)

package/dist/features/deployJSONRoom.d.ts

@@ -14,15 +14,12 @@ import { JSONRoom } from "../types/JSONRoom";
  * const firstJSONRoom = customRooms.rooms.room[0];
  * deployJSONRoom(firstJSONRoom);
  * ```
- * @param seed Optional. Specifies the seed that will be used for spawning every entity in the room.
- * Default is `getRandomSeed()`.
+ * @param rng Optional. Specifies the RNG object that will be used for spawning every entity in the
+ * room. Default is `newRNG()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
- * @returns Before using the seed for spawning each entity, it is iterated with `nextSeed`. The
- * function returns the final iterated seed after spawning everything, which can be used in
- * subsequent room deployments.
  */
-export declare function deployJSONRoom(jsonRoom: JSONRoom, seed?: Seed, verbose?: boolean): Seed;
+export declare function deployJSONRoom(jsonRoom: JSONRoom, rng?: RNG, verbose?: boolean): void;
 /**
  * Helper function to deconstruct a vanilla room and set up a custom room in its place.
  * Specifically, this will clear the current room of all entities and grid entities, and then spawn
@@ -42,15 +39,12 @@ export declare function deployJSONRoom(jsonRoom: JSONRoom, seed?: Seed, verbose?
  * const jsonRooms = customRooms.rooms.room;
  * deployRandomJSONRoom(jsonRooms);
  * ```
- * @param seed Optional. Specifies the seed that will be used for determining the random room. After
- * that, it is also used for spawning every entity in the room. Default is `getRandomSeed()`.
+ * @param rng Optional. Specifies the RNG object that will be used for determining the random room.
+ * After that, it is also used for spawning every entity in the room. Default is `newRNG()`.
  * @param verbose Optional. If specified, will write entries to the "log.txt" file that describe
  * what the function is doing. Default is false.
- * @returns Before using the seed for spawning each entity, it is iterated with `nextSeed`. The
- * function returns the final iterated seed after spawning everything, which can be used in
- * subsequent room deployments.
  */
-export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], seed?: Seed, verbose?: boolean): Seed;
+export declare function deployRandomJSONRoom(jsonRooms: JSONRoom[], rng?: RNG, verbose?: boolean): void;
 /**
  * Helper function to remove all naturally spawning entities and grid entities from a room. Notably,
  * this will not remove players (1), tears (2), familiars (3), lasers (7), knives (8),

package/dist/features/deployJSONRoom.lua

@@ -32,9 +32,8 @@ local ____npc = require("functions.npc")
 local getNPCs = ____npc.getNPCs
 local ____pickups = require("functions.pickups")
 local removeAllPickups = ____pickups.removeAllPickups
-local ____random = require("functions.random")
-local getRandomSeed = ____random.getRandomSeed
-local nextSeed = ____random.nextSeed
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
 local ____roomData = require("functions.roomData")
 local getRoomListIndex = ____roomData.getRoomListIndex
 local ____rooms = require("functions.rooms")
@@ -137,7 +136,7 @@ function fillRoomWithDecorations(self)
         ::__continue30::
     end
 end
-function spawnAllEntities(self, jsonRoom, seed, verbose)
+function spawnAllEntities(self, jsonRoom, rng, verbose)
     if verbose == nil then
         verbose = false
     end
@@ -184,7 +183,6 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
                 y
             )
         else
-            seed = nextSeed(nil, seed)
             if verbose then
                 log(((((((((("Spawning normal entity " .. tostring(entityType)) .. ".") .. tostring(variant)) .. ".") .. tostring(subType)) .. " at: (") .. tostring(x)) .. ", ") .. tostring(y)) .. ")")
             end
@@ -195,7 +193,7 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
                 subType,
                 x,
                 y,
-                seed
+                rng
             )
             local npc = entity:ToNPC()
             if npc ~= nil and npc.CanShutDoors then
@@ -211,7 +209,6 @@ function spawnAllEntities(self, jsonRoom, seed, verbose)
     elseif verbose then
         log("Leaving the room cleared since there were no battle NPCs spawned.")
     end
-    return seed
 end
 function spawnGridEntityForJSONRoom(self, xmlEntityType, xmlEntityVariant, x, y)
     local room = game:GetRoom()
@@ -233,7 +230,7 @@ function spawnGridEntityForJSONRoom(self, xmlEntityType, xmlEntityVariant, x, y)
     end
     return gridEntity
 end
-function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y, seed)
+function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y, rng)
     local room = game:GetRoom()
     local roomType = room:GetType()
     local position = gridToPos(nil, x, y)
@@ -244,10 +241,12 @@ function spawnNormalEntityForJSONRoom(self, entityType, variant, subType, x, y,
             nil,
             subType,
             position,
-            seed,
+            rng,
             options
         )
     else
+        rng:Next()
+        local seed = rng:GetSeed()
         entity = game:Spawn(
             entityType,
             variant,
@@ -404,9 +403,9 @@ function ____exports.deployJSONRoomInit(self, mod)
     saveDataManager(nil, "deployJSONRoom", v)
     mod:AddCallback(ModCallbacks.MC_POST_NEW_ROOM, postNewRoom)
 end
-function ____exports.deployJSONRoom(self, jsonRoom, seed, verbose)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.deployJSONRoom(self, jsonRoom, rng, verbose)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if verbose == nil then
         verbose = false
@@ -422,26 +421,25 @@ function ____exports.deployJSONRoom(self, jsonRoom, seed, verbose)
     if verbose then
         log("Starting to spawn all of the new entities and grid entities.")
     end
-    local newSeed = spawnAllEntities(nil, jsonRoom, seed, verbose)
+    spawnAllEntities(nil, jsonRoom, rng, verbose)
     if verbose then
         log("Finished spawning all of the new entities and grid entities.")
     end
     fixPitGraphics(nil)
     fillRoomWithDecorations(nil)
-    return newSeed
 end
-function ____exports.deployRandomJSONRoom(self, jsonRooms, seed, verbose)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.deployRandomJSONRoom(self, jsonRooms, rng, verbose)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if verbose == nil then
         verbose = false
     end
     errorIfFeaturesNotInitialized(nil, FEATURE_NAME)
-    local randomJSONRoom = getRandomJSONRoom(nil, jsonRooms, seed, verbose)
+    local randomJSONRoom = getRandomJSONRoom(nil, jsonRooms, rng, verbose)
     if verbose then
         log((((((("Randomly chose JSON room " .. randomJSONRoom["$"].type) .. ".") .. randomJSONRoom["$"].variant) .. ".") .. randomJSONRoom["$"].subtype) .. " with name: ") .. randomJSONRoom["$"].name)
     end
-    return ____exports.deployJSONRoom(nil, randomJSONRoom, seed, verbose)
+    return ____exports.deployJSONRoom(nil, randomJSONRoom, rng, verbose)
 end
 return ____exports

package/dist/features/saveDataManager/merge.d.ts

@@ -1,8 +1,17 @@
 /// <reference types="typescript-to-lua/language-extensions" />
 /**
- * merge takes the values from a new table and recursively merges them into an old object
- * (while performing appropriate deserialization).
- * This function handles Lua tables and TypeScriptToLua Maps/Sets/Classes.
+ * merge takes the values from a new table and recursively merges them into an old object (while
+ * performing appropriate deserialization).
+ *
+ * It supports the following object types:
+ *
+ * - `LuaTable` / basic TSTL objects
+ * - TSTL `Map`
+ * - TSTL `Set`
+ * - TSTL classes
+ * - `DefaultMap`
+ * - Isaac `RNG` objects
+ * - Isaac `Vector` objects
  *
  * Since it is common for a variable to have a type of `something | null`, we must iterate over the
  * new object and copy over all of the values. (A value of null transpiles to nil, which means the

package/dist/features/saveDataManager/merge.lua

@@ -3,7 +3,7 @@ local Map = ____lualib.Map
 local __TS__InstanceOf = ____lualib.__TS__InstanceOf
 local Set = ____lualib.Set
 local ____exports = {}
-local mergeArray, mergeTSTLObject, mergeTable, mergeVector
+local mergeArray, mergeTSTLObject, mergeTable, tryDeserializeIsaacClass
 local ____SerializationBrand = require("enums.private.SerializationBrand")
 local isSerializationBrand = ____SerializationBrand.isSerializationBrand
 local SerializationBrand = ____SerializationBrand.SerializationBrand
@@ -13,15 +13,18 @@ local ____array = require("functions.array")
 local isArray = ____array.isArray
 local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
-local isSerializedVector = ____deepCopy.isSerializedVector
 local ____log = require("functions.log")
 local log = ____log.log
+local ____rng = require("functions.rng")
+local copyRNG = ____rng.copyRNG
+local isSerializedRNG = ____rng.isSerializedRNG
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local ____utils = require("functions.utils")
 local getTraversalDescription = ____utils.getTraversalDescription
 local ____vector = require("functions.vector")
-local deserializeVector = ____vector.deserializeVector
+local copyVector = ____vector.copyVector
+local isSerializedVector = ____vector.isSerializedVector
 local ____constants = require("features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 function ____exports.merge(self, oldObject, newTable, traversalDescription)
@@ -100,7 +103,9 @@ function mergeTable(self, oldTable, newTable, traversalDescription)
             if isSerializationBrand(nil, key) then
                 goto __continue23
             end
-            if mergeVector(nil, oldTable, key, value) then
+            local deserializedIsaacClass = tryDeserializeIsaacClass(nil, value)
+            if deserializedIsaacClass ~= nil then
+                oldTable[key] = deserializedIsaacClass
                 goto __continue23
             end
             local valueType = type(value)
@@ -123,13 +128,13 @@ function mergeTable(self, oldTable, newTable, traversalDescription)
         ::__continue23::
     end
 end
-function mergeVector(self, oldTable, key, value)
-    if not isSerializedVector(nil, value) then
-        return false
+function tryDeserializeIsaacClass(self, value)
+    if isSerializedVector(nil, value) then
+        return copyVector(nil, value, SerializationType.DESERIALIZE)
     end
-    local serializedVector = value
-    local vector = deserializeVector(nil, serializedVector)
-    oldTable[key] = vector
-    return true
+    if isSerializedRNG(nil, value) then
+        return copyRNG(nil, value, SerializationType.DESERIALIZE)
+    end
+    return nil
 end
 return ____exports

package/dist/functions/array.d.ts

@@ -43,20 +43,20 @@ export declare function getLastElement<T>(array: T[]): T;
  * Helper function to get a random element from the provided array.
  *
  * @param array The array to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `getRandomSeed()`.
+ * @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 getRandomArrayElement<T>(array: T[] | readonly T[], seed?: Seed, exceptions?: T[] | readonly T[]): T;
+export declare function getRandomArrayElement<T>(array: T[] | readonly T[], rng?: RNG, exceptions?: T[] | readonly T[]): T;
 /**
  * Helper function to get a random element from the provided array. Once the random element is
  * decided, it is then removed from the array (in-place).
  *
  * @param array The array to get an element from.
- * @param seed Optional. The seed used to select the random element. Default is `getRandomSeed()`.
+ * @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 getRandomArrayElementAndRemove<T>(array: T[], seed?: Seed, exceptions?: T[] | readonly T[]): T;
-export declare function getRandomArrayIndex<T>(array: T[] | readonly T[], seed?: Seed): int;
+export declare function getRandomArrayElementAndRemove<T>(array: T[], rng?: RNG, exceptions?: T[] | readonly T[]): T;
+export declare function getRandomArrayIndex<T>(array: T[] | readonly T[], rng?: RNG): int;
 /**
  * Initializes an array with all elements containing the specified default value.
  *
@@ -80,11 +80,11 @@ export declare function isArrayInArray<T>(arrayToMatch: T[] | readonly T[], pare
  *
  * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
  */
-export declare function shuffleArray<T>(originalArray: T[] | readonly T[], seed?: Seed): T[];
+export declare function shuffleArray<T>(originalArray: T[] | readonly T[], rng?: RNG): T[];
 /**
  * Shuffles the provided array in-place using the Fisher-Yates algorithm.
  *
  * From: https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
  */
-export declare function shuffleArrayInPlace<T>(array: T[], seed?: Seed): void;
+export declare function shuffleArrayInPlace<T>(array: T[], rng?: RNG): void;
 export declare function sumArray(array: number[] | readonly number[]): number;

package/dist/functions/array.lua

@@ -11,29 +11,28 @@ local __TS__ArrayReduce = ____lualib.__TS__ArrayReduce
 local ____exports = {}
 local ____random = require("functions.random")
 local getRandomInt = ____random.getRandomInt
-local getRandomSeed = ____random.getRandomSeed
-local nextSeed = ____random.nextSeed
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
 local ____utils = require("functions.utils")
 local ____repeat = ____utils["repeat"]
-function ____exports.getRandomArrayIndex(self, array, seed)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomArrayIndex(self, array, rng)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if #array == 0 then
         error("Failed to get a random array index since the provided array is empty.")
     end
-    return getRandomInt(nil, 0, #array - 1, seed)
+    return getRandomInt(nil, 0, #array - 1, rng)
 end
-function ____exports.shuffleArrayInPlace(self, array, seed)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.shuffleArrayInPlace(self, array, rng)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     local currentIndex = #array
     local randomIndex
     while currentIndex > 0 do
         currentIndex = currentIndex - 1
-        seed = nextSeed(nil, seed)
-        randomIndex = ____exports.getRandomArrayIndex(nil, array, seed)
+        randomIndex = ____exports.getRandomArrayIndex(nil, array, rng)
         local ____temp_0 = {array[randomIndex + 1], array[currentIndex + 1]}
         array[currentIndex + 1] = ____temp_0[1]
         array[randomIndex + 1] = ____temp_0[2]
@@ -116,9 +115,9 @@ end
 function ____exports.getLastElement(self, array)
     return array[#array]
 end
-function ____exports.getRandomArrayElement(self, array, seed, exceptions)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomArrayElement(self, array, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -131,17 +130,17 @@ function ____exports.getRandomArrayElement(self, array, seed, exceptions)
         array,
         table.unpack(exceptions)
     )
-    local randomIndex = ____exports.getRandomArrayIndex(nil, arrayWithoutExceptions, seed)
+    local randomIndex = ____exports.getRandomArrayIndex(nil, arrayWithoutExceptions, rng)
     return arrayWithoutExceptions[randomIndex + 1]
 end
-function ____exports.getRandomArrayElementAndRemove(self, array, seed, exceptions)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomArrayElementAndRemove(self, array, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
-    local randomArrayElement = ____exports.getRandomArrayElement(nil, array, seed, exceptions)
+    local randomArrayElement = ____exports.getRandomArrayElement(nil, array, rng, exceptions)
     ____exports.arrayRemoveInPlace(nil, array, randomArrayElement)
     return randomArrayElement
 end
@@ -193,12 +192,12 @@ function ____exports.isArrayInArray(self, arrayToMatch, parentArray)
         function(____, element) return ____exports.arrayEquals(nil, element, arrayToMatch) end
     )
 end
-function ____exports.shuffleArray(self, originalArray, seed)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.shuffleArray(self, originalArray, rng)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     local array = ____exports.copyArray(nil, originalArray)
-    ____exports.shuffleArrayInPlace(nil, array, seed)
+    ____exports.shuffleArrayInPlace(nil, array, rng)
     return array
 end
 function ____exports.sumArray(self, array)

package/dist/functions/cards.d.ts

@@ -43,25 +43,24 @@ export declare function getMaxCards(): int;
  * - any objects like Dice Shard
  * - any modded cards.
  *
- * @param seed Optional. The seed with which to select the random card. Default is `getRandomSeed()`.
+ * @param rng Optional. The RNG object with which to select the random card. Default is `newRNG()`.
  * @param exceptions Optional. An array of cards to not select.
  */
-export declare function getRandomCard(seed?: Seed, exceptions?: Card[]): Card;
+export declare function getRandomCard(rng?: RNG, exceptions?: Card[]): Card;
 /**
  * @param cardType The card type that represents the pool of cards to select from.
- * @param seed Optional. The seed with which to select the random card. Default is `getRandomSeed()`.
+ * @param rng Optional. The RNG object with which to select the random card. Default is `newRNG()`.
  * @param exceptions Optional. An array of cards to not select.
  */
-export declare function getRandomCardOfType(cardType: CardType, seed?: Seed, exceptions?: Card[]): Card;
+export declare function getRandomCardOfType(cardType: CardType, rng?: RNG, exceptions?: Card[]): Card;
 /**
  * Has an equal chance of returning any rune (e.g. Rune of Hagalaz, Blank Rune, Black Rune, Soul of
  * Isaac, etc.). This will never return a Rune Shard.
  *
- * @param seed Optional. The seed with which to select the random rune. Default is
- * `getRandomSeed()`.
+ * @param rng Optional. The RNG object with which to select the random rune. Default is `newRNG()`.
  * @param exceptions Optional. An array of runes to not select.
  */
-export declare function getRandomRune(seed?: Seed, exceptions?: Card[]): Card;
+export declare function getRandomRune(rng?: RNG, exceptions?: Card[]): Card;
 /**
  * Returns true for cards that have the following card type:
  * - CardType.TAROT

package/dist/functions/cards.lua

@@ -20,8 +20,8 @@ local CARD_TYPES = ____cardTypes.CARD_TYPES
 local DEFAULT_CARD_TYPE = ____cardTypes.DEFAULT_CARD_TYPE
 local ____math = require("functions.math")
 local range = ____math.range
-local ____random = require("functions.random")
-local getRandomSeed = ____random.getRandomSeed
+local ____rng = require("functions.rng")
+local newRNG = ____rng.newRNG
 local ____set = require("functions.set")
 local addSetsToSet = ____set.addSetsToSet
 local getRandomSetElement = ____set.getRandomSetElement
@@ -100,35 +100,35 @@ function ____exports.getCardName(self, card)
     end
     return DEFAULT_CARD_NAME
 end
-function ____exports.getRandomCard(self, seed, exceptions)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomCard(self, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
-    return getRandomSetElement(nil, CARD_SET, seed, exceptions)
+    return getRandomSetElement(nil, CARD_SET, rng, exceptions)
 end
-function ____exports.getRandomCardOfType(self, cardType, seed, exceptions)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomCardOfType(self, cardType, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local cardSet = ____exports.getCardsOfType(nil, cardType)
-    return getRandomSetElement(nil, cardSet, seed, exceptions)
+    return getRandomSetElement(nil, cardSet, rng, exceptions)
 end
-function ____exports.getRandomRune(self, seed, exceptions)
-    if seed == nil then
-        seed = getRandomSeed(nil)
+function ____exports.getRandomRune(self, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
     end
     local runesSet = ____exports.getCardsOfType(nil, CardType.RUNE)
     runesSet:delete(Card.RUNE_SHARD)
-    return getRandomSetElement(nil, runesSet, seed, exceptions)
+    return getRandomSetElement(nil, runesSet, rng, exceptions)
 end
 function ____exports.isCard(self, card)
     return CARD_SET:has(card)

package/dist/functions/color.d.ts

@@ -1,5 +1,23 @@
 /// <reference types="isaac-typescript-definitions" />
-export declare function copyColor(color: Color): Color;
+/// <reference types="typescript-to-lua/language-extensions" />
+import { SerializationType } from "../enums/SerializationType";
+declare type SerializedColor = LuaTable<string, string | number>;
+interface CopyColorReturn {
+    [SerializationType.NONE]: Color;
+    [SerializationType.SERIALIZE]: SerializedColor;
+    [SerializationType.DESERIALIZE]: Color;
+}
+/**
+ * Helper function to copy a `Color` object.
+ *
+ * @param color The Color object to copy. In the case of deserialization, this will actually be a
+ * Lua table instead of an instantiated Color class.
+ * @param serializationType Default is `SerializationType.NONE`.
+ */
+export declare function copyColor<C extends Color | SerializedColor, S extends SerializationType>(color: C, serializationType: S): CopyColorReturn[S];
 export declare function copyKColor(kColor: KColor): KColor;
 export declare function getDefaultColor(): Color;
 export declare function getDefaultKColor(): KColor;
+/** Helper function to check if something is an instantiated Color object. */
+export declare function isColor(object: unknown): object is Color;
+export {};