Merge branch 'main' into dependabot/npm_and_yarn/docs/prettier-3.7.1

Author: Josh-Sanford

docs/.eslintrc.js

@@ -0,0 +1,19 @@
+import babelParser from '@babel/eslint-parser';
+import docusaurus from '@docusaurus/eslint-plugin';
+
+export default [
+  {
+    files: ['**/*.{js,mjs,cjs,jsx}'],
+    plugins: {
+      '@docusaurus': docusaurus,
+    },
+    languageOptions: {
+      parser: babelParser,
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    rules: {
+      ...docusaurus.configs.recommended.rules,
+    },
+  },
+];

docs/eslint.config.mjs

@@ -31,7 +31,7 @@
     "@docusaurus/eslint-plugin": "^3.9.2",
     "@docusaurus/module-type-aliases": "3.9.2",
     "@tsconfig/docusaurus": "^2.0.7",
-    "eslint": "^8.57.0",
+    "eslint": "^9.39.1",
     "prettier": "^3.7.1",
     "typescript": "^5.9.3"
   },

docs/package-lock.json

@@ -56,7 +56,7 @@ class ArticlePage extends StatelessWidget {
     return BlocProvider<ArticleBloc>(
       create: (_) => ArticleBloc(
         articleId: id,
-        shareLauncher: const ShareLauncher(),
+        shareLauncher: ShareLauncher(),
         articleRepository: context.read<ArticleRepository>(),
       )..add(const ArticleRequested()),
       child: ArticleView(

docs/package.json

@@ -30,7 +30,7 @@ class SlideshowPage extends StatelessWidget {
     return BlocProvider(
       create: (context) => ArticleBloc(
         articleId: articleId,
-        shareLauncher: const ShareLauncher(),
+        shareLauncher: ShareLauncher(),
         articleRepository: context.read<ArticleRepository>(),
       ),
       child: SlideshowView(block: slideshow),

flutter_news_example/lib/article/view/article_page.dart

@@ -16,24 +16,24 @@ class ShareFailure with EquatableMixin implements Exception {
 }
 
 /// ShareProvider is a function type that provides the ability to share content.
-typedef ShareProvider = Future<void> Function(String);
+typedef ShareProvider = Future<ShareResult> Function(ShareParams);
 
 /// {@template share_launcher}
 /// A class allowing opening native share bottom sheet.
 /// {@endtemplate}
 class ShareLauncher {
   /// {@macro share_launcher}
 
-  const ShareLauncher({ShareProvider? shareProvider})
-    : _shareProvider = shareProvider ?? Share.share;
+  ShareLauncher({ShareProvider? shareProvider})
+    : _shareProvider = shareProvider ?? SharePlus.instance.share;
 
   final ShareProvider _shareProvider;
 
   /// Method for opening native share bottom sheet.
   Future<void> share({required String text}) async {
     try {
-      return _shareProvider(text);
-    } catch (error, stackTrace) {
+      await _shareProvider(ShareParams(text: text));
+    } on Exception catch (error, stackTrace) {
       Error.throwWithStackTrace(ShareFailure(error), stackTrace);
     }
   }

flutter_news_example/lib/slideshow/view/slideshow_page.dart

@@ -10,8 +10,8 @@ dependencies:
   equatable: ^2.0.3
   flutter:
     sdk: flutter
-  share_plus: ^10.0.2
-  share_plus_platform_interface: ^5.0.0
+  share_plus: ^12.0.1
+  share_plus_platform_interface: ^6.1.0
 
 dev_dependencies:
   flutter_test:

flutter_news_example/packages/share_launcher/lib/src/share_launcher.dart

@@ -10,6 +10,9 @@ class MockSharePlatform extends Mock
     implements SharePlatform {}
 
 void main() {
+  setUpAll(() {
+    registerFallbackValue(ShareParams(text: 'fallback'));
+  });
   group('ShareFailure', () {
     test('supports value comparison', () {
       final shareFailure1 = ShareFailure('error');
@@ -25,9 +28,10 @@ void main() {
       var called = false;
 
       final shareLauncher = ShareLauncher(
-        shareProvider: (String text) async {
+        shareProvider: (params) async {
           called = true;
-          expect(text, equals('text'));
+          expect(params.text, equals('text'));
+          return ShareResult('raw', ShareResultStatus.success);
         },
       );
 
@@ -38,7 +42,7 @@ void main() {
 
     test('throws ShareFailure when shareLauncher throws', () async {
       final shareLauncher = ShareLauncher(
-        shareProvider: (String text) => throw Exception(),
+        shareProvider: (params) => throw Exception(),
       );
 
       expect(shareLauncher.share(text: 'text'), throwsA(isA<ShareFailure>()));
@@ -49,12 +53,12 @@ void main() {
       final mock = MockSharePlatform();
       SharePlatform.instance = mock;
       when(
-        () => SharePlatform.instance.share(any(that: isA<String>())),
+        () => SharePlatform.instance.share(any(that: isA<ShareParams>())),
       ).thenAnswer((_) async => ShareResult('raw', ShareResultStatus.success));
 
       await ShareLauncher().share(text: 'text');
 
-      verify(() => mock.share('text')).called(1);
+      verify(() => mock.share(any(that: isA<ShareParams>()))).called(1);
     });
   });
 }