@capacitor/camera 8.1.0-test.250320251731 → 8.1.0

package/android/build.gradle

@@ -30,8 +30,8 @@ apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 if (System.getenv("CAP_PLUGIN_PUBLISH") == "true") {
     apply plugin: 'io.github.gradle-nexus.publish-plugin'
-    apply from: file('../../scripts/android/publish-root.gradle')
-    apply from: file('../../scripts/android/publish-module.gradle')
+    apply from: file('../scripts/android/publish-root.gradle')
+    apply from: file('../scripts/android/publish-module.gradle')
 }
 
 android {
@@ -74,6 +74,8 @@ repositories {
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
+    
+    implementation 'io.ionic.libs:ioncamera-android:1.0.0'
 
     if (System.getenv("CAP_PLUGIN_PUBLISH") == "true") {
         implementation "com.capacitorjs:core:$capacitorVersion"
@@ -89,6 +91,4 @@ dependencies {
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
     implementation 'com.google.code.gson:gson:2.10.1'
-    //implementation project(':gradle-project-test')
-    implementation files('libs/IONCameraLib-debug.aar')
 }

package/android/src/main/AndroidManifest.xml

@@ -3,5 +3,11 @@
         <intent>
             <action android:name="android.media.action.IMAGE_CAPTURE" />
         </intent>
+        <intent>
+            <action android:name="android.intent.action.GET_CONTENT" />
+        </intent>
+        <intent>
+            <action android:name="android.intent.action.PICK" />
+        </intent>
     </queries>
 </manifest>

package/android/src/main/java/com/capacitorjs/plugins/camera/CameraPlugin.kt

@@ -90,7 +90,7 @@ class CameraPlugin : Plugin() {
         ionFlow.load()
     }
 
-
+    @Deprecated("Use either takePhoto for CameraSource.Camera or chooseFromGallery for CameraSource.Photos")
     @PluginMethod
     fun getPhoto(call: PluginCall) {
         legacyFlow.getPhoto(call)
@@ -126,6 +126,7 @@ class CameraPlugin : Plugin() {
         ionFlow.editURIPhoto(call)
     }
 
+    @Deprecated("Use chooseFromGallery instead")
     @PluginMethod
     fun pickImages(call: PluginCall) {
         legacyFlow.pickImages(call)
@@ -160,7 +161,7 @@ class CameraPlugin : Plugin() {
      */
     @PermissionCallback
     private fun ionCameraPermissionsCallback(call: PluginCall) {
-        ionFlow.handleCameraPermissionsCallback(call)
+        ionFlow.handlePermissionsCallback(call)
     }
 
     override fun requestPermissionForAliases(

package/android/src/main/java/com/capacitorjs/plugins/camera/IonCameraFlow.kt

@@ -33,6 +33,7 @@ import io.ionic.libs.ioncameralib.manager.IONCAMRGalleryManager
 import io.ionic.libs.ioncameralib.manager.IONCAMRVideoManager
 import io.ionic.libs.ioncameralib.model.IONCAMRCameraParameters
 import io.ionic.libs.ioncameralib.model.IONCAMREditParameters
+import io.ionic.libs.ioncameralib.model.IONCAMRVideoParameters
 import io.ionic.libs.ioncameralib.model.IONCAMRError
 import io.ionic.libs.ioncameralib.model.IONCAMRMediaResult
 import io.ionic.libs.ioncameralib.model.IONCAMRMediaType
@@ -62,11 +63,11 @@ class IonCameraFlow(
     private lateinit var editLauncher: ActivityResultLauncher<Intent>
     private var currentCall: PluginCall? = null
     private var cameraSettings: IonCameraSettings? = null
-    private var videoSettings: IonVideoSettings? = null
     private var gallerySettings: IonGallerySettings? = null
     private var editParameters = IONCAMREditParameters(
         editURI = "", fromUri = false, saveToGallery = false, includeMetadata = false
     )
+    private var videoParameters: IONCAMRVideoParameters? = null
     private var lastEditUri: String? = null
 
     companion object {
@@ -118,7 +119,7 @@ class IonCameraFlow(
     }
 
     fun recordVideo(call: PluginCall) {
-        videoSettings = getVideoSettings(call)
+        videoParameters = getVideoSettings(call)
         currentCall = call
         openRecordVideo(call)
     }
@@ -186,8 +187,8 @@ class IonCameraFlow(
 
     }
 
-    fun getVideoSettings(call: PluginCall): IonVideoSettings {
-        return IonVideoSettings(
+    fun getVideoSettings(call: PluginCall): IONCAMRVideoParameters {
+        return IONCAMRVideoParameters(
             saveToGallery = call.getBoolean("saveToGallery") ?: false,
             includeMetadata = call.getBoolean("includeMetadata") ?: false,
             isPersistent = call.getBoolean("isPersistent") ?: true
@@ -200,8 +201,7 @@ class IonCameraFlow(
             allowMultipleSelection = call.getBoolean("allowMultipleSelection") ?: false,
             limit = call.getInt("limit") ?: 0,
             includeMetadata = call.getBoolean("includeMetadata") ?: false,
-            allowEdit = call.getBoolean("allowEdit") ?: false,
-            editInApp = call.getBoolean("editInApp") ?: true,
+            editable = IonEditableMode.fromString(call.getString("editable")),
             quality = call.getInt("quality") ?: DEFAULT_QUALITY,
             width = call.getInt("targetWidth") ?: 0,
             height = call.getInt("targetHeight") ?: 0,
@@ -214,8 +214,7 @@ class IonCameraFlow(
         var allowMultipleSelection: Boolean = false,
         var limit: Int = 0,
         var includeMetadata: Boolean = false,
-        var allowEdit: Boolean = false,
-        var editInApp: Boolean = true,
+        var editable: IonEditableMode = IonEditableMode.NO,
         var quality: Int = 90,
         var width: Int = 0,
         var height: Int = 0,
@@ -234,8 +233,7 @@ class IonCameraFlow(
         settings.correctOrientation = call.getBoolean("correctOrientation") ?: IonCameraSettings.DEFAULT_CORRECT_ORIENTATION
         settings.encodingType = call.getInt("encodingType") ?: IonCameraSettings.DEFAULT_ENCODING_TYPE
         settings.saveToGallery = call.getBoolean("saveToGallery") ?: IonCameraSettings.DEFAULT_SAVE_IMAGE_TO_GALLERY
-        settings.allowEdit = call.getBoolean("allowEdit") ?: false
-        settings.editInApp = call.getBoolean("editInApp") ?: true
+        settings.editable = IonEditableMode.fromString(call.getString("editable"))
         settings.includeMetadata = call.getBoolean("includeMetadata") ?: false
         settings.shouldResize = settings.targetWidth > 0 || settings.targetHeight > 0
         return settings
@@ -267,13 +265,13 @@ class IonCameraFlow(
                 currentCall = call
                 manager.takePhoto(activity, settings.encodingType, cameraLauncher)
             } catch (ex: Exception) {
-                sendError(IONCAMRError.FAILED_TO_CAPTURE_IMAGE_ERROR)
+                sendError(IONCAMRError.TAKE_PHOTO_ERROR)
             }
         }
     }
 
     fun openRecordVideo(call: PluginCall) {
-        val settings = videoSettings ?: run {
+        val settings = videoParameters ?: run {
             sendError(IONCAMRError.INVALID_ARGUMENT_ERROR)
             return
         }
@@ -293,7 +291,7 @@ class IonCameraFlow(
                     sendError(it)
                 }
             } catch (ex: Exception) {
-                sendError(IONCAMRError.VIDEO_CAPTURE_NOT_SUPPORTED_ERROR)
+                sendError(IONCAMRError.CAPTURE_VIDEO_ERROR)
             }
         }
     }
@@ -319,6 +317,8 @@ class IonCameraFlow(
     }
 
     private fun openGallery(call: PluginCall) {
+        if (!checkGalleryPermissions(call)) return
+
         val manager = galleryManager ?: run {
             sendError(IONCAMRError.CONTEXT_ERROR)
             return
@@ -350,8 +350,12 @@ class IonCameraFlow(
             saveToGallery = false,
             includeMetadata = false
         )
+
         val imageBase64 = call.getString("inputImage")
-        if (imageBase64 == null) return
+        if (imageBase64.isNullOrEmpty()) {
+            sendError(IONCAMRError.INVALID_ARGUMENT_ERROR)
+            return
+        }
         manager.editImage(activity, imageBase64, editLauncher)
     }
 
@@ -385,10 +389,11 @@ class IonCameraFlow(
                     sendError(IONCAMRError.INVALID_ARGUMENT_ERROR)
                     return
                 }
-                if (settings.allowEdit) {
-                    if (settings.editInApp) {
+                when (settings.editable) {
+                    IonEditableMode.IN_APP -> {
                         editPhoto()
-                    } else {
+                    }
+                    IonEditableMode.EXTERNAL -> {
                         val editor = editManager ?: run {
                             sendError(IONCAMRError.CONTEXT_ERROR)
                             return
@@ -415,8 +420,9 @@ class IonCameraFlow(
                             editPhoto()
                         }
                     }
-                } else {
-                    processResult(result.data)
+                    IonEditableMode.NO -> {
+                        processResult(result.data)
+                    }
                 }
             }
             Activity.RESULT_CANCELED -> {
@@ -465,36 +471,40 @@ class IonCameraFlow(
                     return
                 }
 
-                if (settings.allowEdit && uris.size == 1 && settings.mediaType == IONCAMRMediaType.PICTURE) {
+                if (settings.editable != IonEditableMode.NO && uris.size == 1 && settings.mediaType == IONCAMRMediaType.PICTURE) {
                     val originalUri = uris.first()
-                    if (settings.editInApp) {
-                        editor.openCropActivity(
-                            activity,
-                            originalUri,
-                            galleryCropLauncher
-                        )
-                    } else {
-                        val tempUri = if (originalUri.scheme == "content") {
-                            IonCameraUtils.getGalleryTempImage(activity, originalUri)
-                        } else {
-                            originalUri
-                        }
-
-                        if (tempUri == null) {
-                            sendError(IONCAMRError.EDIT_IMAGE_ERROR)
-                            return
-                        }
-
-                        val editIntent = createEditIntent(tempUri)
-                        if (editIntent != null) {
-                            galleryCropLauncher.launch(editIntent)
-                        } else {
+                    when (settings.editable) {
+                        IonEditableMode.IN_APP -> {
                             editor.openCropActivity(
                                 activity,
                                 originalUri,
                                 galleryCropLauncher
                             )
                         }
+                        IonEditableMode.EXTERNAL -> {
+                            val tempUri = if (originalUri.scheme == "content") {
+                                IonCameraUtils.getGalleryTempImage(activity, originalUri)
+                            } else {
+                                originalUri
+                            }
+
+                            if (tempUri == null) {
+                                sendError(IONCAMRError.EDIT_IMAGE_ERROR)
+                                return
+                            }
+
+                            val editIntent = createEditIntent(tempUri)
+                            if (editIntent != null) {
+                                galleryCropLauncher.launch(editIntent)
+                            } else {
+                                editor.openCropActivity(
+                                    activity,
+                                    originalUri,
+                                    galleryCropLauncher
+                                )
+                            }
+                        }
+                        else -> {}
                     }
                 } else {
                     processResultFromGallery(result)
@@ -531,14 +541,14 @@ class IonCameraFlow(
                 lastEditUri = null
             }
             Activity.RESULT_CANCELED -> {
-                if (!settings.editInApp && !lastEditUri.isNullOrEmpty()) {
+                if (settings.editable == IonEditableMode.EXTERNAL && !lastEditUri.isNullOrEmpty()) {
                     val intent = Intent().apply {
                         putExtra(IONCAMRImageEditorActivity.IMAGE_OUTPUT_URI_EXTRAS, lastEditUri)
                     }
                     processResultEditFromGallery(intent)
                 } else {
                     lastEditUri = null
-                    sendError(IONCAMRError.EDIT_OPERATION_CANCELLED_ERROR)
+                    sendError(IONCAMRError.EDIT_CANCELLED_ERROR)
                 }
             }
             else -> sendError(IONCAMRError.EDIT_IMAGE_ERROR)
@@ -571,7 +581,7 @@ class IonCameraFlow(
     private fun handleEditResult(result: ActivityResult) {
         when (result.resultCode) {
             Activity.RESULT_OK -> processResultFromEdit(result)
-            Activity.RESULT_CANCELED -> sendError(IONCAMRError.EDIT_OPERATION_CANCELLED_ERROR)
+            Activity.RESULT_CANCELED -> sendError(IONCAMRError.EDIT_CANCELLED_ERROR)
             else -> sendError(IONCAMRError.EDIT_IMAGE_ERROR)
         }
     }
@@ -689,14 +699,14 @@ class IonCameraFlow(
                 lastEditUri = null
             }
             Activity.RESULT_CANCELED -> {
-                if (!settings.editInApp && !lastEditUri.isNullOrEmpty()) {
+                if (settings.editable == IonEditableMode.EXTERNAL && !lastEditUri.isNullOrEmpty()) {
                     val intent = Intent().apply {
                         putExtra(IONCAMRImageEditorActivity.IMAGE_OUTPUT_URI_EXTRAS, lastEditUri)
                     }
                     processResult(intent)
                 } else {
                     lastEditUri = null
-                    sendError(IONCAMRError.EDIT_OPERATION_CANCELLED_ERROR)
+                    sendError(IONCAMRError.EDIT_CANCELLED_ERROR)
                 }
             }
             else -> sendError(IONCAMRError.EDIT_IMAGE_ERROR)
@@ -727,18 +737,17 @@ class IonCameraFlow(
         ret.put("webPath", FileUtils.getPortablePath(context, bridge.localUrl, uri))
         ret.put("saved", mediaResult.saved)
 
-        val metadata = JSObject()
         mediaResult.metadata?.let {
+            val metadata = JSObject()
             metadata.put("duration", it.duration)
             metadata.put("size", it.size)
             metadata.put("format", it.format)
             metadata.put("resolution", it.resolution)
             metadata.put("creationDate", it.creationDate)
             metadata.put("exif", exif.toJson())
+            ret.put("metadata", metadata)
         }
 
-        ret.put("metadata", metadata)
-
         currentCall?.resolve(ret)
         currentCall = null
         lastEditUri = null
@@ -755,17 +764,16 @@ class IonCameraFlow(
         ret.put("webPath", FileUtils.getPortablePath(context, bridge.localUrl, uri))
         ret.put("saved", mediaResult.saved)
 
-        val metadata = JSObject()
         mediaResult.metadata?.let {
+            val metadata = JSObject()
             metadata.put("duration", it.duration)
             metadata.put("size", it.size)
             metadata.put("format", it.format)
             metadata.put("resolution", it.resolution)
             metadata.put("creationDate", it.creationDate)
+            ret.put("metadata", metadata)
         }
 
-        ret.put("metadata", metadata)
-
         currentCall?.resolve(ret)
         currentCall = null
     }
@@ -786,27 +794,27 @@ class IonCameraFlow(
                 FileUtils.getPortablePath(context, bridge.localUrl, uri)
             )
 
-            val metadata = JSObject()
             mediaResult.metadata?.let {
+                val metadata = JSObject()
                 metadata.put("duration", it.duration)
                 metadata.put("size", it.size)
                 metadata.put("format", it.format)
                 metadata.put("resolution", it.resolution)
                 metadata.put("creationDate", it.creationDate)
-            }
 
-            if (mediaResult.type == IONCAMRMediaType.PICTURE.type) {
-                val bitmap = BitmapFactory.decodeFile(mediaResult.uri)
-                if (bitmap == null) {
-                    sendError(IONCAMRError.PROCESS_IMAGE_ERROR)
-                    return
+                if (mediaResult.type == IONCAMRMediaType.PICTURE.type) {
+                    val bitmap = BitmapFactory.decodeFile(mediaResult.uri)
+                    if (bitmap == null) {
+                        sendError(IONCAMRError.PROCESS_IMAGE_ERROR)
+                        return
+                    }
+
+                    val exif = ImageUtils.getExifData(context, bitmap, uri)
+                    metadata.put("exif", exif.toJson())
                 }
 
-                val exif = ImageUtils.getExifData(context, bitmap, uri)
-                metadata.put("exif", exif.toJson())
+                ret.put("metadata", metadata)
             }
-
-            ret.put("metadata", metadata)
             photos.put(ret)
         }
 
@@ -857,7 +865,7 @@ class IonCameraFlow(
             sendError(IONCAMRError.CAPTURE_VIDEO_ERROR)
             return
         }
-        val settings = videoSettings ?: run {
+        val settings = videoParameters ?: run {
             sendError(IONCAMRError.INVALID_ARGUMENT_ERROR)
             return
         }
@@ -931,10 +939,10 @@ class IonCameraFlow(
             targetHeight = targetHeight,
             encodingType = encodingType,
             mediaType = MEDIA_TYPE_PHOTO,
-            allowEdit = allowEdit,
+            allowEdit = editable != IonEditableMode.NO,
             correctOrientation = correctOrientation,
             saveToPhotoAlbum = saveToGallery,
-            includeMetadata = includeMetadata
+            includeMetadata = includeMetadata,
         )
     }
 
@@ -982,13 +990,46 @@ class IonCameraFlow(
         return true
     }
 
-    fun handleCameraPermissionsCallback(call: PluginCall) {
-        if (permissionHelper.getPermissionState(CAMERA) != PermissionState.GRANTED) {
+    private fun checkGalleryPermissions(call: PluginCall): Boolean {
+        // Android 10+ does not require storage permissions to use the system gallery picker
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            return true
+        }
+        val needGalleryPerms = permissionHelper.isPermissionDeclared(SAVE_GALLERY)
+        val hasGalleryPerms = !needGalleryPerms || permissionHelper.getPermissionState(SAVE_GALLERY) == PermissionState.GRANTED
+        if (!hasGalleryPerms) {
+            permissionHelper.requestPermissionForAlias(SAVE_GALLERY, call, "ionCameraPermissionsCallback")
+            return false
+        }
+        return true
+    }
+
+    fun handlePermissionsCallback(call: PluginCall) {
+        // chooseFromGallery does not require CAMERA permission
+        if (call.methodName != "chooseFromGallery" &&
+            permissionHelper.getPermissionState(CAMERA) != PermissionState.GRANTED) {
             sendError(IONCAMRError.CAMERA_PERMISSION_DENIED_ERROR)
             return
         }
 
-        when (call.getMethodName()) {
+        // On Android <= 9, SAVE_GALLERY (READ/WRITE_EXTERNAL_STORAGE) is required:
+        // - for takePhoto/recordVideo when saveToGallery is true
+        // - always for chooseFromGallery (READ_EXTERNAL_STORAGE is needed to access the gallery)
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+            val needsGalleryPerm = when (call.methodName) {
+                "takePhoto" -> cameraSettings?.saveToGallery ?: false
+                "recordVideo" -> videoParameters?.saveToGallery ?: false
+                "chooseFromGallery" -> true
+                else -> false
+            }
+            val galleryPermDeclared = permissionHelper.isPermissionDeclared(SAVE_GALLERY)
+            if (needsGalleryPerm && galleryPermDeclared && permissionHelper.getPermissionState(SAVE_GALLERY) != PermissionState.GRANTED) {
+                sendError(IONCAMRError.GALLERY_PERMISSION_DENIED_ERROR)
+                return
+            }
+        }
+
+        when (call.methodName) {
             "takePhoto" -> openCamera(call)
             "recordVideo" -> openRecordVideo(call)
             "chooseFromGallery" -> openGallery(call)

package/android/src/main/java/com/capacitorjs/plugins/camera/IonCameraSettings.kt

@@ -7,8 +7,7 @@ class IonCameraSettings {
     var correctOrientation: Boolean = DEFAULT_CORRECT_ORIENTATION
     var encodingType: Int = 0 //JPEG
     var saveToGallery: Boolean = DEFAULT_SAVE_IMAGE_TO_GALLERY
-    var allowEdit: Boolean = false
-    var editInApp: Boolean = true
+    var editable: IonEditableMode = IonEditableMode.NO
     var includeMetadata: Boolean = false
     var shouldResize: Boolean = false
 

package/android/src/main/java/com/capacitorjs/plugins/camera/IonEditableMode.kt

@@ -0,0 +1,16 @@
+package com.capacitorjs.plugins.camera
+
+enum class IonEditableMode(val value: String) {
+    NO("no"),
+    IN_APP("in-app"),
+    EXTERNAL("external");
+
+    companion object {
+        fun fromString(value: String?): IonEditableMode {
+            if (value == null) return NO
+            return values().find {
+                it.value.equals(value, ignoreCase = true)
+            } ?: NO
+        }
+    }
+}

package/android/src/main/java/com/capacitorjs/plugins/camera/IonGallerySettings.kt

@@ -7,8 +7,7 @@ class IonGallerySettings {
     var allowMultipleSelection: Boolean = false
     var limit: Int = 0
     var includeMetadata: Boolean = false
-    var allowEdit: Boolean = false
-    var editInApp: Boolean = true
+    var editable: IonEditableMode = IonEditableMode.NO
     var quality: Int = DEFAULT_QUALITY
     var width: Int = 0
     var height: Int = 0

package/dist/docs.json

@@ -324,7 +324,7 @@
               "name": "since"
             }
           ],
-          "docs": "Returns the thumbnail of the media, base64 encoded.\nOn Web, for `MediaType.Photo`, the full image is returned here, also base64 encoded.",
+          "docs": "Returns the thumbnail of the media, base64 encoded.\nOn Web, for `MediaType.Photo`, the full image is returned here, also base64 encoded.\nOn Web, for `MediaType.Video`, a full-resolution JPEG frame captured from the video is returned, base64 encoded at 80% quality.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -383,7 +383,7 @@
               "name": "since"
             }
           ],
-          "docs": "File size of the media, in bytes\nNot available on Web.",
+          "docs": "File size of the media, in bytes.",
           "complexTypes": [],
           "type": "number | undefined"
         },
@@ -395,7 +395,7 @@
               "name": "since"
             }
           ],
-          "docs": "Only applicable for `MediaType.Video` - the duration of the media, in seconds.\nNot available on Web.",
+          "docs": "Only applicable for `MediaType.Video` - the duration of the media, in seconds.",
           "complexTypes": [],
           "type": "number | undefined"
         },
@@ -407,7 +407,7 @@
               "name": "since"
             }
           ],
-          "docs": "The format of the image, ex: jpeg, png, mp4.\n\nWeb supports jpeg, png and gif, but the exact availability may vary depending on the browser.\ngif is only supported for `chooseFromGallery`, and only if `webUseInput` option is set to `true`.",
+          "docs": "The format of the image, ex: jpeg, png, mp4.\n\nAndroid and iOS may return 'jpg' instead of 'jpeg'. The format is the same, just with a different name.\nPlease compare against both 'jpeg' and 'jpg' when checking if the format of the returned media is JPEG.\nWeb supports jpeg, png and gif, but the exact availability may vary depending on the browser.\ngif is only supported for `chooseFromGallery` on Web.",
           "complexTypes": [],
           "type": "string"
         },
@@ -421,7 +421,7 @@
           ],
           "docs": "The resolution of the media, in `<width>x<height>` format. Example: '1920x1080'.",
           "complexTypes": [],
-          "type": "string"
+          "type": "string | undefined"
         },
         {
           "name": "creationDate",
@@ -431,7 +431,7 @@
               "name": "since"
             }
           ],
-          "docs": "The date and time the media was created, in ISO 8601 format.\nIf creation date is not available (e.g. Android 7 and below), the last modified date is returned.\nNot available on web.",
+          "docs": "The date and time the media was created, in ISO 8601 format.\nIf creation date is not available (e.g. Android 7 and below), the last modified date is returned.\nFor Web, the last modified date is always returned.",
           "complexTypes": [],
           "type": "string | undefined"
         },
@@ -443,7 +443,7 @@
               "name": "since"
             }
           ],
-          "docs": "Exif data, if any, retreived from the media item.\nNot available on Web.",
+          "docs": "Exif data, if any, retreived from the media item.\nOnly available for `MediaType.Photo`.\nNot available on Web.",
           "complexTypes": [],
           "type": "string | undefined"
         }
@@ -565,10 +565,10 @@
           "type": "CameraDirection"
         },
         {
-          "name": "allowEdit",
+          "name": "editable",
           "tags": [
             {
-              "text": "false",
+              "text": "'no'",
               "name": "default"
             },
             {
@@ -576,25 +576,9 @@
               "name": "since"
             }
           ],
-          "docs": "Whether to allow the user to crop or make small edits.\nNote: This option is only supported on Android and iOS.",
+          "docs": "Determines if and how the user can edit the photo.\n- 'in-app': Use an in-app editor for photo edition.\n- 'external': Open a separate (platform-specific) native app to handle photo edition, falling back to the in-app editor if none is available. Note: iOS does not support external editing and will use 'in-app' instead.\n- 'no': No editing allowed.\nNot available on Web.",
           "complexTypes": [],
-          "type": "boolean | undefined"
-        },
-        {
-          "name": "editInApp",
-          "tags": [
-            {
-              "text": "true",
-              "name": "default"
-            },
-            {
-              "text": "8.1.0",
-              "name": "since"
-            }
-          ],
-          "docs": "If `true`, will use an in-app editor for photo edition.\nIf `false`, will open a separate (platform-specific) native app to handle photo edition, falling back to the in-app editor if none is available.\nOnly applicable with `allowEdit` set to true.\nNote: This option is only supported on Android and iOS.",
-          "complexTypes": [],
-          "type": "boolean | undefined"
+          "type": "'in-app' | 'external' | 'no' | undefined"
         },
         {
           "name": "presentationStyle",
@@ -636,7 +620,7 @@
               "name": "since"
             }
           ],
-          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.\nNote: This option is only supported on Android and iOS.",
+          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.",
           "complexTypes": [],
           "type": "boolean | undefined"
         }
@@ -812,31 +796,15 @@
               "name": "since"
             }
           ],
-          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.\nNote: This option is only supported on Android and iOS.",
-          "complexTypes": [],
-          "type": "boolean | undefined"
-        },
-        {
-          "name": "allowEdit",
-          "tags": [
-            {
-              "text": "false",
-              "name": "default"
-            },
-            {
-              "text": "8.1.0",
-              "name": "since"
-            }
-          ],
-          "docs": "Whether to allow the user to crop or make small edits.\nOnly applicable for `MediaTypeSelection.Photo` and `allowMultipleSelection` set to `false`.\nNote: This option is only supported on Android and iOS.",
+          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
         {
-          "name": "editInApp",
+          "name": "editable",
           "tags": [
             {
-              "text": "true",
+              "text": "'no'",
               "name": "default"
             },
             {
@@ -844,9 +812,9 @@
               "name": "since"
             }
           ],
-          "docs": "If `true`, will use an in-app editor for photo edition.\nIf `false`, will open a separate (platform-specific) native app to handle photo edition, falling back to the in-app editor if none is available.\nOnly applicable with `allowEdit` set to true.\nNote: This option is only supported on Android and iOS.",
+          "docs": "Determines if and how the user can edit the photo.\n- 'in-app': Use an in-app editor for photo edition.\n- 'external': Open a separate (platform-specific) native app to handle photo edition, falling back to the in-app editor if none is available. Note: iOS does not support external editing and will use 'in-app' instead.\n- 'no': No editing allowed.\nOnly applicable for `MediaTypeSelection.Photo` and `allowMultipleSelection` set to `false`.\nNot available on Web.",
           "complexTypes": [],
-          "type": "boolean | undefined"
+          "type": "'in-app' | 'external' | 'no' | undefined"
         },
         {
           "name": "presentationStyle",
@@ -1023,7 +991,7 @@
               "name": "since"
             }
           ],
-          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.\nNote: This option is only supported on Android and iOS.",
+          "docs": "Whether or not MediaResult should include its metadata.\nIf an error occurs when obtaining the metadata, it will return empty.",
           "complexTypes": [],
           "type": "boolean | undefined"
         }