com.amanotes.prefabpool 2.0.2 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [2.1.0] - 2026-10-06
+
+### Added
+- `PrefabPool.ReleaseForSceneChange()` - lets a pool outlive the scene that used it: returns every checked-out instance to its pool and drops scene-bound spawn parents. Pooled instances stay alive; re-register the groups with the next scene's parents.
+
+## [2.0.3] - 2026-09-24
+
+### Added
+- `IPrefabPool.TryReturn` / `PoolGroup.TryReturn` — returns whether the instance was in the checkout ledger (`Return` remains a silent no-op when unknown).
+
 ## [2.0.2] - 2026-09-14
 
 ### Fixed

package/Docs/PrefabPool-API.md

@@ -1,6 +1,6 @@
 # PrefabPool API Reference
 
-**Package:** `com.amanotes.prefabpool` | **Version:** 2.0.2 | **Namespace:** `Amanotes.Core`
+**Package:** `com.amanotes.prefabpool` | **Version:** 2.1.0 | **Namespace:** `Amanotes.Core`
 
 Generic object pooling system to eliminate garbage collection spikes from frequent instantiation/destruction.
 
@@ -370,3 +370,15 @@ var unknown = group.Get("unknown_id");
 ## See Also
 
 - [PrefabPool README](../README.md)
+
+---
+
+## Outliving a scene
+
+`PrefabPool.ReleaseForSceneChange()` lets a pool survive the scene that used it (for example a pool in `DontDestroyOnLoad`):
+
+- every checked-out instance is returned to its pool;
+- scene-bound spawn parents are dropped (`group.Register(pool, null)`);
+- pooled instances stay alive.
+
+Call `RegisterGroup(group, newSpawnParent)` again once the next scene's parent exists. No-op after `MarkShutdown()` / `DestroyPool()`.

package/README.md

@@ -1,7 +1,7 @@
 # PrefabPool
 
 **Package:** `com.amanotes.prefabpool`  
-**Version:** 2.0.2
+**Version:** 2.1.0
 
 Generic object pooling system for Unity with lifecycle callbacks and material pooling support.
 
@@ -30,7 +30,7 @@ Add the package to your Unity project via `Packages/manifest.json`:
 ```json
 {
   "dependencies": {
-    "com.amanotes.prefabpool": "2.0.2"
+    "com.amanotes.prefabpool": "2.1.0"
   },
   "scopedRegistries": [
     {

package/Runtime/PrefabPool.cs

@@ -1,7 +1,9 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
+#if UNITY_EDITOR
 using UnityEditor;
+#endif
 using UnityEngine;
 using UnityObject = UnityEngine.Object;
 
@@ -196,6 +198,12 @@ namespace Amanotes.Core
         {
             _prefabPool?.Return(this, gameObject);
         }
+
+        public bool TryReturn(GameObject gameObject)
+        {
+            if (_prefabPool == null || gameObject == null) return false;
+            return _prefabPool.TryReturn(this, gameObject);
+        }
         
         public Transform SpawnParent => _spawnParent;
     }
@@ -207,6 +215,8 @@ namespace Amanotes.Core
         void SetSpawnParent(string groupId, Transform spawnParent);
         GameObject Get(PoolGroup group, string prefabId, Vector3 localPosition = default, Transform customParent = null);
         void Return(PoolGroup group, GameObject gameObject);
+        /// <summary>Returns false when the instance was not checked out from this pool (silent no-op in <see cref="Return"/>).</summary>
+        bool TryReturn(PoolGroup group, GameObject gameObject);
         IEnumerator Initialize();
         /// <summary>
         /// Marks the pool as shut down so all subsequent Get/Return calls no-op safely.
@@ -362,6 +372,29 @@ namespace Amanotes.Core
         public bool IsReady => _isReady;
         
         public void MarkShutdown() => _isDestroyed = true;
+
+        /// <summary>
+        /// Lets the pool outlive the scene that used it: returns every checked-out instance to its pool and drops
+        /// scene-bound spawn parents. Pooled instances stay alive; re-register the groups with the next scene's parents.
+        /// </summary>
+        public void ReleaseForSceneChange()
+        {
+            if (_isDestroyed) return;
+
+            var liveIds = new List<UnityObjectId>(_liveInstances.Keys);
+            for (var i = 0; i < liveIds.Count; i++)
+            {
+                var id = liveIds[i];
+                var go = _liveInstances[id];
+                if (go != null && _instanceTypeMap.TryGetValue(id, out var entry))
+                    entry.Return(go, transform);
+                _instanceTypeMap.Remove(id);
+                _liveInstances.Remove(id);
+            }
+
+            for (var i = 0; i < _groupOrder.Count; i++)
+                _groupOrder[i].Register(this, null);
+        }
         
         public void RegisterGroup(PoolGroup group, Transform spawnParent)
         {
@@ -418,15 +451,21 @@ namespace Amanotes.Core
         
         public void Return(PoolGroup group, GameObject go)
         {
-            if (_isDestroyed || group == null || go == null) return;
-            
+            TryReturn(group, go);
+        }
+
+        public bool TryReturn(PoolGroup group, GameObject go)
+        {
+            if (_isDestroyed || group == null || go == null) return false;
+
             var instanceId = UnityObjectIdentity.GetId(go);
-            if (_instanceTypeMap.TryGetValue(instanceId, out var entry))
-            {
-                entry.Return(go, transform);
-                _instanceTypeMap.Remove(instanceId);
-                _liveInstances.Remove(instanceId);
-            }
+            if (!_instanceTypeMap.TryGetValue(instanceId, out var entry))
+                return false;
+
+            entry.Return(go, transform);
+            _instanceTypeMap.Remove(instanceId);
+            _liveInstances.Remove(instanceId);
+            return true;
         }
         
         private void PurgeStaleInstanceMap()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.amanotes.prefabpool",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "displayName": "[Ama] Prefab Pool",
   "description": "Generic object pooling system for Unity",
   "unity": "2022.3",