feat: camera and gallery image selection for media attachments in composer

doc/roadmap.txt

···
       - [x] Immediate save on media add/remove
       - [x] Save on app backgrounding
       - [x] Cancel pending saves on dispose
-- [/] Image picker integration:
+- [x] Image picker integration:
       - [x] Gallery selection (image_picker)
-      - [ ] Camera capture
+      - [x] Camera capture
       - [x] Max 4 images limit
       - [x] JPEG/PNG/WebP support
       - [x] Add media to draft

ios/Runner/Info.plist

···
 				<string>org.stormlightlabs.lazurite</string>
 			</array>
 		</dict>
-	</array>
+
+	<key>NSPhotoLibraryUsageDescription</key>
+	<string>Lazurite needs access to your photo library to attach images to posts.</string>
+	<key>NSCameraUsageDescription</key>
+	<string>Lazurite needs access to your camera to take photos for posts.</string>
+	<key>NSMicrophoneUsageDescription</key>
+	<string>Lazurite needs access to your microphone for video recording.</string>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleDisplayName</key>

lib/src/features/composer/presentation/screens/composer_screen.dart

···
 
     if (currentCount >= 4) return;
 
+    // Show modal sheet to choose between Camera and Gallery
+    final source = await showModalBottomSheet<ImageSource>(
+      context: context,
+      showDragHandle: true,
+      builder: (context) => SafeArea(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            ListTile(
+              leading: const Icon(Icons.camera_alt_outlined),
+              title: const Text('Take photo'),
+              onTap: () => Navigator.pop(context, ImageSource.camera),
+            ),
+            ListTile(
+              leading: const Icon(Icons.photo_library_outlined),
+              title: const Text('Choose from gallery'),
+              onTap: () => Navigator.pop(context, ImageSource.gallery),
+            ),
+          ],
+        ),
+      ),
+    );
+
+    if (source == null) return;
+
+    if (!mounted) return;
+
     final picker = ImagePicker();
-    final images = await picker.pickMultiImage(limit: 4 - currentCount);
+    final notifier = ref.read(composerProvider(widget.draftId).notifier);
 
-    if (images.isNotEmpty) {
-      final notifier = ref.read(composerProvider(widget.draftId).notifier);
-      for (final image in images) {
+    if (source == ImageSource.camera) {
+      final image = await picker.pickImage(source: ImageSource.camera);
+      if (image != null) {
         final mimeType = _getMimeType(image.path);
         await notifier.addMedia(image.path, mimeType);
+      }
+    } else {
+      // Gallery allows multiple selection
+      final images = await picker.pickMultiImage(limit: 4 - currentCount);
+      if (images.isNotEmpty) {
+        for (final image in images) {
+          final mimeType = _getMimeType(image.path);
+          await notifier.addMedia(image.path, mimeType);
+        }
       }
     }
   }

pubspec.lock

···
     source: hosted
     version: "0.2.2+1"
   image_picker_platform_interface:
-    dependency: transitive
+    dependency: "direct dev"
     description:
       name: image_picker_platform_interface
       sha256: "567e056716333a1647c64bb6bd873cff7622233a5c3f694be28a583d4715690c"
···
     source: hosted
     version: "3.1.6"
   plugin_platform_interface:
-    dependency: transitive
+    dependency: "direct dev"
     description:
       name: plugin_platform_interface
       sha256: "4820fbfdb9478b1ebae27888254d445073732dae3d6ea81f0b7e06d5dedc3f02"

pubspec.yaml

···
   mocktail: ^1.0.4
   mocktail_image_network: ^1.2.0
   fake_async: ^1.3.3
+  image_picker_platform_interface: ^2.9.0
+  plugin_platform_interface: ^2.1.0
 
 flutter:
   uses-material-design: true

test/src/features/composer/presentation/screens/composer_screen_test.dart

···
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_test/flutter_test.dart';
 import 'package:go_router/go_router.dart';
+import 'package:image_picker_platform_interface/image_picker_platform_interface.dart';
 import 'package:lazurite/src/features/composer/application/composer_notifier.dart';
 import 'package:lazurite/src/features/composer/application/composer_providers.dart';
 import 'package:lazurite/src/features/composer/domain/draft.dart';
···
 import 'package:lazurite/src/features/composer/presentation/screens/composer_screen.dart';
 import 'package:lazurite/src/features/composer/presentation/widgets/publish_button.dart';
 import 'package:mocktail/mocktail.dart';
+import 'package:plugin_platform_interface/plugin_platform_interface.dart';
 
 class MockDraftRepository extends Mock implements DraftRepository {}
 
 void main() {
   late MockDraftRepository mockRepository;
+  late MockImagePickerPlatform mockImagePickerPlatform;
 
   setUp(() {
     mockRepository = MockDraftRepository();
+    mockImagePickerPlatform = MockImagePickerPlatform();
+    ImagePickerPlatform.instance = mockImagePickerPlatform;
+    registerFallbackValue(FakeImagePickerOptions());
+    registerFallbackValue(FakeMultiImagePickerOptions());
   });
 
   Draft createMockDraft({
···
 
       verify(() => notifier.mockForceSaveObj('Saving on pause')).called(1);
     });
+
+    testWidgets('shows image source selection sheet when adding media', (tester) async {
+      await tester.pumpWidget(buildTestWidget());
+      await tester.pumpAndSettle();
+
+      await tester.tap(find.byIcon(Icons.add_photo_alternate_outlined));
+      await tester.pumpAndSettle();
+
+      expect(find.text('Take photo'), findsOneWidget);
+      expect(find.text('Choose from gallery'), findsOneWidget);
+    });
+
+    testWidgets('picks image from camera', (tester) async {
+      final file = XFile('test_image.jpg');
+      when(
+        () => mockImagePickerPlatform.getImageFromSource(
+          source: ImageSource.camera,
+          options: any(named: 'options'),
+        ),
+      ).thenAnswer((_) async => file);
+
+      await tester.pumpWidget(buildTestWidget());
+      await tester.pumpAndSettle();
+
+      await tester.tap(find.byIcon(Icons.add_photo_alternate_outlined));
+      await tester.pumpAndSettle();
+
+      await tester.tap(find.text('Take photo'));
+      await tester.pumpAndSettle();
+
+      final element = tester.element(find.byType(ComposerScreen));
+      final container = ProviderScope.containerOf(element);
+      final notifier =
+          container.read(composerProvider(null).notifier) as MockComposerNotifierWrapper;
+
+      verify(() => notifier.mockAddMediaObj('test_image.jpg', 'image/jpeg')).called(1);
+    });
+
+    testWidgets('picks multiple images from gallery', (tester) async {
+      final file1 = XFile('image1.png');
+      final file2 = XFile('image2.webp');
+
+      when(
+        () => mockImagePickerPlatform.getMultiImageWithOptions(options: any(named: 'options')),
+      ).thenAnswer((_) async => [file1, file2]);
+
+      await tester.pumpWidget(buildTestWidget());
+      await tester.pumpAndSettle();
+
+      await tester.tap(find.byIcon(Icons.add_photo_alternate_outlined));
+      await tester.pumpAndSettle();
+
+      await tester.tap(find.text('Choose from gallery'));
+      await tester.pumpAndSettle();
+
+      final element = tester.element(find.byType(ComposerScreen));
+      final container = ProviderScope.containerOf(element);
+      final notifier =
+          container.read(composerProvider(null).notifier) as MockComposerNotifierWrapper;
+
+      verify(() => notifier.mockAddMediaObj('image1.png', 'image/png')).called(1);
+      verify(() => notifier.mockAddMediaObj('image2.webp', 'image/webp')).called(1);
+    });
   });
 }
 
···
   }
 
   void mockForceSave(String text) {}
+
+  @override
+  Future<void> addMedia(String path, String mimeType) async {
+    mockAddMedia(path, mimeType);
+  }
+
+  void mockAddMedia(String path, String mimeType) {}
 }
 
 class MockComposerNotifierWrapper extends _MockComposerNotifier {
   MockComposerNotifierWrapper(super.draft);
 
   final _mockForceSave = MockForceSave();
+  final _mockAddMedia = MockAddMedia();
 
   @override
   void mockForceSave(String text) => _mockForceSave(text);
 
+  @override
+  void mockAddMedia(String path, String mimeType) => _mockAddMedia(path, mimeType);
+
   MockForceSave get mockForceSaveObj => _mockForceSave;
+  MockAddMedia get mockAddMediaObj => _mockAddMedia;
+}
+
+class MockAddMedia extends Mock implements AddMediaHandler {}
+
+abstract class AddMediaHandler {
+  void call(String path, String mimeType);
 }
 
 abstract class ForceSaveHandler {
···
 }
 
 class MockForceSave extends Mock implements ForceSaveHandler {}
+
+class MockImagePickerPlatform extends Mock
+    with MockPlatformInterfaceMixin
+    implements ImagePickerPlatform {}
+
+class MockImagePicker extends Mock implements ImagePickerPlatform {}
+
+class FakeImagePickerOptions extends Fake implements ImagePickerOptions {}
+
+class FakeMultiImagePickerOptions extends Fake implements MultiImagePickerOptions {}