Flutter Catalog variant of the flutter_feed for playohood

.github/dependabot.yml

@@ -6,16 +6,41 @@ version: 2
 
 updates:
   - package-ecosystem: "pub"
-    directory: "/packages/flutter_timeline"
+    directory: "/packages/dart_feed_utilities"
     schedule:
       interval: "weekly"
-  
+
   - package-ecosystem: "pub"
-    directory: "/packages/flutter_timeline_interface"
+    directory: "/packages/flutter_catalog"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pub"
+    directory: "/packages/flutter_catalog_interface"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pub"
+    directory: "/packages/flutter_catalog_rest_api"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pub"
+    directory: "/packages/flutter_catalog_riverpod"
     schedule:
       interval: "weekly"
 
   - package-ecosystem: "pub"
     directory: "/packages/flutter_feed_utils"
     schedule:
       interval: "weekly"
+
+  - package-ecosystem: "pub"
+    directory: "/packages/flutter_timeline"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pub"
+    directory: "/packages/flutter_timeline_interface"
+    schedule:
+      interval: "weekly"

.github/workflows/release.yml

@@ -0,0 +1,14 @@
+name: Iconica Standard Component Release Workflow
+# Workflow Caller version: 1.0.0
+
+on:
+  release:
+    types: [published]
+
+  workflow_dispatch:
+
+jobs:
+  call-global-iconica-workflow:
+    uses: Iconica-Development/.github/.github/workflows/component-release.yml@master
+    secrets: inherit
+    permissions: write-all

.pre-commit-config.yaml

@@ -4,7 +4,7 @@ repos:
   hooks:
   - id: dart-format
     args:
-      - packages/dart_feed_utils/lib/*
+      - packages/dart_feed_utilities/lib/*
       - packages/flutter_feed_utils/lib/*
       - packages/flutter_timeline/lib/*
       - packages/flutter_timeline/example/lib/*

packages/flutter_catalog/.gitignore

@@ -0,0 +1,43 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

packages/flutter_catalog/analysis_options.yaml

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Iconica
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+include: package:flutter_iconica_analysis/components_options.yaml
+
+analyzer:
+  exclude: [lib/l10n/*.dart]
+
+linter:
+  rules:

packages/flutter_catalog/example/.gitignore

@@ -0,0 +1,48 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+app_localizations_en.dart
+app_localizations.dart

packages/flutter_catalog/example/analysis_options.yaml

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 Iconica
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+include: package:flutter_iconica_analysis/analysis_options.yaml
+
+analyzer:
+  exclude: [lib/l10n/*.dart]
+
+linter:
+  rules:

packages/flutter_catalog/example/l10n.yaml

@@ -0,0 +1,4 @@
+arb-dir: lib/l10n
+template-arb-file: app_en.arb
+output-localization-file: app_localizations.dart
+synthetic-package: false

packages/flutter_catalog/example/lib/l10n/app_en.arb

@@ -0,0 +1,3 @@
+{
+    "@@locale": "en"
+}

packages/flutter_catalog/example/lib/main.dart

@@ -0,0 +1,52 @@
+import "package:flutter/material.dart";
+import "package:flutter_catalog/flutter_catalog.dart";
+import "package:flutter_catalog_example/l10n/app_localizations.dart";
+
+void main() {
+  runApp(const CatalogExampleApp());
+}
+
+class CatalogExampleApp extends StatelessWidget {
+  const CatalogExampleApp({super.key});
+
+  @override
+  Widget build(BuildContext context) => MaterialApp(
+        title: "Flutter Catalog",
+        localizationsDelegates: const [
+          ...AppLocalizations.localizationsDelegates,
+          ...FlutterCatalogLocalizations.localizationsDelegates,
+        ],
+        supportedLocales: const [Locale("en")],
+        theme: ThemeData(
+          useMaterial3: true,
+          colorScheme: ColorScheme.fromSeed(
+            seedColor: const Color(0xFFBDE260),
+          ),
+          appBarTheme: const AppBarTheme(
+            backgroundColor: Color(0xFFBDE260),
+            foregroundColor: Colors.black,
+          ),
+        ),
+        home: const CatalogView(),
+      );
+}
+
+class CatalogView extends StatelessWidget {
+  const CatalogView({
+    super.key,
+  });
+
+  @override
+  Widget build(BuildContext context) => FlutterCatalogUserstory(
+        userId: "example_user",
+        options: CatalogOptions(
+          builders: CatalogBuilders(
+            baseScreenBuilder: (context, screenType, appBar, title, body) =>
+                Scaffold(
+              appBar: appBar,
+              body: body,
+            ),
+          ),
+        ),
+      );
+}

packages/flutter_catalog/example/pubspec.yaml

@@ -0,0 +1,29 @@
+name: flutter_catalog_example
+description: "Flutter Feed Catalog Example Application"
+publish_to: "none"
+
+version: 1.0.0+1
+
+environment:
+  sdk: ">=3.4.0 <4.0.0"
+dependencies:
+  flutter:
+    sdk: flutter
+  flutter_localizations:
+    sdk: flutter
+  flutter_catalog:
+    path: ../
+
+dependency_overrides:
+  flutter_hooks: 0.20.4
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_iconica_analysis:
+    hosted: https://forgejo.internal.iconica.nl/api/packages/internal/pub
+    version: ^7.0.0
+
+flutter:
+  uses-material-design: true
+  generate: true

packages/flutter_catalog/example/test/widget_test.dart

@@ -0,0 +1,15 @@
+// This is an example unit test.
+//
+// A unit test tests a single function, method, or class. To learn more about
+// writing unit tests, visit
+// https://flutter.dev/docs/cookbook/testing/unit/introduction
+
+import "package:flutter_test/flutter_test.dart";
+
+void main() {
+  group("Plus Operator", () {
+    test("should add two numbers together", () {
+      expect(1 + 1, 2);
+    });
+  });
+}

packages/flutter_catalog/l10n.yaml

@@ -0,0 +1,5 @@
+arb-dir: lib/l10n
+template-arb-file: app_en.arb
+output-localization-file: app_localizations.dart
+synthetic-package: false
+output-class: "FlutterCatalogLocalizations"

packages/flutter_catalog/lib/flutter_catalog.dart

@@ -0,0 +1,21 @@
+/// A library that provides a complete catalog user story.
+///
+/// Includes views for Browse, filtering, and viewing item details.
+library flutter_catalog;
+
+export "package:flutter_catalog_interface/flutter_catalog_interface.dart";
+
+export "/l10n/app_localizations.dart";
+export "src/config/catalog_builders.dart";
+export "src/config/catalog_filter_options.dart";
+export "src/config/catalog_options.dart";
+export "src/config/catalog_theme.dart";
+export "src/config/catalog_translations.dart";
+export "src/config/screen_types.dart";
+export "src/flutter_catalog_userstory.dart";
+export "src/repositories/memory_catalog_repository.dart";
+export "src/services/catalog_service.dart";
+export "src/services/pop_handler.dart";
+export "src/utils/scope.dart";
+export "src/views/views.dart";
+export "src/widgets/catalog_grid_item.dart";

packages/flutter_catalog/lib/l10n/app_en.arb

@@ -0,0 +1,40 @@
+{
+    "@@locale": "en",
+    "overviewTitle": "Toys near you",
+    "filtersTitle": "Filters",
+    "searchHint": "Find toys...",
+    "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": {
+        "placeholders": {
+            "date": {}
+        }
+    },
+    "editItemButton": "Edit",
+    "contactUserDisabledMessage": "You cannot contact the author of this item.",
+    "itemCreatePageTitle": "Create Item",
+    "priceFree": "Free",
+    "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."
+}