feat(cat-voices): share dialog in proposal view (#2256)

* feat(cat-voices): share dialog in proposal view

* refactor(cat-voices): rename selfRef to proposalId for clarity in ProposalViewHeader and related components

* refactor(cat-voices): rename proposalId to proposalRef

* refactor(cat-voices): rename proposalId to proposalRef in ProposalViewHeader for improved clarity

Author: LynxLynxx

catalyst_voices/apps/voices/lib/pages/proposal/widget/proposal_share_button.dart

@@ -1,15 +1,48 @@
+import 'dart:async';
+
+import 'package:catalyst_voices/routes/routing/proposal_route.dart';
 import 'package:catalyst_voices/widgets/buttons/voices_buttons.dart';
+import 'package:catalyst_voices/widgets/modals/proposals/share_proposal_dialog.dart';
+import 'package:catalyst_voices/widgets/snackbar/voices_snackbar.dart';
+import 'package:catalyst_voices/widgets/snackbar/voices_snackbar_type.dart';
+import 'package:catalyst_voices_blocs/catalyst_voices_blocs.dart';
+import 'package:catalyst_voices_localization/catalyst_voices_localization.dart';
+import 'package:catalyst_voices_models/catalyst_voices_models.dart';
 import 'package:flutter/material.dart';
+import 'package:flutter_bloc/flutter_bloc.dart';
 
 class ProposalShareButton extends StatelessWidget {
   const ProposalShareButton({super.key});
 
   @override
   Widget build(BuildContext context) {
-    return ShareButton(
-      onTap: () {
-        // TODO(LynxLynxx): Implement Share
+    return BlocSelector<ProposalCubit, ProposalState, DocumentRef?>(
+      selector: (state) {
+        return state.data.header.proposalRef;
+      },
+      builder: (context, proposalRef) {
+        return ShareButton(
+          onTap: () {
+            if (proposalRef != null) {
+              final url = ProposalRoute.fromRef(ref: proposalRef).location;
+              unawaited(ShareProposalDialog.show(context, url));
+            } else {
+              _showErrorSnackbar(context);
+            }
+          },
+        );
       },
     );
   }
+
+  void _showErrorSnackbar(BuildContext context) {
+    VoicesSnackBar.hideCurrent(context);
+
+    VoicesSnackBar(
+      type: VoicesSnackBarType.error,
+      behavior: SnackBarBehavior.floating,
+      title: context.l10n.somethingWentWrong,
+      message: context.l10n.shareProposalErrorDescription,
+    ).show(context);
+  }
 }

catalyst_voices/packages/internal/catalyst_voices_blocs/lib/src/proposal/proposal_cubit.dart

@@ -265,6 +265,7 @@ final class ProposalCubit extends Cubit<ProposalState>
         : const <Segment>[];
 
     final header = ProposalViewHeader(
+      proposalRef: proposalDocumentRef,
       title: proposalDocument?.title ?? '',
       authorName: proposalDocument?.authorName ?? '',
       createdAt: proposalDocumentRef?.version?.tryDateTime,

catalyst_voices/packages/internal/catalyst_voices_localization/lib/l10n/intl_en.arb

@@ -2546,5 +2546,9 @@
         "type": "int"
       }
     }
+  },
+  "shareProposalErrorDescription": "Something went wrong while sharing proposal. Please try again later.",
+  "@shareProposalErrorDescription": {
+    "description": "Error description when sharing proposal fails"
   }
 }

catalyst_voices/packages/internal/catalyst_voices_view_models/lib/src/proposal/proposal_view_header.dart

@@ -3,6 +3,7 @@ import 'package:catalyst_voices_view_models/catalyst_voices_view_models.dart';
 import 'package:equatable/equatable.dart';
 
 final class ProposalViewHeader extends Equatable {
+  final DocumentRef? proposalRef;
   final String title;
   final String authorName;
   final DateTime? createdAt;
@@ -11,6 +12,7 @@ final class ProposalViewHeader extends Equatable {
   final bool isFavorite;
 
   const ProposalViewHeader({
+    this.proposalRef,
     this.title = '',
     this.authorName = '',
     this.createdAt,
@@ -21,6 +23,7 @@ final class ProposalViewHeader extends Equatable {
 
   @override
   List<Object?> get props => [
+        proposalRef,
         title,
         authorName,
         createdAt,
@@ -30,6 +33,7 @@ final class ProposalViewHeader extends Equatable {
       ];
 
   ProposalViewHeader copyWith({
+    Optional<DocumentRef>? proposalRef,
     String? title,
     String? authorName,
     Optional<DateTime>? createdAt,
@@ -38,6 +42,7 @@ final class ProposalViewHeader extends Equatable {
     bool? isFavorite,
   }) {
     return ProposalViewHeader(
+      proposalRef: proposalRef.dataOr(this.proposalRef),
       title: title ?? this.title,
       authorName: authorName ?? this.authorName,
       createdAt: createdAt.dataOr(this.createdAt),