Refactor, cleanup code and add documentaiton

Assets/Scripts/CardSystem/UI/Component/BookTabButton.cs

@@ -0,0 +1,135 @@
+using System;
+using AppleHills.Data.CardSystem;
+using BookCurlPro;
+using Core;
+using UnityEngine;
+using UnityEngine.UI;
+using Tween = Pixelplacement.Tween;
+
+namespace UI.CardSystem
+{
+    /// <summary>
+    /// Tab button for navigating to specific pages in the card album book.
+    /// Coordinates with other tabs via static events for visual feedback.
+    /// </summary>
+    [RequireComponent(typeof(Button))]
+    public class BookTabButton : MonoBehaviour
+    {
+        [Header("Book Reference")]
+        [SerializeField] private BookPro book;
+        
+        [Header("Tab Configuration")]
+        [SerializeField] private int targetPage;
+        [SerializeField] private CardZone zone;
+        
+        [Header("Visual Settings")]
+        [SerializeField] private bool enableScaling = true;
+        [SerializeField] private float selectedScale = 2.0f;
+        [SerializeField] private float normalScale = 1.0f;
+        [SerializeField] private float scaleTransitionDuration = 0.2f;
+        
+        private Button button;
+        private RectTransform rectTransform;
+        private Vector2 originalSize;
+        
+        // Static dispatcher for coordinating all tabs
+        private static event Action<BookTabButton> OnTabClicked;
+        
+        // Public properties to access this tab's configuration
+        public CardZone Zone => zone;
+        public int TargetPage => targetPage;
+
+        private void Awake()
+        {
+            // Get required components
+            button = GetComponent<Button>();
+            rectTransform = GetComponent<RectTransform>();
+            
+            // Cache original size
+            originalSize = rectTransform.sizeDelta;
+            
+            // Register button click
+            button.onClick.AddListener(OnButtonClicked);
+            
+            // Subscribe to static tab event
+            OnTabClicked += OnAnyTabClicked;
+        }
+
+        private void OnDestroy()
+        {
+            // Cleanup listeners
+            if (button != null)
+            {
+                button.onClick.RemoveListener(OnButtonClicked);
+            }
+            
+            OnTabClicked -= OnAnyTabClicked;
+        }
+
+        private void OnButtonClicked()
+        {
+            if (book == null)
+            {
+                Logging.Warning($"[BookTabButton] No BookPro reference assigned on {gameObject.name}");
+                return;
+            }
+            
+            // Notify all tabs that this one was clicked
+            OnTabClicked?.Invoke(this);
+            
+            // Flip to target page using AutoFlip
+            BookCurlPro.AutoFlip autoFlip = book.GetComponent<BookCurlPro.AutoFlip>();
+            if (autoFlip == null)
+            {
+                autoFlip = book.gameObject.AddComponent<BookCurlPro.AutoFlip>();
+            }
+            
+            autoFlip.enabled = true;
+            autoFlip.StartFlipping(targetPage);
+        }
+
+        private void OnAnyTabClicked(BookTabButton clickedTab)
+        {
+            // Skip scaling if disabled
+            if (!enableScaling) return;
+            
+            // Scale this tab based on whether it was clicked
+            if (clickedTab == this)
+            {
+                SetScale(selectedScale);
+            }
+            else
+            {
+                SetScale(normalScale);
+            }
+        }
+
+        private void SetScale(float targetScale)
+        {
+            Vector2 targetSize = originalSize * targetScale;
+            
+            // Use Pixelplacement Tween for smooth size change
+            Tween.Value(rectTransform.sizeDelta, targetSize, 
+                (Vector2 value) => rectTransform.sizeDelta = value, 
+                scaleTransitionDuration, 0f, Tween.EaseInOut);
+        }
+
+        // Public method to programmatically trigger this tab
+        public void ActivateTab()
+        {
+            OnButtonClicked();
+        }
+
+#if UNITY_EDITOR
+        private void OnValidate()
+        {
+            // Ensure target page is non-negative
+            if (targetPage < 0)
+            {
+                targetPage = 0;
+            }
+        }
+#endif
+    }
+}
+

Assets/Scripts/CardSystem/UI/Component/BookTabButton.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: ff50caabb55742bc8d24a6ddffeda815
+timeCreated: 1762385754

Assets/Scripts/CardSystem/UI/Component/BoosterNotificationDot.cs

@@ -0,0 +1,219 @@
+using Core.Lifecycle;
+using Data.CardSystem;
+using Pixelplacement;
+using Pixelplacement.TweenSystem;
+using TMPro;
+using UnityEngine;
+
+namespace UI.CardSystem
+{
+    /// <summary>
+    /// Manages a notification dot that displays a count (e.g., booster packs)
+    /// Can be reused across different UI elements that need to show numeric notifications
+    /// Automatically syncs with CardSystemManager to display booster pack count
+    /// </summary>
+    public class BoosterNotificationDot : ManagedBehaviour
+    {
+        [Header("UI References")]
+        [SerializeField] private GameObject dotBackground;
+        [SerializeField] private TextMeshProUGUI countText;
+        
+        [Header("Settings")]
+        [SerializeField] private bool hideWhenZero = true;
+        [SerializeField] private bool useAnimation = false;
+        [SerializeField] private string textPrefix = "";
+        [SerializeField] private string textSuffix = "";
+        [SerializeField] private Color textColor = Color.white;
+        
+        [Header("Animation")]
+        [SerializeField] private bool useTween = true;
+        [SerializeField] private float pulseDuration = 0.3f;
+        [SerializeField] private float pulseScale = 1.2f;
+        
+        // Optional animator reference
+        [SerializeField] private Animator animator;
+        [SerializeField] private string animationTrigger = "Update";
+        
+        // Current count value
+        private int _currentCount;
+        private Vector3 _originalScale;
+        
+        private TweenBase _activeTween;
+        
+        internal override void OnManagedStart()
+        {
+            // Store original scale for pulse animation
+            if (dotBackground != null)
+            {
+                _originalScale = dotBackground.transform.localScale;
+            }
+            
+            // Apply text color
+            if (countText != null)
+            {
+                countText.color = textColor;
+            }
+            
+            // Subscribe to CardSystemManager events (managers are guaranteed to be initialized)
+            if (CardSystemManager.Instance != null)
+            {
+                CardSystemManager.Instance.OnBoosterCountChanged += OnBoosterCountChanged;
+                
+                // Poll initial count and display it
+                int initialCount = CardSystemManager.Instance.GetBoosterPackCount();
+                SetCount(initialCount);
+            }
+            else
+            {
+                // If CardSystemManager isn't available yet, set to default count
+                SetCount(_currentCount);
+            }
+        }
+        
+        internal override void OnManagedDestroy()
+        {
+            // Unsubscribe from CardSystemManager events to prevent memory leaks
+            if (CardSystemManager.Instance != null)
+            {
+                CardSystemManager.Instance.OnBoosterCountChanged -= OnBoosterCountChanged;
+            }
+        }
+        
+        /// <summary>
+        /// Callback when booster count changes in CardSystemManager
+        /// </summary>
+        private void OnBoosterCountChanged(int newCount)
+        {
+            SetCount(newCount);
+        }
+        
+        /// <summary>
+        /// Sets the count displayed on the notification dot
+        /// Also handles visibility based on settings
+        /// </summary>
+        public void SetCount(int count)
+        {
+            bool countChanged = count != _currentCount;
+            _currentCount = count;
+            
+            // Update text
+            if (countText != null)
+            {
+                countText.text = textPrefix + count.ToString() + textSuffix;
+            }
+            
+            // Handle visibility
+            if (hideWhenZero)
+            {
+                SetVisibility(count > 0);
+            }
+            
+            // Play animation if value changed and animation is enabled
+            if (countChanged && count > 0)
+            {
+                if (useAnimation)
+                {
+                    Animate();
+                }
+            }
+        }
+        
+        /// <summary>
+        /// Gets the current count value
+        /// </summary>
+        public int GetCount()
+        {
+            return _currentCount;
+        }
+        
+        /// <summary>
+        /// Set text formatting options
+        /// </summary>
+        public void SetFormatting(string prefix, string suffix, Color color)
+        {
+            textPrefix = prefix;
+            textSuffix = suffix;
+            textColor = color;
+            
+            if (countText != null)
+            {
+                countText.color = color;
+                // Update text with new formatting
+                countText.text = textPrefix + _currentCount.ToString() + textSuffix;
+            }
+        }
+        
+        /// <summary>
+        /// Explicitly control the notification dot visibility
+        /// </summary>
+        public void SetVisibility(bool isVisible)
+        {
+            if (dotBackground != null)
+            {
+                dotBackground.SetActive(isVisible);
+            }
+            
+            if (countText != null)
+            {
+                countText.gameObject.SetActive(isVisible);
+            }
+        }
+        
+        /// <summary>
+        /// Show the notification dot
+        /// </summary>
+        public void Show()
+        {
+            SetVisibility(true);
+        }
+        
+        /// <summary>
+        /// Hide the notification dot
+        /// </summary>
+        public void Hide()
+        {
+            SetVisibility(false);
+        }
+        
+        /// <summary>
+        /// Play animation manually - either using Animator or Tween
+        /// </summary>
+        public void Animate()
+        {
+            if (useAnimation)
+            {
+                if (animator != null)
+                {
+                    animator.SetTrigger(animationTrigger);
+                }
+                else if (useTween && dotBackground != null)
+                {
+                    // Cancel any existing tweens on this transform
+                    if(_activeTween != null)
+                        _activeTween.Cancel();
+                    
+                    // Reset to original scale
+                    dotBackground.transform.localScale = _originalScale;
+                    
+                    // Pulse animation using Tween
+                    _activeTween = Tween.LocalScale(dotBackground.transform, 
+                        _originalScale * pulseScale, 
+                        pulseDuration/2, 
+                        0, 
+                        Tween.EaseOut, 
+                        Tween.LoopType.None, 
+                        null, 
+                        () => {
+                            // Scale back to original size
+                            Tween.LocalScale(dotBackground.transform, 
+                                _originalScale, 
+                                pulseDuration/2, 
+                                0, 
+                                Tween.EaseIn);
+                        },
+                        obeyTimescale: false);
+                }
+            }
+        }
+    }
+}

Assets/Scripts/CardSystem/UI/Component/BoosterNotificationDot.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 5845ed3764635fe429b6f1063effdd8a

Assets/Scripts/CardSystem/UI/Component/CardAlbumOpener.cs

@@ -0,0 +1,92 @@
+using Core;
+using UI.Core;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace UI.CardSystem
+{
+    /// <summary>
+    /// Opens the card album view when the button is pressed.
+    /// Attach this to a top-level GameObject in the scene.
+    /// </summary>
+    public class CardAlbumOpener : MonoBehaviour
+    {
+        [Header("References")]
+        [SerializeField] private Button openAlbumButton;
+        [SerializeField] private AlbumViewPage albumViewPage;
+        [SerializeField] private BoosterOpeningPage boosterOpeningPage;
+
+        private void Awake()
+        {
+            if (openAlbumButton != null)
+            {
+                openAlbumButton.onClick.AddListener(OnOpenAlbumClicked);
+            }
+        }
+
+        private void Start()
+        {
+            if (UIPageController.Instance != null)
+            {
+                UIPageController.Instance.OnPageChanged += OnPageChanged;
+            }
+        }
+
+        private void OnDisable()
+        {
+            if (UIPageController.Instance != null)
+            {
+                UIPageController.Instance.OnPageChanged -= OnPageChanged;
+            }
+        }
+
+        private void OnDestroy()
+        {
+            if (openAlbumButton != null)
+            {
+                openAlbumButton.onClick.RemoveListener(OnOpenAlbumClicked);
+            }
+
+            Logging.Debug("ALBUM: CardAlbumDestroyed");
+        }
+
+        private void OnOpenAlbumClicked()
+        {
+            if (UIPageController.Instance == null) return;
+
+            // Check if we're currently on the booster opening page
+            if (UIPageController.Instance.CurrentPage == boosterOpeningPage)
+            {
+                // We're in booster opening page, pop back to album main page
+                UIPageController.Instance.PopPage();
+            }
+            else if (UIPageController.Instance.CurrentPage != albumViewPage)
+            {
+                // We're not in the album at all, open it
+                if (openAlbumButton != null)
+                {
+                    openAlbumButton.gameObject.SetActive(false);
+                }
+
+                if (albumViewPage != null)
+                {
+                    UIPageController.Instance.PushPage(albumViewPage);
+                }
+            }
+        }
+
+        private void OnPageChanged(UIPage currentPage)
+        {
+            if (openAlbumButton == null) return;
+            
+            // Show the button when:
+            // 1. We're on the booster opening page (acts as "back to album" button)
+            // 2. We're NOT on the album main page (acts as "open album" button)
+            // Hide the button only when we're on the album main page
+            
+            bool shouldShowButton = currentPage == boosterOpeningPage || currentPage != albumViewPage;
+            openAlbumButton.gameObject.SetActive(shouldShowButton);
+        }
+    }
+}
+

Assets/Scripts/CardSystem/UI/Component/CardAlbumOpener.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 4b3b63118ebc48d6b8f28cd69d96191e
+timeCreated: 1762384087