isaacscript-common 1.2.201 → 1.2.202

package/dist/functions/random.d.ts

@@ -16,6 +16,24 @@ export declare function getRandom(seed?: Seed): float;
  * ```
  */
 export declare function getRandomFloat(min: int, max: int, seed?: Seed): 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.
+ */
+export declare function getRandomFloatFromRNG(min: int, max: int, rng: RNG): 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.)
+ *
+ * Note that this function will invoke the `Next` method on the `RNG` object before returning the
+ * random number.
+ */
+export declare function getRandomFromRNG(rng: RNG): float;
 /**
  * This returns a random integer between min and max, inclusive.
  *
@@ -25,6 +43,15 @@ export declare function getRandomFloat(min: int, max: int, seed?: Seed): float;
  * ```
  */
 export declare function getRandomInt(min: int, max: int, seed?: Seed): int;
+/**
+ * This returns a random integer between min and max, inclusive.
+ *
+ * Example:
+ * ```ts
+ * const oneTwoOrThree = getRandomInt(1, 3, seed);
+ * ```
+ */
+export declare function getRandomIntFromRNG(min: int, max: int, rng: RNG): int;
 /**
  * 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
@@ -46,7 +73,7 @@ export declare function getRandomSeed(): Seed;
  *
  * @param seed The seed to initialize it with. Default is `getRandomSeed()`.
  */
-export declare function initRNG(seed?: Seed): RNG;
+export declare function newRNG(seed?: Seed): RNG;
 /**
  * Helper function to get the next seed value.
  *

package/dist/functions/random.lua

@@ -1,12 +1,33 @@
 --[[ Generated with https://github.com/TypeScriptToLua/TypeScriptToLua ]]
 local ____exports = {}
 local RECOMMENDED_SHIFT_IDX
+function ____exports.getRandomFloatFromRNG(self, min, max, rng)
+    if min > max then
+        local oldMin = min
+        local oldMax = max
+        min = oldMax
+        max = oldMin
+    end
+    return min + ____exports.getRandomFromRNG(nil, rng) * (max - min)
+end
+function ____exports.getRandomFromRNG(self, rng)
+    return rng:RandomFloat()
+end
+function ____exports.getRandomIntFromRNG(self, min, max, rng)
+    if min > max then
+        local oldMin = min
+        local oldMax = max
+        min = oldMax
+        max = oldMin
+    end
+    return rng:RandomInt(max - min + 1) + min
+end
 function ____exports.getRandomSeed(self)
-    local random = Random()
-    local safeRandomValue = random == 0 and 1 or random
-    return safeRandomValue
+    local randomNumber = Random()
+    local safeRandomNumber = randomNumber == 0 and 1 or randomNumber
+    return safeRandomNumber
 end
-function ____exports.initRNG(self, seed)
+function ____exports.newRNG(self, seed)
     if seed == nil then
         seed = ____exports.getRandomSeed(nil)
     end
@@ -22,24 +43,25 @@ function ____exports.getRandom(self, seed)
     if seed == nil then
         seed = ____exports.getRandomSeed(nil)
     end
-    local rng = ____exports.initRNG(nil, seed)
-    return rng:RandomFloat()
+    local rng = ____exports.newRNG(nil, seed)
+    return ____exports.getRandomFromRNG(nil, rng)
 end
 function ____exports.getRandomFloat(self, min, max, seed)
     if seed == nil then
         seed = ____exports.getRandomSeed(nil)
     end
-    return min + ____exports.getRandom(nil, seed) * (max - min)
+    local rng = ____exports.newRNG(nil, seed)
+    return ____exports.getRandomFloatFromRNG(nil, min, max, rng)
 end
 function ____exports.getRandomInt(self, min, max, seed)
     if seed == nil then
         seed = ____exports.getRandomSeed(nil)
     end
-    local rng = ____exports.initRNG(nil, seed)
-    return rng:RandomInt(max - min + 1) + min
+    local rng = ____exports.newRNG(nil, seed)
+    return ____exports.getRandomIntFromRNG(nil, min, max, rng)
 end
 function ____exports.nextSeed(self, seed)
-    local rng = ____exports.initRNG(nil, seed)
+    local rng = ____exports.newRNG(nil, seed)
     rng:Next()
     return rng:GetSeed()
 end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "1.2.201",
+  "version": "1.2.202",
   "description": "Helper functions for IsaacScript mods",
   "keywords": [
     "isaac",