@arfuhad/react-native-smart-camera 0.1.0

package/build/types.d.ts

@@ -0,0 +1,478 @@
+import type { ViewStyle } from 'react-native';
+/**
+ * Performance mode for face detection
+ * - 'fast': Favor speed over accuracy
+ * - 'accurate': Favor accuracy over speed
+ */
+export type PerformanceMode = 'fast' | 'accurate';
+/**
+ * Mode for detecting facial landmarks
+ * - 'none': Don't detect landmarks
+ * - 'all': Detect all landmarks (eyes, ears, nose, cheeks, mouth)
+ */
+export type LandmarkMode = 'none' | 'all';
+/**
+ * Mode for detecting facial contours
+ * - 'none': Don't detect contours
+ * - 'all': Detect contours (only for most prominent face)
+ */
+export type ContourMode = 'none' | 'all';
+/**
+ * Mode for face classification
+ * - 'none': Don't classify faces
+ * - 'all': Classify faces (smiling, eyes open)
+ */
+export type ClassificationMode = 'none' | 'all';
+/**
+ * Camera facing direction
+ */
+export type CameraFacing = 'front' | 'back';
+/**
+ * Common face detection options shared between frame processor and static images
+ */
+export interface FaceDetectionOptions {
+    /**
+     * Favor speed or accuracy when detecting faces
+     * @default 'fast'
+     */
+    performanceMode?: PerformanceMode;
+    /**
+     * Whether to identify facial landmarks: eyes, ears, nose, cheeks, mouth
+     * @default 'none'
+     */
+    landmarkMode?: LandmarkMode;
+    /**
+     * Whether to detect contours of facial features.
+     * Contours are detected for only the most prominent face in an image.
+     * @default 'none'
+     */
+    contourMode?: ContourMode;
+    /**
+     * Whether to classify faces into categories such as 'smiling' and 'eyes open'
+     * @default 'none'
+     */
+    classificationMode?: ClassificationMode;
+    /**
+     * Sets the smallest desired face size, expressed as the ratio
+     * of the width of the head to width of the image.
+     * @default 0.15
+     */
+    minFaceSize?: number;
+    /**
+     * Whether to assign faces an ID to track faces across images.
+     * Note: When contour detection is enabled, only one face is detected,
+     * so face tracking doesn't produce useful results. Don't enable both
+     * contour detection and face tracking for best performance.
+     * @default false
+     */
+    trackingEnabled?: boolean;
+}
+/**
+ * Frame processor specific options
+ */
+export interface FrameProcessorOptions extends FaceDetectionOptions {
+    /**
+     * Current active camera
+     * @default 'front'
+     */
+    cameraFacing?: CameraFacing;
+    /**
+     * Should handle auto scale (face bounds, contour and landmarks) and rotation
+     * on native side? If disabled, all detection results will be relative to frame
+     * coordinates, not to screen/preview.
+     * You shouldn't use this option if you want to draw on screen using Skia Frame Processor.
+     * @default false
+     */
+    autoMode?: boolean;
+    /**
+     * Required if you want to use autoMode. Screen width for coordinate scaling.
+     * You must handle your own logic to get screen sizes, with or without statusbar size, etc.
+     * @default 1.0
+     */
+    windowWidth?: number;
+    /**
+     * Required if you want to use autoMode. Screen height for coordinate scaling.
+     * You must handle your own logic to get screen sizes, with or without statusbar size, etc.
+     * @default 1.0
+     */
+    windowHeight?: number;
+}
+/**
+ * Static image face detection options
+ */
+export interface StaticImageOptions extends FaceDetectionOptions {
+    /**
+     * Image source for static face detection.
+     * Can be a require() result (number), a URI string, or an object with uri.
+     */
+    image: number | string | {
+        uri: string;
+    };
+}
+/**
+ * 2D point coordinates
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Bounding rectangle
+ */
+export interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Facial landmarks detected by ML Kit
+ */
+export interface FaceLandmarks {
+    leftEye?: Point;
+    rightEye?: Point;
+    leftEar?: Point;
+    rightEar?: Point;
+    leftCheek?: Point;
+    rightCheek?: Point;
+    noseBase?: Point;
+    leftMouth?: Point;
+    rightMouth?: Point;
+    bottomMouth?: Point;
+}
+/**
+ * Face contour types
+ */
+export type ContourType = 'face' | 'leftEyebrowTop' | 'leftEyebrowBottom' | 'rightEyebrowTop' | 'rightEyebrowBottom' | 'leftEye' | 'rightEye' | 'upperLipTop' | 'upperLipBottom' | 'lowerLipTop' | 'lowerLipBottom' | 'noseBridge' | 'noseBottom' | 'leftCheek' | 'rightCheek';
+/**
+ * Facial contours detected by ML Kit
+ */
+export interface FaceContours {
+    [key: string]: Point[];
+}
+/**
+ * Detected face data
+ */
+export interface Face {
+    /**
+     * Bounding box of the detected face
+     */
+    bounds: Bounds;
+    /**
+     * Roll angle of the face (rotation around front-to-back axis)
+     */
+    rollAngle?: number;
+    /**
+     * Pitch angle of the face (rotation around left-to-right axis)
+     */
+    pitchAngle?: number;
+    /**
+     * Yaw angle of the face (rotation around top-to-bottom axis)
+     */
+    yawAngle?: number;
+    /**
+     * Facial landmarks (when landmarkMode is 'all')
+     */
+    landmarks?: FaceLandmarks;
+    /**
+     * Facial contours (when contourMode is 'all')
+     */
+    contours?: FaceContours;
+    /**
+     * Probability that the face is smiling (0.0 - 1.0)
+     * Only available when classificationMode is 'all'
+     */
+    smilingProbability?: number;
+    /**
+     * Probability that the left eye is open (0.0 - 1.0)
+     * Only available when classificationMode is 'all'
+     */
+    leftEyeOpenProbability?: number;
+    /**
+     * Probability that the right eye is open (0.0 - 1.0)
+     * Only available when classificationMode is 'all'
+     */
+    rightEyeOpenProbability?: number;
+    /**
+     * Tracking ID for this face (when trackingEnabled is true)
+     */
+    trackingId?: number;
+}
+/**
+ * Blink detection event
+ */
+export interface BlinkEvent {
+    /**
+     * Timestamp when the blink was detected
+     */
+    timestamp: number;
+    /**
+     * Left eye open probability (0.0 - 1.0)
+     */
+    leftEyeOpen: number;
+    /**
+     * Right eye open probability (0.0 - 1.0)
+     */
+    rightEyeOpen: number;
+    /**
+     * Whether a blink was detected
+     */
+    isBlink: boolean;
+    /**
+     * Face tracking ID (when trackingEnabled is true)
+     */
+    faceId?: number;
+}
+/**
+ * WebRTC mode
+ * - 'call': Video calling (1:1 or group)
+ * - 'stream': Live streaming to a server
+ */
+export type WebRTCMode = 'call' | 'stream';
+/**
+ * WebRTC video constraints
+ */
+export interface VideoConstraints {
+    width?: number;
+    height?: number;
+    frameRate?: number;
+}
+/**
+ * WebRTC configuration
+ */
+export interface WebRTCConfig {
+    /**
+     * Whether WebRTC is enabled
+     */
+    enabled: boolean;
+    /**
+     * RTCPeerConnection instance
+     */
+    peerConnection?: RTCPeerConnection;
+    /**
+     * WebRTC mode (call or stream)
+     * @default 'call'
+     */
+    mode?: WebRTCMode;
+    /**
+     * Video constraints for the stream
+     */
+    videoConstraints?: VideoConstraints;
+}
+/**
+ * Face detection configuration for SmartCamera component
+ */
+export interface FaceDetectionConfig extends FaceDetectionOptions {
+    /**
+     * Whether face detection is enabled
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Handle auto scale on native side
+     * @default false
+     */
+    autoMode?: boolean;
+    /**
+     * Screen width for coordinate scaling (required when autoMode is true)
+     * @default 1.0
+     */
+    windowWidth?: number;
+    /**
+     * Screen height for coordinate scaling (required when autoMode is true)
+     * @default 1.0
+     */
+    windowHeight?: number;
+}
+/**
+ * SmartCamera component props
+ */
+export interface SmartCameraProps {
+    /**
+     * Camera facing direction
+     * @default 'front'
+     */
+    camera?: CameraFacing;
+    /**
+     * Target frame rate for the camera
+     * @default 30
+     */
+    fps?: number;
+    /**
+     * Style for the camera view
+     */
+    style?: ViewStyle;
+    /**
+     * Face detection configuration
+     */
+    faceDetection?: FaceDetectionConfig;
+    /**
+     * Whether blink detection is enabled
+     * @default false
+     */
+    blinkDetection?: boolean;
+    /**
+     * Callback when a blink is detected
+     */
+    onBlinkDetected?: (event: BlinkEvent) => void;
+    /**
+     * Callback when faces are detected
+     */
+    onFaceDetected?: (faces: Face[]) => void;
+    /**
+     * WebRTC configuration for streaming
+     */
+    webrtc?: WebRTCConfig;
+    /**
+     * Whether the camera is active
+     * @default true
+     */
+    isActive?: boolean;
+    /**
+     * Callback when camera is ready
+     */
+    onReady?: () => void;
+    /**
+     * Callback when an error occurs
+     */
+    onError?: (error: SmartCameraError) => void;
+}
+/**
+ * Error codes for SmartCamera
+ */
+export type SmartCameraErrorCode = 'CAMERA_UNAVAILABLE' | 'PERMISSION_DENIED' | 'WEBRTC_ERROR' | 'ML_KIT_ERROR' | 'FRAME_PROCESSOR_ERROR' | 'UNKNOWN_ERROR';
+/**
+ * SmartCamera error
+ */
+export interface SmartCameraError {
+    /**
+     * Error code
+     */
+    code: SmartCameraErrorCode;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Original native error (if available)
+     */
+    nativeError?: Error;
+}
+/**
+ * Return type for useSmartCameraWebRTC hook
+ */
+export interface UseSmartCameraWebRTCResult {
+    /**
+     * The video track for WebRTC
+     */
+    videoTrack: MediaStreamTrack | null;
+    /**
+     * Start streaming to the peer connection
+     */
+    startStreaming: () => void;
+    /**
+     * Stop streaming
+     */
+    stopStreaming: () => void;
+    /**
+     * Switch between front and back camera
+     */
+    switchCamera: () => void;
+    /**
+     * Whether streaming is active
+     */
+    isStreaming: boolean;
+}
+/**
+ * Return type for useFaceDetection hook
+ */
+export interface UseFaceDetectionResult {
+    /**
+     * Currently detected faces
+     */
+    faces: Face[];
+    /**
+     * Whether face detection is active/detecting
+     */
+    isDetecting: boolean;
+}
+/**
+ * Return type for useBlinkDetection hook
+ */
+export interface UseBlinkDetectionResult {
+    /**
+     * Last blink event
+     */
+    lastBlink: BlinkEvent | null;
+    /**
+     * Total blink count
+     */
+    blinkCount: number;
+    /**
+     * Reset blink count
+     */
+    resetCount: () => void;
+}
+/**
+ * Camera device information
+ */
+export interface CameraDevice {
+    /**
+     * Unique identifier for the camera device
+     */
+    id: string;
+    /**
+     * Human-readable name of the camera
+     */
+    name: string;
+    /**
+     * Camera position (front or back)
+     */
+    position: CameraFacing;
+    /**
+     * Whether the camera has a flash
+     */
+    hasFlash: boolean;
+    /**
+     * Whether the camera has a torch (flashlight)
+     */
+    hasTorch: boolean;
+    /**
+     * Whether the camera supports low-light boost
+     */
+    supportsLowLightBoost: boolean;
+}
+/**
+ * Return type for useSmartCamera hook
+ */
+export interface UseSmartCameraResult {
+    /**
+     * Whether camera permission has been granted
+     */
+    hasPermission: boolean;
+    /**
+     * Request camera permission
+     */
+    requestPermission: () => Promise<boolean>;
+    /**
+     * Current camera device
+     */
+    device: CameraDevice | undefined;
+    /**
+     * Switch between front and back camera
+     */
+    switchCamera: () => void;
+    /**
+     * Current camera facing direction
+     */
+    currentCamera: CameraFacing;
+}
+/**
+ * Device orientation
+ */
+export type Orientation = 'portrait' | 'portrait-upside-down' | 'landscape-left' | 'landscape-right';
+/**
+ * Camera output orientation
+ */
+export type OutputOrientation = Orientation | 'device';
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ViewStyle } from 'react-native';\n\n// ============================================================================\n// Face Detection Options\n// ============================================================================\n\n/**\n * Performance mode for face detection\n * - 'fast': Favor speed over accuracy\n * - 'accurate': Favor accuracy over speed\n */\nexport type PerformanceMode = 'fast' | 'accurate';\n\n/**\n * Mode for detecting facial landmarks\n * - 'none': Don't detect landmarks\n * - 'all': Detect all landmarks (eyes, ears, nose, cheeks, mouth)\n */\nexport type LandmarkMode = 'none' | 'all';\n\n/**\n * Mode for detecting facial contours\n * - 'none': Don't detect contours\n * - 'all': Detect contours (only for most prominent face)\n */\nexport type ContourMode = 'none' | 'all';\n\n/**\n * Mode for face classification\n * - 'none': Don't classify faces\n * - 'all': Classify faces (smiling, eyes open)\n */\nexport type ClassificationMode = 'none' | 'all';\n\n/**\n * Camera facing direction\n */\nexport type CameraFacing = 'front' | 'back';\n\n/**\n * Common face detection options shared between frame processor and static images\n */\nexport interface FaceDetectionOptions {\n  /**\n   * Favor speed or accuracy when detecting faces\n   * @default 'fast'\n   */\n  performanceMode?: PerformanceMode;\n\n  /**\n   * Whether to identify facial landmarks: eyes, ears, nose, cheeks, mouth\n   * @default 'none'\n   */\n  landmarkMode?: LandmarkMode;\n\n  /**\n   * Whether to detect contours of facial features.\n   * Contours are detected for only the most prominent face in an image.\n   * @default 'none'\n   */\n  contourMode?: ContourMode;\n\n  /**\n   * Whether to classify faces into categories such as 'smiling' and 'eyes open'\n   * @default 'none'\n   */\n  classificationMode?: ClassificationMode;\n\n  /**\n   * Sets the smallest desired face size, expressed as the ratio\n   * of the width of the head to width of the image.\n   * @default 0.15\n   */\n  minFaceSize?: number;\n\n  /**\n   * Whether to assign faces an ID to track faces across images.\n   * Note: When contour detection is enabled, only one face is detected,\n   * so face tracking doesn't produce useful results. Don't enable both\n   * contour detection and face tracking for best performance.\n   * @default false\n   */\n  trackingEnabled?: boolean;\n}\n\n/**\n * Frame processor specific options\n */\nexport interface FrameProcessorOptions extends FaceDetectionOptions {\n  /**\n   * Current active camera\n   * @default 'front'\n   */\n  cameraFacing?: CameraFacing;\n\n  /**\n   * Should handle auto scale (face bounds, contour and landmarks) and rotation\n   * on native side? If disabled, all detection results will be relative to frame\n   * coordinates, not to screen/preview.\n   * You shouldn't use this option if you want to draw on screen using Skia Frame Processor.\n   * @default false\n   */\n  autoMode?: boolean;\n\n  /**\n   * Required if you want to use autoMode. Screen width for coordinate scaling.\n   * You must handle your own logic to get screen sizes, with or without statusbar size, etc.\n   * @default 1.0\n   */\n  windowWidth?: number;\n\n  /**\n   * Required if you want to use autoMode. Screen height for coordinate scaling.\n   * You must handle your own logic to get screen sizes, with or without statusbar size, etc.\n   * @default 1.0\n   */\n  windowHeight?: number;\n}\n\n/**\n * Static image face detection options\n */\nexport interface StaticImageOptions extends FaceDetectionOptions {\n  /**\n   * Image source for static face detection.\n   * Can be a require() result (number), a URI string, or an object with uri.\n   */\n  image: number | string | { uri: string };\n}\n\n// ============================================================================\n// Face Detection Results\n// ============================================================================\n\n/**\n * 2D point coordinates\n */\nexport interface Point {\n  x: number;\n  y: number;\n}\n\n/**\n * Bounding rectangle\n */\nexport interface Bounds {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * Facial landmarks detected by ML Kit\n */\nexport interface FaceLandmarks {\n  leftEye?: Point;\n  rightEye?: Point;\n  leftEar?: Point;\n  rightEar?: Point;\n  leftCheek?: Point;\n  rightCheek?: Point;\n  noseBase?: Point;\n  leftMouth?: Point;\n  rightMouth?: Point;\n  bottomMouth?: Point;\n}\n\n/**\n * Face contour types\n */\nexport type ContourType =\n  | 'face'\n  | 'leftEyebrowTop'\n  | 'leftEyebrowBottom'\n  | 'rightEyebrowTop'\n  | 'rightEyebrowBottom'\n  | 'leftEye'\n  | 'rightEye'\n  | 'upperLipTop'\n  | 'upperLipBottom'\n  | 'lowerLipTop'\n  | 'lowerLipBottom'\n  | 'noseBridge'\n  | 'noseBottom'\n  | 'leftCheek'\n  | 'rightCheek';\n\n/**\n * Facial contours detected by ML Kit\n */\nexport interface FaceContours {\n  [key: string]: Point[];\n}\n\n/**\n * Detected face data\n */\nexport interface Face {\n  /**\n   * Bounding box of the detected face\n   */\n  bounds: Bounds;\n\n  /**\n   * Roll angle of the face (rotation around front-to-back axis)\n   */\n  rollAngle?: number;\n\n  /**\n   * Pitch angle of the face (rotation around left-to-right axis)\n   */\n  pitchAngle?: number;\n\n  /**\n   * Yaw angle of the face (rotation around top-to-bottom axis)\n   */\n  yawAngle?: number;\n\n  /**\n   * Facial landmarks (when landmarkMode is 'all')\n   */\n  landmarks?: FaceLandmarks;\n\n  /**\n   * Facial contours (when contourMode is 'all')\n   */\n  contours?: FaceContours;\n\n  /**\n   * Probability that the face is smiling (0.0 - 1.0)\n   * Only available when classificationMode is 'all'\n   */\n  smilingProbability?: number;\n\n  /**\n   * Probability that the left eye is open (0.0 - 1.0)\n   * Only available when classificationMode is 'all'\n   */\n  leftEyeOpenProbability?: number;\n\n  /**\n   * Probability that the right eye is open (0.0 - 1.0)\n   * Only available when classificationMode is 'all'\n   */\n  rightEyeOpenProbability?: number;\n\n  /**\n   * Tracking ID for this face (when trackingEnabled is true)\n   */\n  trackingId?: number;\n}\n\n// ============================================================================\n// Blink Detection\n// ============================================================================\n\n/**\n * Blink detection event\n */\nexport interface BlinkEvent {\n  /**\n   * Timestamp when the blink was detected\n   */\n  timestamp: number;\n\n  /**\n   * Left eye open probability (0.0 - 1.0)\n   */\n  leftEyeOpen: number;\n\n  /**\n   * Right eye open probability (0.0 - 1.0)\n   */\n  rightEyeOpen: number;\n\n  /**\n   * Whether a blink was detected\n   */\n  isBlink: boolean;\n\n  /**\n   * Face tracking ID (when trackingEnabled is true)\n   */\n  faceId?: number;\n}\n\n// ============================================================================\n// WebRTC Configuration\n// ============================================================================\n\n/**\n * WebRTC mode\n * - 'call': Video calling (1:1 or group)\n * - 'stream': Live streaming to a server\n */\nexport type WebRTCMode = 'call' | 'stream';\n\n/**\n * WebRTC video constraints\n */\nexport interface VideoConstraints {\n  width?: number;\n  height?: number;\n  frameRate?: number;\n}\n\n/**\n * WebRTC configuration\n */\nexport interface WebRTCConfig {\n  /**\n   * Whether WebRTC is enabled\n   */\n  enabled: boolean;\n\n  /**\n   * RTCPeerConnection instance\n   */\n  peerConnection?: RTCPeerConnection;\n\n  /**\n   * WebRTC mode (call or stream)\n   * @default 'call'\n   */\n  mode?: WebRTCMode;\n\n  /**\n   * Video constraints for the stream\n   */\n  videoConstraints?: VideoConstraints;\n}\n\n// ============================================================================\n// Face Detection Configuration (for SmartCamera component)\n// ============================================================================\n\n/**\n * Face detection configuration for SmartCamera component\n */\nexport interface FaceDetectionConfig extends FaceDetectionOptions {\n  /**\n   * Whether face detection is enabled\n   * @default false\n   */\n  enabled?: boolean;\n\n  /**\n   * Handle auto scale on native side\n   * @default false\n   */\n  autoMode?: boolean;\n\n  /**\n   * Screen width for coordinate scaling (required when autoMode is true)\n   * @default 1.0\n   */\n  windowWidth?: number;\n\n  /**\n   * Screen height for coordinate scaling (required when autoMode is true)\n   * @default 1.0\n   */\n  windowHeight?: number;\n}\n\n// ============================================================================\n// SmartCamera Component Props\n// ============================================================================\n\n/**\n * SmartCamera component props\n */\nexport interface SmartCameraProps {\n  /**\n   * Camera facing direction\n   * @default 'front'\n   */\n  camera?: CameraFacing;\n\n  /**\n   * Target frame rate for the camera\n   * @default 30\n   */\n  fps?: number;\n\n  /**\n   * Style for the camera view\n   */\n  style?: ViewStyle;\n\n  /**\n   * Face detection configuration\n   */\n  faceDetection?: FaceDetectionConfig;\n\n  /**\n   * Whether blink detection is enabled\n   * @default false\n   */\n  blinkDetection?: boolean;\n\n  /**\n   * Callback when a blink is detected\n   */\n  onBlinkDetected?: (event: BlinkEvent) => void;\n\n  /**\n   * Callback when faces are detected\n   */\n  onFaceDetected?: (faces: Face[]) => void;\n\n  /**\n   * WebRTC configuration for streaming\n   */\n  webrtc?: WebRTCConfig;\n\n  /**\n   * Whether the camera is active\n   * @default true\n   */\n  isActive?: boolean;\n\n  /**\n   * Callback when camera is ready\n   */\n  onReady?: () => void;\n\n  /**\n   * Callback when an error occurs\n   */\n  onError?: (error: SmartCameraError) => void;\n}\n\n// ============================================================================\n// Error Handling\n// ============================================================================\n\n/**\n * Error codes for SmartCamera\n */\nexport type SmartCameraErrorCode =\n  | 'CAMERA_UNAVAILABLE'\n  | 'PERMISSION_DENIED'\n  | 'WEBRTC_ERROR'\n  | 'ML_KIT_ERROR'\n  | 'FRAME_PROCESSOR_ERROR'\n  | 'UNKNOWN_ERROR';\n\n/**\n * SmartCamera error\n */\nexport interface SmartCameraError {\n  /**\n   * Error code\n   */\n  code: SmartCameraErrorCode;\n\n  /**\n   * Human-readable error message\n   */\n  message: string;\n\n  /**\n   * Original native error (if available)\n   */\n  nativeError?: Error;\n}\n\n// ============================================================================\n// Hook Return Types\n// ============================================================================\n\n/**\n * Return type for useSmartCameraWebRTC hook\n */\nexport interface UseSmartCameraWebRTCResult {\n  /**\n   * The video track for WebRTC\n   */\n  videoTrack: MediaStreamTrack | null;\n\n  /**\n   * Start streaming to the peer connection\n   */\n  startStreaming: () => void;\n\n  /**\n   * Stop streaming\n   */\n  stopStreaming: () => void;\n\n  /**\n   * Switch between front and back camera\n   */\n  switchCamera: () => void;\n\n  /**\n   * Whether streaming is active\n   */\n  isStreaming: boolean;\n}\n\n/**\n * Return type for useFaceDetection hook\n */\nexport interface UseFaceDetectionResult {\n  /**\n   * Currently detected faces\n   */\n  faces: Face[];\n\n  /**\n   * Whether face detection is active/detecting\n   */\n  isDetecting: boolean;\n}\n\n/**\n * Return type for useBlinkDetection hook\n */\nexport interface UseBlinkDetectionResult {\n  /**\n   * Last blink event\n   */\n  lastBlink: BlinkEvent | null;\n\n  /**\n   * Total blink count\n   */\n  blinkCount: number;\n\n  /**\n   * Reset blink count\n   */\n  resetCount: () => void;\n}\n\n// ============================================================================\n// Camera Device Types\n// ============================================================================\n\n/**\n * Camera device information\n */\nexport interface CameraDevice {\n  /**\n   * Unique identifier for the camera device\n   */\n  id: string;\n\n  /**\n   * Human-readable name of the camera\n   */\n  name: string;\n\n  /**\n   * Camera position (front or back)\n   */\n  position: CameraFacing;\n\n  /**\n   * Whether the camera has a flash\n   */\n  hasFlash: boolean;\n\n  /**\n   * Whether the camera has a torch (flashlight)\n   */\n  hasTorch: boolean;\n\n  /**\n   * Whether the camera supports low-light boost\n   */\n  supportsLowLightBoost: boolean;\n}\n\n/**\n * Return type for useSmartCamera hook\n */\nexport interface UseSmartCameraResult {\n  /**\n   * Whether camera permission has been granted\n   */\n  hasPermission: boolean;\n\n  /**\n   * Request camera permission\n   */\n  requestPermission: () => Promise<boolean>;\n\n  /**\n   * Current camera device\n   */\n  device: CameraDevice | undefined;\n\n  /**\n   * Switch between front and back camera\n   */\n  switchCamera: () => void;\n\n  /**\n   * Current camera facing direction\n   */\n  currentCamera: CameraFacing;\n}\n\n// ============================================================================\n// Orientation Types\n// ============================================================================\n\n/**\n * Device orientation\n */\nexport type Orientation = 'portrait' | 'portrait-upside-down' | 'landscape-left' | 'landscape-right';\n\n/**\n * Camera output orientation\n */\nexport type OutputOrientation = Orientation | 'device';\n"]}

package/build/utils/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * SmartCamera utility functions
+ */
+/**
+ * Creates an FPS limiter for frame processing
+ *
+ * @param targetFps - Target frames per second
+ * @returns Object with shouldProcess function
+ *
+ * @example
+ * ```ts
+ * const limiter = createFpsLimiter(15);
+ *
+ * const frameProcessor = useFrameProcessor((frame) => {
+ *   if (!limiter.shouldProcess()) return;
+ *   // Process frame...
+ * }, []);
+ * ```
+ */
+export declare function createFpsLimiter(targetFps: number): {
+    shouldProcess: () => boolean;
+    reset: () => void;
+    setTargetFps: (fps: number) => void;
+};
+/**
+ * Creates a debounced function
+ *
+ * @param fn - Function to debounce
+ * @param delay - Delay in milliseconds
+ * @returns Debounced function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Creates a throttled function
+ *
+ * @param fn - Function to throttle
+ * @param limit - Minimum time between calls in milliseconds
+ * @returns Throttled function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Creates an object pool for reducing garbage collection
+ *
+ * @param factory - Factory function to create new objects
+ * @param initialSize - Initial pool size
+ * @param maxSize - Maximum pool size
+ */
+export declare function createObjectPool<T>(factory: () => T, initialSize?: number, maxSize?: number): {
+    acquire: () => T;
+    release: (obj: T) => void;
+    clear: () => void;
+    getStats: () => {
+        size: number;
+        inUse: number;
+        available: number;
+    };
+};
+import type { SmartCameraError, SmartCameraErrorCode } from '../types';
+/**
+ * Creates a SmartCameraError from an unknown error
+ *
+ * @param error - The original error
+ * @param defaultCode - Default error code if not determinable
+ * @returns SmartCameraError
+ */
+export declare function createSmartCameraError(error: unknown, defaultCode?: SmartCameraErrorCode): SmartCameraError;
+/**
+ * Safely execute a function and return a SmartCameraError on failure
+ */
+export declare function safeExecute<T>(fn: () => Promise<T>, errorCode?: SmartCameraErrorCode): Promise<{
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: SmartCameraError;
+}>;
+/**
+ * Validates face detection options
+ */
+export declare function validateFaceDetectionOptions(options: Record<string, unknown>): string[];
+interface PerformanceMetrics {
+    frameCount: number;
+    averageProcessingTime: number;
+    minProcessingTime: number;
+    maxProcessingTime: number;
+    droppedFrames: number;
+}
+/**
+ * Creates a performance monitor for frame processing
+ */
+export declare function createPerformanceMonitor(windowSize?: number): {
+    startFrame: () => number;
+    endFrame: (startTime: number) => void;
+    getMetrics: () => PerformanceMetrics;
+    reset: () => void;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM;yBAK3B,OAAO;;wBAWN,MAAM;EAK7B;AAMD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC;AAMD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,EAChB,WAAW,GAAE,MAAW,EACxB,OAAO,GAAE,MAAY;mBAUN,CAAC;mBAmBC,CAAC,KAAG,IAAI;iBAOZ,IAAI;;;;;;EAUlB;AAMD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,oBAAsC,GAClD,gBAAgB,CA6BlB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,oBAAsC,GAChD,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAO7E;AAMD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CA+CvF;AAMD,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,GAAE,MAAW;sBAQ5C,MAAM;0BAIA,MAAM,KAAG,IAAI;sBAsBnB,kBAAkB;iBAWvB,IAAI;EAOlB"}