com.wallstop-studios.unity-helpers 2.0.0-rc03 → 2.0.0-rc05

package/Runtime/Core/Random/DotNetRandom.cs

@@ -0,0 +1,54 @@
+namespace UnityHelpers.Core.Random
+{
+    using System;
+    using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
+
+    [Serializable]
+    [DataContract]
+    public sealed class DotNetRandom : AbstractRandom
+    {
+        [JsonPropertyName("State")]
+        [DataMember(Name = "State")]
+        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 state)
+        {
+            _seed = unchecked((int)state.State1);
+            _random = new Random(_seed);
+            _numberGenerated = 0;
+            ulong generationCount = state.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

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

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: ddc39031f4659de4bbdd61deab3d299a
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: ddc39031f4659de4bbdd61deab3d299a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 738be60c0f0a5ad428b38b79c266f408
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 738be60c0f0a5ad428b38b79c266f408
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Random/PcgRandom.cs

@@ -2,24 +2,29 @@
 {
     using System;
     using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
 
     /// <summary>
     ///     Implementation based off of the reference PCG Random, found here: https://www.pcg-random.org/index.html
     /// </summary>
     [Serializable]
     [DataContract]
-    public sealed class PcgRandom : AbstractRandom, IEquatable<PcgRandom>, IComparable, IComparable<PcgRandom>
+    public sealed class PcgRandom
+        : AbstractRandom,
+            IEquatable<PcgRandom>,
+            IComparable,
+            IComparable<PcgRandom>
     {
+        [DataMember(Name = "State")]
+        [JsonPropertyName("State")]
         public static IRandom Instance => ThreadLocalRandom<PcgRandom>.Instance;
 
-        [DataMember(Name = "Increment")]
         internal readonly ulong _increment;
-        [DataMember(Name = "State")]
+
         internal ulong _state;
 
-        public PcgRandom() : this(Guid.NewGuid())
-        {
-        }
+        public PcgRandom()
+            : this(Guid.NewGuid()) { }
 
         public PcgRandom(Guid guid)
         {
@@ -28,11 +33,12 @@
             _increment = BitConverter.ToUInt64(guidArray, sizeof(ulong));
         }
 
-        public PcgRandom(RandomState randomState)
+        [JsonConstructor]
+        public PcgRandom(RandomState state)
         {
-            _state = randomState.State1;
-            _increment = randomState.State2;
-            _cachedGaussian = randomState.Gaussian;
+            _state = state.State1;
+            _increment = state.State2;
+            _cachedGaussian = state.Gaussian;
         }
 
         public PcgRandom(ulong increment, ulong state)
@@ -45,11 +51,11 @@
         {
             // Start with a nice prime
             _increment = 6554638469UL;
-            _state = unchecked((ulong) seed);
+            _state = unchecked((ulong)seed);
             _increment = NextUlong();
         }
 
-        public override RandomState InternalState => new (_state, _increment, _cachedGaussian);
+        public override RandomState InternalState => new(_state, _increment, _cachedGaussian);
 
         public override uint NextUint()
         {
@@ -71,7 +77,14 @@
             }
 
             // ReSharper disable once CompareOfFloatsByEqualityOperator
-            return _increment == other._increment && _state == other._state && _cachedGaussian == other._cachedGaussian;
+            return _increment == other._increment
+                && _state == other._state
+                && _cachedGaussian == other._cachedGaussian;
+        }
+
+        public override bool Equals(object obj)
+        {
+            return Equals(obj as PcgRandom);
         }
 
         public int CompareTo(PcgRandom other)
@@ -87,6 +100,7 @@
                 {
                     return 0;
                 }
+
                 if (_state < other._state)
                 {
                     return -1;
@@ -114,9 +128,9 @@
             return _cachedGaussian.Value.CompareTo(other._cachedGaussian.Value);
         }
 
-        public override bool Equals(object other)
+        public int CompareTo(object obj)
         {
-            return Equals(other as PcgRandom);
+            return CompareTo(obj as PcgRandom);
         }
 
         public override int GetHashCode()
@@ -129,11 +143,6 @@
             return $"{{\"Increment\": {_increment}, \"State\": {_state}}}";
         }
 
-        public int CompareTo(object other)
-        {
-            return CompareTo(other as PcgRandom);
-        }
-
         public override IRandom Copy()
         {
             return new PcgRandom(InternalState);

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 5206bd9e6b6b7a24cb5a88faba0e4777
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 5206bd9e6b6b7a24cb5a88faba0e4777
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Random/RandomState.cs

@@ -1,6 +1,7 @@
 namespace UnityHelpers.Core.Random
 {
     using System;
+    using System.Text.Json.Serialization;
     using Extension;
     using Helper;
     using ProtoBuf;
@@ -27,6 +28,7 @@
 
         [ProtoMember(1)]
         private ulong _state1;
+
         [ProtoMember(2)]
         private ulong _state2;
 
@@ -38,6 +40,7 @@
 
         private int _hashCode;
 
+        [JsonConstructor]
         public RandomState(ulong state1, ulong state2 = 0, double? gaussian = null)
         {
             _state1 = state1;
@@ -71,14 +74,22 @@
         public bool Equals(RandomState other)
         {
             // ReSharper disable once CompareOfFloatsByEqualityOperator
-            return _state1 == other._state1 && _state2 == other._state2 && _hasGaussian == other._hasGaussian && (!_hasGaussian || _gaussian == other._gaussian);
+            return _state1 == other._state1
+                && _state2 == other._state2
+                && _hasGaussian == other._hasGaussian
+                && (!_hasGaussian || _gaussian == other._gaussian);
         }
 
         public override int GetHashCode()
         {
             if (_hashCode == 0)
             {
-                return _hashCode = Objects.ValueTypeHashCode(_state1, _state2, _hasGaussian, _gaussian);
+                return _hashCode = Objects.ValueTypeHashCode(
+                    _state1,
+                    _state2,
+                    _hasGaussian,
+                    _gaussian
+                );
             }
 
             return _hashCode;

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 41d80559b2118924ba94e768d005a4e6
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 41d80559b2118924ba94e768d005a4e6
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Random/SquirrelRandom.cs

@@ -1,8 +1,12 @@
 namespace UnityHelpers.Core.Random
 {
     using System;
+    using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
 
     // https://youtu.be/LWFzPP8ZbdU?t=2673
+    [DataContract]
+    [Serializable]
     public sealed class SquirrelRandom : AbstractRandom
     {
         private const uint BitNoise1 = 0xB5297A4D;
@@ -10,28 +14,29 @@
         private const uint BitNoise3 = 0x1B56C4E9;
         private const int LargePrime = 198491317;
 
-        public static readonly SquirrelRandom Instance = new();
+        public static readonly SquirrelRandom Instance = ThreadLocalRandom<SquirrelRandom>.Instance;
+
+        [JsonPropertyName("State")]
+        [DataMember(Name = "State")]
+        public override RandomState InternalState => new(_position, gaussian: _cachedGaussian);
 
         private uint _position;
 
-        public SquirrelRandom() : this(Guid.NewGuid().GetHashCode())
-        {
-
-        }
+        public SquirrelRandom()
+            : this(Guid.NewGuid().GetHashCode()) { }
 
         public SquirrelRandom(int seed)
         {
             _position = unchecked((uint)seed);
         }
 
+        [JsonConstructor]
         public SquirrelRandom(RandomState randomState)
         {
             _position = unchecked((uint)randomState.State1);
             _cachedGaussian = randomState.Gaussian;
         }
 
-        public override RandomState InternalState => new(_position, gaussian: _cachedGaussian);
-
         public override uint NextUint()
         {
             return _position = NextUintInternal(_position);

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 3f2a41ab545b08e4b9bd2a8025bf839a
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 3f2a41ab545b08e4b9bd2a8025bf839a
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Random/SystemRandom.cs

@@ -1,12 +1,21 @@
 namespace UnityHelpers.Core.Random
 {
     using System;
+    using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
 
     /// <summary>
     ///     Implementation dependent upon .Net's Random class.
     /// </summary>
+    [Serializable]
+    [DataContract]
     public sealed class SystemRandom : AbstractRandom
     {
+        [JsonPropertyName("State")]
+        [DataMember(Name = "State")]
+        public override RandomState InternalState =>
+            new(unchecked((ulong)inext), unchecked((ulong)inextp), _cachedGaussian);
+
         /*
             Copied from Random.cs source. Apparently it isn't guaranteed to be the
             same across platforms and we depend on that.
@@ -17,9 +26,8 @@
 
         public static IRandom Instance => ThreadLocalRandom<SystemRandom>.Instance;
 
-        public SystemRandom() : this (Environment.TickCount)
-        {
-        }
+        public SystemRandom()
+            : this(Environment.TickCount) { }
 
         public SystemRandom(int seed)
         {
@@ -48,6 +56,7 @@
             this.inextp = 21;
         }
 
+        [JsonConstructor]
         public SystemRandom(RandomState randomState)
         {
             inext = unchecked((int)randomState.State1);
@@ -55,8 +64,6 @@
             _cachedGaussian = randomState.Gaussian;
         }
 
-        public override RandomState InternalState => new(unchecked((ulong)inext), unchecked((ulong)inextp), _cachedGaussian);
-
         public override uint NextUint()
         {
             int inext = this.inext;
@@ -75,7 +82,7 @@
             this.SeedArray[index1] = num;
             this.inext = index1;
             this.inextp = index2;
-            return unchecked((uint) num);
+            return unchecked((uint)num);
         }
 
         public override double NextDouble()
@@ -84,15 +91,14 @@
             do
             {
                 generated = unchecked((int)NextUint()) * 4.6566128752458E-10;
-            }
-            while (generated < 0 || 1 <= generated);
+            } while (generated < 0 || 1 <= generated);
 
             return generated;
         }
 
         public override float NextFloat()
         {
-            return (float) NextDouble();
+            return (float)NextDouble();
         }
 
         public override IRandom Copy()

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: d00769758e05b2f478ea85ce53650d44
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: d00769758e05b2f478ea85ce53650d44
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

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

@@ -1,11 +1,11 @@
-fileFormatVersion: 2
-guid: 0d9f5b15009b2ff48ba3d66fd8a7fc53
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
+fileFormatVersion: 2
+guid: 0d9f5b15009b2ff48ba3d66fd8a7fc53
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Core/Random/UnityRandom.cs

@@ -1,16 +1,51 @@
 namespace UnityHelpers.Core.Random
 {
     using System;
+    using System.Runtime.Serialization;
+    using System.Text.Json.Serialization;
 
+    [Serializable]
+    [DataContract]
     public sealed class UnityRandom : AbstractRandom
     {
-        public static readonly UnityRandom Instance = new UnityRandom();
+        public static readonly UnityRandom Instance = new();
 
-        private UnityRandom()
+        [JsonPropertyName("State")]
+        [DataMember(Name = "State")]
+        public override RandomState InternalState
         {
+            get
+            {
+                unchecked
+                {
+                    return new RandomState(
+                        (ulong)(_seed ?? 0),
+                        gaussian: _seed != null ? 0.0 : null
+                    );
+                }
+            }
+        }
+
+        private readonly int? _seed;
+
+        public UnityRandom(int? seed = null)
+        {
+            if (seed != null)
+            {
+                _seed = seed.Value;
+                UnityEngine.Random.InitState(seed.Value);
+            }
+        }
+
+        [JsonConstructor]
+        public UnityRandom(RandomState state)
+        {
+            unchecked
+            {
+                _seed = state.Gaussian != null ? (int)state.State1 : null;
+            }
         }
 
-        public override RandomState InternalState => throw new NotSupportedException("Unity Random does not expose its internal state");
         public override uint NextUint()
         {
             return unchecked((uint)UnityEngine.Random.Range(int.MinValue, int.MaxValue));
@@ -18,7 +53,7 @@
 
         public override IRandom Copy()
         {
-            throw new NotSupportedException("Unity Random does not support copying / seeding");
+            return new UnityRandom(_seed);
         }
     }
 }