react-native-rectangle-doc-scanner 3.123.0 → 3.125.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.18,
+    contrast: 1.12,
+    saturation: 0.78,
+};
 const normalizeCapturedDocument = (document) => {
     const { origin: _origin, ...rest } = document;
     const normalizedPath = stripFileUri(document.initialPath ?? document.path);
@@ -169,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);
@@ -207,12 +254,13 @@ 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) {
             resetScannerView({ remount: true });
@@ -236,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, resetScannerView]);
+    }, [cropWidth, cropHeight, emitError, preparePreviewImage, resetScannerView]);
     const handleCapture = (0, react_1.useCallback)(async (document) => {
         console.log('[FullDocScanner] handleCapture called:', {
             origin: document.origin,
@@ -262,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;
@@ -405,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];
@@ -419,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) {
@@ -427,16 +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);
         // 확인 화면을 닫고 카메라로 돌아감
         resetScannerView({ remount: true });
-    }, [croppedImageData, resetScannerView, rotationDegrees]);
+    }, [croppedImageData, getActivePreviewImage, resetScannerView, rotationDegrees]);
     const handleRetake = (0, react_1.useCallback)(() => {
         console.log('[FullDocScanner] Retake - clearing cropped image and resetting scanner');
         // Business 모드에서 두 번째 사진을 다시 찍는 경우, 첫 번째 사진 유지
@@ -500,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
@@ -518,12 +568,24 @@ const FullDocScanner = ({ onResult, onClose, detectionConfig, overlayColor = '#3
                 react_1.default.createElement(react_native_1.TouchableOpacity, { style: styles.rotateButtonTop, onPress: () => handleRotateImage(90), accessibilityLabel: "\uC624\uB978\uCABD\uC73C\uB85C 90\uB3C4 \uD68C\uC804", accessibilityRole: "button" },
                     react_1.default.createElement(react_native_1.Text, { style: styles.rotateIconText }, "\u21BB"),
                     react_1.default.createElement(react_native_1.Text, { style: styles.rotateButtonLabel }, "\uC6B0\uB85C 90\u00B0")))) : null,
+            croppedImageData.enhanced ? (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
+                    styles.originalToggleButton,
+                    croppedImageData.useOriginal
+                        ? styles.originalToggleButtonActive
+                        : styles.originalToggleButtonInactive,
+                ], 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
+                            : styles.originalToggleButtonTextInactive,
+                    ] }, mergedStrings.originalBtn))) : 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,
             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)),
@@ -735,6 +797,33 @@ const styles = react_native_1.StyleSheet.create({
         gap: 24,
         paddingVertical: 32,
     },
+    originalToggleButton: {
+        alignSelf: 'center',
+        marginTop: 12,
+        marginBottom: 4,
+        paddingVertical: 10,
+        paddingHorizontal: 28,
+        borderRadius: 999,
+        borderWidth: 1,
+    },
+    originalToggleButtonActive: {
+        backgroundColor: '#3170f3',
+        borderColor: '#3170f3',
+    },
+    originalToggleButtonInactive: {
+        backgroundColor: 'rgba(255,255,255,0.12)',
+        borderColor: 'rgba(255,255,255,0.25)',
+    },
+    originalToggleButtonText: {
+        fontSize: 14,
+        fontWeight: '700',
+    },
+    originalToggleButtonTextActive: {
+        color: '#fff',
+    },
+    originalToggleButtonTextInactive: {
+        color: 'rgba(255,255,255,0.65)',
+    },
     confirmButton: {
         paddingHorizontal: 40,
         paddingVertical: 16,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rectangle-doc-scanner",
-  "version": "3.123.0",
+  "version": "3.125.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.18,
+  contrast: 1.12,
+  saturation: 0.78,
+};
+
 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);
@@ -238,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);
@@ -292,13 +370,14 @@ 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,
         });
+
+        setCroppedImageData(preview);
+        setProcessing(false);
       } catch (error) {
         resetScannerView({ remount: true });
 
@@ -333,7 +412,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
         }
       }
     },
-    [cropWidth, cropHeight, emitError, resetScannerView],
+    [cropWidth, cropHeight, emitError, preparePreviewImage, resetScannerView],
   );
 
   const handleCapture = useCallback(
@@ -369,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;
       }
@@ -391,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(() => {
@@ -550,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,
     };
 
@@ -567,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');
@@ -578,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,
     };
 
@@ -589,7 +671,7 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
 
     // 확인 화면을 닫고 카메라로 돌아감
     resetScannerView({ remount: true });
-  }, [croppedImageData, resetScannerView, rotationDegrees]);
+  }, [croppedImageData, getActivePreviewImage, resetScannerView, rotationDegrees]);
 
 
   const handleRetake = useCallback(() => {
@@ -666,6 +748,8 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
     [],
   );
 
+  const activePreviewImage = croppedImageData ? getActivePreviewImage(croppedImageData) : null;
+
   return (
     <View style={styles.container}>
       {croppedImageData ? (
@@ -727,6 +811,35 @@ export const FullDocScanner: React.FC<FullDocScannerProps> = ({
             </View>
           ) : null}
 
+          {croppedImageData.enhanced ? (
+            <TouchableOpacity
+              style={[
+                styles.originalToggleButton,
+                croppedImageData.useOriginal
+                  ? styles.originalToggleButtonActive
+                  : styles.originalToggleButtonInactive,
+              ]}
+              onPress={() =>
+                setCroppedImageData((prev) =>
+                  prev ? { ...prev, useOriginal: !prev.useOriginal } : prev,
+                )
+              }
+              accessibilityRole="button"
+              accessibilityLabel={mergedStrings.originalBtn}
+            >
+              <Text
+                style={[
+                  styles.originalToggleButtonText,
+                  croppedImageData.useOriginal
+                    ? styles.originalToggleButtonTextActive
+                    : styles.originalToggleButtonTextInactive,
+                ]}
+              >
+                {mergedStrings.originalBtn}
+              </Text>
+            </TouchableOpacity>
+          ) : null}
+
           {/* 뒷면 촬영 버튼 - 상단에 표시 (Business 모드이고 첫 번째 사진일 때만) */}
           {isBusinessMode && capturedPhotos.length === 0 && (
             <TouchableOpacity
@@ -739,14 +852,16 @@ 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}
           <View style={styles.confirmationButtons}>
             <TouchableOpacity
               style={[styles.confirmButton, styles.retakeButton]}
@@ -1052,6 +1167,33 @@ const styles = StyleSheet.create({
     gap: 24,
     paddingVertical: 32,
   },
+  originalToggleButton: {
+    alignSelf: 'center',
+    marginTop: 12,
+    marginBottom: 4,
+    paddingVertical: 10,
+    paddingHorizontal: 28,
+    borderRadius: 999,
+    borderWidth: 1,
+  },
+  originalToggleButtonActive: {
+    backgroundColor: '#3170f3',
+    borderColor: '#3170f3',
+  },
+  originalToggleButtonInactive: {
+    backgroundColor: 'rgba(255,255,255,0.12)',
+    borderColor: 'rgba(255,255,255,0.25)',
+  },
+  originalToggleButtonText: {
+    fontSize: 14,
+    fontWeight: '700',
+  },
+  originalToggleButtonTextActive: {
+    color: '#fff',
+  },
+  originalToggleButtonTextInactive: {
+    color: 'rgba(255,255,255,0.65)',
+  },
   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