feat: Showcase Project for ngx-statewise

[Pierre-MarieMarchio]

Description:

Create a comprehensive showcase project within our monorepo that demonstrates the capabilities, patterns, and best practices for using ngx-statewise. This showcase will serve as living documentation for developers adopting our lightweight state management library, providing real-world examples of action flows, state management, effects handling, and integration with Angular components. While this project won't be published to npm, it will be a crucial resource for understanding and adopting ngx-statewise effectively.

---

Tasks:

• Setup Project Structure

  • Create a new Angular application within the monorepo structure
  • Configure build and test settings specific to the showcase needs
  • Add required dependencies including ngx-statewise

• Implement Core Demo Features

  • Create a user authentication flow showcasing login/logout with proper state management
  • Implement a data management module demonstrating CRUD operations with API integration
  • Develop example showing cascading effects and complex state transitions

• Demonstrate Key Concepts

  • Implement examples of States using both signals and regular properties
  • Create Action Groups and Single Actions with various payload types
  • Build Updators with both direct string keys and ofType pattern
  • Create Effects with both Promise and Observable return types
  • Create Managers that expose state via computed signals

• Implementation Patterns Showcase

  • Demonstrate global vs local Updator registration
  • Show synchronous vs asynchronous dispatch patterns
  • Showcase cascading effects with chains of actions
  • Illustrate error handling and recovery patterns

• UI and Documentation

  • Create a clean, intuitive UI that clearly demonstrates state changes
  • Add in-app documentation explaining key concepts alongside the examples
  • Include code snippets/explanations of what's happening "behind the scenes"
  • Add a dashboard showing real-time state visualization

---

Expected Outcome:

• A fully functional Angular application that showcases all the core features of ngx-statewise in action
• Clear examples of how to structure a real-world application using the library's patterns
• Interactive demonstrations that make it easy for developers to understand the unidirectional flow
• Documentation embedded in the application that explains key concepts alongside working examples
• A reference implementation that developers can use to understand best practices when implementing ngx-statewise in their own projects