docs: add UserAppSettings model description

- Added UserAppSettings description

Author: fulleni

README.md

@@ -27,6 +27,7 @@ This package provides the following core data models:
 *   **`Category`**: Represents a news category with an ID, name, and optional description and icon URL.
 *   **`Source`**: Represents a news source, including ID, name, description, URL, language, optional headquarters (`Country`), and a `SourceType` enum (e.g., `newsAgency`, `blog`).
 *   **`Country`**: Represents a country with an ID, ISO code, name, and flag URL.
+*   **`UserAppSettings`**: Represents a collection of user-specific application settings, unifying display preferences (`DisplaySettings`) and language selection (`AppLanguage`). This model is designed for management via a generic data client (`HtDataClient`).
 *   **`User`**: Represents a user within the system, including their assigned `role`.
 *   **`PaginatedResponse<T>`**: A generic class for handling paginated API responses, containing a list of items (`items`), a `cursor` for the next page, and a `hasMore` flag.
 *   **`AuthSuccessResponse`**: Represents the successful result of an authentication operation, typically containing the authenticated user details and an access token.

lib/src/models/user-app-settings/user_app_settings.dart

@@ -24,8 +24,8 @@ class UserAppSettings extends Equatable {
     required this.id,
     DisplaySettings? displaySettings,
     AppLanguage? language,
-  })  : displaySettings = displaySettings ?? const DisplaySettings(),
-        language = language ?? 'en'; // Default language is English
+  }) : displaySettings = displaySettings ?? const DisplaySettings(),
+       language = language ?? 'en'; // Default language is English
 
   /// Factory method to create a [UserAppSettings] instance from a JSON map.
   factory UserAppSettings.fromJson(Map<String, dynamic> json) =>
@@ -44,11 +44,7 @@ class UserAppSettings extends Equatable {
   Map<String, dynamic> toJson() => _$UserAppSettingsToJson(this);
 
   @override
-  List<Object?> get props => [
-        id,
-        displaySettings,
-        language,
-      ];
+  List<Object?> get props => [id, displaySettings, language];
 
   /// Creates a copy of this [UserAppSettings] but with the given fields
   /// replaced with the new values.

test/src/models/user-app-settings/user_app_settings_test.dart

@@ -38,9 +38,7 @@ void main() {
       expect(
         createSubject(
           id: userId,
-          displaySettings: const DisplaySettings(
-            baseTheme: AppBaseTheme.dark,
-          ),
+          displaySettings: const DisplaySettings(baseTheme: AppBaseTheme.dark),
           language: 'fr',
         ),
         equals(
@@ -66,11 +64,7 @@ void main() {
           displaySettings: customDisplaySettings,
           language: customLanguage,
         ).props,
-        equals([
-          userId,
-          customDisplaySettings,
-          customLanguage,
-        ]),
+        equals([userId, customDisplaySettings, customLanguage]),
       );
     });
 
@@ -90,9 +84,7 @@ void main() {
       test('retains old values if null is provided', () {
         final original = createSubject(
           id: userId,
-          displaySettings: const DisplaySettings(
-            baseTheme: AppBaseTheme.dark,
-          ),
+          displaySettings: const DisplaySettings(baseTheme: AppBaseTheme.dark),
           language: 'fr',
         );
         expect(original.copyWith(), equals(original));
@@ -126,7 +118,10 @@ void main() {
     group('fromJson/toJson', () {
       test('works correctly with default nested values', () {
         final json = createJson(id: userId);
-        expect(UserAppSettings.fromJson(json), equals(createSubject(id: userId)));
+        expect(
+          UserAppSettings.fromJson(json),
+          equals(createSubject(id: userId)),
+        );
       });
 
       test('works correctly with custom nested values', () {