@thegrizzlylabs/react-native-genius-scan 5.17.3 → 6.0.0-beta02

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Headers/GSSDK-Swift.h

@@ -281,9 +281,7 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 #if __has_warning("-Watimport-in-framework-header")
 #pragma clang diagnostic ignored "-Watimport-in-framework-header"
 #endif
-@import AVFoundation;
 @import CoreFoundation;
-@import CoreGraphics;
 @import Dispatch;
 @import Foundation;
 @import ObjectiveC;
@@ -312,14 +310,6 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 
 #if defined(__OBJC__)
 
-SWIFT_PROTOCOL("_TtP5GSSDK20CGImageRepresentable_")
-@protocol CGImageRepresentable
-- (CGImageRef _Nullable)CGImageRepresentation SWIFT_WARN_UNUSED_RESULT;
-@end
-
-@interface AVCapturePhoto (SWIFT_EXTENSION(GSSDK)) <CGImageRepresentable>
-@end
-
 @class NSString;
 /// Entry point of the SDK. Use this to initialize the SDK with your license key.
 SWIFT_CLASS("_TtC5GSSDK3GSK")
@@ -351,96 +341,212 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, copy) NSString * _No
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
-@class AVCaptureDevice;
-@class AVCaptureSession;
-enum GSKCameraSessionFlashStatus : NSInteger;
-enum GSKCameraSessionDocumentDetection : NSInteger;
-@class GSKCameraSessionConfiguration;
-SWIFT_CLASS("_TtC5GSSDK16GSKCameraSession")
-@interface GSKCameraSession : NSObject
-/// Minimum duration in <code>.aboutToTrigger</code> state before triggering the photo.
-/// This can be used to coordinate animations.
-SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly) NSTimeInterval minDurationInAboutToTriggerForTrigger;)
-+ (NSTimeInterval)minDurationInAboutToTriggerForTrigger SWIFT_WARN_UNUSED_RESULT;
-/// Public for legacy reasons, not to be used directly.
-@property (nonatomic, strong) AVCaptureDevice * _Nullable captureDevice;
-/// Public for legacy reasons, not to be used directly.
-@property (nonatomic, strong) AVCaptureSession * _Nullable captureSession;
-/// The flash mode. Default is .auto.
-@property (nonatomic) enum GSKCameraSessionFlashStatus flashStatus;
-/// Returns the current status of the document detection.
-/// This is a computed property that maps to the new activeDetectionMode property for backward compatibility.
-/// Observable.
+/// A barcode such as 1D barcodes or QR codes.
+SWIFT_CLASS("_TtC5GSSDK10GSKBarcode")
+@interface GSKBarcode : NSObject
+- (nonnull instancetype)init SWIFT_UNAVAILABLE;
++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
+@end
+
+@interface GSKBarcode (SWIFT_EXTENSION(GSSDK))
+- (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT;
+@end
+
+@interface GSKBarcode (SWIFT_EXTENSION(GSSDK))
+@property (nonatomic, readonly) NSUInteger hash;
+@end
+
+@class GSKBarcodeScanFlowConfiguration;
+@class UIViewController;
+@class GSKBarcodeScanFlowResult;
+/// A UI flow for scanning barcodes and QR codes using the device camera.
+/// Configure the flow with <code>GSKBarcodeScanFlowConfiguration</code> to select the
+/// barcode types to detect and whether batch mode is enabled. Present it from
+/// a view controller and await a <code>GSKBarcodeScanFlowResult</code> containing the
+/// decoded barcodes.
 /// important:
-/// This property is deprecated. Use <code>activeDetectionMode</code> instead, which supports both document and readable
-/// code detection modes.
-@property (nonatomic) enum GSKCameraSessionDocumentDetection activeDocumentDetection SWIFT_DEPRECATED_MSG("Use activeDetectionMode instead");
-/// True for the duration of taking the photo and processing it. Observable.
-@property (nonatomic, readonly) BOOL isTakingPhoto;
-/// Returns false if flash isn’t supported on this device configuration.
-@property (nonatomic, readonly) BOOL supportsFlash;
-/// Public to be accessible from Objective-C, but should be private otherwise.
-@property (nonatomic, readonly, strong) dispatch_queue_t _Nullable captureSessionQueue;
-@property (nonatomic, readonly, strong) dispatch_queue_t _Nonnull takePhotoQueue;
-- (nonnull instancetype)initWithConfiguration:(GSKCameraSessionConfiguration * _Nonnull)configuration;
-- (void)pauseSession;
-- (void)resumeSession;
+/// Camera access requires <code>NSCameraUsageDescription</code> in
+/// <code>Info.plist</code>.
+SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
+@interface GSKBarcodeScanFlow : NSObject
+/// Initializes a new barcode scan flow
+/// \param configuration Configuration for the barcode scanning
+///
+- (nonnull instancetype)initWithConfiguration:(GSKBarcodeScanFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
+/// Starts the barcode scanning flow by presenting a full-screen camera interface.
+/// This method presents a camera view controller that continuously scans for barcodes and QR codes.
+/// The scanning process respects the code types specified in the flow’s configuration.
+/// The method uses Swift’s async/await pattern, suspending until either:
+/// <ul>
+///   <li>
+///     A barcode is successfully detected (except in batch mode)
+///   </li>
+///   <li>
+///     The user taps the done button (batch mode)
+///   </li>
+///   <li>
+///     The user cancels the operation
+///   </li>
+///   <li>
+///     An error occurs during setup or scanning
+///   </li>
+/// </ul>
+/// The behavior varies based on the configuration’s isBatchModeEnabled:
+/// <ul>
+///   <li>
+///     <code>false</code>: Returns immediately after detecting one or more codes in a single frame
+///   </li>
+///   <li>
+///     <code>true</code>: Collects unique codes over time until the user taps the done button
+///   </li>
+/// </ul>
+/// Example usage:
+/// \code
+/// let flow = GSKBarcodeScanFlow()
+/// do {
+///     let result = try await flow.resultByStarting(fromViewController: self)
+///     print("Scanned codes: \(result.barcodes.map { $0.value })")
+/// } catch GSKScanFlowError.cancellation {
+///     print("User canceled scanning")
+/// } catch {
+///     print("Scanning failed: \(error)")
+/// }
+///
+/// \endcodeimportant:
+/// This method requires camera permissions. Ensure your app’s Info.plist includes
+/// the <code>NSCameraUsageDescription</code> key with an appropriate description.
+/// note:
+/// The camera interface is presented with <code>modalPresentationStyle</code> set to <code>.fullScreen</code>
+/// for an immersive scanning experience.
+/// \param viewController The view controller from which to present the camera interface.
+/// This should typically be the currently visible view controller.
+///
+///
+/// throws:
+///
+/// <ul>
+///   <li>
+///     A <code>GSKScanFlowError</code>
+///   </li>
+/// </ul>
+///
+/// returns:
+/// A <code>GSKBarcodeScanFlowResult</code> containing the detected barcodes with their
+/// decoded values and format types.
+- (void)resultByStartingFromViewController:(UIViewController * _Nonnull)viewController completionHandler:(void (^ _Nonnull)(GSKBarcodeScanFlowResult * _Nullable, NSError * _Nullable))completionHandler;
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class AVCaptureMetadataOutput;
-@class AVMetadataObject;
-@class AVCaptureConnection;
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK)) <AVCaptureMetadataOutputObjectsDelegate>
-- (void)captureOutput:(AVCaptureMetadataOutput * _Nonnull)output didOutputMetadataObjects:(NSArray<AVMetadataObject *> * _Nonnull)metadataObjects fromConnection:(AVCaptureConnection * _Nonnull)connection;
+@class NSError;
+@interface GSKBarcodeScanFlow (SWIFT_EXTENSION(GSSDK))
+/// Instantiates a <code>GSKBarcodeScanFlow</code> instance with the provided configuration.
+/// This initializer is only available from Objective-C.
++ (nonnull instancetype)barcodeScanFlowWithConfiguration:(GSKBarcodeScanFlowConfiguration * _Nonnull)configuration SWIFT_WARN_UNUSED_RESULT;
+/// Starts the barcode scanning flow.
+/// @param viewController The view controller to present the barcode scanning interface from.
+/// @param successBlock A completion block/closure that will be called on the main
+/// thread upon successful completion of the scan flow. It receives a <code>GSKBarcodeScanFlowResult</code> object as
+/// a parameter. This object gives you access to the scanned codes.
+/// @param failureBlock A block/closure called if an error was encountered.
+/// This method is only available from Objective-C.
+- (void)startFromViewController:(UIViewController * _Nonnull)viewController success:(void (^ _Nonnull)(GSKBarcodeScanFlowResult * _Nonnull))successBlock failure:(void (^ _Nonnull)(NSError * _Nonnull))failureBlock;
 @end
 
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK))
-/// Manually take a photo
-/// If autoTriggerEnabled is true, the photo is taken automatically when the frame is detected.
-/// Otherwise, if you want to let the user manually trigger the photo, you can use this method.
-/// This method can be called even when activeDetectionMode is higlightAndTrigger and will force taking the
-/// photo.
-/// This method is thread-safe.
-/// IMPORTANT: Taking the photo will pause the session. You have to resume the session will <code>resumeSession</code> once
-/// you are done processing the result.
-- (void)takePhoto;
+@class UIColor;
+/// Configuration for the UI barcode scanning flow
+/// This class allows customization of which barcode and QR code formats should be detected
+/// during the scanning process. By default, all supported formats are enabled.
+SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
+@interface GSKBarcodeScanFlowConfiguration : NSObject
+/// Whether batch mode is enabled for code detection.
+/// This setting controls how codes are detected and when they are returned:
+/// <ul>
+///   <li>
+///     <code>false</code>: Detect multiple codes simultaneously in a single frame and return immediately (default)
+///   </li>
+///   <li>
+///     <code>true</code>: Collect multiple codes over time before returning when user taps Done
+///   </li>
+/// </ul>
+/// Example:
+/// \code
+/// // Standard mode - return codes immediately (default)
+/// let standardConfig = GSKBarcodeScanFlowConfiguration(isBatchModeEnabled: false)
+///
+/// // Batch mode - collect codes over time
+/// let batchConfig = GSKBarcodeScanFlowConfiguration(isBatchModeEnabled: true)
+///
+/// \endcode
+@property (nonatomic) BOOL isBatchModeEnabled;
+/// The highlight color used for the UI (overlay). Defaults
+/// to <code>.green</code>. For good contrast, we recommend using a bright color.
+@property (nonatomic, strong) UIColor * _Nonnull highlightColor;
+/// The menu color used for the UI. Defaults to <code>nil</code>, meaning that the system
+/// default color will be used (blue on iOS, for example).
+@property (nonatomic, strong) UIColor * _Nullable menuColor;
+/// Creates a new barcode scan flow configuration with default values
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
-@class AVCapturePhotoOutput;
-@class AVCaptureResolvedPhotoSettings;
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK)) <AVCapturePhotoCaptureDelegate>
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output willBeginCaptureForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output willCapturePhotoForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didCapturePhotoForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didFinishProcessingPhoto:(AVCapturePhoto * _Nonnull)photo error:(NSError * _Nullable)error;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didFinishCaptureForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings error:(NSError * _Nullable)error;
+@class NSDictionary;
+@interface GSKBarcodeScanFlowConfiguration (SWIFT_EXTENSION(GSSDK))
+/// Create a configuration from a dictionary.
+/// This is used for interfacing with cross-platform plugins but shouldn’t
+/// be used in native projects.
++ (GSKBarcodeScanFlowConfiguration * _Nullable)configurationWithDictionary:(NSDictionary * _Nonnull)dictionary error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
+/// Create a configuration from JSON data.
+/// This is used for interfacing with cross-platform plugins but shouldn’t
+/// be used in native projects.
++ (GSKBarcodeScanFlowConfiguration * _Nullable)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 @end
 
-/// The configuration for a camera session.
-SWIFT_CLASS("_TtC5GSSDK29GSKCameraSessionConfiguration")
-@interface GSKCameraSessionConfiguration : NSObject
-/// note:
-/// Deprecated in favor of <code>init(detectionMode:)</code> which allows for more flexible detection modes.
-/// \param documentDetection The type of real-time document detection to apply.
+/// The result of a barcode scanning flow.
+/// This class encapsulates the successful outcome of a barcode or QR code scanning session,
+/// containing the detected barcode or QR code data.
+SWIFT_CLASS("_TtC5GSSDK24GSKBarcodeScanFlowResult")
+@interface GSKBarcodeScanFlowResult : NSObject
+/// The detected barcodes containing their decoded values and types.
+/// This property provides access to an array of detected codes, each containing
+/// both the string content and format type (e.g., QR code, Code 128, EAN-13, etc.).
+/// <ul>
+///   <li>
+///     For standard mode: Contains all codes detected in a single frame
+///   </li>
+///   <li>
+///     For batch mode: Contains all codes collected over the scanning session
+///   </li>
+/// </ul>
+@property (nonatomic, readonly, copy) NSArray<GSKBarcode *> * _Nonnull barcodes;
+/// Creates a new barcode scan flow result.
+/// \param barcodes The detected barcodes.
 ///
-- (nonnull instancetype)initWithDocumentDetection:(enum GSKCameraSessionDocumentDetection)documentDetection OBJC_DESIGNATED_INITIALIZER SWIFT_DEPRECATED_MSG("Use init(detectionMode:) instead");
-/// A session configuration where the document detection is <code>.highlightAndAutoCapture</code>
-- (nonnull instancetype)init;
+- (nonnull instancetype)initWithBarcodes:(NSArray<GSKBarcode *> * _Nonnull)barcodes OBJC_DESIGNATED_INITIALIZER;
+- (nonnull instancetype)init SWIFT_UNAVAILABLE;
++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-/// The style of document detection to be used during a camera session.
-typedef SWIFT_ENUM(NSInteger, GSKCameraSessionDocumentDetection, open) {
-/// The session doesn’t attempt to detect documents.
-  GSKCameraSessionDocumentDetectionNone = 0,
-/// The session detects documents and produces quadrangles
-/// to be used for highlighting the document in the video frames.
-  GSKCameraSessionDocumentDetectionHighlight = 1,
-/// The session detects documents and snaps the photo when
-/// the detection is stable.
-  GSKCameraSessionDocumentDetectionHighlightAndTrigger = 2,
-};
+@interface GSKBarcodeScanFlowResult (SWIFT_EXTENSION(GSSDK))
+/// Returns a dictionary representation of the result
+/// The dictionary contains:
+/// <ul>
+///   <li>
+///     barcodes: An array of code dictionaries, each containing:
+///     <ul>
+///       <li>
+///         value: The decoded string value
+///       </li>
+///       <li>
+///         type: The code type as a string (e.g., “qr”, “code128”)
+///       </li>
+///     </ul>
+///   </li>
+/// </ul>
+@property (nonatomic, readonly, copy) NSDictionary<NSString *, id> * _Nonnull dictionary;
+/// Returns a JSON representation of the result.
+/// See <code>dictionary</code> for an explanation of the JSON data’s structure.
+- (NSString * _Nonnull)json SWIFT_WARN_UNUSED_RESULT;
+@end
 
 /// Represents an error raised by the camera session
 typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
@@ -455,83 +561,210 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
   GSKCameraSessionErrorWarnLockDevice = -1003,
 };
 
-typedef SWIFT_ENUM(NSInteger, GSKCameraSessionFlashStatus, open) {
-  GSKCameraSessionFlashStatusAuto = 0,
-  GSKCameraSessionFlashStatusOn = 1,
-  GSKCameraSessionFlashStatusOff = 2,
-};
-
 @class NSCoder;
-@protocol UIViewControllerTransitionCoordinator;
 @class NSBundle;
-/// A ready-to-use camera interface for scanning documents.
+/// A camera view controller to scan documents or barcodes.
+/// Inherit from this view controller to create a custom scanning experience. Lay out the <code>cameraView</code> as desired:
+/// By default, <code>cameraView</code> fills the entire screen. You can disable its resizing mask
+/// (<code>cameraView.translatesAutoresizingMaskIntoConstraints</code>) and use Auto Layout constraints.
+/// note:
+///
+/// When a photo of a document is taken, whether manually or automatically, the capture session is paused
+/// and a delegate callback (<code>cameraViewController(_:didGenerateScan:)</code>) is called when the photo is ready.
+/// In this callback, you can decide whether to exit the camera view controller (if you just need to scan a
+/// single page), or keep scanning more images (to support a “batch scanning” flow). For the latter scenario,
+/// you will need to resume the camera session (see <code>resume()</code>). You also need to “reveal” the shutter screen
+/// (see <code>hideShutterView(animated:)</code>).
 SWIFT_CLASS("_TtC5GSSDK23GSKCameraViewController")
 @interface GSKCameraViewController : UIViewController
+/// Requests camera access if needed.
+/// This returns immediately when access is already determined. It only shows the system prompt
+/// when access has not been requested yet.
+///
+/// returns:
+/// <code>true</code> when access is authorized.
++ (void)requestCameraAccessWithCompletionHandler:(void (^ _Nonnull)(BOOL))completionHandler;
 - (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE;
-- (nonnull instancetype)initWithCameraSession:(GSKCameraSession * _Nonnull)cameraSession OBJC_DESIGNATED_INITIALIZER;
-@property (nonatomic, readonly) BOOL prefersStatusBarHidden;
-- (void)loadView;
 - (void)viewDidLoad;
 - (void)viewWillAppear:(BOOL)animated;
 - (void)viewWillDisappear:(BOOL)animated;
-- (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id <UIViewControllerTransitionCoordinator> _Nonnull)coordinator;
+/// Manually trigger a photo.
+/// Use this to handle the user tapping on a “take photo” button, or your own
+/// custom logic to take a photo.
+- (void)takePhoto;
 - (nonnull instancetype)initWithNibName:(NSString * _Nullable)nibNameOrNil bundle:(NSBundle * _Nullable)nibBundleOrNil SWIFT_UNAVAILABLE;
 @end
 
-@class GSKView;
-@interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK)) <GSKViewDelegate>
-- (void)cameraView:(GSKView * _Nonnull)cameraView requestedFocusAtPoint:(CGPoint)focusPoint;
+@interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
 @end
 
+/// A document detection mode
+/// When detecting a document, the camera controller can just highlight the document, or also
+/// highlight and trigger the photo when the detection is stable enough.
+typedef SWIFT_ENUM(NSInteger, DocumentDetectionMode, open) {
+/// Visual highlighting only.
+/// The camera will detect document edges and provide visual feedback by drawing
+/// a document overlay, but will not automatically capture photos. Users must
+/// manually trigger photo capture.
+  DocumentDetectionModeHighlightOnly = 0,
+/// Highlighting with automatic capture.
+/// Similar to <code>highlightOnly</code>, but the camera will automatically take a photo
+/// when a stable document is detected for a sufficient duration. This provides
+/// a hands-free scanning experience.
+  DocumentDetectionModeHighlightAndAutoCapture = 1,
+};
+
 @interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
-/// Snap the photo
-- (void)takePhoto;
 @end
 
-@class GSKScan;
-@class GSKQuadrangle;
+/// Constants indicating an interruption reason for the camera session.
+typedef SWIFT_ENUM(NSInteger, InterruptionReason, open) {
+/// An interruption caused by the app being sent to the background while using a camera.
+  InterruptionReasonVideoDeviceNotAvailableInBackground = 0,
+/// An interruption caused by the audio hardware temporarily being made unavailable, for instance,
+/// for a phone call, or alarm.
+  InterruptionReasonAudioDeviceInUseByAnotherClient = 1,
+/// An interruption caused by the video device temporarily being made unavailable, for instance,
+/// when stolen away by another app.
+  InterruptionReasonVideoDeviceInUseByAnotherClient = 2,
+/// An interruption caused when the app is running in a multi-app layout, causing resource contention
+/// and degraded recording quality of service. Given your present session configuration, the
+/// session may only be run if your app occupies the full screen.
+  InterruptionReasonVideoDeviceNotAvailableWithMultipleForegroundApps = 3,
+/// An interruption caused by the video device temporarily being made unavailable due to system pressure,
+/// such as thermal duress.
+  InterruptionReasonVideoDeviceNotAvailableDueToSystemPressure = 4,
+  InterruptionReasonUnknown = 5,
+};
+
 @interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
-- (void)cameraSessionDidSetup:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession setupFailedWithError:(NSError * _Nonnull)error;
-- (void)cameraSessionWillSnapPhoto:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidSnapPhoto:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFailToSnapPhotoWithError:(NSError * _Nonnull)error;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didGenerateScan:(GSKScan * _Nonnull)scan;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didEncounterFailureWithError:(NSError * _Nonnull)error;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFailWithError:(NSError * _Nonnull)error;
-- (void)cameraSessionIsSearchingQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionIsAboutToChooseQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession willAutoTriggerWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFindQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
-- (void)cameraSessionFailedToFindQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidStart:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidStop:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession wasInterruptedWithReason:(enum AVCaptureSessionInterruptionReason)reason;
-- (void)cameraSessionInterruptionEnded:(GSKCameraSession * _Nonnull)cameraSession;
+/// Factory method for a camera view controller with document detection.
+/// This is only to be used from Objective-C. From Swift, prefer using <code>init(configuration:)</code> instead.
+/// \param documentDetectionMode The document detection mode.
+///
+/// \param documentOverlayColor The color of the document overlay.
+///
++ (void)makeCameraViewControllerWithDocumentDetectionMode:(enum DocumentDetectionMode)documentDetectionMode documentOverlayColor:(UIColor * _Nonnull)documentOverlayColor completionHandler:(void (^ _Nonnull)(GSKCameraViewController * _Nullable, NSError * _Nullable))completionHandler;
+@end
+
+@class GSKQuadrangle;
+@class GSKScan;
+SWIFT_PROTOCOL("_TtP5GSSDK31GSKCameraViewControllerDelegate_")
+@protocol GSKCameraViewControllerDelegate
+@optional
+/// The camera view controller failed with an error.
+/// \param cameraViewController The camera view controller
+///
+/// \param error The encountered error.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFailWithError:(NSError * _Nonnull)error;
+/// The camera view controller encountered a non-fatal error.
+/// \param cameraViewController The camera view controller
+///
+/// \param error The encountered error.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didEncounterNonCriticalError:(NSError * _Nonnull)error;
+/// The camera view controller started running
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidStart:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller stopped running
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidStop:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller was interrupted.
+/// This can happen in various cases, including when the user goes to Split View mode on iPad.
+/// \param cameraViewController The camera view controller
+///
+/// \param reason The reason why the camera view controller was interrupted.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController wasInterruptedWithReason:(enum InterruptionReason)reason;
+/// The camera view controller resumes after interruption
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerInterruptionDidEnd:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller is still looking for a quadrangle.
+/// This is a general notification about the status of the search: we may or may not have identified
+/// its edges. If you want to act on identified edges, listen to the <code>cameraViewController:didFindDocumentWithQuadrangle:</code>
+/// delegate method.
+/// <ul>
+///   <li>
+///     Parameters:
+///   </li>
+///   <li>
+///     cameraViewController: The camera view controller
+///   </li>
+/// </ul>
+- (void)cameraViewControllerIsSearchingForDocument:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller identified a document in the last frame of the photo stream
+/// \param cameraViewController The camera view controller
+///
+/// \param quadrangle The quadrangle of the document that has been found.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFindDocumentWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
+/// The camera view controller couldn’t identify a document in the last frame of the photo stream.
+/// This doesn’t mean that the camera view controller has stopped searching for documents or failed.
+/// It just means no document has been identified. In this case, you want to clear any overlay.
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerFailedToFindDocument:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller real-time document detection will soon take the photo of a quadrangle, but if the document
+/// detection is not stable enough, the process can still be
+/// cancelled.
+/// It’s a good time to tell the user to remain stable.
+/// Only called when the document detection is set to .highlightAndAutoCapture.
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerPhotoStabilizationDidStart:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller is going to automatically take a photo because the detection was stable enough.
+/// The photo taking is underway and cannot be interrupted at this stage.
+/// \param cameraViewController The camera view controller
+///
+/// \param quadrangle The quadrangle of the document that will be photographed.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController willSnapPhotoWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
+/// The camera view controller just took a photo, but it hasn’t been post-processed it yet
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidSnapPhoto:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller has finished processing the photo we just took.
+/// \param cameraViewController The camera view controller
+///
+/// \param scan The scan object that has been generated. The image contained in the scan object is the full,
+/// unprocessed image in which the document was detected. Use <code>GSKScanProcessor</code> to process and
+/// warp and enhance the scanned document.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didGenerateScan:(GSKScan * _Nonnull)scan;
+/// Camera view controller has detected barcodes.
+/// \param cameraViewController The camera view controller
+///
+/// \param barcodes The detected barcodes
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFindBarcodes:(NSArray<GSKBarcode *> * _Nonnull)barcodes;
 @end
 
 /// The type of document detected by the document finder.
 typedef SWIFT_ENUM(NSInteger, GSKDocumentFinderImageType, closed) {
 /// No document present in the image
   GSKDocumentFinderImageTypeNoDocument = 0,
-/// A document present in the image, but no crop, perspective correction have been applied
+/// A document is present in the image, but no crop or perspective correction has been applied.
   GSKDocumentFinderImageTypeUnwarped = 1,
-/// A document present in the image, and crop, perspective correction have been applied
+/// A document is present in the image, and crop and perspective correction have been applied.
   GSKDocumentFinderImageTypeWarped = 2,
-/// A document present in the image, crop/perspective correction and
-/// enhanced have been applied.
+/// A document is present in the image, and crop/perspective correction and
+/// enhancement have been applied.
   GSKDocumentFinderImageTypeEnhanced = 3,
 };
 
 @class GSKPDFDocument;
 @protocol GSKDocumentImageProcessor;
 @class GSKDocumentGeneratorConfiguration;
-/// This class exposes the capacility to generate a PDF document file.
+/// This class exposes the capability to generate a PDF or TIFF multi-page document file.
 SWIFT_CLASS("_TtC5GSSDK20GSKDocumentGenerator")
 @interface GSKDocumentGenerator : NSObject
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 /// Generates a document file based on a document model and a generator configuration.
-/// \param document The source document to generate as PDF.
+/// \param document The source document to generate as PDF or TIFF depending on the configuration.
 ///
 /// \param imageProcessor An object used to process each source document’s image before inserting it in the resulting document.
 /// Only used when generating a PDF document
@@ -540,7 +773,7 @@ SWIFT_CLASS("_TtC5GSSDK20GSKDocumentGenerator")
 ///
 - (BOOL)generate:(GSKPDFDocument * _Nonnull)document imageProcessor:(id <GSKDocumentImageProcessor> _Nonnull)imageProcessor configuration:(GSKDocumentGeneratorConfiguration * _Nonnull)configuration error:(NSError * _Nullable * _Nullable)error;
 /// Generates a document file based on a document model and a generator configuration.
-/// \param document The source document to generate as PDF.
+/// \param document The source document to generate as PDF or TIFF depending on the configuration.
 ///
 /// \param configuration The configuration for the document generation.
 ///
@@ -554,7 +787,7 @@ SWIFT_CLASS("_TtC5GSSDK33GSKDocumentGeneratorConfiguration")
 @interface GSKDocumentGeneratorConfiguration : NSObject
 + (GSKDocumentGeneratorConfiguration * _Nonnull)pdfConfigurationWithOutputFilePath:(NSString * _Nonnull)outputFilePath SWIFT_WARN_UNUSED_RESULT;
 + (GSKDocumentGeneratorConfiguration * _Nonnull)tiffConfigurationWithOutputFilePath:(NSString * _Nonnull)outputFilePath SWIFT_WARN_UNUSED_RESULT;
-/// The output file format of the document generator. Must be .pdf or .tif.
+/// The output file format of the document generator. Must be .pdf or .tiff.
 @property (nonatomic, readonly) enum GSKDocumentGeneratorFileFormat outputFileFormat;
 /// The path where the generated document will be written. The extension will not be validated.
 @property (nonatomic, readonly, copy) NSString * _Nonnull outputFilePath;
@@ -585,7 +818,7 @@ SWIFT_CLASS("_TtC5GSSDK33GSKDocumentGeneratorConfiguration")
 
 SWIFT_CLASS("_TtC5GSSDK38GSKDocumentGeneratorDebugConfiguration")
 @interface GSKDocumentGeneratorDebugConfiguration : NSObject
-/// If true, OCR’ed text will visible on the PDF.
+/// If true, OCR’ed text will be visible on the PDF.
 /// Defaults to false. Use this for debug only
 @property (nonatomic, readonly) BOOL isOCRTextShownOnPDF;
 - (nonnull instancetype)initWithIsOCRTextShownOnPDF:(BOOL)isOCRTextShownOnPDF OBJC_DESIGNATED_INITIALIZER;
@@ -629,6 +862,52 @@ SWIFT_PROTOCOL("_TtP5GSSDK25GSKDocumentImageProcessor_")
 - (NSString * _Nullable)process:(NSString * _Nonnull)inputFilePath SWIFT_WARN_UNUSED_RESULT;
 @end
 
+@class UIImage;
+@class UIView;
+/// A view controller that displays a scanned image with an interactive quadrangle overlay
+/// for manual cropping and perspective adjustment.
+/// <code>GSKEditFrameViewController</code> presents an image and allows the user to refine the detected
+/// document boundaries by dragging the quadrangle’s corner handles. As the user edits the
+/// quadrangle, changes are reflected in the <code>quadrangle</code> property, which is Key-Value
+/// Observing (KVO) compliant.
+/// The overlay’s appearance—including colors, handle size, transparency, and magnifier
+/// behavior—can be customized through the exposed properties. This view controller is
+/// typically used after automatic document detection, to let the user fine-tune the crop
+/// before further processing (such as perspective correction or export).
+SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
+@interface GSKEditFrameViewController : UIViewController
+/// The image on which the quadrangle is overlaid.
+@property (nonatomic, strong) UIImage * _Nonnull image;
+@property (nonatomic, readonly, strong) UIView * _Nonnull frameView;
+/// Used to set the quadrangle to display in the view controller, and to retrieve the new quadrangle edited by the user.
+@property (nonatomic, strong) GSKQuadrangle * _Nonnull quadrangle;
+/// Insets applied around the image.
+/// By default this matches half the quadrangle overlay handle width, so handles remain visible even when
+/// the corners are on the edge of the image.
+@property (nonatomic) CGFloat inset;
+/// Customize the color of the shade within the quadrangle.
+@property (nonatomic, strong) UIColor * _Nonnull shadeColor SWIFT_DEPRECATED_MSG("Deprecated in favor of frameView.imageSelection.insideShadeColor.");
+/// Customize the color of the shade outside the quadrangle.
+@property (nonatomic, strong) UIColor * _Nonnull outsideShadeColor;
+/// Customize the color of the line used to draw the quadrangle.
+@property (nonatomic, strong) UIColor * _Nonnull lineColor;
+/// Customize the width of the corner handles.
+@property (nonatomic) CGFloat handleWidth;
+/// Customize the transparency of the entire overlay
+@property (nonatomic) CGFloat overlayAlpha;
+/// Customize the magnifier center style shown while dragging corners.
+@property (nonatomic) GSKMagnifierViewCenterStyle magnifierViewCenterStyle;
+/// \param image The image on which to draw the quadrangle. This is typically the original photo from the camera.
+///
+/// \param quadrangle The initial quadrangle to display.
+///
+- (nonnull instancetype)initWithImage:(UIImage * _Nonnull)image quadrangle:(GSKQuadrangle * _Nonnull)quadrangle OBJC_DESIGNATED_INITIALIZER;
+- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE;
+- (void)setQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle animated:(BOOL)animated;
+- (void)viewDidLoad;
+- (nonnull instancetype)initWithNibName:(NSString * _Nullable)nibNameOrNil bundle:(NSBundle * _Nullable)nibBundleOrNil SWIFT_UNAVAILABLE;
+@end
+
 /// A configuration to specify the background cleaning to apply with GSKScanProcessor.
 SWIFT_CLASS("_TtC5GSSDK40GSKFilterBackgroundCleaningConfiguration")
 @interface GSKFilterBackgroundCleaningConfiguration : NSObject
@@ -794,6 +1073,12 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) GSKFilterLig
 - (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT;
 @end
 
+typedef SWIFT_ENUM(NSInteger, GSKFlashStatus, open) {
+  GSKFlashStatusAuto = 0,
+  GSKFlashStatusOn = 1,
+  GSKFlashStatusOff = 2,
+};
+
 enum GSKIntegrationFramework : NSInteger;
 SWIFT_CLASS_NAMED("GSKIntegrationContext")
 @interface GSKIntegrationContext : NSObject
@@ -833,14 +1118,14 @@ SWIFT_CLASS("_TtC5GSSDK6GSKOCR")
 /// The OCR decides what post-processing to apply for the best results.
 ///
 /// \param configuration Configuration for the OCR process, in particular the language in which the OCR is
-/// performed. Note that you must provided the appropriate trained data.
+/// performed. Note that you must provide the appropriate trained data.
 ///
 /// \param progressBlock The progress between 0 and 1. Called on the same thread.
 ///
 ///
 /// returns:
 /// An OCR result.
-- (void)recognizeTextForImageAtPath:(NSString * _Nonnull)imagePath ocrConfiguration:(GSKOCRConfiguration * _Nonnull)configuration onProgress:(void (^ _Nullable)(float))progressBlock completionHandler:(void (^ _Nonnull)(GSKOCRResult * _Nullable, NSError * _Nullable))completionHandler;
+- (void)recognizeTextForImageAtPath:(NSString * _Nonnull)imagePath configuration:(GSKOCRConfiguration * _Nonnull)configuration onProgress:(void (^ _Nullable)(float))progressBlock completionHandler:(void (^ _Nonnull)(GSKOCRResult * _Nullable, NSError * _Nullable))completionHandler;
 @end
 
 /// The configuration for an OCR operation.
@@ -928,186 +1213,6 @@ SWIFT_CLASS("_TtC5GSSDK10GSKPDFSize")
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class GSKReadableCodeFlowConfiguration;
-@class GSKReadableCodeFlowResult;
-/// A flow for scanning readable codes (barcodes, QR codes, etc.)
-SWIFT_CLASS("_TtC5GSSDK19GSKReadableCodeFlow")
-@interface GSKReadableCodeFlow : NSObject
-/// Initializes a new readable code flow
-/// \param configuration Configuration for the readable code scanning
-///
-- (nonnull instancetype)initWithConfiguration:(GSKReadableCodeFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
-/// Starts the readable code scanning flow by presenting a full-screen camera interface.
-/// This method presents a camera view controller that continuously scans for barcodes and QR codes.
-/// The scanning process respects the code types specified in the flow’s configuration.
-/// The method uses Swift’s async/await pattern, suspending until either:
-/// <ul>
-///   <li>
-///     A readable code is successfully detected (except in batch mode)
-///   </li>
-///   <li>
-///     The user taps the done button (batch mode)
-///   </li>
-///   <li>
-///     The user cancels the operation
-///   </li>
-///   <li>
-///     An error occurs during setup or scanning
-///   </li>
-/// </ul>
-/// The behavior varies based on the configuration’s isBatchModeEnabled:
-/// <ul>
-///   <li>
-///     <code>false</code>: Returns immediately after detecting one or more codes in a single frame
-///   </li>
-///   <li>
-///     <code>true</code>: Collects unique codes over time until the user taps the done button
-///   </li>
-/// </ul>
-/// Example usage:
-/// \code
-/// let flow = GSKReadableCodeFlow()
-/// do {
-///     let result = try await flow.resultByStarting(fromViewController: self)
-///     print("Scanned codes: \(result.readableCodes.map { $0.value })")
-/// } catch GSKReadableCodeFlowError.userCancellation {
-///     print("User canceled scanning")
-/// } catch {
-///     print("Scanning failed: \(error)")
-/// }
-///
-/// \endcodeimportant:
-/// This method requires camera permissions. Ensure your app’s Info.plist includes
-/// the <code>NSCameraUsageDescription</code> key with an appropriate description.
-/// note:
-/// The camera interface is presented with <code>modalPresentationStyle</code> set to <code>.fullScreen</code>
-/// for an immersive scanning experience.
-/// \param viewController The view controller from which to present the camera interface.
-/// This should typically be the currently visible view controller.
-///
-///
-/// throws:
-///
-/// <ul>
-///   <li>
-///     Typically throws a <code>GSKReadableCodeFlowError</code>
-///   </li>
-/// </ul>
-///
-/// returns:
-/// A <code>GSKReadableCodeFlowResult</code> containing the detected readable codes with their
-/// decoded values and format types.
-- (void)resultByStartingFromViewController:(UIViewController * _Nonnull)viewController completionHandler:(void (^ _Nonnull)(GSKReadableCodeFlowResult * _Nullable, NSError * _Nullable))completionHandler;
-- (nonnull instancetype)init SWIFT_UNAVAILABLE;
-+ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
-@end
-
-@class NSError;
-@interface GSKReadableCodeFlow (SWIFT_EXTENSION(GSSDK))
-/// Instantiates a <code>GSKReadableCodeFlow</code> instance with the provided configuration.
-/// This initializer is only available from Objective-C.
-+ (nonnull instancetype)readableCodeFlowWithConfiguration:(GSKReadableCodeFlowConfiguration * _Nonnull)configuration SWIFT_WARN_UNUSED_RESULT;
-/// Starts the readable code scanning flow.
-/// @param viewController The view controller to present the readable code scanning interface from.
-/// @param successBlock A completion block/closure that will be called on the main
-/// thread upon successful completion of the scan flow. It receives a <code>GSKReadableCodeFlowResult</code> object as
-/// a parameter. This object gives you access to the scanned codes.
-/// @param failureBlock A block/closure called if an error was encountered.
-/// This method is only available from Objective-C.
-- (void)startFromViewController:(UIViewController * _Nonnull)viewController success:(void (^ _Nonnull)(GSKReadableCodeFlowResult * _Nonnull))successBlock failure:(void (^ _Nonnull)(NSError * _Nonnull))failureBlock;
-@end
-
-@class UIColor;
-/// Configuration for the UI readable code scanning flow
-/// This class allows customization of which barcode and QR code formats should be detected
-/// during the scanning process. By default, all supported formats are enabled.
-SWIFT_CLASS("_TtC5GSSDK32GSKReadableCodeFlowConfiguration")
-@interface GSKReadableCodeFlowConfiguration : NSObject
-/// Whether batch mode is enabled for code detection.
-/// This setting controls how codes are detected and when they are returned:
-/// <ul>
-///   <li>
-///     <code>false</code>: Detect multiple codes simultaneously in a single frame and return immediately (default)
-///   </li>
-///   <li>
-///     <code>true</code>: Collect multiple codes over time before returning when user taps Done
-///   </li>
-/// </ul>
-/// Example:
-/// \code
-/// // Standard mode - return codes immediately (default)
-/// let standardConfig = GSKReadableCodeFlowConfiguration(isBatchModeEnabled: false)
-///
-/// // Batch mode - collect codes over time
-/// let batchConfig = GSKReadableCodeFlowConfiguration(isBatchModeEnabled: true)
-///
-/// \endcode
-@property (nonatomic) BOOL isBatchModeEnabled;
-/// The highlight color used for the UI (overlay). Defaults
-/// to <code>.green</code>. For good constrast, we recommend using a bright color.
-@property (nonatomic, strong) UIColor * _Nonnull highlightColor;
-/// The menu color used for the UI. Defaults to <code>nil</code>, meaning that the system
-/// default color will be used (blue on iOS, for example).
-@property (nonatomic, strong) UIColor * _Nullable menuColor;
-/// Creates a new readable code flow configuration with default values
-- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
-@end
-
-@interface GSKReadableCodeFlowConfiguration (SWIFT_EXTENSION(GSSDK))
-/// Create a configuration from a dictionary.
-/// This is used for interfacing with cross-platform plugins but shouldn’t
-/// be used in native projects.
-+ (GSKReadableCodeFlowConfiguration * _Nullable)configurationWithDictionary:(NSDictionary * _Nonnull)dictionary error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
-/// Create a configuration from JSON data.
-/// This is used for interfacing with cross-platform plugins but shouldn’t
-/// be used in native projects.
-+ (GSKReadableCodeFlowConfiguration * _Nullable)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
-@end
-
-/// Enum that defines various errors that can occur during a readable code flow.
-typedef SWIFT_ENUM(NSInteger, GSKReadableCodeFlowError, open) {
-/// User has canceled the readable code flow
-  GSKReadableCodeFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 0,
-/// A general error due to a bad configuration parameter
-  GSKReadableCodeFlowConfigurationError SWIFT_COMPILE_NAME("configuration") = 1,
-/// Camera permission was denied
-  GSKReadableCodeFlowPermissionDeniedError SWIFT_COMPILE_NAME("permissionDenied") = 2,
-/// Failed to initialize the barcode detector
-  GSKReadableCodeFlowDetectorError SWIFT_COMPILE_NAME("detectorError") = 3,
-};
-static NSString * _Nonnull const GSKReadableCodeFlowErrorDomain = @"GSSDK.GSKReadableCodeFlowError";
-
-/// The result of a readable code scanning flow
-/// This class encapsulates the successful outcome of a readable code scanning session,
-/// containing the detected barcode or QR code data.
-SWIFT_CLASS("_TtC5GSSDK25GSKReadableCodeFlowResult")
-@interface GSKReadableCodeFlowResult : NSObject
-- (nonnull instancetype)init SWIFT_UNAVAILABLE;
-+ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
-@end
-
-@interface GSKReadableCodeFlowResult (SWIFT_EXTENSION(GSSDK))
-/// Returns a dictionary representation of the result
-/// The dictionary contains:
-/// <ul>
-///   <li>
-///     readableCodes: An array of code dictionaries, each containing:
-///     <ul>
-///       <li>
-///         value: The decoded string value
-///       </li>
-///       <li>
-///         type: The code type as a string (e.g., “qr”, “code128”)
-///       </li>
-///     </ul>
-///   </li>
-/// </ul>
-@property (nonatomic, readonly, copy) NSDictionary<NSString *, id> * _Nonnull dictionary;
-/// Returns a JSON representation of the result.
-/// See <code>dictionary</code> for an explanation of the JSON data’s structure.
-- (NSString * _Nonnull)json SWIFT_WARN_UNUSED_RESULT;
-@end
-
 typedef SWIFT_ENUM(NSInteger, GSKReceiptCategory, open) {
   GSKReceiptCategoryGas = 0,
   GSKReceiptCategoryTransportation = 1,
@@ -1126,9 +1231,15 @@ SWIFT_CLASS("_TtC5GSSDK13GSKReceiptVAT")
 @end
 
 @class GSKScanFlowConfiguration;
-/// A high-level scanner module.
-/// You present it and when the user is done, you obtain a result object containing the scanned documents.
-/// The scan flow can be customized with a <code>GSKScanFlowConfiguration</code> instance.
+/// A UI-driven scan flow for turning physical documents into processed digital pages.
+/// Create an instance with <code>GSKScanFlowConfiguration</code> to choose the source
+/// (camera, photo library, or image URL), multi-page behavior, output format,
+/// filters, OCR, and structured-data extraction. Present the flow from a view
+/// controller and await a <code>GSKScanFlowResult</code> with the captured pages and the
+/// optional multi-page document.
+/// important:
+/// If you start a scan flow with the camera, your app must declare the
+/// <code>NSCameraUsageDescription</code> key in <code>Info.plist</code>.
 SWIFT_CLASS("_TtC5GSSDK11GSKScanFlow")
 @interface GSKScanFlow : NSObject
 - (nonnull instancetype)initWithConfiguration:(GSKScanFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
@@ -1247,17 +1358,29 @@ SWIFT_CLASS("_TtC5GSSDK24GSKScanFlowConfiguration")
 + (nullable instancetype)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 @end
 
-/// Enum that defines various errors that can occur during a scan flow.
-typedef SWIFT_ENUM(NSInteger, GSKScanFlowError, open) {
+/// Enum that defines various numeric error codes that can occur during a scan flow.
+typedef SWIFT_ENUM(NSInteger, GSKScanFlowErrorCode, open) {
 /// User has canceled the scan flow
-  GSKScanFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 999,
-/// A general error due to a bad input parameter. Verify that your
+  GSKScanFlowCancellationErrorCode SWIFT_COMPILE_NAME("cancellation") = 999,
+/// A general error due to an incorrect configuration. Verify that your
 /// inputs match the API requirements.
-  GSKScanFlowBadInputError SWIFT_COMPILE_NAME("badInput") = 1000,
+  GSKScanFlowConfigurationErrorCode SWIFT_COMPILE_NAME("configuration") = 1000,
+/// A licensing error. This is a developer error and you should contact the
+/// Genius Scan SDK support team to make sure you have a valid license key.
+  GSKScanFlowLicensingErrorCode SWIFT_COMPILE_NAME("licensing") = 1001,
+/// An error that happened while capturing the scans. This can sometimes be recovered
+/// by restarting the device.
+  GSKScanFlowCaptureErrorCode SWIFT_COMPILE_NAME("capture") = 1002,
+/// An error caused by low storage space. This can be recovered by cleaning up
+/// storage space and trying again.
+  GSKScanFlowStorageSpaceErrorCode SWIFT_COMPILE_NAME("storageSpace") = 1003,
+/// An internal error. This is a catch-all category, and the underlying error will
+/// give more details.
+  GSKScanFlowInternalErrorCode SWIFT_COMPILE_NAME("internal") = 9999,
 };
 
 /// The different possible filters for the scanner UI.
-/// All cases match <code>GSKFilterType</code> values except <code>.automatic</code>.
+/// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {
   GSKScanFlowFilterNone SWIFT_COMPILE_NAME("none") = 0,
 /// Automatic filter
@@ -1298,8 +1421,8 @@ typedef SWIFT_ENUM(NSUInteger, GSKScanFlowFlashMode, open) {
 /// The format of the exported document.
 typedef SWIFT_ENUM(NSUInteger, GSKScanFlowMultiPageFormat, open) {
   GSKScanFlowNone SWIFT_COMPILE_NAME("none") = 0,
-  GSKScanFlowPDF SWIFT_COMPILE_NAME("PDF") = 1,
-  GSKScanFlowTIFF SWIFT_COMPILE_NAME("TIFF") = 2,
+  GSKScanFlowPDF SWIFT_COMPILE_NAME("pdf") = 1,
+  GSKScanFlowTIFF SWIFT_COMPILE_NAME("tiff") = 2,
 };
 
 /// The configuration for text recognition
@@ -1338,9 +1461,9 @@ typedef SWIFT_ENUM(NSUInteger, GSKScanFlowPDFPageSize, open) {
 SWIFT_CLASS("_TtC5GSSDK17GSKScanFlowResult")
 @interface GSKScanFlowResult : NSObject
 /// Document containing the pages that were scanned during the scan
-/// flow. The format is specified by <code>multiPageFormat</code> property of
-/// the used <code>GSKScanFlowConfiguration</code>. Is <code>nil</code> if no format was
-/// specified or if generation failed.
+/// flow. The format is specified by the <code>multiPageFormat</code> property of
+/// the <code>GSKScanFlowConfiguration</code> used for the scan flow. This is <code>nil</code>
+/// when <code>multiPageFormat</code> is <code>.none</code> or if document generation failed.
 @property (nonatomic, copy) NSURL * _Nullable multiPageDocumentURL;
 /// The individual scans taken during the scan flow.
 /// Each scan object contains both the original and the enhanced scans.
@@ -1373,7 +1496,7 @@ SWIFT_CLASS("_TtC5GSSDK15GSKScanFlowScan")
 /// If OCR was performed, the recognized text.
 @property (nonatomic, strong) GSKScanFlowOCRResult * _Nullable ocrResult;
 /// If structured data extraction was performed, the structured data.
-@property (nonatomic, strong) GSKScanFlowStructuredDataResult * _Nullable structuredDataResult;
+@property (nonatomic, strong) GSKScanFlowStructuredDataResult * _Nullable structuredData;
 - (nonnull instancetype)initWithOriginalFilePath:(NSString * _Nonnull)originalFilePath enhancedFilePath:(NSString * _Nonnull)enhancedFilePath OBJC_DESIGNATED_INITIALIZER;
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
@@ -1403,6 +1526,8 @@ SWIFT_CLASS("_TtC5GSSDK31GSKScanFlowStructuredDataResult")
 /// Present if receipt extraction was requested and a receipt/invoice was
 /// successfully extracted, <code>nil</code> otherwise.
 @property (nonatomic, strong) GSKStructuredDataReceipt * _Nullable receipt;
+/// Present if barcode extraction was requested and codes were successfully extracted, empty otherwise.
+@property (nonatomic, copy) NSArray<GSKBarcode *> * _Nonnull barcodes;
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
@@ -1542,23 +1667,19 @@ SWIFT_CLASS("_TtC5GSSDK13GSKTextLayout")
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class GSKTextLayoutToTextConverterResult;
+/// Converts an OCR text layout into plain text.
+/// A <code>GSKOCRResult</code> contains both raw text and a <code>GSKTextLayout</code>, which preserves spatial information such as
+/// bounding boxes and line/word positions. This converter reconstructs the raw text from a <code>GSKTextLayout</code> by
+/// traversing its bounding boxes in reading order and grouping content into paragraphs.
+/// Use this when you want to retain only the spatial representation (for highlighting, selection, reflow, etc.)
+/// and regenerate the plain-text representation on demand, rather than storing both.
 SWIFT_CLASS("_TtC5GSSDK28GSKTextLayoutToTextConverter")
 @interface GSKTextLayoutToTextConverter : NSObject
-- (GSKTextLayoutToTextConverterResult * _Nullable)convert:(GSKTextLayout * _Nonnull)textLayout error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
 SWIFT_CLASS("_TtC5GSSDK34GSKTextLayoutToTextConverterResult")
 @interface GSKTextLayoutToTextConverterResult : NSObject
-/// The text reconstructed from the text layout.
-@property (nonatomic, readonly, copy) NSString * _Nonnull text;
-/// The average word confidence of the recognized text.
-/// A value between 0 and 100
-@property (nonatomic, readonly) NSInteger averageWordConfidence;
-/// The number of words in the recognized text.
-/// This is the number of words on which the average word confidence has been computed.
-@property (nonatomic, readonly) NSInteger wordCount;
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
@@ -1571,12 +1692,6 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) GSKUIBackgro
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
-@interface GSKView (SWIFT_EXTENSION(GSSDK))
-- (void)startSearchAnimation;
-- (void)startSnapAnimationWithDuration:(NSTimeInterval)duration;
-- (void)endSnapAnimation;
-@end
-
 SWIFT_CLASS("_TtC5GSSDK14GSSDKResources")
 @interface GSSDKResources : NSObject
 SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) NSBundle * _Nonnull bundle;)