@onekeyfe/react-native-image-crop-picker 3.0.147

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OneKey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @onekeyfe/react-native-image-crop-picker
+
+Single photo picker and cropper for OneKey, built on [Nitro Modules](https://nitro.margelo.com/). It replaces `react-native-image-crop-picker` and keeps the part of its API that OneKey uses: `openPicker`, `openCropper`, `clean`, `cleanSingle`, and the `E_*` error codes.
+
+Neither platform asks for photo library permission:
+
+- **iOS** picks with `PHPickerViewController`, which runs out of process. `react-native-image-crop-picker` requested full photo library access first. Once a user denied it, iOS never showed the prompt again and every later `openPicker` call failed silently (OK-48227). Cropping uses a vendored TOCropViewController 3.2.0 with the OK-51551 rotation fix, which upstream still lacks.
+- **Android** picks with the system Photo Picker (`ActivityResultContracts.PickVisualMedia`, which falls back to `ACTION_OPEN_DOCUMENT` on devices without it) and crops with uCrop `2.2.11-native`. Activity results go through the activity's `ActivityResultRegistry`, so no `ActivityEventListener` is needed.
+
+## Installation
+
+```sh
+yarn add react-native-image-crop-picker@npm:@onekeyfe/react-native-image-crop-picker react-native-nitro-modules
+```
+
+The npm alias keeps existing `react-native-image-crop-picker` imports working.
+
+- **iOS**: do not also install the `TOCropViewController` pod. This package compiles its own copy, and the duplicate classes would clash at link time.
+- **Android**: uCrop is only published to JitPack. Add `maven { url "https://www.jitpack.io" }` to the app's `allprojects.repositories`.
+
+## Usage
+
+```ts
+import ImageCropPicker, {
+  ImageCropPickerError,
+} from 'react-native-image-crop-picker';
+
+try {
+  const image = await ImageCropPicker.openPicker({
+    width: 240,
+    height: 240,
+    cropping: true,
+    includeBase64: true,
+    compressImageQuality: 0.8,
+  });
+  // image.path is a file:// URI; image.data is base64 without a data: prefix.
+} catch (error) {
+  if (error instanceof ImageCropPickerError && error.code === 'E_PICKER_CANCELLED') {
+    return;
+  }
+  throw error;
+}
+
+const cropped = await ImageCropPicker.openCropper({
+  path: 'file:///path/to/image.jpg',
+  width: 480,
+  height: 800,
+});
+```
+
+`openCropper` accepts `file://` URIs, absolute paths, `http(s)://` URLs, `data:` URIs and, on Android, `content://` URIs.
+
+## Behavior
+
+- Results are always JPEG. `width` and `height` set the crop aspect ratio, and the cropped image is scaled to exactly that size, so a crop box a pixel off the ratio still yields the requested dimensions. With `freeStyleCropEnabled`, the crop keeps its own aspect ratio and is scaled to fit inside `width` × `height`.
+- `compressImageMaxWidth`, `compressImageMaxHeight` and `compressImageQuality` apply after cropping. The default quality is 0.8 on iOS and 1 on Android, as in `react-native-image-crop-picker`.
+- Photos are decoded at most 4096 px on the long side, which keeps very large photos from exhausting memory. `cropRect` is reported in the original image's coordinates on iOS.
+- Results are written to `<tmp>/react-native-image-crop-picker/` on iOS and `<cache>/react-native-image-crop-picker/` on Android. `clean()` empties that directory.
+- Only one picker or cropper can be open at a time. A second call rejects with `E_PICKER_IN_PROGRESS`.
+- On iOS, cancelling the cropper that `openPicker` opened returns to the photo picker. On Android it rejects with `E_PICKER_CANCELLED`.
+
+## Not supported
+
+Multiple selection, video, the camera and `includeExif` are not implemented. `mediaType`, `forceJpg` and `sortOrder` are accepted for source compatibility and ignored.
+
+## Error codes
+
+| Code | Meaning |
+| --- | --- |
+| `E_PICKER_CANCELLED` | The user closed the picker or the cropper. |
+| `E_PICKER_IN_PROGRESS` | Another picker or cropper is still open. |
+| `E_ACTIVITY_DOES_NOT_EXIST` | Android: no current activity. |
+| `E_FAILED_TO_SHOW_PICKER` | The picker or cropper could not be presented. |
+| `E_NO_IMAGE_DATA_FOUND` | The selected item could not be read as an image. |
+| `E_CROPPER_IMAGE_NOT_FOUND` | `openCropper` could not load `path`. |
+| `E_CANNOT_SAVE_IMAGE` | The result could not be written. |
+| `E_LOW_MEMORY_ERROR` | Android: out of memory while processing. |
+| `E_ERROR_WHILE_CLEANING_FILES` | `clean` or `cleanSingle` failed. |
+| `E_UNKNOWN` | Any other native error. |
+
+## License
+
+MIT. The vendored TOCropViewController in `ios/TOCropViewController` is MIT licensed by Tim Oliver; see its `LICENSE`.

package/ReactNativeImageCropPicker.podspec

@@ -0,0 +1,40 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "ReactNativeImageCropPicker"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/OneKeyHQ/app-modules/react-native-image-crop-picker.git", :tag => "#{s.version}" }
+
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{h,m,mm}",
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  # Vendored TOCropViewController 3.2.0 with the OK-51551 rotation fix. Its
+  # headers are public so the Swift sources can use it. It replaces the
+  # standalone TOCropViewController pod, which must not be installed alongside.
+  s.public_header_files = ["ios/TOCropViewController/**/*.h"]
+  # TOCropViewController looks up its strings in a bundle with exactly this name.
+  s.resource_bundles = {
+    "TOCropViewControllerBundle" => ["ios/TOCropViewController/Resources/**/*.{lproj,xcprivacy}"],
+  }
+  s.frameworks = "PhotosUI", "UniformTypeIdentifiers"
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+  s.dependency 'ReactNativeNativeLogger'
+
+  load 'nitrogen/generated/ios/ReactNativeImageCropPicker+autolinking.rb'
+  add_nitrogen_files(s)
+
+  install_modules_dependencies(s)
+end

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(reactnativeimagecroppicker)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME reactnativeimagecroppicker)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/reactnativeimagecroppicker+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,144 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['ReactNativeImageCropPicker_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply from: '../nitrogen/generated/android/reactnativeimagecroppicker+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["ReactNativeImageCropPicker_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.reactnativeimagecroppicker"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+            "META-INF",
+            "META-INF/**",
+            "**/libc++_shared.so",
+            "**/libfbjni.so",
+            "**/libjsi.so",
+            "**/libfolly_json.so",
+            "**/libfolly_runtime.so",
+            "**/libglog.so",
+            "**/libhermes.so",
+            "**/libhermes-executor-debug.so",
+            "**/libhermes_executor.so",
+            "**/libreactnative.so",
+            "**/libreactnativejni.so",
+            "**/libturbomodulejsijni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+  // uCrop is only published to JitPack.
+  maven {
+    url "https://www.jitpack.io"
+    content {
+      includeGroup "com.github.yalantis"
+    }
+  }
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation project(":react-native-nitro-modules")
+
+  implementation project(":onekeyfe_react-native-native-logger")
+
+  implementation "androidx.activity:activity:1.10.1"
+  implementation "androidx.appcompat:appcompat:1.7.1"
+  implementation "androidx.exifinterface:exifinterface:1.4.1"
+  // uCrop's JitPack POM omits its runtime dependencies.
+  implementation "androidx.transition:transition:1.6.0"
+  implementation "com.github.yalantis:ucrop:2.2.11-native"
+}

package/android/gradle.properties

@@ -0,0 +1,4 @@
+ReactNativeImageCropPicker_kotlinVersion=1.9.25
+ReactNativeImageCropPicker_compileSdkVersion=35
+ReactNativeImageCropPicker_targetSdkVersion=35
+ReactNativeImageCropPicker_minSdkVersion=24

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,24 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  xmlns:tools="http://schemas.android.com/tools">
+
+  <application>
+    <activity
+      android:name="com.yalantis.ucrop.UCropActivity"
+      android:exported="false"
+      android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
+
+    <!-- Prompts Google Play services to install the backported photo picker module. -->
+    <service
+      android:name="com.google.android.gms.metadata.ModuleDependencies"
+      android:enabled="false"
+      android:exported="false"
+      tools:ignore="MissingClass">
+      <intent-filter>
+        <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
+      </intent-filter>
+      <meta-data
+        android:name="photopicker_activity:0:required"
+        android:value="" />
+    </service>
+  </application>
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "reactnativeimagecroppickerOnLoad.hpp"
+
+extern "C" JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::reactnativeimagecroppicker::initialize(vm);
+}

package/android/src/main/java/com/margelo/nitro/reactnativeimagecroppicker/ImageCropPickerException.kt

@@ -0,0 +1,45 @@
+package com.margelo.nitro.reactnativeimagecroppicker
+
+// The JS wrapper parses "<code>: <message>" back into `error.code` /
+// `error.message`, matching react-native-image-crop-picker.
+internal class ImageCropPickerException(
+  val code: String,
+  message: String,
+  cause: Throwable? = null,
+) : Exception("$code: $message", cause) {
+  companion object {
+    const val E_PICKER_CANCELLED = "E_PICKER_CANCELLED"
+    const val E_PICKER_IN_PROGRESS = "E_PICKER_IN_PROGRESS"
+    const val E_ACTIVITY_DOES_NOT_EXIST = "E_ACTIVITY_DOES_NOT_EXIST"
+    const val E_FAILED_TO_SHOW_PICKER = "E_FAILED_TO_SHOW_PICKER"
+    const val E_NO_IMAGE_DATA_FOUND = "E_NO_IMAGE_DATA_FOUND"
+    const val E_CROPPER_IMAGE_NOT_FOUND = "E_CROPPER_IMAGE_NOT_FOUND"
+    const val E_CANNOT_SAVE_IMAGE = "E_CANNOT_SAVE_IMAGE"
+    const val E_LOW_MEMORY_ERROR = "E_LOW_MEMORY_ERROR"
+    const val E_ERROR_WHILE_CLEANING_FILES = "E_ERROR_WHILE_CLEANING_FILES"
+
+    fun cancelled() = ImageCropPickerException(E_PICKER_CANCELLED, "User cancelled image selection")
+
+    fun inProgress() =
+      ImageCropPickerException(E_PICKER_IN_PROGRESS, "Another image picker or cropper is already open")
+
+    fun noActivity() = ImageCropPickerException(E_ACTIVITY_DOES_NOT_EXIST, "Activity doesn't exist")
+
+    fun failedToShowPicker(cause: Throwable) =
+      ImageCropPickerException(E_FAILED_TO_SHOW_PICKER, cause.message ?: "Cannot show picker", cause)
+
+    fun noImageData(message: String = "Cannot find image data") =
+      ImageCropPickerException(E_NO_IMAGE_DATA_FOUND, message)
+
+    fun cropperImageNotFound() =
+      ImageCropPickerException(E_CROPPER_IMAGE_NOT_FOUND, "Can't find the image at the specified path")
+
+    fun cannotSaveImage(cause: Throwable? = null) =
+      ImageCropPickerException(E_CANNOT_SAVE_IMAGE, "Cannot save image. Unable to write to tmp location.", cause)
+
+    fun lowMemory(cause: Throwable) =
+      ImageCropPickerException(E_LOW_MEMORY_ERROR, cause.message ?: "Out of memory", cause)
+
+    fun cleanupFailed() = ImageCropPickerException(E_ERROR_WHILE_CLEANING_FILES, "Error while cleaning up tmp files")
+  }
+}