feat: add catalog modification screen

Author: Freek van de Ven

packages/flutter_catalog/lib/l10n/app_en.arb

@@ -6,16 +6,32 @@
     "filterButton": "Filters",
     "noItemsFound": "No items found.",
     "itemLoadingError": "Failed to load items.",
+    "itemCreatePageMandatorySection": "Mandatory",
     "detailDescriptionTitle": "Description",
     "applyFiltersButton": "Apply filters",
     "sendMessageButton": "Send message",
     "characteristicsTitle": "Characteristics",
     "distanceTitle": "Distance",
     "postedSince": "Posted since {date}",
     "@postedSince": {
-        "description": "Indicates how long ago the item was posted, formatted as a relative date.",
         "placeholders": {
             "date": {}
         }
-    }
+    },
+    "itemCreatePageTitle": "Create Item",
+    "itemEditPageTitle": "Edit Item",
+    "itemCreatePageTitleHint": "Title",
+    "itemCreatePageDescriptionHint": "Description",
+    "itemCreatePageTitleRequiredError": "Title is required.",
+    "itemCreatePageAddImagesButton": "Add Images",
+    "itemCreatePageSaveChangesButton": "Save Changes",
+    "itemCreatePageSavingChangesButton": "Saving...",
+    "itemCreatePageDeleteItemButton": "Delete Item",
+    "itemCreatePageDeleteConfirmationTitle": "Delete Item",
+    "itemCreatePageDeleteConfirmationMessage": "Are you sure you want to delete this item forever?",
+    "itemCreatePageDeleteConfirmationConfirm": "Delete",
+    "itemCreatePageDeleteConfirmationCancel": "Cancel",
+    "itemCreatePageGenericError": "An error occurred.",
+    "itemCreatePageItemDeletedSuccess": "Item deleted successfully.",
+    "itemCreatePageItemDeleteError": "Failed to delete item."
 }

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:
@@ -159,11 +165,107 @@ abstract class FlutterCatalogLocalizations {
   /// **'Distance'**
   String get distanceTitle;
 
-  /// Indicates how long ago the item was posted, formatted as a relative date.
+  /// No description provided for @postedSince.
   ///
   /// In en, this message translates to:
   /// **'Posted since {date}'**
   String postedSince(Object date);
+
+  /// No description provided for @itemCreatePageTitle.
+  ///
+  /// In en, this message translates to:
+  /// **'Create Item'**
+  String get itemCreatePageTitle;
+
+  /// No description provided for @itemEditPageTitle.
+  ///
+  /// In en, this message translates to:
+  /// **'Edit Item'**
+  String get itemEditPageTitle;
+
+  /// No description provided for @itemCreatePageTitleHint.
+  ///
+  /// In en, this message translates to:
+  /// **'Title'**
+  String get itemCreatePageTitleHint;
+
+  /// No description provided for @itemCreatePageDescriptionHint.
+  ///
+  /// In en, this message translates to:
+  /// **'Description'**
+  String get itemCreatePageDescriptionHint;
+
+  /// No description provided for @itemCreatePageTitleRequiredError.
+  ///
+  /// In en, this message translates to:
+  /// **'Title is required.'**
+  String get itemCreatePageTitleRequiredError;
+
+  /// No description provided for @itemCreatePageAddImagesButton.
+  ///
+  /// In en, this message translates to:
+  /// **'Add Images'**
+  String get itemCreatePageAddImagesButton;
+
+  /// No description provided for @itemCreatePageSaveChangesButton.
+  ///
+  /// In en, this message translates to:
+  /// **'Save Changes'**
+  String get itemCreatePageSaveChangesButton;
+
+  /// No description provided for @itemCreatePageSavingChangesButton.
+  ///
+  /// In en, this message translates to:
+  /// **'Saving...'**
+  String get itemCreatePageSavingChangesButton;
+
+  /// No description provided for @itemCreatePageDeleteItemButton.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete Item'**
+  String get itemCreatePageDeleteItemButton;
+
+  /// No description provided for @itemCreatePageDeleteConfirmationTitle.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete Item'**
+  String get itemCreatePageDeleteConfirmationTitle;
+
+  /// No description provided for @itemCreatePageDeleteConfirmationMessage.
+  ///
+  /// In en, this message translates to:
+  /// **'Are you sure you want to delete this item forever?'**
+  String get itemCreatePageDeleteConfirmationMessage;
+
+  /// No description provided for @itemCreatePageDeleteConfirmationConfirm.
+  ///
+  /// In en, this message translates to:
+  /// **'Delete'**
+  String get itemCreatePageDeleteConfirmationConfirm;
+
+  /// No description provided for @itemCreatePageDeleteConfirmationCancel.
+  ///
+  /// In en, this message translates to:
+  /// **'Cancel'**
+  String get itemCreatePageDeleteConfirmationCancel;
+
+  /// No description provided for @itemCreatePageGenericError.
+  ///
+  /// In en, this message translates to:
+  /// **'An error occurred.'**
+  String get itemCreatePageGenericError;
+
+  /// No description provided for @itemCreatePageItemDeletedSuccess.
+  ///
+  /// In en, this message translates to:
+  /// **'Item deleted successfully.'**
+  String get itemCreatePageItemDeletedSuccess;
+
+  /// No description provided for @itemCreatePageItemDeleteError.
+  ///
+  /// In en, this message translates to:
+  /// **'Failed to delete item.'**
+  String get itemCreatePageItemDeleteError;
 }
 
 class _FlutterCatalogLocalizationsDelegate

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';
 
@@ -41,4 +44,53 @@ class FlutterCatalogLocalizationsEn extends FlutterCatalogLocalizations {
   String postedSince(Object date) {
     return 'Posted since $date';
   }
+
+  @override
+  String get itemCreatePageTitle => 'Create Item';
+
+  @override
+  String get itemEditPageTitle => 'Edit Item';
+
+  @override
+  String get itemCreatePageTitleHint => 'Title';
+
+  @override
+  String get itemCreatePageDescriptionHint => 'Description';
+
+  @override
+  String get itemCreatePageTitleRequiredError => 'Title is required.';
+
+  @override
+  String get itemCreatePageAddImagesButton => 'Add Images';
+
+  @override
+  String get itemCreatePageSaveChangesButton => 'Save Changes';
+
+  @override
+  String get itemCreatePageSavingChangesButton => 'Saving...';
+
+  @override
+  String get itemCreatePageDeleteItemButton => 'Delete Item';
+
+  @override
+  String get itemCreatePageDeleteConfirmationTitle => 'Delete Item';
+
+  @override
+  String get itemCreatePageDeleteConfirmationMessage =>
+      'Are you sure you want to delete this item forever?';
+
+  @override
+  String get itemCreatePageDeleteConfirmationConfirm => 'Delete';
+
+  @override
+  String get itemCreatePageDeleteConfirmationCancel => 'Cancel';
+
+  @override
+  String get itemCreatePageGenericError => 'An error occurred.';
+
+  @override
+  String get itemCreatePageItemDeletedSuccess => 'Item deleted successfully.';
+
+  @override
+  String get itemCreatePageItemDeleteError => 'Failed to delete item.';
 }

packages/flutter_catalog/lib/src/config/catalog_builders.dart

@@ -12,6 +12,7 @@ class CatalogBuilders {
     this.errorPlaceholderBuilder,
     this.noItemsPlaceholderBuilder,
     this.filterSectionBuilder,
+    this.primaryButtonBuilder = _defaultPrimaryButtonBuilder,
   });
 
   /// A builder for the main screen layout.
@@ -47,6 +48,26 @@ class CatalogBuilders {
   ///   (e.g., checkboxes, sliders).
   final Widget Function(BuildContext context, String title, Widget child)?
       filterSectionBuilder;
+
+  /// A builder for primary action buttons, like the 'Save' button.
+  ///
+  /// If not provided, a default [ElevatedButton] will be used.
+  final PrimaryButtonBuilder primaryButtonBuilder;
+
+  /// The default builder for the primary button.
+  static Widget _defaultPrimaryButtonBuilder(
+    BuildContext context, {
+    required VoidCallback onPressed,
+    // onDisabledPressed is ignored by the default implementation
+    // as a standard ElevatedButton is not clickable when disabled.
+    required VoidCallback onDisabledPressed,
+    required bool isDisabled,
+    required Widget child,
+  }) =>
+      ElevatedButton(
+        onPressed: isDisabled ? null : onPressed,
+        child: child,
+      );
 }
 
 /// The base screen builder signature.
@@ -63,3 +84,18 @@ typedef BaseScreenBuilder = Widget Function(
   String? title,
   Widget body,
 );
+
+/// A builder for a primary action button.
+///
+/// - [onPressed]: The callback for when the button is pressed and enabled.
+/// - [onDisabledPressed]: The callback for when the button is pressed but
+/// disabled.
+/// - [isDisabled]: Whether the button should be in a disabled state.
+/// - [child]: The widget to display inside the button.
+typedef PrimaryButtonBuilder = Widget Function(
+  BuildContext context, {
+  required VoidCallback onPressed,
+  required VoidCallback onDisabledPressed,
+  required bool isDisabled,
+  required Widget child,
+});

packages/flutter_catalog/lib/src/config/catalog_options.dart

@@ -43,13 +43,33 @@ class CatalogOptions {
 
   /// An optional filter configuration for managing item filtering.
   final FilterOptions? filterOptions;
+
+  /// Creates a copy of this object with the given fields replaced
+  /// with the new values.
+  CatalogOptions copyWith({
+    CatalogRepository? catalogRepository,
+    CatalogBuilders? builders,
+    CatalogTheme? theme,
+    CatalogTranslations? translations,
+    VoidCallback? onNoItems,
+    FilterOptions? filterOptions,
+  }) =>
+      CatalogOptions(
+        catalogRepository: catalogRepository ?? this.catalogRepository,
+        builders: builders ?? this.builders,
+        theme: theme ?? this.theme,
+        translations: translations ?? this.translations,
+        onNoItems: onNoItems ?? this.onNoItems,
+        filterOptions: filterOptions ?? this.filterOptions,
+      );
 }
 
 /// A configuration class for managing filter-related repositories and options.
 class FilterOptions {
   /// Constructs a [FilterOptions].
   const FilterOptions({
     this.showFiltersInOverview = true,
+    this.showSearchInOverview = true,
     this.filterRepository,
     this.filterValueRepository,
     this.filterDataSourceRepository,
@@ -61,6 +81,10 @@ class FilterOptions {
   /// displayed
   final bool showFiltersInOverview;
 
+  /// Whether to show the search bar in the overview screen's AppBar.
+  /// Defaults to true.
+  final bool showSearchInOverview;
+
   /// The repository for managing filter data.
   final FilterRepository? filterRepository;