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

package/Samples~/DI - Zenject/Scripts/SpawnerZenject.cs

@@ -7,14 +7,85 @@ namespace Samples.UnityHelpers.DI.Zenject
     public sealed class SpawnerZenject : MonoBehaviour
     {
         [SerializeField]
-        private RelationalConsumer _prefab;
+        private RelationalConsumer _componentPrefab;
+
+        [SerializeField]
+        private GameObject _hierarchyPrefab;
+
+        [SerializeField]
+        private Transform _defaultParent;
 
         [Inject]
         private DiContainer _container;
 
-        public RelationalConsumer Build(Transform parent)
+        [Inject(Optional = true)]
+        private RelationalConsumerPool _pool;
+
+        /// <summary>
+        /// Instantiate a component prefab through Zenject so dependencies and relational fields are populated automatically.
+        /// </summary>
+        public RelationalConsumer SpawnComponent(Transform parent)
+        {
+            Transform targetParent = parent != null ? parent : _defaultParent;
+            return _container.InstantiateComponentWithRelations(_componentPrefab, targetParent);
+        }
+
+        /// <summary>
+        /// Instantiate a hierarchy prefab and hydrate every attributed component beneath it.
+        /// </summary>
+        public GameObject SpawnHierarchy(Transform parent)
+        {
+            Transform targetParent = parent != null ? parent : _defaultParent;
+            return _container.InstantiateGameObjectWithRelations(
+                _hierarchyPrefab,
+                targetParent,
+                includeInactiveChildren: true
+            );
+        }
+
+        /// <summary>
+        /// Rent an instance from a Zenject memory pool (falls back to SpawnComponent when the pool is not bound).
+        /// </summary>
+        public RelationalConsumer SpawnFromPool(Transform parent)
+        {
+            if (_pool == null)
+            {
+                return SpawnComponent(parent);
+            }
+
+            RelationalConsumer instance = _pool.Spawn();
+            Transform targetParent = parent != null ? parent : _defaultParent;
+            if (targetParent != null)
+            {
+                instance.transform.SetParent(targetParent, false);
+            }
+            return instance;
+        }
+
+        /// <summary>
+        /// Return an instance to the pool.
+        /// </summary>
+        public void DespawnToPool(RelationalConsumer instance)
         {
-            return _container.InstantiateComponentWithRelations(_prefab, parent);
+            if (_pool == null || instance == null)
+            {
+                return;
+            }
+
+            _pool.Despawn(instance);
+        }
+
+        /// <summary>
+        /// Hydrate an existing hierarchy that was created outside of the container (editor tooling etc.).
+        /// </summary>
+        public void HydrateExistingHierarchy(GameObject root)
+        {
+            if (root == null)
+            {
+                return;
+            }
+
+            _container.AssignRelationalHierarchy(root, includeInactiveChildren: true);
         }
     }
 }

package/Samples~/Random - PRNG/README.md

@@ -3,10 +3,11 @@ Random – PRNG Utilities
 Shows quick usage of the high-quality PRNGs (e.g., PCG) for integers, floats, Gaussian values, and sampling from collections.
 
 How to use
+
 - Add `RandomPrngDemo` to any GameObject and press Play.
 - Optionally change the `seed` in the inspector for deterministic sequences.
 
 What it shows
+
 - `PcgRandom` construction with a seed and sampling `Next`, `NextFloat`, `NextGaussian`.
 - `NextOf` to pick elements from lists.
-

package/Samples~/Relational Components - Basic/README.md

@@ -3,17 +3,19 @@ Relational Components – Basic
 This sample demonstrates the built-in Relational Component Attributes without any DI container. Attach the script to a GameObject hierarchy and the fields are auto-assigned at runtime.
 
 How to use
+
 - Open any scene and create a simple hierarchy with a parent, a child, and a sibling next to the consumer object.
 - Add `RelationalBasicConsumer` to the child object.
 - Enter Play Mode and check the Console for the assigned references.
 
 What it shows
+
 - `[ParentComponent]` finds components on ancestors (configurable depth).
 - `[SiblingComponent]` finds components on the same GameObject.
 - `[ChildComponent]` finds components on children (recursively).
 - `this.AssignRelationalComponents()` hydrates all relational fields in `Awake()`/`OnEnable()`.
 
 Notes
+
 - You can adjust filters on attributes: `Optional`, `IncludeInactive`, `TagFilter`, `NameFilter`, and `MaxCount` for collections.
 - For DI integrations, see the separate VContainer/Zenject samples.
-

package/Samples~/Serialization - JSON/README.md

@@ -3,11 +3,12 @@ Serialization – JSON Converters
 Demonstrates serialization of Unity types using System.Text.Json with Unity Helpers’ built-in converters and helper APIs.
 
 How to use
+
 - Add `JsonSerializationDemo` to any GameObject and press Play.
 - Check the Console for serialized JSON, byte sizes, and a round-trip decode.
 
 What it shows
+
 - `Serializer.JsonStringify` and `Serializer.JsonDeserialize<T>` for text workflows.
 - `Serializer.JsonSerialize` and `Serializer.JsonDeserialize<T>(byte[])` for UTF-8 bytes.
 - Using `Serializer.CreateFastJsonOptions()` for hot paths.
-

package/Samples~/Spatial Structures - 2D and 3D/README.md

@@ -3,11 +3,12 @@ Spatial Structures – 2D and 3D
 Demonstrates building and querying spatial structures for static point sets and grid-based indexing.
 
 How to use
+
 - Add `SpatialStructuresDemo` to any GameObject and press Play.
 - Adjust `pointCount`, `areaSize`, and `queryRadius` in the inspector.
 
 What it shows
+
 - `QuadTree2D<T>` created from points with a transformer and radius query.
 - `KdTree2D<T>` approximate nearest neighbors.
 - `SpatialHash2D<T>` bucketed insertion and radius query.
-

package/Samples~/UGUI - EnhancedImage/README.md

@@ -3,10 +3,11 @@ UGUI – EnhancedImage
 Shows programmatic setup and basic usage of `EnhancedImage` with HDR tinting.
 
 How to use
+
 - Add `EnhancedImageDemo` to an empty scene and press Play.
 - Optionally assign a `materialTemplate` in the inspector to use a shader that exposes `_Color` and optional `_ShapeMask`.
 
 What it shows
+
 - Creating a `Canvas` and an `EnhancedImage` at runtime.
 - Setting an HDR tint via `HdrColor` (values > 1).
-

package/Samples~/UI Toolkit - MultiFile Selector (Editor)/README.md

@@ -3,10 +3,11 @@ UI Toolkit – MultiFile Selector (Editor)
 A minimal EditorWindow showcasing `MultiFileSelectorElement` for fast in-Editor multi-file selection with breadcrumbs, filtering and virtualization.
 
 How to use
+
 - Import the sample, then open: `Window > Unity Helpers > MultiFile Selector Sample`.
 - Pick extensions and select multiple files; results are logged to the Console.
 
 What it shows
+
 - Creating and adding `MultiFileSelectorElement` to an EditorWindow.
 - Hooks for `OnFilesSelected` and `OnCancelled`.
-

package/Tests/Editor/Attributes/AnimationEventHelpersTests.cs

@@ -93,6 +93,22 @@ namespace WallstopStudios.UnityHelpers.Tests.Editor.Attributes
 
             CollectionAssert.AreEquivalent(expected, methods.Select(method => method.Name));
         }
+
+        [Test]
+        public void GetPossibleAnimatorEventsAreSortedByName()
+        {
+            List<MethodInfo> methods = AnimationEventHelpers.GetPossibleAnimatorEventsForType(
+                typeof(AnimationEventSignatureHost)
+            );
+            // Ensure ascending ordinal sort by method name
+            for (int i = 1; i < methods.Count; i++)
+            {
+                Assert.LessOrEqual(
+                    string.Compare(methods[i - 1].Name, methods[i].Name, StringComparison.Ordinal),
+                    0
+                );
+            }
+        }
     }
 
     internal enum AnimationEventSignal

package/Tests/Editor/Core/Attributes/RelationalComponentAssignerTests.cs

@@ -28,20 +28,19 @@ namespace WallstopStudios.UnityHelpers.Tests.Core.Attributes
         {
             AttributeMetadataCache cache = CreateScriptableObject<AttributeMetadataCache>();
 
-            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata =
-                new AttributeMetadataCache.RelationalTypeMetadata(
-                    typeof(RelationalConsumer).AssemblyQualifiedName,
-                    new[]
-                    {
-                        new AttributeMetadataCache.RelationalFieldMetadata(
-                            "_spriteRenderer",
-                            AttributeMetadataCache.RelationalAttributeKind.Sibling,
-                            AttributeMetadataCache.FieldKind.Single,
-                            typeof(SpriteRenderer).AssemblyQualifiedName,
-                            false
-                        ),
-                    }
-                );
+            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata = new(
+                typeof(RelationalConsumer).AssemblyQualifiedName,
+                new[]
+                {
+                    new AttributeMetadataCache.RelationalFieldMetadata(
+                        "_spriteRenderer",
+                        AttributeMetadataCache.RelationalAttributeKind.Sibling,
+                        AttributeMetadataCache.FieldKind.Single,
+                        typeof(SpriteRenderer).AssemblyQualifiedName,
+                        false
+                    ),
+                }
+            );
 
             cache.SetMetadata(
                 System.Array.Empty<string>(),
@@ -50,7 +49,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Core.Attributes
             );
             cache.ForceRebuildForTests();
 
-            RelationalComponentAssigner assigner = new RelationalComponentAssigner(cache);
+            RelationalComponentAssigner assigner = new(cache);
 
             Assert.IsTrue(
                 assigner.HasRelationalAssignments(typeof(RelationalConsumer)),
@@ -67,20 +66,19 @@ namespace WallstopStudios.UnityHelpers.Tests.Core.Attributes
         {
             AttributeMetadataCache cache = CreateScriptableObject<AttributeMetadataCache>();
 
-            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata =
-                new AttributeMetadataCache.RelationalTypeMetadata(
-                    typeof(RelationalConsumer).AssemblyQualifiedName,
-                    new[]
-                    {
-                        new AttributeMetadataCache.RelationalFieldMetadata(
-                            "_spriteRenderer",
-                            AttributeMetadataCache.RelationalAttributeKind.Sibling,
-                            AttributeMetadataCache.FieldKind.Single,
-                            typeof(SpriteRenderer).AssemblyQualifiedName,
-                            false
-                        ),
-                    }
-                );
+            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata = new(
+                typeof(RelationalConsumer).AssemblyQualifiedName,
+                new[]
+                {
+                    new AttributeMetadataCache.RelationalFieldMetadata(
+                        "_spriteRenderer",
+                        AttributeMetadataCache.RelationalAttributeKind.Sibling,
+                        AttributeMetadataCache.FieldKind.Single,
+                        typeof(SpriteRenderer).AssemblyQualifiedName,
+                        false
+                    ),
+                }
+            );
 
             cache.SetMetadata(
                 System.Array.Empty<string>(),
@@ -89,7 +87,7 @@ namespace WallstopStudios.UnityHelpers.Tests.Core.Attributes
             );
             cache.ForceRebuildForTests();
 
-            RelationalComponentAssigner assigner = new RelationalComponentAssigner(cache);
+            RelationalComponentAssigner assigner = new(cache);
 
             GameObject go1 = NewGameObject("Relational");
             SpriteRenderer sr1 = go1.AddComponent<SpriteRenderer>();
@@ -98,13 +96,13 @@ namespace WallstopStudios.UnityHelpers.Tests.Core.Attributes
             GameObject go2 = NewGameObject("NonRelational");
             NonRelational non = go2.AddComponent<NonRelational>();
 
-            Assert.IsNull(consumer.SR, "Precondition: relational field should start null");
+            Assert.IsTrue(consumer.SR == null, "Precondition: relational field should start null");
 
-            List<Component> items = new List<Component> { consumer, null, non.transform };
+            List<Component> items = new() { consumer, null, non.transform };
             assigner.Assign(items);
 
-            Assert.IsNotNull(
-                consumer.SR,
+            Assert.IsTrue(
+                consumer.SR != null,
                 "Relational field should be assigned by Assign(IEnumerable<Component>)"
             );
 

package/Tests/Editor/Integrations/Reflex/ReflexIntegrationCompilationTests.cs

@@ -0,0 +1,41 @@
+#if REFLEX_PRESENT
+namespace WallstopStudios.UnityHelpers.Tests.Integrations.Reflex
+{
+    using System.Reflection;
+    using NUnit.Framework;
+    using WallstopStudios.UnityHelpers.Integrations.Reflex;
+
+    public sealed class ReflexIntegrationCompilationTests
+    {
+        [Test]
+        public void CanReferenceReflexIntegrationTypes()
+        {
+            Assert.NotNull(
+                typeof(RelationalComponentsInstaller),
+                "RelationalComponentsInstaller should be available when REFLEX_PRESENT is defined."
+            );
+            Assert.NotNull(
+                typeof(ContainerRelationalExtensions),
+                "ContainerRelationalExtensions should be available when REFLEX_PRESENT is defined."
+            );
+            Assert.NotNull(
+                typeof(RelationalSceneAssignmentOptions),
+                "RelationalSceneAssignmentOptions should be available when REFLEX_PRESENT is defined."
+            );
+        }
+
+        [Test]
+        public void PublicExtensionMethodsAccessible()
+        {
+            MethodInfo method = typeof(ContainerRelationalExtensions).GetMethod(
+                "AssignRelationalComponents",
+                BindingFlags.Public | BindingFlags.Static
+            );
+            Assert.NotNull(
+                method,
+                "AssignRelationalComponents extension method should be discoverable."
+            );
+        }
+    }
+}
+#endif

package/Tests/Editor/Integrations/Reflex/ReflexIntegrationCompilationTests.cs.meta

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

package/Tests/Editor/Integrations/Reflex/WallstopStudios.UnityHelpers.Tests.Editor.Reflex.asmdef

@@ -0,0 +1,27 @@
+{
+  "name": "WallstopStudios.UnityHelpers.Tests.Editor.Reflex",
+  "rootNamespace": "WallstopStudios.UnityHelpers.Tests.Integrations.Reflex",
+  "references": [
+    "UnityEditor.TestRunner",
+    "UnityEngine.TestRunner",
+    "WallstopStudios.UnityHelpers",
+    "WallstopStudios.UnityHelpers.Integration.Reflex",
+    "WallstopStudios.UnityHelpers.Tests.Editor",
+    "Reflex"
+  ],
+  "includePlatforms": ["Editor"],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": true,
+  "precompiledReferences": ["nunit.framework.dll"],
+  "autoReferenced": false,
+  "defineConstraints": ["UNITY_INCLUDE_TESTS", "REFLEX_PRESENT"],
+  "versionDefines": [
+    {
+      "name": "com.gustavopsantos.reflex",
+      "expression": "0.0.1",
+      "define": "REFLEX_PRESENT"
+    }
+  ],
+  "noEngineReferences": false
+}

package/Tests/Editor/Integrations/Reflex/WallstopStudios.UnityHelpers.Tests.Editor.Reflex.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 1af741409dac4694ad2c4d35e798679f
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Tests/Editor/Integrations/Reflex.meta

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

package/Tests/Editor/Integrations/VContainer/VContainerRelationalEntryPointTests.cs

@@ -34,20 +34,19 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
 
             AttributeMetadataCache cache = CreateScriptableObject<AttributeMetadataCache>();
 #if UNITY_EDITOR
-            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata =
-                new AttributeMetadataCache.RelationalTypeMetadata(
-                    typeof(Consumer).AssemblyQualifiedName,
-                    new[]
-                    {
-                        new AttributeMetadataCache.RelationalFieldMetadata(
-                            "_spriteRenderer",
-                            AttributeMetadataCache.RelationalAttributeKind.Sibling,
-                            AttributeMetadataCache.FieldKind.Single,
-                            typeof(SpriteRenderer).AssemblyQualifiedName,
-                            false
-                        ),
-                    }
-                );
+            AttributeMetadataCache.RelationalTypeMetadata relationalMetadata = new(
+                typeof(Consumer).AssemblyQualifiedName,
+                new[]
+                {
+                    new AttributeMetadataCache.RelationalFieldMetadata(
+                        "_spriteRenderer",
+                        AttributeMetadataCache.RelationalAttributeKind.Sibling,
+                        AttributeMetadataCache.FieldKind.Single,
+                        typeof(SpriteRenderer).AssemblyQualifiedName,
+                        false
+                    ),
+                }
+            );
 
             cache.SetMetadata(
                 System.Array.Empty<string>(),
@@ -55,10 +54,11 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
                 new[] { relationalMetadata }
             );
             cache.ForceRebuildForTests();
+            yield return null;
 #endif
 
-            RelationalComponentAssigner assigner = new RelationalComponentAssigner(cache);
-            RelationalComponentEntryPoint entry = new RelationalComponentEntryPoint(
+            RelationalComponentAssigner assigner = new(cache);
+            RelationalComponentEntryPoint entry = new(
                 assigner,
                 cache,
                 RelationalSceneAssignmentOptions.Default
@@ -69,8 +69,11 @@ namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
             // Allow assignment to complete
             yield return null;
 
-            Assert.NotNull(consumer);
-            Assert.NotNull(consumer.SR, "Relational field should be assigned by entry point");
+            Assert.IsTrue(consumer != null);
+            Assert.IsTrue(
+                consumer.SR != null,
+                "Relational field should be assigned by entry point"
+            );
         }
     }
 }

package/Tests/Editor/Integrations/VContainer/VContainerRelationalHelpersTests.cs

@@ -0,0 +1,164 @@
+#if VCONTAINER_PRESENT
+namespace WallstopStudios.UnityHelpers.Tests.Integrations.VContainer
+{
+    using global::VContainer;
+    using NUnit.Framework;
+    using UnityEngine;
+    using WallstopStudios.UnityHelpers.Core.Attributes;
+    using WallstopStudios.UnityHelpers.Integrations.VContainer;
+    using WallstopStudios.UnityHelpers.Tags;
+    using WallstopStudios.UnityHelpers.Tests.Editor.Utils;
+
+    public sealed class VContainerRelationalHelpersTests : CommonTestBase
+    {
+        private sealed class TestComponent : MonoBehaviour
+        {
+            [ParentComponent(OnlyAncestors = true)]
+            public Rigidbody parentBody;
+
+            [ChildComponent(OnlyDescendants = true)]
+            public CapsuleCollider childCollider;
+        }
+
+        [Test]
+        public void InjectWithRelationsAssignsFields()
+        {
+            ContainerBuilder builder = new();
+            IObjectResolver resolver = builder.Build();
+
+            // Build hierarchy: Parent(Rigidbody) -> Middle(TestComponent) -> Child(CapsuleCollider)
+            GameObject parent = NewGameObject("Parent");
+            parent.AddComponent<Rigidbody>();
+            GameObject middle = NewGameObject("Middle");
+            middle.transform.SetParent(parent.transform);
+            TestComponent comp = middle.AddComponent<TestComponent>();
+            GameObject child = NewGameObject("Child");
+            child.transform.SetParent(middle.transform);
+            child.AddComponent<CapsuleCollider>();
+
+            TestComponent result = resolver.InjectWithRelations(comp);
+
+            Assert.That(result, Is.SameAs(comp));
+            Assert.IsTrue(comp.parentBody != null);
+            Assert.IsTrue(comp.childCollider != null);
+        }
+
+        [Test]
+        public void InstantiateComponentWithRelationsAssignsFields()
+        {
+            ContainerBuilder builder = new();
+            IObjectResolver resolver = builder.Build();
+
+            // Build prefab hierarchy: Root(Rigidbody) -> Middle(TestComponent) -> Child(CapsuleCollider)
+            GameObject prefabRoot = NewGameObject("PrefabRoot");
+            prefabRoot.AddComponent<Rigidbody>();
+            GameObject prefabMiddle = NewGameObject("PrefabMiddle");
+            prefabMiddle.transform.SetParent(prefabRoot.transform);
+            TestComponent prefabComp = prefabMiddle.AddComponent<TestComponent>();
+            GameObject prefabChild = NewGameObject("PrefabChild");
+            prefabChild.transform.SetParent(prefabMiddle.transform);
+            prefabChild.AddComponent<CapsuleCollider>();
+
+            // Instantiate the full hierarchy and hydrate via GO helper
+            GameObject instanceRoot = resolver.InstantiateGameObjectWithRelations(prefabRoot);
+            TestComponent instance = instanceRoot.GetComponentInChildren<TestComponent>(true);
+
+            Assert.IsTrue(instance != null);
+            Assert.IsTrue(instance.parentBody != null);
+            Assert.IsTrue(instance.childCollider != null);
+        }
+
+        [Test]
+        public void InjectGameObjectWithRelationsAssignsHierarchy()
+        {
+            ContainerBuilder builder = new();
+            IObjectResolver resolver = builder.Build();
+
+            GameObject root = NewGameObject("Root");
+            root.AddComponent<Rigidbody>();
+            GameObject middle = NewGameObject("Middle");
+            middle.transform.SetParent(root.transform);
+            TestComponent comp = middle.AddComponent<TestComponent>();
+            GameObject child = NewGameObject("Child");
+            child.transform.SetParent(middle.transform);
+            child.AddComponent<CapsuleCollider>();
+
+            resolver.InjectGameObjectWithRelations(root);
+
+            Assert.IsTrue(comp.parentBody != null);
+            Assert.IsTrue(comp.childCollider != null);
+        }
+
+        [Test]
+        public void InstantiateGameObjectWithRelationsAssignsHierarchy()
+        {
+            ContainerBuilder builder = new();
+            IObjectResolver resolver = builder.Build();
+
+            GameObject prefab = NewGameObject("PrefabRoot");
+            prefab.AddComponent<Rigidbody>();
+            GameObject mid = NewGameObject("PrefabMiddle");
+            mid.transform.SetParent(prefab.transform);
+            TestComponent prefabComp = mid.AddComponent<TestComponent>();
+            GameObject child = NewGameObject("PrefabChild");
+            child.transform.SetParent(mid.transform);
+            child.AddComponent<CapsuleCollider>();
+
+            GameObject instance = resolver.InstantiateGameObjectWithRelations(prefab);
+            TestComponent comp = instance.GetComponentInChildren<TestComponent>(true);
+
+            Assert.IsTrue(comp != null);
+            Assert.IsTrue(comp.parentBody != null);
+            Assert.IsTrue(comp.childCollider != null);
+        }
+
+        [Test]
+        public void AssignerRecognizesBaseTypeMetadataForDerivedComponents()
+        {
+            AttributeMetadataCache cache = CreateScriptableObject<AttributeMetadataCache>();
+
+            AttributeMetadataCache.RelationalFieldMetadata[] fields =
+            {
+                new(
+                    nameof(BaseWithSibling._spriteRenderer),
+                    AttributeMetadataCache.RelationalAttributeKind.Sibling,
+                    AttributeMetadataCache.FieldKind.Single,
+                    typeof(SpriteRenderer).AssemblyQualifiedName,
+                    false
+                ),
+            };
+            AttributeMetadataCache.RelationalTypeMetadata[] relational =
+            {
+                new(typeof(BaseWithSibling).AssemblyQualifiedName, fields),
+            };
+            cache._relationalTypeMetadata = relational;
+            cache.ForceRebuildForTests();
+
+            ContainerBuilder builder = new();
+            builder.RegisterInstance(cache).AsSelf();
+            builder
+                .RegisterInstance(new RelationalComponentAssigner(cache))
+                .As<IRelationalComponentAssigner>();
+            IObjectResolver resolver = builder.Build();
+
+            GameObject go = NewGameObject("Root");
+            go.AddComponent<SpriteRenderer>();
+            DerivedWithSibling comp = go.AddComponent<DerivedWithSibling>();
+
+            resolver.AssignRelationalComponents(comp);
+
+            Assert.IsTrue(comp.SR != null);
+        }
+
+        private class BaseWithSibling : MonoBehaviour
+        {
+            [SiblingComponent]
+            protected internal SpriteRenderer _spriteRenderer;
+
+            public SpriteRenderer SR => _spriteRenderer;
+        }
+
+        private sealed class DerivedWithSibling : BaseWithSibling { }
+    }
+}
+#endif

package/Tests/Editor/Integrations/VContainer/VContainerRelationalHelpersTests.cs.meta

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

package/Tests/Editor/Integrations/VContainer/WallstopStudios.UnityHelpers.Tests.Editor.VContainer.asmdef

@@ -6,7 +6,8 @@
     "UnityEngine.TestRunner",
     "WallstopStudios.UnityHelpers",
     "WallstopStudios.UnityHelpers.Integration.VContainer",
-    "WallstopStudios.UnityHelpers.Tests.Editor"
+    "WallstopStudios.UnityHelpers.Tests.Editor",
+    "VContainer"
   ],
   "includePlatforms": ["Editor"],
   "excludePlatforms": [],