@cleanuidev/react-native-scanner 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -2,9 +2,9 @@
 
 # 📱 React Native Scanner
 
-**A powerful, native barcode and QR code scanner for React Native**
+**A powerful, native barcode and QR code scanner for React Native with configurable target area scanning. Limit scan area and restrict scanning to a specific region.**
 
-![React Native Barcode Scanner Demo - QR Code and Barcode Scanning with Focus Area](./preview.gif)
+![React Native Barcode Scanner Demo - QR Code and Barcode Scanning with Target Area](./preview.gif)
 
 [![npm version](https://img.shields.io/npm/v/@cleanuidev/react-native-scanner?label=beta&color=blue)](https://www.npmjs.com/package/@cleanuidev/react-native-scanner)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -13,7 +13,7 @@
 
 **Built with ❤️ by [CleanUI.dev](https://cleanui.dev)**
 
-[Features](#-features) • [Installation](#-installation) • [Documentation](#-documentation)
+[Features](#-features) • [Why Choose](#-why-choose-this-library) • [Comparison](#-comparison-with-other-libraries) • [Quick Start](#-quick-start) • [Installation](#-installation) • [FAQ](#-frequently-asked-questions)
 
 </div>
 
@@ -26,16 +26,66 @@
 | Feature | Description |
 |:------:|:-----------|
 | 🚀 **Native Performance** | Built with CameraX & ML Kit (Android) and AVFoundation & Vision (iOS) for optimal performance |
-| 🎯 **Focus Area** | Configurable focus area with optional overlay for precise scanning |
+| 🎯 **Target Area Scanning** | Scan barcodes within configurable target areas for precise detection |
 | 🔦 **Torch Control** | Built-in flashlight/torch control |
 | 📊 **Multiple Formats** | Support for QR codes, Code128, Code39, EAN, UPC, and more |
-| 🎨 **Customizable** | Configurable focus area colors, barcode frame visualization, and scanning behavior |
+| 🎨 **Customizable** | Configurable target area colors, barcode frame visualization, and scanning behavior |
 | 📱 **Cross Platform** | Android & iOS support (new Fabric architecture) |
 
 </div>
 
 ---
 
+## 🎯 Why Choose @cleanuidev/react-native-scanner?
+
+- **🎯 Target Area Scanning**: Unlike other libraries, built-in support for limiting scan area, restricting scanning region, and scanning within configurable target areas for precise detection
+- **🚀 High Performance**: Uses native CameraX & ML Kit (Android) and AVFoundation & Vision (iOS) for optimal performance
+- **📱 New Architecture Ready**: Full support for React Native's new architecture (Fabric) on both platforms
+- **🔧 Easy Integration**: Simple API with sensible defaults - get started in minutes
+- **📊 Multiple Scan Strategies**: Process one, all, largest, or sorted barcodes with built-in strategies
+- **🎨 Highly Customizable**: Configurable target areas, barcode frames, and scanning behavior
+- **📦 Lightweight**: Minimal dependencies, optimized bundle size
+- **✅ Active Maintenance**: Regularly updated with bug fixes and new features
+
+---
+
+## 🆚 Comparison with Other Libraries
+
+| Feature | @cleanuidev/react-native-scanner | react-native-vision-camera | expo-camera |
+|---------|--------------------------------|---------------------------|-------------|
+| **Target Area Scanning / Limit Scan Area** | ✅ Built-in (limit scan area, restrict scan region) | ❌ Manual implementation | ❌ Manual implementation |
+| **New Architecture Support** | ✅ Full Fabric support | ✅ Yes | ✅ Yes |
+| **Native Performance** | ✅ CameraX + ML Kit / AVFoundation + Vision | ✅ Yes | ✅ Yes |
+| **Expo Support** | ✅ Dev builds | ✅ Dev builds | ✅ Expo Go |
+| **Barcode Frame Visualization** | ✅ Built-in | ⚠️ Custom | ❌ No |
+| **Multiple Scan Strategies** | ✅ 4 strategies (ONE, ALL, BIGGEST, SORT_BY_BIGGEST) | ⚠️ Custom | ❌ No |
+| **Setup Complexity** | ⭐⭐ Simple | ⭐⭐⭐ Moderate | ⭐ Easy |
+| **Bundle Size** | Small | Medium | Small |
+| **Active Maintenance** | ✅ Active | ✅ Active | ✅ Active |
+| **License** | MIT | MIT | MIT |
+| **Best For** | Barcode/QR scanning with target areas | General camera + scanning | Expo projects |
+
+> **💡 When to choose this library**: If you need barcode/QR code scanning with the ability to limit scan area, restrict scanning region, or scan within target areas, this library provides a simpler API and built-in features compared to general-purpose camera libraries.
+
+---
+
+## ⚡ Quick Start
+
+```bash
+npm install @cleanuidev/react-native-scanner
+```
+
+```tsx
+import ScannerView, { BarcodeFormat } from '@cleanuidev/react-native-scanner';
+
+<ScannerView
+  barcodeTypes={[BarcodeFormat.QR_CODE]}
+  onBarcodeScanned={(e) => console.log(e.nativeEvent)}
+/>
+```
+
+---
+
 ## 📦 Installation
 
 ### Install Beta Version
@@ -53,9 +103,9 @@ yarn add @cleanuidev/react-native-scanner@beta
 To install a specific beta version:
 
 ```bash
-npm install @cleanuidev/react-native-scanner@1.0.0-beta.1
+npm install @cleanuidev/react-native-scanner@1.0.0-beta.4
 # or
-yarn add @cleanuidev/react-native-scanner@1.0.0-beta.1
+yarn add @cleanuidev/react-native-scanner@1.0.0-beta.4
 ```
 
 > **Note**: Once the library reaches stable release (1.0.0), you can install it without the `@beta` tag:
@@ -67,7 +117,71 @@ yarn add @cleanuidev/react-native-scanner@1.0.0-beta.1
 
 ## Platform Setup
 
-### Android Setup
+### Expo Setup
+
+> **⚠️ Important**: This library uses native code and requires an **Expo development build**. It cannot run in Expo Go.
+
+#### Prerequisites
+
+- Expo SDK 53+ (recommended)
+- EAS CLI installed: `npm install -g eas-cli`
+- Expo development build configured
+
+#### Installation
+
+1. **Install the package:**
+
+```bash
+npx expo install @cleanuidev/react-native-scanner
+```
+
+2. **Configure app.json or app.config.js:**
+
+Add camera permissions directly to your Expo configuration:
+
+```json
+{
+  "expo": {
+    "ios": {
+      "infoPlist": {
+        "NSCameraUsageDescription": "This app needs camera access to scan barcodes and QR codes"
+      }
+    },
+    "android": {
+      "permissions": [
+        "android.permission.CAMERA",
+        "android.permission.WAKE_LOCK"
+      ]
+    }
+  }
+}
+```
+
+3. **Create a development build:**
+
+For iOS:
+```bash
+eas build --profile development --platform ios
+```
+
+For Android:
+```bash
+eas build --profile development --platform android
+```
+
+Or build locally:
+```bash
+npx expo run:ios
+# or
+npx expo run:android
+```
+
+5. **Install the development build on your device:**
+
+- For EAS builds: Download and install the build from the EAS dashboard
+- For local builds: The build will be installed automatically
+
+### Android Setup (Bare React Native)
 
 Add the following permissions to your `android/app/src/main/AndroidManifest.xml`:
 
@@ -79,7 +193,7 @@ Add the following permissions to your `android/app/src/main/AndroidManifest.xml`
 <uses-feature android:name="android.hardware.camera.flash" android:required="false" />
 ```
 
-### iOS Setup
+### iOS Setup (Bare React Native)
 
 For iOS, add camera usage description to your `ios/YourApp/Info.plist`:
 
@@ -129,7 +243,7 @@ const styles = StyleSheet.create({
 });
 ```
 
-### Scanner with Focus Area
+### Scanner with Target Area - Limit Scan Area Example
 
 ```tsx
 import React, { useState } from 'react';
@@ -139,12 +253,12 @@ import ScannerView, { BarcodeFormat } from '@cleanuidev/react-native-scanner';
 export default function FocusAreaScanner() {
   const [torchEnabled, setTorchEnabled] = useState(false);
   
-  // Focus area configuration
+  // Target area configuration - limit scan area to specific region
   const focusAreaConfig = {
-    enabled: true,        // Only scan barcodes within the focus area
-    showOverlay: true,    // Show the focus area overlay
-    size: 300,           // Size of the focus area (square)
-    color: '#00FF00',    // Color of the focus area border
+    enabled: true,        // Limit scan area - only scan barcodes within the target area
+    showOverlay: true,    // Show overlay outside the target area
+    size: 300,           // Size of the target area (square)
+    color: '#00FF00',    // Color of the target area border
   };
 
   // Barcode frames configuration
@@ -198,7 +312,7 @@ export default function FocusAreaScanner() {
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `barcodeTypes` | `BarcodeFormat[]` | `[BarcodeFormat.QR_CODE]` | Array of barcode formats to scan |
-| `focusArea` | `FocusAreaConfig` | - | Focus area configuration |
+| `focusArea` | `FocusAreaConfig` | - | Limit scan area and restrict scanning region - target area configuration for precise scanning |
 | `barcodeFrames` | `BarcodeFramesConfig` | - | Barcode frame visualization configuration |
 | `torch` | `boolean` | `false` | Enable/disable torch/flashlight |
 | `zoom` | `number` | `1.0` | Camera zoom level |
@@ -213,10 +327,10 @@ export default function FocusAreaScanner() {
 
 ```tsx
 type FocusAreaConfig = {
-  enabled?: boolean;        // Whether to restrict scanning to focus area only
-  size?: FrameSize;         // Size of the focus area
-  color?: string;           // Color of focus area border
-  showOverlay?: boolean;    // Whether to draw the focus area overlay
+  enabled?: boolean;        // Limit scan area - whether to restrict scanning to target area only
+  size?: FrameSize;         // Size of the target area (scan region limit)
+  color?: string;           // Color of target area border
+  showOverlay?: boolean;    // Whether to draw overlay outside the target area
 };
 ```
 
@@ -226,7 +340,7 @@ type FocusAreaConfig = {
 type BarcodeFramesConfig = {
   enabled?: boolean;        // Whether to draw frames around detected barcodes
   color?: string;           // Color of barcode frames
-  onlyInFocusArea?: boolean; // Only show frames for barcodes in focus area
+  onlyInFocusArea?: boolean; // Only show frames for barcodes in target area
 };
 ```
 
@@ -311,16 +425,16 @@ BarcodeFormat.ITF            // ITF (Interleaved 2 of 5)
 }
 ```
 
-## Focus Area Configuration
+## Target Area Configuration - Limit Scan Area
 
-The focus area feature provides precise control over where barcodes are scanned:
+The target area feature provides precise control over where barcodes are scanned. You can limit scan area, restrict scanning region, and confine barcode detection to a specific area on the screen:
 
-### Basic Focus Area
+### Basic Target Area
 
 ```tsx
 <ScannerView
   focusArea={{
-    showOverlay: true,    // Show visual overlay
+    showOverlay: true,    // Show overlay outside the target area
     size: 300,           // 300x300 pixel square
     color: '#00FF00',    // Green border
   }}
@@ -328,30 +442,65 @@ The focus area feature provides precise control over where barcodes are scanned:
 />
 ```
 
-### Focus Area with Restricted Scanning
+### Limit Scan Area - Restricted Scanning
+
+Limit scan area and restrict scanning to a specific region:
 
 ```tsx
 <ScannerView
   focusArea={{
-    enabled: true,        // Only scan within focus area
-    showOverlay: true,    // Show visual overlay
+    enabled: true,        // Limit scan area - only scan barcodes within the target area
+    showOverlay: true,    // Show overlay outside the target area
     size: 300,           // 300x300 pixel square
     color: '#00FF00',    // Green border
   }}
-  // Only scans within the focus area
+  // Only scans within the limited scan area
+/>
+```
+
+This configuration restricts scanning region and limits scan area to the defined target area only.
+
+### Rectangular Target Area
+
+```tsx
+<ScannerView
+  focusArea={{
+    enabled: true,
+    showOverlay: true,
+    size: { width: 300, height: 200 }, // Rectangular target area
+    color: '#00FF00',
+  }}
+/>
+```
+
+### Positioning Target Area with Coordinates
+
+You can position the target area anywhere on the screen using percentage-based coordinates (0-100):
+
+```tsx
+<ScannerView
+  focusArea={{
+    enabled: true,
+    showOverlay: true,
+    size: 300,
+    position: { x: 50, y: 50 }, // Center position (default)
+    color: '#00FF00',
+  }}
 />
 ```
 
-### Rectangular Focus Area
+**Example: Position target area at top center**
 
 ```tsx
 <ScannerView
   focusArea={{
     enabled: true,
     showOverlay: true,
-    size: { width: 300, height: 200 }, // Rectangular focus area
+    size: 250,
+    position: { x: 50, y: 25 }, // Top center
     color: '#00FF00',
   }}
+  onBarcodeScanned={handleBarcodeScanned}
 />
 ```
 
@@ -371,7 +520,7 @@ The scanner can display visual frames around detected barcodes to help users see
 />
 ```
 
-### Show Frames Only in Focus Area
+### Show Frames Only in Target Area
 
 ```tsx
 <ScannerView
@@ -383,7 +532,7 @@ The scanner can display visual frames around detected barcodes to help users see
   barcodeFrames={{
     enabled: true,
     color: '#FF0000',
-    onlyInFocusArea: true, // Only show frames for barcodes in focus area
+    onlyInFocusArea: true, // Only show frames for barcodes in target area
   }}
 />
 ```
@@ -551,6 +700,52 @@ const requestCameraPermission = async () => {
 
 See the `example/` directory for complete working examples, including the "New Props Example" that demonstrates the updated prop structure.
 
+## ❓ Frequently Asked Questions
+
+### Is this library compatible with Expo?
+Yes! This library works with Expo development builds (SDK 53+). It does not work with Expo Go due to native code requirements. See the [Expo Setup](#expo-setup) section for detailed instructions.
+
+### Does it support React Native's new architecture?
+Yes! Full support for Fabric (new architecture) on both Android and iOS. The library is built with the new architecture in mind.
+
+### How does it compare to react-native-vision-camera?
+This library focuses specifically on barcode/QR code scanning with built-in target area support and multiple scan strategies. `react-native-vision-camera` is a general-purpose camera library that requires more setup for barcode scanning. If you only need barcode scanning, this library provides a simpler API and built-in features.
+
+### Can I limit the scan area or restrict scanning to a specific region?
+Yes! You can limit the scan area and restrict scanning to a specific region. The target area is optional. By default, you can scan the entire camera view. Set `focusArea.enabled: true` to limit scan area and restrict scanning to a specific region only.
+
+### Is it possible to limit scan area?
+Yes! This library provides built-in support for limiting scan area. You can restrict scanning to a specific region using the `focusArea` prop with `enabled: true`. This allows you to limit scan area to a defined region on the screen, perfect for precise barcode detection.
+
+### Can I scan barcodes outside the target area?
+Yes! The target area is optional. By default, you can scan the entire camera view. Set `focusArea.enabled: true` to restrict scanning to a specific area.
+
+### What barcode formats are supported?
+QR Code, Code128, Code39, EAN-13, EAN-8, UPC-A, UPC-E, Data Matrix, PDF417, Aztec, and ITF (Interleaved 2 of 5). See the [Barcode Formats](#barcode-formats) section for the complete list.
+
+### Is it production-ready?
+The library is currently in beta (1.0.0-beta.4) but is stable and actively maintained. Production use is recommended with proper testing. We're working towards a stable 1.0.0 release.
+
+### Does it work with React Native 0.83+?
+Yes! The library supports React Native 0.83 and newer versions, including full support for the new architecture.
+
+### Can I customize the target area appearance?
+Yes! You can customize the target area size, position, color, and overlay. See the [Target Area Configuration](#target-area-configuration) section for details.
+
+### How do I handle multiple barcodes?
+The library supports multiple scan strategies: process all barcodes, only the first one, only the largest, or all sorted by size. See the [Barcode Scan Strategy](#barcode-scan-strategy) section.
+
+## 💼 Use Cases
+
+- **Retail & E-commerce**: Product barcode scanning for inventory and checkout (limit scan area for precise product detection)
+- **Inventory Management**: Stock tracking and warehouse management systems (restrict scan region for accurate scanning)
+- **Event Management**: QR code ticket scanning and attendee check-in (limit scan area for ticket validation)
+- **Authentication**: QR code-based login and two-factor authentication (restrict scanning region for security)
+- **Payment Systems**: QR code payment processing and transaction scanning (limit scan area for payment codes)
+- **Document Management**: Document barcode scanning and tracking (restrict scan region for document processing)
+- **Asset Tracking**: QR/barcode-based asset management systems (limit scan area for asset identification)
+- **Healthcare**: Medical device and medication barcode scanning (restrict scanning region for medical accuracy)
+
 ## Contributing
 
 1. Fork the repository
@@ -567,6 +762,19 @@ For bug reports, feature requests, and general questions:
 - 📝 [Open an issue](https://github.com/cleanui-dev/react-native-scanner/issues) on GitHub
 - 💬 Use GitHub Discussions for questions and community help
 
+### Support the Maintainer
+
+If you find this library useful, consider supporting the maintainer/developer directly through donations:
+
+- 💰 [Donate via PayPal](https://paypal.me/rahulgwebdev) - Support the maintainer directly and help keep this project maintained and improved
+- ⭐ Star the repository - Show your appreciation and help others discover this library
+
+**Your donations help:**
+- 🐛 Maintain and fix bugs
+- ✨ Add new features and improvements
+- 📚 Keep documentation up to date
+- ⚡ Ensure long-term sustainability of the project
+
 ### Commercial Support & Consulting
 
 Need professional help with implementation, custom development, or enterprise support?

package/Scanner.podspec

@@ -11,7 +11,7 @@ Pod::Spec.new do |s|
   s.authors      = package["author"]
 
   s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://github.com/rahulgwebdev/react-native-scanner.git", :tag => "#{s.version}" }
+  s.source       = { :git => "https://github.com/cleanuidev/react-native-scanner.git", :tag => "#{s.version}" }
 
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.private_header_files = "ios/**/*.h"

package/android/src/main/java/com/scanner/ScannerView.kt

@@ -222,6 +222,7 @@ class ScannerView : FrameLayout {
 
     if (!hasCameraPermission()) {
       Log.e(TAG, "Camera permission not granted")
+      emitOnScannerError("Camera permission not granted", "CAMERA_PERMISSION_DENIED")
       return
     }
 
@@ -331,8 +332,16 @@ class ScannerView : FrameLayout {
       // Set up auto-focus on frame center (if focus area is enabled)
       setupAutoFocusOnFrame()
 
+      // Emit onLoad event after camera is successfully started
+      emitOnLoadEvent(success = true)
+
     } catch (exc: Exception) {
       Log.e(TAG, "Use case binding failed", exc)
+      // Emit onScannerError event for camera initialization failure
+      emitOnScannerError(
+        error = exc.message ?: "Camera binding failed",
+        code = "CAMERA_INITIALIZATION_FAILED"
+      )
     }
   }
 
@@ -450,12 +459,14 @@ class ScannerView : FrameLayout {
                 // Debounce: Prevent rapid duplicate emissions
                 // If we've emitted recently (within debounce interval), skip this emission
                 // This prevents multiple alerts when pauseScanning is set but detection callbacks are still in flight
+                Log.d(TAG, "📊 Debounce check: interval=${barcodeEmissionDebounceInterval}ms, timeSinceLast=${timeSinceLastEmission}ms")
                 if (timeSinceLastEmission < barcodeEmissionDebounceInterval) {
-                  Log.d(TAG, "⏭️ Skipping barcode emission (debounced, last emission was ${timeSinceLastEmission}ms ago)")
+                  Log.d(TAG, "⏭️ Skipping barcode emission (debounced, last emission was ${timeSinceLastEmission}ms ago, interval=${barcodeEmissionDebounceInterval}ms)")
                   return@addOnSuccessListener
                 }
 
                 lastBarcodeEmissionTime = currentTime
+                Log.d(TAG, "✅ Emitting barcode (interval=${barcodeEmissionDebounceInterval}ms, timeSinceLast=${timeSinceLastEmission}ms)")
 
                 // Create array of barcode events
                 val barcodeEvents = Arguments.createArray()
@@ -502,6 +513,11 @@ class ScannerView : FrameLayout {
             }
           }
           .addOnFailureListener { e ->
+            // Emit onScannerError event for barcode detection failure
+            emitOnScannerError(
+              error = e.message ?: "Barcode detection failed",
+              code = "BARCODE_DETECTION_FAILED"
+            )
             Log.e(TAG, "Barcode scanning failed", e)
           }
           .addOnCompleteListener {
@@ -613,8 +629,48 @@ class ScannerView : FrameLayout {
 
   fun setBarcodeEmissionInterval(intervalSeconds: Double) {
     // Convert seconds to milliseconds, ensure non-negative
+    val previousInterval = barcodeEmissionDebounceInterval
+    Log.d(TAG, "📊 [ScannerView] setBarcodeEmissionInterval called with: ${intervalSeconds}s")
     barcodeEmissionDebounceInterval = max(0, (intervalSeconds * 1000).toLong())
-    Log.d(TAG, "Barcode emission interval set to: ${barcodeEmissionDebounceInterval}ms")
+    Log.d(TAG, "📊 ScannerView.setBarcodeEmissionInterval: ${intervalSeconds}s -> ${barcodeEmissionDebounceInterval}ms (was ${previousInterval}ms)")
+    
+    if (barcodeEmissionDebounceInterval == 0L) {
+      Log.d(TAG, "📊 ⚠️ Debouncing DISABLED (interval = 0ms)")
+    } else {
+      Log.d(TAG, "📊 ✅ Debouncing ENABLED (interval = ${barcodeEmissionDebounceInterval}ms)")
+    }
+  }
+
+  private fun emitOnLoadEvent(success: Boolean, error: String? = null) {
+    val ctx = reactContext
+    if (ctx is ThemedReactContext) {
+      ctx.runOnUiQueueThread {
+        val eventData = Arguments.createMap().apply {
+          putBoolean("success", success)
+          if (error != null) {
+            putString("error", error)
+          }
+        }
+        ctx.getJSModule(RCTEventEmitter::class.java)
+          .receiveEvent(this@ScannerView.id, "onLoad", eventData)
+        Log.d(TAG, "✅ onLoad event emitted: success=$success, error=$error")
+      }
+    }
+  }
+
+  private fun emitOnScannerError(error: String, code: String) {
+    val ctx = reactContext
+    if (ctx is ThemedReactContext) {
+      ctx.runOnUiQueueThread {
+        val eventData = Arguments.createMap().apply {
+          putString("error", error)
+          putString("code", code)
+        }
+        ctx.getJSModule(RCTEventEmitter::class.java)
+          .receiveEvent(this@ScannerView.id, "onScannerError", eventData)
+        Log.d(TAG, "✅ onScannerError event emitted: code=$code, error=$error")
+      }
+    }
   }
 
   fun setBarcodeScanStrategy(strategy: String) {

package/android/src/main/java/com/scanner/ScannerViewManager.kt

@@ -6,12 +6,20 @@ import com.facebook.react.bridge.*
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.uimanager.SimpleViewManager
 import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewManagerDelegate
 import com.facebook.react.uimanager.annotations.ReactProp
 import com.facebook.react.uimanager.events.RCTModernEventEmitter
+import com.facebook.react.viewmanagers.ScannerViewManagerInterface
+import com.facebook.react.viewmanagers.ScannerViewManagerDelegate
 
 @ReactModule(name = ScannerViewManager.NAME)
-class ScannerViewManager : SimpleViewManager<ScannerView>() {
+class ScannerViewManager : SimpleViewManager<ScannerView>(),
+  ScannerViewManagerInterface<ScannerView> {
+  private val mDelegate: ViewManagerDelegate<ScannerView> = ScannerViewManagerDelegate(this)
 
+  override fun getDelegate(): ViewManagerDelegate<ScannerView> {
+    return mDelegate
+  }
   override fun getName(): String {
     return NAME
   }
@@ -22,7 +30,7 @@ class ScannerViewManager : SimpleViewManager<ScannerView>() {
 
   // Barcode configuration
   @ReactProp(name = "barcodeTypes")
-  fun setBarcodeTypes(view: ScannerView?, types: ReadableArray?) {
+  override fun setBarcodeTypes(view: ScannerView?, types: ReadableArray?) {
     if (types != null) {
       val typeList = mutableListOf<String>()
       for (i in 0 until types.size()) {
@@ -36,33 +44,33 @@ class ScannerViewManager : SimpleViewManager<ScannerView>() {
 
   // Focus area configuration
   @ReactProp(name = "focusArea")
-  fun setFocusArea(view: ScannerView?, focusArea: ReadableMap?) {
+  override fun setFocusArea(view: ScannerView?, focusArea: ReadableMap?) {
     if (focusArea != null) {
-      val enabled = focusArea.getBoolean("enabled") ?: false
-      val showOverlay = focusArea.getBoolean("showOverlay") ?: false
+      val enabled = focusArea.getBoolean("enabled")
+      val showOverlay = focusArea.getBoolean("showOverlay")
       val borderColor = focusArea.getString("borderColor")
       val tintColor = focusArea.getString("tintColor")
       val size = focusArea.getDynamic("size")
       val position = focusArea.getMap("position")
-      
+
       // Set focus area properties
       view?.setFocusAreaEnabled(enabled)
       view?.setEnableFrame(showOverlay)
-      
+
       if (borderColor != null) {
         view?.setBorderColor(borderColor)
       }
-      
+
       if (tintColor != null) {
         view?.setTintColor(tintColor)
       }
-      
+
       if (position != null) {
         val x = position.getDouble("x").toFloat()
         val y = position.getDouble("y").toFloat()
         view?.setPosition(x, y)
       }
-      
+
       if (size != null) {
         val frameSize: FrameSize = when {
           size.type == ReadableType.Number -> FrameSize.Square(size.asInt())
@@ -76,40 +84,40 @@ class ScannerViewManager : SimpleViewManager<ScannerView>() {
         }
         view?.setFrameSize(frameSize)
       }
-      
+
       Log.d("ScannerViewManager", "Focus area configured: enabled=$enabled, showOverlay=$showOverlay, borderColor=$borderColor, tintColor=$tintColor, position=$position")
     }
   }
 
   // Barcode frames configuration
   @ReactProp(name = "barcodeFrames")
-  fun setBarcodeFrames(view: ScannerView?, barcodeFrames: ReadableMap?) {
+  override fun setBarcodeFrames(view: ScannerView?, barcodeFrames: ReadableMap?) {
     if (barcodeFrames != null) {
       val enabled = barcodeFrames.getBoolean("enabled") ?: false
       val color = barcodeFrames.getString("color")
       val onlyInFocusArea = barcodeFrames.getBoolean("onlyInFocusArea") ?: false
-      
+
       // Set barcode frames properties
       view?.setBarcodeFramesEnabled(enabled)
       view?.setShowBarcodeFramesOnlyInFrame(onlyInFocusArea)
-      
+
       if (color != null) {
         view?.setBarcodeFramesColor(color)
       }
-      
+
       Log.d("ScannerViewManager", "Barcode frames configured: enabled=$enabled, onlyInFocusArea=$onlyInFocusArea, color=$color")
     }
   }
 
   // Torch control
   @ReactProp(name = "torch")
-  fun setTorch(view: ScannerView?, enabled: Boolean?) {
-    view?.setTorch(enabled ?: false)
+  override fun setTorch(view: ScannerView, value: Boolean) {
+    view.setTorch(value)
   }
 
   // Event handlers
   @ReactProp(name = "onBarcodeScanned")
-  fun setOnBarcodeScanned(view: ScannerView?, onBarcodeScanned: Boolean?) {
+   fun setOnBarcodeScanned(view: ScannerView?, onBarcodeScanned: Boolean?) {
     // This prop is used to register the event handler
     // The actual event emission happens in ScannerView.processImage()
     Log.d("ScannerViewManager", "onBarcodeScanned event handler registered")
@@ -128,33 +136,49 @@ class ScannerViewManager : SimpleViewManager<ScannerView>() {
   }
 
   @ReactProp(name = "zoom")
-  fun setZoom(view: ScannerView?, zoom: Double) {
+  override fun setZoom(view: ScannerView?, zoom: Double) {
     view?.setZoom(zoom.toFloat())
   }
 
   @ReactProp(name = "pauseScanning")
-  fun setPauseScanning(view: ScannerView?, pause: Boolean?) {
-    if (pause == true) {
-      view?.pauseScanning()
+  override fun setPauseScanning(view: ScannerView, value: Boolean) {
+    if (value) {
+      view.pauseScanning()
     } else {
-      view?.resumeScanning()
+      view.resumeScanning()
     }
   }
 
   @ReactProp(name = "barcodeScanStrategy")
-  fun setBarcodeScanStrategy(view: ScannerView?, strategy: String?) {
+  override fun setBarcodeScanStrategy(view: ScannerView?, strategy: String?) {
     view?.setBarcodeScanStrategy(strategy ?: "ALL")
   }
 
   @ReactProp(name = "keepScreenOn")
-  fun setKeepScreenOn(view: ScannerView?, keepOn: Boolean?) {
-    view?.setKeepScreenOnEnabled(keepOn ?: true)
+  override fun setKeepScreenOn(view: ScannerView, value: Boolean) {
+    view.setKeepScreenOnEnabled(value)
   }
 
   @ReactProp(name = "barcodeEmissionInterval")
-  fun setBarcodeEmissionInterval(view: ScannerView?, interval: Double) {
-    // Use 0.5 as default if interval is 0 or negative (React Native may pass 0 for undefined)
-    val actualInterval = if (interval > 0) interval else 0.5
+  override fun setBarcodeEmissionInterval(view: ScannerView?, interval: Double) {
+    Log.d("ScannerViewManager", "📊 [@ReactProp] barcodeEmissionInterval received: $interval")
+
+    // WithDefault<Double, 0.5> in TypeScript means codegen handles the default automatically
+    // If negative, clamp to 0 (minimum value)
+    // If 0, disable debouncing
+    // Otherwise, use the provided value (0 or positive)
+    val actualInterval = if (interval < 0) {
+      Log.d("ScannerViewManager", "📊 Clamping negative interval ($interval) to 0.0 (minimum)")
+      0.0 // Negative values clamped to 0 (minimum)
+    } else {
+      if (interval == 0.0) {
+        Log.d("ScannerViewManager", "📊 Using interval: ${interval}s (explicitly set to 0, will disable debouncing)")
+      } else {
+        Log.d("ScannerViewManager", "📊 Using interval: ${interval}s")
+      }
+      interval // Use provided value (0 or positive)
+    }
+    Log.d("ScannerViewManager", "📊 Final interval to set: ${actualInterval}s")
     view?.setBarcodeEmissionInterval(actualInterval)
   }
 
@@ -169,7 +193,16 @@ class ScannerViewManager : SimpleViewManager<ScannerView>() {
         "bubbled" to "onBarcodeScanned"
       )
     )
-    // Add more events here if needed
+    map["onLoad"] = mapOf(
+      "phasedRegistrationNames" to mapOf(
+        "bubbled" to "onLoad"
+      )
+    )
+    map["onScannerError"] = mapOf(
+      "phasedRegistrationNames" to mapOf(
+        "bubbled" to "onScannerError"
+      )
+    )
     return map
   }
 }

package/ios/CameraManager.swift

@@ -47,6 +47,9 @@ class CameraManager: NSObject, CameraControlProtocol {
     private var desiredTorchLevel: Float = 1.0
     private var desiredZoomLevel: CGFloat = 1.0
     
+    /// Observer for subject area change (refocus when scene changes, like native Camera app)
+    private var subjectAreaObserver: NSObjectProtocol?
+    
     // MARK: - Initialization
     
     override init() {
@@ -81,9 +84,10 @@ class CameraManager: NSObject, CameraControlProtocol {
                     self.isSessionRunning = true
                 }
 
-                // Apply any desired settings now that the session/device exists
+                // Apply settings after session is running (native camera app behavior)
                 self.applyZoom()
                 self.applyTorch()
+                self.setupFocusAndExposure()
                 
                 DispatchQueue.main.async {
                     self.delegate?.cameraManagerDidStart(self)
@@ -94,6 +98,7 @@ class CameraManager: NSObject, CameraControlProtocol {
     
     /// Stop the camera session
     func stopCamera() {
+        unregisterSubjectAreaChangeObserver()
         sessionQueue.async { [weak self] in
             guard let self = self, self.isSessionRunning else { return }
             
@@ -126,6 +131,17 @@ class CameraManager: NSObject, CameraControlProtocol {
         }
     }
     
+    /// Set focus and exposure point of interest for better scanning of small barcodes/QR codes.
+    /// Call this after the camera has started (e.g. when focus area is known).
+    /// - Parameters:
+    ///   - normalizedX: X in range 0...1 (0.5 = center)
+    ///   - normalizedY: Y in range 0...1 (0.5 = center)
+    func setFocusPointOfInterest(normalizedX: CGFloat, normalizedY: CGFloat) {
+        sessionQueue.async { [weak self] in
+            self?.applyFocusPointOfInterest(normalizedX: normalizedX, normalizedY: normalizedY)
+        }
+    }
+    
     /// Check if torch is available
     /// - Returns: True if torch is available
     func isTorchAvailable() -> Bool {
@@ -144,7 +160,14 @@ class CameraManager: NSObject, CameraControlProtocol {
     /// Configure the capture session
     private func configureCaptureSession() {
         captureSession.beginConfiguration()
-        captureSession.sessionPreset = .high
+        // Prefer full HD for sharper small barcode/QR capture when supported (e.g. iPhone 15)
+        if captureSession.canSetSessionPreset(.hd1920x1080) {
+            captureSession.sessionPreset = .hd1920x1080
+            print("[CameraManager] Session preset: hd1920x1080")
+        } else {
+            captureSession.sessionPreset = .high
+            print("[CameraManager] Session preset: high")
+        }
         
         // Setup camera input
         guard setupCameraInput() else {
@@ -178,7 +201,16 @@ class CameraManager: NSObject, CameraControlProtocol {
             print("[CameraManager] No camera device available")
             return false
         }
-        
+
+        // Bias autofocus towards near objects (ideal for barcodes/QR codes held close to camera).
+        // Must be configured before adding the device to an active session to be effective.
+        lockDeviceForConfiguration(device) { device in
+            if device.isAutoFocusRangeRestrictionSupported {
+                device.autoFocusRangeRestriction = .near
+                print("[CameraManager] ✅ Auto-focus range restriction set to NEAR")
+            }
+        }
+
         do {
             let input = try AVCaptureDeviceInput(device: device)
             
@@ -261,6 +293,103 @@ class CameraManager: NSObject, CameraControlProtocol {
         }
     }
     
+    // MARK: - Focus and Exposure (for small barcode/QR scanning)
+    
+    /// Enable continuous autofocus and continuous auto-exposure (native Camera app behavior).
+    /// Applied after the session is running so the device is fully active.
+    private func setupFocusAndExposure() {
+        guard let device = currentDevice else { return }
+        lockDeviceForConfiguration(device) { device in
+            // Continuous autofocus: camera keeps refocusing so small codes stay sharp
+            if device.isFocusModeSupported(.continuousAutoFocus) {
+                device.focusMode = .continuousAutoFocus
+                print("[CameraManager] ✅ Continuous autofocus enabled")
+            } else if device.isFocusModeSupported(.autoFocus) {
+                device.focusMode = .autoFocus
+                print("[CameraManager] ✅ Auto focus enabled (continuous not supported)")
+            }
+            // Continuous auto-exposure: adapts to lighting for better small code readability
+            if device.isExposureModeSupported(.continuousAutoExposure) {
+                device.exposureMode = .continuousAutoExposure
+                print("[CameraManager] ✅ Continuous auto-exposure enabled")
+            }
+            // Default focus point at center (device coords); overridden by setFocusPointOfInterest
+            let center = CGPoint(x: 0.5, y: 0.5)
+            if device.isFocusPointOfInterestSupported && device.isFocusModeSupported(.continuousAutoFocus) {
+                device.focusPointOfInterest = center
+            }
+            if device.isExposurePointOfInterestSupported && device.isExposureModeSupported(.continuousAutoExposure) {
+                device.exposurePointOfInterest = center
+            }
+            // Native Camera behavior: refocus when scene changes (lighting, movement, etc.)
+            if device.isSubjectAreaChangeMonitoringEnabled == false {
+                device.isSubjectAreaChangeMonitoringEnabled = true
+                print("[CameraManager] ✅ Subject area change monitoring enabled")
+            }
+        }
+        // Observe scene changes and re-apply continuous focus (like native Camera app)
+        registerSubjectAreaChangeObserverIfNeeded()
+    }
+    
+    /// When the scene changes, re-apply continuous focus so the camera refocuses.
+    private func registerSubjectAreaChangeObserverIfNeeded() {
+        guard subjectAreaObserver == nil else { return }
+        subjectAreaObserver = NotificationCenter.default.addObserver(
+            forName: .AVCaptureDeviceSubjectAreaDidChange,
+            object: currentDevice,
+            queue: .main
+        ) { [weak self] _ in
+            self?.sessionQueue.async {
+                self?.reapplyContinuousFocus()
+            }
+        }
+        print("[CameraManager] Subject area change observer registered")
+    }
+    
+    private func unregisterSubjectAreaChangeObserver() {
+        if let observer = subjectAreaObserver {
+            NotificationCenter.default.removeObserver(observer)
+            subjectAreaObserver = nil
+            print("[CameraManager] Subject area change observer removed")
+        }
+    }
+    
+    /// Re-apply continuous focus and exposure (called when scene changes).
+    private func reapplyContinuousFocus() {
+        guard let device = currentDevice else { return }
+        lockDeviceForConfiguration(device) { device in
+            if device.isFocusModeSupported(.continuousAutoFocus) {
+                device.focusMode = .continuousAutoFocus
+            }
+            if device.isExposureModeSupported(.continuousAutoExposure) {
+                device.exposureMode = .continuousAutoExposure
+            }
+        }
+    }
+    
+    /// Set focus and exposure point of interest (e.g. center of focus area) so the camera
+    /// prioritizes that region. The inputs are expected to already be in device coordinates
+    /// (0,0 = top-left, 1,1 = bottom-right) as returned by AVCaptureVideoPreviewLayer helpers.
+    private func applyFocusPointOfInterest(normalizedX: CGFloat, normalizedY: CGFloat) {
+        guard let device = currentDevice else { return }
+        let devicePoint = CGPoint(x: normalizedX, y: normalizedY)
+        lockDeviceForConfiguration(device) { device in
+            if device.isFocusPointOfInterestSupported {
+                device.focusPointOfInterest = devicePoint
+                if device.isFocusModeSupported(.continuousAutoFocus) {
+                    device.focusMode = .continuousAutoFocus
+                }
+            }
+            if device.isExposurePointOfInterestSupported {
+                device.exposurePointOfInterest = devicePoint
+                if device.isExposureModeSupported(.continuousAutoExposure) {
+                    device.exposureMode = .continuousAutoExposure
+                }
+            }
+            print("[CameraManager] Focus point of interest set (view: \(normalizedX), \(normalizedY) → device: \(devicePoint.x), \(devicePoint.y))")
+        }
+    }
+    
     /// Setup video output
     /// - Returns: True if setup successful
     @discardableResult
@@ -296,12 +425,18 @@ class CameraManager: NSObject, CameraControlProtocol {
     /// Get the default camera device (back camera)
     /// - Returns: The camera device or nil
     private func getDefaultCameraDevice() -> AVCaptureDevice? {
-        // Prefer a BACK camera that supports torch.
+        // Prefer the physical wide‑angle back camera for barcode scanning.
+        // Using the virtual multi‑camera (e.g. builtInTripleCamera) on newer iPhones
+        // can cause macro / close‑range focus issues for small barcodes.
+        if let wideBack = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back) {
+            print("[CameraManager] ✅ Using back wide‑angle camera: \(wideBack.localizedName)")
+            return wideBack
+        }
+
+        // Fallback: look for any other back camera with torch (dual, telephoto, etc.)
         let deviceTypes: [AVCaptureDevice.DeviceType] = [
-            .builtInTripleCamera,
             .builtInDualCamera,
             .builtInDualWideCamera,
-            .builtInWideAngleCamera,
             .builtInTelephotoCamera,
             .builtInUltraWideCamera,
         ]
@@ -313,7 +448,7 @@ class CameraManager: NSObject, CameraControlProtocol {
         )
 
         if let torchBack = discovery.devices.first(where: { $0.hasTorch }) {
-            print("[CameraManager] ✅ Using back camera with torch: \(torchBack.localizedName)")
+            print("[CameraManager] ✅ Using fallback back camera with torch: \(torchBack.localizedName)")
             return torchBack
         }
 
@@ -371,6 +506,7 @@ class CameraManager: NSObject, CameraControlProtocol {
     }
     
     deinit {
+        unregisterSubjectAreaChangeObserver()
         stopCamera()
         print("[CameraManager] Deinitialized")
     }

package/ios/ScannerView.mm

@@ -263,7 +263,11 @@ using namespace facebook::react;
 
     // Barcode emission interval
     if (oldViewProps.barcodeEmissionInterval != newViewProps.barcodeEmissionInterval) {
-        NSNumber *intervalValue = @(newViewProps.barcodeEmissionInterval);
+        // Handle negative values (clamp to 0)
+        double interval = newViewProps.barcodeEmissionInterval;
+        double actualInterval = interval < 0 ? 0.0 : interval;
+        
+        NSNumber *intervalValue = @(actualInterval);
         if ([_scannerImpl respondsToSelector:@selector(setBarcodeEmissionInterval:)]) {
             [_scannerImpl performSelector:@selector(setBarcodeEmissionInterval:) withObject:intervalValue];
         }

package/ios/ScannerViewImpl.swift

@@ -146,6 +146,8 @@ class ScannerViewImpl: UIView {
     @objc func configureFocusArea(_ config: [String: Any]) {
         focusAreaConfig = FocusAreaConfig.from(dict: config)
         focusAreaOverlay.updateFocusArea(config: focusAreaConfig)
+        // Update camera focus point to focus area center for better small barcode scanning
+        setupFocusPointOfInterest()
         print("[ScannerViewImpl] Focus area configured")
     }
     
@@ -520,10 +522,38 @@ extension ScannerViewImpl: CameraManagerDelegate {
             // Check bounds multiple times with delay to catch layout
             self.attemptToAddPreviewLayer(attempt: 0)
             
+            // Set focus point of interest (center or focus area center) for better small barcode/QR scanning
+            self.setupFocusPointOfInterest()
+            
             self.emitLoadEvent(success: true)
         }
     }
     
+    /// Set the camera focus point of interest to the focus area center (or screen center)
+    /// so continuous autofocus prioritizes that region and small barcodes/QR codes stay sharp.
+    private func setupFocusPointOfInterest() {
+        guard bounds.width > 0, bounds.height > 0 else { return }
+        guard let previewLayer = self.previewLayer else { return }
+
+        // 1) Get center point in view coordinates (either focus area center or view center)
+        let centerPointInView: CGPoint
+        if focusAreaConfig.enabled, let focusRect = focusAreaOverlay.getFocusAreaFrame() {
+            centerPointInView = CGPoint(x: focusRect.midX, y: focusRect.midY)
+        } else {
+            centerPointInView = CGPoint(x: bounds.midX, y: bounds.midY)
+        }
+
+        // 2) Convert from view/layer space into device focus coordinates using AVFoundation helper
+        let pointInLayer = previewLayer.convert(centerPointInView, from: self.layer)
+        let devicePoint = previewLayer.captureDevicePointConverted(fromLayerPoint: pointInLayer)
+
+        // 3) Pass device-normalized coordinates (0,0 top-left, 1,1 bottom-right) to camera manager
+        cameraManager.setFocusPointOfInterest(
+            normalizedX: devicePoint.x,
+            normalizedY: devicePoint.y
+        )
+    }
+    
     private func attemptToAddPreviewLayer(attempt: Int) {
         guard !isPreviewLayerAdded else { return }
         

package/lib/module/ScannerViewNativeComponent.ts

@@ -6,6 +6,7 @@ import {
 import type {
   DirectEventHandler,
   Double,
+  WithDefault,
 } from 'react-native/Libraries/Types/CodegenTypesNamespace';
 
 // Define codegen types locally (no longer exported from react-native in 0.83)
@@ -111,7 +112,7 @@ export interface NativeProps extends ViewProps {
    * Prevents rapid duplicate detections. Set to 0 to disable debouncing.
    * @default 0.5
    */
-  barcodeEmissionInterval?: Double;
+  barcodeEmissionInterval?: WithDefault<Double, 0.5>;
 
   onBarcodeScanned?: DirectEventHandler<BarcodeScannedEventPayload>;
   onScannerError?: DirectEventHandler<ScannerErrorEventPayload>;

package/lib/typescript/src/ScannerViewNativeComponent.d.ts

@@ -1,5 +1,5 @@
 import { type ViewProps, type NativeSyntheticEvent } from 'react-native';
-import type { DirectEventHandler, Double } from 'react-native/Libraries/Types/CodegenTypesNamespace';
+import type { DirectEventHandler, Double, WithDefault } from 'react-native/Libraries/Types/CodegenTypesNamespace';
 export interface BarcodeScannedEventPayload {
     barcodes: {
         data: string;
@@ -81,7 +81,7 @@ export interface NativeProps extends ViewProps {
      * Prevents rapid duplicate detections. Set to 0 to disable debouncing.
      * @default 0.5
      */
-    barcodeEmissionInterval?: Double;
+    barcodeEmissionInterval?: WithDefault<Double, 0.5>;
     onBarcodeScanned?: DirectEventHandler<BarcodeScannedEventPayload>;
     onScannerError?: DirectEventHandler<ScannerErrorEventPayload>;
     onLoad?: DirectEventHandler<OnLoadEventPayload>;

package/lib/typescript/src/ScannerViewNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScannerViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/ScannerViewNativeComponent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ScannerViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/ScannerViewNativeComponent.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cleanuidev/react-native-scanner",
-  "version": "1.0.0-beta.2",
-  "description": "scanner",
+  "version": "1.0.0-beta.4",
+  "description": "High-performance native barcode and QR code scanner for React Native. Scan barcodes in configurable target areas for precise detection. Built with CameraX & ML Kit (Android) and AVFoundation & Vision (iOS).",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -45,7 +45,31 @@
   "keywords": [
     "react-native",
     "ios",
-    "android"
+    "android",
+    "barcode-scanner",
+    "qr-code-scanner",
+    "barcode",
+    "qr-code",
+    "qrcode",
+    "scanner",
+    "camera",
+    "camerax",
+    "ml-kit",
+    "avfoundation",
+    "vision",
+    "react-native-scanner",
+    "barcode-detection",
+    "qr-detection",
+    "mobile-scanner",
+    "native-scanner",
+    "fabric",
+    "new architecture",
+    "focus area",
+    "region scanning",
+    "frame scanning",
+    "area scanning",
+    "targeted-scanning",
+    "precise-scanning"
   ],
   "repository": {
     "type": "git",

package/src/ScannerViewNativeComponent.ts

@@ -6,6 +6,7 @@ import {
 import type {
   DirectEventHandler,
   Double,
+  WithDefault,
 } from 'react-native/Libraries/Types/CodegenTypesNamespace';
 
 // Define codegen types locally (no longer exported from react-native in 0.83)
@@ -111,7 +112,7 @@ export interface NativeProps extends ViewProps {
    * Prevents rapid duplicate detections. Set to 0 to disable debouncing.
    * @default 0.5
    */
-  barcodeEmissionInterval?: Double;
+  barcodeEmissionInterval?: WithDefault<Double, 0.5>;
 
   onBarcodeScanned?: DirectEventHandler<BarcodeScannedEventPayload>;
   onScannerError?: DirectEventHandler<ScannerErrorEventPayload>;