feat: add catalog modification screen

Author: Freek van de Ven

packages/flutter_catalog/lib/l10n/app_en.arb

@@ -6,6 +6,7 @@
     "filterButton": "Filters",
     "noItemsFound": "No items found.",
     "itemLoadingError": "Failed to load items.",
+    "itemCreatePageMandatorySection": "Mandatory",
     "detailDescriptionTitle": "Description",
     "applyFiltersButton": "Apply filters",
     "sendMessageButton": "Send message",

packages/flutter_catalog/lib/l10n/app_localizations.dart

@@ -129,6 +129,12 @@ abstract class FlutterCatalogLocalizations {
   /// **'Failed to load items.'**
   String get itemLoadingError;
 
+  /// No description provided for @itemCreatePageMandatorySection.
+  ///
+  /// In en, this message translates to:
+  /// **'Mandatory'**
+  String get itemCreatePageMandatorySection;
+
   /// No description provided for @detailDescriptionTitle.
   ///
   /// In en, this message translates to:

packages/flutter_catalog/lib/l10n/app_localizations_en.dart

@@ -22,6 +22,9 @@ class FlutterCatalogLocalizationsEn extends FlutterCatalogLocalizations {
   @override
   String get itemLoadingError => 'Failed to load items.';
 
+  @override
+  String get itemCreatePageMandatorySection => 'Mandatory';
+
   @override
   String get detailDescriptionTitle => 'Description';
 

packages/flutter_catalog/lib/src/flutter_catalog_userstory.dart

@@ -9,6 +9,7 @@ import "package:flutter_catalog/src/routes.dart";
 import "package:flutter_catalog/src/services/catalog_service.dart";
 import "package:flutter_catalog/src/services/pop_handler.dart";
 import "package:flutter_catalog/src/utils/scope.dart";
+import "package:flutter_catalog/src/views/catalog_modify_view.dart";
 import "package:flutter_catalog_interface/flutter_catalog_interface.dart";
 import "package:flutter_hooks/flutter_hooks.dart";
 
@@ -56,6 +57,30 @@ class FlutterCatalogDetailUserstory extends _BaseCatalogNavigatorUserstory {
       );
 }
 
+/// A self-contained user story for creating or editing a catalog item.
+class FlutterCatalogModifyUserstory extends _BaseCatalogNavigatorUserstory {
+  /// Constructs a [FlutterCatalogModifyUserstory].
+  const FlutterCatalogModifyUserstory({
+    required super.userId,
+    required super.options,
+    this.initialItem,
+    super.onExit,
+    super.key,
+  });
+
+  /// The initial catalog item to edit, or `null` for creating a new item.
+  final CatalogItem? initialItem;
+
+  @override
+  MaterialPageRoute buildInitialRoute(BuildContext context) =>
+      MaterialPageRoute(
+        builder: (context) => CatalogModifyView(
+          initialItem: initialItem,
+          onExit: onExit,
+        ),
+      );
+}
+
 /// Base hook widget for catalog navigator user stories.
 abstract class _BaseCatalogNavigatorUserstory extends HookWidget {
   /// Constructs a [_BaseCatalogNavigatorUserstory].

packages/flutter_catalog/lib/src/models/item_view_model.dart

@@ -0,0 +1,44 @@
+import "package:image_picker/image_picker.dart";
+
+/// A data class to manage the state of the item modification form.
+class ItemModificationData {
+  ///
+  const ItemModificationData({
+    this.title,
+    this.description,
+    this.newImages = const [],
+    this.existingImageUrls = const [],
+    this.customFieldValues = const {},
+  });
+
+  ///
+  final String? title;
+
+  ///
+  final String? description;
+
+  ///
+  final List<XFile> newImages;
+
+  ///
+  final List<String> existingImageUrls;
+
+  /// Custom field values for the item.
+  final Map<String, dynamic> customFieldValues;
+
+  ///
+  ItemModificationData copyWith({
+    String? title,
+    String? description,
+    List<XFile>? newImages,
+    List<String>? existingImageUrls,
+    Map<String, dynamic>? customFieldValues,
+  }) =>
+      ItemModificationData(
+        title: title ?? this.title,
+        description: description ?? this.description,
+        newImages: newImages ?? this.newImages,
+        existingImageUrls: existingImageUrls ?? this.existingImageUrls,
+        customFieldValues: customFieldValues ?? this.customFieldValues,
+      );
+}

packages/flutter_catalog/lib/src/routes.dart

@@ -1,6 +1,7 @@
 import "package:flutter/material.dart";
 import "package:flutter_catalog/src/views/catalog_detail_view.dart";
 import "package:flutter_catalog/src/views/catalog_filter_view.dart";
+import "package:flutter_catalog/src/views/catalog_modify_view.dart";
 import "package:flutter_catalog/src/views/catalog_overview_view.dart";
 import "package:flutter_catalog_interface/flutter_catalog_interface.dart";
 
@@ -32,6 +33,25 @@ MaterialPageRoute catalogDetailRoute({
       builder: (context) => CatalogDetailView(
         item: item,
         onExit: () => Navigator.of(context).pop(),
+        onEditItem: (itemToEdit) async => _routeToScreen(
+          context,
+          catalogModifyRoute(
+            initialItem: itemToEdit,
+            onExit: () => Navigator.of(context).pop(),
+          ).builder(context),
+        ),
+      ),
+    );
+
+/// Returns a [MaterialPageRoute] for the create/edit screen.
+MaterialPageRoute<void> catalogModifyRoute({
+  required VoidCallback onExit,
+  CatalogItem? initialItem,
+}) =>
+    MaterialPageRoute(
+      builder: (context) => CatalogModifyView(
+        initialItem: initialItem,
+        onExit: onExit,
       ),
     );
 

packages/flutter_catalog/lib/src/services/catalog_service.dart

@@ -1,29 +1,24 @@
+import "package:cross_file/cross_file.dart";
 import "package:flutter_catalog_interface/flutter_catalog_interface.dart";
 
 /// A service class to manage catalog-related operations.
 ///
-/// This class uses a [CatalogRepository] to fetch and manipulate catalog data.
-class CatalogService {
+/// This class is generic and uses a [CatalogRepository] to fetch and
+/// manipulate catalog data of type T.
+class CatalogService<T extends CatalogItem> {
   /// Creates a [CatalogService] with the given repository.
   CatalogService({
-    required CatalogRepository repository,
+    required CatalogRepository<T> repository,
     required this.userId,
   }) : _repository = repository;
 
-  final CatalogRepository _repository;
+  final CatalogRepository<T> _repository;
 
   /// The ID of the user for whom catalog operations are performed.
   final String userId;
 
-  /// Retrieves catalog items, optionally applying filters, user location,
-  /// pagination, and filtered by user.
-  ///
-  /// [userId] is required for personalized results or distance calculations.
-  /// [userLocation] provides the GPS location for distance calculation.
-  /// [filters] allow for filtering the items (e.g., by category).
-  /// [limit] specifies the maximum number of items to return.
-  /// [offset] specifies the starting index for pagination.
-  Future<List<CatalogItem>> fetchCatalogItems({
+  /// Retrieves catalog items, optionally applying filters and user location.
+  Future<List<T>> fetchCatalogItems({
     LatLng? userLocation,
     Map<String, dynamic>? filters,
     int? limit,
@@ -37,15 +32,30 @@ class CatalogService {
         offset: offset,
       );
 
-  /// Toggles the favorite status of an item for a specific user.
-  ///
-  /// [itemId] is the ID of the catalog item.
-  Future<void> toggleFavorite(
-    String itemId,
-  ) async =>
+  /// Toggles the favorite status of an item for the current user.
+  Future<void> toggleFavorite(String itemId) async =>
       _repository.toggleFavorite(itemId, userId);
 
   /// Fetches a single catalog item by its ID.
-  Future<CatalogItem?> fetchCatalogItemById(String id) async =>
+  Future<T?> fetchCatalogItemById(String id) async =>
       _repository.fetchCatalogItemById(id, userId);
+
+  /// Creates a new catalog item.
+  Future<void> createCatalogItem(Map<String, dynamic> item) async =>
+      _repository.createCatalogItem(item);
+
+  /// Updates an existing catalog item by its ID.
+  Future<void> updateCatalogItem(
+    String itemId,
+    Map<String, dynamic> item,
+  ) async =>
+      _repository.updateCatalogItem(itemId, item);
+
+  /// Deletes a catalog item by its ID.
+  Future<void> deleteCatalogItem(String itemId) async =>
+      _repository.deleteCatalogItem(itemId);
+
+  /// Uploads an image file.
+  Future<String> uploadImage(XFile imageFile) async =>
+      _repository.uploadImage(imageFile);
 }

packages/flutter_catalog/lib/src/views/catalog_detail_view.dart

@@ -11,6 +11,7 @@ class CatalogDetailView extends HookWidget {
   /// Creates a [CatalogDetailView].
   const CatalogDetailView({
     required this.item,
+    required this.onEditItem,
     super.key,
     this.onExit,
   });
@@ -21,11 +22,14 @@ class CatalogDetailView extends HookWidget {
   /// A callback to execute when the user wants to navigate back.
   final VoidCallback? onExit;
 
+  /// A callback to execute when the user wants to edit the item.
+  final void Function(CatalogItem item) onEditItem;
+
   @override
   Widget build(BuildContext context) {
     var scope = CatalogScope.of(context);
     var service = scope.catalogService;
-
+    var isAuthor = scope.userId == item.authorId;
     var isFavorite = useState(item.isFavorited ?? false);
 
     useEffect(
@@ -67,6 +71,12 @@ class CatalogDetailView extends HookWidget {
             ),
             onPressed: toggleFavorite,
           ),
+          if (isAuthor)
+            IconButton(
+              icon: const Icon(Icons.edit),
+              // Call the new callback when pressed
+              onPressed: () => onEditItem(item),
+            ),
         ],
       ),
       body: SingleChildScrollView(