@thegrizzlylabs/react-native-genius-scan 6.0.0-beta01 → 6.0.0-beta03

package/ios/GSSDK/GSSDK.xcframework/ios-arm64_x86_64-simulator/GSSDK.framework/Headers/GSSDK-Swift.h

@@ -1,6 +1,6 @@
 #if 0
 #elif defined(__arm64__) && __arm64__
-// Generated by Apple Swift version 6.2 effective-5.10 (swiftlang-6.2.0.19.9 clang-1700.3.19.1)
+// Generated by Apple Swift version 6.2.3 effective-5.10 (swiftlang-6.2.3.3.21 clang-1700.6.3.2)
 #ifndef GSSDK_SWIFT_H
 #define GSSDK_SWIFT_H
 #pragma clang diagnostic push
@@ -359,7 +359,14 @@ SWIFT_CLASS("_TtC5GSSDK10GSKBarcode")
 @class GSKBarcodeScanFlowConfiguration;
 @class UIViewController;
 @class GSKBarcodeScanFlowResult;
-/// A flow for scanning barcodes and QR codes.
+/// 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:
+/// Camera access requires <code>NSCameraUsageDescription</code> in
+/// <code>Info.plist</code>.
 SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 @interface GSKBarcodeScanFlow : NSObject
 /// Initializes a new barcode scan flow
@@ -399,7 +406,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 /// do {
 ///     let result = try await flow.resultByStarting(fromViewController: self)
 ///     print("Scanned codes: \(result.barcodes.map { $0.value })")
-/// } catch GSKBarcodeScanFlowError.userCancellation {
+/// } catch GSKScanFlowError.cancellation {
 ///     print("User canceled scanning")
 /// } catch {
 ///     print("Scanning failed: \(error)")
@@ -419,7 +426,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 ///
 /// <ul>
 ///   <li>
-///     Typically throws a <code>GSKBarcodeScanFlowError</code>
+///     A <code>GSKScanFlowError</code>
 ///   </li>
 /// </ul>
 ///
@@ -473,7 +480,7 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 /// \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.
+/// 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).
@@ -494,19 +501,6 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 + (GSKBarcodeScanFlowConfiguration * _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 barcode scan flow.
-typedef SWIFT_ENUM(NSInteger, GSKBarcodeScanFlowError, open) {
-/// User has canceled the barcode scan flow
-  GSKBarcodeScanFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 0,
-/// A general error due to a bad configuration parameter
-  GSKBarcodeScanFlowConfigurationError SWIFT_COMPILE_NAME("configuration") = 1,
-/// Camera permission was denied
-  GSKBarcodeScanFlowPermissionDeniedError SWIFT_COMPILE_NAME("permissionDenied") = 2,
-/// Failed to initialize the barcode detector
-  GSKBarcodeScanFlowDetectorError SWIFT_COMPILE_NAME("detectorError") = 3,
-};
-static NSString * _Nonnull const GSKBarcodeScanFlowErrorDomain = @"GSSDK.GSKBarcodeScanFlowError";
-
 /// 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.
@@ -572,7 +566,7 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// 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.translateAutoresizingMaskIntoConstraints</code>) and use Auto Layout constraints.
+/// (<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
@@ -580,9 +574,16 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// 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>.
+/// (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;
 - (void)viewDidLoad;
 - (void)viewWillAppear:(BOOL)animated;
@@ -746,24 +747,24 @@ SWIFT_PROTOCOL("_TtP5GSSDK31GSKCameraViewControllerDelegate_")
 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
@@ -772,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.
 ///
@@ -786,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;
@@ -817,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;
@@ -863,6 +864,16 @@ SWIFT_PROTOCOL("_TtP5GSSDK25GSKDocumentImageProcessor_")
 
 @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.
@@ -870,6 +881,10 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @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.
@@ -878,6 +893,8 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @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.
@@ -1101,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.
@@ -1214,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;
@@ -1335,15 +1358,33 @@ 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,
 };
 
+SWIFT_CLASS("_TtC5GSSDK26GSKScanFlowErrorCodeBridge")
+@interface GSKScanFlowErrorCodeBridge : NSObject
++ (NSString * _Nonnull)stringCodeForRawValue:(NSInteger)rawValue SWIFT_WARN_UNUSED_RESULT;
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
 /// The different possible filters for the scanner UI.
 /// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {
@@ -1386,8 +1427,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
@@ -1426,9 +1467,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.
@@ -1632,23 +1673,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
@@ -1688,7 +1725,7 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) NSBundle * _
 #endif
 
 #elif defined(__x86_64__) && __x86_64__
-// Generated by Apple Swift version 6.2 effective-5.10 (swiftlang-6.2.0.19.9 clang-1700.3.19.1)
+// Generated by Apple Swift version 6.2.3 effective-5.10 (swiftlang-6.2.3.3.21 clang-1700.6.3.2)
 #ifndef GSSDK_SWIFT_H
 #define GSSDK_SWIFT_H
 #pragma clang diagnostic push
@@ -2047,7 +2084,14 @@ SWIFT_CLASS("_TtC5GSSDK10GSKBarcode")
 @class GSKBarcodeScanFlowConfiguration;
 @class UIViewController;
 @class GSKBarcodeScanFlowResult;
-/// A flow for scanning barcodes and QR codes.
+/// 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:
+/// Camera access requires <code>NSCameraUsageDescription</code> in
+/// <code>Info.plist</code>.
 SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 @interface GSKBarcodeScanFlow : NSObject
 /// Initializes a new barcode scan flow
@@ -2087,7 +2131,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 /// do {
 ///     let result = try await flow.resultByStarting(fromViewController: self)
 ///     print("Scanned codes: \(result.barcodes.map { $0.value })")
-/// } catch GSKBarcodeScanFlowError.userCancellation {
+/// } catch GSKScanFlowError.cancellation {
 ///     print("User canceled scanning")
 /// } catch {
 ///     print("Scanning failed: \(error)")
@@ -2107,7 +2151,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 ///
 /// <ul>
 ///   <li>
-///     Typically throws a <code>GSKBarcodeScanFlowError</code>
+///     A <code>GSKScanFlowError</code>
 ///   </li>
 /// </ul>
 ///
@@ -2161,7 +2205,7 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 /// \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.
+/// 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).
@@ -2182,19 +2226,6 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 + (GSKBarcodeScanFlowConfiguration * _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 barcode scan flow.
-typedef SWIFT_ENUM(NSInteger, GSKBarcodeScanFlowError, open) {
-/// User has canceled the barcode scan flow
-  GSKBarcodeScanFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 0,
-/// A general error due to a bad configuration parameter
-  GSKBarcodeScanFlowConfigurationError SWIFT_COMPILE_NAME("configuration") = 1,
-/// Camera permission was denied
-  GSKBarcodeScanFlowPermissionDeniedError SWIFT_COMPILE_NAME("permissionDenied") = 2,
-/// Failed to initialize the barcode detector
-  GSKBarcodeScanFlowDetectorError SWIFT_COMPILE_NAME("detectorError") = 3,
-};
-static NSString * _Nonnull const GSKBarcodeScanFlowErrorDomain = @"GSSDK.GSKBarcodeScanFlowError";
-
 /// 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.
@@ -2260,7 +2291,7 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// 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.translateAutoresizingMaskIntoConstraints</code>) and use Auto Layout constraints.
+/// (<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
@@ -2268,9 +2299,16 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// 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>.
+/// (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;
 - (void)viewDidLoad;
 - (void)viewWillAppear:(BOOL)animated;
@@ -2434,24 +2472,24 @@ SWIFT_PROTOCOL("_TtP5GSSDK31GSKCameraViewControllerDelegate_")
 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
@@ -2460,7 +2498,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.
 ///
@@ -2474,7 +2512,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;
@@ -2505,7 +2543,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;
@@ -2551,6 +2589,16 @@ SWIFT_PROTOCOL("_TtP5GSSDK25GSKDocumentImageProcessor_")
 
 @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.
@@ -2558,6 +2606,10 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @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.
@@ -2566,6 +2618,8 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @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.
@@ -2789,14 +2843,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.
@@ -2902,9 +2956,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;
@@ -3023,15 +3083,33 @@ 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,
 };
 
+SWIFT_CLASS("_TtC5GSSDK26GSKScanFlowErrorCodeBridge")
+@interface GSKScanFlowErrorCodeBridge : NSObject
++ (NSString * _Nonnull)stringCodeForRawValue:(NSInteger)rawValue SWIFT_WARN_UNUSED_RESULT;
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
 /// The different possible filters for the scanner UI.
 /// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {
@@ -3074,8 +3152,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
@@ -3114,9 +3192,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.
@@ -3320,23 +3398,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