react-native-nitro-zxing 0.1.0-alpha.0

package/nitrogen/generated/shared/c++/Rect.hpp

@@ -0,0 +1,95 @@
+///
+/// Rect.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+
+
+namespace margelo::nitro::camera::zxing {
+
+  /**
+   * A struct which can be represented as a JavaScript object (Rect).
+   */
+  struct Rect final {
+  public:
+    double left     SWIFT_PRIVATE;
+    double right     SWIFT_PRIVATE;
+    double top     SWIFT_PRIVATE;
+    double bottom     SWIFT_PRIVATE;
+
+  public:
+    Rect() = default;
+    explicit Rect(double left, double right, double top, double bottom): left(left), right(right), top(top), bottom(bottom) {}
+
+  public:
+    friend bool operator==(const Rect& lhs, const Rect& rhs) = default;
+  };
+
+} // namespace margelo::nitro::camera::zxing
+
+namespace margelo::nitro {
+
+  // C++ Rect <> JS Rect (object)
+  template <>
+  struct JSIConverter<margelo::nitro::camera::zxing::Rect> final {
+    static inline margelo::nitro::camera::zxing::Rect fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::camera::zxing::Rect(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "left"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "right"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "top"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottom")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::camera::zxing::Rect& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "left"), JSIConverter<double>::toJSI(runtime, arg.left));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "right"), JSIConverter<double>::toJSI(runtime, arg.right));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "top"), JSIConverter<double>::toJSI(runtime, arg.top));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "bottom"), JSIConverter<double>::toJSI(runtime, arg.bottom));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "left")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "right")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "top")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottom")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/TargetBarcodeFormat.hpp

@@ -0,0 +1,124 @@
+///
+/// TargetBarcodeFormat.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/NitroHash.hpp>)
+#include <NitroModules/NitroHash.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+namespace margelo::nitro::camera::zxing {
+
+  /**
+   * An enum which can be represented as a JavaScript union (TargetBarcodeFormat).
+   */
+  enum class TargetBarcodeFormat {
+    CODE_128      SWIFT_NAME(code128) = 0,
+    CODE_39      SWIFT_NAME(code39) = 1,
+    CODE_93      SWIFT_NAME(code93) = 2,
+    CODABAR      SWIFT_NAME(codabar) = 3,
+    DATA_MATRIX      SWIFT_NAME(dataMatrix) = 4,
+    EAN_13      SWIFT_NAME(ean13) = 5,
+    EAN_8      SWIFT_NAME(ean8) = 6,
+    ITF      SWIFT_NAME(itf) = 7,
+    QR_CODE      SWIFT_NAME(qrCode) = 8,
+    UPC_A      SWIFT_NAME(upcA) = 9,
+    UPC_E      SWIFT_NAME(upcE) = 10,
+    PDF_417      SWIFT_NAME(pdf417) = 11,
+    AZTEC      SWIFT_NAME(aztec) = 12,
+    ALL_FORMATS      SWIFT_NAME(allFormats) = 13,
+  } CLOSED_ENUM;
+
+} // namespace margelo::nitro::camera::zxing
+
+namespace margelo::nitro {
+
+  // C++ TargetBarcodeFormat <> JS TargetBarcodeFormat (union)
+  template <>
+  struct JSIConverter<margelo::nitro::camera::zxing::TargetBarcodeFormat> final {
+    static inline margelo::nitro::camera::zxing::TargetBarcodeFormat fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, arg);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("code-128"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_128;
+        case hashString("code-39"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_39;
+        case hashString("code-93"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_93;
+        case hashString("codabar"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::CODABAR;
+        case hashString("data-matrix"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::DATA_MATRIX;
+        case hashString("ean-13"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::EAN_13;
+        case hashString("ean-8"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::EAN_8;
+        case hashString("itf"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::ITF;
+        case hashString("qr-code"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::QR_CODE;
+        case hashString("upc-a"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::UPC_A;
+        case hashString("upc-e"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::UPC_E;
+        case hashString("pdf-417"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::PDF_417;
+        case hashString("aztec"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::AZTEC;
+        case hashString("all-formats"): return margelo::nitro::camera::zxing::TargetBarcodeFormat::ALL_FORMATS;
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum TargetBarcodeFormat - invalid value!");
+      }
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, margelo::nitro::camera::zxing::TargetBarcodeFormat arg) {
+      switch (arg) {
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_128: return JSIConverter<std::string>::toJSI(runtime, "code-128");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_39: return JSIConverter<std::string>::toJSI(runtime, "code-39");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::CODE_93: return JSIConverter<std::string>::toJSI(runtime, "code-93");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::CODABAR: return JSIConverter<std::string>::toJSI(runtime, "codabar");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::DATA_MATRIX: return JSIConverter<std::string>::toJSI(runtime, "data-matrix");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::EAN_13: return JSIConverter<std::string>::toJSI(runtime, "ean-13");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::EAN_8: return JSIConverter<std::string>::toJSI(runtime, "ean-8");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::ITF: return JSIConverter<std::string>::toJSI(runtime, "itf");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::QR_CODE: return JSIConverter<std::string>::toJSI(runtime, "qr-code");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::UPC_A: return JSIConverter<std::string>::toJSI(runtime, "upc-a");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::UPC_E: return JSIConverter<std::string>::toJSI(runtime, "upc-e");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::PDF_417: return JSIConverter<std::string>::toJSI(runtime, "pdf-417");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::AZTEC: return JSIConverter<std::string>::toJSI(runtime, "aztec");
+        case margelo::nitro::camera::zxing::TargetBarcodeFormat::ALL_FORMATS: return JSIConverter<std::string>::toJSI(runtime, "all-formats");
+        default: [[unlikely]]
+          throw std::invalid_argument("Cannot convert TargetBarcodeFormat to JS - invalid value: "
+                                    + std::to_string(static_cast<int>(arg)) + "!");
+      }
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isString()) {
+        return false;
+      }
+      std::string unionValue = JSIConverter<std::string>::fromJSI(runtime, value);
+      switch (hashString(unionValue.c_str(), unionValue.size())) {
+        case hashString("code-128"):
+        case hashString("code-39"):
+        case hashString("code-93"):
+        case hashString("codabar"):
+        case hashString("data-matrix"):
+        case hashString("ean-13"):
+        case hashString("ean-8"):
+        case hashString("itf"):
+        case hashString("qr-code"):
+        case hashString("upc-a"):
+        case hashString("upc-e"):
+        case hashString("pdf-417"):
+        case hashString("aztec"):
+        case hashString("all-formats"):
+          return true;
+        default:
+          return false;
+      }
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "react-native-nitro-zxing",
+  "version": "0.1.0-alpha.0",
+  "description": "Barcode scanning plugin for react-native-vision-camera powered by zxing-cpp.",
+  "main": "lib/index",
+  "module": "lib/index",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "src",
+    "react-native.config.js",
+    "lib",
+    "nitrogen",
+    "android/build.gradle",
+    "android/gradle.properties",
+    "android/fix-prefab.gradle",
+    "android/CMakeLists.txt",
+    "android/src",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "cpp/*.hpp",
+    "cpp/*.cpp",
+    "cpp/zxing-core/core",
+    "cpp/zxing-core/wrappers/ios/Sources/Wrapper/Version.h",
+    "cpp/zxing-core/LICENSE",
+    "nitro.json",
+    "*.podspec",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf android/build node_modules/**/android/build lib",
+    "build": "tsc",
+    "typescript": "tsc",
+    "specs": "tsc --noEmit false && nitrogen",
+    "prepack": "test -f cpp/zxing-core/core/CMakeLists.txt || (echo 'zxing-core submodule missing: run git submodule update --init' && exit 1)",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "camera",
+    "react-native-camera",
+    "vision-camera",
+    "barcode",
+    "barcode-scanner",
+    "qr-code",
+    "qrcode",
+    "scanner",
+    "code-scanner",
+    "zxing",
+    "zxing-cpp",
+    "frame-processor",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/margelo/react-native-nitro-zxing.git"
+  },
+  "author": "Margelo",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/margelo/react-native-nitro-zxing/issues"
+  },
+  "homepage": "https://github.com/margelo/react-native-nitro-zxing",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.15",
+    "nitrogen": "0.37.0",
+    "react": "19.2.3",
+    "react-native": "0.85.3",
+    "react-native-nitro-image": "0.15.2",
+    "react-native-nitro-modules": "0.37.0",
+    "react-native-vision-camera": "5.2.3",
+    "typescript": "6.0.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-image": "*",
+    "react-native-nitro-modules": "*",
+    "react-native-vision-camera": "*"
+  },
+  "peerDependenciesMeta": {
+    "react-native-nitro-modules": {
+      "optional": true
+    }
+  },
+  "release-it": {
+    "npm": {
+      "publish": true
+    },
+    "git": false,
+    "github": {
+      "release": false
+    },
+    "hooks": {
+      "before:init": "bun typecheck",
+      "after:bump": "bun run build"
+    }
+  }
+}

package/react-native.config.js

@@ -0,0 +1,16 @@
+// https://github.com/react-native-community/cli/blob/main/docs/dependencies.md
+
+module.exports = {
+  dependency: {
+    platforms: {
+      /**
+       * @type {import('@react-native-community/cli-types').IOSDependencyParams}
+       */
+      ios: {},
+      /**
+       * @type {import('@react-native-community/cli-types').AndroidDependencyParams}
+       */
+      android: {},
+    },
+  },
+}

package/src/factory.ts

@@ -0,0 +1,26 @@
+import type { Image } from 'react-native-nitro-image'
+import { NitroModules } from 'react-native-nitro-modules'
+import type { Frame } from 'react-native-vision-camera'
+import type { Barcode } from './specs/Barcode.nitro'
+import type { BarcodeScanner } from './specs/BarcodeScanner.nitro'
+import type {
+  BarcodeScannerOptions,
+  ZXingBarcodeScannerFactory,
+} from './specs/BarcodeScannerFactory.nitro'
+
+const factory = NitroModules.createHybridObject<ZXingBarcodeScannerFactory>(
+  'ZXingBarcodeScannerFactory',
+)
+
+/**
+ * Create a new {@linkcode BarcodeScanner}.
+ *
+ * The {@linkcode BarcodeScanner} can be used to
+ * scan {@linkcode Barcode}s in a {@linkcode Frame} or
+ * an existing {@linkcode Image}.
+ */
+export function createBarcodeScanner(
+  options: BarcodeScannerOptions,
+): BarcodeScanner {
+  return factory.createBarcodeScanner(options)
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+export * from './factory'
+export * from './specs/Barcode.nitro'
+export * from './specs/BarcodeFormat'
+export * from './specs/BarcodeScanner.nitro'
+export * from './specs/BarcodeScannerFactory.nitro'
+export * from './specs/BarcodeValueType'
+export * from './specs/Point'
+export * from './specs/Rect'
+export * from './useBarcodeScanner'

package/src/specs/Barcode.nitro.ts

@@ -0,0 +1,70 @@
+import type { Image } from 'react-native-nitro-image'
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { Frame } from 'react-native-vision-camera'
+import type { createBarcodeScanner } from '../factory'
+import type { BarcodeFormat } from './BarcodeFormat'
+import type { BarcodeScanner } from './BarcodeScanner.nitro'
+import type { BarcodeValueType } from './BarcodeValueType'
+import type { Point } from './Point'
+import type { Rect } from './Rect'
+
+/**
+ * Represents a single detected Barcode.
+ *
+ * A {@linkcode Barcode} is produced via the
+ * {@linkcode BarcodeScanner} (see
+ * {@linkcode createBarcodeScanner | createBarcodeScanner(...)}).
+ *
+ * See {@linkcode BarcodeScanner.scanCodes | BarcodeScanner.scanCodes(...)}
+ * and {@linkcode BarcodeScanner.scanCodesInImageAsync | BarcodeScanner.scanCodesInImageAsync(...)}
+ * for information about Barcode coordinate systems.
+ *
+ * @example
+ * ```ts
+ * const barcode = ...
+ * console.log(`Barcode value: ${barcode.rawValue}`)
+ * ```
+ */
+export interface Barcode
+  extends HybridObject<{
+    ios: 'c++'
+    android: 'c++'
+  }> {
+  /**
+   * Get the format of this {@linkcode Barcode}.
+   * @see {@linkcode BarcodeFormat}
+   */
+  readonly format: BarcodeFormat
+
+  /**
+   * Get the {@linkcode Barcode}'s bounding box.
+   *
+   * The coordinates are relative to the input {@linkcode Frame}
+   * or {@linkcode Image}.
+   */
+  readonly boundingBox: Rect
+  /**
+   * Get the {@linkcode Barcode}'s corner points.
+   *
+   * The coordinates are relative to the input {@linkcode Frame}
+   * or {@linkcode Image}.
+   */
+  readonly cornerPoints: Point[]
+  /**
+   * Get the {@linkcode Barcode}'s value in a user-friendly format.
+   */
+  readonly displayValue: string | undefined
+  /**
+   * Get the {@linkcode Barcode}'s value in raw bytes.
+   */
+  readonly rawBytes: ArrayBuffer | undefined
+  /**
+   * Get the {@linkcode Barcode}'s raw value as a string.
+   */
+  readonly rawValue: string | undefined
+  /**
+   * Get the {@linkcode Barcode}'s value's type.
+   * @see {@linkcode BarcodeValueType}
+   */
+  readonly valueType: BarcodeValueType
+}

package/src/specs/BarcodeFormat.ts

@@ -0,0 +1,31 @@
+import type { Barcode } from './Barcode.nitro'
+import type { BarcodeScanner } from './BarcodeScanner.nitro'
+
+/**
+ * Represents a detected {@linkcode Barcode}'s format, or
+ * `'unknown'` if the format of a scanned Barcode could not be
+ * determined.
+ */
+export type BarcodeFormat =
+  | 'unknown'
+  | 'code-128'
+  | 'code-39'
+  | 'code-93'
+  | 'codabar'
+  | 'data-matrix'
+  | 'ean-13'
+  | 'ean-8'
+  | 'itf'
+  | 'qr-code'
+  | 'upc-a'
+  | 'upc-e'
+  | 'pdf-417'
+  | 'aztec'
+
+/**
+ * Represents a target {@linkcode BarcodeFormat} that the {@linkcode BarcodeScanner}
+ * can be configured to scan for, or `'all-formats'` to scan for every supported format.
+ */
+export type TargetBarcodeFormat =
+  | Exclude<BarcodeFormat, 'unknown'>
+  | 'all-formats'

package/src/specs/BarcodeScanner.nitro.ts

@@ -0,0 +1,91 @@
+import type { Image } from 'react-native-nitro-image'
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { Frame, PreviewViewMethods } from 'react-native-vision-camera'
+import type { createBarcodeScanner } from '../factory'
+import type { useBarcodeScanner } from '../useBarcodeScanner'
+import type { Barcode } from './Barcode.nitro'
+
+/**
+ * Represents a Barcode Scanner that uses ZXing (zxing-cpp).
+ *
+ * The {@linkcode BarcodeScanner} can be used in a
+ * Frame Processor by calling {@linkcode BarcodeScanner.scanCodes | scanCodes(...)},
+ * or for static images by calling
+ * {@linkcode BarcodeScanner.scanCodesInImageAsync | scanCodesInImageAsync(...)}.
+ *
+ * @see {@linkcode useBarcodeScanner | useBarcodeScanner(...)}
+ * @see {@linkcode createBarcodeScanner | createBarcodeScanner(...)}
+ */
+export interface BarcodeScanner
+  extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  /**
+   * Synchronously detects {@linkcode Barcode}s in the
+   * given {@linkcode Frame}.
+   *
+   * All coordinates in the {@linkcode Barcode} are
+   * relative to the {@linkcode Frame}'s coordinate system.
+   *
+   * You can convert {@linkcode Barcode} coordinates to Camera coordinates using
+   * {@linkcode Frame.convertFramePointToCameraPoint | Frame.convertFramePointToCameraPoint(...)},
+   * and then convert the Camera coordinates to Preview View coordinates using
+   * {@linkcode PreviewViewMethods.convertCameraPointToViewPoint | PreviewViewMethods.convertCameraPointToViewPoint(...)}.
+   *
+   * @example
+   * ```ts
+   * const scanner = // ...
+   * const frame = // ...
+   * const previewView = // ...
+   *
+   * const barcodes = scanner.scanCodes(frame)
+   * for (const barcode of barcodes) {
+   *   console.log('Barcode value:', barcode.rawValue)
+   *   for (const point of barcode.cornerPoints) {
+   *     const cameraPoint = frame.convertFramePointToCameraPoint(point)
+   *     const previewPoint = previewView.convertCameraPointToViewPoint(cameraPoint)
+   *     console.log('Corner Point:', previewPoint)
+   *   }
+   * }
+   * ```
+   */
+  scanCodes(frame: Frame): Barcode[]
+  /**
+   * Asynchronously detects {@linkcode Barcode}s in the
+   * given {@linkcode Frame}.
+   *
+   * The Frame must remain valid until the returned Promise settles. Do not
+   * call {@linkcode Frame.dispose | Frame.dispose()} before awaiting it.
+   *
+   * @see {@linkcode scanCodes}
+   */
+  scanCodesAsync(frame: Frame): Promise<Barcode[]>
+
+  /**
+   * Asynchronously detects {@linkcode Barcode}s in the
+   * given {@linkcode Image}.
+   *
+   * This can be used to scan codes in an existing still image, such as
+   * an image loaded from disk, bundled resources or a URL via
+   * `react-native-nitro-image`.
+   *
+   * All coordinates in the returned {@linkcode Barcode}s are relative
+   * to the given {@linkcode Image}'s coordinate system.
+   *
+   * @example
+   * ```ts
+   * import { loadImage } from 'react-native-nitro-image'
+   * import { createBarcodeScanner } from 'react-native-nitro-zxing'
+   *
+   * const image = await loadImage({ url: 'https://example.com/barcode.png' })
+   * const scanner = createBarcodeScanner({ barcodeFormats: ['all-formats'] })
+   *
+   * try {
+   *   const barcodes = await scanner.scanCodesInImageAsync(image)
+   *   console.log('Barcode value:', barcodes[0]?.rawValue)
+   * } finally {
+   *   image.dispose()
+   *   scanner.dispose()
+   * }
+   * ```
+   */
+  scanCodesInImageAsync(image: Image): Promise<Barcode[]>
+}

package/src/specs/BarcodeScannerFactory.nitro.ts

@@ -0,0 +1,27 @@
+import type { HybridObject } from 'react-native-nitro-modules'
+import type { TargetBarcodeFormat } from './BarcodeFormat'
+import type { BarcodeScanner } from './BarcodeScanner.nitro'
+
+export interface BarcodeScannerOptions {
+  /**
+   * Specifies the formats to be used for Barcode
+   * scanning.
+   *
+   * If you want to detect all kinds of barcodes,
+   * use {@linkcode TargetBarcodeFormat | ['all-formats']}
+   */
+  barcodeFormats: TargetBarcodeFormat[]
+}
+
+export interface ZXingBarcodeScannerFactory
+  extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  /**
+   * Create a new {@linkcode BarcodeScanner}.
+   */
+  createBarcodeScanner(options: BarcodeScannerOptions): BarcodeScanner
+}
+
+/**
+ * Alias of {@linkcode ZXingBarcodeScannerFactory}.
+ */
+export type BarcodeScannerFactory = ZXingBarcodeScannerFactory

package/src/specs/BarcodeValueType.ts

@@ -0,0 +1,25 @@
+import type { Barcode } from './Barcode.nitro'
+import type { BarcodeFormat } from './BarcodeFormat'
+
+/**
+ * Represents the semantic type of data encoded in a {@linkcode Barcode} - e.g.
+ * a URL, a phone number, or a WiFi config - or `'unknown'` if the content type
+ * could not be classified.
+ *
+ * This describes **what** the barcode's content represents, not the barcode's
+ * visual format (see {@linkcode BarcodeFormat}).
+ */
+export type BarcodeValueType =
+  | 'unknown'
+  | 'contact-info'
+  | 'email'
+  | 'isbn'
+  | 'phone'
+  | 'product'
+  | 'sms'
+  | 'text'
+  | 'url'
+  | 'wifi'
+  | 'geo'
+  | 'calendar-event'
+  | 'driver-license'

package/src/specs/Point.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents a Point in the current context's
+ * coordinate system.
+ */
+export interface Point {
+  /**
+   * The X coordinate of the Point.
+   */
+  x: number
+  /**
+   * The Y coordinate of the Point.
+   */
+  y: number
+}

package/src/specs/Rect.ts

@@ -0,0 +1,22 @@
+/**
+ * Represents a Rectangle in the current context's
+ * coordinate system.
+ */
+export interface Rect {
+  /**
+   * The left value (min X) of the Rectangle.
+   */
+  left: number
+  /**
+   * The right value (max X) of the Rectangle.
+   */
+  right: number
+  /**
+   * The top value (min Y) of the Rectangle.
+   */
+  top: number
+  /**
+   * The bottom value (max Y) of the Rectangle.
+   */
+  bottom: number
+}