com.amanotes.prefabpool 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [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.0.3 | **Namespace:** `Amanotes.Core`
 
 Generic object pooling system to eliminate garbage collection spikes from frequent instantiation/destruction.
 

package/README.md

@@ -1,7 +1,7 @@
 # PrefabPool
 
 **Package:** `com.amanotes.prefabpool`  
-**Version:** 2.0.2
+**Version:** 2.0.3
 
 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.0.3"
   },
   "scopedRegistries": [
     {

package/Runtime/PrefabPool.cs

@@ -196,6 +196,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 +213,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.
@@ -418,15 +426,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.0.3",
   "displayName": "[Ama] Prefab Pool",
   "description": "Generic object pooling system for Unity",
   "unity": "2022.3",