@gmessier/nitro-speech 0.4.2 → 0.4.3

package/README.md

@@ -34,7 +34,7 @@
 - 👆 Configurable Haptic Feedback on start and finish
 - 🎚️ Speech-quality configurations:
   - Result is grouped by speech segments into Batches.
-  - Param `iosPreset` - `shortForm` or `general` enables best transcriber for your situation
+  - Param `iosPreset` - enables best transcriber for your situation
   - Param `disableRepeatingFilter` - filters out consecutive duplicate words.
   - Param `androidDisableBatchHandling` - disables empty partial results
   - Many more, see `SpeechRecognitionConfig`
@@ -138,7 +138,7 @@ Both permissions are required for speech recognition to work on iOS.
 | **Language model selection** | Choose between web search vs free-form models | Auto | ✅ |
 | **Batch handling** | Filters out empty or repeated results | Auto | ✅ |
 | **Formatting quality** | Prefer quality vs speed in formatting | Auto | ✅ |
-| **Transcription preset** | `iosPreset` adapts for short phrases (`shortForm`) or `general` conversation | ✅ | Auto |
+| **Transcription preset** | `iosPreset` adapts for different scenarios | ✅ | Auto |
 | **Automatic punctuation** | Adds punctuation to transcription (iOS 16+) | ✅ | Auto |
 | **Atypical speech hint** | Hint iOS that speech may include accent, lisp, or other confounding traits | ✅ | Auto |
 | **getSupportedLocalesIOS** | Supported locales for iOS (No available API for Android) | ✅ | X |
@@ -235,7 +235,7 @@ function MyComponent() {
 }
 ```
 
-On iOS 26+, the recognizer prefers the newer `SpeechTranscriber` path for general cases. Setting `iosPreset: 'shortForm'`, `iosAddPunctuation: false`, or `iosAtypicalSpeech: true` switches priority to `DictationTranscriber` that is better suited for short utterances or non-standard speech patterns.
+On iOS 26+, the recognizer prefers the newer `SpeechTranscriber` path for general cases. Setting `iosPreset: 'shortForm' OR 'speed'`, `iosAddPunctuation: false`, or `iosAtypicalSpeech: true` switches priority to `DictationTranscriber` that is better suited for short utterances or non-standard speech patterns.
 
 ### With React Navigation (important)
 

package/ios/Audio/AudioLevelTracker.swift

@@ -20,7 +20,7 @@ final class AudioLevelTracker {
 
     var currentSample: AudioLevelSample?
     
-    private let lg = Lg(prefix: "RecognizerEngine")
+    private let lg = Lg(prefix: "RecognizerEngine", disable: true)
 
     func reset() {
         smoothedLevel = 0

package/ios/Coordinator.swift

@@ -39,6 +39,7 @@ final class Coordinator {
         }
         
         if params?.iosPreset == IosPreset.shortform
+        || params?.iosPreset == IosPreset.speed
         || params?.iosAddPunctuation == false
         || params?.iosAtypicalSpeech == true {
             // DictationTranscriber priority

package/ios/HybridRecognizer.swift

@@ -7,10 +7,13 @@ class HybridRecognizer: HybridRecognizerSpec  {
     var onReadyForSpeech: (() -> Void)?
     var onRecordingStopped: (() -> Void)?
     var onResult: (([String]) -> Void)?
+    var onResultFallback: (([String]) -> Void)?
     var onAutoFinishProgress: ((Double) -> Void)?
+    var onAutoFinishProgressFallback: ((Double) -> Void)?
     var onError: ((String) -> Void)?
     var onPermissionDenied: (() -> Void)?
     var onVolumeChange: ((VolumeChangeEvent) -> Void)?
+    var onVolumeChangeFallback: ((VolumeChangeEvent) -> Void)?
     
     private let coordinator = Coordinator()
     private var paramsHash: String?
@@ -154,12 +157,29 @@ extension HybridRecognizer: RecognizerDelegate {
     
     func result(batches: [String]) {
         self.lg.log("[onResult] \(batches)")
-        self.onResult?(batches)
+        if onResult != nil {
+            onResultFallback = onResult
+        }
+        
+        if (onResultFallback == nil) {
+            self.lg.log("onResultFallback -> nil")
+        }
+        
+        onResultFallback?(batches)
     }
     
     func autoFinishProgress(timeLeftMs: Double) {
         self.lg.log("[onAutoFinishProgress] \(timeLeftMs)ms")
-        self.onAutoFinishProgress?(timeLeftMs)
+        
+        if onAutoFinishProgress != nil {
+            onAutoFinishProgressFallback = onAutoFinishProgress
+        }
+        
+        if (onAutoFinishProgressFallback == nil) {
+            self.lg.log("onAutoFinishProgressFallback -> nil")
+        }
+        
+        onAutoFinishProgressFallback?(timeLeftMs)
     }
     
     func error(message: String) {
@@ -174,7 +194,15 @@ extension HybridRecognizer: RecognizerDelegate {
     
     func volumeChange(event: VolumeChangeEvent) {
         // self.lg.log("[onVolumeChange] \(event.rawVolume)")
-        self.onVolumeChange?(event)
+        if onVolumeChange != nil {
+            onVolumeChangeFallback = onVolumeChange
+        }
+        
+        if (onVolumeChangeFallback == nil) {
+            self.lg.log("onVolumeChangeFallback -> nil")
+        }
+        
+        onVolumeChangeFallback?(event)
     }
     
     func reselectEngine(forPrewarm: Bool) {

package/ios/Shared/AutoStopper.swift

@@ -5,7 +5,7 @@ final class AutoStopper {
     private static let defaultProgressIntervalMs = 1000.0
     private static let minProgressIntervalMs = 50.0
 
-    private let lg = Lg(prefix: "AutoStopper", disable: false)
+    private let lg = Lg(prefix: "AutoStopper", disable: true)
     
     private let queue = DispatchQueue(label: "com.margelo.nitrospeech.autostopper")
 

package/ios/Shared/Utils.swift

@@ -44,7 +44,8 @@ enum Utils {
         }
         let preset = switch params.iosPreset {
             case nil: "n"
-            case .shortform: "s"
+            // Both presets prioritize Dictation
+            case .shortform, .speed: "s"
             case .general: "g"
         }
         let atypicalSpeech = switch params.iosAtypicalSpeech {

package/lib/specs/SpeechRecognitionConfig.d.ts

@@ -22,7 +22,7 @@ interface ParamsAndroid {
      */
     androidDisableBatchHandling?: boolean;
 }
-type IosPreset = 'shortform' | 'general';
+type IosPreset = 'shortform' | 'general' | 'speed';
 interface ParamsIOS {
     /**
      * Add punctuation to speech recognition results
@@ -33,9 +33,11 @@ interface ParamsIOS {
      */
     iosAddPunctuation?: boolean;
     /**
-     * `"shortForm"` - for a short phrase or sentence, also disables punctuation
+     * `"shortForm"` - For a short phrase or sentence, also disables punctuation
      *
-     * `"general"` - for longer speeches, more accurate but delayed response
+     * `"speed"` - Gives priority to speed over accuracy
+     *
+     * `"general"` - For longer speeches, more accurate but delayed response
      *
      * @since iOS 26.0+
      *

package/nitrogen/generated/android/c++/JIosPreset.hpp

@@ -48,6 +48,9 @@ namespace margelo::nitro::nitrospeech {
         case IosPreset::GENERAL:
           static const auto fieldGENERAL = clazz->getStaticField<JIosPreset>("GENERAL");
           return clazz->getStaticFieldValue(fieldGENERAL);
+        case IosPreset::SPEED:
+          static const auto fieldSPEED = clazz->getStaticField<JIosPreset>("SPEED");
+          return clazz->getStaticFieldValue(fieldSPEED);
         default:
           std::string stringValue = std::to_string(static_cast<int>(value));
           throw std::invalid_argument("Invalid enum value (" + stringValue + "!");

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitrospeech/IosPreset.kt

@@ -17,7 +17,8 @@ import com.facebook.proguard.annotations.DoNotStrip
 @Keep
 enum class IosPreset(@DoNotStrip @Keep val value: Int) {
   SHORTFORM(0),
-  GENERAL(1);
+  GENERAL(1),
+  SPEED(2);
 
   companion object
 }

package/nitrogen/generated/ios/swift/IosPreset.swift

@@ -21,6 +21,8 @@ public extension IosPreset {
         self = .shortform
       case "general":
         self = .general
+      case "speed":
+        self = .speed
       default:
         return nil
     }
@@ -35,6 +37,8 @@ public extension IosPreset {
         return "shortform"
       case .general:
         return "general"
+      case .speed:
+        return "speed"
     }
   }
 }

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

@@ -31,6 +31,7 @@ namespace margelo::nitro::nitrospeech {
   enum class IosPreset {
     SHORTFORM      SWIFT_NAME(shortform) = 0,
     GENERAL      SWIFT_NAME(general) = 1,
+    SPEED      SWIFT_NAME(speed) = 2,
   } CLOSED_ENUM;
 
 } // namespace margelo::nitro::nitrospeech
@@ -45,6 +46,7 @@ namespace margelo::nitro {
       switch (hashString(unionValue.c_str(), unionValue.size())) {
         case hashString("shortform"): return margelo::nitro::nitrospeech::IosPreset::SHORTFORM;
         case hashString("general"): return margelo::nitro::nitrospeech::IosPreset::GENERAL;
+        case hashString("speed"): return margelo::nitro::nitrospeech::IosPreset::SPEED;
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert \"" + unionValue + "\" to enum IosPreset - invalid value!");
       }
@@ -53,6 +55,7 @@ namespace margelo::nitro {
       switch (arg) {
         case margelo::nitro::nitrospeech::IosPreset::SHORTFORM: return JSIConverter<std::string>::toJSI(runtime, "shortform");
         case margelo::nitro::nitrospeech::IosPreset::GENERAL: return JSIConverter<std::string>::toJSI(runtime, "general");
+        case margelo::nitro::nitrospeech::IosPreset::SPEED: return JSIConverter<std::string>::toJSI(runtime, "speed");
         default: [[unlikely]]
           throw std::invalid_argument("Cannot convert IosPreset to JS - invalid value: "
                                     + std::to_string(static_cast<int>(arg)) + "!");
@@ -66,6 +69,7 @@ namespace margelo::nitro {
       switch (hashString(unionValue.c_str(), unionValue.size())) {
         case hashString("shortform"):
         case hashString("general"):
+        case hashString("speed"):
           return true;
         default:
           return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmessier/nitro-speech",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "React Native Real-time Speech Recognition Library powered by Nitro Modules",
   "main": "./lib/index.js",
   "module": "./lib/index.js",

package/src/specs/SpeechRecognitionConfig.ts

@@ -23,7 +23,7 @@ interface ParamsAndroid {
   androidDisableBatchHandling?: boolean
 }
 
-type IosPreset = 'shortform' | 'general'
+type IosPreset = 'shortform' | 'general' | 'speed'
 
 interface ParamsIOS {
   /**
@@ -35,9 +35,11 @@ interface ParamsIOS {
    */
   iosAddPunctuation?: boolean
   /**
-   * `"shortForm"` - for a short phrase or sentence, also disables punctuation
+   * `"shortForm"` - For a short phrase or sentence, also disables punctuation
    *
-   * `"general"` - for longer speeches, more accurate but delayed response
+   * `"speed"` - Gives priority to speed over accuracy
+   *
+   * `"general"` - For longer speeches, more accurate but delayed response
    *
    * @since iOS 26.0+
    *