com.wallstop-studios.unity-helpers 2.0.0-rc06 → 2.0.0-rc07

package/Runtime/Core/Helper/Helpers.cs

@@ -17,568 +17,13 @@
     using UnityEditor.SceneManagement;
 #endif
 
-    public static class Helpers
+    public static partial class Helpers
     {
         private static readonly WaitForEndOfFrame WaitForEndOfFrame = new();
         private static readonly Dictionary<Type, MethodInfo> AwakeMethodsByType = new();
         private static readonly Object LogObject = new();
         private static readonly Dictionary<string, Object> ObjectsByTag = new();
 
-        public static T Find<T>(this Object component, string tag, bool log = true)
-            where T : Object
-        {
-            if (ObjectsByTag.TryGetValue(tag, out Object value))
-            {
-                if (value != null && value is T typed)
-                {
-                    return typed;
-                }
-
-                _ = ObjectsByTag.Remove(tag);
-            }
-
-            GameObject gameObject = GameObject.FindGameObjectWithTag(tag);
-            if (gameObject == null)
-            {
-                if (log)
-                {
-                    component.LogWarn("Could not find {0}.", tag);
-                }
-
-                return default;
-            }
-
-            if (gameObject.TryGetComponent(out T instance))
-            {
-                ObjectsByTag[tag] = instance;
-                return instance;
-            }
-
-            if (log)
-            {
-                component.LogWarn(
-                    "Failed to find {0} on {1} (name: {2}), id [{3}].",
-                    typeof(T).Name,
-                    tag,
-                    gameObject.name,
-                    gameObject.GetInstanceID()
-                );
-            }
-
-            return default;
-        }
-
-        public static T Find<T>(string tag, bool log = true)
-            where T : MonoBehaviour
-        {
-            if (ObjectsByTag.TryGetValue(tag, out Object value))
-            {
-                if (value != null && value is T typed)
-                {
-                    return typed;
-                }
-
-                _ = ObjectsByTag.Remove(tag);
-            }
-
-            GameObject gameObject = GameObject.FindGameObjectWithTag(tag);
-            if (gameObject == null)
-            {
-                if (log)
-                {
-                    LogObject.Log($"Could not find {tag}.");
-                }
-
-                return default;
-            }
-
-            if (gameObject.TryGetComponent(out T instance))
-            {
-                ObjectsByTag[tag] = instance;
-                return instance;
-            }
-
-            if (log)
-            {
-                LogObject.Log($"Failed to find {typeof(T).Name} on {tag}");
-            }
-
-            return default;
-        }
-
-        public static void SetInstance<T>(string tag, T instance)
-            where T : MonoBehaviour
-        {
-            ObjectsByTag[tag] = instance;
-        }
-
-        public static void ClearInstance<T>(string tag, T instance)
-            where T : MonoBehaviour
-        {
-            if (ObjectsByTag.TryGetValue(tag, out Object existing) && existing == instance)
-            {
-                _ = ObjectsByTag.Remove(tag);
-            }
-        }
-
-        public static bool HasComponent<T>(this Object unityObject)
-            where T : Object
-        {
-            return unityObject switch
-            {
-                GameObject go => go.HasComponent<T>(),
-                Component component => component.HasComponent<T>(),
-                _ => false,
-            };
-        }
-
-        public static bool HasComponent<T>(this Component component)
-            where T : Object
-        {
-            return component.TryGetComponent<T>(out _);
-        }
-
-        public static bool HasComponent<T>(this GameObject gameObject)
-            where T : Object
-        {
-            return gameObject.TryGetComponent<T>(out _);
-        }
-
-        public static bool HasComponent(this GameObject gameObject, Type type)
-        {
-            return gameObject.TryGetComponent(type, out _);
-        }
-
-        public static void LogNotAssigned(this Object component, string name)
-        {
-            component.LogWarn("{0} not found.", name);
-        }
-
-        public static IEnumerable<GameObject> IterateOverChildGameObjects(
-            this GameObject gameObject
-        )
-        {
-            for (int i = 0; i < gameObject.transform.childCount; i++)
-            {
-                yield return gameObject.transform.GetChild(i).gameObject;
-            }
-        }
-
-        public static IEnumerable<GameObject> IterateOverChildGameObjectsRecursively(
-            this GameObject gameObject
-        )
-        {
-            for (int i = 0; i < gameObject.transform.childCount; i++)
-            {
-                GameObject child = gameObject.transform.GetChild(i).gameObject;
-                yield return child;
-                foreach (GameObject go in child.IterateOverChildGameObjectsRecursively())
-                {
-                    yield return go;
-                }
-            }
-        }
-
-        public static IEnumerable<GameObject> IterateOverChildGameObjectsRecursivelyIncludingSelf(
-            this GameObject gameObject
-        )
-        {
-            yield return gameObject;
-
-            for (int i = 0; i < gameObject.transform.childCount; ++i)
-            {
-                GameObject child = gameObject.transform.GetChild(i).gameObject;
-                foreach (
-                    GameObject c in child.IterateOverChildGameObjectsRecursivelyIncludingSelf()
-                )
-                {
-                    yield return c;
-                }
-            }
-        }
-
-        public static IEnumerable<GameObject> IterateOverParentGameObjects(
-            this GameObject gameObject
-        )
-        {
-            Transform currentTransform = gameObject.transform.parent;
-            while (currentTransform != null)
-            {
-                yield return currentTransform.gameObject;
-                currentTransform = currentTransform.parent;
-            }
-        }
-
-        public static IEnumerable<GameObject> IterateOverParentGameObjectsRecursivelyIncludingSelf(
-            this GameObject gameObject
-        )
-        {
-            yield return gameObject;
-
-            foreach (GameObject parent in IterateOverParentGameObjects(gameObject))
-            {
-                yield return parent;
-            }
-        }
-
-        public static void EnableRecursively<T>(
-            this Component component,
-            bool enabled,
-            Func<T, bool> exclude = null
-        )
-            where T : Behaviour
-        {
-            if (component == null)
-            {
-                return;
-            }
-
-            foreach (T behaviour in component.GetComponents<T>())
-            {
-                if (behaviour != null && (exclude?.Invoke(behaviour) ?? true))
-                {
-                    behaviour.enabled = enabled;
-                }
-            }
-
-            Transform transform = (component as Transform) ?? component.transform;
-            if (transform == null)
-            {
-                return;
-            }
-
-            for (int i = 0; i < transform.childCount; ++i)
-            {
-                Transform child = transform.GetChild(i);
-                EnableRecursively<T>(child, enabled);
-            }
-        }
-
-        public static void EnableRendererRecursively<T>(
-            this Component component,
-            bool enabled,
-            Func<T, bool> exclude = null
-        )
-            where T : Renderer
-        {
-            if (component == null)
-            {
-                return;
-            }
-
-            T behavior = component as T ?? component.GetComponent<T>();
-            if (behavior != null && (exclude?.Invoke(behavior) ?? true))
-            {
-                behavior.enabled = enabled;
-            }
-
-            Transform transform = (component as Transform) ?? component.transform;
-            if (transform == null)
-            {
-                return;
-            }
-
-            for (int i = 0; i < transform.childCount; ++i)
-            {
-                Transform child = transform.GetChild(i);
-                EnableRendererRecursively<T>(child, enabled);
-            }
-        }
-
-        public static IEnumerable<T> IterateOverAllChildComponentsRecursively<T>(
-            this Component component
-        )
-        {
-            if (component == null)
-            {
-                yield break;
-            }
-
-            foreach (T c in component.gameObject.GetComponents<T>())
-            {
-                yield return c;
-            }
-
-            for (int i = 0; i < component.transform.childCount; ++i)
-            {
-                Transform child = component.transform.GetChild(i);
-
-                foreach (T c in child.IterateOverAllChildComponentsRecursively<T>())
-                {
-                    yield return c;
-                }
-            }
-        }
-
-        public static IEnumerable<Transform> IterateOverAllChildren(this Component component)
-        {
-            if (component == null)
-            {
-                yield break;
-            }
-
-            for (int i = 0; i < component.transform.childCount; ++i)
-            {
-                yield return component.transform.GetChild(i);
-            }
-        }
-
-        public static IEnumerable<Transform> IterateOverAllParents(this Component component)
-        {
-            if (component == null)
-            {
-                yield break;
-            }
-
-            Transform transform = component.transform;
-            while (transform.parent != null)
-            {
-                yield return transform.parent;
-                transform = transform.parent;
-            }
-        }
-
-        public static IEnumerable<Transform> IterateOverAllParentsIncludingSelf(
-            this Component component
-        )
-        {
-            if (component == null)
-            {
-                yield break;
-            }
-
-            Transform transform = component.transform;
-            while (transform != null)
-            {
-                yield return transform;
-                transform = transform.parent;
-            }
-        }
-
-        public static IEnumerable<Transform> IterateOverAllChildrenRecursively(
-            this Component component
-        )
-        {
-            if (component == null)
-            {
-                yield break;
-            }
-
-            for (int i = 0; i < component.transform.childCount; ++i)
-            {
-                Transform childTransform = component.transform.GetChild(i);
-                yield return childTransform;
-                foreach (
-                    Transform childChildTransform in childTransform.IterateOverAllChildrenRecursively()
-                )
-                {
-                    yield return childChildTransform;
-                }
-            }
-        }
-
-        public static bool IsLeft(Vector2 a, Vector2 b, Vector2 point)
-        {
-            // http://alienryderflex.com/point_left_of_ray/
-
-            //check which side of line AB the point P is on
-            if ((b.x - a.x) * (point.y - a.y) - (point.x - a.x) * (b.y - a.y) > 0)
-            {
-                return false;
-            }
-
-            return true;
-        }
-
-        public static void DestroyAllChildrenGameObjects(this GameObject gameObject)
-        {
-            if (Application.isEditor)
-            {
-                EditorDestroyAllChildrenGameObjects(gameObject);
-            }
-            else
-            {
-                PlayDestroyAllChildrenGameObjects(gameObject);
-            }
-        }
-
-        public static void DestroyAllComponentsOfType<T>(this GameObject gameObject)
-            where T : Component
-        {
-            foreach (T component in gameObject.GetComponents<T>())
-            {
-                SmartDestroy(component);
-            }
-        }
-
-        public static void SmartDestroy(this Object obj, float? afterTime = null)
-        {
-            if (Application.isEditor && !Application.isPlaying)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-            {
-                if (afterTime.HasValue)
-                {
-                    Object.Destroy(obj, afterTime.Value);
-                }
-                else
-                {
-                    Object.Destroy(obj);
-                }
-            }
-        }
-
-        public static void DestroyAllChildrenGameObjectsImmediatelyConditionally(
-            this GameObject gameObject,
-            Func<GameObject, bool> acceptancePredicate
-        )
-        {
-            InternalDestroyAllChildrenGameObjects(
-                gameObject,
-                toDestroy =>
-                {
-                    if (!acceptancePredicate(toDestroy))
-                    {
-                        return;
-                    }
-
-                    Object.DestroyImmediate(toDestroy);
-                }
-            );
-        }
-
-        public static void DestroyAllChildGameObjectsConditionally(
-            this GameObject gameObject,
-            Func<GameObject, bool> acceptancePredicate
-        )
-        {
-            InternalDestroyAllChildrenGameObjects(
-                gameObject,
-                toDestroy =>
-                {
-                    if (!acceptancePredicate(toDestroy))
-                    {
-                        return;
-                    }
-
-                    toDestroy.Destroy();
-                }
-            );
-        }
-
-        public static void DestroyAllChildrenGameObjectsImmediately(this GameObject gameObject) =>
-            InternalDestroyAllChildrenGameObjects(gameObject, Object.DestroyImmediate);
-
-        public static void PlayDestroyAllChildrenGameObjects(this GameObject gameObject) =>
-            InternalDestroyAllChildrenGameObjects(gameObject, go => go.Destroy());
-
-        public static void EditorDestroyAllChildrenGameObjects(this GameObject gameObject) =>
-            InternalDestroyAllChildrenGameObjects(gameObject, go => go.Destroy());
-
-        private static void InternalDestroyAllChildrenGameObjects(
-            this GameObject gameObject,
-            Action<GameObject> destroyFunction
-        )
-        {
-            for (int i = gameObject.transform.childCount - 1; 0 <= i; --i)
-            {
-                destroyFunction(gameObject.transform.GetChild(i).gameObject);
-            }
-        }
-
-        public static bool IsPrefab(this GameObject gameObject)
-        {
-            Scene scene = gameObject.scene;
-#if UNITY_EDITOR
-            if (scene.rootCount == 1 && string.Equals(scene.name, gameObject.name))
-            {
-                return true;
-            }
-
-            return PrefabUtility.GetPrefabAssetType(gameObject) switch
-            {
-                PrefabAssetType.NotAPrefab => false,
-                PrefabAssetType.MissingAsset => scene.rootCount == 0,
-                _ => true,
-            };
-#else
-            return scene.rootCount == 0;
-#endif
-        }
-
-        public static bool IsPrefab(this Component component)
-        {
-            return IsPrefab(component.gameObject);
-        }
-
-        public static Vector2 RadianToVector2(float radian)
-        {
-            return new Vector2(Mathf.Cos(radian), Mathf.Sin(radian));
-        }
-
-        public static Vector2 DegreeToVector2(float degree)
-        {
-            return RadianToVector2(degree * Mathf.Deg2Rad);
-        }
-
-        public static T GetOrAddComponent<T>(this GameObject unityObject)
-            where T : Component
-        {
-            if (!unityObject.TryGetComponent(out T instance))
-            {
-                instance = unityObject.AddComponent<T>();
-            }
-
-            return instance;
-        }
-
-        public static Component GetOrAddComponent(this GameObject unityObject, Type componentType)
-        {
-            if (!unityObject.TryGetComponent(componentType, out Component instance))
-            {
-                instance = unityObject.AddComponent(componentType);
-            }
-
-            return instance;
-        }
-
-        public static void ModifyAndSavePrefab(GameObject prefab, Action<GameObject> modifyAction)
-        {
-            if (prefab == null)
-            {
-                return;
-            }
-
-#if UNITY_EDITOR
-            if (PrefabUtility.IsPartOfPrefabAsset(prefab))
-            {
-                string assetPath = AssetDatabase.GetAssetPath(prefab);
-                GameObject content = PrefabUtility.LoadPrefabContents(assetPath);
-
-                if (content == null)
-                {
-                    Debug.LogError($"Unable to load {prefab} as a prefab");
-                    return;
-                }
-
-                modifyAction(content);
-                _ = PrefabUtility.SaveAsPrefabAsset(content, assetPath);
-                PrefabUtility.UnloadPrefabContents(content);
-            }
-            else
-            {
-                modifyAction(prefab);
-                PrefabStage stage = PrefabStageUtility.GetPrefabStage(prefab);
-                if (stage)
-                {
-                    _ = EditorSceneManager.MarkSceneDirty(stage.scene);
-                }
-            }
-#endif
-        }
-
         // https://gamedevelopment.tutsplus.com/tutorials/unity-solution-for-hitting-moving-targets--cms-29633
         public static Vector2 PredictCurrentTarget(
             this GameObject currentTarget,

package/Runtime/Core/Helper/Partials/LogHelpers.cs

@@ -0,0 +1,13 @@
+namespace UnityHelpers.Core.Helper
+{
+    using Extension;
+    using UnityEngine;
+
+    public static partial class Helpers
+    {
+        public static void LogNotAssigned(this Object component, string name)
+        {
+            component.LogWarn("{0} not found.", name);
+        }
+    }
+}

package/Runtime/Core/Helper/Partials/LogHelpers.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: ed23b619dc044d65aeb490a27de13d87
+timeCreated: 1732648629

package/Runtime/Core/Helper/Partials/MathHelpers.cs

@@ -0,0 +1,30 @@
+namespace UnityHelpers.Core.Helper
+{
+    using UnityEngine;
+
+    public static partial class Helpers
+    {
+        public static bool IsLeft(Vector2 a, Vector2 b, Vector2 point)
+        {
+            // http://alienryderflex.com/point_left_of_ray/
+
+            //check which side of line AB the point P is on
+            if ((b.x - a.x) * (point.y - a.y) - (point.x - a.x) * (b.y - a.y) > 0)
+            {
+                return false;
+            }
+
+            return true;
+        }
+
+        public static Vector2 RadianToVector2(float radian)
+        {
+            return new Vector2(Mathf.Cos(radian), Mathf.Sin(radian));
+        }
+
+        public static Vector2 DegreeToVector2(float degree)
+        {
+            return RadianToVector2(degree * Mathf.Deg2Rad);
+        }
+    }
+}

package/Runtime/Core/Helper/Partials/MathHelpers.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: d9c95567ccbc418887abf8e21a8f265c
+timeCreated: 1732648488