react-native-scanbot-barcode-scanner-sdk 5.1.2-alpha.1 → 6.1.0-rc.1

package/src/ui_v2/barcode/BarcodeRecognizerConfiguration.ts

@@ -1,14 +1,14 @@
 import { DeepPartial, PartiallyConstructible } from '../../utils';
 
 /**
-Expected quantity of QR codes in an image.
+The customer format used in AUSTRALIA_POST codes. Only relevant for format codes 59 and 62.
 
-- `LOW`:
-   Up to 6 QR codes per image.
-- `HIGH`:
-   Up to 24 QR codes per image.
+- `NUMERIC`:
+   The numeric format.
+- `ALPHA_NUMERIC`:
+   The alphanumeric format.
 */
-export type CodeDensity = 'LOW' | 'HIGH';
+export type AustraliaPostCustomerFormat = 'NUMERIC' | 'ALPHA_NUMERIC';
 
 /**
 Type of MSI plessey checksum algorithm used.
@@ -41,15 +41,25 @@ export type MSIPlesseyChecksumAlgorithm =
 GS1_COMPOSITE barcode type handling
 
 - `NONE`:
-   No special handling for GS1-formatted results. Special (FNC1) characters are stripped.
+   The (FNC1) character is simply stripped from the result in barcodes that implement this mode. Do not use. Will be removed in a future release.
 - `PARSE`:
-   GS1 messages are converted to machine-readable format per the GS1 spec (the special character is converted to ASCII \x1D). Message is not validated. The implied 01 AI key is prepended to DataBar results.
-- `VALIDATE`:
-   GS1 messages are converted to machine-readable format per the GS1 spec (the special character is converted to ASCII \x1D) and validated. The implied 01 AI key is prepended to DataBar results. Invalid messages are not returned.
-- `DECODE`:
-   GS1 strings are converted to human-readable format and validated. The implied (01) AI key is prepended to DataBar results. Invalid messages are not returned.
+   GS1 messages are converted to the machine-readable format per the GS1 spec (the special FNC1 character is converted to ASCII \x1D). The implied 01 AI key is prepended to DataBar results. No validation is performed.
+- `VALIDATE_STRUCTURE`:
+   Same as PARSE. Additionally, messages containing unknown AI keys, or containing values of incorrect format for known keys, are not returned.
+- `DECODE_STRUCTURE`:
+   Same as VALIDATE_STRUCTURE, except that GS1 strings are converted to the human-readable format, instead (with parentheses used to wrap AI keys, e.g. (01)123456789). The \x1D character is never used in this representation.
+- `VALIDATE_FULL`:
+   Full validation including linting and checksums. This is the most strict mode.
+- `DECODE_FULL`:
+   Same as DECODE_STRUCTURE, but with full validation.
 */
-export type Gs1Handling = 'NONE' | 'PARSE' | 'VALIDATE' | 'DECODE';
+export type Gs1Handling =
+  | 'NONE'
+  | 'PARSE'
+  | 'VALIDATE_STRUCTURE'
+  | 'DECODE_STRUCTURE'
+  | 'VALIDATE_FULL'
+  | 'DECODE_FULL';
 
 /**
 Type of barcode document format used.
@@ -143,6 +153,14 @@ Barcode symbology used.
    GS1 Composite
 - `MICRO_PDF_417`:
    Databar micro pdf 417
+- `MAXI_CODE`:
+   Maxicode
+- `RMQR_CODE`:
+   RMQR code
+- `CODE_11`:
+   Code 11 barcode type
+- `CODE_32`:
+   Code 32 barcode type
 */
 export type BarcodeFormat =
   | 'AZTEC'
@@ -172,7 +190,11 @@ export type BarcodeFormat =
   | 'AUSTRALIA_POST'
   | 'DATABAR_LIMITED'
   | 'GS1_COMPOSITE'
-  | 'MICRO_PDF_417';
+  | 'MICRO_PDF_417'
+  | 'MAXI_CODE'
+  | 'RMQR_CODE'
+  | 'CODE_11'
+  | 'CODE_32';
 
 /**
 Filter for extended EAN and UPC barcodes.
@@ -227,6 +249,16 @@ export class BarcodeRecognizerConfiguration extends PartiallyConstructible {
     Default is false
     */
   public stripCheckDigits: boolean = false;
+  /**
+    If `true`, the optional check digit for IATA_2_OF_5 codes is used in validation. The default is `true`.
+    Default is true
+    */
+  public useIATA2OF5Checksum: boolean = true;
+  /**
+    If `true`, the optional check digit for CODE_11 codes is used in validation. The default is `true`.
+    Default is true
+    */
+  public useCode11Checksum: boolean = true;
   /**
     List of accepted barcode symbologies.
     */
@@ -236,16 +268,16 @@ export class BarcodeRecognizerConfiguration extends PartiallyConstructible {
     Default is MOD_10
     */
   public msiPlesseyChecksumAlgorithm: MSIPlesseyChecksumAlgorithm = 'MOD_10';
+  /**
+    The customer format used in AUSTRALIA_POST codes. The default value is ALPHA_NUMERIC.
+    Default is ALPHA_NUMERIC
+    */
+  public australiaPostCustomerFormat: AustraliaPostCustomerFormat = 'ALPHA_NUMERIC';
   /**
     If `true`, enables a mode that slightly decreases scanning quality and energy consumption. Increases scanning speed. If `false`, the mode is disabled. The default is `false`. Android only.
     Default is false
     */
   public lowPowerMode: boolean = false;
-  /**
-    The expected quantity of QR codes in an image.
-    Default is LOW
-    */
-  public codeDensity: CodeDensity = 'LOW';
   /**
     The expected way of handling GS1_COMPOSITE barcodes.
     Default is PARSE
@@ -276,18 +308,24 @@ export class BarcodeRecognizerConfiguration extends PartiallyConstructible {
     if (source.stripCheckDigits !== undefined) {
       this.stripCheckDigits = source.stripCheckDigits;
     }
+    if (source.useIATA2OF5Checksum !== undefined) {
+      this.useIATA2OF5Checksum = source.useIATA2OF5Checksum;
+    }
+    if (source.useCode11Checksum !== undefined) {
+      this.useCode11Checksum = source.useCode11Checksum;
+    }
     if (source.barcodeFormats !== undefined) {
       this.barcodeFormats = source.barcodeFormats.map((it) => it);
     }
     if (source.msiPlesseyChecksumAlgorithm !== undefined) {
       this.msiPlesseyChecksumAlgorithm = source.msiPlesseyChecksumAlgorithm;
     }
+    if (source.australiaPostCustomerFormat !== undefined) {
+      this.australiaPostCustomerFormat = source.australiaPostCustomerFormat;
+    }
     if (source.lowPowerMode !== undefined) {
       this.lowPowerMode = source.lowPowerMode;
     }
-    if (source.codeDensity !== undefined) {
-      this.codeDensity = source.codeDensity;
-    }
     if (source.gs1Handling !== undefined) {
       this.gs1Handling = source.gs1Handling;
     }

package/src/ui_v2/barcode/BarcodeScannerConfiguration.ts

@@ -3,8 +3,9 @@ import { ArOverlayFindAndPickConfiguration } from '../barcode/ArTrackingOverlayC
 import { ArOverlayGeneralConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { ArOverlayPolygonConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { AspectRatio } from '../common/Common';
+import { AustraliaPostCustomerFormat } from '../barcode/BarcodeRecognizerConfiguration';
 import { BackgroundStyle } from '../common/Common';
-import { BadgeStyle } from '../barcode/ArTrackingOverlayConfiguration';
+import { BadgeStyle } from '../common/Common';
 import { BadgedButton } from '../common/Common';
 import { BarcodeDocumentFormat } from '../barcode/BarcodeRecognizerConfiguration';
 import { BarcodeFormat } from '../barcode/BarcodeRecognizerConfiguration';
@@ -22,7 +23,6 @@ import { CameraConfiguration } from '../common/CameraConfiguration';
 import { CameraModule } from '../common/CameraConfiguration';
 import { CameraPermissionScreen } from '../common/CameraPermission';
 import { CameraPreviewMode } from '../common/Common';
-import { CodeDensity } from '../barcode/BarcodeRecognizerConfiguration';
 import { CollapsedVisibleHeight } from '../barcode/MultipleScanningModeUseCase';
 import { DeepPartial, PartiallyConstructible } from '../../utils';
 import { ExpectedBarcode } from '../barcode/FindAndPickScanningModeUseCase';

package/src/ui_v2/barcode/BarcodeUseCase.ts

@@ -2,7 +2,7 @@ import { ArOverlayFindAndPickConfiguration } from '../barcode/ArTrackingOverlayC
 import { ArOverlayGeneralConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { ArOverlayPolygonConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { BackgroundStyle } from '../common/Common';
-import { BadgeStyle } from '../barcode/ArTrackingOverlayConfiguration';
+import { BadgeStyle } from '../common/Common';
 import { BadgedButton } from '../common/Common';
 import { BarcodeInfoMapping } from '../barcode/BarcodeInfoMapping';
 import { BarcodeItemConfiguration } from '../barcode/ArTrackingOverlayConfiguration';

package/src/ui_v2/barcode/FindAndPickScanningModeUseCase.ts

@@ -2,7 +2,7 @@ import { ArOverlayFindAndPickConfiguration } from '../barcode/ArTrackingOverlayC
 import { ArOverlayGeneralConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { ArOverlayPolygonConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { BackgroundStyle } from '../common/Common';
-import { BadgeStyle } from '../barcode/ArTrackingOverlayConfiguration';
+import { BadgeStyle } from '../common/Common';
 import { BadgedButton } from '../common/Common';
 import { BarcodeInfoMapping } from '../barcode/BarcodeInfoMapping';
 import { BarcodeItemConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
@@ -50,6 +50,10 @@ export class ExpectedBarcode extends PartiallyConstructible {
     Default is 1
     */
   public count: number = 1;
+  /**
+   Use this key to display the original barcode image
+   */
+  public static readonly barcodeImageKey = 'BARCODE_IMAGE';
 
   /** @param source {@displayType `DeepPartial<ExpectedBarcode>`} */
   public constructor(source: DeepPartial<ExpectedBarcode> = {}) {
@@ -247,7 +251,7 @@ export class FindAndPickScanningMode extends PartiallyConstructible {
     Configuration of the AR overlay.
     */
   public arOverlay: ArOverlayFindAndPickConfiguration = new ArOverlayFindAndPickConfiguration({
-    visible: false,
+    visible: true,
     automaticSelectionEnabled: true,
     polygon: new FindAndPickArOverlayPolygonConfiguration({
       partiallyScanned: new PolygonStyle({

package/src/ui_v2/barcode/MultipleScanningModeUseCase.ts

@@ -2,7 +2,7 @@ import { ArOverlayFindAndPickConfiguration } from '../barcode/ArTrackingOverlayC
 import { ArOverlayGeneralConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { ArOverlayPolygonConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { BackgroundStyle } from '../common/Common';
-import { BadgeStyle } from '../barcode/ArTrackingOverlayConfiguration';
+import { BadgeStyle } from '../common/Common';
 import { BadgedButton } from '../common/Common';
 import { BarcodeInfoMapping } from '../barcode/BarcodeInfoMapping';
 import { BarcodeItemConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
@@ -428,6 +428,11 @@ export class MultipleScanningMode extends PartiallyConstructible {
     Default is 1000
     */
   public countingRepeatDelay: number = 1000;
+  /**
+    Whether the user can submit an empty barcode list.
+    Default is false
+    */
+  public allowEmptySubmission: boolean = false;
   /**
     Mode used for scanning multiple barcodes.
     Default is COUNTING
@@ -694,6 +699,9 @@ export class MultipleScanningMode extends PartiallyConstructible {
     if (source.countingRepeatDelay !== undefined) {
       this.countingRepeatDelay = source.countingRepeatDelay;
     }
+    if (source.allowEmptySubmission !== undefined) {
+      this.allowEmptySubmission = source.allowEmptySubmission;
+    }
     if (source.mode !== undefined) {
       this.mode = source.mode;
     }

package/src/ui_v2/barcode/SingleScanningModeUseCase.ts

@@ -2,7 +2,7 @@ import { ArOverlayFindAndPickConfiguration } from '../barcode/ArTrackingOverlayC
 import { ArOverlayGeneralConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { ArOverlayPolygonConfiguration } from '../barcode/ArTrackingOverlayConfiguration';
 import { BackgroundStyle } from '../common/Common';
-import { BadgeStyle } from '../barcode/ArTrackingOverlayConfiguration';
+import { BadgeStyle } from '../common/Common';
 import { BadgedButton } from '../common/Common';
 import { BarcodeInfoMapping } from '../barcode/BarcodeInfoMapping';
 import { BarcodeItemConfiguration } from '../barcode/ArTrackingOverlayConfiguration';

package/src/ui_v2/common/CameraPermission.ts

@@ -33,24 +33,40 @@ export class CameraPermissionScreen extends PartiallyConstructible {
     Configuration of the camera permission request's confirmation button.
     */
   public enableCameraButton: ButtonConfiguration = new ButtonConfiguration({
-    text: "{'type': 'String', 'default': 'Grant permission'}",
-    background: new BackgroundStyle({}),
-    foreground: new ForegroundStyle({}),
+    text: 'Grant permission',
+    background: new BackgroundStyle({
+      strokeColor: '?sbColorPrimary',
+      fillColor: '?sbColorPrimary',
+      strokeWidth: 0.0,
+    }),
+    foreground: new ForegroundStyle({
+      iconVisible: false,
+      color: '?sbColorOnPrimary',
+      useShadow: false,
+    }),
   });
   /**
     Configuration of the camera permission request's close button.
     */
   public closeButton: ButtonConfiguration = new ButtonConfiguration({
     text: 'Close',
-    background: new BackgroundStyle({}),
-    foreground: new ForegroundStyle({}),
+    background: new BackgroundStyle({
+      strokeColor: '#00000000',
+      fillColor: '#00000000',
+      strokeWidth: 0.0,
+    }),
+    foreground: new ForegroundStyle({
+      iconVisible: false,
+      color: '?sbColorPrimary',
+      useShadow: false,
+    }),
   });
   /**
     Configuration of the camera permission request's title.
     */
   public enableCameraTitle: StyledText = new StyledText({
     text: 'Camera permission denied!',
-    color: '?colorOnSurface',
+    color: '?sbColorOnSurface',
   });
   /**
     Configuration of the camera permission request's explanatory text.

package/src/ui_v2/common/Common.ts

@@ -209,6 +209,41 @@ export class IconStyle extends PartiallyConstructible {
   }
 }
 
+/**
+Configuration of the icon appearance.
+*/
+export class IconButton extends PartiallyConstructible {
+  /**
+    Whether the icon is visible on the button.
+    Default is true
+    */
+  public visible: boolean = true;
+  /**
+    Icon color.
+    Default is "#FFFFFF"
+    */
+  public color: string = '#FFFFFF';
+  /**
+    The text to be read when button is selected through accessibility mode.
+    Default is ""
+    */
+  public accessibilityDescription: string = '';
+
+  /** @param source {@displayType `DeepPartial<IconButton>`} */
+  public constructor(source: DeepPartial<IconButton> = {}) {
+    super();
+    if (source.visible !== undefined) {
+      this.visible = source.visible;
+    }
+    if (source.color !== undefined) {
+      this.color = source.color;
+    }
+    if (source.accessibilityDescription !== undefined) {
+      this.accessibilityDescription = source.accessibilityDescription;
+    }
+  }
+}
+
 /**
 Configuration of the polygon appearance.
 */
@@ -220,9 +255,9 @@ export class PolygonStyle extends PartiallyConstructible {
   public strokeColor: string = '#FFFFFFFF';
   /**
     Polygon color.
-    Default is "#30FFFFFF"
+    Default is "#FFFFFF30"
     */
-  public fillColor: string = '#30FFFFFF';
+  public fillColor: string = '#FFFFFF30';
   /**
     Width of the polygon outline in dp.
     Default is 2.0
@@ -349,6 +384,40 @@ export class AspectRatio extends PartiallyConstructible {
   }
 }
 
+/**
+Configuration of the round button.
+*/
+export class BadgeStyle extends PartiallyConstructible {
+  /**
+    Control the visibility of the badge.
+    Default is true
+    */
+  public visible: boolean = true;
+  /**
+    The style of the button's background.
+    */
+  public background: BackgroundStyle = new BackgroundStyle({});
+  /**
+    Color of the button foreground (icon, text).
+    Default is "?sbColorOnSurface"
+    */
+  public foregroundColor: string = '?sbColorOnSurface';
+
+  /** @param source {@displayType `DeepPartial<BadgeStyle>`} */
+  public constructor(source: DeepPartial<BadgeStyle> = {}) {
+    super();
+    if (source.visible !== undefined) {
+      this.visible = source.visible;
+    }
+    if (source.background !== undefined) {
+      this.background = new BackgroundStyle(source.background);
+    }
+    if (source.foregroundColor !== undefined) {
+      this.foregroundColor = source.foregroundColor;
+    }
+  }
+}
+
 /**
 Configuration of the round button.
 */
@@ -358,6 +427,11 @@ export class RoundButton extends PartiallyConstructible {
     Default is true
     */
   public visible: boolean = true;
+  /**
+    The text to be read when button is selected through accessibility mode.
+    Default is ""
+    */
+  public accessibilityDescription: string = '';
   /**
     Color of the button background shape.
     Default is "#0000007A"
@@ -385,6 +459,9 @@ export class RoundButton extends PartiallyConstructible {
     if (source.visible !== undefined) {
       this.visible = source.visible;
     }
+    if (source.accessibilityDescription !== undefined) {
+      this.accessibilityDescription = source.accessibilityDescription;
+    }
     if (source.backgroundColor !== undefined) {
       this.backgroundColor = source.backgroundColor;
     }
@@ -481,6 +558,11 @@ export class ButtonConfiguration extends PartiallyConstructible {
     Default is ""
     */
   public text: string = '';
+  /**
+    The text to be read when button is selected through accessibility mode.
+    Default is ""
+    */
+  public accessibilityDescription: string = '';
   /**
     The style of the button's background.
     */
@@ -499,6 +581,9 @@ export class ButtonConfiguration extends PartiallyConstructible {
     if (source.text !== undefined) {
       this.text = source.text;
     }
+    if (source.accessibilityDescription !== undefined) {
+      this.accessibilityDescription = source.accessibilityDescription;
+    }
     if (source.background !== undefined) {
       this.background = new BackgroundStyle(source.background);
     }
@@ -508,6 +593,87 @@ export class ButtonConfiguration extends PartiallyConstructible {
   }
 }
 
+/**
+Button configuration.
+*/
+export class PopupMenuItem extends PartiallyConstructible {
+  /**
+    The text to be displayed on the button.
+    */
+  public title: StyledText = new StyledText({});
+  /**
+    The text to be read when button is selected through accessibility mode.
+    Default is ""
+    */
+  public accessibilityDescription: string = '';
+  /**
+    The style of the button's icon (icon, text).
+    */
+  public icon: IconStyle = new IconStyle({});
+
+  /** @param source {@displayType `DeepPartial<PopupMenuItem>`} */
+  public constructor(source: DeepPartial<PopupMenuItem> = {}) {
+    super();
+    if (source.title !== undefined) {
+      this.title = new StyledText(source.title);
+    }
+    if (source.accessibilityDescription !== undefined) {
+      this.accessibilityDescription = source.accessibilityDescription;
+    }
+    if (source.icon !== undefined) {
+      this.icon = new IconStyle(source.icon);
+    }
+  }
+}
+
+/**
+Button configuration.
+*/
+export class BarButtonConfiguration extends PartiallyConstructible {
+  /**
+    Whether the button is visible or not.
+    Default is true
+    */
+  public visible: boolean = true;
+  /**
+    The text to be displayed on the button.
+    */
+  public title: StyledText = new StyledText({});
+  /**
+    The text to be read when button is selected through accessibility mode.
+    Default is ""
+    */
+  public accessibilityDescription: string = '';
+  /**
+    The style of the button's background.
+    */
+  public background: BackgroundStyle = new BackgroundStyle({});
+  /**
+    The style of the button's icon (icon, text).
+    */
+  public icon: IconStyle = new IconStyle({});
+
+  /** @param source {@displayType `DeepPartial<BarButtonConfiguration>`} */
+  public constructor(source: DeepPartial<BarButtonConfiguration> = {}) {
+    super();
+    if (source.visible !== undefined) {
+      this.visible = source.visible;
+    }
+    if (source.title !== undefined) {
+      this.title = new StyledText(source.title);
+    }
+    if (source.accessibilityDescription !== undefined) {
+      this.accessibilityDescription = source.accessibilityDescription;
+    }
+    if (source.background !== undefined) {
+      this.background = new BackgroundStyle(source.background);
+    }
+    if (source.icon !== undefined) {
+      this.icon = new IconStyle(source.icon);
+    }
+  }
+}
+
 /**
 Configure the orientation of the interface.
 

package/src/ui_v2/common/NavigationBarConfiguration.ts

@@ -0,0 +1,13 @@
+import { DeepPartial, PartiallyConstructible } from '../../utils';
+
+/**
+Visual mode used for the navigation bar icons. Android only.
+
+- `DARK`:
+   Display all icons in the navigation bar in black.
+- `LIGHT`:
+   Display all icons in the navigation bar in white.
+- `HIDDEN`:
+   Hide the navigation bar.
+*/
+export type NavigationBarMode = 'DARK' | 'LIGHT' | 'HIDDEN';

package/src/ui_v2/common/ScanbotAlertDialog.ts

@@ -37,11 +37,31 @@ export class ScanbotAlertDialog extends PartiallyConstructible {
   /**
     Configuration of the retry button.
     */
-  public okButton: ButtonConfiguration;
+  public okButton: ButtonConfiguration = new ButtonConfiguration({
+    background: new BackgroundStyle({ fillColor: '?sbColorPrimary' }),
+  });
+  /**
+    Configuration of the middle button for dialogs with tree buttons.
+    */
+  public actionButton: ButtonConfiguration = new ButtonConfiguration({
+    visible: false,
+    background: new BackgroundStyle({
+      strokeColor: '#00000000',
+      fillColor: '#00000000',
+      strokeWidth: 0.0,
+    }),
+  });
   /**
     Configuration of the cancel button.
     */
-  public cancelButton: ButtonConfiguration;
+  public cancelButton: ButtonConfiguration = new ButtonConfiguration({
+    visible: true,
+    background: new BackgroundStyle({
+      strokeColor: '#00000000',
+      fillColor: '#00000000',
+      strokeWidth: 0.0,
+    }),
+  });
 
   /** @param source {@displayType `DeepPartial<ScanbotAlertDialog>`} */
   public constructor(source: DeepPartial<ScanbotAlertDialog> = {}) {
@@ -63,13 +83,12 @@ export class ScanbotAlertDialog extends PartiallyConstructible {
     }
     if (source.okButton !== undefined) {
       this.okButton = new ButtonConfiguration(source.okButton);
-    } else {
-      throw new Error('okButton must be present in constructor argument');
+    }
+    if (source.actionButton !== undefined) {
+      this.actionButton = new ButtonConfiguration(source.actionButton);
     }
     if (source.cancelButton !== undefined) {
       this.cancelButton = new ButtonConfiguration(source.cancelButton);
-    } else {
-      throw new Error('cancelButton must be present in constructor argument');
     }
   }
 }

package/src/ui_v2/common/UserGuidanceConfiguration.ts

@@ -1,5 +1,6 @@
 import { BackgroundStyle } from '../common/Common';
 import { DeepPartial, PartiallyConstructible } from '../../utils';
+import { IconStyle } from '../common/Common';
 import { StyledText } from '../common/Common';
 
 /**
@@ -37,3 +38,43 @@ export class UserGuidanceConfiguration extends PartiallyConstructible {
     }
   }
 }
+
+/**
+Configuration of the hint guiding users through the scanning process.
+*/
+export class IconUserGuidanceConfiguration extends PartiallyConstructible {
+  /**
+    Whether the user guidance is visible.
+    Default is true
+    */
+  public visible: boolean = true;
+  /**
+    Icon of the user guidance.
+    */
+  public icon: IconStyle = new IconStyle({ color: '?sbColorOnPrimary' });
+  /**
+    Title of the user guidance.
+    */
+  public title: StyledText = new StyledText({ color: '?sbColorOnPrimary' });
+  /**
+    Background style used for the user guidance.
+    */
+  public background: BackgroundStyle = new BackgroundStyle({ fillColor: '?sbColorSurfaceLow' });
+
+  /** @param source {@displayType `DeepPartial<IconUserGuidanceConfiguration>`} */
+  public constructor(source: DeepPartial<IconUserGuidanceConfiguration> = {}) {
+    super();
+    if (source.visible !== undefined) {
+      this.visible = source.visible;
+    }
+    if (source.icon !== undefined) {
+      this.icon = new IconStyle(source.icon);
+    }
+    if (source.title !== undefined) {
+      this.title = new StyledText(source.title);
+    }
+    if (source.background !== undefined) {
+      this.background = new BackgroundStyle(source.background);
+    }
+  }
+}

package/src/ui_v2/index.ts

@@ -55,18 +55,13 @@ export function startBarcodeScanner(
       barcodeItemMapperEventEmitter.addListener(
         barcodeItemMapperEventName,
         (barcodeItem: BarcodeItem) => {
+          const barcodeItemUuid = `${barcodeItem.textWithExtension}_${barcodeItem.type ?? ''}`;
+
           barcodeItemMapperCallback!(
             barcodeItem,
             (barcodeMappedData: BarcodeMappedData) =>
-              ScanbotBarcodeSDKImpl.onBarcodeItemMapper(
-                isIOS ? JSON.stringify(barcodeItem) : barcodeItem,
-                barcodeMappedData
-              ),
-            () =>
-              ScanbotBarcodeSDKImpl.onBarcodeItemMapper(
-                isIOS ? JSON.stringify(barcodeItem) : barcodeItem,
-                null
-              )
+              ScanbotBarcodeSDKImpl.onBarcodeItemMapper(barcodeItemUuid, barcodeMappedData),
+            () => ScanbotBarcodeSDKImpl.onBarcodeItemMapper(barcodeItemUuid, null)
           );
         }
       );
@@ -115,6 +110,7 @@ export * from './common/ActionBarConfiguration';
 export * from './common/CameraConfiguration';
 export * from './common/CameraPermission';
 export * from './common/Common';
+export * from './common/NavigationBarConfiguration';
 export * from './common/ScanbotAlertDialog';
 export * from './common/TopBarConfiguration';
 export * from './common/UserGuidanceConfiguration';