react-native-rectangle-doc-scanner 3.122.0 → 3.124.0

package/dist/FullDocScanner.d.ts

@@ -24,6 +24,7 @@ export interface FullDocScannerStrings {
     second?: string;
     secondBtn?: string;
     secondPrompt?: string;
+    originalBtn?: string;
 }
 export interface FullDocScannerProps {
     onResult: (results: FullDocScannerResult[]) => void;

package/dist/FullDocScanner.js

@@ -43,15 +43,6 @@ const react_native_image_picker_1 = require("react-native-image-picker");
 const react_native_image_crop_picker_1 = __importDefault(require("react-native-image-crop-picker"));
 const react_native_fs_1 = __importDefault(require("react-native-fs"));
 const DocScanner_1 = require("./DocScanner");
-let ImageManipulator = null;
-try {
-    ImageManipulator = require('expo-image-manipulator');
-}
-catch (error) {
-    console.warn('[FullDocScanner] expo-image-manipulator module unavailable.', error);
-}
-let expoManipulatorUnavailable = false;
-const isExpoImageManipulatorAvailable = () => !!ImageManipulator?.manipulateAsync && !expoManipulatorUnavailable;
 // 회전은 항상 지원됨 (회전 각도를 반환하고 tdb 앱에서 처리)
 const isImageRotationSupported = () => true;
 const stripFileUri = (value) => value.replace(/^file:\/\//, '');
@@ -105,6 +96,11 @@ async function withTimeout(factory) {
         }
     }
 }
+const AUTO_ENHANCE_PARAMS = {
+    brightness: 0.08,
+    contrast: 1.05,
+    saturation: 0.92,
+};
 const normalizeCapturedDocument = (document) => {
     const { origin: _origin, ...rest } = document;
     const normalizedPath = stripFileUri(document.initialPath ?? document.path);
@@ -125,6 +121,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
     const [rotationDegrees, setRotationDegrees] = (0, react_1.useState)(0);
     const [capturedPhotos, setCapturedPhotos] = (0, react_1.useState)([]);
     const [currentPhotoIndex, setCurrentPhotoIndex] = (0, react_1.useState)(0);
+    const [scannerSession, setScannerSession] = (0, react_1.useState)(0);
     const resolvedGridColor = gridColor ?? overlayColor;
     const docScannerRef = (0, react_1.useRef)(null);
     const captureModeRef = (0, react_1.useRef)(null);
@@ -132,6 +129,29 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
     const rectangleCaptureTimeoutRef = (0, react_1.useRef)(null);
     const rectangleHintTimeoutRef = (0, react_1.useRef)(null);
     const isBusinessMode = type === 'business';
+    const resetScannerView = (0, react_1.useCallback)((options) => {
+        setProcessing(false);
+        setCroppedImageData(null);
+        setRotationDegrees(0);
+        setRectangleDetected(false);
+        setRectangleHint(false);
+        captureModeRef.current = null;
+        captureInProgressRef.current = false;
+        if (rectangleCaptureTimeoutRef.current) {
+            clearTimeout(rectangleCaptureTimeoutRef.current);
+            rectangleCaptureTimeoutRef.current = null;
+        }
+        if (rectangleHintTimeoutRef.current) {
+            clearTimeout(rectangleHintTimeoutRef.current);
+            rectangleHintTimeoutRef.current = null;
+        }
+        if (docScannerRef.current?.reset) {
+            docScannerRef.current.reset();
+        }
+        if (options?.remount) {
+            setScannerSession((prev) => prev + 1);
+        }
+    }, []);
     const mergedStrings = (0, react_1.useMemo)(() => ({
         captureHint: strings?.captureHint,
         manualHint: strings?.manualHint,
@@ -145,7 +165,58 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         second: strings?.second ?? 'Back',
         secondBtn: strings?.secondBtn ?? 'Capture Back Side?',
         secondPrompt: strings?.secondPrompt ?? strings?.secondBtn ?? 'Capture Back Side?',
+        originalBtn: strings?.originalBtn ?? 'Use Original',
     }), [strings]);
+    const pdfScannerManager = react_native_1.NativeModules?.RNPdfScannerManager;
+    const autoEnhancementEnabled = (0, react_1.useMemo)(() => typeof pdfScannerManager?.applyColorControls === 'function', [pdfScannerManager]);
+    const ensureBase64ForImage = (0, react_1.useCallback)(async (image) => {
+        if (image.base64) {
+            return image;
+        }
+        try {
+            const base64Data = await react_native_fs_1.default.readFile(image.path, 'base64');
+            return {
+                ...image,
+                base64: base64Data,
+            };
+        }
+        catch (error) {
+            console.warn('[FullDocScanner] Failed to generate base64 for image:', error);
+            return image;
+        }
+    }, []);
+    const applyAutoEnhancement = (0, react_1.useCallback)(async (image) => {
+        if (!autoEnhancementEnabled || !pdfScannerManager?.applyColorControls) {
+            return null;
+        }
+        try {
+            const outputPath = await pdfScannerManager.applyColorControls(image.path, AUTO_ENHANCE_PARAMS.brightness, AUTO_ENHANCE_PARAMS.contrast, AUTO_ENHANCE_PARAMS.saturation);
+            return {
+                path: stripFileUri(outputPath),
+            };
+        }
+        catch (error) {
+            console.error('[FullDocScanner] Auto enhancement failed:', error);
+            return null;
+        }
+    }, [autoEnhancementEnabled, pdfScannerManager]);
+    const preparePreviewImage = (0, react_1.useCallback)(async (image) => {
+        const original = await ensureBase64ForImage(image);
+        const enhancedCandidate = await applyAutoEnhancement(original);
+        if (enhancedCandidate) {
+            const enhanced = await ensureBase64ForImage(enhancedCandidate);
+            return {
+                original,
+                enhanced,
+                useOriginal: false,
+            };
+        }
+        return {
+            original,
+            useOriginal: true,
+        };
+    }, [applyAutoEnhancement, ensureBase64ForImage]);
+    const getActivePreviewImage = (0, react_1.useCallback)((preview) => preview.useOriginal || !preview.enhanced ? preview.original : preview.enhanced, []);
     const emitError = (0, react_1.useCallback)((error, fallbackMessage) => {
         console.error('[FullDocScanner] error', error);
         onError?.(error);
@@ -183,23 +254,16 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
                 path: croppedImage.path,
                 hasBase64: !!croppedImage.data,
             });
-            setProcessing(false);
-            // Show confirmation screen
-            setCroppedImageData({
-                path: croppedImage.path,
+            const sanitizedPath = stripFileUri(croppedImage.path);
+            const preview = await preparePreviewImage({
+                path: sanitizedPath,
                 base64: croppedImage.data ?? undefined,
             });
+            setCroppedImageData(preview);
+            setProcessing(false);
         }
         catch (error) {
-            setProcessing(false);
-            // Reset capture state when cropper fails or is cancelled
-            captureInProgressRef.current = false;
-            captureModeRef.current = null;
-            setRectangleDetected(false);
-            setRectangleHint(false);
-            if (docScannerRef.current?.reset) {
-                docScannerRef.current.reset();
-            }
+            resetScannerView({ remount: true });
             const errorCode = error?.code;
             const errorMessageRaw = error?.message ?? String(error);
             const errorMessage = typeof errorMessageRaw === 'string' ? errorMessageRaw : String(errorMessageRaw);
@@ -220,7 +284,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
                 emitError(error instanceof Error ? error : new Error(errorMessage), 'Failed to crop image. Please try again.');
             }
         }
-    }, [cropWidth, cropHeight, emitError]);
+    }, [cropWidth, cropHeight, emitError, preparePreviewImage, resetScannerView]);
     const handleCapture = (0, react_1.useCallback)(async (document) => {
         console.log('[FullDocScanner] handleCapture called:', {
             origin: document.origin,
@@ -246,27 +310,26 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         }
         if (normalizedDoc.croppedPath) {
             console.log('[FullDocScanner] Grid detected: using pre-cropped image', normalizedDoc.croppedPath);
-            // RNFS를 사용해서 base64 생성
+            setProcessing(true);
             try {
-                const base64Data = await react_native_fs_1.default.readFile(normalizedDoc.croppedPath, 'base64');
-                console.log('[FullDocScanner] Generated base64 for pre-cropped image, length:', base64Data.length);
-                setCroppedImageData({
+                const preview = await preparePreviewImage({
                     path: normalizedDoc.croppedPath,
-                    base64: base64Data,
                 });
+                setCroppedImageData(preview);
             }
             catch (error) {
-                console.error('[FullDocScanner] Failed to generate base64:', error);
-                // base64 생성 실패 시 경로만 저장
-                setCroppedImageData({
-                    path: normalizedDoc.croppedPath,
-                });
+                console.error('[FullDocScanner] Failed to prepare preview image:', error);
+                resetScannerView({ remount: true });
+                emitError(error instanceof Error ? error : new Error(String(error)), 'Failed to process captured image.');
+            }
+            finally {
+                setProcessing(false);
             }
             return;
         }
         console.log('[FullDocScanner] Fallback to manual crop (no croppedPath available)');
         await openCropper(normalizedDoc.path, { waitForPickerDismissal: false });
-    }, [openCropper]);
+    }, [emitError, openCropper, preparePreviewImage, resetScannerView]);
     const triggerManualCapture = (0, react_1.useCallback)(() => {
         const scannerInstance = docScannerRef.current;
         const hasScanner = !!scannerInstance;
@@ -389,13 +452,14 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         if (!croppedImageData) {
             return;
         }
+        const activeImage = getActivePreviewImage(croppedImageData);
         // 회전 각도 정규화 (0, 90, 180, 270)
         const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
         console.log('[FullDocScanner] Confirm - rotation degrees:', rotationDegrees, 'normalized:', rotationNormalized);
         // 현재 사진을 capturedPhotos에 추가
         const currentPhoto = {
-            path: croppedImageData.path,
-            base64: croppedImageData.base64,
+            path: activeImage.path,
+            base64: activeImage.base64,
             rotationDegrees: rotationNormalized,
         };
         const updatedPhotos = [...capturedPhotos, currentPhoto];
@@ -403,7 +467,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         // 결과 반환
         console.log('[FullDocScanner] Returning results');
         onResult(updatedPhotos);
-    }, [croppedImageData, rotationDegrees, capturedPhotos, onResult]);
+    }, [croppedImageData, rotationDegrees, capturedPhotos, getActivePreviewImage, onResult]);
     const handleCaptureSecondPhoto = (0, react_1.useCallback)(() => {
         console.log('[FullDocScanner] Capturing second photo');
         if (!croppedImageData) {
@@ -411,33 +475,17 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
         }
         // 현재 사진(앞면)을 먼저 저장
         const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
+        const activeImage = getActivePreviewImage(croppedImageData);
         const currentPhoto = {
-            path: croppedImageData.path,
-            base64: croppedImageData.base64,
+            path: activeImage.path,
+            base64: activeImage.base64,
             rotationDegrees: rotationNormalized,
         };
         setCapturedPhotos([currentPhoto]);
         setCurrentPhotoIndex(1);
         // 확인 화면을 닫고 카메라로 돌아감
-        setCroppedImageData(null);
-        setRotationDegrees(0);
-        setProcessing(false);
-        setRectangleDetected(false);
-        setRectangleHint(false);
-        captureModeRef.current = null;
-        captureInProgressRef.current = false;
-        if (rectangleCaptureTimeoutRef.current) {
-            clearTimeout(rectangleCaptureTimeoutRef.current);
-            rectangleCaptureTimeoutRef.current = null;
-        }
-        if (rectangleHintTimeoutRef.current) {
-            clearTimeout(rectangleHintTimeoutRef.current);
-            rectangleHintTimeoutRef.current = null;
-        }
-        if (docScannerRef.current?.reset) {
-            docScannerRef.current.reset();
-        }
-    }, [croppedImageData, rotationDegrees]);
+        resetScannerView({ remount: true });
+    }, [croppedImageData, getActivePreviewImage, resetScannerView, rotationDegrees]);
     const handleRetake = (0, react_1.useCallback)(() => {
         console.log('[FullDocScanner] Retake - clearing cropped image and resetting scanner');
         // Business 모드에서 두 번째 사진을 다시 찍는 경우, 첫 번째 사진 유지
@@ -451,26 +499,8 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
             setCapturedPhotos([]);
             setCurrentPhotoIndex(0);
         }
-        setCroppedImageData(null);
-        setRotationDegrees(0);
-        setProcessing(false);
-        setRectangleDetected(false);
-        setRectangleHint(false);
-        captureModeRef.current = null;
-        captureInProgressRef.current = false;
-        if (rectangleCaptureTimeoutRef.current) {
-            clearTimeout(rectangleCaptureTimeoutRef.current);
-            rectangleCaptureTimeoutRef.current = null;
-        }
-        if (rectangleHintTimeoutRef.current) {
-            clearTimeout(rectangleHintTimeoutRef.current);
-            rectangleHintTimeoutRef.current = null;
-        }
-        // Reset DocScanner state
-        if (docScannerRef.current?.reset) {
-            docScannerRef.current.reset();
-        }
-    }, [capturedPhotos.length, isBusinessMode]);
+        resetScannerView({ remount: true });
+    }, [capturedPhotos.length, isBusinessMode, resetScannerView]);
     const handleRectangleDetect = (0, react_1.useCallback)((event) => {
         const stableCounter = event.stableCounter ?? 0;
         const rectangleCoordinates = event.rectangleOnScreen ?? event.rectangleCoordinates;
@@ -519,6 +549,7 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
             clearTimeout(rectangleHintTimeoutRef.current);
         }
     }, []);
+    const activePreviewImage = croppedImageData ? getActivePreviewImage(croppedImageData) : null;
     return (react_1.default.createElement(react_native_1.View, { style: styles.container },
         croppedImageData ? (
         // check_DP: Show confirmation screen
@@ -539,16 +570,24 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
                     react_1.default.createElement(react_native_1.Text, { style: styles.rotateButtonLabel }, "\uC6B0\uB85C 90\u00B0")))) : null,
             isBusinessMode && capturedPhotos.length === 0 && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.captureBackButton, onPress: handleCaptureSecondPhoto, accessibilityLabel: mergedStrings.secondBtn, accessibilityRole: "button" },
                 react_1.default.createElement(react_native_1.Text, { style: styles.captureBackButtonText }, mergedStrings.secondBtn))),
-            react_1.default.createElement(react_native_1.Image, { source: { uri: croppedImageData.path }, style: [
+            activePreviewImage ? (react_1.default.createElement(react_native_1.Image, { source: { uri: activePreviewImage.path }, style: [
                     styles.previewImage,
                     { transform: [{ rotate: `${rotationDegrees}deg` }] }
-                ], resizeMode: "contain" }),
+                ], resizeMode: "contain" })) : null,
+            croppedImageData.enhanced ? (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
+                    styles.originalToggleButton,
+                    croppedImageData.useOriginal && styles.originalToggleButtonActive,
+                ], onPress: () => setCroppedImageData((prev) => prev ? { ...prev, useOriginal: !prev.useOriginal } : prev), accessibilityRole: "button", accessibilityLabel: mergedStrings.originalBtn },
+                react_1.default.createElement(react_native_1.Text, { style: [
+                        styles.originalToggleButtonText,
+                        croppedImageData.useOriginal && styles.originalToggleButtonTextActive,
+                    ] }, mergedStrings.originalBtn))) : null,
             react_1.default.createElement(react_native_1.View, { style: styles.confirmationButtons },
                 react_1.default.createElement(react_native_1.TouchableOpacity, { style: [styles.confirmButton, styles.retakeButton], onPress: handleRetake, accessibilityLabel: mergedStrings.retake, accessibilityRole: "button" },
                     react_1.default.createElement(react_native_1.Text, { style: styles.confirmButtonText }, mergedStrings.retake)),
                 react_1.default.createElement(react_native_1.TouchableOpacity, { style: [styles.confirmButton, styles.confirmButtonPrimary], onPress: handleConfirm, accessibilityLabel: mergedStrings.confirm, accessibilityRole: "button" },
                     react_1.default.createElement(react_native_1.Text, { style: styles.confirmButtonText }, mergedStrings.confirm))))) : (react_1.default.createElement(react_native_1.View, { style: styles.flex },
-            react_1.default.createElement(DocScanner_1.DocScanner, { ref: docScannerRef, autoCapture: false, overlayColor: overlayColor, showGrid: showGrid, gridColor: resolvedGridColor, gridLineWidth: gridLineWidth, minStableFrames: minStableFrames ?? 6, detectionConfig: detectionConfig, onCapture: handleCapture, onRectangleDetect: handleRectangleDetect, showManualCaptureButton: false, enableTorch: flashEnabled },
+            react_1.default.createElement(DocScanner_1.DocScanner, { key: scannerSession, ref: docScannerRef, autoCapture: false, overlayColor: overlayColor, showGrid: showGrid, gridColor: resolvedGridColor, gridLineWidth: gridLineWidth, minStableFrames: minStableFrames ?? 6, detectionConfig: detectionConfig, onCapture: handleCapture, onRectangleDetect: handleRectangleDetect, showManualCaptureButton: false, enableTorch: flashEnabled },
                 react_1.default.createElement(react_native_1.View, { style: styles.overlayTop, pointerEvents: "box-none" },
                     react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
                             styles.iconButton,
@@ -754,6 +793,28 @@ const styles = react_native_1.StyleSheet.create({
         gap: 24,
         paddingVertical: 32,
     },
+    originalToggleButton: {
+        alignSelf: 'center',
+        marginTop: 16,
+        paddingVertical: 10,
+        paddingHorizontal: 24,
+        borderRadius: 24,
+        borderWidth: 1,
+        borderColor: 'rgba(255,255,255,0.4)',
+        backgroundColor: 'rgba(30,30,30,0.7)',
+    },
+    originalToggleButtonActive: {
+        backgroundColor: 'rgba(255,255,255,0.15)',
+        borderColor: '#fff',
+    },
+    originalToggleButtonText: {
+        color: '#fff',
+        fontSize: 14,
+        fontWeight: '600',
+    },
+    originalToggleButtonTextActive: {
+        color: '#fff',
+    },
     confirmButton: {
         paddingHorizontal: 40,
         paddingVertical: 16,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rectangle-doc-scanner",
-  "version": "3.122.0",
+  "version": "3.124.0",
   "description": "Native-backed document scanner for React Native with customizable overlays.",
   "license": "MIT",
   "main": "dist/index.js",

package/src/FullDocScanner.tsx

@@ -4,6 +4,7 @@ import {
   Alert,
   Image,
   InteractionManager,
+  NativeModules,
   StyleSheet,
   Text,
   TouchableOpacity,
@@ -20,23 +21,6 @@ import type {
   DocScannerCapture,
   RectangleDetectEvent,
 } from './DocScanner';
-
-type ImageManipulatorModule = typeof import('expo-image-manipulator');
-
-let ImageManipulator: ImageManipulatorModule | null = null;
-
-try {
-  ImageManipulator = require('expo-image-manipulator') as ImageManipulatorModule;
-} catch (error) {
-  console.warn(
-    '[FullDocScanner] expo-image-manipulator module unavailable.',
-    error,
-  );
-}
-
-let expoManipulatorUnavailable = false;
-const isExpoImageManipulatorAvailable = () =>
-  !!ImageManipulator?.manipulateAsync && !expoManipulatorUnavailable;
 // 회전은 항상 지원됨 (회전 각도를 반환하고 tdb 앱에서 처리)
 const isImageRotationSupported = () => true;
 
@@ -104,6 +88,19 @@ type OpenCropperOptions = {
   waitForPickerDismissal?: boolean;
 };
 
+type PreviewImageInfo = { path: string; base64?: string };
+type PreviewImageData = {
+  original: PreviewImageInfo;
+  enhanced?: PreviewImageInfo;
+  useOriginal: boolean;
+};
+
+const AUTO_ENHANCE_PARAMS = {
+  brightness: 0.08,
+  contrast: 1.05,
+  saturation: 0.92,
+};
+
 const normalizeCapturedDocument = (document: DocScannerCapture): CapturedDocument => {
   const { origin: _origin, ...rest } = document;
   const normalizedPath = stripFileUri(document.initialPath ?? document.path);
@@ -139,6 +136,7 @@ export interface FullDocScannerStrings {
   second?: string;
   secondBtn?: string;
   secondPrompt?: string;
+  originalBtn?: string;
 }
 
 export interface FullDocScannerProps {
@@ -175,7 +173,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
   type,
 }) => {
   const [processing, setProcessing] = useState(false);
-  const [croppedImageData, setCroppedImageData] = useState<{path: string; base64?: string} | null>(null);
+  const [croppedImageData, setCroppedImageData] = useState<PreviewImageData | null>(null);
   const [isGalleryOpen, setIsGalleryOpen] = useState(false);
   const [rectangleDetected, setRectangleDetected] = useState(false);
   const [rectangleHint, setRectangleHint] = useState(false);
@@ -183,6 +181,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
   const [rotationDegrees, setRotationDegrees] = useState(0);
   const [capturedPhotos, setCapturedPhotos] = useState<FullDocScannerResult[]>([]);
   const [currentPhotoIndex, setCurrentPhotoIndex] = useState(0);
+  const [scannerSession, setScannerSession] = useState(0);
   const resolvedGridColor = gridColor ?? overlayColor;
   const docScannerRef = useRef<DocScannerHandle | null>(null);
   const captureModeRef = useRef<'grid' | 'no-grid' | null>(null);
@@ -192,6 +191,37 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
 
   const isBusinessMode = type === 'business';
 
+  const resetScannerView = useCallback(
+    (options?: { remount?: boolean }) => {
+      setProcessing(false);
+      setCroppedImageData(null);
+      setRotationDegrees(0);
+      setRectangleDetected(false);
+      setRectangleHint(false);
+      captureModeRef.current = null;
+      captureInProgressRef.current = false;
+
+      if (rectangleCaptureTimeoutRef.current) {
+        clearTimeout(rectangleCaptureTimeoutRef.current);
+        rectangleCaptureTimeoutRef.current = null;
+      }
+
+      if (rectangleHintTimeoutRef.current) {
+        clearTimeout(rectangleHintTimeoutRef.current);
+        rectangleHintTimeoutRef.current = null;
+      }
+
+      if (docScannerRef.current?.reset) {
+        docScannerRef.current.reset();
+      }
+
+      if (options?.remount) {
+        setScannerSession((prev) => prev + 1);
+      }
+    },
+    [],
+  );
+
   const mergedStrings = useMemo(
     () => ({
       captureHint: strings?.captureHint,
@@ -206,10 +236,90 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       second: strings?.second ?? 'Back',
       secondBtn: strings?.secondBtn ?? 'Capture Back Side?',
       secondPrompt: strings?.secondPrompt ?? strings?.secondBtn ?? 'Capture Back Side?',
+      originalBtn: strings?.originalBtn ?? 'Use Original',
     }),
     [strings],
   );
 
+  const pdfScannerManager = (NativeModules as any)?.RNPdfScannerManager;
+
+  const autoEnhancementEnabled = useMemo(
+    () => typeof pdfScannerManager?.applyColorControls === 'function',
+    [pdfScannerManager],
+  );
+
+  const ensureBase64ForImage = useCallback(
+    async (image: PreviewImageInfo): Promise<PreviewImageInfo> => {
+      if (image.base64) {
+        return image;
+      }
+      try {
+        const base64Data = await RNFS.readFile(image.path, 'base64');
+        return {
+          ...image,
+          base64: base64Data,
+        };
+      } catch (error) {
+        console.warn('[FullDocScanner] Failed to generate base64 for image:', error);
+        return image;
+      }
+    },
+    [],
+  );
+
+  const applyAutoEnhancement = useCallback(
+    async (image: PreviewImageInfo): Promise<PreviewImageInfo | null> => {
+      if (!autoEnhancementEnabled || !pdfScannerManager?.applyColorControls) {
+        return null;
+      }
+
+      try {
+        const outputPath: string = await pdfScannerManager.applyColorControls(
+          image.path,
+          AUTO_ENHANCE_PARAMS.brightness,
+          AUTO_ENHANCE_PARAMS.contrast,
+          AUTO_ENHANCE_PARAMS.saturation,
+        );
+
+        return {
+          path: stripFileUri(outputPath),
+        };
+      } catch (error) {
+        console.error('[FullDocScanner] Auto enhancement failed:', error);
+        return null;
+      }
+    },
+    [autoEnhancementEnabled, pdfScannerManager],
+  );
+
+  const preparePreviewImage = useCallback(
+    async (image: PreviewImageInfo): Promise<PreviewImageData> => {
+      const original = await ensureBase64ForImage(image);
+      const enhancedCandidate = await applyAutoEnhancement(original);
+
+      if (enhancedCandidate) {
+        const enhanced = await ensureBase64ForImage(enhancedCandidate);
+        return {
+          original,
+          enhanced,
+          useOriginal: false,
+        };
+      }
+
+      return {
+        original,
+        useOriginal: true,
+      };
+    },
+    [applyAutoEnhancement, ensureBase64ForImage],
+  );
+
+  const getActivePreviewImage = useCallback(
+    (preview: PreviewImageData): PreviewImageInfo =>
+      preview.useOriginal || !preview.enhanced ? preview.original : preview.enhanced,
+    [],
+  );
+
   const emitError = useCallback(
     (error: Error, fallbackMessage?: string) => {
       console.error('[FullDocScanner] error', error);
@@ -260,28 +370,21 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
           hasBase64: !!croppedImage.data,
         });
 
-        setProcessing(false);
-
-        // Show confirmation screen
-        setCroppedImageData({
-          path: croppedImage.path,
+        const sanitizedPath = stripFileUri(croppedImage.path);
+        const preview = await preparePreviewImage({
+          path: sanitizedPath,
           base64: croppedImage.data ?? undefined,
         });
-      } catch (error) {
-        setProcessing(false);
 
-        // Reset capture state when cropper fails or is cancelled
-        captureInProgressRef.current = false;
-        captureModeRef.current = null;
-        setRectangleDetected(false);
-        setRectangleHint(false);
-        if (docScannerRef.current?.reset) {
-          docScannerRef.current.reset();
-        }
+        setCroppedImageData(preview);
+        setProcessing(false);
+      } catch (error) {
+        resetScannerView({ remount: true });
 
         const errorCode = (error as any)?.code;
         const errorMessageRaw = (error as any)?.message ?? String(error);
-        const errorMessage = typeof errorMessageRaw === 'string' ? errorMessageRaw : String(errorMessageRaw);
+        const errorMessage =
+          typeof errorMessageRaw === 'string' ? errorMessageRaw : String(errorMessageRaw);
         const normalizedMessage = errorMessage.toLowerCase();
         const isUserCancelled =
           errorCode === 'E_PICKER_CANCELLED' ||
@@ -309,7 +412,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
         }
       }
     },
-    [cropWidth, cropHeight, emitError],
+    [cropWidth, cropHeight, emitError, preparePreviewImage, resetScannerView],
   );
 
   const handleCapture = useCallback(
@@ -345,21 +448,21 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       if (normalizedDoc.croppedPath) {
         console.log('[FullDocScanner] Grid detected: using pre-cropped image', normalizedDoc.croppedPath);
 
-        // RNFS를 사용해서 base64 생성
+        setProcessing(true);
         try {
-          const base64Data = await RNFS.readFile(normalizedDoc.croppedPath, 'base64');
-          console.log('[FullDocScanner] Generated base64 for pre-cropped image, length:', base64Data.length);
-
-          setCroppedImageData({
+          const preview = await preparePreviewImage({
             path: normalizedDoc.croppedPath,
-            base64: base64Data,
           });
+          setCroppedImageData(preview);
         } catch (error) {
-          console.error('[FullDocScanner] Failed to generate base64:', error);
-          // base64 생성 실패 시 경로만 저장
-          setCroppedImageData({
-            path: normalizedDoc.croppedPath,
-          });
+          console.error('[FullDocScanner] Failed to prepare preview image:', error);
+          resetScannerView({ remount: true });
+          emitError(
+            error instanceof Error ? error : new Error(String(error)),
+            'Failed to process captured image.',
+          );
+        } finally {
+          setProcessing(false);
         }
         return;
       }
@@ -367,7 +470,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       console.log('[FullDocScanner] Fallback to manual crop (no croppedPath available)');
       await openCropper(normalizedDoc.path, { waitForPickerDismissal: false });
     },
-    [openCropper],
+    [emitError, openCropper, preparePreviewImage, resetScannerView],
   );
 
   const triggerManualCapture = useCallback(() => {
@@ -526,14 +629,16 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       return;
     }
 
+    const activeImage = getActivePreviewImage(croppedImageData);
+
     // 회전 각도 정규화 (0, 90, 180, 270)
     const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
     console.log('[FullDocScanner] Confirm - rotation degrees:', rotationDegrees, 'normalized:', rotationNormalized);
 
     // 현재 사진을 capturedPhotos에 추가
     const currentPhoto: FullDocScannerResult = {
-      path: croppedImageData.path,
-      base64: croppedImageData.base64,
+      path: activeImage.path,
+      base64: activeImage.base64,
       rotationDegrees: rotationNormalized,
     };
 
@@ -543,7 +648,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     // 결과 반환
     console.log('[FullDocScanner] Returning results');
     onResult(updatedPhotos);
-  }, [croppedImageData, rotationDegrees, capturedPhotos, onResult]);
+  }, [croppedImageData, rotationDegrees, capturedPhotos, getActivePreviewImage, onResult]);
 
   const handleCaptureSecondPhoto = useCallback(() => {
     console.log('[FullDocScanner] Capturing second photo');
@@ -554,9 +659,10 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
 
     // 현재 사진(앞면)을 먼저 저장
     const rotationNormalized = ((rotationDegrees % 360) + 360) % 360;
+    const activeImage = getActivePreviewImage(croppedImageData);
     const currentPhoto: FullDocScannerResult = {
-      path: croppedImageData.path,
-      base64: croppedImageData.base64,
+      path: activeImage.path,
+      base64: activeImage.base64,
       rotationDegrees: rotationNormalized,
     };
 
@@ -564,25 +670,8 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     setCurrentPhotoIndex(1);
 
     // 확인 화면을 닫고 카메라로 돌아감
-    setCroppedImageData(null);
-    setRotationDegrees(0);
-    setProcessing(false);
-    setRectangleDetected(false);
-    setRectangleHint(false);
-    captureModeRef.current = null;
-    captureInProgressRef.current = false;
-    if (rectangleCaptureTimeoutRef.current) {
-      clearTimeout(rectangleCaptureTimeoutRef.current);
-      rectangleCaptureTimeoutRef.current = null;
-    }
-    if (rectangleHintTimeoutRef.current) {
-      clearTimeout(rectangleHintTimeoutRef.current);
-      rectangleHintTimeoutRef.current = null;
-    }
-    if (docScannerRef.current?.reset) {
-      docScannerRef.current.reset();
-    }
-  }, [croppedImageData, rotationDegrees]);
+    resetScannerView({ remount: true });
+  }, [croppedImageData, getActivePreviewImage, resetScannerView, rotationDegrees]);
 
 
   const handleRetake = useCallback(() => {
@@ -599,26 +688,8 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       setCurrentPhotoIndex(0);
     }
 
-    setCroppedImageData(null);
-    setRotationDegrees(0);
-    setProcessing(false);
-    setRectangleDetected(false);
-    setRectangleHint(false);
-    captureModeRef.current = null;
-    captureInProgressRef.current = false;
-    if (rectangleCaptureTimeoutRef.current) {
-      clearTimeout(rectangleCaptureTimeoutRef.current);
-      rectangleCaptureTimeoutRef.current = null;
-    }
-    if (rectangleHintTimeoutRef.current) {
-      clearTimeout(rectangleHintTimeoutRef.current);
-      rectangleHintTimeoutRef.current = null;
-    }
-    // Reset DocScanner state
-    if (docScannerRef.current?.reset) {
-      docScannerRef.current.reset();
-    }
-  }, [capturedPhotos.length, isBusinessMode]);
+    resetScannerView({ remount: true });
+  }, [capturedPhotos.length, isBusinessMode, resetScannerView]);
 
   const handleRectangleDetect = useCallback((event: RectangleDetectEvent) => {
     const stableCounter = event.stableCounter ?? 0;
@@ -677,6 +748,8 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     [],
   );
 
+  const activePreviewImage = croppedImageData ? getActivePreviewImage(croppedImageData) : null;
+
   return (
     <View style={styles.container}>
       {croppedImageData ? (
@@ -750,14 +823,40 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
             </TouchableOpacity>
           )}
 
-          <Image
-            source={{ uri: croppedImageData.path }}
-            style={[
-              styles.previewImage,
-              { transform: [{ rotate: `${rotationDegrees}deg` }] }
-            ]}
-            resizeMode="contain"
-          />
+          {activePreviewImage ? (
+            <Image
+              source={{ uri: activePreviewImage.path }}
+              style={[
+                styles.previewImage,
+                { transform: [{ rotate: `${rotationDegrees}deg` }] }
+              ]}
+              resizeMode="contain"
+            />
+          ) : null}
+          {croppedImageData.enhanced ? (
+            <TouchableOpacity
+              style={[
+                styles.originalToggleButton,
+                croppedImageData.useOriginal && styles.originalToggleButtonActive,
+              ]}
+              onPress={() =>
+                setCroppedImageData((prev) =>
+                  prev ? { ...prev, useOriginal: !prev.useOriginal } : prev,
+                )
+              }
+              accessibilityRole="button"
+              accessibilityLabel={mergedStrings.originalBtn}
+            >
+              <Text
+                style={[
+                  styles.originalToggleButtonText,
+                  croppedImageData.useOriginal && styles.originalToggleButtonTextActive,
+                ]}
+              >
+                {mergedStrings.originalBtn}
+              </Text>
+            </TouchableOpacity>
+          ) : null}
           <View style={styles.confirmationButtons}>
             <TouchableOpacity
               style={[styles.confirmButton, styles.retakeButton]}
@@ -781,6 +880,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
       ) : (
         <View style={styles.flex}>
           <DocScanner
+            key={scannerSession}
             ref={docScannerRef}
             autoCapture={false}
             overlayColor={overlayColor}
@@ -1062,6 +1162,28 @@ const styles = StyleSheet.create({
     gap: 24,
     paddingVertical: 32,
   },
+  originalToggleButton: {
+    alignSelf: 'center',
+    marginTop: 16,
+    paddingVertical: 10,
+    paddingHorizontal: 24,
+    borderRadius: 24,
+    borderWidth: 1,
+    borderColor: 'rgba(255,255,255,0.4)',
+    backgroundColor: 'rgba(30,30,30,0.7)',
+  },
+  originalToggleButtonActive: {
+    backgroundColor: 'rgba(255,255,255,0.15)',
+    borderColor: '#fff',
+  },
+  originalToggleButtonText: {
+    color: '#fff',
+    fontSize: 14,
+    fontWeight: '600',
+  },
+  originalToggleButtonTextActive: {
+    color: '#fff',
+  },
   confirmButton: {
     paddingHorizontal: 40,
     paddingVertical: 16,

package/vendor/react-native-document-scanner/ios/RNPdfScannerManager.m

@@ -2,6 +2,8 @@
 #import "RNPdfScannerManager.h"
 #import "DocumentScannerView.h"
 #import <React/RCTUIManager.h>
+#import <UIKit/UIKit.h>
+#import <CoreImage/CoreImage.h>
 
 @interface RNPdfScannerManager()
 @property (strong, nonatomic) DocumentScannerView *scannerView;
@@ -87,4 +89,112 @@ RCT_EXPORT_METHOD(capture:(NSNumber * _Nullable)reactTag
     return _scannerView;
 }
 
+RCT_EXPORT_METHOD(applyColorControls:(NSString *)imagePath
+                  brightness:(nonnull NSNumber *)brightness
+                  contrast:(nonnull NSNumber *)contrast
+                  saturation:(nonnull NSNumber *)saturation
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+    dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
+        @autoreleasepool {
+            NSString *resolvedPath = imagePath ?: @"";
+            if (![resolvedPath length]) {
+                if (reject) {
+                    reject(@"INVALID_PATH", @"Image path is empty", nil);
+                }
+                return;
+            }
+
+            NSString *fileUri = resolvedPath;
+            if (![fileUri hasPrefix:@"file://"]) {
+                fileUri = [NSString stringWithFormat:@"file://%@", resolvedPath];
+            }
+
+            NSURL *imageURL = [NSURL URLWithString:fileUri];
+            if (!imageURL) {
+                if (reject) {
+                    reject(@"INVALID_URI", @"Unable to create URL for image path", nil);
+                }
+                return;
+            }
+
+            CIImage *inputImage = [CIImage imageWithContentsOfURL:imageURL];
+            if (!inputImage) {
+                if (reject) {
+                    reject(@"LOAD_FAILED", @"Failed to load image for color adjustment", nil);
+                }
+                return;
+            }
+
+            CIFilter *colorControls = [CIFilter filterWithName:@"CIColorControls"];
+            if (!colorControls) {
+                if (reject) {
+                    reject(@"FILTER_MISSING", @"CIColorControls filter is unavailable", nil);
+                }
+                return;
+            }
+
+            [colorControls setValue:inputImage forKey:kCIInputImageKey];
+            [colorControls setValue:brightness forKey:@"inputBrightness"];
+            [colorControls setValue:contrast forKey:@"inputContrast"];
+            [colorControls setValue:saturation forKey:@"inputSaturation"];
+
+            CIImage *outputImage = colorControls.outputImage;
+            if (!outputImage) {
+                if (reject) {
+                    reject(@"FILTER_FAILED", @"Failed to apply color controls", nil);
+                }
+                return;
+            }
+
+            CIContext *context = [CIContext contextWithOptions:nil];
+            CGRect extent = outputImage.extent;
+            CGImageRef cgImage = [context createCGImage:outputImage fromRect:extent];
+
+            if (!cgImage) {
+                if (reject) {
+                    reject(@"RENDER_FAILED", @"Failed to render filtered image", nil);
+                }
+                return;
+            }
+
+            UIImage *resultImage = [UIImage imageWithCGImage:cgImage];
+            CGImageRelease(cgImage);
+
+            if (!resultImage) {
+                if (reject) {
+                    reject(@"IMAGE_CREATION_FAILED", @"Failed to create UIImage from filtered output", nil);
+                }
+                return;
+            }
+
+            NSData *jpegData = UIImageJPEGRepresentation(resultImage, 0.98f);
+            if (!jpegData) {
+                if (reject) {
+                    reject(@"ENCODE_FAILED", @"Failed to encode filtered image to JPEG", nil);
+                }
+                return;
+            }
+
+            NSString *tempDirectory = NSTemporaryDirectory();
+            NSString *fileName = [NSString stringWithFormat:@"docscanner_enhanced_%@.jpg", [[NSUUID UUID] UUIDString]];
+            NSString *outputPath = [tempDirectory stringByAppendingPathComponent:fileName];
+
+            NSError *writeError = nil;
+            BOOL success = [jpegData writeToFile:outputPath options:NSDataWritingAtomic error:&writeError];
+            if (!success) {
+                if (reject) {
+                    reject(@"WRITE_FAILED", @"Failed to write filtered image to disk", writeError);
+                }
+                return;
+            }
+
+            if (resolve) {
+                resolve(outputPath);
+            }
+        }
+    });
+}
+
 @end