@onefootprint/footprint-native-camera-module 0.1.0 → 0.1.2

package/FootprintNativeCameraSwift/Frameworks/FootprintNativeCameraSwift.xcframework/ios-arm64_x86_64-simulator/FootprintNativeCameraSwift.framework/Modules/FootprintNativeCameraSwift.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -1,6 +1,6 @@
 // swift-interface-format-version: 1.0
 // swift-compiler-version: Apple Swift version 6.3.3 (swiftlang-6.3.3.1.3 clang-2100.1.1.101)
-// swift-module-flags: -target x86_64-apple-ios16.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FootprintNativeCameraSwift -package-name footprintnativecameraswift
+// swift-module-flags: -target x86_64-apple-ios14.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FootprintNativeCameraSwift -package-name footprintnativecameraswift
 // swift-module-flags-ignorable:  -formal-cxx-interoperability-mode=off -interface-compiler-version 6.3.3
 import AVFoundation
 import Combine
@@ -26,13 +26,25 @@ import _StringProcessing
 import _SwiftConcurrencyShims
 public class AutocaptureManager {
   public init()
-  public func detectForAutoCapture(_ image: CoreVideo.CVPixelBuffer, orientation: ImageIO.CGImagePropertyOrientation, side: Swift.String) -> Swift.String
+  public func detectForAutoCapture(_ image: CoreVideo.CVPixelBuffer, orientation: ImageIO.CGImagePropertyOrientation, side: Swift.String, isPassport: Swift.Bool = false) -> Swift.String
   @objc deinit
 }
 public struct CameraConstants {
   public let deviceToFrameWidthRatioPortraitDoc: CoreFoundation.CGFloat
   public let deviceToFrameWidthRatioLandscapeDoc: CoreFoundation.CGFloat
   public let deviceToFrameRatioSelfie: CoreFoundation.CGFloat
+  public let documentBoxHeightRatioCard: CoreFoundation.CGFloat
+  public let documentBoxHeightRatioPassport: CoreFoundation.CGFloat
+  public let documentCenteringMargin: CoreFoundation.CGFloat
+  public let documentAcceptFillFactor: CoreFoundation.CGFloat
+  public let documentMaxFillFactor: CoreFoundation.CGFloat
+  public let documentAcceptFillFactorPassport: CoreFoundation.CGFloat
+  public let documentMaxFillFactorPassport: CoreFoundation.CGFloat
+  public let documentCenteringMarginPassport: CoreFoundation.CGFloat
+  public let motionAccelerationThresholdPassport: Swift.Double
+  public let autocaptureGracePeriod: Swift.Double
+  public let autocaptureGracePeriodPassport: Swift.Double
+  public let motionAccelerationThreshold: Swift.Double
   public init()
 }
 public enum CameraError : Swift.Error {
@@ -57,7 +69,7 @@ public enum CameraError : Swift.Error {
   }
   final public let orientationHelper: FootprintNativeCameraSwift.CameraOrientationHelper
   @objc override dynamic public init()
-  public func setupCaptureSession() throws
+  public func setupCaptureSession(position: AVFoundation.AVCaptureDevice.Position = .back) throws
   public func setupDetection(processFrame: @escaping (CoreVideo.CVImageBuffer, ImageIO.CGImagePropertyOrientation) -> Swift.Void)
   public func switchToFrontCamera()
   public func capturePhoto(completion: @escaping (Swift.Result<AVFoundation.AVCapturePhoto, FootprintNativeCameraSwift.CameraError>) -> Swift.Void)
@@ -162,10 +174,12 @@ public struct CaptureTokens {
   public let backgroundColor: FootprintNativeCameraSwift.CaptureTokens.BackgroundColor
   public let textColor: FootprintNativeCameraSwift.CaptureTokens.TextColor
   public let borderColor: FootprintNativeCameraSwift.CaptureTokens.BorderColor
-  public init(accent: SwiftUICore.Color = Color(fpHex: 0xFF4A24DB))
+  public init(accent: SwiftUICore.Color = Color(fpHex: 0xFF387F7F))
 }
 extension SwiftUICore.Color {
   public init(fpHex hex: Swift.UInt32)
+  public init(fpHex light: Swift.UInt32, dark: Swift.UInt32)
+  public init?(fpHexString hex: Swift.String?)
 }
 final public class CameraCaptureViewModel : Combine.ObservableObject, @unchecked Swift.Sendable {
   @Combine.Published<FootprintNativeCamera.CameraCaptureState> @_projectedValueProperty($cameraCaptureState) final public var cameraCaptureState: FootprintNativeCamera.CameraCaptureState {
@@ -358,7 +372,7 @@ public enum CaptureButtonVariant {
   public typealias Body = @_opaqueReturnTypeOf("$s26FootprintNativeCameraSwift21CapturePreviewOverlayV4bodyQrvp", 0) __
 }
 @_Concurrency.MainActor @preconcurrency public struct CountdownView : SwiftUICore.View {
-  @_Concurrency.MainActor @preconcurrency public init(shouldRun: SwiftUICore.Binding<Swift.Bool>, tokens: FootprintNativeCameraSwift.CaptureTokens = CaptureTokens(), onComplete: @escaping () -> Swift.Void)
+  @_Concurrency.MainActor @preconcurrency public init(shouldRun: SwiftUICore.Binding<Swift.Bool>, tokens: FootprintNativeCameraSwift.CaptureTokens = CaptureTokens(), isPassport: Swift.Bool = false, onComplete: @escaping () -> Swift.Void)
   @_Concurrency.MainActor @preconcurrency public var body: some SwiftUICore.View {
     get
   }

package/FootprintNativeCameraSwift/Frameworks/FootprintNativeCameraSwift.xcframework/ios-arm64_x86_64-simulator/FootprintNativeCameraSwift.framework/Modules/FootprintNativeCameraSwift.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -1,6 +1,6 @@
 // swift-interface-format-version: 1.0
 // swift-compiler-version: Apple Swift version 6.3.3 (swiftlang-6.3.3.1.3 clang-2100.1.1.101)
-// swift-module-flags: -target x86_64-apple-ios16.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FootprintNativeCameraSwift -package-name footprintnativecameraswift
+// swift-module-flags: -target x86_64-apple-ios14.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name FootprintNativeCameraSwift -package-name footprintnativecameraswift
 // swift-module-flags-ignorable:  -formal-cxx-interoperability-mode=off -interface-compiler-version 6.3.3
 import AVFoundation
 import Combine
@@ -26,13 +26,25 @@ import _StringProcessing
 import _SwiftConcurrencyShims
 public class AutocaptureManager {
   public init()
-  public func detectForAutoCapture(_ image: CoreVideo.CVPixelBuffer, orientation: ImageIO.CGImagePropertyOrientation, side: Swift.String) -> Swift.String
+  public func detectForAutoCapture(_ image: CoreVideo.CVPixelBuffer, orientation: ImageIO.CGImagePropertyOrientation, side: Swift.String, isPassport: Swift.Bool = false) -> Swift.String
   @objc deinit
 }
 public struct CameraConstants {
   public let deviceToFrameWidthRatioPortraitDoc: CoreFoundation.CGFloat
   public let deviceToFrameWidthRatioLandscapeDoc: CoreFoundation.CGFloat
   public let deviceToFrameRatioSelfie: CoreFoundation.CGFloat
+  public let documentBoxHeightRatioCard: CoreFoundation.CGFloat
+  public let documentBoxHeightRatioPassport: CoreFoundation.CGFloat
+  public let documentCenteringMargin: CoreFoundation.CGFloat
+  public let documentAcceptFillFactor: CoreFoundation.CGFloat
+  public let documentMaxFillFactor: CoreFoundation.CGFloat
+  public let documentAcceptFillFactorPassport: CoreFoundation.CGFloat
+  public let documentMaxFillFactorPassport: CoreFoundation.CGFloat
+  public let documentCenteringMarginPassport: CoreFoundation.CGFloat
+  public let motionAccelerationThresholdPassport: Swift.Double
+  public let autocaptureGracePeriod: Swift.Double
+  public let autocaptureGracePeriodPassport: Swift.Double
+  public let motionAccelerationThreshold: Swift.Double
   public init()
 }
 public enum CameraError : Swift.Error {
@@ -57,7 +69,7 @@ public enum CameraError : Swift.Error {
   }
   final public let orientationHelper: FootprintNativeCameraSwift.CameraOrientationHelper
   @objc override dynamic public init()
-  public func setupCaptureSession() throws
+  public func setupCaptureSession(position: AVFoundation.AVCaptureDevice.Position = .back) throws
   public func setupDetection(processFrame: @escaping (CoreVideo.CVImageBuffer, ImageIO.CGImagePropertyOrientation) -> Swift.Void)
   public func switchToFrontCamera()
   public func capturePhoto(completion: @escaping (Swift.Result<AVFoundation.AVCapturePhoto, FootprintNativeCameraSwift.CameraError>) -> Swift.Void)
@@ -162,10 +174,12 @@ public struct CaptureTokens {
   public let backgroundColor: FootprintNativeCameraSwift.CaptureTokens.BackgroundColor
   public let textColor: FootprintNativeCameraSwift.CaptureTokens.TextColor
   public let borderColor: FootprintNativeCameraSwift.CaptureTokens.BorderColor
-  public init(accent: SwiftUICore.Color = Color(fpHex: 0xFF4A24DB))
+  public init(accent: SwiftUICore.Color = Color(fpHex: 0xFF387F7F))
 }
 extension SwiftUICore.Color {
   public init(fpHex hex: Swift.UInt32)
+  public init(fpHex light: Swift.UInt32, dark: Swift.UInt32)
+  public init?(fpHexString hex: Swift.String?)
 }
 final public class CameraCaptureViewModel : Combine.ObservableObject, @unchecked Swift.Sendable {
   @Combine.Published<FootprintNativeCamera.CameraCaptureState> @_projectedValueProperty($cameraCaptureState) final public var cameraCaptureState: FootprintNativeCamera.CameraCaptureState {
@@ -358,7 +372,7 @@ public enum CaptureButtonVariant {
   public typealias Body = @_opaqueReturnTypeOf("$s26FootprintNativeCameraSwift21CapturePreviewOverlayV4bodyQrvp", 0) __
 }
 @_Concurrency.MainActor @preconcurrency public struct CountdownView : SwiftUICore.View {
-  @_Concurrency.MainActor @preconcurrency public init(shouldRun: SwiftUICore.Binding<Swift.Bool>, tokens: FootprintNativeCameraSwift.CaptureTokens = CaptureTokens(), onComplete: @escaping () -> Swift.Void)
+  @_Concurrency.MainActor @preconcurrency public init(shouldRun: SwiftUICore.Binding<Swift.Bool>, tokens: FootprintNativeCameraSwift.CaptureTokens = CaptureTokens(), isPassport: Swift.Bool = false, onComplete: @escaping () -> Swift.Void)
   @_Concurrency.MainActor @preconcurrency public var body: some SwiftUICore.View {
     get
   }

package/FootprintNativeCameraSwift/Frameworks/FootprintNativeCameraSwift.xcframework/ios-arm64_x86_64-simulator/FootprintNativeCameraSwift.framework/_CodeSignature/CodeResources

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Info.plist</key>
 		<data>
-		e+6I2QVj1oQDl5Y8dQFzGFz2Iso=
+		AfTq1fznIspUiSdLqri9a+rL6Gc=
 		</data>
 	</dict>
 	<key>files2</key>

package/FootprintNativeCameraSwift.podspec

@@ -10,7 +10,7 @@ Pod::Spec.new do |s|
   s.license        = package['license']
   s.author         = 'Footprint'
   s.homepage       = 'https://onefootprint.com'
-  s.platforms      = { :ios => '16.0' }
+  s.platforms      = { :ios => '14.0' }
   s.swift_version  = '5.9'
   s.source         = { git: '' }
   s.static_framework = true

package/README.md

@@ -1,78 +1,34 @@
-# footprint-native-camera-module
+# @onefootprint/footprint-native-camera-module
 
-KMM module providing the native document capture screen, detection / autocapture, and per-side upload contract. Same source consumed by:
+Native document-capture implementation — camera, auto-capture, and on-device
+detection — for [Footprint](https://www.onefootprint.com)'s Expo SDK. It ships the
+compiled iOS and Android binaries and is consumed through
+[`@onefootprint/footprint-expo-camera-module`](https://www.npmjs.com/package/@onefootprint/footprint-expo-camera-module);
+you don't call it directly.
 
-- `HandoffSharedLogic` — via SwiftPM (iOS) and a Gradle composite build (Android), for the existing handoff flow.
-- `@onefootprint/footprint-expo-camera-module` — via React Native autolinking (iOS podspec + Android gradle subproject), for the Expo SDK's native document capture.
+## Install
 
-## Public surface (common)
-
-| File | What |
-|---|---|
-| `CameraCaptureState.kt` / `CaptureMode.kt` / `AutoCaptureStatus.kt` | Camera/capture state enums (`.value: String` for cross-runtime mapping). |
-| `DocumentSide.kt` | `typealias DocumentSide = String` + `DocumentSides` constants. |
-| `CaptureAppearance.kt` / `CaptureTheme.kt` | Theme contract painted by the capture screen. Built via `CaptureAppearance.fromVariables(...)` from the broader `Appearance.variables` bag. |
-| `CaptureCopy.kt` / `CaptureTranslations.kt` | Localized copy table keyed by language code. |
-| `CaptureUploadClient.kt` | Interface for per-side upload + process. Adapters provided by consumers. |
-
-## Public surface (Android)
-
-| File | What |
-|---|---|
-| `DocumentCaptureScreen.kt` | Compose screen. Same name as iOS's SwiftUI view. |
-| `DocumentCaptureActivity.kt` | Hosts the Compose screen. Declared in this module's `AndroidManifest.xml`; merged into consumer apps automatically. |
-| `DocumentCaptureContract.kt` | `ActivityResultContract<DocumentCaptureInput, DocumentCaptureOutcome>`. |
-| `AutocaptureManager.kt` / `DocumentDetection.kt` / `FaceDetection.kt` | Per-frame detection. |
-
-## Public surface (iOS — via `FootprintNativeCameraSwift/Sources/`)
-
-| File | What |
-|---|---|
-| `DocumentCaptureScreen.swift` | SwiftUI view. Wrap in `UIHostingController` from UIKit hosts. |
-| `CameraManager.swift` / `AutocaptureManager.swift` / `CameraPreview.swift` / `PhotoPicker.swift` | Capture primitives. |
-
-## Distribution
-
-| Target | How |
-|---|---|
-| HandoffSwift (iOS) | Consumes `FootprintNativeCameraSwift/Package.swift` (SwiftPM). |
-| HandoffSharedLogic (Android) | Composite Gradle build — `includeBuild("../footprint-native-camera-module")` in `HandoffSharedLogic/settings.gradle.kts`. |
-| Expo bridge (both) | React Native autolinking via `react-native.config.js` → `FootprintNativeCameraSwift.podspec` (iOS) + `android/build.gradle` (Android). |
-
-## Build
+Install it together with the camera bridge and the SDK:
 
 ```sh
-pnpm build:native     # ./gradlew :shared:assembleRelease + :shared:packForXcode, copies AAR to android/libs/
-pnpm build:android    # just the AAR
-pnpm build:ios        # just the xcframework
+npm install @onefootprint/footprint-expo \
+            @onefootprint/footprint-expo-camera-module \
+            @onefootprint/footprint-native-camera-module
 ```
 
-Outputs:
-- `FootprintNativeCameraSwift/Frameworks/FootprintNativeCamera.xcframework` — Kotlin types
-- `android/libs/footprint-native-camera-module.aar` — Android library
-- Both are gitignored and regenerated from source.
-
-## Dev workflow
+React Native autolinking wires up the native code automatically (iOS podspec +
+Android Gradle) — there's no manual native setup. Run `npx expo prebuild --clean`
+after installing.
 
-When you change Kotlin or Swift in this module:
+## Documentation
 
-```sh
-# In this directory:
-pnpm build:native              # rebuilds xcframework + AAR
-yalc publish                    # pushes to local yalc store
-
-# In any consumer (footprint-expo-camera-module, ...):
-yalc update                     # pulls the latest from yalc
-pnpm install
-```
+See the **[native onboarding guide](https://docs.onefootprint.com/articles/sdks/expo-native)**
+for the full integration (initialize → identify → collect → process).
 
-For HandoffSwift / HandoffSharedLogic, no yalc — they consume sources via SwiftPM / composite Gradle build directly.
+## Requirements
 
-## Publishing to npm
+Expo SDK 53+, React 19+, React Native 0.70+.
 
-Published as `@onefootprint/footprint-native-camera-module` via the `mobile_npm_publish` GitHub
-workflow (macOS runner, npm OIDC trusted publishing). `prepack` runs `build:native`, so the
-gitignored xcframeworks + AAR are rebuilt from source and packed into the tarball. Preview the
-tarball contents with `npm pack --dry-run`.
+## License
 
-Publish the **native module before** the Expo bridge — the bridge peer-depends on it.
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onefootprint/footprint-native-camera-module",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Native KMM camera module: detection, autocapture, and document capture UI for iOS + Android. Consumed by @onefootprint/footprint-expo-camera-module (the Expo bridge) and by HandoffSharedLogic.",
   "repository": {
     "type": "git",