com.wallstop-studios.unity-helpers 2.0.0 → 2.0.1

package/Tests/Runtime/Integrations/VContainer/RelationalObjectPoolsVContainerTests.cs

@@ -1,7 +1,6 @@
 #if VCONTAINER_PRESENT
 namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
 {
-    using System;
     using global::VContainer;
     using NUnit.Framework;
     using UnityEngine;
@@ -12,10 +11,16 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
 
     public sealed class RelationalObjectPoolsVContainerTests : CommonTestBase
     {
+        [SetUp]
+        public void CommonSetup()
+        {
+            ReflexTestSupport.EnsureReflexSettings();
+        }
+
         [Test]
         public void ComponentPoolGetWithRelationsInjectsAndAssigns()
         {
-            ContainerBuilder builder = new ContainerBuilder();
+            ContainerBuilder builder = new();
             IObjectResolver resolver = builder.Build();
 
             ObjectPool<TestComponent> pool = RelationalObjectPools.CreatePoolWithRelations(
@@ -46,7 +51,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
         [Test]
         public void GameObjectPoolGetWithRelationsInjectsAndAssigns()
         {
-            ContainerBuilder builder = new ContainerBuilder();
+            ContainerBuilder builder = new();
             IObjectResolver resolver = builder.Build();
 
             GameObject prefab = Track(new GameObject("PrefabRoot"));

package/Tests/Runtime/Integrations/Zenject/RelationalComponentsZenjectTests.cs

@@ -20,6 +20,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.Zenject
         [SetUp]
         public void Setup()
         {
+            ReflexTestSupport.EnsureReflexSettings();
             Container = new DiContainer();
         }
 
@@ -200,16 +201,12 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.Zenject
         public System.Collections.IEnumerator SceneLoadListenerAssignsAdditiveSceneSinglePass()
         {
             AttributeMetadataCache cache = CreateCacheFor(typeof(ZenjectRelationalTester));
-            RelationalComponentAssigner assigner = new RelationalComponentAssigner(cache);
-            RelationalSceneAssignmentOptions options = new RelationalSceneAssignmentOptions(
+            RelationalComponentAssigner assigner = new(cache);
+            RelationalSceneAssignmentOptions options = new(
                 includeInactive: true,
                 useSinglePassScan: true
             );
-            RelationalSceneLoadListener listener = new RelationalSceneLoadListener(
-                assigner,
-                cache,
-                options
-            );
+            RelationalSceneLoadListener listener = new(assigner, cache, options);
             listener.Initialize();
             TrackDisposable(listener);
 
@@ -238,16 +235,12 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.Zenject
         public System.Collections.IEnumerator SceneLoadListenerAssignsAdditiveSceneMultiPass()
         {
             AttributeMetadataCache cache = CreateCacheFor(typeof(ZenjectRelationalTester));
-            RelationalComponentAssigner assigner = new RelationalComponentAssigner(cache);
-            RelationalSceneAssignmentOptions options = new RelationalSceneAssignmentOptions(
+            RelationalComponentAssigner assigner = new(cache);
+            RelationalSceneAssignmentOptions options = new(
                 includeInactive: true,
                 useSinglePassScan: false
             );
-            RelationalSceneLoadListener listener = new RelationalSceneLoadListener(
-                assigner,
-                cache,
-                options
-            );
+            RelationalSceneLoadListener listener = new(assigner, cache, options);
             listener.Initialize();
             TrackDisposable(listener);
 
@@ -526,14 +519,14 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.Zenject
 
             AttributeMetadataCache.RelationalFieldMetadata[] fields =
             {
-                new AttributeMetadataCache.RelationalFieldMetadata(
+                new(
                     nameof(ZenjectRelationalTester.parentBody),
                     AttributeMetadataCache.RelationalAttributeKind.Parent,
                     AttributeMetadataCache.FieldKind.Single,
                     typeof(Rigidbody).AssemblyQualifiedName,
                     isInterface: false
                 ),
-                new AttributeMetadataCache.RelationalFieldMetadata(
+                new(
                     nameof(ZenjectRelationalTester.childCollider),
                     AttributeMetadataCache.RelationalAttributeKind.Child,
                     AttributeMetadataCache.FieldKind.Single,
@@ -544,10 +537,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.Zenject
 
             AttributeMetadataCache.RelationalTypeMetadata[] relationalTypes =
             {
-                new AttributeMetadataCache.RelationalTypeMetadata(
-                    componentType.AssemblyQualifiedName,
-                    fields
-                ),
+                new(componentType.AssemblyQualifiedName, fields),
             };
 
             cache._relationalTypeMetadata = relationalTypes;

package/Tests/Runtime/Performance/RandomPerformanceTests.cs

@@ -41,7 +41,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Performance
             BenchmarkReadmeUpdater.UpdateSection(
                 "RANDOM_BENCHMARKS",
                 tableLines,
-                "RANDOM_PERFORMANCE.md"
+                "Docs/RANDOM_PERFORMANCE.md"
             );
 
             void LogRow(string row)

package/Tests/Runtime/Performance/SpatialTree2DPerformanceTests.cs

@@ -294,7 +294,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Performance
             BenchmarkReadmeUpdater.UpdateSection(
                 "SPATIAL_TREE_BENCHMARKS",
                 finalReadmeLines,
-                "SPATIAL_TREE_2D_PERFORMANCE.md"
+                "Docs/SPATIAL_TREE_2D_PERFORMANCE.md"
             );
 
             yield break;

package/Tests/Runtime/Performance/SpatialTree3DPerformanceTests.cs

@@ -265,7 +265,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Performance
             BenchmarkReadmeUpdater.UpdateSection(
                 "SPATIAL_TREE_3D_BENCHMARKS",
                 finalReadmeLines,
-                "SPATIAL_TREE_3D_PERFORMANCE.md"
+                "Docs/SPATIAL_TREE_3D_PERFORMANCE.md"
             );
 
             yield break;

package/Tests/Runtime/Serialization/JsonRoundtripComprehensiveTests.cs

@@ -31,14 +31,9 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void AdaptersCollectionsRoundTrip()
         {
-            List<FastVector3Int> list = new List<FastVector3Int>
-            {
-                new(1, 2, 3),
-                new(-4, 5, -6),
-                new(7, 0, -1),
-            };
+            List<FastVector3Int> list = new() { new(1, 2, 3), new(-4, 5, -6), new(7, 0, -1) };
 
-            Dictionary<string, FastVector2Int> map = new Dictionary<string, FastVector2Int>
+            Dictionary<string, FastVector2Int> map = new()
             {
                 ["a"] = new(9, -9),
                 ["b"] = new(0, 1),
@@ -76,7 +71,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void CompositePayloadRoundTrips()
         {
-            CompositePayload payload = new CompositePayload
+            CompositePayload payload = new()
             {
                 fv2 = new FastVector2Int(-3, 7),
                 fv3 = new FastVector3Int(1, -2, 3),
@@ -147,7 +142,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void CompositePayloadRoundTripsWithFastOptions()
         {
-            CompositePayload payload = new CompositePayload
+            CompositePayload payload = new()
             {
                 fv2 = new FastVector2Int(9, -4),
                 fv3 = new FastVector3Int(5, 6, -7),

package/Tests/Runtime/Serialization/ProtoRoundtripComprehensiveTests.cs

@@ -38,7 +38,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void Vector2RoundTrip()
         {
-            Vector2 v = new Vector2(1.5f, -2.25f);
+            Vector2 v = new(1.5f, -2.25f);
             Vector2 again = RoundTrip(v);
             Assert.AreEqual(v.x, again.x, 0f, "Vector2 x should match");
             Assert.AreEqual(v.y, again.y, 0f, "Vector2 y should match");
@@ -47,7 +47,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void Vector3RoundTrip()
         {
-            Vector3 v = new Vector3(-1.5f, 2.75f, 3.25f);
+            Vector3 v = new(-1.5f, 2.75f, 3.25f);
             Vector3 again = RoundTrip(v);
             Assert.AreEqual(v.x, again.x, 0f, "Vector3 x should match");
             Assert.AreEqual(v.y, again.y, 0f, "Vector3 y should match");
@@ -57,12 +57,12 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void Vector2IntAndVector3IntRoundTrip()
         {
-            Vector2Int v2i = new Vector2Int(int.MinValue + 1, int.MaxValue - 1);
+            Vector2Int v2i = new(int.MinValue + 1, int.MaxValue - 1);
             Vector2Int v2iAgain = RoundTrip(v2i);
             Assert.AreEqual(v2i.x, v2iAgain.x, "Vector2Int x should match");
             Assert.AreEqual(v2i.y, v2iAgain.y, "Vector2Int y should match");
 
-            Vector3Int v3i = new Vector3Int(1, -2, 3);
+            Vector3Int v3i = new(1, -2, 3);
             Vector3Int v3iAgain = RoundTrip(v3i);
             Assert.AreEqual(v3i.x, v3iAgain.x, "Vector3Int x should match");
             Assert.AreEqual(v3i.y, v3iAgain.y, "Vector3Int y should match");
@@ -72,7 +72,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void QuaternionRoundTrip()
         {
-            Quaternion q = new Quaternion(0.1f, 0.2f, 0.3f, 0.9f);
+            Quaternion q = new(0.1f, 0.2f, 0.3f, 0.9f);
             Quaternion again = RoundTrip(q);
             Assert.AreEqual(q.x, again.x, 0f, "Quaternion x should match");
             Assert.AreEqual(q.y, again.y, 0f, "Quaternion y should match");
@@ -83,14 +83,14 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void ColorAndColor32RoundTrip()
         {
-            Color c = new Color(0.1f, 0.2f, 0.3f, 0.4f);
+            Color c = new(0.1f, 0.2f, 0.3f, 0.4f);
             Color cAgain = RoundTrip(c);
             Assert.AreEqual(c.r, cAgain.r, 0f, "Color r should match");
             Assert.AreEqual(c.g, cAgain.g, 0f, "Color g should match");
             Assert.AreEqual(c.b, cAgain.b, 0f, "Color b should match");
             Assert.AreEqual(c.a, cAgain.a, 0f, "Color a should match");
 
-            Color32 c32 = new Color32(10, 20, 30, 40);
+            Color32 c32 = new(10, 20, 30, 40);
             Color32 c32Again = RoundTrip(c32);
             Assert.AreEqual(c32.r, c32Again.r, "Color32 r should match");
             Assert.AreEqual(c32.g, c32Again.g, "Color32 g should match");
@@ -113,11 +113,11 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void RectAndRectIntRoundTrip()
         {
-            Rect r = new Rect(1.5f, 2.5f, 10f, 20f);
+            Rect r = new(1.5f, 2.5f, 10f, 20f);
             Rect rAgain = RoundTrip(r);
             Assert.AreEqual(r, rAgain, "Rect should round-trip by value");
 
-            RectInt ri = new RectInt(1, 2, 3, 4);
+            RectInt ri = new(1, 2, 3, 4);
             RectInt riAgain = RoundTrip(ri);
             Assert.AreEqual(ri, riAgain, "RectInt should round-trip by value");
         }
@@ -125,12 +125,12 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void BoundsAndBoundsIntRoundTrip()
         {
-            Bounds b = new Bounds(new Vector3(1, 2, 3), new Vector3(4, 5, 6));
+            Bounds b = new(new Vector3(1, 2, 3), new Vector3(4, 5, 6));
             Bounds bAgain = RoundTrip(b);
             Assert.AreEqual(b.center, bAgain.center, "Bounds center should round-trip");
             Assert.AreEqual(b.size, bAgain.size, "Bounds size should round-trip");
 
-            BoundsInt bi = new BoundsInt(new Vector3Int(1, 2, 3), new Vector3Int(4, 5, 6));
+            BoundsInt bi = new(new Vector3Int(1, 2, 3), new Vector3Int(4, 5, 6));
             BoundsInt biAgain = RoundTrip(bi);
             Assert.AreEqual(bi.position, biAgain.position, "BoundsInt position should round-trip");
             Assert.AreEqual(bi.size, biAgain.size, "BoundsInt size should round-trip");
@@ -139,7 +139,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void ResolutionRoundTrip()
         {
-            Resolution r = new Resolution { width = 800, height = 600 };
+            Resolution r = new() { width = 800, height = 600 };
             Resolution rAgain = RoundTrip(r);
             Assert.AreEqual(r.width, rAgain.width, "Resolution width should round-trip");
             Assert.AreEqual(r.height, rAgain.height, "Resolution height should round-trip");
@@ -219,7 +219,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Serialization
         [Test]
         public void CompositePayloadWithCollectionsRoundTrips()
         {
-            Composite payload = new Composite
+            Composite payload = new()
             {
                 fv2 = new FastVector2Int(-3, 7),
                 fv3 = new FastVector3Int(1, -2, 3),

package/Tests/Runtime/TestUtils/CommonTestBase.cs

@@ -16,6 +16,17 @@ namespace WallstopStudios.UnityHelpers.Tests.TestUtils
     /// </summary>
     public abstract class CommonTestBase
     {
+        /// <summary>
+        /// Ensures ReflexSettings singleton is present when the Reflex package is installed so tests do not hit assertions.
+        /// </summary>
+        [SetUp]
+        public virtual void BaseSetUp()
+        {
+#if REFLEX_PRESENT
+            ReflexTestSupport.EnsureReflexSettings();
+#endif
+        }
+
         // Per-test tracked UnityEngine.Objects
         protected readonly List<Object> _trackedObjects = new();
 

package/Tests/Runtime/TestUtils/ReflexTestSupport.cs

@@ -0,0 +1,111 @@
+#if REFLEX_PRESENT
+namespace WallstopStudios.UnityHelpers.Tests.TestUtils
+{
+    using System;
+    using System.Collections.Generic;
+    using System.Linq;
+    using System.Reflection;
+    using UnityEngine;
+
+    public static class ReflexTestSupport
+    {
+        private const string ReflexSettingsTypeName = "Reflex.Configuration.ReflexSettings";
+        private const string InstanceFieldName = "_instance";
+        private const string LogLevelBackingFieldName = "<LogLevel>k__BackingField";
+        private const string ProjectScopesBackingFieldName = "<ProjectScopes>k__BackingField";
+        private const string LogLevelTypeName = "Reflex.Logging.LogLevel";
+        private const string ProjectScopeTypeName = "Reflex.Core.ProjectScope";
+
+        private static bool _initialized;
+
+        public static void EnsureReflexSettings()
+        {
+            if (_initialized)
+            {
+                return;
+            }
+
+            Type settingsType = FindType(ReflexSettingsTypeName);
+            if (settingsType == null)
+            {
+                return;
+            }
+
+            FieldInfo instanceField = settingsType.GetField(
+                InstanceFieldName,
+                BindingFlags.NonPublic | BindingFlags.Static
+            );
+            if (instanceField == null)
+            {
+                return;
+            }
+
+            object currentInstance = instanceField.GetValue(null);
+            if (currentInstance == null)
+            {
+                ScriptableObject settings = ScriptableObject.CreateInstance(settingsType);
+                SetInstanceField(
+                    settingsType,
+                    settings,
+                    LogLevelBackingFieldName,
+                    GetLogLevelInfo()
+                );
+                SetInstanceField(
+                    settingsType,
+                    settings,
+                    ProjectScopesBackingFieldName,
+                    CreateEmptyProjectScopesList()
+                );
+                instanceField.SetValue(null, settings);
+            }
+
+            _initialized = true;
+        }
+
+        private static void SetInstanceField(
+            Type declaringType,
+            object instance,
+            string fieldName,
+            object value
+        )
+        {
+            FieldInfo field = declaringType.GetField(
+                fieldName,
+                BindingFlags.Instance | BindingFlags.NonPublic
+            );
+            field?.SetValue(instance, value);
+        }
+
+        private static object GetLogLevelInfo()
+        {
+            Type logLevelType = FindType(LogLevelTypeName);
+            if (logLevelType == null)
+            {
+                return null;
+            }
+
+            return Enum.Parse(logLevelType, "Info", ignoreCase: true);
+        }
+
+        private static object CreateEmptyProjectScopesList()
+        {
+            Type projectScopeType = FindType(ProjectScopeTypeName);
+            if (projectScopeType == null)
+            {
+                return null;
+            }
+
+            Type listType = typeof(List<>).MakeGenericType(projectScopeType);
+            return Activator.CreateInstance(listType);
+        }
+
+        private static Type FindType(string fullName)
+        {
+            return AppDomain
+                .CurrentDomain.GetAssemblies()
+                .Select(assembly => assembly.GetType(fullName))
+                .FirstOrDefault(type => type != null);
+        }
+    }
+}
+#endif

package/Tests/Runtime/TestUtils/ReflexTestSupport.cs.meta

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

package/Tests/Runtime/Utils/MatchColliderToSpriteTests.cs

@@ -26,10 +26,10 @@ namespace WallstopStudios.UnityHelpers.Tests.Utils
             // Define a physics shape for the sprite (a simple rectangle)
             Vector2[] physicsShape =
             {
-                new Vector2(-0.5f, -0.5f),
-                new Vector2(-0.5f, 0.5f),
-                new Vector2(0.5f, 0.5f),
-                new Vector2(0.5f, -0.5f),
+                new(-0.5f, -0.5f),
+                new(-0.5f, 0.5f),
+                new(0.5f, 0.5f),
+                new(0.5f, -0.5f),
             };
             _testSprite.OverridePhysicsShape(new[] { physicsShape });
         }

package/Tests/TestUtils.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: e7e2ac7ef9eb44199df1d8b995b21799
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.wallstop-studios.unity-helpers",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "displayName": "Unity Helpers",
   "description": "Various Unity Helper Library",
   "dependencies": {},
@@ -43,6 +43,11 @@
       "description": "SceneContext installer, scene-wide assignment, and prefab instantiation with relations.",
       "path": "Samples~/DI - Zenject"
     },
+    {
+      "displayName": "DI – Reflex",
+      "description": "SceneScope installer, scene scan, and runtime Container helpers.",
+      "path": "Samples~/DI - Reflex"
+    },
     {
       "displayName": "Relational Components – Basic",
       "description": "Attribute-based auto-wiring without DI; parent/sibling/child examples.",