@capgo/capacitor-file-picker 8.2.6 → 8.2.8

package/README.md

@@ -16,6 +16,18 @@ Let users pick files, images, videos and folders with the native pickers on iOS
   <img src="https://raw.githubusercontent.com/Cap-go/capacitor-file-picker/main/assets/github-social-preview.png" alt="@capgo/capacitor-file-picker for Capacitor apps" width="300" />
 </p>
 
+## Built and maintained with AI
+
+We build, improve and fix our plugins with heavy use of AI, so issues usually get fixed in under a day and pull requests get feedback the same day. A human still reviews and merges 50+ pull requests daily.
+
+- Most plugin issues get a fix pull request the same day, often within a couple of hours, and are usually resolved in one to two days.
+- Every pull request goes through our AI review system, usually within minutes.
+- Our AI pre-checks tests, code review, conventions and security, then a human validates and merges.
+- A human, Martin, reviews and merges 50+ pull requests every day.
+- In the last 90 days, 95% of plugin issues were resolved.
+
+[Learn more about how we build with AI](https://capgo.app/docs/plugins/ai-engineering/)
+
 ## Key features
 
 - **Files**: `pickFiles()` picks one or more files of any type.
@@ -152,6 +164,10 @@ pickImages(options?: PickMediaOptions | undefined) => Promise<PickFilesResult>
 
 Pick one or more images from the gallery.
 Android/iOS only.
+On Android, `limit` is enforced by the system photo picker when available
+(Android 13+, or Android 11-12 with the Google Play system photo picker extension).
+Older Android versions may allow selecting more items than `limit`; results are
+truncated to `limit` before they are returned.
 
 | Param         | Type                                                          | Description                  |
 | ------------- | ------------------------------------------------------------- | ---------------------------- |
@@ -172,6 +188,10 @@ pickVideos(options?: PickMediaOptions | undefined) => Promise<PickFilesResult>
 
 Pick one or more videos from the gallery.
 Android/iOS only.
+On Android, `limit` is enforced by the system photo picker when available
+(Android 13+, or Android 11-12 with the Google Play system photo picker extension).
+Older Android versions may allow selecting more items than `limit`; results are
+truncated to `limit` before they are returned.
 
 | Param         | Type                                                          | Description                  |
 | ------------- | ------------------------------------------------------------- | ---------------------------- |
@@ -390,12 +410,12 @@ Options for picking files.
 
 Options for picking media (images/videos).
 
-| Prop                  | Type                 | Description                                                                                 | Default            |
-| --------------------- | -------------------- | ------------------------------------------------------------------------------------------- | ------------------ |
-| **`limit`**           | <code>number</code>  | Maximum number of files to pick. Set to 0 for unlimited (platform default).                 | <code>0</code>     |
-| **`readData`**        | <code>boolean</code> | Whether to read the file data as base64. Note: Reading large files may cause memory issues. | <code>false</code> |
-| **`skipTranscoding`** | <code>boolean</code> | iOS only: Skip transcoding of videos.                                                       | <code>false</code> |
-| **`ordered`**         | <code>boolean</code> | iOS 15+ only: Show ordered selection badges.                                                | <code>false</code> |
+| Prop                  | Type                 | Description                                                                                                                                                                                                                                                                                                                           | Default            |
+| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
+| **`limit`**           | <code>number</code>  | Maximum number of files to pick. Set to 0 for unlimited (platform default). On Android, when the system photo picker is available, the platform enforces this limit (capped by the device maximum). On older Android versions the picker may not enforce the limit; the plugin truncates the returned list to this value when needed. | <code>0</code>     |
+| **`readData`**        | <code>boolean</code> | Whether to read the file data as base64. Note: Reading large files may cause memory issues.                                                                                                                                                                                                                                           | <code>false</code> |
+| **`skipTranscoding`** | <code>boolean</code> | iOS only: Skip transcoding of videos.                                                                                                                                                                                                                                                                                                 | <code>false</code> |
+| **`ordered`**         | <code>boolean</code> | iOS 15+ only: Show ordered selection badges.                                                                                                                                                                                                                                                                                          | <code>false</code> |
 
 
 #### PickDirectoryResult

package/android/build.gradle

@@ -53,6 +53,8 @@ dependencies {
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     testImplementation "junit:junit:$junitVersion"
+    testImplementation "org.mockito:mockito-core:5.14.2"
+    testImplementation "org.robolectric:robolectric:4.16"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
 }

package/android/src/main/java/app/capgo/capacitor/filepicker/CapgoFilePickerPlugin.java

@@ -2,6 +2,7 @@ package app.capgo.capacitor.filepicker;
 
 import android.Manifest;
 import android.app.Activity;
+import android.content.ActivityNotFoundException;
 import android.content.ClipData;
 import android.content.Intent;
 import android.database.Cursor;
@@ -50,14 +51,30 @@ import org.json.JSONException;
 )
 public class CapgoFilePickerPlugin extends Plugin {
 
-    private final String pluginVersion = "8.2.6";
-    private boolean readData = false;
+    private final String pluginVersion = "8.2.8";
+
+    private PickerLaunchQueue pickerLaunchQueue;
+
+    @Override
+    public void load() {
+        super.load();
+        pickerLaunchQueue = new PickerLaunchQueue((runnable) -> bridge.executeOnMainThread(runnable), this::launchPickerActivity);
+    }
+
+    private boolean launchPickerActivity(PickerLaunchQueue.PendingPickerLaunch launch) {
+        try {
+            startActivityForResult(launch.call, launch.getIntent(), launch.callbackName);
+            return true;
+        } catch (ActivityNotFoundException e) {
+            launch.call.reject("Unable to open file picker", e);
+            return false;
+        }
+    }
 
     // MARK: - Pick Files
 
     @PluginMethod
     public void pickFiles(PluginCall call) {
-        readData = call.getBoolean("readData", false);
         int limit = call.getInt("limit", 0);
 
         Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
@@ -86,53 +103,49 @@ public class CapgoFilePickerPlugin extends Plugin {
         intent.addCategory(Intent.CATEGORY_OPENABLE);
         intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, limit != 1);
 
-        startActivityForResult(call, intent, "pickFilesResult");
+        enqueuePickerLaunch(call, intent, "pickFilesResult", false);
     }
 
     // MARK: - Pick Images
 
     @PluginMethod
     public void pickImages(PluginCall call) {
-        readData = call.getBoolean("readData", false);
         int limit = call.getInt("limit", 0);
+        boolean photoPickerAvailable = MediaPickerIntents.isPhotoPickerAvailable();
+        boolean truncateResults = MediaPickerIntents.shouldTruncateResultsToLimit(photoPickerAvailable);
 
-        Intent intent = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
-        intent.setType("image/*");
-        intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, limit != 1);
-
-        startActivityForResult(call, intent, "pickMediaResult");
+        Intent intent = MediaPickerIntents.buildPickImagesIntent(limit, photoPickerAvailable);
+        enqueuePickerLaunch(call, intent, "pickMediaResult", truncateResults);
     }
 
     // MARK: - Pick Videos
 
     @PluginMethod
     public void pickVideos(PluginCall call) {
-        readData = call.getBoolean("readData", false);
         int limit = call.getInt("limit", 0);
+        boolean photoPickerAvailable = MediaPickerIntents.isPhotoPickerAvailable();
+        boolean truncateResults = MediaPickerIntents.shouldTruncateResultsToLimit(photoPickerAvailable);
 
-        Intent intent = new Intent(Intent.ACTION_PICK, MediaStore.Video.Media.EXTERNAL_CONTENT_URI);
-        intent.setType("video/*");
-        intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, limit != 1);
-
-        startActivityForResult(call, intent, "pickMediaResult");
+        Intent intent = MediaPickerIntents.buildPickVideosIntent(limit, photoPickerAvailable);
+        enqueuePickerLaunch(call, intent, "pickMediaResult", truncateResults);
     }
 
     // MARK: - Pick Media
 
     @PluginMethod
     public void pickMedia(PluginCall call) {
-        readData = call.getBoolean("readData", false);
         int limit = call.getInt("limit", 0);
 
         Intent intent;
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+        boolean photoPickerAvailable = MediaPickerIntents.isPhotoPickerAvailable();
+        boolean truncateResults = false;
+        if (photoPickerAvailable) {
             intent = new Intent(MediaStore.ACTION_PICK_IMAGES);
             intent.setType("*/*");
             intent.putExtra(Intent.EXTRA_MIME_TYPES, new String[] { "image/*", "video/*" });
-            if (limit > 1) {
-                intent.putExtra(MediaStore.EXTRA_PICK_IMAGES_MAX, limit);
-            }
+            MediaPickerIntents.applyPhotoPickerMaxLimit(intent, limit, MediaStore.getPickImagesMaxLimit());
         } else {
+            truncateResults = true;
             intent = new Intent(Intent.ACTION_GET_CONTENT);
             intent.setType("*/*");
             intent.putExtra(Intent.EXTRA_MIME_TYPES, new String[] { "image/*", "video/*" });
@@ -140,7 +153,7 @@ public class CapgoFilePickerPlugin extends Plugin {
             intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, limit != 1);
         }
 
-        startActivityForResult(call, intent, "pickMediaResult");
+        enqueuePickerLaunch(call, intent, "pickMediaResult", truncateResults);
     }
 
     // MARK: - Pick Directory
@@ -150,7 +163,7 @@ public class CapgoFilePickerPlugin extends Plugin {
         Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
         intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
 
-        startActivityForResult(call, intent, "pickDirectoryResult");
+        enqueuePickerLaunch(call, intent, "pickDirectoryResult", false);
     }
 
     // MARK: - Convert HEIC to JPEG
@@ -253,89 +266,123 @@ public class CapgoFilePickerPlugin extends Plugin {
 
     @ActivityCallback
     private void pickFilesResult(PluginCall call, ActivityResult result) {
-        handleFilePickerResult(call, result);
+        handleFilePickerResult(call, result, false);
     }
 
     @ActivityCallback
     private void pickMediaResult(PluginCall call, ActivityResult result) {
-        handleFilePickerResult(call, result);
+        handleFilePickerResult(call, result, truncateResultsForCall(call));
+    }
+
+    private boolean truncateResultsForCall(PluginCall call) {
+        return pickerLaunchQueue.isTruncateResultsForCall(call);
     }
 
-    private void handleFilePickerResult(PluginCall call, ActivityResult result) {
+    private void handleFilePickerResult(PluginCall call, ActivityResult result, boolean truncateResultsToLimit) {
         if (call == null) {
+            completeActivePickerLaunch();
             return;
         }
 
-        if (result.getResultCode() != Activity.RESULT_OK) {
-            notifyListeners("pickerDismissed", new JSObject());
-            JSObject ret = new JSObject();
-            ret.put("files", new JSArray());
-            call.resolve(ret);
-            return;
-        }
+        try {
+            if (result.getResultCode() != Activity.RESULT_OK) {
+                notifyListeners("pickerDismissed", new JSObject());
+                JSObject ret = new JSObject();
+                ret.put("files", new JSArray());
+                call.resolve(ret);
+                return;
+            }
 
-        Intent data = result.getData();
-        if (data == null) {
-            JSObject ret = new JSObject();
-            ret.put("files", new JSArray());
-            call.resolve(ret);
-            return;
-        }
+            Intent data = result.getData();
+            if (data == null) {
+                JSObject ret = new JSObject();
+                ret.put("files", new JSArray());
+                call.resolve(ret);
+                return;
+            }
 
-        List<Uri> uris = new ArrayList<>();
+            List<Uri> uris = new ArrayList<>();
 
-        ClipData clipData = data.getClipData();
-        if (clipData != null) {
-            for (int i = 0; i < clipData.getItemCount(); i++) {
-                uris.add(clipData.getItemAt(i).getUri());
+            ClipData clipData = data.getClipData();
+            if (clipData != null) {
+                for (int i = 0; i < clipData.getItemCount(); i++) {
+                    uris.add(clipData.getItemAt(i).getUri());
+                }
+            } else if (data.getData() != null) {
+                uris.add(data.getData());
             }
-        } else if (data.getData() != null) {
-            uris.add(data.getData());
-        }
 
-        JSArray files = new JSArray();
-        for (Uri uri : uris) {
-            JSObject fileInfo = getFileInfo(uri);
-            if (fileInfo != null) {
-                files.put(fileInfo);
+            if (truncateResultsToLimit) {
+                int limit = call.getInt("limit", 0);
+                uris = MediaPickerIntents.truncateUris(uris, limit);
             }
-        }
 
-        JSObject ret = new JSObject();
-        ret.put("files", files);
-        call.resolve(ret);
+            boolean readData = call.getBoolean("readData", false);
+            JSArray files = new JSArray();
+            for (Uri uri : uris) {
+                JSObject fileInfo = getFileInfo(uri, readData);
+                if (fileInfo != null) {
+                    files.put(fileInfo);
+                }
+            }
+
+            JSObject ret = new JSObject();
+            ret.put("files", files);
+            call.resolve(ret);
+        } finally {
+            completeActivePickerLaunch();
+        }
     }
 
     @ActivityCallback
     private void pickDirectoryResult(PluginCall call, ActivityResult result) {
         if (call == null) {
+            completeActivePickerLaunch();
             return;
         }
 
-        if (result.getResultCode() != Activity.RESULT_OK) {
-            notifyListeners("pickerDismissed", new JSObject());
-            call.reject("User cancelled");
-            return;
-        }
+        try {
+            if (result.getResultCode() != Activity.RESULT_OK) {
+                notifyListeners("pickerDismissed", new JSObject());
+                call.reject("User cancelled");
+                return;
+            }
 
-        Intent data = result.getData();
-        if (data == null || data.getData() == null) {
-            call.reject("No directory selected");
-            return;
+            Intent data = result.getData();
+            if (data == null || data.getData() == null) {
+                call.reject("No directory selected");
+                return;
+            }
+
+            Uri uri = data.getData();
+            String path = getPathFromUri(uri);
+
+            JSObject ret = new JSObject();
+            ret.put("path", path != null ? path : uri.toString());
+            call.resolve(ret);
+        } finally {
+            completeActivePickerLaunch();
         }
+    }
 
-        Uri uri = data.getData();
-        String path = getPathFromUri(uri);
+    private void enqueuePickerLaunch(PluginCall call, Intent intent, String callbackName, boolean truncateResultsToLimit) {
+        PickerLaunchQueue.PendingPickerLaunch launch = new PickerLaunchQueue.PendingPickerLaunch(
+            call,
+            intent,
+            callbackName,
+            truncateResultsToLimit
+        );
+        pickerLaunchQueue.enqueue(launch);
+    }
 
-        JSObject ret = new JSObject();
-        ret.put("path", path != null ? path : uri.toString());
-        call.resolve(ret);
+    private void completeActivePickerLaunch() {
+        pickerLaunchQueue.completeActive();
     }
 
     // MARK: - Helpers
 
     @Nullable
-    private JSObject getFileInfo(Uri uri) {
+    private JSObject getFileInfo(Uri uri, boolean readData) {
         try {
             JSObject result = new JSObject();
 
@@ -415,7 +462,6 @@ public class CapgoFilePickerPlugin extends Plugin {
                 }
             }
 
-            // Read data if requested
             if (readData) {
                 try (InputStream is = getContext().getContentResolver().openInputStream(uri)) {
                     if (is != null) {

package/android/src/main/java/app/capgo/capacitor/filepicker/MediaPickerIntents.java

@@ -0,0 +1,87 @@
+package app.capgo.capacitor.filepicker;
+
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.os.ext.SdkExtensions;
+import android.provider.MediaStore;
+import java.util.ArrayList;
+import java.util.List;
+
+/** Builds gallery picker intents and applies selection limits on Android. */
+final class MediaPickerIntents {
+
+    private MediaPickerIntents() {}
+
+    static boolean isPhotoPickerAvailable() {
+        return isPhotoPickerAvailable(Build.VERSION.SDK_INT, getRExtensionVersion());
+    }
+
+    static boolean isPhotoPickerAvailable(int sdkInt, int rExtensionVersion) {
+        if (sdkInt >= Build.VERSION_CODES.TIRAMISU) {
+            return true;
+        }
+        if (sdkInt >= Build.VERSION_CODES.R) {
+            return rExtensionVersion >= 2;
+        }
+        return false;
+    }
+
+    private static int getRExtensionVersion() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            return SdkExtensions.getExtensionVersion(Build.VERSION_CODES.R);
+        }
+        return 0;
+    }
+
+    static Intent buildPickImagesIntent(int limit, boolean photoPickerAvailable) {
+        return buildGalleryIntent("image/*", MediaStore.Images.Media.EXTERNAL_CONTENT_URI, limit, photoPickerAvailable);
+    }
+
+    static Intent buildPickVideosIntent(int limit, boolean photoPickerAvailable) {
+        return buildGalleryIntent("video/*", MediaStore.Video.Media.EXTERNAL_CONTENT_URI, limit, photoPickerAvailable);
+    }
+
+    static int resolvePhotoPickerMaxLimit(int limit, int pickImagesMaxLimit) {
+        if (limit <= 0) {
+            return pickImagesMaxLimit > 0 ? pickImagesMaxLimit : limit;
+        }
+        return pickImagesMaxLimit > 0 ? Math.min(limit, pickImagesMaxLimit) : limit;
+    }
+
+    static void applyPhotoPickerMaxLimit(Intent intent, int limit, int pickImagesMaxLimit) {
+        if (limit == 1) {
+            return;
+        }
+        intent.putExtra(MediaStore.EXTRA_PICK_IMAGES_MAX, resolvePhotoPickerMaxLimit(limit, pickImagesMaxLimit));
+    }
+
+    static Intent buildGalleryIntent(String mimeType, Uri legacyPickUri, int limit, boolean photoPickerAvailable) {
+        return buildGalleryIntent(mimeType, legacyPickUri, limit, photoPickerAvailable, MediaStore.getPickImagesMaxLimit());
+    }
+
+    static Intent buildGalleryIntent(String mimeType, Uri legacyPickUri, int limit, boolean photoPickerAvailable, int pickImagesMaxLimit) {
+        if (photoPickerAvailable) {
+            Intent intent = new Intent(MediaStore.ACTION_PICK_IMAGES);
+            intent.setType(mimeType);
+            applyPhotoPickerMaxLimit(intent, limit, pickImagesMaxLimit);
+            return intent;
+        }
+
+        Intent intent = new Intent(Intent.ACTION_PICK, legacyPickUri);
+        intent.setType(mimeType);
+        intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, limit != 1);
+        return intent;
+    }
+
+    static boolean shouldTruncateResultsToLimit(boolean photoPickerAvailable) {
+        return !photoPickerAvailable;
+    }
+
+    static List<Uri> truncateUris(List<Uri> uris, int limit) {
+        if (limit <= 0 || uris.size() <= limit) {
+            return uris;
+        }
+        return new ArrayList<>(uris.subList(0, limit));
+    }
+}

package/android/src/main/java/app/capgo/capacitor/filepicker/PickerLaunchQueue.java

@@ -0,0 +1,126 @@
+package app.capgo.capacitor.filepicker;
+
+import com.getcapacitor.PluginCall;
+import java.util.ArrayDeque;
+import java.util.Queue;
+
+/**
+ * Serializes picker activity launches so only one Capacitor saved activity call is active.
+ * All queue mutations and launches run on the main thread.
+ */
+final class PickerLaunchQueue {
+
+    static final class PendingPickerLaunch {
+
+        final PluginCall call;
+        final IntentHolder intent;
+        final String callbackName;
+        final boolean truncateResultsToLimit;
+
+        PendingPickerLaunch(PluginCall call, android.content.Intent intent, String callbackName, boolean truncateResultsToLimit) {
+            this.call = call;
+            this.intent = new IntentHolder(intent);
+            this.callbackName = callbackName;
+            this.truncateResultsToLimit = truncateResultsToLimit;
+        }
+
+        android.content.Intent getIntent() {
+            return intent.get();
+        }
+    }
+
+    /**
+     * Holds a copy of the intent so queued launches are not affected if callers mutate the original.
+     */
+    private static final class IntentHolder {
+
+        private final android.content.Intent intent;
+
+        IntentHolder(android.content.Intent intent) {
+            this.intent = new android.content.Intent(intent);
+        }
+
+        android.content.Intent get() {
+            return intent;
+        }
+    }
+
+    interface MainThreadScheduler {
+        void run(Runnable runnable);
+    }
+
+    /**
+     * @return true when the activity was launched and the call is retained for the result callback
+     */
+    interface ActivityLauncher {
+        boolean launch(PendingPickerLaunch launch);
+    }
+
+    private final MainThreadScheduler mainThreadScheduler;
+    private final ActivityLauncher activityLauncher;
+    private final Queue<PendingPickerLaunch> pendingPickerLaunches = new ArrayDeque<>();
+    private PendingPickerLaunch activePickerLaunch;
+
+    PickerLaunchQueue(MainThreadScheduler mainThreadScheduler, ActivityLauncher activityLauncher) {
+        this.mainThreadScheduler = mainThreadScheduler;
+        this.activityLauncher = activityLauncher;
+    }
+
+    void enqueue(PendingPickerLaunch launch) {
+        mainThreadScheduler.run(() -> enqueueOnMainThread(launch));
+    }
+
+    void completeActive() {
+        mainThreadScheduler.run(this::completeActiveOnMainThread);
+    }
+
+    PendingPickerLaunch getActiveLaunch() {
+        return activePickerLaunch;
+    }
+
+    boolean isTruncateResultsForCall(PluginCall call) {
+        PendingPickerLaunch active = activePickerLaunch;
+        if (active != null && active.call == call) {
+            return active.truncateResultsToLimit;
+        }
+        return false;
+    }
+
+    private void enqueueOnMainThread(PendingPickerLaunch launch) {
+        if (activePickerLaunch != null) {
+            pendingPickerLaunches.add(launch);
+            return;
+        }
+        startPickerLaunch(launch);
+    }
+
+    private void completeActiveOnMainThread() {
+        activePickerLaunch = null;
+        startNextQueuedLaunch();
+    }
+
+    private void startNextQueuedLaunch() {
+        PendingPickerLaunch next = pendingPickerLaunches.poll();
+        if (next != null) {
+            startPickerLaunch(next);
+        }
+    }
+
+    private void startPickerLaunch(PendingPickerLaunch launch) {
+        boolean launched;
+        try {
+            launched = activityLauncher.launch(launch);
+        } catch (RuntimeException e) {
+            launch.call.reject("Unable to open file picker", e);
+            startNextQueuedLaunch();
+            return;
+        }
+
+        if (!launched) {
+            startNextQueuedLaunch();
+            return;
+        }
+
+        activePickerLaunch = launch;
+    }
+}

package/dist/docs.json

@@ -75,7 +75,7 @@
             "text": "```typescript\nconst result = await CapgoFilePicker.pickImages({\n  limit: 10,\n  readData: false\n});\nconsole.log('Picked images:', result.files);\n```"
           }
         ],
-        "docs": "Pick one or more images from the gallery.\nAndroid/iOS only.",
+        "docs": "Pick one or more images from the gallery.\nAndroid/iOS only.\nOn Android, `limit` is enforced by the system photo picker when available\n(Android 13+, or Android 11-12 with the Google Play system photo picker extension).\nOlder Android versions may allow selecting more items than `limit`; results are\ntruncated to `limit` before they are returned.",
         "complexTypes": [
           "PickFilesResult",
           "PickMediaOptions"
@@ -111,7 +111,7 @@
             "text": "```typescript\nconst result = await CapgoFilePicker.pickVideos({\n  limit: 3,\n  skipTranscoding: true\n});\nconsole.log('Picked videos:', result.files);\n```"
           }
         ],
-        "docs": "Pick one or more videos from the gallery.\nAndroid/iOS only.",
+        "docs": "Pick one or more videos from the gallery.\nAndroid/iOS only.\nOn Android, `limit` is enforced by the system photo picker when available\n(Android 13+, or Android 11-12 with the Google Play system photo picker extension).\nOlder Android versions may allow selecting more items than `limit`; results are\ntruncated to `limit` before they are returned.",
         "complexTypes": [
           "PickFilesResult",
           "PickMediaOptions"
@@ -557,7 +557,7 @@
               "name": "default"
             }
           ],
-          "docs": "Maximum number of files to pick.\nSet to 0 for unlimited (platform default).",
+          "docs": "Maximum number of files to pick.\nSet to 0 for unlimited (platform default).\nOn Android, when the system photo picker is available, the platform enforces this\nlimit (capped by the device maximum). On older Android versions the picker may not\nenforce the limit; the plugin truncates the returned list to this value when needed.",
           "complexTypes": [],
           "type": "number | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -33,6 +33,9 @@ export interface PickMediaOptions {
     /**
      * Maximum number of files to pick.
      * Set to 0 for unlimited (platform default).
+     * On Android, when the system photo picker is available, the platform enforces this
+     * limit (capped by the device maximum). On older Android versions the picker may not
+     * enforce the limit; the plugin truncates the returned list to this value when needed.
      * @default 0
      */
     limit?: number;
@@ -195,6 +198,10 @@ export interface CapgoFilePickerPlugin {
     /**
      * Pick one or more images from the gallery.
      * Android/iOS only.
+     * On Android, `limit` is enforced by the system photo picker when available
+     * (Android 13+, or Android 11-12 with the Google Play system photo picker extension).
+     * Older Android versions may allow selecting more items than `limit`; results are
+     * truncated to `limit` before they are returned.
      *
      * @param options - Options for picking images
      * @returns Promise that resolves with the picked images
@@ -212,6 +219,10 @@ export interface CapgoFilePickerPlugin {
     /**
      * Pick one or more videos from the gallery.
      * Android/iOS only.
+     * On Android, `limit` is enforced by the system photo picker when available
+     * (Android 13+, or Android 11-12 with the Google Play system photo picker extension).
+     * Older Android versions may allow selecting more items than `limit`; results are
+     * truncated to `limit` before they are returned.
      *
      * @param options - Options for picking videos
      * @returns Promise that resolves with the picked videos

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Options for picking files.\n *\n * @since 8.0.0\n */\nexport interface PickFilesOptions {\n  /**\n   * List of accepted MIME types or file extensions.\n   * On iOS, only MIME types are supported.\n   * Examples: ['image/*'], ['application/pdf'], ['.pdf', '.doc']\n   */\n  types?: string[];\n  /**\n   * Maximum number of files to pick.\n   * Set to 0 for unlimited (platform default).\n   * @default 0\n   */\n  limit?: number;\n  /**\n   * Whether to read the file data as base64.\n   * Note: Reading large files may cause memory issues.\n   * @default false\n   */\n  readData?: boolean;\n}\n\n/**\n * Options for picking media (images/videos).\n *\n * @since 8.0.0\n */\nexport interface PickMediaOptions {\n  /**\n   * Maximum number of files to pick.\n   * Set to 0 for unlimited (platform default).\n   * @default 0\n   */\n  limit?: number;\n  /**\n   * Whether to read the file data as base64.\n   * Note: Reading large files may cause memory issues.\n   * @default false\n   */\n  readData?: boolean;\n  /**\n   * iOS only: Skip transcoding of videos.\n   * @default false\n   */\n  skipTranscoding?: boolean;\n  /**\n   * iOS 15+ only: Show ordered selection badges.\n   * @default false\n   */\n  ordered?: boolean;\n}\n\n/**\n * Options for converting HEIC to JPEG.\n *\n * @since 8.0.0\n */\nexport interface ConvertHeicToJpegOptions {\n  /** The path to the HEIC file to convert */\n  path: string;\n  /**\n   * The compression quality for JPEG (0.0 - 1.0).\n   * @default 0.9\n   */\n  quality?: number;\n}\n\n/**\n * Result of HEIC to JPEG conversion.\n *\n * @since 8.0.0\n */\nexport interface ConvertHeicToJpegResult {\n  /** The path to the converted JPEG file */\n  path: string;\n}\n\n/**\n * Options for copying a file.\n *\n * @since 8.0.0\n */\nexport interface CopyFileOptions {\n  /** Source file path */\n  from: string;\n  /** Destination file path */\n  to: string;\n  /**\n   * Whether to overwrite if destination exists.\n   * @default false\n   */\n  overwrite?: boolean;\n}\n\n/**\n * Represents a picked file.\n *\n * @since 8.0.0\n */\nexport interface PickedFile {\n  /** The name of the file */\n  name: string;\n  /** The path to the file */\n  path?: string;\n  /** The MIME type of the file */\n  mimeType: string;\n  /** The size of the file in bytes */\n  size: number;\n  /**\n   * The base64 encoded data of the file.\n   * Only present if readData was true.\n   */\n  data?: string;\n  /**\n   * The Blob instance of the file.\n   * Web only.\n   */\n  blob?: Blob;\n  /** Width in pixels (images/videos only) */\n  width?: number;\n  /** Height in pixels (images/videos only) */\n  height?: number;\n  /** Duration in seconds (videos only) */\n  duration?: number;\n  /** Last modified timestamp in milliseconds */\n  modifiedAt?: number;\n}\n\n/**\n * Result of picking files.\n *\n * @since 8.0.0\n */\nexport interface PickFilesResult {\n  /** Array of picked files */\n  files: PickedFile[];\n}\n\n/**\n * Result of picking a directory.\n *\n * @since 8.0.0\n */\nexport interface PickDirectoryResult {\n  /** The path to the selected directory */\n  path: string;\n}\n\n/**\n * Permission status for file access.\n *\n * @since 8.0.0\n */\nexport interface PermissionStatus {\n  /**\n   * Whether broad external storage or media permission is granted.\n   * Picker APIs that return user-selected files usually do not require this on Android 13+.\n   */\n  readExternalStorage: PermissionState;\n  /** Whether permission to access media location is granted */\n  accessMediaLocation?: PermissionState;\n}\n\n/**\n * Permission state values.\n *\n * @since 8.0.0\n */\nexport type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';\n\n/**\n * Listener callback for picker dismissed event.\n *\n * @since 8.0.0\n */\nexport type PickerDismissedListener = (event: null) => void;\n\n/**\n * Capacitor File Picker Plugin interface for selecting files, images, videos, and directories.\n *\n * @since 8.0.0\n */\nexport interface CapgoFilePickerPlugin {\n  /**\n   * Pick one or more files from the device.\n   *\n   * @param options - Options for picking files\n   * @returns Promise that resolves with the picked files\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickFiles({\n   *   types: ['application/pdf', 'image/*'],\n   *   limit: 5,\n   *   readData: false\n   * });\n   * console.log('Picked files:', result.files);\n   * ```\n   */\n  pickFiles(options?: PickFilesOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more images from the gallery.\n   * Android/iOS only.\n   *\n   * @param options - Options for picking images\n   * @returns Promise that resolves with the picked images\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickImages({\n   *   limit: 10,\n   *   readData: false\n   * });\n   * console.log('Picked images:', result.files);\n   * ```\n   */\n  pickImages(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more videos from the gallery.\n   * Android/iOS only.\n   *\n   * @param options - Options for picking videos\n   * @returns Promise that resolves with the picked videos\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickVideos({\n   *   limit: 3,\n   *   skipTranscoding: true\n   * });\n   * console.log('Picked videos:', result.files);\n   * ```\n   */\n  pickVideos(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more images or videos from the gallery.\n   * Android/iOS only.\n   *\n   * @param options - Options for picking media\n   * @returns Promise that resolves with the picked media files\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickMedia({\n   *   limit: 5,\n   *   readData: true\n   * });\n   * console.log('Picked media:', result.files);\n   * ```\n   */\n  pickMedia(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick a directory from the device.\n   * Android/iOS only.\n   *\n   * @returns Promise that resolves with the picked directory path\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickDirectory();\n   * console.log('Selected directory:', result.path);\n   * ```\n   */\n  pickDirectory(): Promise<PickDirectoryResult>;\n\n  /**\n   * Convert a HEIC image to JPEG format.\n   * iOS only.\n   *\n   * @param options - Options for the conversion\n   * @returns Promise that resolves with the converted file path\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.convertHeicToJpeg({\n   *   path: '/path/to/image.heic',\n   *   quality: 0.9\n   * });\n   * console.log('Converted file:', result.path);\n   * ```\n   */\n  convertHeicToJpeg(options: ConvertHeicToJpegOptions): Promise<ConvertHeicToJpegResult>;\n\n  /**\n   * Copy a file to a new location.\n   *\n   * @param options - Options for copying the file\n   * @returns Promise that resolves when the copy is complete\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoFilePicker.copyFile({\n   *   from: '/source/file.pdf',\n   *   to: '/destination/file.pdf',\n   *   overwrite: true\n   * });\n   * ```\n   */\n  copyFile(options: CopyFileOptions): Promise<void>;\n\n  /**\n   * Check broad storage or media permission state.\n   * Picker-only flows should not gate `pickFiles()`, `pickImages()`,\n   * `pickVideos()`, or `pickMedia()` on this permission on Android 13+.\n   * Android only.\n   *\n   * @returns Promise that resolves with the permission status\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const status = await CapgoFilePicker.checkPermissions();\n   * console.log('Read permission:', status.readExternalStorage);\n   * ```\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request broad storage or media permissions.\n   * Do not request or declare `READ_MEDIA_IMAGES` or `READ_MEDIA_VIDEO`\n   * only to use picker APIs. Google Play allows these permissions only\n   * when picker alternatives are not sufficient for core app functionality.\n   * Use `@capgo/capacitor-file-picker` picker methods instead for\n   * user-selected file, image, or video access.\n   * Android only.\n   *\n   * @returns Promise that resolves with the permission status\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const status = await CapgoFilePicker.requestPermissions();\n   * if (status.readExternalStorage === 'granted') {\n   *   console.log('Permission granted');\n   * }\n   * ```\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Add a listener for the picker dismissed event.\n   * iOS only.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - The listener function\n   * @returns Promise that resolves with the listener handle\n   * @since 8.0.0\n   */\n  addListener(eventName: 'pickerDismissed', listenerFunc: PickerDismissedListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 8.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version.\n   *\n   * @returns Promise that resolves with the plugin version\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const { version } = await CapgoFilePicker.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Options for picking files.\n *\n * @since 8.0.0\n */\nexport interface PickFilesOptions {\n  /**\n   * List of accepted MIME types or file extensions.\n   * On iOS, only MIME types are supported.\n   * Examples: ['image/*'], ['application/pdf'], ['.pdf', '.doc']\n   */\n  types?: string[];\n  /**\n   * Maximum number of files to pick.\n   * Set to 0 for unlimited (platform default).\n   * @default 0\n   */\n  limit?: number;\n  /**\n   * Whether to read the file data as base64.\n   * Note: Reading large files may cause memory issues.\n   * @default false\n   */\n  readData?: boolean;\n}\n\n/**\n * Options for picking media (images/videos).\n *\n * @since 8.0.0\n */\nexport interface PickMediaOptions {\n  /**\n   * Maximum number of files to pick.\n   * Set to 0 for unlimited (platform default).\n   * On Android, when the system photo picker is available, the platform enforces this\n   * limit (capped by the device maximum). On older Android versions the picker may not\n   * enforce the limit; the plugin truncates the returned list to this value when needed.\n   * @default 0\n   */\n  limit?: number;\n  /**\n   * Whether to read the file data as base64.\n   * Note: Reading large files may cause memory issues.\n   * @default false\n   */\n  readData?: boolean;\n  /**\n   * iOS only: Skip transcoding of videos.\n   * @default false\n   */\n  skipTranscoding?: boolean;\n  /**\n   * iOS 15+ only: Show ordered selection badges.\n   * @default false\n   */\n  ordered?: boolean;\n}\n\n/**\n * Options for converting HEIC to JPEG.\n *\n * @since 8.0.0\n */\nexport interface ConvertHeicToJpegOptions {\n  /** The path to the HEIC file to convert */\n  path: string;\n  /**\n   * The compression quality for JPEG (0.0 - 1.0).\n   * @default 0.9\n   */\n  quality?: number;\n}\n\n/**\n * Result of HEIC to JPEG conversion.\n *\n * @since 8.0.0\n */\nexport interface ConvertHeicToJpegResult {\n  /** The path to the converted JPEG file */\n  path: string;\n}\n\n/**\n * Options for copying a file.\n *\n * @since 8.0.0\n */\nexport interface CopyFileOptions {\n  /** Source file path */\n  from: string;\n  /** Destination file path */\n  to: string;\n  /**\n   * Whether to overwrite if destination exists.\n   * @default false\n   */\n  overwrite?: boolean;\n}\n\n/**\n * Represents a picked file.\n *\n * @since 8.0.0\n */\nexport interface PickedFile {\n  /** The name of the file */\n  name: string;\n  /** The path to the file */\n  path?: string;\n  /** The MIME type of the file */\n  mimeType: string;\n  /** The size of the file in bytes */\n  size: number;\n  /**\n   * The base64 encoded data of the file.\n   * Only present if readData was true.\n   */\n  data?: string;\n  /**\n   * The Blob instance of the file.\n   * Web only.\n   */\n  blob?: Blob;\n  /** Width in pixels (images/videos only) */\n  width?: number;\n  /** Height in pixels (images/videos only) */\n  height?: number;\n  /** Duration in seconds (videos only) */\n  duration?: number;\n  /** Last modified timestamp in milliseconds */\n  modifiedAt?: number;\n}\n\n/**\n * Result of picking files.\n *\n * @since 8.0.0\n */\nexport interface PickFilesResult {\n  /** Array of picked files */\n  files: PickedFile[];\n}\n\n/**\n * Result of picking a directory.\n *\n * @since 8.0.0\n */\nexport interface PickDirectoryResult {\n  /** The path to the selected directory */\n  path: string;\n}\n\n/**\n * Permission status for file access.\n *\n * @since 8.0.0\n */\nexport interface PermissionStatus {\n  /**\n   * Whether broad external storage or media permission is granted.\n   * Picker APIs that return user-selected files usually do not require this on Android 13+.\n   */\n  readExternalStorage: PermissionState;\n  /** Whether permission to access media location is granted */\n  accessMediaLocation?: PermissionState;\n}\n\n/**\n * Permission state values.\n *\n * @since 8.0.0\n */\nexport type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';\n\n/**\n * Listener callback for picker dismissed event.\n *\n * @since 8.0.0\n */\nexport type PickerDismissedListener = (event: null) => void;\n\n/**\n * Capacitor File Picker Plugin interface for selecting files, images, videos, and directories.\n *\n * @since 8.0.0\n */\nexport interface CapgoFilePickerPlugin {\n  /**\n   * Pick one or more files from the device.\n   *\n   * @param options - Options for picking files\n   * @returns Promise that resolves with the picked files\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickFiles({\n   *   types: ['application/pdf', 'image/*'],\n   *   limit: 5,\n   *   readData: false\n   * });\n   * console.log('Picked files:', result.files);\n   * ```\n   */\n  pickFiles(options?: PickFilesOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more images from the gallery.\n   * Android/iOS only.\n   * On Android, `limit` is enforced by the system photo picker when available\n   * (Android 13+, or Android 11-12 with the Google Play system photo picker extension).\n   * Older Android versions may allow selecting more items than `limit`; results are\n   * truncated to `limit` before they are returned.\n   *\n   * @param options - Options for picking images\n   * @returns Promise that resolves with the picked images\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickImages({\n   *   limit: 10,\n   *   readData: false\n   * });\n   * console.log('Picked images:', result.files);\n   * ```\n   */\n  pickImages(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more videos from the gallery.\n   * Android/iOS only.\n   * On Android, `limit` is enforced by the system photo picker when available\n   * (Android 13+, or Android 11-12 with the Google Play system photo picker extension).\n   * Older Android versions may allow selecting more items than `limit`; results are\n   * truncated to `limit` before they are returned.\n   *\n   * @param options - Options for picking videos\n   * @returns Promise that resolves with the picked videos\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickVideos({\n   *   limit: 3,\n   *   skipTranscoding: true\n   * });\n   * console.log('Picked videos:', result.files);\n   * ```\n   */\n  pickVideos(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick one or more images or videos from the gallery.\n   * Android/iOS only.\n   *\n   * @param options - Options for picking media\n   * @returns Promise that resolves with the picked media files\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickMedia({\n   *   limit: 5,\n   *   readData: true\n   * });\n   * console.log('Picked media:', result.files);\n   * ```\n   */\n  pickMedia(options?: PickMediaOptions): Promise<PickFilesResult>;\n\n  /**\n   * Pick a directory from the device.\n   * Android/iOS only.\n   *\n   * @returns Promise that resolves with the picked directory path\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.pickDirectory();\n   * console.log('Selected directory:', result.path);\n   * ```\n   */\n  pickDirectory(): Promise<PickDirectoryResult>;\n\n  /**\n   * Convert a HEIC image to JPEG format.\n   * iOS only.\n   *\n   * @param options - Options for the conversion\n   * @returns Promise that resolves with the converted file path\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const result = await CapgoFilePicker.convertHeicToJpeg({\n   *   path: '/path/to/image.heic',\n   *   quality: 0.9\n   * });\n   * console.log('Converted file:', result.path);\n   * ```\n   */\n  convertHeicToJpeg(options: ConvertHeicToJpegOptions): Promise<ConvertHeicToJpegResult>;\n\n  /**\n   * Copy a file to a new location.\n   *\n   * @param options - Options for copying the file\n   * @returns Promise that resolves when the copy is complete\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * await CapgoFilePicker.copyFile({\n   *   from: '/source/file.pdf',\n   *   to: '/destination/file.pdf',\n   *   overwrite: true\n   * });\n   * ```\n   */\n  copyFile(options: CopyFileOptions): Promise<void>;\n\n  /**\n   * Check broad storage or media permission state.\n   * Picker-only flows should not gate `pickFiles()`, `pickImages()`,\n   * `pickVideos()`, or `pickMedia()` on this permission on Android 13+.\n   * Android only.\n   *\n   * @returns Promise that resolves with the permission status\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const status = await CapgoFilePicker.checkPermissions();\n   * console.log('Read permission:', status.readExternalStorage);\n   * ```\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request broad storage or media permissions.\n   * Do not request or declare `READ_MEDIA_IMAGES` or `READ_MEDIA_VIDEO`\n   * only to use picker APIs. Google Play allows these permissions only\n   * when picker alternatives are not sufficient for core app functionality.\n   * Use `@capgo/capacitor-file-picker` picker methods instead for\n   * user-selected file, image, or video access.\n   * Android only.\n   *\n   * @returns Promise that resolves with the permission status\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const status = await CapgoFilePicker.requestPermissions();\n   * if (status.readExternalStorage === 'granted') {\n   *   console.log('Permission granted');\n   * }\n   * ```\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Add a listener for the picker dismissed event.\n   * iOS only.\n   *\n   * @param eventName - The event name\n   * @param listenerFunc - The listener function\n   * @returns Promise that resolves with the listener handle\n   * @since 8.0.0\n   */\n  addListener(eventName: 'pickerDismissed', listenerFunc: PickerDismissedListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 8.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version.\n   *\n   * @returns Promise that resolves with the plugin version\n   * @since 8.0.0\n   * @example\n   * ```typescript\n   * const { version } = await CapgoFilePicker.getPluginVersion();\n   * console.log('Plugin version:', version);\n   * ```\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/ios/Sources/CapgoFilePickerPlugin/CapgoFilePickerPlugin.swift

@@ -11,7 +11,7 @@ import UniformTypeIdentifiers
  */
 @objc(CapgoFilePickerPlugin)
 public class CapgoFilePickerPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.2.6"
+    private let pluginVersion: String = "8.2.8"
     public let identifier = "CapgoFilePickerPlugin"
     public let jsName = "CapgoFilePicker"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-file-picker",
-  "version": "8.2.6",
+  "version": "8.2.8",
   "description": "File picker Capacitor plugin - Pick files, images, videos, and directories",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",