com.wallstop-studios.unity-helpers 2.0.0-rc27 → 2.0.0-rc31

package/Runtime/Core/Random/DotNetRandom.cs

@@ -1,52 +1,52 @@
-namespace UnityHelpers.Core.Random
-{
-    using System;
-    using System.Runtime.Serialization;
-    using System.Text.Json.Serialization;
-
-    [Serializable]
-    [DataContract]
-    public sealed class DotNetRandom : AbstractRandom
-    {
-        public override RandomState InternalState =>
-            new RandomState(unchecked((ulong)_seed), state2: _numberGenerated);
-
-        private ulong _numberGenerated;
-        private int _seed;
-        private Random _random;
-
-        public DotNetRandom()
-            : this(Guid.NewGuid()) { }
-
-        public DotNetRandom(Guid guid)
-        {
-            _seed = guid.GetHashCode();
-            _random = new Random(_seed);
-        }
-
-        [JsonConstructor]
-        public DotNetRandom(RandomState internalState)
-        {
-            _seed = unchecked((int)internalState.State1);
-            _random = new Random(_seed);
-            _numberGenerated = 0;
-            ulong generationCount = internalState.State2;
-
-            while (_numberGenerated < generationCount)
-            {
-                _ = NextUint();
-            }
-        }
-
-        public override uint NextUint()
-        {
-            ++_numberGenerated;
-            return unchecked((uint)_random.Next(int.MinValue, int.MaxValue));
-        }
-
-        public override IRandom Copy()
-        {
-            return new DotNetRandom(InternalState);
-        }
-    }
-}
+namespace UnityHelpers.Core.Random
+{
+    using System;
+    using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
+
+    [Serializable]
+    [DataContract]
+    public sealed class DotNetRandom : AbstractRandom
+    {
+        public override RandomState InternalState =>
+            new RandomState(unchecked((ulong)_seed), state2: _numberGenerated);
+
+        private ulong _numberGenerated;
+        private int _seed;
+        private Random _random;
+
+        public DotNetRandom()
+            : this(Guid.NewGuid()) { }
+
+        public DotNetRandom(Guid guid)
+        {
+            _seed = guid.GetHashCode();
+            _random = new Random(_seed);
+        }
+
+        [JsonConstructor]
+        public DotNetRandom(RandomState internalState)
+        {
+            _seed = unchecked((int)internalState.State1);
+            _random = new Random(_seed);
+            _numberGenerated = 0;
+            ulong generationCount = internalState.State2;
+
+            while (_numberGenerated < generationCount)
+            {
+                _ = NextUint();
+            }
+        }
+
+        public override uint NextUint()
+        {
+            ++_numberGenerated;
+            return unchecked((uint)_random.Next(int.MinValue, int.MaxValue));
+        }
+
+        public override IRandom Copy()
+        {
+            return new DotNetRandom(InternalState);
+        }
+    }
+}

package/Runtime/Core/Random/DotNetRandom.cs.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: a01f07b12a4e4da0b9d41986ff6a6c43
+fileFormatVersion: 2
+guid: a01f07b12a4e4da0b9d41986ff6a6c43
 timeCreated: 1732481642

package/Runtime/Core/Random/IRandom.cs

@@ -1,160 +1,160 @@
-namespace UnityHelpers.Core.Random
-{
-    using System;
-    using System.Collections.Generic;
-    using DataStructure.Adapters;
-
-    public interface IRandom
-    {
-        RandomState InternalState { get; }
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, int.MaxValue).</returns>
-        int Next();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        int Next(int max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        int Next(int min, int max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, uint.MaxValue].</returns>
-        uint NextUint();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        uint NextUint(uint max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        uint NextUint(uint min, uint max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, short.MaxValue).</returns>
-        short NextShort();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        short NextShort(short max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        short NextShort(short min, short max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, byte.MaxValue).</returns>
-        byte NextByte();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        byte NextByte(byte max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        byte NextByte(byte min, byte max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, long.MaxValue).</returns>
-        long NextLong();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        long NextLong(long max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        long NextLong(long min, long max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, ulong.MaxValue).</returns>
-        ulong NextUlong();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        ulong NextUlong(ulong max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [min, max).</returns>
-        ulong NextUlong(ulong min, ulong max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>50% chance of true or false.</returns>
-        bool NextBool();
-
-        void NextBytes(byte[] buffer);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, 1).</returns>
-        float NextFloat();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        float NextFloat(float max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range min, max).</returns>
-        float NextFloat(float min, float max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, 1).</returns>
-        double NextDouble();
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range [0, max).</returns>
-        double NextDouble(double max);
-
-        /// <summary>
-        /// </summary>
-        /// <returns>A number within the range min, max).</returns>
-        double NextDouble(double min, double max);
-
-        double NextGaussian(double mean = 0, double stdDev = 1);
-
-        Guid NextGuid();
-        KGuid NextKGuid();
-
-        T NextOf<T>(IEnumerable<T> enumerable);
-        T NextOf<T>(IReadOnlyCollection<T> collection);
-        T NextOf<T>(IReadOnlyList<T> list);
-
-        T NextEnum<T>()
-            where T : struct, Enum;
-
-        float[,] NextNoiseMap(
-            int width,
-            int height,
-            PerlinNoise noise = null,
-            float scale = 2.5f,
-            int octaves = 8
-        );
-
-        IRandom Copy();
-    }
-}
+namespace UnityHelpers.Core.Random
+{
+    using System;
+    using System.Collections.Generic;
+    using DataStructure.Adapters;
+
+    public interface IRandom
+    {
+        RandomState InternalState { get; }
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, int.MaxValue).</returns>
+        int Next();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        int Next(int max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        int Next(int min, int max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, uint.MaxValue].</returns>
+        uint NextUint();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        uint NextUint(uint max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        uint NextUint(uint min, uint max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, short.MaxValue).</returns>
+        short NextShort();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        short NextShort(short max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        short NextShort(short min, short max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, byte.MaxValue).</returns>
+        byte NextByte();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        byte NextByte(byte max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        byte NextByte(byte min, byte max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, long.MaxValue).</returns>
+        long NextLong();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        long NextLong(long max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        long NextLong(long min, long max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, ulong.MaxValue).</returns>
+        ulong NextUlong();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        ulong NextUlong(ulong max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [min, max).</returns>
+        ulong NextUlong(ulong min, ulong max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>50% chance of true or false.</returns>
+        bool NextBool();
+
+        void NextBytes(byte[] buffer);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, 1).</returns>
+        float NextFloat();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        float NextFloat(float max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range min, max).</returns>
+        float NextFloat(float min, float max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, 1).</returns>
+        double NextDouble();
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range [0, max).</returns>
+        double NextDouble(double max);
+
+        /// <summary>
+        /// </summary>
+        /// <returns>A number within the range min, max).</returns>
+        double NextDouble(double min, double max);
+
+        double NextGaussian(double mean = 0, double stdDev = 1);
+
+        Guid NextGuid();
+        KGuid NextKGuid();
+
+        T NextOf<T>(IEnumerable<T> enumerable);
+        T NextOf<T>(IReadOnlyCollection<T> collection);
+        T NextOf<T>(IReadOnlyList<T> list);
+
+        T NextEnum<T>()
+            where T : struct, Enum;
+
+        float[,] NextNoiseMap(
+            int width,
+            int height,
+            PerlinNoise noise = null,
+            float scale = 2.5f,
+            int octaves = 8
+        );
+
+        IRandom Copy();
+    }
+}

package/Runtime/Core/Random/NativePcgRandom.cs

@@ -1,97 +1,97 @@
-namespace UnityHelpers.Core.Random
-{
-    using System;
-
-    public struct NativePcgRandom
-    {
-        private const uint HalfwayUint = uint.MaxValue / 2;
-        private const double MagicDouble = 4.6566128752458E-10;
-        private const float MagicFloat = 5.960465E-008F;
-
-        private readonly ulong _increment;
-        private ulong _state;
-
-        public NativePcgRandom(Guid seed)
-        {
-            byte[] guidArray = seed.ToByteArray();
-            _state = BitConverter.ToUInt64(guidArray, 0);
-            _increment = BitConverter.ToUInt64(guidArray, sizeof(ulong));
-        }
-
-        public NativePcgRandom(int seed)
-        {
-            _increment = 6554638469UL;
-            _state = unchecked((ulong)seed);
-            _increment = NextUlong();
-        }
-
-        public uint NextUint()
-        {
-            unchecked
-            {
-                ulong oldState = _state;
-                _state = oldState * 6364136223846793005UL + _increment;
-                uint xorShifted = (uint)(((oldState >> 18) ^ oldState) >> 27);
-                int rot = (int)(oldState >> 59);
-                return (xorShifted >> rot) | (xorShifted << (-rot & 31));
-            }
-        }
-
-        public int Next(int max)
-        {
-            if (max <= 0)
-            {
-                throw new ArgumentException($"Max {max} cannot be less-than or equal-to 0");
-            }
-
-            return unchecked((int)NextUint(unchecked((uint)max)));
-        }
-
-        public uint NextUint(uint max)
-        {
-            /*
-                https://github.com/libevent/libevent/blob/3807a30b03ab42f2f503f2db62b1ef5876e2be80/arc4random.c#L531
-
-                http://cs.stackexchange.com/questions/570/generating-uniformly-distributed-random-numbers-using-a-coin
-                Generates a uniform random number within the bound, avoiding modulo bias
-            */
-            uint threshold = unchecked((uint)((0x100000000UL - max) % max));
-            while (true)
-            {
-                uint randomValue = NextUint();
-                if (threshold <= randomValue)
-                {
-                    return randomValue % max;
-                }
-            }
-        }
-
-        public long NextLong()
-        {
-            uint upper = NextUint();
-            uint lower = NextUint();
-            // Mix things up a little
-            if (NextBool())
-            {
-                return unchecked((long)((ulong)upper << 32) | lower);
-            }
-            return unchecked((long)((ulong)lower << 32) | upper);
-        }
-
-        public ulong NextUlong()
-        {
-            return unchecked((ulong)NextLong());
-        }
-
-        public bool NextBool()
-        {
-            return NextUint() < HalfwayUint;
-        }
-
-        public float NextFloat()
-        {
-            uint floatAsInt = NextUint();
-            return (floatAsInt >> 8) * MagicFloat;
-        }
-    }
-}
+namespace UnityHelpers.Core.Random
+{
+    using System;
+
+    public struct NativePcgRandom
+    {
+        private const uint HalfwayUint = uint.MaxValue / 2;
+        private const double MagicDouble = 4.6566128752458E-10;
+        private const float MagicFloat = 5.960465E-008F;
+
+        private readonly ulong _increment;
+        private ulong _state;
+
+        public NativePcgRandom(Guid seed)
+        {
+            byte[] guidArray = seed.ToByteArray();
+            _state = BitConverter.ToUInt64(guidArray, 0);
+            _increment = BitConverter.ToUInt64(guidArray, sizeof(ulong));
+        }
+
+        public NativePcgRandom(int seed)
+        {
+            _increment = 6554638469UL;
+            _state = unchecked((ulong)seed);
+            _increment = NextUlong();
+        }
+
+        public uint NextUint()
+        {
+            unchecked
+            {
+                ulong oldState = _state;
+                _state = oldState * 6364136223846793005UL + _increment;
+                uint xorShifted = (uint)(((oldState >> 18) ^ oldState) >> 27);
+                int rot = (int)(oldState >> 59);
+                return (xorShifted >> rot) | (xorShifted << (-rot & 31));
+            }
+        }
+
+        public int Next(int max)
+        {
+            if (max <= 0)
+            {
+                throw new ArgumentException($"Max {max} cannot be less-than or equal-to 0");
+            }
+
+            return unchecked((int)NextUint(unchecked((uint)max)));
+        }
+
+        public uint NextUint(uint max)
+        {
+            /*
+                https://github.com/libevent/libevent/blob/3807a30b03ab42f2f503f2db62b1ef5876e2be80/arc4random.c#L531
+
+                http://cs.stackexchange.com/questions/570/generating-uniformly-distributed-random-numbers-using-a-coin
+                Generates a uniform random number within the bound, avoiding modulo bias
+            */
+            uint threshold = unchecked((uint)((0x100000000UL - max) % max));
+            while (true)
+            {
+                uint randomValue = NextUint();
+                if (threshold <= randomValue)
+                {
+                    return randomValue % max;
+                }
+            }
+        }
+
+        public long NextLong()
+        {
+            uint upper = NextUint();
+            uint lower = NextUint();
+            // Mix things up a little
+            if (NextBool())
+            {
+                return unchecked((long)((ulong)upper << 32) | lower);
+            }
+            return unchecked((long)((ulong)lower << 32) | upper);
+        }
+
+        public ulong NextUlong()
+        {
+            return unchecked((ulong)NextLong());
+        }
+
+        public bool NextBool()
+        {
+            return NextUint() < HalfwayUint;
+        }
+
+        public float NextFloat()
+        {
+            uint floatAsInt = NextUint();
+            return (floatAsInt >> 8) * MagicFloat;
+        }
+    }
+}

package/Runtime/Core/Random/PRNG.cs

@@ -1,7 +1,7 @@
-namespace UnityHelpers.Core.Random
-{
-    public static class PRNG
-    {
-        public static IRandom Instance => PcgRandom.Instance;
-    }
-}
+namespace UnityHelpers.Core.Random
+{
+    public static class PRNG
+    {
+        public static IRandom Instance => PcgRandom.Instance;
+    }
+}

package/Runtime/Core/Random/PRNG.cs.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: 5041bafe46dc450bb37153e394011636
+fileFormatVersion: 2
+guid: 5041bafe46dc450bb37153e394011636
 timeCreated: 1732564259