chore: initial commit

2026-05-08 11:04:00 +08:00
commit f55d2a57c3
6278 changed files with 866081 additions and 0 deletions
--- a/Packages/com.kybernetik.animancer/Runtime/Interfaces/IWrapper.cs
+++ b/Packages/com.kybernetik.animancer/Runtime/Interfaces/IWrapper.cs
@@ -0,0 +1,72 @@
+// Animancer // https://kybernetik.com.au/animancer // Copyright 2018-2026 Kybernetik //
+
+using System;
+using UnityEngine;
+
+namespace Animancer
+{
+    /// <summary>An object which wraps a <see cref="WrappedObject"/> object.</summary>
+    /// https://kybernetik.com.au/animancer/api/Animancer/IWrapper
+    public interface IWrapper
+    {
+        /************************************************************************************************************************/
+
+        /// <summary>The wrapped object.</summary>
+        /// <remarks>
+        /// Use <see cref="AnimancerUtilities.TryGetWrappedObject"/>
+        /// in case the <see cref="WrappedObject"/> is also an <see cref="IWrapper"/>.
+        /// </remarks>
+        object WrappedObject { get; }
+
+        /************************************************************************************************************************/
+    }
+
+    /// https://kybernetik.com.au/animancer/api/Animancer/AnimancerUtilities
+    public partial class AnimancerUtilities
+    {
+        /************************************************************************************************************************/
+
+        /// <summary>
+        /// Returns the last <see cref="IWrapper.WrappedObject"/>
+        /// which is a <typeparamref name="T"/>, including the `wrapper` itself.
+        /// </summary>
+        public static bool TryGetWrappedObject<T>(
+            object wrapper,
+            out T wrapped,
+            bool logException = false)
+            where T : class
+        {
+            wrapped = default;
+
+            while (true)
+            {
+                if (wrapper is T t)
+                    wrapped = t;
+
+                if (wrapper is IWrapper targetWrapper)
+                {
+                    try
+                    {
+                        wrapper = targetWrapper.WrappedObject;
+                    }
+                    catch (Exception exception)
+                    {
+                        if (logException)
+                            Debug.LogException(exception);
+
+                        break;
+                    }
+                }
+                else
+                {
+                    break;
+                }
+            }
+
+            return wrapped != null;
+        }
+
+        /************************************************************************************************************************/
+    }
+}
+