✨ feat: add more option for crop, ratio, default ratio for both platform

Author: baronha

docs/docs/CONFIG.mdx

@@ -81,16 +81,59 @@ Maximum number of videos allowed.
 - **Required**: No
 - **Platform**: iOS, Android
 
-### `crop`
+## Crop 🪚
 
 Configuration for image cropping functionality.
 
 - **Type**: object
 - **Default**: `undefined`
 - **Required**: No
 - **Platform**: iOS, Android
+
+### `circle`
+
+Enable circular crop mask.
+
+- **Type**: boolean
+- **Default**: `false`
+- **Required**: No
+- **Platform**: iOS, Android
+
+### `ratio`
+
+Aspect ratios for cropping.
+Android: Maximum: 4 items
+
+- **Type**: `array`
+- **Default**: `undefined`
+- **Required**: No
+- **Platform**: iOS, Android
 - **Properties**:
-  - `circle`: boolean - Enable circular crop mask
+  - `title`: string - Display title for the ratio (e.g., "Square", "16:9")
+  - `width`: number - Width value for the aspect ratio
+  - `height`: number - Height value for the aspect ratio
+
+### `defaultRatio`
+
+Default ratio to be selected when opening the crop interface.
+
+- **Type**: `object`
+- **Default**: `undefined`
+- **Required**: No
+- **Platform**: iOS, Android
+- **Properties**:
+  - `title`: string - Display title for the ratio (e.g., "Square", "16:9")
+  - `width`: number - Width value for the aspect ratio
+  - `height`: number - Height value for the aspect ratio
+
+### `freeStyle`
+
+Enable free style cropping.
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Required**: No
+- **Platform**: iOS, Android
 
 ---
 

docs/docs/CROP.mdx

@@ -0,0 +1,95 @@
+---
+id: crop
+title: Crop
+sidebar_label: Crop
+slug: /crop
+---
+
+## Usage
+
+```typescript
+import { openCropper } from '@baronha/react-native-multiple-image-picker'
+
+const cropConfig: CropConfig = {
+  // ...
+}
+
+const open = async () => {
+  try {
+    const response = await openCropper('file://path/to/image.jpg', cropConfig)
+    setImages(response)
+  } catch (e) {
+    // catch error for multiple image picker
+  }
+}
+```
+
+## CropConfig
+
+### `circle`
+
+Enable circular crop mask.
+
+- **Type**: boolean
+- **Default**: `false`
+- **Required**: No
+- **Platform**: iOS, Android
+
+### `ratio`
+
+Aspect ratios for cropping.
+Android: Maximum: 4 items
+
+- **Type**: `array`
+- **Default**: `undefined`
+- **Required**: No
+- **Platform**: iOS, Android
+- **Properties**:
+  - `title`: string - Display title for the ratio (e.g., "Square", "16:9")
+  - `width`: number - Width value for the aspect ratio
+  - `height`: number - Height value for the aspect ratio
+
+### `defaultRatio`
+
+Default ratio to be selected when opening the crop interface.
+
+- **Type**: `object`
+- **Default**: `undefined`
+- **Required**: No
+- **Platform**: iOS, Android
+- **Properties**:
+  - `title`: string - Display title for the ratio (e.g., "Square", "16:9")
+  - `width`: number - Width value for the aspect ratio
+  - `height`: number - Height value for the aspect ratio
+
+### `freeStyle`
+
+Enable free style cropping.
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Required**: No
+- **Platform**: iOS, Android
+
+### `language`
+
+- **Type**: `string`
+- **Default**: `false`
+- **Required**: No
+- **Platform**: iOS
+
+See [**Language**](/config/#language)
+
+## Result
+
+### `path`
+
+- **Type**: `string`
+
+### `width`
+
+- **Type**: `number`
+
+### `height`
+
+- **Type**: `number`

docs/sidebars.ts

@@ -23,6 +23,8 @@ const sidebars: SidebarsConfig = {
       },
       items: ['getting-started', 'usage', 'config', 'result'],
     },
+
+    'crop',
   ],
 }
 

ios/TopViewController.swift

@@ -0,0 +1,19 @@
+//
+//  UIViewController+TopViewController.swift
+//  Pods
+//
+//  Created by BAO HA on 11/12/24.
+//
+
+import UIKit
+
+extension UIViewController {
+    func topViewController() -> UIViewController? {
+        var controller = UIApplication.shared.keyWindow?.rootViewController
+        while let presentedViewController = controller?.presentedViewController {
+            controller = presentedViewController
+        }
+
+        return controller
+    }
+}