react-native-tts-kit 0.1.0

package/build/engines/Engine.d.ts

@@ -0,0 +1,15 @@
+import type { ClonedVoice, CloneOptions, EngineCapabilities, EngineId, PrefetchProgress, SpeakOptions, StreamHandle, Voice } from '../types';
+export interface Engine {
+    readonly id: EngineId;
+    readonly capabilities: EngineCapabilities;
+    isAvailable(): Promise<boolean>;
+    prefetch(onProgress?: (p: PrefetchProgress) => void): Promise<void>;
+    getVoices(): Promise<Voice[]>;
+    speak(text: string, options?: SpeakOptions): Promise<void>;
+    stream(text: string, options?: SpeakOptions): StreamHandle;
+    stop(): Promise<void>;
+    /** Delete any locally cached model files so the next prefetch re-downloads. */
+    clearCache?(): Promise<void>;
+    cloneVoice?(options: CloneOptions): Promise<ClonedVoice>;
+}
+//# sourceMappingURL=Engine.d.ts.map

package/build/engines/Engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../src/engines/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,EACN,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE1C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,+EAA+E;IAC/E,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,UAAU,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1D"}

package/build/engines/Engine.js

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

package/build/engines/Engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Engine.js","sourceRoot":"","sources":["../../src/engines/Engine.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ClonedVoice,\n  CloneOptions,\n  EngineCapabilities,\n  EngineId,\n  PrefetchProgress,\n  SpeakOptions,\n  StreamHandle,\n  Voice,\n} from '../types';\n\nexport interface Engine {\n  readonly id: EngineId;\n  readonly capabilities: EngineCapabilities;\n\n  isAvailable(): Promise<boolean>;\n  prefetch(onProgress?: (p: PrefetchProgress) => void): Promise<void>;\n\n  getVoices(): Promise<Voice[]>;\n  speak(text: string, options?: SpeakOptions): Promise<void>;\n  stream(text: string, options?: SpeakOptions): StreamHandle;\n  stop(): Promise<void>;\n\n  /** Delete any locally cached model files so the next prefetch re-downloads. */\n  clearCache?(): Promise<void>;\n\n  cloneVoice?(options: CloneOptions): Promise<ClonedVoice>;\n}\n"]}

package/build/engines/SupertonicEngine.d.ts

@@ -0,0 +1,14 @@
+import type { EngineCapabilities, EngineId, PrefetchProgress, SpeakOptions, StreamHandle, Voice } from '../types';
+import type { Engine } from './Engine';
+export declare class SupertonicEngine implements Engine {
+    readonly id: EngineId;
+    readonly capabilities: EngineCapabilities;
+    isAvailable(): Promise<boolean>;
+    prefetch(onProgress?: (p: PrefetchProgress) => void): Promise<void>;
+    getVoices(): Promise<Voice[]>;
+    speak(text: string, options?: SpeakOptions): Promise<void>;
+    stream(text: string, options?: SpeakOptions): StreamHandle;
+    stop(): Promise<void>;
+    clearCache(): Promise<void>;
+}
+//# sourceMappingURL=SupertonicEngine.d.ts.map

package/build/engines/SupertonicEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupertonicEngine.d.ts","sourceRoot":"","sources":["../../src/engines/SupertonicEngine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,EACN,MAAM,UAAU,CAAC;AAmBlB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AA8EvC,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAgB;IACrC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAMvC;IAEI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnE,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCpE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY;IAgExD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/build/engines/SupertonicEngine.js

@@ -0,0 +1,183 @@
+import { requireNativeModule } from 'expo-modules-core';
+import { Platform } from 'react-native';
+// iOS has CoreML/ANE fp16 acceleration; even an 8-step diffusion takes ~1s.
+// Android relies on NNAPI + commodity SoCs (e.g. Snapdragon 720G in mid-tier
+// phones) and tops out around 1-1.2s per diffusion step at fp32, so 8 steps
+// stretches synthesis to 10-14s. Supertonic-3 was trained for 2-8 step
+// inference; 6 steps is the quality/speed sweet spot on Android — audibly
+// closer to 8-step than to 4-step, while still ~25% faster than 8.
+// Callers can override per-call via SpeakOptions.totalStep.
+const DEFAULT_TOTAL_STEP = Platform.OS === 'android' ? 6 : 8;
+import { BufferedStreamEmitter } from './BufferedStreamEmitter';
+import { DEFAULT_LANGUAGE, DEFAULT_VOICE_ID, SUPERTONIC_LANGUAGES, SUPERTONIC_VOICES, findVoice, } from '../voices/catalog';
+import { stripProsody } from '../voices/prosody';
+let nativeModule = null;
+function getNative() {
+    if (!nativeModule) {
+        nativeModule = requireNativeModule('RNTTSKit');
+    }
+    return nativeModule;
+}
+let counter = 0;
+const newId = () => `op_${Date.now().toString(36)}_${(++counter).toString(36)}`;
+function decodeBase64(b64) {
+    if (typeof atob === 'function') {
+        const bin = atob(b64);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++)
+            out[i] = bin.charCodeAt(i);
+        return out;
+    }
+    const lookup = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+    const cleaned = b64.replace(/=+$/, '');
+    const out = new Uint8Array((cleaned.length * 3) >> 2);
+    let o = 0;
+    for (let i = 0; i < cleaned.length; i += 4) {
+        const a = lookup.indexOf(cleaned[i]);
+        const b = lookup.indexOf(cleaned[i + 1]);
+        const c = lookup.indexOf(cleaned[i + 2] ?? 'A');
+        const d = lookup.indexOf(cleaned[i + 3] ?? 'A');
+        out[o++] = (a << 2) | (b >> 4);
+        if (cleaned[i + 2])
+            out[o++] = ((b & 15) << 4) | (c >> 2);
+        if (cleaned[i + 3])
+            out[o++] = ((c & 3) << 6) | d;
+    }
+    return out.subarray(0, o);
+}
+// BufferedStreamEmitter is exported from its own module so we can unit-test
+// it without needing the native module to load. See ./BufferedStreamEmitter.ts
+function resolveLang(options) {
+    const lang = options.language ?? DEFAULT_LANGUAGE;
+    if (!SUPERTONIC_LANGUAGES.includes(lang)) {
+        throw new Error(`[ttskit] Unsupported language for Supertonic: ${lang}`);
+    }
+    return lang;
+}
+export class SupertonicEngine {
+    id = 'supertonic';
+    capabilities = {
+        streaming: true,
+        cloning: false,
+        emotionTags: false,
+        offline: true,
+        languages: [...SUPERTONIC_LANGUAGES],
+    };
+    async isAvailable() {
+        try {
+            return await getNative().isAvailable();
+        }
+        catch {
+            return false;
+        }
+    }
+    async prefetch(onProgress) {
+        const native = getNative();
+        const sub = onProgress
+            ? native.addListener('onPrefetchProgress', (e) => onProgress(e))
+            : null;
+        try {
+            await native.prefetch();
+        }
+        finally {
+            sub?.remove();
+        }
+    }
+    async getVoices() {
+        return SUPERTONIC_VOICES;
+    }
+    async speak(text, options = {}) {
+        const voiceId = options.voice ?? DEFAULT_VOICE_ID;
+        if (!findVoice(voiceId))
+            throw new Error(`[ttskit] Unknown voice: ${voiceId}`);
+        const lang = resolveLang(options);
+        const id = newId();
+        const native = getNative();
+        const cleanText = stripProsody(text);
+        const subs = [];
+        if (options.onStart) {
+            subs.push(native.addListener('onSpeakStart', (e) => {
+                if (e.id === id)
+                    options.onStart?.();
+            }));
+        }
+        if (options.onDone) {
+            subs.push(native.addListener('onSpeakDone', (e) => {
+                if (e.id === id)
+                    options.onDone?.();
+            }));
+        }
+        try {
+            await native.speak(id, cleanText, voiceId, lang, options.totalStep ?? DEFAULT_TOTAL_STEP, options.rate ?? 1.05, options.volume ?? 1);
+        }
+        catch (err) {
+            options.onError?.(err);
+            throw err;
+        }
+        finally {
+            subs.forEach((s) => s.remove());
+        }
+    }
+    stream(text, options = {}) {
+        const voiceId = options.voice ?? DEFAULT_VOICE_ID;
+        if (!findVoice(voiceId))
+            throw new Error(`[ttskit] Unknown voice: ${voiceId}`);
+        const lang = resolveLang(options);
+        const id = newId();
+        const native = getNative();
+        const emitter = new BufferedStreamEmitter();
+        const cleanText = stripProsody(text);
+        let cleanedUp = false;
+        const chunkSub = native.addListener('onStreamChunk', (e) => {
+            if (e.id !== id)
+                return;
+            emitter.emitChunk(decodeBase64(e.pcm));
+        });
+        const endSub = native.addListener('onStreamEnd', (e) => {
+            if (e.id !== id)
+                return;
+            emitter.emitEnd();
+            cleanup();
+        });
+        const errSub = native.addListener('onStreamError', (e) => {
+            if (e.id !== id)
+                return;
+            emitter.emitError(new Error(e.message));
+            cleanup();
+        });
+        function cleanup() {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            chunkSub.remove();
+            endSub.remove();
+            errSub.remove();
+        }
+        native
+            .stream(id, cleanText, voiceId, lang, options.totalStep ?? DEFAULT_TOTAL_STEP, options.rate ?? 1.05, options.volume ?? 1)
+            .catch((err) => {
+            emitter.emitError(err);
+            cleanup();
+        });
+        const handle = {
+            id,
+            on(event, listener) {
+                // @ts-expect-error: emitter has overloaded signatures, runtime forwards correctly
+                emitter.on(event, listener);
+                return handle;
+            },
+            async cancel() {
+                cleanup();
+                await native.stop();
+            },
+        };
+        return handle;
+    }
+    async stop() {
+        await getNative().stop();
+    }
+    async clearCache() {
+        await getNative().clearCache();
+    }
+}
+//# sourceMappingURL=SupertonicEngine.js.map

package/build/engines/SupertonicEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupertonicEngine.js","sourceRoot":"","sources":["../../src/engines/SupertonicEngine.ts"],"names":[],"mappings":"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","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\nimport { Platform } from 'react-native';\n\nimport type {\n  EngineCapabilities,\n  EngineId,\n  PrefetchProgress,\n  SpeakOptions,\n  StreamHandle,\n  Voice,\n} from '../types';\n\n// iOS has CoreML/ANE fp16 acceleration; even an 8-step diffusion takes ~1s.\n// Android relies on NNAPI + commodity SoCs (e.g. Snapdragon 720G in mid-tier\n// phones) and tops out around 1-1.2s per diffusion step at fp32, so 8 steps\n// stretches synthesis to 10-14s. Supertonic-3 was trained for 2-8 step\n// inference; 6 steps is the quality/speed sweet spot on Android — audibly\n// closer to 8-step than to 4-step, while still ~25% faster than 8.\n// Callers can override per-call via SpeakOptions.totalStep.\nconst DEFAULT_TOTAL_STEP = Platform.OS === 'android' ? 6 : 8;\nimport { BufferedStreamEmitter } from './BufferedStreamEmitter';\nimport {\n  DEFAULT_LANGUAGE,\n  DEFAULT_VOICE_ID,\n  SUPERTONIC_LANGUAGES,\n  SUPERTONIC_VOICES,\n  findVoice,\n} from '../voices/catalog';\nimport { stripProsody } from '../voices/prosody';\nimport type { Engine } from './Engine';\n\ntype Subscription = { remove(): void };\ntype ChunkPayload = { id: string; pcm: string };\ntype IdPayload = { id: string };\ntype ErrorPayload = { id: string; message: string };\n\ninterface TTSKitNative {\n  isAvailable(): Promise<boolean>;\n  prefetch(): Promise<void>;\n  speak(\n    id: string,\n    text: string,\n    voiceId: string,\n    lang: string,\n    totalStep: number,\n    speed: number,\n    volume: number\n  ): Promise<void>;\n  stream(\n    id: string,\n    text: string,\n    voiceId: string,\n    lang: string,\n    totalStep: number,\n    speed: number,\n    volume: number\n  ): Promise<void>;\n  stop(): Promise<void>;\n  clearCache(): Promise<void>;\n  addListener(name: string, listener: (event: any) => void): Subscription;\n}\n\nlet nativeModule: TTSKitNative | null = null;\nfunction getNative(): TTSKitNative {\n  if (!nativeModule) {\n    nativeModule = requireNativeModule<TTSKitNative>('RNTTSKit');\n  }\n  return nativeModule;\n}\n\nlet counter = 0;\nconst newId = () => `op_${Date.now().toString(36)}_${(++counter).toString(36)}`;\n\nfunction decodeBase64(b64: string): Uint8Array {\n  if (typeof atob === 'function') {\n    const bin = atob(b64);\n    const out = new Uint8Array(bin.length);\n    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n    return out;\n  }\n  const lookup = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n  const cleaned = b64.replace(/=+$/, '');\n  const out = new Uint8Array((cleaned.length * 3) >> 2);\n  let o = 0;\n  for (let i = 0; i < cleaned.length; i += 4) {\n    const a = lookup.indexOf(cleaned[i]);\n    const b = lookup.indexOf(cleaned[i + 1]);\n    const c = lookup.indexOf(cleaned[i + 2] ?? 'A');\n    const d = lookup.indexOf(cleaned[i + 3] ?? 'A');\n    out[o++] = (a << 2) | (b >> 4);\n    if (cleaned[i + 2]) out[o++] = ((b & 15) << 4) | (c >> 2);\n    if (cleaned[i + 3]) out[o++] = ((c & 3) << 6) | d;\n  }\n  return out.subarray(0, o);\n}\n\n// BufferedStreamEmitter is exported from its own module so we can unit-test\n// it without needing the native module to load. See ./BufferedStreamEmitter.ts\n\nfunction resolveLang(options: SpeakOptions): string {\n  const lang = options.language ?? DEFAULT_LANGUAGE;\n  if (!SUPERTONIC_LANGUAGES.includes(lang)) {\n    throw new Error(`[ttskit] Unsupported language for Supertonic: ${lang}`);\n  }\n  return lang;\n}\n\nexport class SupertonicEngine implements Engine {\n  readonly id: EngineId = 'supertonic';\n  readonly capabilities: EngineCapabilities = {\n    streaming: true,\n    cloning: false,\n    emotionTags: false,\n    offline: true,\n    languages: [...SUPERTONIC_LANGUAGES],\n  };\n\n  async isAvailable(): Promise<boolean> {\n    try {\n      return await getNative().isAvailable();\n    } catch {\n      return false;\n    }\n  }\n\n  async prefetch(onProgress?: (p: PrefetchProgress) => void): Promise<void> {\n    const native = getNative();\n    const sub = onProgress\n      ? native.addListener('onPrefetchProgress', (e: PrefetchProgress) => onProgress(e))\n      : null;\n    try {\n      await native.prefetch();\n    } finally {\n      sub?.remove();\n    }\n  }\n\n  async getVoices(): Promise<Voice[]> {\n    return SUPERTONIC_VOICES;\n  }\n\n  async speak(text: string, options: SpeakOptions = {}): Promise<void> {\n    const voiceId = options.voice ?? DEFAULT_VOICE_ID;\n    if (!findVoice(voiceId)) throw new Error(`[ttskit] Unknown voice: ${voiceId}`);\n    const lang = resolveLang(options);\n    const id = newId();\n    const native = getNative();\n    const cleanText = stripProsody(text);\n\n    const subs: Subscription[] = [];\n    if (options.onStart) {\n      subs.push(native.addListener('onSpeakStart', (e: IdPayload) => {\n        if (e.id === id) options.onStart?.();\n      }));\n    }\n    if (options.onDone) {\n      subs.push(native.addListener('onSpeakDone', (e: IdPayload) => {\n        if (e.id === id) options.onDone?.();\n      }));\n    }\n    try {\n      await native.speak(\n        id,\n        cleanText,\n        voiceId,\n        lang,\n        options.totalStep ?? DEFAULT_TOTAL_STEP,\n        options.rate ?? 1.05,\n        options.volume ?? 1\n      );\n    } catch (err) {\n      options.onError?.(err as Error);\n      throw err;\n    } finally {\n      subs.forEach((s) => s.remove());\n    }\n  }\n\n  stream(text: string, options: SpeakOptions = {}): StreamHandle {\n    const voiceId = options.voice ?? DEFAULT_VOICE_ID;\n    if (!findVoice(voiceId)) throw new Error(`[ttskit] Unknown voice: ${voiceId}`);\n    const lang = resolveLang(options);\n\n    const id = newId();\n    const native = getNative();\n    const emitter = new BufferedStreamEmitter();\n    const cleanText = stripProsody(text);\n    let cleanedUp = false;\n\n    const chunkSub = native.addListener('onStreamChunk', (e: ChunkPayload) => {\n      if (e.id !== id) return;\n      emitter.emitChunk(decodeBase64(e.pcm));\n    });\n    const endSub = native.addListener('onStreamEnd', (e: IdPayload) => {\n      if (e.id !== id) return;\n      emitter.emitEnd();\n      cleanup();\n    });\n    const errSub = native.addListener('onStreamError', (e: ErrorPayload) => {\n      if (e.id !== id) return;\n      emitter.emitError(new Error(e.message));\n      cleanup();\n    });\n\n    function cleanup() {\n      if (cleanedUp) return;\n      cleanedUp = true;\n      chunkSub.remove();\n      endSub.remove();\n      errSub.remove();\n    }\n\n    native\n      .stream(\n        id,\n        cleanText,\n        voiceId,\n        lang,\n        options.totalStep ?? DEFAULT_TOTAL_STEP,\n        options.rate ?? 1.05,\n        options.volume ?? 1\n      )\n      .catch((err: Error) => {\n        emitter.emitError(err);\n        cleanup();\n      });\n\n    const handle: StreamHandle = {\n      id,\n      on(event: 'chunk' | 'end' | 'error', listener: (...args: any[]) => void) {\n        // @ts-expect-error: emitter has overloaded signatures, runtime forwards correctly\n        emitter.on(event, listener);\n        return handle;\n      },\n      async cancel() {\n        cleanup();\n        await native.stop();\n      },\n    };\n    return handle;\n  }\n\n  async stop(): Promise<void> {\n    await getNative().stop();\n  }\n\n  async clearCache(): Promise<void> {\n    await getNative().clearCache();\n  }\n}\n"]}

package/build/engines/SystemEngine.d.ts

@@ -0,0 +1,13 @@
+import type { EngineCapabilities, EngineId, PrefetchProgress, SpeakOptions, StreamHandle, Voice } from '../types';
+import type { Engine } from './Engine';
+export declare class SystemEngine implements Engine {
+    readonly id: EngineId;
+    readonly capabilities: EngineCapabilities;
+    isAvailable(): Promise<boolean>;
+    prefetch(_onProgress?: (p: PrefetchProgress) => void): Promise<void>;
+    getVoices(): Promise<Voice[]>;
+    speak(text: string, options?: SpeakOptions): Promise<void>;
+    stream(_text: string, _options?: SpeakOptions): StreamHandle;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=SystemEngine.d.ts.map

package/build/engines/SystemEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemEngine.d.ts","sourceRoot":"","sources":["../../src/engines/SystemEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,EACN,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAmBvC,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAY;IACjC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAMvC;IAEI,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAYnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,YAAiB,GAAG,YAAY;IAI1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/build/engines/SystemEngine.js

@@ -0,0 +1,78 @@
+let cached = null;
+function loadExpoSpeech() {
+    if (cached)
+        return cached;
+    try {
+        cached = require('expo-speech');
+        return cached;
+    }
+    catch {
+        return null;
+    }
+}
+export class SystemEngine {
+    id = 'system';
+    capabilities = {
+        streaming: false,
+        cloning: false,
+        emotionTags: false,
+        offline: true,
+        languages: ['*'],
+    };
+    async isAvailable() {
+        return loadExpoSpeech() !== null;
+    }
+    async prefetch(_onProgress) {
+        // No-op: system voices are bundled with the OS.
+    }
+    async getVoices() {
+        const speech = loadExpoSpeech();
+        if (!speech)
+            return [];
+        const voices = await speech.getAvailableVoicesAsync();
+        return voices.map((v) => ({
+            id: v.identifier,
+            name: v.name,
+            language: v.language,
+            engine: 'system',
+        }));
+    }
+    speak(text, options = {}) {
+        const speech = loadExpoSpeech();
+        if (!speech) {
+            throw new Error('[ttskit] expo-speech is not installed');
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                speech.speak(text, {
+                    voice: options.voice,
+                    language: options.language,
+                    rate: options.rate,
+                    pitch: options.pitch,
+                    volume: options.volume,
+                    onStart: options.onStart,
+                    onDone: () => {
+                        options.onDone?.();
+                        resolve();
+                    },
+                    onError: (err) => {
+                        options.onError?.(err);
+                        reject(err);
+                    },
+                    onStopped: () => resolve(),
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    stream(_text, _options = {}) {
+        throw new Error('[ttskit] System engine does not support streaming. Use engine: "supertonic".');
+    }
+    async stop() {
+        const speech = loadExpoSpeech();
+        await speech?.stop();
+    }
+}
+//# sourceMappingURL=SystemEngine.js.map

package/build/engines/SystemEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemEngine.js","sourceRoot":"","sources":["../../src/engines/SystemEngine.ts"],"names":[],"mappings":"AAgBA,IAAI,MAAM,GAA4B,IAAI,CAAC;AAC3C,SAAS,cAAc;IACrB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,aAAa,CAAqB,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,YAAY;IACd,EAAE,GAAa,QAAQ,CAAC;IACxB,YAAY,GAAuB;QAC1C,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC,GAAG,CAAC;KACjB,CAAC;IAEF,KAAK,CAAC,WAAW;QACf,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,WAA2C;QACxD,gDAAgD;IAClD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,CAAC,CAAC,UAAU;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,MAAM,EAAE,QAAoB;SAC7B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,UAAwB,EAAE;QAC5C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;oBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,MAAM,EAAE,GAAG,EAAE;wBACX,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;wBACnB,OAAO,EAAE,CAAC;oBACZ,CAAC;oBACD,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;wBACtB,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;wBACvB,MAAM,CAAC,GAAG,CAAC,CAAC;oBACd,CAAC;oBACD,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,WAAyB,EAAE;QAC/C,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import type {\n  EngineCapabilities,\n  EngineId,\n  PrefetchProgress,\n  SpeakOptions,\n  StreamHandle,\n  Voice,\n} from '../types';\nimport type { Engine } from './Engine';\n\ntype ExpoSpeechModule = {\n  speak(text: string, options?: any): void;\n  stop(): Promise<void>;\n  getAvailableVoicesAsync(): Promise<Array<{ identifier: string; name: string; language: string }>>;\n};\n\nlet cached: ExpoSpeechModule | null = null;\nfunction loadExpoSpeech(): ExpoSpeechModule | null {\n  if (cached) return cached;\n  try {\n    cached = require('expo-speech') as ExpoSpeechModule;\n    return cached;\n  } catch {\n    return null;\n  }\n}\n\nexport class SystemEngine implements Engine {\n  readonly id: EngineId = 'system';\n  readonly capabilities: EngineCapabilities = {\n    streaming: false,\n    cloning: false,\n    emotionTags: false,\n    offline: true,\n    languages: ['*'],\n  };\n\n  async isAvailable(): Promise<boolean> {\n    return loadExpoSpeech() !== null;\n  }\n\n  async prefetch(_onProgress?: (p: PrefetchProgress) => void): Promise<void> {\n    // No-op: system voices are bundled with the OS.\n  }\n\n  async getVoices(): Promise<Voice[]> {\n    const speech = loadExpoSpeech();\n    if (!speech) return [];\n    const voices = await speech.getAvailableVoicesAsync();\n    return voices.map((v) => ({\n      id: v.identifier,\n      name: v.name,\n      language: v.language,\n      engine: 'system' as EngineId,\n    }));\n  }\n\n  speak(text: string, options: SpeakOptions = {}): Promise<void> {\n    const speech = loadExpoSpeech();\n    if (!speech) {\n      throw new Error('[ttskit] expo-speech is not installed');\n    }\n    return new Promise((resolve, reject) => {\n      try {\n        speech.speak(text, {\n          voice: options.voice,\n          language: options.language,\n          rate: options.rate,\n          pitch: options.pitch,\n          volume: options.volume,\n          onStart: options.onStart,\n          onDone: () => {\n            options.onDone?.();\n            resolve();\n          },\n          onError: (err: Error) => {\n            options.onError?.(err);\n            reject(err);\n          },\n          onStopped: () => resolve(),\n        });\n      } catch (err) {\n        reject(err);\n      }\n    });\n  }\n\n  stream(_text: string, _options: SpeakOptions = {}): StreamHandle {\n    throw new Error('[ttskit] System engine does not support streaming. Use engine: \"supertonic\".');\n  }\n\n  async stop(): Promise<void> {\n    const speech = loadExpoSpeech();\n    await speech?.stop();\n  }\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,46 @@
+import type { Engine } from './engines/Engine';
+import type { ClonedVoice, CloneOptions, EngineId, PrefetchProgress, SpeakOptions, StreamHandle, Voice } from './types';
+export type { ClonedVoice, CloneOptions, EngineId, PrefetchProgress, SpeakOptions, StreamHandle, Voice, } from './types';
+export type { Engine } from './engines/Engine';
+export { parseProsody, stripProsody } from './voices/prosody';
+export { SUPERTONIC_VOICES, SUPERTONIC_LANGUAGES } from './voices/catalog';
+export declare const TTSKit: {
+    setEngine(id: EngineId): void;
+    getEngine(): EngineId;
+    registerEngine(engine: Engine): void;
+    /**
+     * Suggest a sensible engine for the current device.
+     *
+     * - On iOS, always returns `'supertonic'` — every iPhone with iOS 13+ has the
+     *   Neural Engine and runs neural TTS well (~1-2s TTFA).
+     * - On Android, returns `'supertonic'` for devices that report a recent SoC
+     *   with NNAPI 1.2+ acceleration, else `'system'`. The heuristic is
+     *   conservative: it errs toward `system` for any mid-range or older device
+     *   because Supertonic on a mid-range Snapdragon runs at ~0.5× realtime
+     *   (10s+ TTFA), which is worse UX than a robotic but instant system voice.
+     * - Defaults to `'supertonic'` on web / unknown platforms.
+     *
+     * This is opt-in. The library default is still Supertonic everywhere — apps
+     * that want graceful fallback should call this once at startup:
+     *
+     *     TTSKit.setEngine(TTSKit.recommendEngine());
+     *
+     * The detection is heuristic. For a hard guarantee, run a one-time benchmark
+     * (synthesize a known short input, measure TTFA, persist the result) and
+     * decide based on actual numbers — that's more accurate than any static
+     * device-tier list.
+     */
+    recommendEngine(): EngineId;
+    isAvailable(engineId?: EngineId): Promise<boolean>;
+    prefetchModel(onProgress?: (p: PrefetchProgress) => void, engineId?: EngineId): Promise<void>;
+    getVoices(engineId?: EngineId): Promise<Voice[]>;
+    speak(text: string, options?: SpeakOptions): Promise<void>;
+    stream(text: string, options?: SpeakOptions): StreamHandle;
+    stop(engineId?: EngineId): Promise<void>;
+    /** Delete locally cached model files so the next `prefetchModel()` re-downloads.
+     *  No-op for engines that don't have a cache (e.g. the system engine). */
+    clearCache(engineId?: EngineId): Promise<void>;
+    cloneVoice(options: CloneOptions, engineId?: EngineId): Promise<ClonedVoice>;
+};
+export default TTSKit;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,EACN,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,KAAK,GACN,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAgB3E,eAAO,MAAM,MAAM;kBACH,QAAQ,GAAG,IAAI;iBAOhB,QAAQ;2BAIE,MAAM,GAAG,IAAI;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;uBACgB,QAAQ;2BA8BE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;+BAKzC,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,aAC/B,QAAQ,GAClB,OAAO,CAAC,IAAI,CAAC;yBAIW,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;gBAIpC,MAAM,YAAW,YAAY,GAAQ,OAAO,CAAC,IAAI,CAAC;iBAIvD,MAAM,YAAW,YAAY,GAAQ,YAAY;oBAIxC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;8EAC0E;0BAC9C,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;wBAO1B,YAAY,aAAa,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;CAOnF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/build/index.js

@@ -0,0 +1,118 @@
+import { Platform } from 'react-native';
+import { SupertonicEngine } from './engines/SupertonicEngine';
+import { SystemEngine } from './engines/SystemEngine';
+export { parseProsody, stripProsody } from './voices/prosody';
+export { SUPERTONIC_VOICES, SUPERTONIC_LANGUAGES } from './voices/catalog';
+const engines = new Map();
+engines.set('supertonic', new SupertonicEngine());
+engines.set('system', new SystemEngine());
+let activeEngineId = 'supertonic';
+function getEngine(id = activeEngineId) {
+    const engine = engines.get(id);
+    if (!engine) {
+        throw new Error(`[ttskit] Engine "${id}" is not registered.`);
+    }
+    return engine;
+}
+export const TTSKit = {
+    setEngine(id) {
+        if (!engines.has(id)) {
+            throw new Error(`[ttskit] Engine "${id}" is not registered.`);
+        }
+        activeEngineId = id;
+    },
+    getEngine() {
+        return activeEngineId;
+    },
+    registerEngine(engine) {
+        engines.set(engine.id, engine);
+    },
+    /**
+     * Suggest a sensible engine for the current device.
+     *
+     * - On iOS, always returns `'supertonic'` — every iPhone with iOS 13+ has the
+     *   Neural Engine and runs neural TTS well (~1-2s TTFA).
+     * - On Android, returns `'supertonic'` for devices that report a recent SoC
+     *   with NNAPI 1.2+ acceleration, else `'system'`. The heuristic is
+     *   conservative: it errs toward `system` for any mid-range or older device
+     *   because Supertonic on a mid-range Snapdragon runs at ~0.5× realtime
+     *   (10s+ TTFA), which is worse UX than a robotic but instant system voice.
+     * - Defaults to `'supertonic'` on web / unknown platforms.
+     *
+     * This is opt-in. The library default is still Supertonic everywhere — apps
+     * that want graceful fallback should call this once at startup:
+     *
+     *     TTSKit.setEngine(TTSKit.recommendEngine());
+     *
+     * The detection is heuristic. For a hard guarantee, run a one-time benchmark
+     * (synthesize a known short input, measure TTFA, persist the result) and
+     * decide based on actual numbers — that's more accurate than any static
+     * device-tier list.
+     */
+    recommendEngine() {
+        if (Platform.OS === 'ios')
+            return 'supertonic';
+        if (Platform.OS !== 'android')
+            return 'supertonic';
+        // Android tier detection. We can't read SoC directly from JS, so we rely
+        // on what `Platform.constants` exposes: Brand, Manufacturer, Model.
+        // The check is "is this likely a flagship / recent device?" — keep it
+        // narrow and additive. Anything not on the allow-list falls back to system.
+        const c = Platform.constants ?? {};
+        const brand = String(c.Brand ?? '').toLowerCase();
+        const manufacturer = String(c.Manufacturer ?? '').toLowerCase();
+        const model = String(c.Model ?? '').toLowerCase();
+        const apiLevel = typeof c.Release === 'string' ? parseInt(c.Release, 10) : 0;
+        // Android 10 = API 29 = NNAPI 1.2 floor. Below this, NNAPI partitioning
+        // is poor enough that ORT often falls back to XNNPACK silently.
+        if (apiLevel && apiLevel < 10)
+            return 'system';
+        // Pixel 6 and newer have Tensor G1/G2/G3/G4 with a real NPU.
+        if (brand === 'google' && /pixel\s*([6-9]|1\d)/.test(model))
+            return 'supertonic';
+        // Samsung S22+ and Tab S8+ are Snapdragon 8 Gen 1 / Exynos 2200 floor.
+        if (manufacturer === 'samsung' && /sm-s9\d\d|sm-x[78]\d\d/i.test(model))
+            return 'supertonic';
+        // OnePlus 10 Pro+, current generation flagships are usually safe.
+        if (brand === 'oneplus' && /ne|le2\d\d\d/i.test(model))
+            return 'supertonic';
+        // Default for everything else (including the Galaxy A52 you tested on,
+        // which has SD720G and gets ~10s TTFA): use the system engine.
+        return 'system';
+    },
+    async isAvailable(engineId) {
+        return getEngine(engineId).isAvailable();
+    },
+    async prefetchModel(onProgress, engineId) {
+        return getEngine(engineId).prefetch(onProgress);
+    },
+    async getVoices(engineId) {
+        return getEngine(engineId).getVoices();
+    },
+    async speak(text, options = {}) {
+        return getEngine(options.engine).speak(text, options);
+    },
+    stream(text, options = {}) {
+        return getEngine(options.engine).stream(text, options);
+    },
+    async stop(engineId) {
+        return getEngine(engineId).stop();
+    },
+    /** Delete locally cached model files so the next `prefetchModel()` re-downloads.
+     *  No-op for engines that don't have a cache (e.g. the system engine). */
+    async clearCache(engineId) {
+        const engine = getEngine(engineId);
+        if (engine.clearCache) {
+            await engine.clearCache();
+        }
+    },
+    async cloneVoice(options, engineId) {
+        const engine = getEngine(engineId);
+        if (!engine.cloneVoice) {
+            throw new Error(`[ttskit] Engine "${engine.id}" does not support voice cloning.`);
+        }
+        return engine.cloneVoice(options);
+    },
+};
+export default TTSKit;
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\n\nimport { SupertonicEngine } from './engines/SupertonicEngine';\nimport { SystemEngine } from './engines/SystemEngine';\nimport type { Engine } from './engines/Engine';\nimport type {\n  ClonedVoice,\n  CloneOptions,\n  EngineId,\n  PrefetchProgress,\n  SpeakOptions,\n  StreamHandle,\n  Voice,\n} from './types';\n\nexport type {\n  ClonedVoice,\n  CloneOptions,\n  EngineId,\n  PrefetchProgress,\n  SpeakOptions,\n  StreamHandle,\n  Voice,\n} from './types';\nexport type { Engine } from './engines/Engine';\nexport { parseProsody, stripProsody } from './voices/prosody';\nexport { SUPERTONIC_VOICES, SUPERTONIC_LANGUAGES } from './voices/catalog';\n\nconst engines = new Map<EngineId, Engine>();\nengines.set('supertonic', new SupertonicEngine());\nengines.set('system', new SystemEngine());\n\nlet activeEngineId: EngineId = 'supertonic';\n\nfunction getEngine(id: EngineId = activeEngineId): Engine {\n  const engine = engines.get(id);\n  if (!engine) {\n    throw new Error(`[ttskit] Engine \"${id}\" is not registered.`);\n  }\n  return engine;\n}\n\nexport const TTSKit = {\n  setEngine(id: EngineId): void {\n    if (!engines.has(id)) {\n      throw new Error(`[ttskit] Engine \"${id}\" is not registered.`);\n    }\n    activeEngineId = id;\n  },\n\n  getEngine(): EngineId {\n    return activeEngineId;\n  },\n\n  registerEngine(engine: Engine): void {\n    engines.set(engine.id, engine);\n  },\n\n  /**\n   * Suggest a sensible engine for the current device.\n   *\n   * - On iOS, always returns `'supertonic'` — every iPhone with iOS 13+ has the\n   *   Neural Engine and runs neural TTS well (~1-2s TTFA).\n   * - On Android, returns `'supertonic'` for devices that report a recent SoC\n   *   with NNAPI 1.2+ acceleration, else `'system'`. The heuristic is\n   *   conservative: it errs toward `system` for any mid-range or older device\n   *   because Supertonic on a mid-range Snapdragon runs at ~0.5× realtime\n   *   (10s+ TTFA), which is worse UX than a robotic but instant system voice.\n   * - Defaults to `'supertonic'` on web / unknown platforms.\n   *\n   * This is opt-in. The library default is still Supertonic everywhere — apps\n   * that want graceful fallback should call this once at startup:\n   *\n   *     TTSKit.setEngine(TTSKit.recommendEngine());\n   *\n   * The detection is heuristic. For a hard guarantee, run a one-time benchmark\n   * (synthesize a known short input, measure TTFA, persist the result) and\n   * decide based on actual numbers — that's more accurate than any static\n   * device-tier list.\n   */\n  recommendEngine(): EngineId {\n    if (Platform.OS === 'ios') return 'supertonic';\n    if (Platform.OS !== 'android') return 'supertonic';\n\n    // Android tier detection. We can't read SoC directly from JS, so we rely\n    // on what `Platform.constants` exposes: Brand, Manufacturer, Model.\n    // The check is \"is this likely a flagship / recent device?\" — keep it\n    // narrow and additive. Anything not on the allow-list falls back to system.\n    const c: any = Platform.constants ?? {};\n    const brand = String(c.Brand ?? '').toLowerCase();\n    const manufacturer = String(c.Manufacturer ?? '').toLowerCase();\n    const model = String(c.Model ?? '').toLowerCase();\n    const apiLevel = typeof c.Release === 'string' ? parseInt(c.Release, 10) : 0;\n\n    // Android 10 = API 29 = NNAPI 1.2 floor. Below this, NNAPI partitioning\n    // is poor enough that ORT often falls back to XNNPACK silently.\n    if (apiLevel && apiLevel < 10) return 'system';\n\n    // Pixel 6 and newer have Tensor G1/G2/G3/G4 with a real NPU.\n    if (brand === 'google' && /pixel\\s*([6-9]|1\\d)/.test(model)) return 'supertonic';\n    // Samsung S22+ and Tab S8+ are Snapdragon 8 Gen 1 / Exynos 2200 floor.\n    if (manufacturer === 'samsung' && /sm-s9\\d\\d|sm-x[78]\\d\\d/i.test(model)) return 'supertonic';\n    // OnePlus 10 Pro+, current generation flagships are usually safe.\n    if (brand === 'oneplus' && /ne|le2\\d\\d\\d/i.test(model)) return 'supertonic';\n\n    // Default for everything else (including the Galaxy A52 you tested on,\n    // which has SD720G and gets ~10s TTFA): use the system engine.\n    return 'system';\n  },\n\n  async isAvailable(engineId?: EngineId): Promise<boolean> {\n    return getEngine(engineId).isAvailable();\n  },\n\n  async prefetchModel(\n    onProgress?: (p: PrefetchProgress) => void,\n    engineId?: EngineId\n  ): Promise<void> {\n    return getEngine(engineId).prefetch(onProgress);\n  },\n\n  async getVoices(engineId?: EngineId): Promise<Voice[]> {\n    return getEngine(engineId).getVoices();\n  },\n\n  async speak(text: string, options: SpeakOptions = {}): Promise<void> {\n    return getEngine(options.engine).speak(text, options);\n  },\n\n  stream(text: string, options: SpeakOptions = {}): StreamHandle {\n    return getEngine(options.engine).stream(text, options);\n  },\n\n  async stop(engineId?: EngineId): Promise<void> {\n    return getEngine(engineId).stop();\n  },\n\n  /** Delete locally cached model files so the next `prefetchModel()` re-downloads.\n   *  No-op for engines that don't have a cache (e.g. the system engine). */\n  async clearCache(engineId?: EngineId): Promise<void> {\n    const engine = getEngine(engineId);\n    if (engine.clearCache) {\n      await engine.clearCache();\n    }\n  },\n\n  async cloneVoice(options: CloneOptions, engineId?: EngineId): Promise<ClonedVoice> {\n    const engine = getEngine(engineId);\n    if (!engine.cloneVoice) {\n      throw new Error(`[ttskit] Engine \"${engine.id}\" does not support voice cloning.`);\n    }\n    return engine.cloneVoice(options);\n  },\n};\n\nexport default TTSKit;\n"]}

package/build/types.d.ts

@@ -0,0 +1,77 @@
+export type EngineId = 'supertonic' | 'system' | 'neutts' | 'cloud:eleven' | 'cloud:openai' | 'cloud:cartesia';
+export type SupertonicLang = 'en' | 'ko' | 'ja' | 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'es' | 'et' | 'fi' | 'fr' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'lt' | 'lv' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'tr' | 'uk' | 'vi';
+export interface Voice {
+    id: string;
+    name: string;
+    gender?: 'male' | 'female' | 'neutral';
+    engine: EngineId;
+    language?: string;
+    sampleUrl?: string;
+}
+/**
+ * Options for synthesis calls.
+ *
+ * **Privacy:** the text you pass to `speak()` / `stream()` is processed
+ * entirely on-device. It is never sent to a remote server when using the
+ * `supertonic` engine. The `system` engine forwards text to the OS-level
+ * TTS service (`expo-speech`), which on some platforms (notably some
+ * Android OEMs) may route through a cloud service — verify with the
+ * device vendor's privacy policy if that matters for your app.
+ */
+export interface SpeakOptions {
+    voice?: string;
+    engine?: EngineId;
+    /**
+     * BCP-47 language code passed to the model.
+     * Supertonic-3 supports 31 languages (see SupertonicLang); other engines may
+     * use this differently (system engine forwards it as-is to expo-speech).
+     */
+    language?: string;
+    /**
+     * Speech speed multiplier (default 1.05 — matches Supertonic upstream).
+     * Higher = faster.
+     */
+    rate?: number;
+    pitch?: number;
+    volume?: number;
+    /**
+     * Number of denoising steps for diffusion-based engines (Supertonic).
+     * Default 8. Lower = faster but lower quality.
+     */
+    totalStep?: number;
+    onStart?: () => void;
+    onDone?: () => void;
+    onError?: (err: Error) => void;
+}
+export interface StreamHandle {
+    id: string;
+    on(event: 'chunk', listener: (pcm: Uint8Array) => void): this;
+    on(event: 'end', listener: () => void): this;
+    on(event: 'error', listener: (err: Error) => void): this;
+    cancel(): Promise<void>;
+}
+export interface CloneOptions {
+    sampleUri: string;
+    name?: string;
+}
+export interface ClonedVoice {
+    id: string;
+    name: string;
+    engine: EngineId;
+}
+export interface PrefetchProgress {
+    bytesDownloaded: number;
+    totalBytes: number;
+    percent: number;
+}
+export interface EngineCapabilities {
+    streaming: boolean;
+    cloning: boolean;
+    emotionTags: boolean;
+    offline: boolean;
+    languages: string[];
+}
+export interface TTSKitError extends Error {
+    code: 'ENGINE_NOT_AVAILABLE' | 'VOICE_NOT_FOUND' | 'MODEL_NOT_LOADED' | 'SYNTHESIS_FAILED' | 'PERMISSION_DENIED' | 'NETWORK_ERROR' | 'CANCELLED';
+}
+//# 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":"AAAA,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE/G,MAAM,MAAM,cAAc,GACtB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACnE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACnE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/E,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,IAAI,EACA,sBAAsB,GACtB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,GACf,WAAW,CAAC;CACjB"}