🚀 Major Architectural Refactor & UI Standardization

This release introduces a significant architectural refactor aimed at improving the application's maintainability, scalability, and overall robustness. We have overhauled our core data models to align with recent backend changes and standardized state management across all features.

A key part of this effort was extracting all shared UI code into a new, internal ht_ui_kit package, promoting code reuse and creating a more polished, consistent user experience.

✨ Key Architectural & Core Model Updates

• Core Model Refactor: The Category model has been comprehensively replaced by Topic throughout the entire application. Similarly, AppConfig has been renamed to RemoteConfig, and UserRole to AppUserRole for better clarity and consistency with the API.
• Standardized Authentication State: The AuthenticationBloc has been refactored to use a single state class (AuthenticationState) managed by an AuthenticationStatus enum. This simplifies state transitions and improves the predictability of the authentication flow.

🎨 Shared UI Kit & Standardized Error Handling

• Shared UI Code Extraction: Common UI components and utilities (e.g., FailureStateWidget, LoadingStateWidget, app_spacing) have been extracted from this repository into our new internal ht_ui_kit package. This centralizes shared code, promotes reuse, and ensures a consistent look and feel.
• Improved Error Display: To support the new UI kit, error handling has been standardized. All BLoCs now report errors using rich HtHttpException objects instead of simple strings. The shared FailureStateWidget from the UI kit now uses these exceptions to display consistent, informative, and localized error messages to the user.

🔧 Feature & Technical Refinements

• Enhanced Feed & Search: The feed and search features have been refactored to align with the new Topic model and standardized state management patterns. Data fetching is now more flexible, using a new filter and pagination approach.
• Structured Logging: The logging package has been integrated across key BLoCs, providing better debugging capabilities and visibility into the application's behavior.

🐛 Critical Fix for Demo Mode

This release addresses a critical bug affecting the user experience in our demo mode. Previously, users testing the app as a guest would lose their settings and content preferences upon signing up or logging in.

We have now implemented a dedicated data migration service that ensures all user data is seamlessly transferred from the guest profile to the authenticated account. This provides a much smoother and more reliable experience for new users trying out the application.

✨ Fixes & Improvements

• Demo Mode Data Sync: Fixed a critical bug where UserAppSettings and UserContentPreferences were lost when an anonymous user authenticated. All settings are now correctly migrated.
• Race Condition Mitigation: Resolved a potential race condition during the data migration by implementing a retry mechanism and handling ConflictException more gracefully. This ensures data integrity even during concurrent operations.

🔧 Refinements & Code Quality

• New Data Migration Service: Implemented a new client-side DemoDataMigrationService to handle the data transfer logic specifically for the demo environment, improving the robustness of the feature.
• Codebase Cleanup: Performed extensive code hygiene improvements across the app, including removing redundant comments, streamlining BLoC emits, and organizing imports for better readability and maintenance.
• Linter Adjustments: Updated the analysis_options.yaml file to ignore specific, non-critical linter warnings, streamlining the development workflow.

This is the first official public release of ht_main, the Flutter mobile application for the Headlines Toolkit!

This initial version establishes the core foundation of the application, providing a feature-complete, source-available news app and starter kit.

✨ Highlights in this Release

• 📰 Production-Ready News Feed: A beautiful and performant infinite-scrolling feed.
• 🔐 Full Authentication Suite: Includes passwordless email, anonymous sign-in, and seamless account linking.
• 🧑‍🎨 Deep User Personalization: Features for saving headlines, following topics, and customizing content preferences.
• 🎨 Advanced Theming Engine: Full control over light/dark modes, accent colors, and typography.
• 📱 Adaptive UI: A responsive layout that works great on both phones and tablets out of the box.
• 🏗️ Clean Architecture: A solid foundation built with BLoC and GoRouter for easy extension.
• 🌍 Localization Ready: Ships with English and Arabic support included.

This is a foundational release, and we're excited for you to explore it! For full setup instructions and technical details, please see the project README.md.