com.wallstop-studios.unity-helpers 2.0.2 → 2.0.4

package/Runtime/Core/Helper/UnityMainThreadDispatcher.cs

@@ -2,6 +2,7 @@ namespace WallstopStudios.UnityHelpers.Core.Helper
 {
     using System;
     using System.Collections.Concurrent;
+    using System.Threading.Tasks;
     using UnityEngine;
     using Utils;
 #if UNITY_EDITOR
@@ -104,7 +105,8 @@ namespace WallstopStudios.UnityHelpers.Core.Helper
         /// </summary>
         public System.Threading.Tasks.Task RunAsync(Action action)
         {
-            var tcs = new System.Threading.Tasks.TaskCompletionSource<bool>();
+            TaskCompletionSource<bool> tcs =
+                new System.Threading.Tasks.TaskCompletionSource<bool>();
             RunOnMainThread(() =>
             {
                 try
@@ -125,7 +127,7 @@ namespace WallstopStudios.UnityHelpers.Core.Helper
         /// </summary>
         public System.Threading.Tasks.Task<T> Post<T>(Func<T> func)
         {
-            var tcs = new System.Threading.Tasks.TaskCompletionSource<T>();
+            TaskCompletionSource<T> tcs = new System.Threading.Tasks.TaskCompletionSource<T>();
             RunOnMainThread(() =>
             {
                 try

package/Runtime/Tags/AttributeEffect.cs

@@ -9,6 +9,7 @@ namespace WallstopStudios.UnityHelpers.Tags
     using Core.Extension;
     using Core.Helper;
     using UnityEngine;
+    using WallstopStudios.UnityHelpers.Utils;
 #if ODIN_INSPECTOR
     using Sirenix.OdinInspector;
 #endif
@@ -52,6 +53,7 @@ namespace WallstopStudios.UnityHelpers.Tags
     /// </para>
     /// </remarks>
     [Serializable]
+    [CreateAssetMenu(menuName = "Wallstop Studios/Unity Helpers/Attribute Effect")]
     public sealed class AttributeEffect :
 #if ODIN_INSPECTOR
         SerializedScriptableObject
@@ -72,7 +74,7 @@ namespace WallstopStudios.UnityHelpers.Tags
         /// The list of attribute modifications to apply when this effect is activated.
         /// Each modification specifies an attribute name, action type, and value.
         /// </summary>
-        public readonly List<AttributeModification> modifications = new();
+        public List<AttributeModification> modifications = new();
 
         /// <summary>
         /// Specifies how long this effect should persist (Instant, Duration, or Infinite).
@@ -110,12 +112,172 @@ namespace WallstopStudios.UnityHelpers.Tags
         /// </example>
         public List<string> effectTags = new();
 
+        /// <summary>
+        /// Determines whether this effect applies the specified tag.
+        /// </summary>
+        /// <param name="effectTag">The tag to check.</param>
+        /// <returns><c>true</c> if the tag is present; otherwise, <c>false</c>.</returns>
+        public bool HasTag(string effectTag)
+        {
+            if (effectTags == null || string.IsNullOrEmpty(effectTag))
+            {
+                return false;
+            }
+
+            for (int i = 0; i < effectTags.Count; ++i)
+            {
+                if (string.Equals(effectTags[i], effectTag, StringComparison.Ordinal))
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        /// <summary>
+        /// Determines whether this effect applies any of the specified tags.
+        /// </summary>
+        /// <param name="effectTagsToCheck">The tags to inspect.</param>
+        /// <returns><c>true</c> if at least one tag is applied; otherwise, <c>false</c>.</returns>
+        public bool HasAnyTag(IEnumerable<string> effectTagsToCheck)
+        {
+            if (effectTags == null || effectTagsToCheck == null)
+            {
+                return false;
+            }
+
+            switch (effectTagsToCheck)
+            {
+                case IReadOnlyList<string> list:
+                {
+                    return HasAnyTag(list);
+                }
+                case HashSet<string> hashSet:
+                {
+                    foreach (string candidate in hashSet)
+                    {
+                        if (string.IsNullOrEmpty(candidate))
+                        {
+                            continue;
+                        }
+
+                        if (HasTag(candidate))
+                        {
+                            return true;
+                        }
+                    }
+
+                    return false;
+                }
+            }
+
+            foreach (string candidate in effectTagsToCheck)
+            {
+                if (string.IsNullOrEmpty(candidate))
+                {
+                    continue;
+                }
+
+                if (HasTag(candidate))
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        /// <summary>
+        /// Determines whether this effect applies any of the specified tags.
+        /// Optimized for indexed collections.
+        /// </summary>
+        /// <param name="effectTagsToCheck">The tags to inspect.</param>
+        /// <returns><c>true</c> if at least one tag is applied; otherwise, <c>false</c>.</returns>
+        public bool HasAnyTag(IReadOnlyList<string> effectTagsToCheck)
+        {
+            if (effectTags == null || effectTagsToCheck == null)
+            {
+                return false;
+            }
+
+            for (int i = 0; i < effectTagsToCheck.Count; ++i)
+            {
+                string candidate = effectTagsToCheck[i];
+                if (string.IsNullOrEmpty(candidate))
+                {
+                    continue;
+                }
+
+                if (HasTag(candidate))
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        /// <summary>
+        /// Determines whether this effect contains modifications for the specified attribute.
+        /// </summary>
+        /// <param name="attributeName">The attribute name to inspect.</param>
+        /// <returns><c>true</c> if the effect modifies <paramref name="attributeName"/>; otherwise, <c>false</c>.</returns>
+        public bool ModifiesAttribute(string attributeName)
+        {
+            if (modifications == null || string.IsNullOrEmpty(attributeName))
+            {
+                return false;
+            }
+
+            for (int i = 0; i < modifications.Count; ++i)
+            {
+                AttributeModification modification = modifications[i];
+                if (string.Equals(modification.attribute, attributeName, StringComparison.Ordinal))
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
+        /// <summary>
+        /// Copies all modifications that affect the specified attribute into the provided buffer.
+        /// </summary>
+        /// <param name="attributeName">The attribute to filter by.</param>
+        /// <param name="buffer">The destination buffer. Existing entries are preserved.</param>
+        /// <returns>The number of modifications added to <paramref name="buffer"/>.</returns>
+        public List<AttributeModification> GetModifications(
+            string attributeName,
+            List<AttributeModification> buffer = null
+        )
+        {
+            buffer ??= new List<AttributeModification>();
+            buffer.Clear();
+            if (modifications == null || string.IsNullOrEmpty(attributeName))
+            {
+                return buffer;
+            }
+
+            for (int i = 0; i < modifications.Count; ++i)
+            {
+                AttributeModification modification = modifications[i];
+                if (string.Equals(modification.attribute, attributeName, StringComparison.Ordinal))
+                {
+                    buffer.Add(modification);
+                }
+            }
+
+            return buffer;
+        }
+
         /// <summary>
         /// A list of cosmetic effect data that defines visual and audio feedback for this effect.
         /// These are applied when the effect becomes active and removed when it expires.
         /// </summary>
         [JsonIgnore]
-        public readonly List<CosmeticEffectData> cosmeticEffects = new();
+        public List<CosmeticEffectData> cosmeticEffects = new();
 
         private List<string> CosmeticEffectsForJson =>
             cosmeticEffects?.Select(cosmeticEffectData => cosmeticEffectData.name).ToList()
@@ -145,7 +307,9 @@ namespace WallstopStudios.UnityHelpers.Tags
                 return nameof(AttributeEffect);
             }
 
-            StringBuilder descriptionBuilder = new();
+            using PooledResource<StringBuilder> stringBuilderBuffer = Buffers.StringBuilder.Get(
+                out StringBuilder descriptionBuilder
+            );
             for (int i = 0; i < modifications.Count; ++i)
             {
                 AttributeModification modification = modifications[i];