react-native-picture-selector 1.0.0

package/android/build.gradle

@@ -0,0 +1,79 @@
+buildscript {
+  ext.kotlin_version = '1.9.22'
+  repositories {
+    google()
+    mavenCentral()
+  }
+  dependencies {
+    classpath 'com.android.tools.build:gradle:8.1.4'
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+  namespace 'com.margelo.pictureselector'
+  compileSdk 34
+
+  defaultConfig {
+    minSdk 24
+    targetSdk 34
+    ndk {
+      abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
+    }
+    consumerProguardFiles 'proguard-rules.pro'
+  }
+
+  buildFeatures {
+    prefab true
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = '17'
+  }
+
+  sourceSets {
+    main {
+      // Include nitrogen-generated Kotlin sources
+      java.srcDirs += [
+        'src/main/kotlin',
+        '../nitrogen/generated/android/kotlin'
+      ]
+    }
+  }
+}
+
+repositories {
+  google()
+  mavenCentral()
+  maven { url 'https://jitpack.io' }
+}
+
+dependencies {
+  implementation 'com.facebook.react:react-native'
+
+  // Coroutines
+  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
+  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3'
+
+  // ─── PictureSelector v3.11.2 ─────────────────────────────────────────────
+  implementation 'io.github.lucksiege:pictureselector:v3.11.2'
+  implementation 'io.github.lucksiege:compress:v3.11.2'
+  implementation 'io.github.lucksiege:ucrop:v3.11.2'
+  implementation 'io.github.lucksiege:camerax:v3.11.2'
+
+  // ─── Image loading engine (required by PictureSelector) ──────────────────
+  implementation 'com.github.bumptech.glide:glide:4.16.0'
+  annotationProcessor 'com.github.bumptech.glide:compiler:4.16.0'
+
+  // ─── Nitro bridge (resolved at app level via peer dependency) ────────────
+  // react-native-nitro-modules is a peerDependency; the C++ prefab is
+  // provided by the consuming app's node_modules.
+}

package/android/proguard-rules.pro

@@ -0,0 +1,21 @@
+# PictureSelector
+-keep class com.luck.picture.lib.** { *; }
+-keep class com.luck.lib.camerax.** { *; }
+
+# uCrop
+-dontwarn com.yalantis.ucrop**
+-keep class com.yalantis.ucrop** { *; }
+-keep interface com.yalantis.ucrop** { *; }
+
+# Glide
+-keep public class * implements com.bumptech.glide.module.GlideModule
+-keep class * extends com.bumptech.glide.module.AppGlideModule {
+  <init>(...);
+}
+-keep public enum com.bumptech.glide.load.ImageHeaderParser$** {
+  **[] $VALUES;
+  public *;
+}
+
+# Nitro bridge
+-keep class com.margelo.pictureselector.** { *; }

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+  <!-- ─── Permissions ───────────────────────────────────────────────────── -->
+
+  <uses-permission android:name="android.permission.CAMERA" />
+
+  <!-- Android ≤ 12 (API 32) -->
+  <uses-permission
+    android:name="android.permission.READ_EXTERNAL_STORAGE"
+    android:maxSdkVersion="32" />
+
+  <!-- Android 13+ (API 33+) granular media permissions -->
+  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
+
+  <!-- Required to write camera captures on Android ≤ 9 (API 28) -->
+  <uses-permission
+    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
+    android:maxSdkVersion="28" />
+
+  <application>
+    <!--
+      FileProvider is required by PictureSelector for sharing URIs on
+      Android 7+ (API 24+). The authority must match the one used in
+      PictureSelectorOptionsMapper (${applicationId}.fileprovider).
+    -->
+    <provider
+      android:name="androidx.core.content.FileProvider"
+      android:authorities="${applicationId}.fileprovider"
+      android:exported="false"
+      android:grantUriPermissions="true">
+      <meta-data
+        android:name="android.support.FILE_PROVIDER_PATHS"
+        android:resource="@xml/file_paths" />
+    </provider>
+  </application>
+
+</manifest>

package/android/src/main/kotlin/com/margelo/pictureselector/GlideEngine.kt

@@ -0,0 +1,80 @@
+package com.margelo.pictureselector
+
+import android.content.Context
+import android.widget.ImageView
+import com.bumptech.glide.Glide
+import com.bumptech.glide.load.engine.DiskCacheStrategy
+import com.luck.picture.lib.engine.ImageEngine
+import com.luck.picture.lib.utils.ActivityCompatHelper
+
+/**
+ * Glide-based ImageEngine required by PictureSelector for displaying
+ * thumbnails in the gallery grid and album cover.
+ */
+class GlideEngine private constructor() : ImageEngine {
+
+  override fun loadImage(context: Context, url: String, imageView: ImageView) {
+    if (!ActivityCompatHelper.assertValidRequest(context)) return
+    Glide.with(context)
+      .load(url)
+      .override(180, 180)
+      .centerCrop()
+      .into(imageView)
+  }
+
+  override fun loadImage(
+    context: Context,
+    imageView: ImageView,
+    url: String,
+    maxWidth: Int,
+    maxHeight: Int,
+  ) {
+    if (!ActivityCompatHelper.assertValidRequest(context)) return
+    Glide.with(context)
+      .load(url)
+      .override(maxWidth, maxHeight)
+      .centerCrop()
+      .into(imageView)
+  }
+
+  override fun loadAlbumCoverImage(context: Context, url: String, imageView: ImageView) {
+    if (!ActivityCompatHelper.assertValidRequest(context)) return
+    Glide.with(context)
+      .asBitmap()
+      .load(url)
+      .override(180, 180)
+      .centerCrop()
+      .sizeMultiplier(0.5f)
+      .diskCacheStrategy(DiskCacheStrategy.ALL)
+      .into(imageView)
+  }
+
+  override fun loadGridImage(context: Context, url: String, imageView: ImageView) {
+    if (!ActivityCompatHelper.assertValidRequest(context)) return
+    Glide.with(context)
+      .load(url)
+      .override(200, 200)
+      .centerCrop()
+      .diskCacheStrategy(DiskCacheStrategy.ALL)
+      .into(imageView)
+  }
+
+  override fun pauseRequests(context: Context) {
+    Glide.with(context).pauseRequests()
+  }
+
+  override fun resumeRequests(context: Context) {
+    Glide.with(context).resumeRequests()
+  }
+
+  companion object {
+    @Volatile
+    private var instance: GlideEngine? = null
+
+    @JvmStatic
+    fun createGlideEngine(): GlideEngine =
+      instance ?: synchronized(this) {
+        instance ?: GlideEngine().also { instance = it }
+      }
+  }
+}

package/android/src/main/kotlin/com/margelo/pictureselector/HybridPictureSelector.kt

@@ -0,0 +1,138 @@
+package com.margelo.pictureselector
+
+import android.app.Activity
+import com.facebook.react.bridge.ReactApplicationContext
+import com.luck.picture.lib.PictureSelector
+import com.luck.picture.lib.config.SelectMimeType
+import com.luck.picture.lib.entity.LocalMedia
+import com.luck.picture.lib.interfaces.OnResultCallbackListener
+import com.margelo.nitro.core.Promise
+import com.margelo.nitro.com.margelo.pictureselector.HybridHybridPictureSelectorSpec
+import com.margelo.nitro.com.margelo.pictureselector.MediaAsset
+import com.margelo.nitro.com.margelo.pictureselector.MediaType
+import com.margelo.nitro.com.margelo.pictureselector.PictureSelectorOptions
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import kotlin.coroutines.resume
+import kotlin.coroutines.resumeWithException
+import kotlin.coroutines.suspendCoroutine
+
+// ─── Nitrogen-generated types ─────────────────────────────────────────────────
+// Generated by nitrogen into:
+//   nitrogen/generated/android/kotlin/com/margelo/nitro/com/margelo/pictureselector/
+//     HybridHybridPictureSelectorSpec.kt  — abstract base class (extends HybridObject)
+//     MediaAsset.kt                       — data class
+//     PictureSelectorOptions.kt           — data class
+//     CropOptions.kt                      — data class
+//     CompressOptions.kt                  — data class
+//     MediaType.kt                        — enum class
+//     PickerTheme.kt                      — enum class
+//
+// Run `npm run generate` before building.
+
+/**
+ * Nitro HybridObject implementation for the Android side.
+ *
+ * Extends the nitrogen-generated [HybridHybridPictureSelectorSpec] which provides
+ * the JSI bridge. The [reactContext] is injected by [NitroPictureSelectorPackage].
+ *
+ * Threading contract:
+ * - [openPicker] and [openCamera] are called on the JS thread.
+ * - PictureSelector.create(...).openGallery() must be called on the Main thread.
+ * - We switch to Main via [withContext(Dispatchers.Main)] inside Promise.async.
+ *
+ * API REQUIRES VERIFICATION:
+ * - Confirm Promise.async accepts a CoroutineContext parameter in the version
+ *   of react-native-nitro-modules used.
+ */
+class HybridPictureSelector(
+  private val reactContext: ReactApplicationContext,
+) : HybridHybridPictureSelectorSpec() {
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // Public API
+  // ─────────────────────────────────────────────────────────────────────────
+
+  override fun openPicker(options: PictureSelectorOptions): Promise<Array<MediaAsset>> {
+    return Promise.async {
+      withContext(Dispatchers.Main) {
+        val activity = requireActivity()
+        val mimeType = PictureSelectorOptionsMapper.toSelectMimeType(options.mediaType)
+
+        suspendCoroutine { cont ->
+          PictureSelector.create(activity)
+            .openGallery(mimeType)
+            .setImageEngine(GlideEngine.createGlideEngine())
+            .also { builder ->
+              PictureSelectorOptionsMapper.applyGallery(builder, options)
+            }
+            .forResult(object : OnResultCallbackListener<LocalMedia>() {
+              override fun onResult(result: ArrayList<LocalMedia>) {
+                cont.resume(MediaAssetMapper.map(result))
+              }
+
+              override fun onCancel() {
+                cont.resumeWithException(
+                  PictureSelectorException("CANCELLED", "User cancelled the picker")
+                )
+              }
+            })
+        }
+      }
+    }
+  }
+
+  override fun openCamera(options: PictureSelectorOptions): Promise<Array<MediaAsset>> {
+    return Promise.async {
+      withContext(Dispatchers.Main) {
+        val activity = requireActivity()
+        // Camera always captures a single item; force image if mediaType == ALL
+        val mimeType = when (options.mediaType) {
+          MediaType.VIDEO -> SelectMimeType.ofVideo()
+          else            -> SelectMimeType.ofImage()
+        }
+
+        suspendCoroutine { cont ->
+          PictureSelector.create(activity)
+            .openCamera(mimeType)
+            .setImageEngine(GlideEngine.createGlideEngine())
+            .also { builder ->
+              PictureSelectorOptionsMapper.applyCamera(builder, options)
+            }
+            .forResult(object : OnResultCallbackListener<LocalMedia>() {
+              override fun onResult(result: ArrayList<LocalMedia>) {
+                cont.resume(MediaAssetMapper.map(result))
+              }
+
+              override fun onCancel() {
+                cont.resumeWithException(
+                  PictureSelectorException("CANCELLED", "User cancelled the camera")
+                )
+              }
+            })
+        }
+      }
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // Helpers
+  // ─────────────────────────────────────────────────────────────────────────
+
+  private fun requireActivity(): Activity {
+    return reactContext.currentActivity
+      ?: throw PictureSelectorException(
+        "UNKNOWN",
+        "No current Activity available. Ensure the picker is called from a mounted component."
+      )
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Typed exception — message becomes the JS Error.message
+// ─────────────────────────────────────────────────────────────────────────────
+
+class PictureSelectorException(
+  val code: String,
+  message: String,
+) : Exception(message)

package/android/src/main/kotlin/com/margelo/pictureselector/LubanCompressEngine.kt

@@ -0,0 +1,58 @@
+package com.margelo.pictureselector
+
+import android.content.Context
+import android.net.Uri
+import com.luck.picture.lib.engine.CompressFileEngine
+import com.luck.picture.lib.interfaces.OnKeyValueResultCallbackListener
+import top.zibin.luban.Luban
+import top.zibin.luban.OnNewCompressListener
+import java.io.File
+
+/**
+ * Luban-based compression engine for PictureSelector v3.
+ *
+ * PictureSelector bundles Luban via its compress artifact
+ * (io.github.lucksiege:compress). This engine is invoked after selection
+ * when compression is enabled.
+ *
+ * API REQUIRES VERIFICATION: The exact Luban API (OnNewCompressListener
+ * callback method signatures) should be confirmed against the bundled
+ * Luban version in io.github.lucksiege:compress:v3.11.2.
+ */
+class LubanCompressEngine(
+  private val quality: Int,
+  private val maxWidth: Int,
+  private val maxHeight: Int,
+) : CompressFileEngine {
+
+  override fun onStartCompress(
+    context: Context,
+    source: ArrayList<Uri>,
+    call: OnKeyValueResultCallbackListener,
+  ) {
+    // API REQUIRES VERIFICATION: setQuality() method name in bundled Luban version.
+    // In most Luban forks bundled with PictureSelector, quality is set via .quality(Int)
+    // or .setCompressQuality(Int). Adjust the method name after verifying against
+    // io.github.lucksiege:compress:v3.11.2 source.
+    Luban.with(context)
+      .load(source)
+      .ignoreBy(100) // skip files under 100 KB
+      .setTargetDir(context.cacheDir.absolutePath)
+      .quality(quality) // 0–100 JPEG quality
+      .setCompressListener(object : OnNewCompressListener {
+        override fun onStart() {
+          // no-op
+        }
+
+        override fun onSuccess(source: String, compressFile: File) {
+          call.onCallback(source, compressFile.absolutePath)
+        }
+
+        override fun onError(source: String, e: Throwable) {
+          // Return null to signal failure; PictureSelector will use original
+          call.onCallback(source, null)
+        }
+      })
+      .launch()
+  }
+}

package/android/src/main/kotlin/com/margelo/pictureselector/MediaAssetMapper.kt

@@ -0,0 +1,69 @@
+package com.margelo.pictureselector
+
+import com.luck.picture.lib.entity.LocalMedia
+import com.margelo.nitro.com.margelo.pictureselector.MediaAsset
+import java.io.File
+
+/**
+ * Maps PictureSelector [LocalMedia] results to the Nitro bridge [MediaAsset].
+ *
+ * Priority for the final URI:
+ * 1. Compressed file path  (isCompressed && compressPath != null)
+ * 2. Cropped file path     (isCut && cutPath != null)
+ * 3. Real file path        (realPath != null)
+ * 4. Fallback              (path — may be content:// URI)
+ *
+ * API REQUIRES VERIFICATION:
+ * - LocalMedia.bucketDisplayName field name in v3.11.2
+ *   (may be bucketDisplayName or albumName).
+ * - LocalMedia.size field name (may be size or fileSize).
+ * - LocalMedia.duration unit (ms in v3; confirm).
+ */
+object MediaAssetMapper {
+
+  @JvmStatic
+  fun map(results: ArrayList<LocalMedia>): Array<MediaAsset> {
+    return results.map { media -> mapOne(media) }.toTypedArray()
+  }
+
+  private fun mapOne(media: LocalMedia): MediaAsset {
+    val finalPath = resolveFilePath(media)
+    val finalUri  = if (finalPath.startsWith("content://")) finalPath
+                    else "file://$finalPath"
+
+    val editedPath = when {
+      media.isCut  && media.cutPath      != null -> "file://${media.cutPath}"
+      else -> null
+    }
+
+    val type     = if (media.mimeType?.startsWith("video") == true) "video" else "image"
+    val fileName = File(finalPath).name.takeIf { it.isNotEmpty() } ?: "unknown"
+
+    return MediaAsset(
+      uri        = finalUri,
+      type       = type,
+      mimeType   = media.mimeType        ?: "image/jpeg",
+      width      = media.width.toDouble(),
+      height     = media.height.toDouble(),
+      duration   = media.duration.toDouble(), // milliseconds
+      fileName   = fileName,
+      fileSize   = media.size.toDouble(),     // API REQUIRES VERIFICATION: field name
+      editedUri  = editedPath,
+      isOriginal = null,
+      bucketName = media.bucketDisplayName,   // API REQUIRES VERIFICATION: field name
+    )
+  }
+
+  private fun resolveFilePath(media: LocalMedia): String {
+    if (media.isCompressed && !media.compressPath.isNullOrEmpty()) {
+      return media.compressPath!!
+    }
+    if (media.isCut && !media.cutPath.isNullOrEmpty()) {
+      return media.cutPath!!
+    }
+    if (!media.realPath.isNullOrEmpty()) {
+      return media.realPath!!
+    }
+    return media.path ?: ""
+  }
+}

package/android/src/main/kotlin/com/margelo/pictureselector/NitroPictureSelectorPackage.kt

@@ -0,0 +1,52 @@
+package com.margelo.pictureselector
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+import com.margelo.nitro.NitroModules
+
+/**
+ * React Native Package that registers the Nitro HybridObject.
+ *
+ * For new architecture (Turbo Modules / Nitro): this package is discovered
+ * automatically via autolinking when the consumer runs
+ * `react-native link` or Gradle sync.
+ *
+ * Manual registration (legacy / non-autolink):
+ * ```kotlin
+ * // MainApplication.kt
+ * override fun getPackages() = PackageList(this).packages + NitroPictureSelectorPackage()
+ * ```
+ *
+ * API REQUIRES VERIFICATION:
+ * - NitroModules.addHybridObjectCreator is the actual registration API in
+ *   react-native-nitro-modules for Android. Verify against the installed
+ *   version of the library. The creator name ("PictureSelector") must
+ *   exactly match the string passed to NitroModules.createHybridObject()
+ *   on the JS side.
+ */
+class NitroPictureSelectorPackage : ReactPackage {
+
+  override fun createNativeModules(
+    reactContext: ReactApplicationContext,
+  ): List<NativeModule> {
+    // Register the HybridObject factory. The name must match the JS-side
+    // NitroModules.createHybridObject<HybridPictureSelector>('PictureSelector').
+    NitroModules.addHybridObjectCreator("PictureSelector") {
+      try {
+        HybridPictureSelector(reactContext)
+      } catch (e: Exception) {
+        throw RuntimeException(
+          "[react-native-picture-selector] Failed to create HybridPictureSelector: ${e.message}",
+          e
+        )
+      }
+    }
+    return emptyList()
+  }
+
+  override fun createViewManagers(
+    reactContext: ReactApplicationContext,
+  ): List<ViewManager<*, *>> = emptyList()
+}

package/android/src/main/kotlin/com/margelo/pictureselector/PictureSelectorOptionsMapper.kt

@@ -0,0 +1,105 @@
+package com.margelo.pictureselector
+
+import com.luck.picture.lib.config.SelectMimeType
+import com.margelo.nitro.com.margelo.pictureselector.MediaType
+import com.margelo.nitro.com.margelo.pictureselector.PictureSelectorOptions
+
+/**
+ * Maps the JS [PictureSelectorOptions] onto a PictureSelector v3
+ * selection model.
+ *
+ * Note: [PictureSelectionModel] is the builder returned by
+ * [PictureSelector.create(activity).openGallery()] /
+ * [PictureSelector.create(activity).openCamera()].
+ *
+ * API REQUIRES VERIFICATION:
+ * - setSelectVideoMaxDuration / setSelectVideoMinDuration unit (seconds vs ms).
+ *   In v3.11.2 these accept seconds. Confirm in the library source.
+ * - setSelectorUIStyle builder method name & enum values.
+ * - setSelectedData signature for pre-selected items.
+ */
+object PictureSelectorOptionsMapper {
+
+  /**
+   * Apply gallery-specific options to the builder.
+   * Called before .forResult().
+   */
+  @JvmStatic
+  fun applyGallery(
+    builder: com.luck.picture.lib.basic.PictureSelectionModel,
+    options: PictureSelectorOptions,
+  ) {
+    applyCommon(builder, options)
+
+    // Maximum items the user may select
+    builder.setMaxSelectNum((options.maxCount ?: 1.0).toInt())
+
+    // Show camera button inside gallery
+    builder.isDisplayCamera(options.enableCamera ?: true)
+
+    // Pre-selected assets — requires conversion to LocalMedia list
+    // API REQUIRES VERIFICATION: setSelectedData(List<LocalMedia>) signature
+    // options.selectedAssets is currently unused in v1; add in future.
+  }
+
+  /**
+   * Apply camera-specific options to the builder.
+   */
+  @JvmStatic
+  fun applyCamera(
+    builder: com.luck.picture.lib.basic.PictureSelectionModel,
+    options: PictureSelectorOptions,
+  ) {
+    applyCommon(builder, options)
+  }
+
+  // ─── Shared options ──────────────────────────────────────────────────────
+
+  private fun applyCommon(
+    builder: com.luck.picture.lib.basic.PictureSelectionModel,
+    options: PictureSelectorOptions,
+  ) {
+    // ── Video duration limits ─────────────────────────────────────────────
+    // PictureSelector v3 accepts duration in seconds.
+    options.maxVideoDuration?.let { sec ->
+      builder.setSelectVideoMaxDuration(sec.toInt())
+    }
+    options.minVideoDuration?.let { sec ->
+      builder.setSelectVideoMinDuration(sec.toInt())
+    }
+
+    // ── Crop engine ───────────────────────────────────────────────────────
+    val crop = options.crop
+    val maxCount = (options.maxCount ?: 1.0).toInt()
+    if (crop != null && crop.enabled && maxCount == 1) {
+      val freeStyle = crop.freeStyle ?: false
+      val circular  = crop.circular  ?: false
+      val ratioX    = (crop.ratioX   ?: 1.0).toFloat()
+      val ratioY    = (crop.ratioY   ?: 1.0).toFloat()
+      // Map 0–1 JS quality to 0–100 JPEG quality
+      val quality   = (((options.compress?.quality ?: 0.8) * 100).toInt()).coerceIn(10, 100)
+
+      builder.setCropEngine(UCropEngine(freeStyle, ratioX, ratioY, circular, quality))
+    }
+
+    // ── Compress engine ───────────────────────────────────────────────────
+    val compress = options.compress
+    if (compress != null && compress.enabled) {
+      val quality   = (((compress.quality ?: 0.8) * 100).toInt()).coerceIn(10, 100)
+      val maxWidth  = (compress.maxWidth  ?: 1920.0).toInt()
+      val maxHeight = (compress.maxHeight ?: 1920.0).toInt()
+
+      builder.setCompressEngine(LubanCompressEngine(quality, maxWidth, maxHeight))
+    }
+  }
+
+  /**
+   * Convert a JS [MediaType] enum to the PictureSelector SelectMimeType constant.
+   */
+  @JvmStatic
+  fun toSelectMimeType(mediaType: MediaType?): Int = when (mediaType) {
+    MediaType.VIDEO -> SelectMimeType.ofVideo()
+    MediaType.ALL   -> SelectMimeType.ofAll()
+    else            -> SelectMimeType.ofImage()
+  }
+}