@gmessier/nitro-speech 0.4.1 → 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 |
@@ -155,7 +155,8 @@ Because of that, treat it as a **single session owner** setup hook: use it once
 import { useRecognizer } from '@gmessier/nitro-speech';
 
 function MyComponent() {
-  const { 
+  const {
+    prewarm,
     startListening, 
     stopListening, 
     resetAutoFinishTime, 
@@ -234,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)
 
@@ -261,6 +262,7 @@ If you need to call recognizer methods from other components without prop drilli
 ```typescript
 import { RecognizerRef } from '@gmessier/nitro-speech';
 
+RecognizerRef.prewarm({ locale: 'en-US' });
 RecognizerRef.startListening({ locale: 'en-US' });
 RecognizerRef.addAutoFinishTime(5000);
 RecognizerRef.resetAutoFinishTime();
@@ -357,12 +359,20 @@ function MyComponent() {
 
 `SpeechRecognizer` is the hybrid object. It gives direct access to callbacks and control methods, but it is unsafe to orchestrate the full session directly from it.
 
+**Warning**: Since it reflects the original hybrid object, its API may change in the future.
+
 ```typescript
-import { SpeechRecognizer, speechRecognizerVolumeChangeHandler } from '@gmessier/nitro-speech';
+import { 
+  SpeechRecognizer, 
+  speechRecognizerVolumeChangeHandler,
+  speechRecognizerActiveStateHandler,
+} from '@gmessier/nitro-speech';
 
 // Set up callbacks
 SpeechRecognizer.onReadyForSpeech = () => {
   console.log('Listening...');
+  // Add speechRecognizerActiveStateHandler to enable useRecognizerIsActive hook manually
+  speechRecognizerActiveStateHandler(true);
 };
 
 SpeechRecognizer.onResult = (textBatches) => {
@@ -371,6 +381,8 @@ SpeechRecognizer.onResult = (textBatches) => {
 
 SpeechRecognizer.onRecordingStopped = () => {
   console.log('Stopped');
+  // Add speechRecognizerActiveStateHandler to enable useRecognizerIsActive hook manually
+  speechRecognizerActiveStateHandler(false);
 };
 
 SpeechRecognizer.onAutoFinishProgress = (timeLeftMs) => {
@@ -387,10 +399,27 @@ SpeechRecognizer.onPermissionDenied = () => {
 
 SpeechRecognizer.onVolumeChange = (volume) => {
   console.log('new volume: ', volume);
+  // Add speechRecognizerVolumeChangeHandler to enable useVoiceInputVolume hook manually
+  speechRecognizerVolumeChangeHandler(volume);
 };
-// OR use speechRecognizerVolumeChangeHandler to enable useVoiceInputVolume hook manually
-SpeechRecognizer.onVolumeChange = speechRecognizerVolumeChangeHandler
 
+// Prepare resources, download assets, confirms locale availability
+SpeechRecognizer.prewarm({
+  locale: 'en-US',
+  // ... your config to prepare
+});
+// OR `await` if you want to react to the success
+await SpeechRecognizer.prewarm({
+  locale: 'en-US',
+  // ... your config to prepare
+});
+// OR from worklet (only sync)
+scheduleOnRuntime(workletRuntime, () => {
+  SpeechRecognizer.prewarm({
+    locale: 'en-US',
+    // ... your config to prepare
+  });
+});
 
 // Start listening
 SpeechRecognizer.startListening({

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/Recognizer/RecognizerRef.js

@@ -1,10 +1,11 @@
-import { recognizerAddAutoFinishTime, recognizerGetSupportedLocalesIOS, recognizerGetIsActive, recognizerResetAutoFinishTime, recognizerStartListening, recognizerStopListening, recognizerUpdateConfig, recognizerGetVoiceInputVolume, } from './methods';
+import { recognizerAddAutoFinishTime, recognizerGetSupportedLocalesIOS, recognizerGetIsActive, recognizerResetAutoFinishTime, recognizerStartListening, recognizerStopListening, recognizerUpdateConfig, recognizerGetVoiceInputVolume, recognizerPrewarm, } from './methods';
 /**
  * Safe cross-component reference to the Speech Recognizer methods.
  *
  * All methods support worklets and UI thread calls
  */
 export const RecognizerRef = {
+    prewarm: recognizerPrewarm,
     startListening: recognizerStartListening,
     stopListening: recognizerStopListening,
     resetAutoFinishTime: recognizerResetAutoFinishTime,

package/lib/Recognizer/SpeechRecognizer.d.ts

@@ -3,6 +3,7 @@
  *
  * Direct access to the all Speech Recognizer methods and callbacks.
  *
- * @note unsafe, might lead to race conditions
+ * @note Unsafe, might lead to race conditions
+ * @warning Since it reflects the original hybrid object, its API may change in the future.
  */
 export declare const SpeechRecognizer: import("./types").RecognizerSpec;

package/lib/Recognizer/SpeechRecognizer.js

@@ -4,6 +4,7 @@ import { NitroSpeech } from '../NitroSpeech';
  *
  * Direct access to the all Speech Recognizer methods and callbacks.
  *
- * @note unsafe, might lead to race conditions
+ * @note Unsafe, might lead to race conditions
+ * @warning Since it reflects the original hybrid object, its API may change in the future.
  */
 export const SpeechRecognizer = NitroSpeech.recognizer;

package/lib/Recognizer/methods.d.ts

@@ -1,9 +1,10 @@
-import type { SpeechRecognitionConfig } from './types';
-export declare const recognizerStartListening: (params: SpeechRecognitionConfig) => void;
+import type { MutableSpeechRecognitionConfig, SpeechRecognitionConfig } from './types';
+export declare const recognizerPrewarm: (params?: SpeechRecognitionConfig) => Promise<void>;
+export declare const recognizerStartListening: (params?: SpeechRecognitionConfig) => void;
 export declare const recognizerStopListening: () => void;
 export declare const recognizerResetAutoFinishTime: () => void;
 export declare const recognizerAddAutoFinishTime: (additionalTimeMs?: number) => void;
-export declare const recognizerUpdateConfig: (newConfig: SpeechRecognitionConfig, resetAutoFinishTime?: boolean) => void;
+export declare const recognizerUpdateConfig: (newConfig?: MutableSpeechRecognitionConfig, resetAutoFinishTime?: boolean) => void;
 export declare const recognizerGetIsActive: () => boolean;
 export declare const recognizerGetVoiceInputVolume: () => import("./types").VolumeChangeEvent;
 export declare const recognizerGetSupportedLocalesIOS: () => string[];

package/lib/Recognizer/methods.js

@@ -1,4 +1,8 @@
 import { SpeechRecognizer } from './SpeechRecognizer';
+export const recognizerPrewarm = (params) => {
+    'worklet';
+    return SpeechRecognizer.prewarm(params);
+};
 export const recognizerStartListening = (params) => {
     'worklet';
     SpeechRecognizer.startListening(params);

package/lib/Recognizer/types.d.ts

@@ -1,6 +1,6 @@
 import type { Recognizer as RecognizerSpec } from '../specs/Recognizer.nitro';
-import type { SpeechRecognitionConfig } from '../specs/SpeechRecognitionConfig';
+import type { MutableSpeechRecognitionConfig, SpeechRecognitionConfig } from '../specs/SpeechRecognitionConfig';
 import type { VolumeChangeEvent } from '../specs/VolumeChangeEvent';
 type RecognizerCallbacks = Pick<RecognizerSpec, 'onReadyForSpeech' | 'onRecordingStopped' | 'onResult' | 'onAutoFinishProgress' | 'onError' | 'onPermissionDenied' | 'onVolumeChange'>;
-type RecognizerMethods = Pick<RecognizerSpec, 'startListening' | 'stopListening' | 'resetAutoFinishTime' | 'addAutoFinishTime' | 'updateConfig' | 'getIsActive' | 'getVoiceInputVolume' | 'getSupportedLocalesIOS'>;
-export type { RecognizerSpec, SpeechRecognitionConfig, VolumeChangeEvent, RecognizerCallbacks, RecognizerMethods, };
+type RecognizerMethods = Pick<RecognizerSpec, 'prewarm' | 'startListening' | 'stopListening' | 'resetAutoFinishTime' | 'addAutoFinishTime' | 'updateConfig' | 'getIsActive' | 'getVoiceInputVolume' | 'getSupportedLocalesIOS'>;
+export type { RecognizerSpec, SpeechRecognitionConfig, MutableSpeechRecognitionConfig, VolumeChangeEvent, RecognizerCallbacks, RecognizerMethods, };

package/lib/Recognizer/useRecognizer.js

@@ -1,5 +1,5 @@
 import { useEffect } from 'react';
-import { recognizerResetAutoFinishTime, recognizerAddAutoFinishTime, recognizerUpdateConfig, recognizerGetIsActive, recognizerGetSupportedLocalesIOS, recognizerStartListening, recognizerStopListening, recognizerGetVoiceInputVolume, } from './methods';
+import { recognizerResetAutoFinishTime, recognizerAddAutoFinishTime, recognizerUpdateConfig, recognizerGetIsActive, recognizerGetSupportedLocalesIOS, recognizerStartListening, recognizerStopListening, recognizerGetVoiceInputVolume, recognizerPrewarm, } from './methods';
 import { SpeechRecognizer } from './SpeechRecognizer';
 import { speechRecognizerVolumeChangeHandler } from './useVoiceInputVolume';
 import { speechRecognizerActiveStateHandler } from './useRecognizerIsActive';
@@ -59,6 +59,7 @@ export const useRecognizer = (callbacks, destroyDeps = []) => {
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [...destroyDeps]);
     return {
+        prewarm: recognizerPrewarm,
         startListening: recognizerStartListening,
         stopListening: recognizerStopListening,
         resetAutoFinishTime: recognizerResetAutoFinishTime,

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-export * from './Recognizer/types';
 export { useRecognizer } from './Recognizer/useRecognizer';
 export { useVoiceInputVolume, speechRecognizerVolumeChangeHandler, } from './Recognizer/useVoiceInputVolume';
 export { useRecognizerIsActive, speechRecognizerActiveStateHandler, } from './Recognizer/useRecognizerIsActive';
 export { SpeechRecognizer } from './Recognizer/SpeechRecognizer';
 export { RecognizerRef } from './Recognizer/RecognizerRef';
 export { NitroSpeech } from './NitroSpeech';
+export { type RecognizerSpec, type SpeechRecognitionConfig, type MutableSpeechRecognitionConfig, type VolumeChangeEvent, type RecognizerCallbacks, type RecognizerMethods, } from './Recognizer/types';

package/lib/index.js

@@ -1,7 +1,7 @@
-export * from './Recognizer/types';
 export { useRecognizer } from './Recognizer/useRecognizer';
 export { useVoiceInputVolume, speechRecognizerVolumeChangeHandler, } from './Recognizer/useVoiceInputVolume';
 export { useRecognizerIsActive, speechRecognizerActiveStateHandler, } from './Recognizer/useRecognizerIsActive';
 export { SpeechRecognizer } from './Recognizer/SpeechRecognizer';
 export { RecognizerRef } from './Recognizer/RecognizerRef';
 export { NitroSpeech } from './NitroSpeech';
+export {} from './Recognizer/types';

package/lib/specs/Recognizer.nitro.d.ts

@@ -8,9 +8,24 @@ export interface Recognizer extends HybridObject<{
     /**
      * Prepare the speech recognition engine and the model for the given parameters.
      *
-     * Omit the {@linkcode Promise} result if want to run synchronously.
+     * @notes
+     * - Not required, {@linkcode startListening} will prewarm automatically.
+     *
+     * - Omit the {@linkcode Promise} result if you want to run synchronously.
      * {@linkcode startListening} will start and resolve it automatically.
-     * Only `await` if run beforehand and want to react on the success
+     *
+     * - Only `await` if run beforehand and you want to react to the success
+     *
+     * @worklet **Do not** use `await` on Worklet or UI runtimes. It will not work properly.
+     *
+     * You can run it synchronously:
+     * ```typescript
+     *  scheduleOnRuntime(workletRuntime, () => {
+     *    RecognizerRef.prewarm({
+     *      // your config to prepare
+     *    });
+     *  });
+     * ```
      */
     prewarm(defaultParams?: SpeechRecognitionConfig): Promise<void>;
     /**
@@ -24,9 +39,9 @@ export interface Recognizer extends HybridObject<{
      */
     startListening(params?: SpeechRecognitionConfig): void;
     /**
-     * Stops the speech recognition. if not started, does nothing.
+     * Stops the speech recognition. If not started, does nothing.
      *
-     * Not a sync operation for android, delay about 250ms to polish the result.
+     * Not a sync operation for Android, delay about 250ms to polish the result.
      *
      * Use {@linkcode onRecordingStopped} to handle the stop event.
      */
@@ -78,8 +93,6 @@ export interface Recognizer extends HybridObject<{
      * Fires every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
      *
      * Time left in milliseconds until the timer stops.
-     *
-     * @note not implemented for Android yet.
      */
     onAutoFinishProgress?: (timeLeftMs: number) => void;
     /**

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.1",
+  "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/Recognizer/RecognizerRef.ts

@@ -8,6 +8,7 @@ import {
   recognizerStopListening,
   recognizerUpdateConfig,
   recognizerGetVoiceInputVolume,
+  recognizerPrewarm,
 } from './methods'
 
 /**
@@ -16,6 +17,7 @@ import {
  * All methods support worklets and UI thread calls
  */
 export const RecognizerRef: RecognizerMethods = {
+  prewarm: recognizerPrewarm,
   startListening: recognizerStartListening,
   stopListening: recognizerStopListening,
   resetAutoFinishTime: recognizerResetAutoFinishTime,

package/src/Recognizer/SpeechRecognizer.ts

@@ -5,6 +5,7 @@ import { NitroSpeech } from '../NitroSpeech'
  *
  * Direct access to the all Speech Recognizer methods and callbacks.
  *
- * @note unsafe, might lead to race conditions
+ * @note Unsafe, might lead to race conditions
+ * @warning Since it reflects the original hybrid object, its API may change in the future.
  */
 export const SpeechRecognizer = NitroSpeech.recognizer

package/src/Recognizer/methods.ts

@@ -1,7 +1,15 @@
 import { SpeechRecognizer } from './SpeechRecognizer'
-import type { SpeechRecognitionConfig } from './types'
+import type {
+  MutableSpeechRecognitionConfig,
+  SpeechRecognitionConfig,
+} from './types'
 
-export const recognizerStartListening = (params: SpeechRecognitionConfig) => {
+export const recognizerPrewarm = (params?: SpeechRecognitionConfig) => {
+  'worklet'
+  return SpeechRecognizer.prewarm(params)
+}
+
+export const recognizerStartListening = (params?: SpeechRecognitionConfig) => {
   'worklet'
   SpeechRecognizer.startListening(params)
 }
@@ -22,7 +30,7 @@ export const recognizerAddAutoFinishTime = (additionalTimeMs?: number) => {
 }
 
 export const recognizerUpdateConfig = (
-  newConfig: SpeechRecognitionConfig,
+  newConfig?: MutableSpeechRecognitionConfig,
   resetAutoFinishTime?: boolean
 ) => {
   'worklet'

package/src/Recognizer/types.ts

@@ -1,5 +1,8 @@
 import type { Recognizer as RecognizerSpec } from '../specs/Recognizer.nitro'
-import type { SpeechRecognitionConfig } from '../specs/SpeechRecognitionConfig'
+import type {
+  MutableSpeechRecognitionConfig,
+  SpeechRecognitionConfig,
+} from '../specs/SpeechRecognitionConfig'
 import type { VolumeChangeEvent } from '../specs/VolumeChangeEvent'
 
 type RecognizerCallbacks = Pick<
@@ -15,6 +18,7 @@ type RecognizerCallbacks = Pick<
 
 type RecognizerMethods = Pick<
   RecognizerSpec,
+  | 'prewarm'
   | 'startListening'
   | 'stopListening'
   | 'resetAutoFinishTime'
@@ -28,6 +32,7 @@ type RecognizerMethods = Pick<
 export type {
   RecognizerSpec,
   SpeechRecognitionConfig,
+  MutableSpeechRecognitionConfig,
   VolumeChangeEvent,
   RecognizerCallbacks,
   RecognizerMethods,

package/src/Recognizer/useRecognizer.ts

@@ -8,6 +8,7 @@ import {
   recognizerStartListening,
   recognizerStopListening,
   recognizerGetVoiceInputVolume,
+  recognizerPrewarm,
 } from './methods'
 import type { RecognizerCallbacks, RecognizerMethods } from './types'
 import { SpeechRecognizer } from './SpeechRecognizer'
@@ -75,6 +76,7 @@ export const useRecognizer = (
   }, [...destroyDeps])
 
   return {
+    prewarm: recognizerPrewarm,
     startListening: recognizerStartListening,
     stopListening: recognizerStopListening,
     resetAutoFinishTime: recognizerResetAutoFinishTime,

package/src/index.ts

@@ -1,4 +1,3 @@
-export * from './Recognizer/types'
 export { useRecognizer } from './Recognizer/useRecognizer'
 export {
   useVoiceInputVolume,
@@ -11,3 +10,11 @@ export {
 export { SpeechRecognizer } from './Recognizer/SpeechRecognizer'
 export { RecognizerRef } from './Recognizer/RecognizerRef'
 export { NitroSpeech } from './NitroSpeech'
+export {
+  type RecognizerSpec,
+  type SpeechRecognitionConfig,
+  type MutableSpeechRecognitionConfig,
+  type VolumeChangeEvent,
+  type RecognizerCallbacks,
+  type RecognizerMethods,
+} from './Recognizer/types'

package/src/specs/Recognizer.nitro.ts

@@ -12,9 +12,24 @@ export interface Recognizer extends HybridObject<{
   /**
    * Prepare the speech recognition engine and the model for the given parameters.
    *
-   * Omit the {@linkcode Promise} result if want to run synchronously.
+   * @notes
+   * - Not required, {@linkcode startListening} will prewarm automatically.
+   *
+   * - Omit the {@linkcode Promise} result if you want to run synchronously.
    * {@linkcode startListening} will start and resolve it automatically.
-   * Only `await` if run beforehand and want to react on the success
+   *
+   * - Only `await` if run beforehand and you want to react to the success
+   *
+   * @worklet **Do not** use `await` on Worklet or UI runtimes. It will not work properly.
+   *
+   * You can run it synchronously:
+   * ```typescript
+   *  scheduleOnRuntime(workletRuntime, () => {
+   *    RecognizerRef.prewarm({
+   *      // your config to prepare
+   *    });
+   *  });
+   * ```
    */
   prewarm(defaultParams?: SpeechRecognitionConfig): Promise<void>
 
@@ -30,9 +45,9 @@ export interface Recognizer extends HybridObject<{
   startListening(params?: SpeechRecognitionConfig): void
 
   /**
-   * Stops the speech recognition. if not started, does nothing.
+   * Stops the speech recognition. If not started, does nothing.
    *
-   * Not a sync operation for android, delay about 250ms to polish the result.
+   * Not a sync operation for Android, delay about 250ms to polish the result.
    *
    * Use {@linkcode onRecordingStopped} to handle the stop event.
    */
@@ -94,8 +109,6 @@ export interface Recognizer extends HybridObject<{
    * Fires every {@linkcode SpeechRecognitionConfig.autoFinishProgressIntervalMs} or 1000ms
    *
    * Time left in milliseconds until the timer stops.
-   *
-   * @note not implemented for Android yet.
    */
   onAutoFinishProgress?: (timeLeftMs: number) => void
   /**

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+
    *