Merge pull request #818 from navaronbracke/reorganise_classes

feat: Move classes into their own files

+## NEXT
+Improvements:
+* The `type` of an `Address` is now non-null.
+* The `type` of an `Email` is now non-null.
+* The `phoneNumber` of an `SMS` is now non-null.
+* The `latitude` and `longitude` of a `GeoPoint` are now non-null.
+* The `phones` and `urls` of `ContactInfo` are now non-null.
+* The `url` of a `UrlBookmark` is now non-null.
+* The `type` of `Phone` is now non-null.
+* The `width` and `height` of `BarcodeCapture` are now non-null.
+* The `BarcodeCapture` class now exposes a `size`.
+* The list of `corners` of a `Barcode` is now non-null.
+* The internal `fromNative()` methods now accept a `Map<Object?, Object?>` instead of `Map<dynamic, dynamic>`.
+
 ## 3.5.0
 ## 3.5.0
 New Features:
 New Features:
 * Added the option to switch between bundled and unbundled MLKit for Android. (thanks @woolfred !)
 * Added the option to switch between bundled and unbundled MLKit for Android. (thanks @woolfred !)

 import 'dart:io';
 import 'dart:io';
 
 
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/material.dart';
 import 'package:mobile_scanner/mobile_scanner.dart';
 import 'package:mobile_scanner/mobile_scanner.dart';
 
 
@@ -150,7 +151,10 @@ class BarcodeOverlay extends CustomPainter {
 
 
   @override
   @override
   void paint(Canvas canvas, Size size) {
   void paint(Canvas canvas, Size size) {
-    if (barcode.corners == null) return;
+    if (barcode.corners.isEmpty) {
+      return;
+    }
+
     final adjustedSize = applyBoxFit(boxFit, arguments.size, size);
     final adjustedSize = applyBoxFit(boxFit, arguments.size, size);
 
 
     double verticalPadding = size.height - adjustedSize.destination.height;
     double verticalPadding = size.height - adjustedSize.destination.height;
@@ -167,15 +171,19 @@ class BarcodeOverlay extends CustomPainter {
       horizontalPadding = 0;
       horizontalPadding = 0;
     }
     }
 
 
-    final ratioWidth =
-        (Platform.isIOS ? capture.width! : arguments.size.width) /
-            adjustedSize.destination.width;
-    final ratioHeight =
-        (Platform.isIOS ? capture.height! : arguments.size.height) /
-            adjustedSize.destination.height;
+    final double ratioWidth;
+    final double ratioHeight;
+
+    if (!kIsWeb && Platform.isIOS) {
+      ratioWidth = capture.size.width / adjustedSize.destination.width;
+      ratioHeight = capture.size.height / adjustedSize.destination.height;
+    } else {
+      ratioWidth = arguments.size.width / adjustedSize.destination.width;
+      ratioHeight = arguments.size.height / adjustedSize.destination.height;
+    }
 
 
     final List<Offset> adjustedOffset = [];
     final List<Offset> adjustedOffset = [];
-    for (final offset in barcode.corners!) {
+    for (final offset in barcode.corners) {
       adjustedOffset.add(
       adjustedOffset.add(
         Offset(
         Offset(
           offset.dx / ratioWidth + horizontalPadding,
           offset.dx / ratioWidth + horizontalPadding,

@@ -12,6 +12,17 @@ export 'src/enums/torch_state.dart';
 export 'src/mobile_scanner.dart';
 export 'src/mobile_scanner.dart';
 export 'src/mobile_scanner_controller.dart';
 export 'src/mobile_scanner_controller.dart';
 export 'src/mobile_scanner_exception.dart';
 export 'src/mobile_scanner_exception.dart';
+export 'src/objects/address.dart';
 export 'src/objects/barcode.dart';
 export 'src/objects/barcode.dart';
 export 'src/objects/barcode_capture.dart';
 export 'src/objects/barcode_capture.dart';
+export 'src/objects/calendar_event.dart';
+export 'src/objects/contact_info.dart';
+export 'src/objects/driver_license.dart';
+export 'src/objects/email.dart';
+export 'src/objects/geo_point.dart';
 export 'src/objects/mobile_scanner_arguments.dart';
 export 'src/objects/mobile_scanner_arguments.dart';
+export 'src/objects/person_name.dart';
+export 'src/objects/phone.dart';
+export 'src/objects/sms.dart';
+export 'src/objects/url_bookmark.dart';
+export 'src/objects/wifi.dart';

@@ -130,8 +130,6 @@ class MobileScannerWebPlugin {
       _barCodeStreamSubscription =
       _barCodeStreamSubscription =
           barCodeReader.detectBarcodeContinuously().listen((code) {
           barCodeReader.detectBarcodeContinuously().listen((code) {
         if (code != null) {
         if (code != null) {
-          final List<Offset>? corners = code.corners;
-
           controller.add({
           controller.add({
             'name': 'barcodeWeb',
             'name': 'barcodeWeb',
             'data': {
             'data': {
@@ -140,8 +138,8 @@ class MobileScannerWebPlugin {
               'format': code.format.rawValue,
               'format': code.format.rawValue,
               'displayValue': code.displayValue,
               'displayValue': code.displayValue,
               'type': code.type.rawValue,
               'type': code.type.rawValue,
-              if (corners != null && corners.isNotEmpty)
-                'corners': corners
+              if (code.corners.isNotEmpty)
+                'corners': code.corners
                     .map(
                     .map(
                       (Offset c) => <Object?, Object?>{'x': c.dx, 'y': c.dy},
                       (Offset c) => <Object?, Object?>{'x': c.dx, 'y': c.dy},
                     )
                     )

@@ -442,9 +442,10 @@ class MobileScannerController {
                   rawBytes: barcode['rawBytes'] as Uint8List?,
                   rawBytes: barcode['rawBytes'] as Uint8List?,
                   format: toFormat(barcode['format'] as int),
                   format: toFormat(barcode['format'] as int),
                   corners: toCorners(
                   corners: toCorners(
-                    (barcode['corners'] as List<Object?>? ?? [])
-                        .cast<Map<Object?, Object?>>(),
-                  ),
+                        (barcode['corners'] as List<Object?>? ?? [])
+                            .cast<Map<Object?, Object?>>(),
+                      ) ??
+                      const <Offset>[],
                 ),
                 ),
             ],
             ],
           ),
           ),

+import 'package:mobile_scanner/src/enums/address_type.dart';
+
+/// An address.
+class Address {
+  /// Creates a new [Address] instance.
+  const Address({
+    this.addressLines = const <String>[],
+    this.type = AddressType.unknown,
+  });
+
+  /// Creates a new [Address] instance from a map.
+  factory Address.fromNative(Map<Object?, Object?> data) {
+    final List<Object?>? addressLines = data['addressLines'] as List<Object?>?;
+    final AddressType type = AddressType.fromRawValue(
+      data['type'] as int? ?? 0,
+    );
+
+    if (addressLines == null) {
+      return Address(type: type);
+    }
+
+    return Address(
+      addressLines: List.unmodifiable(addressLines.cast<String>()),
+      type: type,
+    );
+  }
+
+  /// The address lines that represent this address.
+  final List<String> addressLines;
+
+  /// Gets type of the address.
+  final AddressType type;
+}

@@ -2,12 +2,17 @@ import 'dart:typed_data';
 import 'dart:ui';
 import 'dart:ui';
 
 
 import 'package:mobile_scanner/src/barcode_utility.dart';
 import 'package:mobile_scanner/src/barcode_utility.dart';
-import 'package:mobile_scanner/src/enums/address_type.dart';
 import 'package:mobile_scanner/src/enums/barcode_format.dart';
 import 'package:mobile_scanner/src/enums/barcode_format.dart';
 import 'package:mobile_scanner/src/enums/barcode_type.dart';
 import 'package:mobile_scanner/src/enums/barcode_type.dart';
-import 'package:mobile_scanner/src/enums/email_type.dart';
-import 'package:mobile_scanner/src/enums/encryption_type.dart';
-import 'package:mobile_scanner/src/enums/phone_type.dart';
+import 'package:mobile_scanner/src/objects/calendar_event.dart';
+import 'package:mobile_scanner/src/objects/contact_info.dart';
+import 'package:mobile_scanner/src/objects/driver_license.dart';
+import 'package:mobile_scanner/src/objects/email.dart';
+import 'package:mobile_scanner/src/objects/geo_point.dart';
+import 'package:mobile_scanner/src/objects/phone.dart';
+import 'package:mobile_scanner/src/objects/sms.dart';
+import 'package:mobile_scanner/src/objects/url_bookmark.dart';
+import 'package:mobile_scanner/src/objects/wifi.dart';
 
 
 /// Represents a single recognized barcode and its value.
 /// Represents a single recognized barcode and its value.
 class Barcode {
 class Barcode {
@@ -16,7 +21,7 @@ class Barcode {
   /// Due to the possible perspective distortions, this is not necessarily a rectangle.
   /// Due to the possible perspective distortions, this is not necessarily a rectangle.
   ///
   ///
   /// Returns null if the corner points can not be determined.
   /// Returns null if the corner points can not be determined.
-  final List<Offset>? corners;
+  final List<Offset> corners;
 
 
   /// Returns barcode format
   /// Returns barcode format
   final BarcodeFormat format;
   final BarcodeFormat format;
@@ -79,7 +84,7 @@ class Barcode {
   final WiFi? wifi;
   final WiFi? wifi;
 
 
   Barcode({
   Barcode({
-    this.corners,
+    this.corners = const <Offset>[],
     this.format = BarcodeFormat.ean13,
     this.format = BarcodeFormat.ean13,
     this.rawBytes,
     this.rawBytes,
     this.type = BarcodeType.text,
     this.type = BarcodeType.text,
@@ -99,8 +104,9 @@ class Barcode {
   /// Create a [Barcode] from native data.
   /// Create a [Barcode] from native data.
   Barcode.fromNative(Map data)
   Barcode.fromNative(Map data)
       : corners = toCorners(
       : corners = toCorners(
-          (data['corners'] as List?)?.cast<Map<Object?, Object?>>(),
-        ),
+              (data['corners'] as List?)?.cast<Map<Object?, Object?>>(),
+            ) ??
+            const <Offset>[],
         format = toFormat(data['format'] as int),
         format = toFormat(data['format'] as int),
         rawBytes = data['rawBytes'] as Uint8List?,
         rawBytes = data['rawBytes'] as Uint8List?,
         rawValue = data['rawValue'] as String?,
         rawValue = data['rawValue'] as String?,
@@ -116,393 +122,3 @@ class Barcode {
         url = toUrl(data['url'] as Map?),
         url = toUrl(data['url'] as Map?),
         wifi = toWiFi(data['wifi'] as Map?);
         wifi = toWiFi(data['wifi'] as Map?);
 }
 }
-
-/// A calendar event extracted from QRCode.
-class CalendarEvent {
-  /// Gets the description of the calendar event.
-  ///
-  /// Returns null if not available.
-  final String? description;
-
-  /// Gets the start date time of the calendar event.
-  ///
-  /// Returns null if not available.
-  final DateTime? start;
-
-  /// Gets the end date time of the calendar event.
-  ///
-  /// Returns null if not available.
-  final DateTime? end;
-
-  /// Gets the location of the calendar event.
-  ///
-  /// Returns null if not available.
-  final String? location;
-
-  /// Gets the organizer of the calendar event.
-  ///
-  /// Returns null if not available.
-  final String? organizer;
-
-  /// Gets the status of the calendar event.
-  ///
-  /// Returns null if not available.
-  final String? status;
-
-  /// Gets the summary of the calendar event.
-  ///
-  /// Returns null if not available.
-  final String? summary;
-
-  /// Create a [CalendarEvent] from native data.
-  CalendarEvent.fromNative(Map data)
-      : description = data['description'] as String?,
-        start = data['start'] != null
-            ? DateTime.tryParse(data['start'] as String)
-            : null,
-        end = data['end'] != null
-            ? DateTime.tryParse(data['end'] as String)
-            : null,
-        location = data['location'] as String?,
-        organizer = data['organizer'] as String?,
-        status = data['status'] as String?,
-        summary = data['summary'] as String?;
-}
-
-/// A person's or organization's business card. For example a VCARD.
-class ContactInfo {
-  /// Gets contact person's addresses.
-  ///
-  /// Returns an empty list if nothing found.
-  final List<Address> addresses;
-
-  /// Gets contact person's emails.
-  ///
-  /// Returns an empty list if nothing found.
-  final List<Email> emails;
-
-  /// Gets contact person's name.
-  ///
-  /// Returns null if not available.
-  final PersonName? name;
-
-  /// Gets contact person's organization.
-  ///
-  /// Returns null if not available.
-  final String? organization;
-
-  /// Gets contact person's phones.
-  ///
-  /// Returns an empty list if nothing found.
-  final List<Phone>? phones;
-
-  /// Gets contact person's title.
-  ///
-  /// Returns null if not available.
-  final String? title;
-
-  /// Gets contact person's urls.
-  ///
-  /// Returns an empty list if nothing found.
-  final List<String>? urls;
-
-  /// Create a [ContactInfo] from native data.
-  ContactInfo.fromNative(Map data)
-      : addresses = List.unmodifiable(
-          (data['addresses'] as List? ?? [])
-              .cast<Map>()
-              .map(Address.fromNative),
-        ),
-        emails = List.unmodifiable(
-          (data['emails'] as List? ?? []).cast<Map>().map(Email.fromNative),
-        ),
-        name = toName(data['name'] as Map?),
-        organization = data['organization'] as String?,
-        phones = List.unmodifiable(
-          (data['phones'] as List? ?? []).cast<Map>().map(Phone.fromNative),
-        ),
-        title = data['title'] as String?,
-        urls = List.unmodifiable((data['urls'] as List? ?? []).cast<String>());
-}
-
-/// An address.
-class Address {
-  /// Gets formatted address, multiple lines when appropriate. This field always contains at least one line.
-  final List<String> addressLines;
-
-  /// Gets type of the address.
-  ///
-  /// Returns null if not available.
-  final AddressType? type;
-
-  /// Create a [Address] from native data.
-  Address.fromNative(Map data)
-      : addressLines = List.unmodifiable(
-          (data['addressLines'] as List? ?? []).cast<String>(),
-        ),
-        type = AddressType.values[data['type'] as int];
-}
-
-/// A person's name, both formatted version and individual name components.
-class PersonName {
-  /// Gets first name.
-  ///
-  /// Returns null if not available.
-  final String? first;
-
-  /// Gets middle name.
-  ///
-  /// Returns null if not available.
-  final String? middle;
-
-  /// Gets last name.
-  ///
-  /// Returns null if not available.
-  final String? last;
-
-  /// Gets prefix of the name.
-  ///
-  /// Returns null if not available.
-  final String? prefix;
-
-  /// Gets suffix of the person's name.
-  ///
-  /// Returns null if not available.
-  final String? suffix;
-
-  /// Gets the properly formatted name.
-  ///
-  /// Returns null if not available.
-  final String? formattedName;
-
-  /// Designates a text string to be set as the kana name in the phonebook. Used for Japanese contacts.
-  ///
-  /// Returns null if not available.
-  final String? pronunciation;
-
-  /// Create a [PersonName] from native data.
-  PersonName.fromNative(Map data)
-      : first = data['first'] as String?,
-        middle = data['middle'] as String?,
-        last = data['last'] as String?,
-        prefix = data['prefix'] as String?,
-        suffix = data['suffix'] as String?,
-        formattedName = data['formattedName'] as String?,
-        pronunciation = data['pronunciation'] as String?;
-}
-
-/// A driver license or ID card.
-class DriverLicense {
-  /// Gets city of holder's address.
-  ///
-  /// Returns null if not available.
-  final String? addressCity;
-
-  /// Gets state of holder's address.
-  ///
-  /// Returns null if not available.
-  final String? addressState;
-
-  /// Gets holder's street address.
-  ///
-  /// Returns null if not available.
-  final String? addressStreet;
-
-  /// Gets postal code of holder's address.
-  ///
-  /// Returns null if not available.
-  final String? addressZip;
-
-  /// Gets birth date of the holder.
-  ///
-  /// Returns null if not available.
-  final String? birthDate;
-
-  /// Gets "DL" for driver licenses, "ID" for ID cards.
-  ///
-  /// Returns null if not available.
-  final String? documentType;
-
-  /// Gets expiry date of the license.
-  ///
-  /// Returns null if not available.
-  final String? expiryDate;
-
-  /// Gets holder's first name.
-  ///
-  /// Returns null if not available.
-  final String? firstName;
-
-  /// Gets holder's gender. 1 - male, 2 - female.
-  ///
-  /// Returns null if not available.
-  final String? gender;
-
-  /// Gets issue date of the license.
-  ///
-  /// The date format depends on the issuing country. MMDDYYYY for the US, YYYYMMDD for Canada.
-  ///
-  /// Returns null if not available.
-  final String? issueDate;
-
-  /// Gets the three-letter country code in which DL/ID was issued.
-  ///
-  /// Returns null if not available.
-  final String? issuingCountry;
-
-  /// Gets holder's last name.
-  ///
-  /// Returns null if not available.
-  final String? lastName;
-
-  /// Gets driver license ID number.
-  ///
-  /// Returns null if not available.
-  final String? licenseNumber;
-
-  /// Gets holder's middle name.
-  ///
-  /// Returns null if not available.
-  final String? middleName;
-
-  /// Create a [DriverLicense] from native data.
-  DriverLicense.fromNative(Map data)
-      : addressCity = data['addressCity'] as String?,
-        addressState = data['addressState'] as String?,
-        addressStreet = data['addressStreet'] as String?,
-        addressZip = data['addressZip'] as String?,
-        birthDate = data['birthDate'] as String?,
-        documentType = data['documentType'] as String?,
-        expiryDate = data['expiryDate'] as String?,
-        firstName = data['firstName'] as String?,
-        gender = data['gender'] as String?,
-        issueDate = data['issueDate'] as String?,
-        issuingCountry = data['issuingCountry'] as String?,
-        lastName = data['lastName'] as String?,
-        licenseNumber = data['licenseNumber'] as String?,
-        middleName = data['middleName'] as String?;
-}
-
-/// An email message from a 'MAILTO:' or similar QRCode type.
-class Email {
-  /// Gets email's address.
-  ///
-  /// Returns null if not available.
-  final String? address;
-
-  /// Gets email's body.
-  ///
-  /// Returns null if not available.
-  final String? body;
-
-  /// Gets email's subject.
-  ///
-  /// Returns null if not available.
-  final String? subject;
-
-  /// Gets type of the email.
-  ///
-  /// See also [EmailType].
-  /// Returns null if not available.
-  final EmailType? type;
-
-  /// Create a [Email] from native data.
-  Email.fromNative(Map data)
-      : address = data['address'] as String?,
-        body = data['body'] as String?,
-        subject = data['subject'] as String?,
-        type = EmailType.values[data['type'] as int];
-}
-
-/// GPS coordinates from a 'GEO:' or similar QRCode type.
-class GeoPoint {
-  /// Gets the latitude.
-  final double? latitude;
-
-  /// Gets the longitude.
-  final double? longitude;
-
-  /// Create a [GeoPoint] from native data.
-  GeoPoint.fromNative(Map data)
-      : latitude = data['latitude'] as double?,
-        longitude = data['longitude'] as double?;
-}
-
-/// Phone number info.
-class Phone {
-  /// Gets phone number.
-  ///
-  /// Returns null if not available.
-  final String? number;
-
-  /// Gets type of the phone number.
-  ///
-  /// See also [PhoneType].
-  /// Returns null if not available.
-  final PhoneType? type;
-
-  /// Create a [Phone] from native data.
-  Phone.fromNative(Map data)
-      : number = data['number'] as String?,
-        type = PhoneType.values[data['type'] as int];
-}
-
-/// A sms message from a 'SMS:' or similar QRCode type.
-class SMS {
-  /// Gets the message content of the sms.
-  ///
-  /// Returns null if not available.
-  final String? message;
-
-  /// Gets the phone number of the sms.
-  ///
-  /// Returns null if not available.
-  final String? phoneNumber;
-
-  /// Create a [SMS] from native data.
-  SMS.fromNative(Map data)
-      : message = data['message'] as String?,
-        phoneNumber = data['phoneNumber'] as String?;
-}
-
-/// A URL and title from a 'MEBKM:' or similar QRCode type.
-class UrlBookmark {
-  /// Gets the title of the bookmark.
-  ///
-  /// Returns null if not available.
-  final String? title;
-
-  /// Gets the url of the bookmark.
-  ///
-  /// Returns null if not available.
-  final String? url;
-
-  /// Create a [UrlBookmark] from native data.
-  UrlBookmark.fromNative(Map data)
-      : title = data['title'] as String?,
-        url = data['url'] as String?;
-}
-
-/// A wifi network parameters from a 'WIFI:' or similar QRCode type.
-class WiFi {
-  /// Gets the encryption type of the WIFI.
-  ///
-  /// See all [EncryptionType].
-  final EncryptionType encryptionType;
-
-  /// Gets the ssid of the WIFI.
-  ///
-  /// Returns null if not available.
-  final String? ssid;
-
-  /// Gets the password of the WIFI.
-  ///
-  /// Returns null if not available.
-  final String? password;
-
-  /// Create a [WiFi] from native data.
-  WiFi.fromNative(Map data)
-      : encryptionType = EncryptionType.values[data['encryptionType'] as int],
-        ssid = data['ssid'] as String?,
-        password = data['password'] as String?;
-}

 import 'dart:typed_data';
 import 'dart:typed_data';
+import 'dart:ui';
 
 
 import 'package:mobile_scanner/src/objects/barcode.dart';
 import 'package:mobile_scanner/src/objects/barcode.dart';
 
 
-/// The return object after a frame is scanned.
-///
-/// [barcodes] A list with barcodes. A scanned frame can contain multiple
-/// barcodes.
-/// [image] If enabled, an image of the scanned frame.
+/// This class represents a scanned barcode.
 class BarcodeCapture {
 class BarcodeCapture {
+  /// Create a new [BarcodeCapture] instance.
+  BarcodeCapture({
+    this.barcodes = const <Barcode>[],
+    double? height,
+    this.image,
+    this.raw,
+    double? width,
+  }) : size =
+            width == null && height == null ? Size.zero : Size(width!, height!);
+
+  /// The list of scanned barcodes.
   final List<Barcode> barcodes;
   final List<Barcode> barcodes;
-  final dynamic raw;
 
 
+  /// The bytes of the image that is embedded in the barcode.
+  ///
+  /// This null if [MobileScannerController.returnImage] is false.
   final Uint8List? image;
   final Uint8List? image;
 
 
-  final double? width;
+  /// The raw data of the scanned barcode.
+  final dynamic raw; // TODO: this should be `Object?` instead of dynamic
 
 
-  final double? height;
+  /// The size of the scanned barcode.
+  final Size size;
 
 
-  BarcodeCapture({
-    required this.barcodes,
-    required this.raw,
-    this.image,
-    this.width,
-    this.height,
-  });
+  /// The width of the scanned barcode.
+  ///
+  /// Prefer using `size.width` instead,
+  /// as this getter will be removed in the future.
+  double get width => size.width;
+
+  /// The height of the scanned barcode.
+  ///
+  /// Prefer using `size.height` instead,
+  /// as this getter will be removed in the future.
+  double get height => size.height;
 }
 }

+/// A calendar event extracted from a QRCode.
+class CalendarEvent {
+  /// Create a new [CalendarEvent] instance.
+  const CalendarEvent({
+    this.description,
+    this.start,
+    this.end,
+    this.location,
+    this.organizer,
+    this.status,
+    this.summary,
+  });
+
+  /// Create a new [CalendarEvent] instance from a map.
+  factory CalendarEvent.fromNative(Map<Object?, Object?> data) {
+    return CalendarEvent(
+      description: data['description'] as String?,
+      start: DateTime.tryParse(data['start'] as String? ?? ''),
+      end: DateTime.tryParse(data['end'] as String? ?? ''),
+      location: data['location'] as String?,
+      organizer: data['organizer'] as String?,
+      status: data['status'] as String?,
+      summary: data['summary'] as String?,
+    );
+  }
+
+  /// The description of the calendar event.
+  final String? description;
+
+  /// The start time of the calendar event.
+  final DateTime? start;
+
+  /// The end time of the calendar event.
+  final DateTime? end;
+
+  /// The location of the calendar event.
+  final String? location;
+
+  /// The organizer of the calendar event.
+  final String? organizer;
+
+  /// The status of the calendar event.
+  final String? status;
+
+  /// The summary of the calendar event.
+  final String? summary;
+}

+import 'package:mobile_scanner/src/objects/address.dart';
+import 'package:mobile_scanner/src/objects/email.dart';
+import 'package:mobile_scanner/src/objects/person_name.dart';
+import 'package:mobile_scanner/src/objects/phone.dart';
+
+/// A person's or organization's business card.
+/// For example a VCARD.
+class ContactInfo {
+  /// Create a new [ContactInfo] instance.
+  const ContactInfo({
+    this.addresses = const <Address>[],
+    this.emails = const <Email>[],
+    this.name,
+    this.organization,
+    this.phones = const <Phone>[],
+    this.title,
+    this.urls = const <String>[],
+  });
+
+  /// Create a new [ContactInfo] instance from a map.
+  factory ContactInfo.fromNative(Map<Object?, Object?> data) {
+    final List<Object?>? addresses = data['addresses'] as List<Object?>?;
+    final List<Object?>? emails = data['emails'] as List<Object?>?;
+    final List<Object?>? phones = data['phones'] as List<Object?>?;
+    final List<Object?>? urls = data['urls'] as List<Object?>?;
+    final Map<Object?, Object?>? name = data['name'] as Map<Object?, Object?>?;
+
+    return ContactInfo(
+      addresses: addresses == null
+          ? const <Address>[]
+          : List.unmodifiable(
+              addresses.cast<Map<Object?, Object?>>().map(Address.fromNative),
+            ),
+      emails: emails == null
+          ? const <Email>[]
+          : List.unmodifiable(
+              emails.cast<Map<Object?, Object?>>().map(Email.fromNative),
+            ),
+      name: name == null ? null : PersonName.fromNative(name),
+      organization: data['organization'] as String?,
+      phones: phones == null
+          ? const <Phone>[]
+          : List.unmodifiable(
+              phones.cast<Map<Object?, Object?>>().map(Phone.fromNative),
+            ),
+      title: data['title'] as String?,
+      urls: urls == null
+          ? const <String>[]
+          : List.unmodifiable(urls.cast<String>()),
+    );
+  }
+
+  /// The list of addresses for the person or organisation.
+  final List<Address> addresses;
+
+  /// The list of email addresses for the person or organisation.
+  final List<Email> emails;
+
+  /// The name of the contact person.
+  final PersonName? name;
+
+  /// The name of the organization.
+  final String? organization;
+
+  /// The available phone numbers for the contact person or organisation.
+  final List<Phone> phones;
+
+  /// The contact person's title.
+  final String? title;
+
+  /// The urls associated with the contact person or organisation.
+  final List<String> urls;
+}

+/// A driver license or ID card.
+class DriverLicense {
+  /// Create a new [DriverLicense].
+  const DriverLicense({
+    this.addressCity,
+    this.addressState,
+    this.addressStreet,
+    this.addressZip,
+    this.birthDate,
+    this.documentType,
+    this.expiryDate,
+    this.firstName,
+    this.gender,
+    this.issueDate,
+    this.issuingCountry,
+    this.lastName,
+    this.licenseNumber,
+    this.middleName,
+  });
+
+  /// Create a [DriverLicense] from a map.
+  factory DriverLicense.fromNative(Map<Object?, Object?> data) {
+    return DriverLicense(
+      addressCity: data['addressCity'] as String?,
+      addressState: data['addressState'] as String?,
+      addressStreet: data['addressStreet'] as String?,
+      addressZip: data['addressZip'] as String?,
+      birthDate: data['birthDate'] as String?,
+      documentType: data['documentType'] as String?,
+      expiryDate: data['expiryDate'] as String?,
+      firstName: data['firstName'] as String?,
+      gender: data['gender'] as String?,
+      issueDate: data['issueDate'] as String?,
+      issuingCountry: data['issuingCountry'] as String?,
+      lastName: data['lastName'] as String?,
+      licenseNumber: data['licenseNumber'] as String?,
+      middleName: data['middleName'] as String?,
+    );
+  }
+
+  /// The city of the holder's address.
+  final String? addressCity;
+
+  /// The state of the holder's address.
+  final String? addressState;
+
+  /// The street address of the holder's address.
+  final String? addressStreet;
+
+  /// The postal code of the holder's address.
+  final String? addressZip;
+
+  /// The holder's birth date.
+  final String? birthDate;
+
+  /// The type of the license.
+  ///
+  /// This is either "DL" for driver licenses or "ID" for ID cards.
+  final String? documentType;
+
+  /// The expiry date of the license.
+  final String? expiryDate;
+
+  /// The holder's first name.
+  final String? firstName;
+
+  /// The holder's gender.
+  ///
+  /// This is either '1' for male or '2' for female.
+  final String? gender;
+
+  /// The issue date of the license.
+  ///
+  /// The date format depends on the issuing country.
+  /// For example `MMDDYYYY` is used in the US,
+  /// and `YYYYMMDD` is used in Canada.
+  final String? issueDate;
+
+  /// The three-letter country code in which this license was issued.
+  final String? issuingCountry;
+
+  /// The holder's last name.
+  final String? lastName;
+
+  /// The identifying number for this license.
+  final String? licenseNumber;
+
+  /// The holder's middle name.
+  final String? middleName;
+}

+import 'package:mobile_scanner/src/enums/email_type.dart';
+
+/// An email message from a 'MAILTO:' or similar QRCode type.
+class Email {
+  /// Construct a new [Email] instance.
+  const Email({
+    this.address,
+    this.body,
+    this.subject,
+    this.type = EmailType.unknown,
+  });
+
+  /// Construct an [Email] from the given [data].
+  factory Email.fromNative(Map<Object?, Object?> data) {
+    return Email(
+      address: data['address'] as String?,
+      body: data['body'] as String?,
+      subject: data['subject'] as String?,
+      type: EmailType.fromRawValue(data['type'] as int? ?? 0),
+    );
+  }
+
+  /// The email address.
+  final String? address;
+
+  /// The body of the email.
+  final String? body;
+
+  /// The subject of the email.
+  final String? subject;
+
+  /// The type of the email.
+  final EmailType type;
+}

+/// GPS coordinates from a `GEO:` or similar QRCode type.
+class GeoPoint {
+  /// Construct a new [GeoPoint] instance.
+  const GeoPoint({
+    required this.latitude,
+    required this.longitude,
+  });
+
+  /// Construct a [GeoPoint] from the given [data].
+  ///
+  /// If the data does not contain valid GeoPoint coordinates,
+  /// then `0,0` is returned.
+  factory GeoPoint.fromNative(Map<Object?, Object?> data) {
+    final double? latitude = data['latitude'] as double?;
+    final double? longitude = data['longitude'] as double?;
+
+    // If either is not set, then this GeoPoint is invalid.
+    // Return the geographic center as fallback.
+    if (latitude == null || longitude == null) {
+      return const GeoPoint(latitude: 0.0, longitude: 0.0);
+    }
+
+    return GeoPoint(latitude: latitude, longitude: longitude);
+  }
+
+  /// The latitude of the coordinate.
+  final double latitude;
+
+  /// The longitude of the coordinate.
+  final double longitude;
+}

+/// A person's name, divided into individual components.
+class PersonName {
+  /// Create a new [PersonName] instance.
+  const PersonName({
+    this.first,
+    this.middle,
+    this.last,
+    this.prefix,
+    this.suffix,
+    this.formattedName,
+    this.pronunciation,
+  });
+
+  /// Create a [PersonName] from a map.
+  factory PersonName.fromNative(Map<Object?, Object?> data) {
+    return PersonName(
+      first: data['first'] as String?,
+      middle: data['middle'] as String?,
+      last: data['last'] as String?,
+      prefix: data['prefix'] as String?,
+      suffix: data['suffix'] as String?,
+      formattedName: data['formattedName'] as String?,
+      pronunciation: data['pronunciation'] as String?,
+    );
+  }
+
+  /// The person's first name.
+  final String? first;
+
+  /// The person's middle name.
+  final String? middle;
+
+  /// The person's last name.
+  final String? last;
+
+  /// The prefix of the person's name.
+  final String? prefix;
+
+  /// The suffix of the person's name.
+  final String? suffix;
+
+  /// The person's name in a structured format.
+  final String? formattedName;
+
+  /// The pronunciation of the person's name.
+  ///
+  /// This is used for the "kana" name in Japanese phonebooks.
+  final String? pronunciation;
+}

+import 'package:mobile_scanner/src/enums/phone_type.dart';
+
+/// Phone number information from a barcode.
+class Phone {
+  /// Construct a new [Phone] instance.
+  const Phone({
+    this.number,
+    this.type = PhoneType.unknown,
+  });
+
+  /// Create a [Phone] from the given [data].
+  factory Phone.fromNative(Map<Object?, Object?> data) {
+    return Phone(
+      number: data['number'] as String?,
+      type: PhoneType.fromRawValue(data['type'] as int? ?? 0),
+    );
+  }
+
+  /// The phone number value.
+  final String? number;
+
+  /// The type of the phone number.
+  final PhoneType type;
+}

+/// An sms message from a `SMS:` or similar QRCode type.
+class SMS {
+  /// Construct a new [SMS] instance.
+  const SMS({
+    this.message,
+    required this.phoneNumber,
+  });
+
+  /// Construct a new [SMS] instance from the given [data].
+  factory SMS.fromNative(Map<Object?, Object?> data) {
+    return SMS(
+      message: data['message'] as String?,
+      phoneNumber: data['phoneNumber'] as String? ?? '',
+    );
+  }
+
+  /// The message contained in the sms.
+  final String? message;
+
+  /// The phone number which sent the sms.
+  final String phoneNumber;
+}

+/// A URL and title from a `MEBKM:` or similar QRCode type.
+class UrlBookmark {
+  /// Construct a new [UrlBookmark] instance.
+  const UrlBookmark({
+    this.title,
+    required this.url,
+  });
+
+  /// Construct a new [UrlBookmark] instance from the given [data].
+  factory UrlBookmark.fromNative(Map<Object?, Object?> data) {
+    return UrlBookmark(
+      title: data['title'] as String?,
+      url: data['url'] as String? ?? '',
+    );
+  }
+
+  /// The title of the bookmark.
+  final String? title;
+
+  /// The url of the bookmark.
+  final String url;
+}

+import 'package:mobile_scanner/src/enums/barcode_type.dart';
+import 'package:mobile_scanner/src/enums/encryption_type.dart';
+
+/// Wireless network information from [BarcodeType.wifi] barcodes.
+class WiFi {
+  /// Construct a new [WiFi] instance.
+  const WiFi({
+    this.encryptionType = EncryptionType.none,
+    this.ssid,
+    this.password,
+  });
+
+  /// Construct a new [WiFi] instance from the given [data].
+  factory WiFi.fromNative(Map<Object?, Object?> data) {
+    return WiFi(
+      encryptionType: EncryptionType.fromRawValue(
+        data['encryptionType'] as int? ?? 0,
+      ),
+      ssid: data['ssid'] as String?,
+      password: data['password'] as String?,
+    );
+  }
+
+  /// The encryption type of the wireless network.
+  final EncryptionType encryptionType;
+
+  /// The ssid of the wireless network.
+  final String? ssid;
+
+  /// The password of the wireless network.
+  final String? password;
+}