react-native-davoice-tts 1.0.74 → 1.0.76

package/ios/TTSRNBridge/DavoiceTTS.xcframework/ios-arm64_x86_64-simulator/DavoiceTTS.framework/Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -14,25 +14,6 @@ import _StringProcessing
 import _SwiftConcurrencyShims
 import onnxruntime_objc
 import phonemes
-@objc public protocol STTDelegate {
-  @objc func stt(_ stt: DavoiceTTS.STT, didEmitEvent name: Swift.String, body: [Swift.String : Any]?)
-}
-@objc @_inheritsConvenienceInitializers @objcMembers final public class STT : ObjectiveC.NSObject, Speech.SFSpeechRecognizerDelegate {
-  @objc weak final public var delegate: (any DavoiceTTS.STTDelegate)?
-  @objc final public var continuous: Swift.Bool
-  @objc public static let supportedEvents: [Swift.String]
-  @objc final public func isSpeechAvailable(_ completion: @escaping (Swift.Bool) -> Swift.Void)
-  @objc final public func isRecognizing() -> Swift.Bool
-  @objc final public func startSpeech(localeStr: Swift.String?)
-  @objc final public func stopSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func cancelSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func destroySpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func teardown()
-  @objc final public func teardown2()
-  @objc final public func speechRecognizer(_ speechRecognizer: Speech.SFSpeechRecognizer, availabilityDidChange available: Swift.Bool)
-  @objc override dynamic public init()
-  @objc deinit
-}
 @objc @_inheritsConvenienceInitializers @_hasMissingDesignatedInitializers final public class SwiftSoundQueue : ObjectiveC.NSObject, AVFAudio.AVAudioPlayerDelegate {
   @objc deinit
   public static let shared: DavoiceTTS.SwiftSoundQueue
@@ -69,3 +50,22 @@ public enum AudioPlaybackHook {
   public static var isEngineReady: DavoiceTTS.IsEngineReady?
   public static var useOnlyEnginePlayback: DavoiceTTS.useOnlyEnginePlayback?
 }
+@objc public protocol STTDelegate {
+  @objc func stt(_ stt: DavoiceTTS.STT, didEmitEvent name: Swift.String, body: [Swift.String : Any]?)
+}
+@objc @_inheritsConvenienceInitializers @objcMembers final public class STT : ObjectiveC.NSObject, Speech.SFSpeechRecognizerDelegate {
+  @objc weak final public var delegate: (any DavoiceTTS.STTDelegate)?
+  @objc final public var continuous: Swift.Bool
+  @objc public static let supportedEvents: [Swift.String]
+  @objc final public func isSpeechAvailable(_ completion: @escaping (Swift.Bool) -> Swift.Void)
+  @objc final public func isRecognizing() -> Swift.Bool
+  @objc final public func startSpeech(localeStr: Swift.String?)
+  @objc final public func stopSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func cancelSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func destroySpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func teardown()
+  @objc final public func teardown2()
+  @objc final public func speechRecognizer(_ speechRecognizer: Speech.SFSpeechRecognizer, availabilityDidChange available: Swift.Bool)
+  @objc override dynamic public init()
+  @objc deinit
+}

package/ios/TTSRNBridge/DavoiceTTS.xcframework/ios-arm64_x86_64-simulator/DavoiceTTS.framework/Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -14,25 +14,6 @@ import _StringProcessing
 import _SwiftConcurrencyShims
 import onnxruntime_objc
 import phonemes
-@objc public protocol STTDelegate {
-  @objc func stt(_ stt: DavoiceTTS.STT, didEmitEvent name: Swift.String, body: [Swift.String : Any]?)
-}
-@objc @_inheritsConvenienceInitializers @objcMembers final public class STT : ObjectiveC.NSObject, Speech.SFSpeechRecognizerDelegate {
-  @objc weak final public var delegate: (any DavoiceTTS.STTDelegate)?
-  @objc final public var continuous: Swift.Bool
-  @objc public static let supportedEvents: [Swift.String]
-  @objc final public func isSpeechAvailable(_ completion: @escaping (Swift.Bool) -> Swift.Void)
-  @objc final public func isRecognizing() -> Swift.Bool
-  @objc final public func startSpeech(localeStr: Swift.String?)
-  @objc final public func stopSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func cancelSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func destroySpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
-  @objc final public func teardown()
-  @objc final public func teardown2()
-  @objc final public func speechRecognizer(_ speechRecognizer: Speech.SFSpeechRecognizer, availabilityDidChange available: Swift.Bool)
-  @objc override dynamic public init()
-  @objc deinit
-}
 @objc @_inheritsConvenienceInitializers @_hasMissingDesignatedInitializers final public class SwiftSoundQueue : ObjectiveC.NSObject, AVFAudio.AVAudioPlayerDelegate {
   @objc deinit
   public static let shared: DavoiceTTS.SwiftSoundQueue
@@ -69,3 +50,22 @@ public enum AudioPlaybackHook {
   public static var isEngineReady: DavoiceTTS.IsEngineReady?
   public static var useOnlyEnginePlayback: DavoiceTTS.useOnlyEnginePlayback?
 }
+@objc public protocol STTDelegate {
+  @objc func stt(_ stt: DavoiceTTS.STT, didEmitEvent name: Swift.String, body: [Swift.String : Any]?)
+}
+@objc @_inheritsConvenienceInitializers @objcMembers final public class STT : ObjectiveC.NSObject, Speech.SFSpeechRecognizerDelegate {
+  @objc weak final public var delegate: (any DavoiceTTS.STTDelegate)?
+  @objc final public var continuous: Swift.Bool
+  @objc public static let supportedEvents: [Swift.String]
+  @objc final public func isSpeechAvailable(_ completion: @escaping (Swift.Bool) -> Swift.Void)
+  @objc final public func isRecognizing() -> Swift.Bool
+  @objc final public func startSpeech(localeStr: Swift.String?)
+  @objc final public func stopSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func cancelSpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func destroySpeech(_ completion: ((Swift.Bool) -> Swift.Void)? = nil)
+  @objc final public func teardown()
+  @objc final public func teardown2()
+  @objc final public func speechRecognizer(_ speechRecognizer: Speech.SFSpeechRecognizer, availabilityDidChange available: Swift.Bool)
+  @objc override dynamic public init()
+  @objc deinit
+}

package/ios/TTSRNBridge/DavoiceTTS.xcframework/ios-arm64_x86_64-simulator/DavoiceTTS.framework/_CodeSignature/CodeResources

@@ -18,11 +18,11 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		Ux06wJCscUYxESolNVnOYjBZxxg=
+		fivfg8eVNZsAD8O5/A9Y+uONgEE=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		iZrHLJK4/9M/e49uphvsLsM0j1w=
+		8Y3XQLeIfwaoU+7uGOI/ejnQmzU=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
@@ -30,19 +30,19 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		iZrHLJK4/9M/e49uphvsLsM0j1w=
+		8Y3XQLeIfwaoU+7uGOI/ejnQmzU=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		O7su1nukOnT6jmDHhZnVr+HSFX0=
+		bqdpNARZYCm+k3I6TD9apxWxOo8=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		Ux06wJCscUYxESolNVnOYjBZxxg=
+		fivfg8eVNZsAD8O5/A9Y+uONgEE=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		euHAtwrs/moRnmtThKWKOEePrKk=
+		OdKnfC2sehdVMtSqGdsJsUvKDy0=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
@@ -50,11 +50,11 @@
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		euHAtwrs/moRnmtThKWKOEePrKk=
+		OdKnfC2sehdVMtSqGdsJsUvKDy0=
 		</data>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		S6id03wM8kk3s8CorbHArkYtlag=
+		pbGalSuDKtFBK6ju5uqFtv4nWj4=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -89,22 +89,22 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			Ux06wJCscUYxESolNVnOYjBZxxg=
+			fivfg8eVNZsAD8O5/A9Y+uONgEE=
 			</data>
 			<key>hash2</key>
 			<data>
-			WMZrtuiNIaxEQhienaCdktvQj4fk8rLubfpq8Q+6Kl4=
+			rNQyPRNJMuApbMq1gyjjFmGFsLiDnRoxQgK1WWhckY8=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			iZrHLJK4/9M/e49uphvsLsM0j1w=
+			8Y3XQLeIfwaoU+7uGOI/ejnQmzU=
 			</data>
 			<key>hash2</key>
 			<data>
-			jgkwM08SMKGxS1bQJU54pz5e45PKuPoCD6zGbV/A0II=
+			4/BSQSjWbbppLdBvyxu62gblBNBKQ/MoCJuBC5OioL4=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
@@ -122,44 +122,44 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			iZrHLJK4/9M/e49uphvsLsM0j1w=
+			8Y3XQLeIfwaoU+7uGOI/ejnQmzU=
 			</data>
 			<key>hash2</key>
 			<data>
-			jgkwM08SMKGxS1bQJU54pz5e45PKuPoCD6zGbV/A0II=
+			4/BSQSjWbbppLdBvyxu62gblBNBKQ/MoCJuBC5OioL4=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			O7su1nukOnT6jmDHhZnVr+HSFX0=
+			bqdpNARZYCm+k3I6TD9apxWxOo8=
 			</data>
 			<key>hash2</key>
 			<data>
-			CTLYrs6X2gnFcahbYjHwbD5HamlDtV8IOFsduYjf/Ac=
+			IvVtse9l29epDyofiapE3u4ODUSbx16fxMnK+B1W0NA=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			Ux06wJCscUYxESolNVnOYjBZxxg=
+			fivfg8eVNZsAD8O5/A9Y+uONgEE=
 			</data>
 			<key>hash2</key>
 			<data>
-			WMZrtuiNIaxEQhienaCdktvQj4fk8rLubfpq8Q+6Kl4=
+			rNQyPRNJMuApbMq1gyjjFmGFsLiDnRoxQgK1WWhckY8=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			euHAtwrs/moRnmtThKWKOEePrKk=
+			OdKnfC2sehdVMtSqGdsJsUvKDy0=
 			</data>
 			<key>hash2</key>
 			<data>
-			yRNxpR+3xAUB0BH5qbJ39I3Nok/3xDHogkzauX28pTI=
+			Oxh3jQ93jMvHo99sWfY1bBtwfF5x/EbM+GhI0EugZs8=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
@@ -177,22 +177,22 @@
 		<dict>
 			<key>hash</key>
 			<data>
-			euHAtwrs/moRnmtThKWKOEePrKk=
+			OdKnfC2sehdVMtSqGdsJsUvKDy0=
 			</data>
 			<key>hash2</key>
 			<data>
-			yRNxpR+3xAUB0BH5qbJ39I3Nok/3xDHogkzauX28pTI=
+			Oxh3jQ93jMvHo99sWfY1bBtwfF5x/EbM+GhI0EugZs8=
 			</data>
 		</dict>
 		<key>Modules/DavoiceTTS.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<dict>
 			<key>hash</key>
 			<data>
-			S6id03wM8kk3s8CorbHArkYtlag=
+			pbGalSuDKtFBK6ju5uqFtv4nWj4=
 			</data>
 			<key>hash2</key>
 			<data>
-			DHu3JYtuwEbXh/fa6dCr248uI6dsUDvxPAtnNUmYNXc=
+			XhUEJ5zGDgJwSvZwDv4OAX9lfe0uT3U2LpyFR+C5tNI=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-davoice-tts",
-    "version": "1.0.74",
+    "version": "1.0.76",
     "description": "tts library for React Native",
     "main": "tts/index.js",
     "types": "tts/index.d.ts",
@@ -12,6 +12,7 @@
     "files": [
         "tts/",
         "stt/",
+        "speech/",
         "android/",
         "ios/",
         "phonemes_dir",

package/speech/index.ts

@@ -0,0 +1,314 @@
+import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
+
+// Native handles
+const NativeSpeech = NativeModules.SpeechBridge;                 // iOS unified (if present)
+const NativeSTT =
+  NativeModules.STT ||
+  NativeModules.RCTSTT ||
+  NativeModules.Voice ||
+  NativeModules.RCTVoice;
+const NativeTTS = NativeModules.DaVoiceTTSBridge;
+
+// ---- Types ----
+export type SpeechStartEvent = {};
+export type SpeechEndEvent = {};
+export type SpeechRecognizedEvent = { isFinal: boolean };
+export type SpeechErrorEvent = { error: { code?: string; message?: string } };
+export type SpeechResultsEvent = { value: string[] };
+export type SpeechVolumeChangeEvent = { value: number };
+
+export type UnifiedEvents = {
+  // STT
+  onSpeechStart?: (e: SpeechStartEvent) => void;
+  onSpeechRecognized?: (e: SpeechRecognizedEvent) => void;
+  onSpeechEnd?: (e: SpeechEndEvent) => void;
+  onSpeechError?: (e: SpeechErrorEvent) => void;
+  onSpeechResults?: (e: SpeechResultsEvent) => void;
+  onSpeechPartialResults?: (e: SpeechResultsEvent) => void;
+  onSpeechVolumeChanged?: (e: SpeechVolumeChangeEvent) => void;
+  // TTS
+  onFinishedSpeaking?: () => void;
+};
+
+type NativeEventName =
+  | 'onSpeechStart'
+  | 'onSpeechRecognized'
+  | 'onSpeechEnd'
+  | 'onSpeechError'
+  | 'onSpeechResults'
+  | 'onSpeechPartialResults'
+  | 'onSpeechVolumeChanged'
+  | 'onFinishedSpeaking';
+
+class Speech {
+  private sttEmitter: NativeEventEmitter | null = null;
+  private ttsEmitter: NativeEventEmitter | null = null;
+  private unifiedEmitter: NativeEventEmitter | null = null;
+  private subs: Array<{ remove: () => void }> = [];
+  private handlers: Required<UnifiedEvents>;
+
+  constructor() {
+    this.handlers = {
+      onSpeechStart: () => {},
+      onSpeechRecognized: () => {},
+      onSpeechEnd: () => {},
+      onSpeechError: () => {},
+      onSpeechResults: () => {},
+      onSpeechPartialResults: () => {},
+      onSpeechVolumeChanged: () => {},
+      onFinishedSpeaking: () => {},
+    };
+
+    // Emitters per-platform
+    if (Platform.OS !== 'web') {
+      if (Platform.OS === 'ios' && NativeSpeech) {
+        this.unifiedEmitter = new NativeEventEmitter(NativeSpeech);
+      } else {
+        // Android (and iOS fallback): separate modules
+        if (NativeSTT) this.sttEmitter = new NativeEventEmitter(NativeSTT);
+        if (NativeTTS) this.ttsEmitter = new NativeEventEmitter(NativeTTS);
+      }
+    }
+  }
+
+  // ---------- Init / Destroy ----------
+  /**
+   * iOS: initialize STT then TTS via native SpeechBridge if available.
+   * Android: no special init needed; optionally preload TTS (if you want).
+   */
+  async initAll(opts: { locale: string; model: string; timeoutMs?: number }) {
+    if (Platform.OS === 'ios' && NativeSpeech?.initAll) {
+      return NativeSpeech.initAll(opts);
+    }
+
+    // Fallback (Android or iOS w/o SpeechBridge):
+    // 1) Start STT (engine hot will happen internally); 2) init TTS.
+    if (!NativeSTT || !NativeTTS) {
+      throw new Error('Missing native bridges (STT/TTS).');
+    }
+
+    // Start STT (best-effort; no-op if already running)
+    await new Promise<void>((resolve, reject) => {
+      try {
+        // iOS fallback signature: (locale, cb)
+        // Android signature: (locale, extras, cb)
+        if (Platform.OS === 'android' && NativeSTT.startSpeech.length >= 3) {
+          NativeSTT.startSpeech(
+            opts.locale,
+            {
+              EXTRA_LANGUAGE_MODEL: 'LANGUAGE_MODEL_FREE_FORM',
+              EXTRA_MAX_RESULTS: 5,
+              EXTRA_PARTIAL_RESULTS: true,
+              REQUEST_PERMISSIONS_AUTO: true,
+            },
+            (err: string) => (err ? reject(new Error(err)) : resolve()),
+          );
+        } else {
+          NativeSTT.startSpeech(opts.locale, (err: string) =>
+            err ? reject(new Error(err)) : resolve(),
+          );
+        }
+      } catch (e) {
+        reject(e as any);
+      }
+    });
+
+    // Init TTS
+    await NativeTTS.initTTS({ model: opts.model });
+  }
+
+  async destroyAll() {
+    // iOS unified
+    if (Platform.OS === 'ios' && NativeSpeech?.destroyAll) {
+      const r = await NativeSpeech.destroyAll();
+      this.teardownListeners();
+      return r;
+    }
+    // Fallback: destroy TTS -> STT
+    try { await NativeTTS?.destroy?.(); } catch {}
+    try {
+      await new Promise<void>((res) => {
+        if (!NativeSTT?.destroySpeech) return res();
+        NativeSTT.destroySpeech(() => res());
+      });
+    } catch {}
+    this.teardownListeners();
+    return 'Destroyed';
+  }
+
+  // ---------- STT ----------
+  async start(locale: string, options: Record<string, any> = {}) {
+    this.ensureListeners();
+    // Prefer unified on iOS
+    if (Platform.OS === 'ios' && NativeSpeech?.startSpeech) {
+      return new Promise<void>((resolve) => NativeSpeech.startSpeech(locale, () => resolve()));
+    }
+
+    // Android + iOS fallback
+    return new Promise<void>((resolve, reject) => {
+      if (!NativeSTT?.startSpeech) return reject(new Error('startSpeech not available'));
+      if (Platform.OS === 'android' && NativeSTT.startSpeech.length >= 3) {
+        NativeSTT.startSpeech(
+          locale,
+          {
+            EXTRA_LANGUAGE_MODEL: 'LANGUAGE_MODEL_FREE_FORM',
+            EXTRA_MAX_RESULTS: 5,
+            EXTRA_PARTIAL_RESULTS: true,
+            REQUEST_PERMISSIONS_AUTO: true,
+            ...options,
+          },
+          (err: string) => (err ? reject(new Error(err)) : resolve()),
+        );
+      } else {
+        NativeSTT.startSpeech(locale, (err: string) =>
+          err ? reject(new Error(err)) : resolve(),
+        );
+      }
+    });
+  }
+
+  stop(): Promise<void> {
+    if (Platform.OS === 'ios' && NativeSpeech?.stopSpeech) {
+      return new Promise((res) => NativeSpeech.stopSpeech(() => res()));
+    }
+    if (!NativeSTT?.stopSpeech) return Promise.resolve();
+    return new Promise((res) => NativeSTT.stopSpeech(() => res()));
+  }
+
+  cancel(): Promise<void> {
+    if (Platform.OS === 'ios' && NativeSpeech?.cancelSpeech) {
+      return new Promise((res) => NativeSpeech.cancelSpeech(() => res()));
+    }
+    if (!NativeSTT?.cancelSpeech) return Promise.resolve();
+    return new Promise((res) => NativeSTT.cancelSpeech(() => res()));
+  }
+
+  isAvailable(): Promise<0 | 1> {
+    // Prefer unified
+    if (Platform.OS === 'ios' && NativeSpeech?.isSpeechAvailable) {
+      return new Promise((resolve, reject) =>
+        NativeSpeech.isSpeechAvailable((ok: 0 | 1, err: string) =>
+          err ? reject(new Error(err)) : resolve(ok),
+        ),
+      );
+    }
+    if (NativeSTT?.isSpeechAvailable) {
+      return new Promise((resolve) =>
+        NativeSTT.isSpeechAvailable((ok: 0 | 1) => resolve(ok)),
+      );
+    }
+    return Promise.resolve(1);
+  }
+
+  isRecognizing(): Promise<0 | 1> {
+    if (Platform.OS === 'ios' && NativeSpeech?.isRecognizing) {
+      return new Promise((resolve) =>
+        NativeSpeech.isRecognizing((v: 0 | 1) => resolve(v)),
+      );
+    }
+    if (NativeSTT?.isRecognizing) {
+      return new Promise((resolve) =>
+        NativeSTT.isRecognizing((v: 0 | 1) => resolve(v)),
+      );
+    }
+    return Promise.resolve(0);
+  }
+
+  // ---------- TTS ----------
+  async initTTS(modelOrConfig: string | { model: string }) {
+    // iOS unified asks you to use initAll
+    if (Platform.OS === 'ios' && NativeSpeech?.initAll) {
+      throw new Error('Use initAll() on iOS unified bridge.');
+    }
+    const cfg = typeof modelOrConfig === 'string' ? { model: modelOrConfig } : modelOrConfig;
+    if (!cfg?.model) throw new Error("initTTS: missing 'model'");
+    return NativeTTS.initTTS(cfg);
+  }
+
+  async speak(text: string, speakerId = 0) {
+    if (Platform.OS === 'ios' && NativeSpeech?.speak) {
+      return NativeSpeech.speak(text, speakerId);
+    }
+    if (!NativeTTS?.speak) throw new Error('TTS speak not available');
+    return NativeTTS.speak(text, speakerId);
+  }
+
+  async stopSpeaking() {
+    if (Platform.OS === 'ios' && NativeSpeech?.stopSpeaking) {
+      return NativeSpeech.stopSpeaking();
+    }
+    if (!NativeTTS?.stopSpeaking) return;
+    return NativeTTS.stopSpeaking();
+  }
+
+  // ---------- Events ----------
+  private ensureListeners() {
+    if (this.subs.length) return;
+
+    // iOS unified: subscribe once on the unified emitter
+    if (Platform.OS === 'ios' && this.unifiedEmitter) {
+      const map: Record<NativeEventName, (...args: any[]) => void> = {
+        onSpeechStart: (e) => this.handlers.onSpeechStart(e),
+        onSpeechRecognized: (e) => this.handlers.onSpeechRecognized(e),
+        onSpeechEnd: (e) => this.handlers.onSpeechEnd(e),
+        onSpeechError: (e) => this.handlers.onSpeechError(e),
+        onSpeechResults: (e) => this.handlers.onSpeechResults(e),
+        onSpeechPartialResults: (e) => this.handlers.onSpeechPartialResults(e),
+        onSpeechVolumeChanged: (e) => this.handlers.onSpeechVolumeChanged(e),
+        onFinishedSpeaking: () => this.handlers.onFinishedSpeaking(),
+      };
+      (Object.keys(map) as NativeEventName[]).forEach((name) => {
+        try {
+          const sub = this.unifiedEmitter!.addListener(name, map[name]);
+          this.subs.push(sub);
+        } catch {}
+      });
+      return;
+    }
+
+    // Android (and iOS fallback): subscribe to both STT and TTS emitters
+    if (this.sttEmitter) {
+      const sttMap = {
+        onSpeechStart: (e: any) => this.handlers.onSpeechStart(e),
+        onSpeechRecognized: (e: any) => this.handlers.onSpeechRecognized(e),
+        onSpeechEnd: (e: any) => this.handlers.onSpeechEnd(e),
+        onSpeechError: (e: any) => this.handlers.onSpeechError(e),
+        onSpeechResults: (e: any) => this.handlers.onSpeechResults(e),
+        onSpeechPartialResults: (e: any) => this.handlers.onSpeechPartialResults(e),
+        onSpeechVolumeChanged: (e: any) => this.handlers.onSpeechVolumeChanged(e),
+      };
+      (Object.keys(sttMap) as (keyof typeof sttMap)[]).forEach((name) => {
+        try {
+          const sub = this.sttEmitter!.addListener(name, sttMap[name]);
+          this.subs.push(sub);
+        } catch {}
+      });
+    }
+    if (this.ttsEmitter) {
+      try {
+        const sub = this.ttsEmitter.addListener('onFinishedSpeaking', () =>
+          this.handlers.onFinishedSpeaking(),
+        );
+        this.subs.push(sub);
+      } catch {}
+    }
+  }
+
+  private teardownListeners() {
+    this.subs.forEach(s => { try { s.remove(); } catch {} });
+    this.subs = [];
+  }
+
+  // ---------- Friendly setters ----------
+  set onSpeechStart(fn: (e: SpeechStartEvent) => void) { this.handlers.onSpeechStart = fn; this.ensureListeners(); }
+  set onSpeechRecognized(fn: (e: SpeechRecognizedEvent) => void) { this.handlers.onSpeechRecognized = fn; this.ensureListeners(); }
+  set onSpeechEnd(fn: (e: SpeechEndEvent) => void) { this.handlers.onSpeechEnd = fn; this.ensureListeners(); }
+  set onSpeechError(fn: (e: SpeechErrorEvent) => void) { this.handlers.onSpeechError = fn; this.ensureListeners(); }
+  set onSpeechResults(fn: (e: SpeechResultsEvent) => void) { this.handlers.onSpeechResults = fn; this.ensureListeners(); }
+  set onSpeechPartialResults(fn: (e: SpeechResultsEvent) => void) { this.handlers.onSpeechPartialResults = fn; this.ensureListeners(); }
+  set onSpeechVolumeChanged(fn: (e: SpeechVolumeChangeEvent) => void) { this.handlers.onSpeechVolumeChanged = fn; this.ensureListeners(); }
+  set onFinishedSpeaking(fn: () => void) { this.handlers.onFinishedSpeaking = fn; this.ensureListeners(); }
+}
+
+const SpeechInstance = new Speech();
+export default SpeechInstance;