react-native-customizable-image-crop-picker 1.0.10 → 1.1.0

package/README.md

@@ -34,22 +34,15 @@ This library is developed and maintained by **Amit Kumar**.
 ## Features
 
 - Camera + gallery
-- Cropping with configurable aspect ratio (`cropWidth` / `cropHeight` or `aspectRatio`)
+- Cropping with configurable aspect ratio (`cropWidth` / `cropHeight`)
 - Circular crop (`circularCrop`)
 - Crop overlays: dimmed layer + grid (`dimmedLayerColor`, `cropGridEnabled`)
-- Native crop controls (rotate/reset + aspect ratio picker) via `showNativeCropControls`
+- Native crop controls/toolbar via `showNativeCropControls`
 - Output compression controls (`compressQuality`, `compressFormat`)
 - Optional base64 output (`includeBase64`)
 - Native full-screen crop UI customization from JS (header/footer/buttons/icons/layout)
 - Icons: remote (http/https) + local (`file://` / Android `content://`) + base64 + bundled assets (`require(...)`)
-- Events: `onCropStart`, `onCropEnd`, `onProgress` (Android base64 progress)
-
-## Roadmap / future features
-
-- **Multiple selection**: `multiple`, `maxFiles`
-- **Flip support** (to complement rotation)
-- **More aspect ratio presets** (configurable preset list)
-- **Richer errors + permission UX** (more granular error codes and clearer guidance)
+- Events: `onCropStart`, `onCropEnd`, `onProgress` (base64/encoding progress on Android + iOS)
 
 ## Demo
 
@@ -75,7 +68,7 @@ This library is developed and maintained by **Amit Kumar**.
 ## Installation
 
 ```bash
-npm install react-native-customizable-image-crop-picker
+npm install react-native-customizable-image-crop-picker --save
 ```
 
 or
@@ -87,9 +80,19 @@ yarn add react-native-customizable-image-crop-picker
 ### iOS
 
 ```bash
-cd ios && pod install && cd ..
+cd ios
+pod install
+cd ..
 ```
 
+#### Permissions (Info.plist)
+
+Add:
+
+- `NSCameraUsageDescription`
+- `NSPhotoLibraryUsageDescription`
+- `NSPhotoLibraryAddUsageDescription`
+
 #### If CocoaPods fails: TOCropViewController modular headers
 
 If `pod install` fails with a Swift modular headers error (TOCropViewController), add this to your **app** `ios/Podfile` (inside your app target):
@@ -140,8 +143,14 @@ If you use **remote icons** (`http/https`) for buttons:
 ## Quick start
 
 ```js
-import { openImageCropPicker } from 'react-native-customizable-image-crop-picker';
+import {
+  openImageCropPicker,
+} from 'react-native-customizable-image-crop-picker';
+```
+
+### Select from gallery
 
+```js
 const result = await openImageCropPicker({
   source: 'gallery',
   cropWidth: 1,
@@ -151,7 +160,7 @@ const result = await openImageCropPicker({
 console.log(result.path);
 ```
 
-### Camera
+### Select from camera
 
 ```js
 const result = await openImageCropPicker({
@@ -163,20 +172,33 @@ const result = await openImageCropPicker({
 
 ### Callbacks / progress (base64)
 
+`onProgress` emits **0..1** while doing the slow work of generating `base64` (only when `includeBase64: true`).
+
 ```js
 const result = await openImageCropPicker({
   source: 'gallery',
   includeBase64: true,
   onCropStart: () => console.log('crop started'),
-  onProgress: (p) => console.log('progress', p), // Android: real base64 progress
+  onProgress: (p) => console.log('progress', p), // 0..1 (Android: real streaming encode, iOS: best-effort)
   onCropEnd: (res, err) => console.log('crop end', { res, err }),
 });
 ```
 
 ### Examples (recommended)
 
-- [Basic Example](https://github.com/amitkumarcoding/imagecroppicker/blob/main/App.js)
-- [Full Example](https://github.com/amitkumarcoding/imagecroppicker/blob/main/packages/react-native-customizable-image-crop-picker/example/App.js)
+- [Example](https://github.com/amitkumarcoding/imagecroppicker/blob/main/packages/react-native-customizable-image-crop-picker/example/App.js)
+
+
+## Optional: JS UI chrome (`ImageCropPickerModal`)
+
+This package also exports a **fully customizable React Native modal** (`ImageCropPickerModal`) that you can use as your own UI layer (custom header/footer/buttons). It’s independent from the native crop flow.
+
+### Usage
+
+```js
+import React, { useState } from 'react';
+import { View, Button } from 'react-native';
+import { ImageCropPickerModal } from 'react-native-customizable-image-crop-picker/example/App.js)
 
 ## Icons (including SVG on Android)
 
@@ -216,7 +238,6 @@ Defaults shown below are the current native defaults.
 | aspectRatio | `{ width: number; height: number }` | No | - | Alternative to `cropWidth/cropHeight` |
 | freeStyleCropEnabled | boolean | No | `false` | If `true`, user can resize the crop box (free-style) |
 | circularCrop | boolean | No | `false` | Circular crop (iOS/Android) |
-| rotationEnabled | boolean | No | `false` | Enables rotation controls when `showNativeCropControls: true` |
 | cropGridEnabled | boolean | No | `false` | Show crop grid (iOS/Android) |
 | cropOverlayColor | string | No | - | Alias for `dimmedLayerColor` |
 | cropFrameColor | string | No | - | Android: crop frame color |
@@ -298,7 +319,7 @@ await openImageCropPicker({
 | statusBarColor | string | No | `#FFFFFF` (light), `#000000` (dark) | Status bar color |
 | statusBarStyle | `'dark' \| 'light'` | No | - | Android only: status bar icon/text color |
 | dimmedLayerColor | string | No | `#B3000000` (light), `#E0000000` (dark) | Dimmed overlay around crop box |
-| showNativeCropControls | boolean | No | `false` | Show native crop controls (rotation/aspect ratio toolbar) |
+| showNativeCropControls | boolean | No | `false` | Show native crop controls/toolbar |
 
 #### `showNativeCropControls` + `controlsPlacement`
 
@@ -307,7 +328,7 @@ When `showNativeCropControls: true`, the native crop toolbar is visible.
 - To avoid the footer covering the native toolbar, `showNativeCropControls` works **only with** `controlsPlacement: 'top'`.
 - If you pass `controlsPlacement: 'bottom'`, the library will **auto-force it to `'top'`**.
 
-### Platform-specific props / behavior
+## Platform-specific props / behavior
 
 - **Android only**
   - **`drawUnderStatusBar`**: edge-to-edge header under the status bar.
@@ -332,7 +353,26 @@ These are read from React Native styles and mapped into native values (subset on
 | headerStyle | `{ containerStyle?, titleStyle? }` | No | - | Supports `containerStyle.backgroundColor`, `titleStyle.color/fontSize/fontFamily` |
 | footerStyle | `{ containerStyle?, cancelButtonStyle?, uploadButtonStyle?, cancelTextStyle?, uploadTextStyle? }` | No | - | Supports background/border/textColor/fontSize/fontFamily/borderRadius subset |
 
-## Response object
+### JS-only props (ignored by `openImageCropPicker()`)
+
+These exist in exported types to support the `ImageCropPickerModal` component. They are currently **not used** by the native `openImageCropPicker()` flow (or its alias `open()`).
+
+| Prop | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| showHeader | boolean | No | - | `ImageCropPickerModal` only |
+| headerAlignment | `'left' \| 'center' \| 'right'` | No | - | `ImageCropPickerModal` only |
+| leftIcon | `React.ReactNode` | No | - | `ImageCropPickerModal` only |
+| rightIcon | `React.ReactNode` | No | - | `ImageCropPickerModal` only |
+| showLeftIcon | boolean | No | - | `ImageCropPickerModal` only |
+| showRightIcon | boolean | No | - | `ImageCropPickerModal` only |
+| showFooter | boolean | No | - | `ImageCropPickerModal` only |
+| cancelIcon | `React.ReactNode` | No | - | `ImageCropPickerModal` only |
+| uploadIcon | `React.ReactNode` | No | - | `ImageCropPickerModal` only |
+| overlayStyle | `CropperOverlayStyle` | No | - | `ImageCropPickerModal` only |
+| backgroundColor | string | No | - | `ImageCropPickerModal` only |
+| safeAreaEnabled | boolean | No | - | `ImageCropPickerModal` only |
+
+## Response Object
 
 | Property | Type | Description |
 | --- | --- | --- |
@@ -363,7 +403,7 @@ The library throws `CropPickerError` with a `code`:
 - Multiple selection options exist in types but **native multiple picking is not implemented yet**.
 - iOS grid/frame color customization is limited (rectangle grid uses the native overlay; circular grid uses a custom overlay).
 
-## Peer dependencies
+## Peer Dependencies
 
 | Package | Version |
 | --- | --- |

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -1,2 +1,2 @@
-#Fri Feb 20 12:30:37 IST 2026
+#Sun Feb 22 18:15:36 IST 2026
 com.rncustomizableimagecroppicker.react-native-customizable-image-crop-picker-main-6\:/xml/nativeimagepicker_file_paths.xml=/Users/amit.kumar/Documents/imageCropPicker/node_modules/react-native-customizable-image-crop-picker/android/build/intermediates/packaged_res/debug/packageDebugResources/xml/nativeimagepicker_file_paths.xml

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/jvm/kotlin/proto.tab.values.s

@@ -1 +1 @@
-�a�l�h�n�m�p�u�m�n�s
+�o�

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -1,2 +1,2 @@
-21
+9
 0

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/lookups.tab.values.s

@@ -1 +1 @@
-�V�P�
�{�~�o�i�U�X�v�w�l
+�N�e˓