isaacscript-common 1.2.200 → 1.2.203

package/dist/callbacks/customRevive.lua

@@ -15,6 +15,7 @@ local ____familiars = require("functions.familiars")
 local removeAllFamiliars = ____familiars.removeAllFamiliars
 local ____log = require("functions.log")
 local log = ____log.log
+local logError = ____log.logError
 local ____playerIndex = require("functions.playerIndex")
 local getPlayerFromIndex = ____playerIndex.getPlayerFromIndex
 local getPlayerIndex = ____playerIndex.getPlayerIndex
@@ -97,25 +98,19 @@ function playerIsAboutToDie(self, player)
     player:AddCollectible(CollectibleType.COLLECTIBLE_1UP, 0, false)
     removeAllFamiliars(nil, FamiliarVariant.ONE_UP)
     removeCollectibleFromItemTracker(nil, CollectibleType.COLLECTIBLE_1UP)
-    local character = player:GetPlayerType()
-    if character ~= PlayerType.PLAYER_SAMSON_B then
-        return
-    end
     local playerIndex = getPlayerIndex(nil, player)
     runNextGameFrame(
         nil,
         function()
-            local taintedSamson = getPlayerFromIndex(nil, playerIndex)
-            if taintedSamson == nil then
+            local futurePlayer = getPlayerFromIndex(nil, playerIndex)
+            if futurePlayer == nil then
                 return
             end
-            local effects = player:GetEffects()
-            local isBerserk = effects:HasCollectibleEffect(CollectibleType.COLLECTIBLE_BERSERK)
-            if not isBerserk then
+            if futurePlayer:IsDead() then
                 return
             end
-            effects:RemoveCollectibleEffect(CollectibleType.COLLECTIBLE_BERSERK, -1)
-            removeAllFamiliars(nil, FamiliarVariant.ONE_UP)
+            logError("The player is still alive after initializing a custom revive. Explicitly killing the player.")
+            futurePlayer:Kill()
         end
     )
 end

package/dist/callbacks/postNewRoomEarly.lua

@@ -7,7 +7,7 @@ local ____gridEntity = require("functions.gridEntity")
 local getTopLeftWallGridIndex = ____gridEntity.getTopLeftWallGridIndex
 local spawnGridEntity = ____gridEntity.spawnGridEntity
 local ____log = require("functions.log")
-local log = ____log.log
+local logError = ____log.logError
 local ____postNewRoomEarly = require("callbacks.subscriptions.postNewRoomEarly")
 local postNewRoomEarlyFire = ____postNewRoomEarly.postNewRoomEarlyFire
 local postNewRoomEarlyHasSubscriptions = ____postNewRoomEarly.postNewRoomEarlyHasSubscriptions
@@ -35,18 +35,16 @@ function checkRoomChanged(self)
     if topLeftWall == nil then
         topLeftWall = spawnGridEntity(nil, GridEntityType.GRID_WALL, topLeftWallGridIndex)
         if topLeftWall == nil then
-            log("Error: Failed to spawn a new wall (1) for the PostNewRoomEarly callback.")
+            logError("Failed to spawn a new wall (1) for the PostNewRoomEarly callback.")
             return
         end
-        log("Spawned a new wall (1) for the PostNewRoomEarly callback.")
     end
     if topLeftWall2 == nil then
         topLeftWall2 = spawnGridEntity(nil, GridEntityType.GRID_WALL, rightOfTopWallGridIndex)
         if topLeftWall2 == nil then
-            log("Error: Failed to spawn a new wall (2) for the PostNewRoomEarly callback.")
+            logError("Failed to spawn a new wall (2) for the PostNewRoomEarly callback.")
             return
         end
-        log("Spawned a new wall (2) for the PostNewRoomEarly callback.")
     end
     local topLeftWallPtrHash = GetPtrHash(topLeftWall)
     local topLeftWallPtrHash2 = GetPtrHash(topLeftWall2)

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/constants.d.ts

@@ -69,6 +69,8 @@ export declare const MAX_ROOM_INDEX = 168;
  * effect.
  */
 export declare const MAX_SPEED_STAT = 2;
+/** Corresponds to the maximum value for `EntityPlayer.SamsonBerserkCharge`. */
+export declare const MAX_TAINTED_SAMSON_BERSERK_CHARGE = 100000;
 export declare const MAX_VANILLA_CHARACTER: number;
 export declare const MAX_VANILLA_COLLECTIBLE_TYPE: number;
 export declare const NUM_DIMENSIONS = 3;
@@ -89,6 +91,8 @@ export declare const PILL_COLOR_MASK = 2047;
  * 1 << 11
  */
 export declare const PILL_GIANT_FLAG = 2048;
+/** After taking damage, `EntityPlayer.SamsonBerserkCharge` is incremented by this amount. */
+export declare const TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = 10000;
 /**
  * Add this to a `TrinketType` to get the corresponding golden trinket type.
  *

package/dist/constants.lua

@@ -22,6 +22,7 @@ ____exports.MAX_PLAYER_SPEED_IN_UNITS = 9.8
 ____exports.MAX_PLAYER_TRINKET_SLOTS = 2
 ____exports.MAX_ROOM_INDEX = 168
 ____exports.MAX_SPEED_STAT = 2
+____exports.MAX_TAINTED_SAMSON_BERSERK_CHARGE = 100000
 ____exports.MAX_VANILLA_CHARACTER = PlayerType.NUM_PLAYER_TYPES - 1
 ____exports.MAX_VANILLA_COLLECTIBLE_TYPE = CollectibleType.NUM_COLLECTIBLES - 1
 ____exports.NUM_DIMENSIONS = 3
@@ -30,6 +31,7 @@ ____exports.MINUTE_IN_MILLISECONDS = 60 * ____exports.SECOND_IN_MILLISECONDS
 ____exports.ONE_BY_ONE_ROOM_GRID_SIZE = 135
 ____exports.PILL_COLOR_MASK = 2047
 ____exports.PILL_GIANT_FLAG = 2048
+____exports.TAINTED_SAMSON_BERSERK_CHARGE_FROM_TAKING_DAMAGE = 10000
 ____exports.TRINKET_GOLDEN_FLAG = 32768
 ____exports.TRINKET_ID_MASK = 32767
 ____exports.UI_HEART_WIDTH = 12

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 `Random()`.
+ * @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 `Random()`.
+ * @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,8 +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 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")
@@ -136,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
@@ -183,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
@@ -194,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
@@ -210,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()
@@ -232,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)
@@ -243,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,
@@ -403,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 = Random()
+function ____exports.deployJSONRoom(self, jsonRoom, rng, verbose)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if verbose == nil then
         verbose = false
@@ -421,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 = Random()
+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/load.lua

@@ -6,6 +6,7 @@ local ____jsonHelpers = require("functions.jsonHelpers")
 local jsonDecode = ____jsonHelpers.jsonDecode
 local ____log = require("functions.log")
 local log = ____log.log
+local logError = ____log.logError
 local ____constants = require("features.saveDataManager.constants")
 local SAVE_DATA_MANAGER_DEBUG = ____constants.SAVE_DATA_MANAGER_DEBUG
 local SAVE_DATA_MANAGER_FEATURE_NAME = ____constants.SAVE_DATA_MANAGER_FEATURE_NAME
@@ -15,7 +16,7 @@ function readSaveDatFile(self, mod)
     local renderFrameCount = Isaac.GetFrameCount()
     local ok, jsonStringOrErrMsg = pcall(tryLoadModData, mod)
     if not ok then
-        log((("Error: Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
+        logError((("Failed to read from the \"save#.dat\" file on render frame " .. tostring(renderFrameCount)) .. ": ") .. jsonStringOrErrMsg)
         return DEFAULT_MOD_DATA
     end
     if jsonStringOrErrMsg == nil then

package/dist/features/saveDataManager/main.lua

@@ -13,7 +13,7 @@ local SerializationType = ____SerializationType.SerializationType
 local ____deepCopy = require("functions.deepCopy")
 local deepCopy = ____deepCopy.deepCopy
 local ____log = require("functions.log")
-local log = ____log.log
+local logError = ____log.logError
 local ____table = require("functions.table")
 local clearTable = ____table.clearTable
 local ____constants = require("features.saveDataManager.constants")
@@ -72,12 +72,12 @@ function restoreDefaults(self, childTableName)
             end
             local saveDataDefaults = saveDataDefaultsMap[subscriberName]
             if saveDataDefaults == nil then
-                log("Error: Failed to find the default copy of the save data for subscriber: " .. subscriberName)
+                logError("Failed to find the default copy of the save data for subscriber: " .. subscriberName)
                 goto __continue14
             end
             local childTableDefaults = saveDataDefaults[childTableName]
             if childTableDefaults == nil then
-                log((("Error: Failed to find the default copy of the child table \"" .. childTableName) .. "\" for subscriber: ") .. subscriberName)
+                logError((("Failed to find the default copy of the child table \"" .. childTableName) .. "\" for subscriber: ") .. subscriberName)
                 goto __continue14
             end
             local childTableDefaultsTable = childTableDefaults

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 `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 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 `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 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,28 +11,28 @@ local __TS__ArrayReduce = ____lualib.__TS__ArrayReduce
 local ____exports = {}
 local ____random = require("functions.random")
 local getRandomInt = ____random.getRandomInt
-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 = Random()
+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 = Random()
+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]
@@ -115,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 = Random()
+function ____exports.getRandomArrayElement(self, array, rng, exceptions)
+    if rng == nil then
+        rng = newRNG(nil)
     end
     if exceptions == nil then
         exceptions = {}
@@ -130,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 = Random()
+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
@@ -192,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 = Random()
+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,24 +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 `Random()`.
+ * @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 `Random()`.
+ * @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 `Random()`.
+ * @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