First commit for private source control. Older commits available on Github.

Assets/Scripts/Framework/Services/Destruction/DestructionService.cs

@@ -0,0 +1,64 @@
+using System;
+using BriarQueen.Framework.Assets;
+using Cysharp.Threading.Tasks;
+using UnityEngine;
+using VContainer;
+using Object = UnityEngine.Object;
+
+namespace BriarQueen.Framework.Services.Destruction
+{
+    /// <summary>
+    ///     Handles safe destruction of GameObjects and ensures proper cleanup from world state.
+    /// </summary>
+    public class DestructionService
+    {
+        private readonly AddressableManager _addressables;
+
+        [Inject]
+        public DestructionService(AddressableManager addressables)
+        {
+            _addressables = addressables;
+        }
+
+
+        /// <summary>
+        ///     Asynchronously destroys a GameObject, invoking destructible callbacks and unregistering state.
+        /// </summary>
+        public async UniTask Destroy(GameObject go)
+        {
+            if (go == null) return;
+
+            Debug.Log($"[DestructionManager] Trying to destroy object of {go}");
+
+            var destructibles = go.GetComponentsInChildren<IDestructible>(true);
+            if (destructibles is { Length: > 0 })
+            {
+                foreach (var d in destructibles)
+                    try
+                    {
+                        if (d != null) await d.OnPreDestroy();
+                    }
+                    catch (Exception ex)
+                    {
+                        Debug.LogWarning($"[DestructionManager] Exception in OnPreDestroy of {d}: {ex}");
+                    }
+
+                foreach (var d in destructibles)
+                    try
+                    {
+                        if (d != null) await d.OnDestroyed();
+                    }
+                    catch (Exception ex)
+                    {
+                        Debug.LogWarning($"[DestructionManager] Exception in OnDestroyed of {d}: {ex}");
+                    }
+            }
+
+            // Prefer Addressables release if this is an Addressables-managed instance.
+            if (_addressables != null &&
+                _addressables.TryReleaseInstance(go)) return; // Addressables.ReleaseInstance will destroy it.
+
+            Object.Destroy(go);
+        }
+    }
+}

Assets/Scripts/Framework/Services/Destruction/DestructionService.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 0fcef8bcf5944f639d5d3daab61778c3
+timeCreated: 1769705715

Assets/Scripts/Framework/Services/Destruction/IDestructible.cs

@@ -0,0 +1,10 @@
+using Cysharp.Threading.Tasks;
+
+namespace BriarQueen.Framework.Services.Destruction
+{
+    public interface IDestructible
+    {
+        UniTask OnPreDestroy(); // Optional: prepare for destruction
+        UniTask OnDestroyed(); // Final cleanup
+    }
+}

Assets/Scripts/Framework/Services/Destruction/IDestructible.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: ab93d57d135a4580afcfd67996a0348b
+timeCreated: 1769705764