- **Refactored Card Placement Flow**
- Separated card presentation from orchestration logic
- Extracted `CornerCardManager` for pending card lifecycle (spawn, shuffle, rebuild)
- Extracted `AlbumNavigationService` for book page navigation and zone mapping
- Extracted `CardEnlargeController` for backdrop management and card reparenting
- Implemented controller pattern (non-MonoBehaviour) for complex logic
- Cards now unparent from slots before rebuild to prevent premature destruction
- **Improved Corner Card Display**
- Fixed cards spawning on top of each other during rebuild
- Implemented shuffle-to-front logic (remaining cards occupy slots 0→1→2)
- Added smart card selection (prioritizes cards matching current album page)
- Pending cards now removed from queue immediately on drag start
- Corner cards rebuild after each placement with proper slot reassignment
- **Enhanced Album Card Viewing**
- Added dramatic scale increase when viewing cards from album slots
- Implemented shrink animation when dismissing enlarged cards
- Cards transition: `PlacedInSlotState` → `AlbumEnlargedState` → `PlacedInSlotState`
- Backdrop shows/hides with card enlarge/shrink cycle
- Cards reparent to enlarged container while viewing, return to slot after
- **State Machine Improvements**
- Added `CardStateNames` constants for type-safe state transitions
- Implemented `ICardClickHandler` and `ICardStateDragHandler` interfaces
- State transitions now use cached property indices
- `BoosterCardContext` separated from `CardContext` for single responsibility
- **Code Cleanup**
- Identified unused `SlotContainerHelper.cs` (superseded by `CornerCardManager`)
- Identified unused `BoosterPackDraggable.canOpenOnDrop` field
- Identified unused `AlbumViewPage._previousInputMode` (hardcoded value)
- Identified unused `Card.OnPlacedInAlbumSlot` event (no subscribers)
Co-authored-by: Michal Pikulski <michal.a.pikulski@gmail.com>
Co-authored-by: Michal Pikulski <michal@foolhardyhorizons.com>
Reviewed-on: #59
# Lifecycle Management & Save System Revamp
## Overview
Complete overhaul of game lifecycle management, interactable system, and save/load architecture. Introduces centralized `ManagedBehaviour` base class for consistent initialization ordering and lifecycle hooks across all systems.
## Core Architecture
### New Lifecycle System
- **`LifecycleManager`**: Centralized coordinator for all managed objects
- **`ManagedBehaviour`**: Base class replacing ad-hoc initialization patterns
- `OnManagedAwake()`: Priority-based initialization (0-100, lower = earlier)
- `OnSceneReady()`: Scene-specific setup after managers ready
- Replaces `BootCompletionService` (deleted)
- **Priority groups**: Infrastructure (0-20) → Game Systems (30-50) → Data (60-80) → UI/Gameplay (90-100)
- **Editor support**: `EditorLifecycleBootstrap` ensures lifecycle works in editor mode
### Unified SaveID System
- Consistent format: `{ParentName}_{ComponentType}`
- Auto-registration via `AutoRegisterForSave = true`
- New `DebugSaveIds` editor tool for inspection
## Save/Load Improvements
### Enhanced State Management
- **Extended SaveLoadData**: Unlocked minigames, card collection states, combination items, slot occupancy
- **Async loading**: `ApplyCardCollectionState()` waits for card definitions before restoring
- **New `SaveablePlayableDirector`**: Timeline sequences save/restore playback state
- **Fixed race conditions**: Proper initialization ordering prevents data corruption
## Interactable & Pickup System
- Migrated to `OnManagedAwake()` for consistent initialization
- Template method pattern for state restoration (`RestoreInteractionState()`)
- Fixed combination item save/load bugs (items in slots vs. follower hand)
- Dynamic spawning support for combined items on load
- **Breaking**: `Interactable.Awake()` now sealed, use `OnManagedAwake()` instead
## UI System Changes
- **AlbumViewPage** and **BoosterNotificationDot**: Migrated to `ManagedBehaviour`
- **Fixed menu persistence bug**: Menus no longer reappear after scene transitions
- **Pause Menu**: Now reacts to all scene loads (not just first scene)
- **Orientation Enforcer**: Enforces per-scene via `SceneManagementService`
- **Loading Screen**: Integrated with new lifecycle
## ⚠️ Breaking Changes
1. **`BootCompletionService` removed** → Use `ManagedBehaviour.OnManagedAwake()` with priority
2. **`Interactable.Awake()` sealed** → Override `OnManagedAwake()` instead
3. **SaveID format changed** → Now `{ParentName}_{ComponentType}` consistently
4. **MonoBehaviours needing init ordering** → Must inherit from `ManagedBehaviour`
Co-authored-by: Michal Pikulski <michal.a.pikulski@gmail.com>
Co-authored-by: Michal Pikulski <michal@foolhardyhorizons.com>
Reviewed-on: #51
- Revamp pausing and centralize management in GameManager
- Switch Pause implementation to be counter-based to solve corner case of multiple pause requests
- Remove duplicated Pause logic from other components
- Add pausing when browsing the card album
- Fully deliver the exclusive UI implementation
- Spruce up the MiniGame tutorial with correct pausing, hiding other UI
- Correctly unpause after showing tutorial
- Fix minigame ending sequence. The cinematic correctly plays only once now
- Replaying the minigame works
Co-authored-by: Michal Adam Pikulski <michal@foolhardyhorizons.com>
Co-authored-by: Michal Pikulski <michal@foolhardyhorizons.com>
Reviewed-on: #39
- A Settings Provider system to utilize addressables for loading settings at runtime
- An editor UI for easy modifications of the settings objects
- A split out developer settings functionality to keep gameplay and nitty-gritty details separately
- Most settings migrated out of game objects and into the new system
- An additional Editor utility for fetching the settings at editor runtime, for gizmos, visualization etc
Co-authored-by: Michal Pikulski <michal.a.pikulski@gmail.com>
Co-authored-by: AlexanderT <alexander@foolhardyhorizons.com>
Reviewed-on: #7
