@unif/react-native-hms-scan 0.1.0

package/ios/HmsScanResultMapper.mm

@@ -0,0 +1,297 @@
+//
+//  HmsScanResultMapper.mm
+//  @unif/react-native-hms-scan
+//
+
+#import "HmsScanResultMapper.h"
+
+#import <ScanKitFrameWork/ScanKitFrameWork.h>
+
+// NOTE on naming collisions: HMSScanFormatTypeCode (in HmsScanFormat.h) declares
+// *global, unscoped* enum constants named QR_CODE, EAN_13, DATA_MATRIX, etc.
+// Those identifiers therefore refer to integers, NOT to our output strings.
+// We only ever compare against those enum constants and emit string *literals*
+// (@"QR_CODE" ...), so there is no clash.
+
+@implementation HmsScanResultMapper
+
+#pragma mark - CSV -> scanFormatType bitmask
+
+// Maps one of our BarcodeFormat tokens to the matching HMSScanFormatTypeCode bit.
+// Returns 0 for tokens HUAWEI iOS does not support (e.g. MULTI_FUNCTIONAL) or
+// UNKNOWN, so they contribute nothing to the OR-ed mask.
++ (unsigned int)bitForFormatToken:(NSString *)token
+{
+  NSString *t = [[token stringByTrimmingCharactersInSet:
+                  [NSCharacterSet whitespaceAndNewlineCharacterSet]] uppercaseString];
+  if (t.length == 0) {
+    return 0;
+  }
+
+  static NSDictionary<NSString *, NSNumber *> *map = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    map = @{
+      @"QR_CODE": @(QR_CODE),
+      @"AZTEC": @(AZTEC),
+      @"DATA_MATRIX": @(DATA_MATRIX),
+      @"PDF417": @(PDF_417),
+      @"CODABAR": @(CODABAR),
+      @"CODE_39": @(CODE_39),
+      @"CODE_93": @(CODE_93),
+      @"CODE_128": @(CODE_128),
+      @"EAN_8": @(EAN_8),
+      @"EAN_13": @(EAN_13),
+      @"UPC_A": @(UPC_A),
+      @"UPC_E": @(UPC_E),
+      // Our ITF14 maps to HUAWEI's ITF bit.
+      @"ITF14": @(ITF),
+      // MULTI_FUNCTIONAL / UNKNOWN have no HUAWEI iOS equivalent -> 0.
+    };
+  });
+
+  NSNumber *bit = map[t];
+  return bit ? (unsigned int)bit.unsignedIntValue : 0u;
+}
+
++ (unsigned int)scanFormatTypeFromCsv:(NSString *)csv
+{
+  NSString *trimmed = [csv stringByTrimmingCharactersInSet:
+                       [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+  if (trimmed.length == 0) {
+    return (unsigned int)ALL;  // empty string == all formats
+  }
+
+  unsigned int mask = 0u;
+  for (NSString *token in [trimmed componentsSeparatedByString:@","]) {
+    mask |= [self bitForFormatToken:token];
+  }
+  // If nothing resolved (e.g. only MULTI_FUNCTIONAL/UNKNOWN was requested),
+  // fall back to ALL so we still attempt a decode rather than scanning nothing.
+  return mask == 0u ? (unsigned int)ALL : mask;
+}
+
+#pragma mark - formatValue -> our BarcodeFormat string
+
+// HUAWEI's `formatValue` is documented as the HMSScanFormatTypeCode integer.
+// We tolerate it being delivered as an NSNumber (bit value) OR an NSString
+// (either a numeric string or already a token like "QR_CODE"), since the
+// public headers do not pin the type and demos have shown both shapes.
++ (NSString *)formatStringFromValue:(id)formatValue
+{
+  // Case 1: numeric (NSNumber, or numeric NSString) -> match the enum bit.
+  NSInteger code = NSNotFound;
+  if ([formatValue isKindOfClass:[NSNumber class]]) {
+    code = [(NSNumber *)formatValue integerValue];
+  } else if ([formatValue isKindOfClass:[NSString class]]) {
+    NSString *s = (NSString *)formatValue;
+    NSString *trimmed = [s stringByTrimmingCharactersInSet:
+                         [NSCharacterSet whitespaceAndNewlineCharacterSet]];
+    // Pure-integer string?
+    NSScanner *scanner = [NSScanner scannerWithString:trimmed];
+    NSInteger parsed = 0;
+    if ([scanner scanInteger:&parsed] && scanner.isAtEnd) {
+      code = parsed;
+    } else {
+      // Case 2: already a token string -> normalize known spellings.
+      NSString *upper = [trimmed uppercaseString];
+      if ([upper isEqualToString:@"PDF_417"]) return @"PDF417";
+      if ([upper isEqualToString:@"ITF"]) return @"ITF14";
+      static NSSet<NSString *> *known = nil;
+      static dispatch_once_t onceToken;
+      dispatch_once(&onceToken, ^{
+        known = [NSSet setWithArray:@[
+          @"QR_CODE", @"AZTEC", @"DATA_MATRIX", @"PDF417", @"CODABAR",
+          @"CODE_39", @"CODE_93", @"CODE_128", @"EAN_8", @"EAN_13",
+          @"UPC_A", @"UPC_E", @"ITF14", @"MULTI_FUNCTIONAL",
+        ]];
+      });
+      return [known containsObject:upper] ? upper : @"UNKNOWN";
+    }
+  } else {
+    return @"UNKNOWN";
+  }
+
+  // Map enum bit -> our string. Compare against the global enum constants.
+  switch (code) {
+    case QR_CODE:     return @"QR_CODE";
+    case AZTEC:       return @"AZTEC";
+    case DATA_MATRIX: return @"DATA_MATRIX";
+    case PDF_417:     return @"PDF417";
+    case CODABAR:     return @"CODABAR";
+    case CODE_39:     return @"CODE_39";
+    case CODE_93:     return @"CODE_93";
+    case CODE_128:    return @"CODE_128";
+    case EAN_8:       return @"EAN_8";
+    case EAN_13:      return @"EAN_13";
+    case UPC_A:       return @"UPC_A";
+    case UPC_E:       return @"UPC_E";
+    case ITF:         return @"ITF14";
+    default:          return @"UNKNOWN";
+  }
+}
+
+#pragma mark - sceneType -> our BarcodeContentType (best effort)
+
+// HUAWEI iOS does not publish a sceneType enum in the headers; precision is
+// limited. We map a few well-known scene tokens/codes and otherwise return nil
+// so `contentType` is omitted (the JS contract treats unknown as undefined).
++ (nullable NSString *)contentTypeFromSceneType:(id)sceneType
+{
+  NSString *token = nil;
+  if ([sceneType isKindOfClass:[NSString class]]) {
+    token = [[(NSString *)sceneType stringByTrimmingCharactersInSet:
+              [NSCharacterSet whitespaceAndNewlineCharacterSet]] uppercaseString];
+  } else if ([sceneType isKindOfClass:[NSNumber class]]) {
+    // No documented numeric scene mapping -> leave unknown.
+    return nil;
+  } else {
+    return nil;
+  }
+  if (token.length == 0) {
+    return nil;
+  }
+
+  static NSDictionary<NSString *, NSString *> *map = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    map = @{
+      @"TEXT": @"TEXT",
+      @"URL": @"URL",
+      @"URI": @"URL",
+      @"EMAIL": @"EMAIL",
+      @"PHONE": @"PHONE",
+      @"TEL": @"PHONE",
+      @"SMS": @"SMS",
+      @"WIFI": @"WIFI",
+      @"CONTACT": @"CONTACT",
+      @"CONTACT_INFO": @"CONTACT",
+      @"EVENT": @"EVENT",
+      @"LOCATION": @"LOCATION",
+      @"GEO": @"LOCATION",
+      @"DRIVER": @"DRIVER",
+      @"ISBN": @"ISBN",
+      @"ARTICLE": @"ARTICLE",
+      @"PRODUCT": @"ARTICLE",
+    };
+  });
+  return map[token];  // nil when unrecognized -> contentType omitted
+}
+
+#pragma mark - ResultPoint -> cornerPoints
+
++ (nullable NSNumber *)numberFromPointDict:(NSDictionary *)dict keys:(NSArray<NSString *> *)keys
+{
+  for (NSString *key in keys) {
+    id v = dict[key];
+    if ([v isKindOfClass:[NSNumber class]]) {
+      return (NSNumber *)v;
+    }
+    if ([v isKindOfClass:[NSString class]]) {
+      return @([(NSString *)v doubleValue]);
+    }
+  }
+  return nil;
+}
+
+// HUAWEI delivers `ResultPoint` as an array of dicts with `posX`/`posY` numbers.
+// We tolerate a couple of key spellings just in case.
++ (nullable NSArray<NSDictionary *> *)cornerPointsFromResultPoint:(id)resultPoint
+{
+  if (![resultPoint isKindOfClass:[NSArray class]]) {
+    return nil;
+  }
+  NSMutableArray<NSDictionary *> *points = [NSMutableArray array];
+  for (id element in (NSArray *)resultPoint) {
+    if (![element isKindOfClass:[NSDictionary class]]) {
+      continue;
+    }
+    NSDictionary *p = (NSDictionary *)element;
+    NSNumber *x = [self numberFromPointDict:p keys:@[ @"posX", @"x", @"X" ]];
+    NSNumber *y = [self numberFromPointDict:p keys:@[ @"posY", @"y", @"Y" ]];
+    if (x != nil && y != nil) {
+      [points addObject:@{ @"x": x, @"y": y }];
+    }
+  }
+  return points.count > 0 ? [points copy] : nil;
+}
+
+#pragma mark - Dict -> ScanResult
+
++ (nullable NSString *)valueFromHuaweiDict:(NSDictionary *)dict
+{
+  // Primary key is `text`; tolerate a couple of alternates defensively.
+  for (NSString *key in @[ @"text", @"originalValue", @"showText", @"value" ]) {
+    id v = dict[key];
+    if ([v isKindOfClass:[NSString class]] && ((NSString *)v).length > 0) {
+      return (NSString *)v;
+    }
+  }
+  return nil;
+}
+
++ (nullable NSDictionary *)scanResultFromHuaweiDict:(NSDictionary *)dict
+{
+  if (![dict isKindOfClass:[NSDictionary class]]) {
+    return nil;
+  }
+
+  NSString *value = [self valueFromHuaweiDict:dict];
+  if (value == nil) {
+    return nil;  // no usable decoded text -> drop
+  }
+
+  NSMutableDictionary *out = [NSMutableDictionary dictionary];
+  out[@"value"] = value;
+  out[@"format"] = [self formatStringFromValue:dict[@"formatValue"]];
+
+  NSString *contentType = [self contentTypeFromSceneType:dict[@"sceneType"]];
+  if (contentType != nil) {
+    out[@"contentType"] = contentType;
+  }
+
+  NSArray<NSDictionary *> *corners = [self cornerPointsFromResultPoint:dict[@"ResultPoint"]];
+  if (corners != nil) {
+    out[@"cornerPoints"] = corners;
+  }
+
+  return [out copy];
+}
+
++ (NSArray<NSDictionary *> *)scanResultsFromHuaweiArray:(NSArray *)array
+{
+  NSMutableArray<NSDictionary *> *results = [NSMutableArray array];
+  if ([array isKindOfClass:[NSArray class]]) {
+    for (id element in array) {
+      NSDictionary *mapped = [self scanResultFromHuaweiDict:element];
+      if (mapped != nil) {
+        [results addObject:mapped];
+      }
+    }
+  }
+  return [results copy];
+}
+
+#pragma mark - JSON
+
++ (NSString *)jsonStringFromScanResults:(NSArray<NSDictionary *> *)results
+{
+  NSArray *safe = [results isKindOfClass:[NSArray class]] ? results : @[];
+  if (![NSJSONSerialization isValidJSONObject:safe]) {
+    return @"[]";
+  }
+  NSError *error = nil;
+  NSData *data = [NSJSONSerialization dataWithJSONObject:safe options:0 error:&error];
+  if (data == nil || error != nil) {
+    return @"[]";
+  }
+  NSString *json = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+  return json ?: @"[]";
+}
+
++ (NSString *)jsonStringFromHuaweiArray:(NSArray *)array
+{
+  return [self jsonStringFromScanResults:[self scanResultsFromHuaweiArray:array]];
+}
+
+@end

package/ios/HmsScanView.h

@@ -0,0 +1,24 @@
+//
+//  HmsScanView.h
+//  @unif/react-native-hms-scan
+//
+//  Fabric component registered under the name "HmsScanView". Hosts HUAWEI Scan
+//  Kit's HmsCustomScanViewController as an embedded child view controller and
+//  bridges its delegate callbacks to the codegen events
+//  (onScanResult / onScanError / onTorchStatus).
+//
+
+#import <React/RCTViewComponentView.h>
+#import <UIKit/UIKit.h>
+
+#ifndef HmsScanViewNativeComponent_h
+#define HmsScanViewNativeComponent_h
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface HmsScanView : RCTViewComponentView
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* HmsScanViewNativeComponent_h */

package/ios/HmsScanView.mm

@@ -0,0 +1,322 @@
+//
+//  HmsScanView.mm
+//  @unif/react-native-hms-scan
+//
+
+#import "HmsScanView.h"
+#import "HmsScanResultMapper.h"
+
+#import <React/RCTConversions.h>
+
+#import <react/renderer/components/ReactNativeHmsScanSpec/ComponentDescriptors.h>
+#import <react/renderer/components/ReactNativeHmsScanSpec/EventEmitters.h>
+#import <react/renderer/components/ReactNativeHmsScanSpec/Props.h>
+#import <react/renderer/components/ReactNativeHmsScanSpec/RCTComponentViewHelpers.h>
+
+#import "RCTFabricComponentsPlugins.h"
+
+#import <AVFoundation/AVFoundation.h>
+#import <ScanKitFrameWork/ScanKitFrameWork.h>
+
+using namespace facebook::react;
+
+@interface HmsScanView () <CustomizedScanDelegate>
+@end
+
+@implementation HmsScanView {
+  HmsCustomScanViewController *_scanVC;
+  // Mirror of the props we apply imperatively, so updateProps can diff against
+  // the *actually applied* state (RCTViewComponentView resets _props each call).
+  NSString *_appliedFormatsCsv;
+  BOOL _appliedContinuous;
+  BOOL _appliedPaused;
+  BOOL _appliedTorch;
+  BOOL _hasAppliedOnce;
+  BOOL _childAttached;
+}
+
+#pragma mark - Codegen wiring
+
++ (ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return concreteComponentDescriptorProvider<HmsScanViewComponentDescriptor>();
+}
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    static const auto defaultProps = std::make_shared<const HmsScanViewProps>();
+    _props = defaultProps;
+
+    _appliedContinuous = YES;  // matches WithDefault<boolean, true>
+    _appliedPaused = NO;
+    _appliedTorch = NO;
+    _appliedFormatsCsv = @"";  // matches WithDefault<string, ''> (= all formats)
+    _hasAppliedOnce = NO;
+    _childAttached = NO;
+
+    [self buildScanViewControllerWithCsv:_appliedFormatsCsv];
+  }
+  return self;
+}
+
+#pragma mark - Scan view controller lifecycle
+
+- (void)buildScanViewControllerWithCsv:(NSString *)csv
+{
+  // (Re)create the VC. HmsCustomScanViewController takes its format set at init
+  // via HmsScanOptions and exposes no setter to change it later, so a formatsCsv
+  // change requires rebuilding the controller.
+  [self teardownScanViewController];
+
+  unsigned int formatType = [HmsScanResultMapper scanFormatTypeFromCsv:csv];
+  HmsScanOptions *options =
+      [[HmsScanOptions alloc] initWithScanFormatType:formatType Photo:NO];
+
+  HmsCustomScanViewController *vc =
+      [[HmsCustomScanViewController alloc] initCustomizedScanWithFormatType:options];
+  vc.backButtonHidden = YES;            // we render our own chrome from JS
+  vc.customizedScanDelegate = self;
+  vc.continuouslyScan = _appliedContinuous;
+
+  _scanVC = vc;
+  _appliedFormatsCsv = csv ?: @"";
+
+  // Embed the VC's view as our content view, filling self.
+  UIView *scanView = vc.view;
+  scanView.frame = self.bounds;
+  scanView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+  self.contentView = scanView;
+
+  // If we're already on screen, (re)attach to the nearest view controller.
+  if (self.window != nil) {
+    [self attachChildViewController];
+  }
+
+  // Re-apply paused state after a rebuild (continuouslyScan was set above).
+  if (_appliedPaused) {
+    [_scanVC pauseContinuouslyScan];
+  } else {
+    [_scanVC resumeContinuouslyScan];
+  }
+}
+
+- (void)teardownScanViewController
+{
+  if (_scanVC == nil) {
+    return;
+  }
+  [self detachChildViewController];
+  _scanVC.customizedScanDelegate = nil;
+  if (self.contentView == _scanVC.view) {
+    self.contentView = nil;
+  }
+  _scanVC = nil;
+}
+
+- (void)attachChildViewController
+{
+  if (_scanVC == nil || _childAttached) {
+    return;
+  }
+  UIViewController *parent = [self reactViewController];
+  if (parent == nil) {
+    return;  // try again on next didMoveToWindow
+  }
+  [parent addChildViewController:_scanVC];
+  // The view is already in our hierarchy (set as contentView); just notify.
+  [_scanVC didMoveToParentViewController:parent];
+  _childAttached = YES;
+}
+
+- (void)detachChildViewController
+{
+  if (_scanVC == nil || !_childAttached) {
+    return;
+  }
+  [_scanVC willMoveToParentViewController:nil];
+  [_scanVC removeFromParentViewController];
+  _childAttached = NO;
+}
+
+- (void)didMoveToWindow
+{
+  [super didMoveToWindow];
+  if (self.window != nil) {
+    [self attachChildViewController];
+  } else {
+    [self detachChildViewController];
+  }
+}
+
+#pragma mark - Props
+
+- (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
+{
+  const auto &newViewProps = *std::static_pointer_cast<HmsScanViewProps const>(props);
+
+  NSString *newCsv = [NSString stringWithUTF8String:newViewProps.formatsCsv.c_str()];
+  if (newCsv == nil) {
+    newCsv = @"";
+  }
+  BOOL newContinuous = newViewProps.continuous;
+  BOOL newPaused = newViewProps.paused;
+  BOOL newTorch = newViewProps.torch;
+
+  BOOL first = !_hasAppliedOnce;
+
+  // formatsCsv change -> rebuild the controller (carry over continuous/paused).
+  if (first || ![newCsv isEqualToString:_appliedFormatsCsv]) {
+    _appliedContinuous = newContinuous;
+    _appliedPaused = newPaused;
+    [self buildScanViewControllerWithCsv:newCsv];
+  } else {
+    // continuous change -> toggle continuouslyScan in place.
+    if (newContinuous != _appliedContinuous) {
+      _appliedContinuous = newContinuous;
+      _scanVC.continuouslyScan = newContinuous;
+    }
+    // paused change -> pause/resume in place.
+    if (newPaused != _appliedPaused) {
+      _appliedPaused = newPaused;
+      if (newPaused) {
+        [_scanVC pauseContinuouslyScan];
+      } else {
+        [_scanVC resumeContinuouslyScan];
+      }
+    }
+  }
+
+  // torch change (best-effort, see applyTorch:).
+  if (first || newTorch != _appliedTorch) {
+    _appliedTorch = newTorch;
+    [self applyTorch:newTorch];
+  }
+
+  _hasAppliedOnce = YES;
+
+  [super updateProps:props oldProps:oldProps];
+}
+
+#pragma mark - Torch (best-effort)
+
+// HUAWEI Scan Kit exposes NO public torch API on iOS — HmsCustomScanViewController
+// renders its own torch button and auto-detects low light. We therefore drive the
+// torch directly through AVFoundation as a best-effort convenience. This is NOT
+// guaranteed to stay in sync with HUAWEI's built-in torch button, and may be a
+// no-op if HUAWEI holds an exclusive lock on the capture device's configuration.
+- (void)applyTorch:(BOOL)on
+{
+  BOOL available = NO;
+  BOOL torchOn = [self setTorchHardwareOn:on available:&available];
+  [self emitTorchStatusAvailable:available on:torchOn];
+}
+
+// Mutates the capture device's torch. Returns the resulting on-state and writes
+// hardware availability into `available`. Does NOT emit any event (so it can be
+// reused on teardown/recycle without firing onTorchStatus on a stale emitter).
+- (BOOL)setTorchHardwareOn:(BOOL)on available:(BOOL *)available
+{
+  AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
+  BOOL isAvailable = (device != nil && device.hasTorch && device.isTorchAvailable);
+  if (available != NULL) {
+    *available = isAvailable;
+  }
+  if (!isAvailable) {
+    return NO;
+  }
+
+  BOOL torchOn = NO;
+  NSError *error = nil;
+  if ([device lockForConfiguration:&error]) {
+    if (on && [device isTorchModeSupported:AVCaptureTorchModeOn]) {
+      device.torchMode = AVCaptureTorchModeOn;
+      torchOn = YES;
+    } else {
+      device.torchMode = AVCaptureTorchModeOff;
+      torchOn = NO;
+    }
+    [device unlockForConfiguration];
+  }
+  // On lock failure we silently ignore (best-effort) and report torchOn = NO.
+  return torchOn;
+}
+
+#pragma mark - CustomizedScanDelegate
+
+// Called by HUAWEI on every decode (repeatedly in continuous mode). `resultDic`
+// is a single result dictionary; we wrap it into the contract's top-level array.
+- (void)customizedScanDelegateForResult:(NSDictionary *)resultDic
+{
+  NSDictionary *mapped = [HmsScanResultMapper scanResultFromHuaweiDict:resultDic];
+  if (mapped == nil) {
+    // Decoded payload had no usable value; surface as a soft error event.
+    [self emitScanErrorWithCode:@"E_NO_RESULT" message:@"扫码结果为空或无法解析"];
+    return;
+  }
+  NSString *json = [HmsScanResultMapper jsonStringFromScanResults:@[ mapped ]];
+  [self emitScanResultJson:json];
+}
+
+#pragma mark - Event emitters
+
+- (void)emitScanResultJson:(NSString *)json
+{
+  if (!_eventEmitter) {
+    return;
+  }
+  std::string resultsJson = json ? std::string([json UTF8String]) : std::string("[]");
+  std::static_pointer_cast<const HmsScanViewEventEmitter>(_eventEmitter)
+      ->onScanResult(HmsScanViewEventEmitter::OnScanResult{
+          .resultsJson = resultsJson,
+      });
+}
+
+- (void)emitScanErrorWithCode:(NSString *)code message:(NSString *)message
+{
+  if (!_eventEmitter) {
+    return;
+  }
+  std::static_pointer_cast<const HmsScanViewEventEmitter>(_eventEmitter)
+      ->onScanError(HmsScanViewEventEmitter::OnScanError{
+          .code = code ? std::string([code UTF8String]) : std::string(""),
+          .message = message ? std::string([message UTF8String]) : std::string(""),
+      });
+}
+
+- (void)emitTorchStatusAvailable:(BOOL)available on:(BOOL)on
+{
+  if (!_eventEmitter) {
+    return;
+  }
+  std::static_pointer_cast<const HmsScanViewEventEmitter>(_eventEmitter)
+      ->onTorchStatus(HmsScanViewEventEmitter::OnTorchStatus{
+          .available = available ? true : false,
+          .on = on ? true : false,
+      });
+}
+
+#pragma mark - Cleanup
+
+- (void)prepareForRecycle
+{
+  // Reset imperative state so a recycled view re-applies props cleanly.
+  // Turn the torch off WITHOUT emitting (the emitter is being torn down).
+  [self setTorchHardwareOn:NO available:NULL];
+  [self teardownScanViewController];
+  _hasAppliedOnce = NO;
+  _appliedFormatsCsv = @"";
+  _appliedContinuous = YES;
+  _appliedPaused = NO;
+  _appliedTorch = NO;
+  [super prepareForRecycle];
+}
+
+- (void)dealloc
+{
+  if (_scanVC != nil) {
+    _scanVC.customizedScanDelegate = nil;
+  }
+}
+
+@end

package/lib/module/HmsScanView.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import { forwardRef } from 'react';
+import NativeHmsScanView from './HmsScanViewNativeComponent';
+import { formatsToCsv, parseResultsJson } from "./format.js";
+
+/** 暗光提示 / 手电状态。 */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 底层 headless 扫码相机组件：只渲染相机预览并发出扫码结果事件。
+ * 取景框 / 扫描线 / 手电按钮等 UI 由上层（如 `<Scanner>`）用普通 RN 视图叠加绘制。
+ *
+ * Android = 华为 RemoteView，iOS = HmsCustomScanViewController（Scan SDK-Plus / ScanKitFrameWork）。
+ */
+export const HmsScanView = /*#__PURE__*/forwardRef(function HmsScanView({
+  formats,
+  continuous = true,
+  paused = false,
+  torch = false,
+  onScanResult,
+  onScanError,
+  onTorchStatus,
+  ...viewProps
+}, ref) {
+  return /*#__PURE__*/_jsx(NativeHmsScanView, {
+    ...viewProps,
+    ref: ref,
+    formatsCsv: formatsToCsv(formats),
+    continuous: continuous,
+    paused: paused,
+    torch: torch,
+    onScanResult: onScanResult ? e => onScanResult(parseResultsJson(e.nativeEvent.resultsJson)) : undefined,
+    onScanError: onScanError ? e => onScanError({
+      code: e.nativeEvent.code,
+      message: e.nativeEvent.message
+    }) : undefined,
+    onTorchStatus: onTorchStatus ? e => onTorchStatus({
+      available: e.nativeEvent.available,
+      on: e.nativeEvent.on
+    }) : undefined
+  });
+});
+//# sourceMappingURL=HmsScanView.js.map

package/lib/module/HmsScanView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["forwardRef","NativeHmsScanView","formatsToCsv","parseResultsJson","jsx","_jsx","HmsScanView","formats","continuous","paused","torch","onScanResult","onScanError","onTorchStatus","viewProps","ref","formatsCsv","e","nativeEvent","resultsJson","undefined","code","message","available","on"],"sourceRoot":"../../src","sources":["HmsScanView.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAA2B,OAAO;AAErD,OAAOC,iBAAiB,MAAM,8BAA8B;AAC5D,SAASC,YAAY,EAAEC,gBAAgB,QAAQ,aAAU;;AAGzD;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAyBA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAAW,gBAAGN,UAAU,CAGnC,SAASM,WAAWA,CACpB;EACEC,OAAO;EACPC,UAAU,GAAG,IAAI;EACjBC,MAAM,GAAG,KAAK;EACdC,KAAK,GAAG,KAAK;EACbC,YAAY;EACZC,WAAW;EACXC,aAAa;EACb,GAAGC;AACL,CAAC,EACDC,GAAG,EACH;EACA,oBACEV,IAAA,CAACJ,iBAAiB;IAAA,GACZa,SAAS;IACbC,GAAG,EAAEA,GAAI;IACTC,UAAU,EAAEd,YAAY,CAACK,OAAO,CAAE;IAClCC,UAAU,EAAEA,UAAW;IACvBC,MAAM,EAAEA,MAAO;IACfC,KAAK,EAAEA,KAAM;IACbC,YAAY,EACVA,YAAY,GACPM,CAAC,IAAKN,YAAY,CAACR,gBAAgB,CAACc,CAAC,CAACC,WAAW,CAACC,WAAW,CAAC,CAAC,GAChEC,SACL;IACDR,WAAW,EACTA,WAAW,GACNK,CAAC,IACAL,WAAW,CAAC;MACVS,IAAI,EAAEJ,CAAC,CAACC,WAAW,CAACG,IAAI;MACxBC,OAAO,EAAEL,CAAC,CAACC,WAAW,CAACI;IACzB,CAAC,CAAC,GACJF,SACL;IACDP,aAAa,EACXA,aAAa,GACRI,CAAC,IACAJ,aAAa,CAAC;MACZU,SAAS,EAAEN,CAAC,CAACC,WAAW,CAACK,SAAS;MAClCC,EAAE,EAAEP,CAAC,CAACC,WAAW,CAACM;IACpB,CAAC,CAAC,GACJJ;EACL,CACF,CAAC;AAEN,CAAC,CAAC","ignoreList":[]}