@gmessier/nitro-speech 0.0.7 → 0.1.1

package/README.md

@@ -4,8 +4,6 @@
 [![license](https://img.shields.io/npm/l/@gmessier/nitro-speech.svg)](https://github.com/NotGeorgeMessier/nitro-speech/blob/main/LICENSE)
 [![npm downloads](https://img.shields.io/npm/dm/@gmessier/nitro-speech.svg)](https://www.npmjs.com/package/@gmessier/nitro-speech)
 
-> 🐛 [Report Bug](https://github.com/NotGeorgeMessier/nitro-speech/issues) | 💡 [Request Feature](https://github.com/NotGeorgeMessier/nitro-speech/issues)
-
 > **⚠️ Work in Progress**
 > 
 > This library is under active development. (Last version is stable)
@@ -19,12 +17,11 @@ Speech recognition for React Native, powered by [Nitro Modules](https://github.c
 - [Features](#features)
 - [Usage](#usage)
   - [Recommended: useRecognizer Hook](#recommended-userecognizer-hook)
+  - [With React Navigation (important)](#with-react-navigation-important)
   - [Alternative: Static Recognizer](#alternative-static-recognizer-not-safe)
 - [API Reference](#api-reference)
 - [Requirements](#requirements)
 - [Troubleshooting](#troubleshooting)
-- [License](#license)
-- [TODO](#todo)
 
 ## Installation
 
@@ -64,6 +61,7 @@ The library declares the required permission in its `AndroidManifest.xml` (merge
 
 ```xml
 <uses-permission android:name="android.permission.RECORD_AUDIO" />
+<uses-permission android:name="android.permission.VIBRATE" />
 ```
 
 ### iOS
@@ -91,6 +89,7 @@ Both permissions are required for speech recognition to work on iOS.
 | **Contextual strings** | Domain-specific vocabulary for improved accuracy | ✅ | ✅ |
 | **Repeating word filter** | Removes consecutive duplicate words from artifacts | ✅ | ✅ |
 | **Permission handling** | Dedicated `onPermissionDenied` callback | ✅ | ✅ |
+| **Haptic feedback** | Optional haptics on recording start/stop | ✅ | ✅ |
 | **Automatic punctuation** | Adds punctuation to transcription (iOS 16+) | ✅ | Auto |
 | **Language model selection** | Choose between web search vs free-form models | Auto | ✅ |
 | **Offensive word masking** | Control whether offensive words are masked | Auto | ✅ |
@@ -136,6 +135,9 @@ function MyComponent() {
         locale: 'en-US',
         autoFinishRecognitionMs: 8000,
         contextualStrings: ['custom', 'words'],
+        // Haptics (both platforms)
+        startHapticFeedbackStyle: 'medium',
+        stopHapticFeedbackStyle: 'light',
         // iOS specific
         iosAddPunctuation: true,
         // Android specific
@@ -159,6 +161,24 @@ function MyComponent() {
 }
 ```
 
+### With React Navigation (important)
+
+React Navigation **doesn’t unmount screens** when you navigate — the screen can stay mounted in the background and come back without remounting. See: [Navigation lifecycle (React Navigation)](https://reactnavigation.org/docs/8.x/navigation-lifecycle/#summary).
+
+Because of that, prefer tying recognition cleanup to **focus state**, not just component unmount. A simple approach is `useIsFocused()` and passing it into `useRecognizer`’s `destroyDeps` so recognition stops when the screen blurs. See: [`useIsFocused` (React Navigation)](https://reactnavigation.org/docs/8.x/use-is-focused).
+
+```typescript
+const isFocused = useIsFocused();
+const { 
+  // ...
+} = useRecognizer(
+  {
+    // ...
+  },
+  [isFocused]
+);
+```
+
 ### Alternative: Static Recognizer (Not Safe)
 
 ```typescript
@@ -214,7 +234,7 @@ The `Recognizer.dispose()` method is **NOT SAFE** and should rarely be used. Hyb
 
 ## API Reference
 
-### `useRecognizer(callbacks)`
+### `useRecognizer(callbacks, destroyDeps?)`
 
 A React hook that provides lifecycle-aware access to the speech recognizer.
 
@@ -222,11 +242,12 @@ A React hook that provides lifecycle-aware access to the speech recognizer.
 
 - `callbacks` (object):
   - `onReadyForSpeech?: () => void` - Called when speech recognition starts
-  - `onResult?: (textBatches: string[]) => void` - Called with transcription results (array of text batches)
+  - `onResult?: (textBatches: string[]) => void` - Called every time when partial result is ready (array of text batches)
   - `onRecordingStopped?: () => void` - Called when recording stops
   - `onAutoFinishProgress?: (timeLeftMs: number) => void` - Called each second during auto-finish countdown
   - `onError?: (message: string) => void` - Called when an error occurs
   - `onPermissionDenied?: () => void` - Called if microphone permission is denied
+- `destroyDeps` (array, optional) - Additional dependencies for the cleanup effect. When any of these change (or the component unmounts), recognition is stopped.
 
 #### Returns
 
@@ -245,6 +266,8 @@ Configuration object for speech recognition.
 - `autoFinishRecognitionMs?: number` - Auto-stop timeout in milliseconds (default: `8000`)
 - `contextualStrings?: string[]` - Array of domain-specific words for better recognition
 - `disableRepeatingFilter?: boolean` - Disable filter that removes consecutive duplicate words (default: `false`)
+- `startHapticFeedbackStyle?: 'light' | 'medium' | 'heavy'` - Haptic feedback style when microphone starts recording (default: `null` / disabled)
+- `stopHapticFeedbackStyle?: 'light' | 'medium' | 'heavy'` - Haptic feedback style when microphone stops recording (default: `null` / disabled)
 
 #### iOS-Specific Parameters
 

package/android/src/main/AndroidManifest.xml

@@ -1,3 +1,4 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
   <uses-permission android:name="android.permission.RECORD_AUDIO" />
+  <uses-permission android:name="android.permission.VIBRATE" />
 </manifest>

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/HapticImpact.kt

@@ -0,0 +1,66 @@
+package com.margelo.nitro.nitrospeech.recognizer
+
+import android.content.Context
+import android.os.Build
+import android.os.VibrationEffect
+import android.os.Vibrator
+import android.os.VibratorManager
+import com.margelo.nitro.nitrospeech.HapticFeedbackStyle
+
+class HapticImpact(
+  private val style: HapticFeedbackStyle = HapticFeedbackStyle.MEDIUM,
+) {
+  private data class LegacyOneShot(
+    val durationMs: Long,
+    val amplitude: Int,
+  )
+
+  fun trigger(context: Context) {
+    val vibrator = getVibrator(context) ?: return
+    if (!vibrator.hasVibrator()) return
+
+    try {
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+        val effect = when (style) {
+          HapticFeedbackStyle.LIGHT -> VibrationEffect.EFFECT_TICK
+          HapticFeedbackStyle.MEDIUM -> VibrationEffect.EFFECT_CLICK
+          HapticFeedbackStyle.HEAVY -> VibrationEffect.EFFECT_HEAVY_CLICK
+        }
+        vibrator.vibrate(VibrationEffect.createPredefined(effect))
+        return
+      }
+
+      val legacyOneShot = when (style) {
+        HapticFeedbackStyle.LIGHT -> LegacyOneShot(durationMs = 12L, amplitude = 50)
+        HapticFeedbackStyle.MEDIUM -> LegacyOneShot(durationMs = 18L, amplitude = 100)
+        HapticFeedbackStyle.HEAVY -> LegacyOneShot(durationMs = 28L, amplitude = 180)
+      }
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+        vibrator.vibrate(
+          VibrationEffect.createOneShot(
+            legacyOneShot.durationMs,
+            legacyOneShot.amplitude
+          )
+        )
+      } else {
+        @Suppress("DEPRECATION")
+        vibrator.vibrate(legacyOneShot.durationMs)
+      }
+    } catch (_: SecurityException) {
+      // Missing android.permission.VIBRATE or disallowed by device policy.
+    } catch (_: Throwable) {
+      // Never crash the recognition flow because of haptics.
+    }
+  }
+
+  private fun getVibrator(context: Context): Vibrator? {
+    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+      val manager =
+        context.getSystemService(Context.VIBRATOR_MANAGER_SERVICE) as? VibratorManager
+      manager?.defaultVibrator
+    } else {
+      @Suppress("DEPRECATION")
+      context.getSystemService(Context.VIBRATOR_SERVICE) as? Vibrator
+    }
+  }
+}

package/android/src/main/java/com/margelo/nitro/nitrospeech/recognizer/HybridRecognizer.kt

@@ -84,6 +84,11 @@ class HybridRecognizer: HybridRecognizerSpec() {
     if (!isActive) return
     onFinishRecognition(null, null, true)
     mainHandler.postDelayed({
+      val context = NitroModules.applicationContext
+      val hapticImpact = config?.stopHapticFeedbackStyle
+      if (hapticImpact != null && context != null) {
+        HapticImpact(hapticImpact).trigger(context)
+      }
       cleanup()
     }, POST_RECOGNITION_DELAY)
   }
@@ -156,6 +161,12 @@ class HybridRecognizer: HybridRecognizerSpec() {
 
         speechRecognizer?.startListening(intent)
         isActive = true
+        
+        val hapticImpact = config?.startHapticFeedbackStyle
+        if (hapticImpact != null) {
+          HapticImpact(hapticImpact).trigger(context)
+        }
+
         mainHandler.postDelayed({
           if (isActive) {
             onReadyForSpeech?.invoke()

package/ios/HapticImpact.swift

@@ -0,0 +1,23 @@
+import Foundation
+import UIKit
+
+class HapticImpact {
+    private let impactGenerator: UIImpactFeedbackGenerator
+
+    init(style: HapticFeedbackStyle) {
+        let hapticStyle = switch style {
+            case .light:
+                UIImpactFeedbackGenerator.FeedbackStyle.light
+            case .medium:
+                UIImpactFeedbackGenerator.FeedbackStyle.medium
+            case .heavy:
+                UIImpactFeedbackGenerator.FeedbackStyle.heavy
+        }
+        self.impactGenerator = UIImpactFeedbackGenerator(style: hapticStyle)
+    }
+
+    func trigger() {
+        impactGenerator.prepare()
+        impactGenerator.impactOccurred()
+    }
+}

package/ios/HybridRecognizer.swift

@@ -1,8 +1,10 @@
 import Foundation
 import Speech
 import NitroModules
+import os.log
 
 class HybridRecognizer: HybridRecognizerSpec {
+    private let logger = Logger(subsystem: "com.margelo.nitro.nitrospeech", category: "AutoStopper")
     private static let defaultAutoFinishRecognitionMs = 8000.0
     
     var onReadyForSpeech: (() -> Void)?
@@ -19,10 +21,11 @@ class HybridRecognizer: HybridRecognizerSpec {
     private var appStateObserver: AppStateObserver?
     private var isActive: Bool = false
     private var isStopping: Bool = false
+    private var config: SpeechToTextParams?
     
     func startListening(params: SpeechToTextParams) {
         if isActive {
-            onError?("Previous recognition session is still active")
+//          Previous recognition session is still active
             return
         }
         
@@ -30,9 +33,11 @@ class HybridRecognizer: HybridRecognizerSpec {
             DispatchQueue.main.async {
                 guard let self = self else { return }
                 
+                self.config = params
+                
                 switch authStatus {
                 case .authorized:
-                    self.requestMicrophonePermission(params: params)
+                    self.requestMicrophonePermission()
                 case .denied, .restricted:
                     self.onPermissionDenied?()
                 case .notDetermined:
@@ -48,6 +53,10 @@ class HybridRecognizer: HybridRecognizerSpec {
         guard isActive, !isStopping else { return }
         isStopping = true
         
+        if let hapticStyle = config?.stopHapticFeedbackStyle {
+            HapticImpact(style: hapticStyle).trigger()
+        }
+        
         // Signal end of audio and request graceful finish
         recognitionRequest?.endAudio()
         recognitionTask?.finish()
@@ -79,13 +88,13 @@ class HybridRecognizer: HybridRecognizerSpec {
         stopListening()
     }
 
-    private func requestMicrophonePermission(params: SpeechToTextParams) {
+    private func requestMicrophonePermission() {
         AVAudioSession.sharedInstance().requestRecordPermission { [weak self] granted in
             DispatchQueue.main.async {
                 guard let self = self else { return }
                 
                 if granted {
-                    self.startRecognition(params: params)
+                    self.startRecognition()
                 } else {
                     self.onPermissionDenied?()
                 }
@@ -93,17 +102,17 @@ class HybridRecognizer: HybridRecognizerSpec {
         }
     }
     
-    private func startRecognition(params: SpeechToTextParams) {
+    private func startRecognition() {
         isStopping = false
         
-        let locale = Locale(identifier: params.locale ?? "en-US")
+        let locale = Locale(identifier: config?.locale ?? "en-US")
         guard let speechRecognizer = SFSpeechRecognizer(locale: locale), speechRecognizer.isAvailable else {
             onError?("Speech recognizer not available")
             return
         }
         
         autoStopper = AutoStopper(
-            silenceThresholdMs: params.autoFinishRecognitionMs ?? Self.defaultAutoFinishRecognitionMs,
+            silenceThresholdMs: config?.autoFinishRecognitionMs ?? Self.defaultAutoFinishRecognitionMs,
             onProgress: { [weak self] timeLeftMs in
                 self?.onAutoFinishProgress?(timeLeftMs)
             },
@@ -115,6 +124,10 @@ class HybridRecognizer: HybridRecognizerSpec {
         do {
             let audioSession = AVAudioSession.sharedInstance()
             try audioSession.setCategory(.record, mode: .measurement, options: .duckOthers)
+            if #available(iOS 13.0, *) {
+                // Without this, iOS may suppress haptics while recording.
+                try audioSession.setAllowHapticsAndSystemSoundsDuringRecording(true)
+            }
             try audioSession.setActive(true, options: .notifyOthersOnDeactivation)
         } catch {
             onError?("Failed to set up audio session: \(error.localizedDescription)")
@@ -131,19 +144,19 @@ class HybridRecognizer: HybridRecognizerSpec {
         
         recognitionRequest.shouldReportPartialResults = true
         
-        if let contextualStrings = params.contextualStrings, !contextualStrings.isEmpty {
+        if let contextualStrings = config?.contextualStrings, !contextualStrings.isEmpty {
             recognitionRequest.contextualStrings = contextualStrings
         }
         
         if #available(iOS 16, *) {
-            if let addPunctiation = params.iosAddPunctuation, addPunctiation == false {
+            if let addPunctiation = config?.iosAddPunctuation, addPunctiation == false {
                 recognitionRequest.addsPunctuation = false
             } else {
                 recognitionRequest.addsPunctuation = true
             }
         }
         
-        let disableRepeatingFilter = params.disableRepeatingFilter ?? false
+        let disableRepeatingFilter = config?.disableRepeatingFilter ?? false
         
         recognitionTask = speechRecognizer.recognitionTask(with: recognitionRequest) { [weak self] result, error in
             guard let self = self else { return }
@@ -197,6 +210,11 @@ class HybridRecognizer: HybridRecognizerSpec {
             audioEngine.prepare()
             try audioEngine.start()
             isActive = true
+
+            if let hapticStyle = config?.startHapticFeedbackStyle {
+                HapticImpact(style: hapticStyle).trigger()
+            }
+            
             autoStopper?.indicateRecordingActivity(
                 from: "startListening",
                 addMsToThreshold: nil

package/lib/commonjs/index.js

@@ -7,6 +7,8 @@ exports.useRecognizer = exports.Recognizer = void 0;
 var _react = _interopRequireDefault(require("react"));
 var _reactNativeNitroModules = require("react-native-nitro-modules");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* eslint-disable react-hooks/exhaustive-deps */
+
 const NitroSpeech = _reactNativeNitroModules.NitroModules.createHybridObject('NitroSpeech');
 
 /**
@@ -28,8 +30,18 @@ const recognizerUpdateAutoFinishTime = (newTimeMs, withRefresh) => {
 
 /**
  * Safe, lifecycle-aware hook to use the recognizer.
+ *
+ * @param callbacks - The callbacks to use for the recognizer.
+ * @param destroyDeps - The additional dependencies to use for the cleanup effect.
+ *
+ * Example: To cleanup when the screen is unfocused.
+ *
+ * ```typescript
+ * const isFocused = useIsFocused()
+ * useRecognizer({ ... }, [isFocused])
+ * ```
  */
-const useRecognizer = callbacks => {
+const useRecognizer = (callbacks, destroyDeps = []) => {
   _react.default.useEffect(() => {
     Recognizer.onReadyForSpeech = () => {
       callbacks.onReadyForSpeech?.();
@@ -62,7 +74,7 @@ const useRecognizer = callbacks => {
     return () => {
       Recognizer.stopListening();
     };
-  }, []);
+  }, [...destroyDeps]);
   return {
     startListening: recognizerStartListening,
     stopListening: recognizerStopListening,

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireDefault","require","_reactNativeNitroModules","e","__esModule","default","NitroSpeech","NitroModules","createHybridObject","Recognizer","exports","recognizer","recognizerStartListening","params","startListening","recognizerStopListening","stopListening","recognizerAddAutoFinishTime","additionalTimeMs","addAutoFinishTime","recognizerUpdateAutoFinishTime","newTimeMs","withRefresh","updateAutoFinishTime","useRecognizer","callbacks","React","useEffect","onReadyForSpeech","onRecordingStopped","onResult","resultBatches","onAutoFinishProgress","timeLeftMs","onError","message","onPermissionDenied","undefined"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,wBAAA,GAAAD,OAAA;AAAyD,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAOzD,MAAMG,WAAW,GACfC,qCAAY,CAACC,kBAAkB,CAAkB,aAAa,CAAC;;AAEjE;AACA;AACA;AACO,MAAMC,UAAU,GAAAC,OAAA,CAAAD,UAAA,GAAGH,WAAW,CAACK,UAAU;AAoBhD,MAAMC,wBAAwB,GAAIC,MAA0B,IAAK;EAC/DJ,UAAU,CAACK,cAAc,CAACD,MAAM,CAAC;AACnC,CAAC;AAED,MAAME,uBAAuB,GAAGA,CAAA,KAAM;EACpCN,UAAU,CAACO,aAAa,CAAC,CAAC;AAC5B,CAAC;AAED,MAAMC,2BAA2B,GAAIC,gBAAyB,IAAK;EACjET,UAAU,CAACU,iBAAiB,CAACD,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAME,8BAA8B,GAAGA,CACrCC,SAAiB,EACjBC,WAAqB,KAClB;EACHb,UAAU,CAACc,oBAAoB,CAACF,SAAS,EAAEC,WAAW,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACO,MAAME,aAAa,GACxBC,SAA8B,IACP;EACvBC,cAAK,CAACC,SAAS,CAAC,MAAM;IACpBlB,UAAU,CAACmB,gBAAgB,GAAG,MAAM;MAClCH,SAAS,CAACG,gBAAgB,GAAG,CAAC;IAChC,CAAC;IACDnB,UAAU,CAACoB,kBAAkB,GAAG,MAAM;MACpCJ,SAAS,CAACI,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACDpB,UAAU,CAACqB,QAAQ,GAAIC,aAAuB,IAAK;MACjDN,SAAS,CAACK,QAAQ,GAAGC,aAAa,CAAC;IACrC,CAAC;IACDtB,UAAU,CAACuB,oBAAoB,GAAIC,UAAkB,IAAK;MACxDR,SAAS,CAACO,oBAAoB,GAAGC,UAAU,CAAC;IAC9C,CAAC;IACDxB,UAAU,CAACyB,OAAO,GAAIC,OAAe,IAAK;MACxCV,SAAS,CAACS,OAAO,GAAGC,OAAO,CAAC;IAC9B,CAAC;IACD1B,UAAU,CAAC2B,kBAAkB,GAAG,MAAM;MACpCX,SAAS,CAACW,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,MAAM;MACX3B,UAAU,CAACmB,gBAAgB,GAAGS,SAAS;MACvC5B,UAAU,CAACoB,kBAAkB,GAAGQ,SAAS;MACzC5B,UAAU,CAACqB,QAAQ,GAAGO,SAAS;MAC/B5B,UAAU,CAACuB,oBAAoB,GAAGK,SAAS;MAC3C5B,UAAU,CAACyB,OAAO,GAAGG,SAAS;MAC9B5B,UAAU,CAAC2B,kBAAkB,GAAGC,SAAS;IAC3C,CAAC;EACH,CAAC,EAAE,CAACZ,SAAS,CAAC,CAAC;EAEfC,cAAK,CAACC,SAAS,CAAC,MAAM;IACpB,OAAO,MAAM;MACXlB,UAAU,CAACO,aAAa,CAAC,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLF,cAAc,EAAEF,wBAAwB;IACxCI,aAAa,EAAED,uBAAuB;IACtCI,iBAAiB,EAAEF,2BAA2B;IAC9CM,oBAAoB,EAAEH;EACxB,CAAC;AACH,CAAC;AAAAV,OAAA,CAAAc,aAAA,GAAAA,aAAA","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireDefault","require","_reactNativeNitroModules","e","__esModule","default","NitroSpeech","NitroModules","createHybridObject","Recognizer","exports","recognizer","recognizerStartListening","params","startListening","recognizerStopListening","stopListening","recognizerAddAutoFinishTime","additionalTimeMs","addAutoFinishTime","recognizerUpdateAutoFinishTime","newTimeMs","withRefresh","updateAutoFinishTime","useRecognizer","callbacks","destroyDeps","React","useEffect","onReadyForSpeech","onRecordingStopped","onResult","resultBatches","onAutoFinishProgress","timeLeftMs","onError","message","onPermissionDenied","undefined"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AACA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,wBAAA,GAAAD,OAAA;AAAyD,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAFzD;;AASA,MAAMG,WAAW,GACfC,qCAAY,CAACC,kBAAkB,CAAkB,aAAa,CAAC;;AAEjE;AACA;AACA;AACO,MAAMC,UAAU,GAAAC,OAAA,CAAAD,UAAA,GAAGH,WAAW,CAACK,UAAU;AAoBhD,MAAMC,wBAAwB,GAAIC,MAA0B,IAAK;EAC/DJ,UAAU,CAACK,cAAc,CAACD,MAAM,CAAC;AACnC,CAAC;AAED,MAAME,uBAAuB,GAAGA,CAAA,KAAM;EACpCN,UAAU,CAACO,aAAa,CAAC,CAAC;AAC5B,CAAC;AAED,MAAMC,2BAA2B,GAAIC,gBAAyB,IAAK;EACjET,UAAU,CAACU,iBAAiB,CAACD,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAME,8BAA8B,GAAGA,CACrCC,SAAiB,EACjBC,WAAqB,KAClB;EACHb,UAAU,CAACc,oBAAoB,CAACF,SAAS,EAAEC,WAAW,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAME,aAAa,GAAGA,CAC3BC,SAA8B,EAC9BC,WAAiC,GAAG,EAAE,KACf;EACvBC,cAAK,CAACC,SAAS,CAAC,MAAM;IACpBnB,UAAU,CAACoB,gBAAgB,GAAG,MAAM;MAClCJ,SAAS,CAACI,gBAAgB,GAAG,CAAC;IAChC,CAAC;IACDpB,UAAU,CAACqB,kBAAkB,GAAG,MAAM;MACpCL,SAAS,CAACK,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACDrB,UAAU,CAACsB,QAAQ,GAAIC,aAAuB,IAAK;MACjDP,SAAS,CAACM,QAAQ,GAAGC,aAAa,CAAC;IACrC,CAAC;IACDvB,UAAU,CAACwB,oBAAoB,GAAIC,UAAkB,IAAK;MACxDT,SAAS,CAACQ,oBAAoB,GAAGC,UAAU,CAAC;IAC9C,CAAC;IACDzB,UAAU,CAAC0B,OAAO,GAAIC,OAAe,IAAK;MACxCX,SAAS,CAACU,OAAO,GAAGC,OAAO,CAAC;IAC9B,CAAC;IACD3B,UAAU,CAAC4B,kBAAkB,GAAG,MAAM;MACpCZ,SAAS,CAACY,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,MAAM;MACX5B,UAAU,CAACoB,gBAAgB,GAAGS,SAAS;MACvC7B,UAAU,CAACqB,kBAAkB,GAAGQ,SAAS;MACzC7B,UAAU,CAACsB,QAAQ,GAAGO,SAAS;MAC/B7B,UAAU,CAACwB,oBAAoB,GAAGK,SAAS;MAC3C7B,UAAU,CAAC0B,OAAO,GAAGG,SAAS;MAC9B7B,UAAU,CAAC4B,kBAAkB,GAAGC,SAAS;IAC3C,CAAC;EACH,CAAC,EAAE,CAACb,SAAS,CAAC,CAAC;EAEfE,cAAK,CAACC,SAAS,CAAC,MAAM;IACpB,OAAO,MAAM;MACXnB,UAAU,CAACO,aAAa,CAAC,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,CAAC,GAAGU,WAAW,CAAC,CAAC;EAEpB,OAAO;IACLZ,cAAc,EAAEF,wBAAwB;IACxCI,aAAa,EAAED,uBAAuB;IACtCI,iBAAiB,EAAEF,2BAA2B;IAC9CM,oBAAoB,EAAEH;EACxB,CAAC;AACH,CAAC;AAAAV,OAAA,CAAAc,aAAA,GAAAA,aAAA","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,6 @@
 "use strict";
 
+/* eslint-disable react-hooks/exhaustive-deps */
 import React from 'react';
 import { NitroModules } from 'react-native-nitro-modules';
 const NitroSpeech = NitroModules.createHybridObject('NitroSpeech');
@@ -23,8 +24,18 @@ const recognizerUpdateAutoFinishTime = (newTimeMs, withRefresh) => {
 
 /**
  * Safe, lifecycle-aware hook to use the recognizer.
+ *
+ * @param callbacks - The callbacks to use for the recognizer.
+ * @param destroyDeps - The additional dependencies to use for the cleanup effect.
+ *
+ * Example: To cleanup when the screen is unfocused.
+ *
+ * ```typescript
+ * const isFocused = useIsFocused()
+ * useRecognizer({ ... }, [isFocused])
+ * ```
  */
-export const useRecognizer = callbacks => {
+export const useRecognizer = (callbacks, destroyDeps = []) => {
   React.useEffect(() => {
     Recognizer.onReadyForSpeech = () => {
       callbacks.onReadyForSpeech?.();
@@ -57,7 +68,7 @@ export const useRecognizer = callbacks => {
     return () => {
       Recognizer.stopListening();
     };
-  }, []);
+  }, [...destroyDeps]);
   return {
     startListening: recognizerStartListening,
     stopListening: recognizerStopListening,

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","NitroModules","NitroSpeech","createHybridObject","Recognizer","recognizer","recognizerStartListening","params","startListening","recognizerStopListening","stopListening","recognizerAddAutoFinishTime","additionalTimeMs","addAutoFinishTime","recognizerUpdateAutoFinishTime","newTimeMs","withRefresh","updateAutoFinishTime","useRecognizer","callbacks","useEffect","onReadyForSpeech","onRecordingStopped","onResult","resultBatches","onAutoFinishProgress","timeLeftMs","onError","message","onPermissionDenied","undefined"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,4BAA4B;AAOzD,MAAMC,WAAW,GACfD,YAAY,CAACE,kBAAkB,CAAkB,aAAa,CAAC;;AAEjE;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAGF,WAAW,CAACG,UAAU;AAoBhD,MAAMC,wBAAwB,GAAIC,MAA0B,IAAK;EAC/DH,UAAU,CAACI,cAAc,CAACD,MAAM,CAAC;AACnC,CAAC;AAED,MAAME,uBAAuB,GAAGA,CAAA,KAAM;EACpCL,UAAU,CAACM,aAAa,CAAC,CAAC;AAC5B,CAAC;AAED,MAAMC,2BAA2B,GAAIC,gBAAyB,IAAK;EACjER,UAAU,CAACS,iBAAiB,CAACD,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAME,8BAA8B,GAAGA,CACrCC,SAAiB,EACjBC,WAAqB,KAClB;EACHZ,UAAU,CAACa,oBAAoB,CAACF,SAAS,EAAEC,WAAW,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACA,OAAO,MAAME,aAAa,GACxBC,SAA8B,IACP;EACvBnB,KAAK,CAACoB,SAAS,CAAC,MAAM;IACpBhB,UAAU,CAACiB,gBAAgB,GAAG,MAAM;MAClCF,SAAS,CAACE,gBAAgB,GAAG,CAAC;IAChC,CAAC;IACDjB,UAAU,CAACkB,kBAAkB,GAAG,MAAM;MACpCH,SAAS,CAACG,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACDlB,UAAU,CAACmB,QAAQ,GAAIC,aAAuB,IAAK;MACjDL,SAAS,CAACI,QAAQ,GAAGC,aAAa,CAAC;IACrC,CAAC;IACDpB,UAAU,CAACqB,oBAAoB,GAAIC,UAAkB,IAAK;MACxDP,SAAS,CAACM,oBAAoB,GAAGC,UAAU,CAAC;IAC9C,CAAC;IACDtB,UAAU,CAACuB,OAAO,GAAIC,OAAe,IAAK;MACxCT,SAAS,CAACQ,OAAO,GAAGC,OAAO,CAAC;IAC9B,CAAC;IACDxB,UAAU,CAACyB,kBAAkB,GAAG,MAAM;MACpCV,SAAS,CAACU,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,MAAM;MACXzB,UAAU,CAACiB,gBAAgB,GAAGS,SAAS;MACvC1B,UAAU,CAACkB,kBAAkB,GAAGQ,SAAS;MACzC1B,UAAU,CAACmB,QAAQ,GAAGO,SAAS;MAC/B1B,UAAU,CAACqB,oBAAoB,GAAGK,SAAS;MAC3C1B,UAAU,CAACuB,OAAO,GAAGG,SAAS;MAC9B1B,UAAU,CAACyB,kBAAkB,GAAGC,SAAS;IAC3C,CAAC;EACH,CAAC,EAAE,CAACX,SAAS,CAAC,CAAC;EAEfnB,KAAK,CAACoB,SAAS,CAAC,MAAM;IACpB,OAAO,MAAM;MACXhB,UAAU,CAACM,aAAa,CAAC,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLF,cAAc,EAAEF,wBAAwB;IACxCI,aAAa,EAAED,uBAAuB;IACtCI,iBAAiB,EAAEF,2BAA2B;IAC9CM,oBAAoB,EAAEH;EACxB,CAAC;AACH,CAAC","ignoreList":[]}
+{"version":3,"names":["React","NitroModules","NitroSpeech","createHybridObject","Recognizer","recognizer","recognizerStartListening","params","startListening","recognizerStopListening","stopListening","recognizerAddAutoFinishTime","additionalTimeMs","addAutoFinishTime","recognizerUpdateAutoFinishTime","newTimeMs","withRefresh","updateAutoFinishTime","useRecognizer","callbacks","destroyDeps","useEffect","onReadyForSpeech","onRecordingStopped","onResult","resultBatches","onAutoFinishProgress","timeLeftMs","onError","message","onPermissionDenied","undefined"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,4BAA4B;AAOzD,MAAMC,WAAW,GACfD,YAAY,CAACE,kBAAkB,CAAkB,aAAa,CAAC;;AAEjE;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAGF,WAAW,CAACG,UAAU;AAoBhD,MAAMC,wBAAwB,GAAIC,MAA0B,IAAK;EAC/DH,UAAU,CAACI,cAAc,CAACD,MAAM,CAAC;AACnC,CAAC;AAED,MAAME,uBAAuB,GAAGA,CAAA,KAAM;EACpCL,UAAU,CAACM,aAAa,CAAC,CAAC;AAC5B,CAAC;AAED,MAAMC,2BAA2B,GAAIC,gBAAyB,IAAK;EACjER,UAAU,CAACS,iBAAiB,CAACD,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAME,8BAA8B,GAAGA,CACrCC,SAAiB,EACjBC,WAAqB,KAClB;EACHZ,UAAU,CAACa,oBAAoB,CAACF,SAAS,EAAEC,WAAW,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,aAAa,GAAGA,CAC3BC,SAA8B,EAC9BC,WAAiC,GAAG,EAAE,KACf;EACvBpB,KAAK,CAACqB,SAAS,CAAC,MAAM;IACpBjB,UAAU,CAACkB,gBAAgB,GAAG,MAAM;MAClCH,SAAS,CAACG,gBAAgB,GAAG,CAAC;IAChC,CAAC;IACDlB,UAAU,CAACmB,kBAAkB,GAAG,MAAM;MACpCJ,SAAS,CAACI,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACDnB,UAAU,CAACoB,QAAQ,GAAIC,aAAuB,IAAK;MACjDN,SAAS,CAACK,QAAQ,GAAGC,aAAa,CAAC;IACrC,CAAC;IACDrB,UAAU,CAACsB,oBAAoB,GAAIC,UAAkB,IAAK;MACxDR,SAAS,CAACO,oBAAoB,GAAGC,UAAU,CAAC;IAC9C,CAAC;IACDvB,UAAU,CAACwB,OAAO,GAAIC,OAAe,IAAK;MACxCV,SAAS,CAACS,OAAO,GAAGC,OAAO,CAAC;IAC9B,CAAC;IACDzB,UAAU,CAAC0B,kBAAkB,GAAG,MAAM;MACpCX,SAAS,CAACW,kBAAkB,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,MAAM;MACX1B,UAAU,CAACkB,gBAAgB,GAAGS,SAAS;MACvC3B,UAAU,CAACmB,kBAAkB,GAAGQ,SAAS;MACzC3B,UAAU,CAACoB,QAAQ,GAAGO,SAAS;MAC/B3B,UAAU,CAACsB,oBAAoB,GAAGK,SAAS;MAC3C3B,UAAU,CAACwB,OAAO,GAAGG,SAAS;MAC9B3B,UAAU,CAAC0B,kBAAkB,GAAGC,SAAS;IAC3C,CAAC;EACH,CAAC,EAAE,CAACZ,SAAS,CAAC,CAAC;EAEfnB,KAAK,CAACqB,SAAS,CAAC,MAAM;IACpB,OAAO,MAAM;MACXjB,UAAU,CAACM,aAAa,CAAC,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,CAAC,GAAGU,WAAW,CAAC,CAAC;EAEpB,OAAO;IACLZ,cAAc,EAAEF,wBAAwB;IACxCI,aAAa,EAAED,uBAAuB;IACtCI,iBAAiB,EAAEF,2BAA2B;IAC9CM,oBAAoB,EAAEH;EACxB,CAAC;AACH,CAAC","ignoreList":[]}