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

package/Samples~/DI - Reflex/Scripts/ReflexPaletteService.cs

@@ -0,0 +1,36 @@
+namespace Samples.UnityHelpers.DI.Reflex
+{
+    using UnityEngine;
+
+    /// <summary>
+    /// Small service registered in the Reflex container so relational components receive dependencies.
+    /// </summary>
+    public sealed class ReflexPaletteService
+    {
+        private readonly Color _accentColor;
+        private readonly Color _inactiveColor;
+        private readonly Color _warningColor;
+
+        public ReflexPaletteService(Color accentColor, Color inactiveColor, Color warningColor)
+        {
+            _accentColor = accentColor;
+            _inactiveColor = inactiveColor;
+            _warningColor = warningColor;
+        }
+
+        public Color AccentColor
+        {
+            get { return _accentColor; }
+        }
+
+        public Color InactiveColor
+        {
+            get { return _inactiveColor; }
+        }
+
+        public Color WarningColor
+        {
+            get { return _warningColor; }
+        }
+    }
+}

package/Samples~/DI - Reflex/Scripts/ReflexPaletteService.cs.meta

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

package/Samples~/DI - Reflex/Scripts/ReflexRelationalConsumer.cs

@@ -0,0 +1,79 @@
+namespace Samples.UnityHelpers.DI.Reflex
+{
+    using Reflex.Attributes;
+    using UnityEngine;
+    using WallstopStudios.UnityHelpers.Core.Attributes;
+
+    /// <summary>
+    /// Simple MonoBehaviour that receives a Reflex dependency and relational components at runtime.
+    /// </summary>
+    public sealed class ReflexRelationalConsumer : MonoBehaviour
+    {
+        [Inject]
+        private ReflexPaletteService _paletteService;
+
+        [SiblingComponent]
+        private SpriteRenderer _spriteRenderer;
+
+        [ChildComponent(OnlyDescendants = true)]
+        private ParticleSystem[] _childParticles;
+
+        private void Awake()
+        {
+            WarmUpParticles();
+        }
+
+        private void OnEnable()
+        {
+            ApplyAccentColor();
+        }
+
+        private void OnDisable()
+        {
+            ApplyInactiveColor();
+        }
+
+        public void ApplyAccentColor()
+        {
+            if (_spriteRenderer != null && _paletteService != null)
+            {
+                _spriteRenderer.color = _paletteService.AccentColor;
+            }
+        }
+
+        public void ApplyInactiveColor()
+        {
+            if (_spriteRenderer != null && _paletteService != null)
+            {
+                _spriteRenderer.color = _paletteService.InactiveColor;
+            }
+        }
+
+        public void FlashWarningColor()
+        {
+            if (_spriteRenderer != null && _paletteService != null)
+            {
+                _spriteRenderer.color = _paletteService.WarningColor;
+            }
+        }
+
+        private void WarmUpParticles()
+        {
+            if (_childParticles == null)
+            {
+                return;
+            }
+
+            for (int i = 0; i < _childParticles.Length; i++)
+            {
+                ParticleSystem system = _childParticles[i];
+                if (system == null)
+                {
+                    continue;
+                }
+
+                system.Stop(true, ParticleSystemStopBehavior.StopEmittingAndClear);
+            }
+        }
+    }
+}

package/Samples~/DI - Reflex/Scripts/ReflexRelationalConsumer.cs.meta

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

package/Samples~/DI - Reflex/Scripts/ReflexSampleInstaller.cs

@@ -0,0 +1,30 @@
+namespace Samples.UnityHelpers.DI.Reflex
+{
+    using Reflex.Core;
+    using UnityEngine;
+
+    /// <summary>
+    /// Installs lightweight sample services so the scene demonstrates Reflex + relational wiring.
+    /// </summary>
+    public sealed class ReflexSampleInstaller : MonoBehaviour, IInstaller
+    {
+        [SerializeField]
+        private Color _accentColor = new Color(0.156f, 0.768f, 0.972f, 1.0f);
+
+        [SerializeField]
+        private Color _inactiveColor = new Color(0.196f, 0.196f, 0.196f, 1.0f);
+
+        [SerializeField]
+        private Color _warningColor = new Color(0.949f, 0.419f, 0.270f, 1.0f);
+
+        public void InstallBindings(ContainerBuilder builder)
+        {
+            builder.AddSingleton(CreatePaletteService, typeof(ReflexPaletteService));
+        }
+
+        private ReflexPaletteService CreatePaletteService(Container container)
+        {
+            return new ReflexPaletteService(_accentColor, _inactiveColor, _warningColor);
+        }
+    }
+}

package/Samples~/DI - Reflex/Scripts/ReflexSampleInstaller.cs.meta

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

package/Samples~/DI - Reflex/Scripts/ReflexSpawner.cs

@@ -0,0 +1,79 @@
+namespace Samples.UnityHelpers.DI.Reflex
+{
+    using Reflex.Core;
+    using Reflex.Extensions;
+    using UnityEngine;
+    using WallstopStudios.UnityHelpers.Integrations.Reflex;
+
+    /// <summary>
+    /// Demonstrates the Reflex container helpers for instantiation and relational assignment.
+    /// </summary>
+    public sealed class ReflexSpawner : MonoBehaviour
+    {
+        [SerializeField]
+        private ReflexRelationalConsumer _componentPrefab;
+
+        [SerializeField]
+        private GameObject _hierarchyPrefab;
+
+        [SerializeField]
+        private Transform _defaultParent;
+
+        private Container _sceneContainer;
+
+        private void Awake()
+        {
+            _sceneContainer = gameObject.scene.GetSceneContainer();
+        }
+
+        /// <summary>
+        /// Instantiate a component prefab through Reflex so dependencies and relational fields are ready.
+        /// </summary>
+        public ReflexRelationalConsumer SpawnComponent(Transform parent)
+        {
+            if (_sceneContainer == null || _componentPrefab == null)
+            {
+                return null;
+            }
+
+            Transform targetParent = parent != null ? parent : _defaultParent;
+            ReflexRelationalConsumer instance = _sceneContainer.InstantiateComponentWithRelations(
+                _componentPrefab,
+                targetParent
+            );
+            return instance;
+        }
+
+        /// <summary>
+        /// Instantiate a hierarchy prefab and hydrate the entire tree.
+        /// </summary>
+        public GameObject SpawnHierarchy(Transform parent)
+        {
+            if (_sceneContainer == null || _hierarchyPrefab == null)
+            {
+                return null;
+            }
+
+            Transform targetParent = parent != null ? parent : _defaultParent;
+            GameObject root = _sceneContainer.InstantiateGameObjectWithRelations(
+                _hierarchyPrefab,
+                targetParent,
+                includeInactiveChildren: true
+            );
+            return root;
+        }
+
+        /// <summary>
+        /// Hydrate a GameObject that was spawned outside of Reflex.
+        /// </summary>
+        public void HydrateExistingHierarchy(GameObject root, bool includeInactiveChildren)
+        {
+            if (_sceneContainer == null || root == null)
+            {
+                return;
+            }
+
+            _sceneContainer.InjectGameObjectWithRelations(root, includeInactiveChildren);
+        }
+    }
+}

package/Samples~/DI - Reflex/Scripts/ReflexSpawner.cs.meta

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

package/Samples~/DI - Reflex/Scripts/Samples.UnityHelpers.DI.Reflex.asmdef

@@ -0,0 +1,26 @@
+{
+  "name": "Samples.UnityHelpers.DI.Reflex",
+  "rootNamespace": "Samples.UnityHelpers.DI.Reflex",
+  "references": [
+    "WallstopStudios.UnityHelpers",
+    "WallstopStudios.UnityHelpers.Integration.Reflex",
+    "Reflex"
+  ],
+  "includePlatforms": [],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [
+    "REFLEX_PRESENT"
+  ],
+  "versionDefines": [
+    {
+      "name": "com.gustavopsantos.reflex",
+      "expression": "0.0.1",
+      "define": "REFLEX_PRESENT"
+    }
+  ],
+  "noEngineReferences": false
+}

package/Samples~/DI - Reflex/Scripts/Samples.UnityHelpers.DI.Reflex.asmdef.meta

@@ -0,0 +1,9 @@
+fileFormatVersion: 2
+guid: 44458593e8fe42398f7a8eb0c53e9a02
+ScriptedImporter:
+  internalIDToNameTable: []
+  externalObjects: {}
+  serializedVersion: 2
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Samples~/DI - Reflex/Scripts.meta

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

package/Samples~/DI - Reflex.meta

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