refactor: forced @JsonEnum Annotations constrains

Author: fulleni

lib/src/models/feed_decorators/engagement_content_type.dart

@@ -9,7 +9,7 @@ import 'package:json_annotation/json_annotation.dart';
 /// {@template engagement_content_type}
 /// Defines the specific type or purpose of an [EngagementContent] item.
 /// {@endtemplate}
-@JsonEnum(fieldRename: FieldRename.kebab)
+@JsonEnum(fieldRename: FieldRename.snake)
 enum EngagementContentType {
   /// A call-to-action to sign up for an account.
   signUp,

lib/src/models/feed_decorators/suggested_content_display_type.dart

@@ -13,7 +13,7 @@ import 'package:json_annotation/json_annotation.dart';
 /// This enum guides the UI on how to render the list of items
 /// contained within a SuggestedContent model.
 /// {@endtemplate}
-@JsonEnum(fieldRename: FieldRename.kebab)
+@JsonEnum(fieldRename: FieldRename.snake)
 enum SuggestedContentDisplayType {
   /// Displays content items in a horizontally scrollable list of cards.
   horizontalCardList,

lib/src/models/feed_extras/feed_template_types.dart

@@ -3,7 +3,7 @@ import 'package:json_annotation/json_annotation.dart';
 /// Defines the types of engagement content templates available.
 /// The string value of the enum (e.g., 'rate-app') will be used as the ID
 /// to link rules in AppConfig to specific EngagementContentTemplate instances.
-@JsonEnum(fieldRename: FieldRename.kebab)
+@JsonEnum(fieldRename: FieldRename.snake)
 enum EngagementTemplateType {
   /// Prompt to rate the application.
   rateApp,
@@ -24,7 +24,7 @@ enum EngagementTemplateType {
 /// Defines the types of suggested content templates available.
 /// The string value of the enum (e.g., 'categories-to-follow') will be used as the ID
 /// to link rules in AppConfig to specific SuggestedContentTemplate instances.
-@JsonEnum(fieldRename: FieldRename.kebab)
+@JsonEnum(fieldRename: FieldRename.snake)
 enum SuggestionTemplateType {
   /// Suggest categories to follow.
   categoriesToFollow,

lib/src/models/user_settings/feed_display_preferences.dart

@@ -1,5 +1,6 @@
 import 'package:equatable/equatable.dart';
 import 'package:json_annotation/json_annotation.dart';
+import 'package:meta/meta.dart';
 
 part 'feed_display_preferences.g.dart';
 
@@ -30,7 +31,13 @@ enum HeadlineImageStyle {
 /// {@template feed_display_preferences}
 /// User preferences for how feeds are displayed.
 /// {@endtemplate}
-@JsonSerializable()
+@immutable
+@JsonSerializable(
+  fieldRename: FieldRename.snake,
+  explicitToJson: true,
+  includeIfNull: false,
+  checked: true,
+)
 class FeedDisplayPreferences extends Equatable {
   /// {@macro feed_display_preferences}
   const FeedDisplayPreferences({
@@ -45,9 +52,11 @@ class FeedDisplayPreferences extends Equatable {
       _$FeedDisplayPreferencesFromJson(json);
 
   /// How densely headline information should be presented.
+  @JsonKey(unknownEnumValue: JsonKey.nullForUndefinedEnumValue)
   final HeadlineDensity headlineDensity;
 
   /// How images should be displayed in the headline feed.
+  @JsonKey(unknownEnumValue: JsonKey.nullForUndefinedEnumValue)
   final HeadlineImageStyle headlineImageStyle;
 
   /// Whether to show the source name directly in the headline feed item.