Merge pull request #10 from PurrNet/dev

Release

Author: BlenMiner

Assets/PurrUI/CHANGELOG.md

@@ -1,3 +1,45 @@
+# [1.4.0-beta.3](https://github.com/PurrNet/PurrUI/compare/v1.4.0-beta.2...v1.4.0-beta.3) (2026-04-13)
+
+
+### Bug Fixes
+
+* make Clear method "cheaper", no need to put everything to foreground etc ([a63c677](https://github.com/PurrNet/PurrUI/commit/a63c6772b868064c7ea0c2facbf58047c7159472))
+
+# [1.4.0-beta.2](https://github.com/PurrNet/PurrUI/compare/v1.4.0-beta.1...v1.4.0-beta.2) (2026-04-13)
+
+
+### Features
+
+* add OnDestroy method to clear view stack ([8d088fc](https://github.com/PurrNet/PurrUI/commit/8d088fc5168ff1b07178f67c51f7c4f2f19c4436))
+
+# [1.4.0-beta.1](https://github.com/PurrNet/PurrUI/compare/v1.3.1-beta.3...v1.4.0-beta.1) (2026-03-18)
+
+
+### Features
+
+* ReplaceOrPush ([71e09f6](https://github.com/PurrNet/PurrUI/commit/71e09f6dd7729fd10ed1ad55cffd01d39fd8dba0))
+
+## [1.3.1-beta.3](https://github.com/PurrNet/PurrUI/compare/v1.3.1-beta.2...v1.3.1-beta.3) (2026-03-18)
+
+
+### Bug Fixes
+
+* allow to replace a specific view instance ([344f199](https://github.com/PurrNet/PurrUI/commit/344f1997ca32aba5adfa88ccd6a8d385f2f31314))
+
+## [1.3.1-beta.2](https://github.com/PurrNet/PurrUI/compare/v1.3.1-beta.1...v1.3.1-beta.2) (2026-03-18)
+
+
+### Bug Fixes
+
+* reset parentStack when not part of a viewStack ([b71a09f](https://github.com/PurrNet/PurrUI/commit/b71a09f8efa8a35ac1fe70e4473a34f437bd9c73))
+
+## [1.3.1-beta.1](https://github.com/PurrNet/PurrUI/compare/v1.3.0...v1.3.1-beta.1) (2026-03-13)
+
+
+### Bug Fixes
+
+* dont push/pop/replace outside of play mode, just a guardrail for users ([558d71a](https://github.com/PurrNet/PurrUI/commit/558d71a8f2b30411b1c5a06fd149305a2a02d98c))
+
 # [1.3.0](https://github.com/PurrNet/PurrUI/compare/v1.2.0...v1.3.0) (2026-03-12)
 
 

Assets/PurrUI/Runtime/MonoView.cs

@@ -12,12 +12,17 @@ public class MonoView : MonoBehaviour
 
         public CanvasGroup canvasGroup { get; private set; }
 
-        public ViewStack parentStack { get; private set; }
+        public ViewStack parentStack { get; internal set; }
 
         public bool cullWindowsBehind => _cullWindowsBehind;
 
         public bool isTopMost => parentStack && parentStack.top == this;
 
+        /// <summary>
+        /// Returns true if this view is currently part of a ViewStack.
+        /// </summary>
+        public bool isInStack => parentStack;
+
         public Canvas canvas { get; private set; }
 
         /// <summary>

Assets/PurrUI/Runtime/ViewStack.cs

@@ -102,6 +102,9 @@ public T FindWindow<T>() where T : MonoView
         /// </summary>
         public MonoView Push(MonoView prefab)
         {
+            if (!Application.isPlaying)
+                return null;
+
             if (prefab == null)
             {
                 Debug.LogError("[WindowStack] Provided prefab is null.", this);
@@ -226,6 +229,9 @@ public T Push<T>() where T : MonoView
         /// </summary>
         public void Pop()
         {
+            if (!Application.isPlaying)
+                return;
+
             if (_stack.Count == 0)
             {
                 Debug.LogError("[WindowStack] No windows to pop.", this);
@@ -238,9 +244,12 @@ public void Pop()
             {
                 var newTopIdx = _stack.Count - 1;
                 var newTop = _stack[newTopIdx];
-                newTop.transform.SetAsLastSibling();
-                newTop.MoveToForeground();
-                newTop.UpdateOrder(newTopIdx + _orderOffset);
+                if (newTop)
+                {
+                    newTop.transform.SetAsLastSibling();
+                    newTop.MoveToForeground();
+                    newTop.UpdateOrder(newTopIdx + _orderOffset);
+                }
             }
             UpdateVisibility();
         }
@@ -250,8 +259,13 @@ public void Pop()
         /// </summary>
         public void Clear()
         {
-            while (_stack.Count > 0)
-                Pop();
+            for (int i = _stack.Count - 1; i >= 0; i--)
+            {
+                var view = _stack[i];
+                view.OnPopped();
+                view.parentStack = null;
+            }
+            _stack.Clear();
         }
 
         /// <summary>
@@ -260,6 +274,9 @@ public void Clear()
         /// <param name="instance"></param>
         public void Pop(MonoView instance)
         {
+            if (!Application.isPlaying)
+                return;
+
             int idx = _stack.IndexOf(instance);
 
             if (idx == -1)
@@ -277,6 +294,7 @@ public void Pop(MonoView instance)
 
             _stack.RemoveAt(idx);
             instance.OnPopped();
+            instance.parentStack = null;
 
             var transition = instance.ExitTransition();
             if (transition != null)
@@ -300,6 +318,9 @@ public void Pop(MonoView instance)
         /// </summary>
         public MonoView Replace(MonoView prefab)
         {
+            if (!Application.isPlaying)
+                return null;
+
             if (prefab == null)
             {
                 Debug.LogError("[WindowStack] Provided prefab is null.", this);
@@ -328,6 +349,108 @@ public T Replace<T>() where T : MonoView
             return (T)Replace(prefab);
         }
 
+        /// <summary>
+        /// Replaces the specified instance in the stack with a new window instantiated from the provided prefab.
+        /// The old instance plays its exit transition while the new one plays its enter transition.
+        /// The new window takes the same position in the stack as the old one.
+        /// </summary>
+        public MonoView Replace(MonoView instance, MonoView prefab)
+        {
+            if (!Application.isPlaying)
+                return null;
+
+            if (prefab == null)
+            {
+                Debug.LogError("[WindowStack] Provided prefab is null.", this);
+                return null;
+            }
+
+            int idx = _stack.IndexOf(instance);
+
+            if (idx == -1)
+            {
+                Debug.LogError("[WindowStack] The provided window instance is not in the stack.", this);
+                return null;
+            }
+
+            // If it's the top window, use the regular Replace method
+            if (idx == _stack.Count - 1)
+                return Replace(prefab);
+
+            // Remove the instance at its position
+            _stack.RemoveAt(idx);
+            instance.OnPopped();
+            instance.parentStack = null;
+
+            var exitTransition = instance.ExitTransition();
+            if (exitTransition != null)
+            {
+                instance.canvasGroup.blocksRaycasts = false;
+                StartCoroutine(RunExitTransition(instance, exitTransition));
+            }
+            else
+            {
+                instance.DestroyMe();
+            }
+
+            // Insert new instance at the same position
+            return InsertIntoStack(prefab, idx);
+        }
+
+        /// <summary>
+        /// Replaces the specified instance in the stack with a new window of the specified type.
+        /// The old instance plays its exit transition while the new one plays its enter transition.
+        /// The new window takes the same position in the stack as the old one.
+        /// </summary>
+        public T Replace<T>(MonoView instance) where T : MonoView
+        {
+            if (!TryGet<T>(out var prefab))
+            {
+                Debug.LogError($"[WindowStack] No window prefab of type `{typeof(T)}` found in WindowPrefabs.", this);
+                return null;
+            }
+
+            return (T)Replace(instance, prefab);
+        }
+
+        /// <summary>
+        /// Replaces the specified instance in the stack with a new window instantiated from the provided prefab.
+        /// If the instance is no longer part of the stack, pushes the new window instead.
+        /// </summary>
+        public MonoView ReplaceOrPush(MonoView instance, MonoView prefab)
+        {
+            if (!Application.isPlaying)
+                return null;
+
+            if (prefab == null)
+            {
+                Debug.LogError("[WindowStack] Provided prefab is null.", this);
+                return null;
+            }
+
+            int idx = _stack.IndexOf(instance);
+
+            if (idx == -1)
+                return Push(prefab);
+
+            return Replace(instance, prefab);
+        }
+
+        /// <summary>
+        /// Replaces the specified instance in the stack with a new window of the specified type.
+        /// If the instance is no longer part of the stack, pushes the new window instead.
+        /// </summary>
+        public T ReplaceOrPush<T>(MonoView instance) where T : MonoView
+        {
+            if (!TryGet<T>(out var prefab))
+            {
+                Debug.LogError($"[WindowStack] No window prefab of type `{typeof(T)}` found in WindowPrefabs.", this);
+                return null;
+            }
+
+            return (T)ReplaceOrPush(instance, prefab);
+        }
+
         /// <summary>
         /// Moves the specified instance to the top of the stack. If the instance is not in the stack, does nothing.
         /// </summary>
@@ -372,6 +495,7 @@ private void RemoveTop()
             var topView = _stack[^1];
             _stack.RemoveAt(_stack.Count - 1);
             topView.OnPopped();
+            topView.parentStack = null;
 
             var transition = topView.ExitTransition();
             if (transition != null)
@@ -388,11 +512,15 @@ private void RemoveTop()
 
         private MonoView AddToStack(MonoView prefab)
         {
-            var idx = _stack.Count;
+            return InsertIntoStack(prefab, _stack.Count);
+        }
+
+        private MonoView InsertIntoStack(MonoView prefab, int idx)
+        {
             var instance = Instantiate(prefab, _parent);
-            _stack.Add(instance);
+            _stack.Insert(idx, instance);
             instance.Initialize(this);
-            instance.UpdateOrder(idx + _orderOffset);
+            UpdateOrder(idx);
             instance.OnPushed();
 
             var transition = instance.EnterTransition();
@@ -427,5 +555,10 @@ private static IEnumerator RunExitTransition(MonoView view, IEnumerator transiti
             yield return transition;
             if (view) view.DestroyMe();
         }
+
+        private void OnDestroy()
+        {
+            Clear();
+        }
     }
 }

Assets/PurrUI/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev.purrnet.ui",
-  "version": "1.3.0",
+  "version": "1.4.0-beta.3",
   "author": {
     "name": "PurrNet Team",
     "url": "https://purrnet.dev/"