v2.0.0 — multi-engine neural TTS platform

Changelog

2.0.0 — 2026-04-14

First release under @pocketpalai/react-native-speech. Transitions the
library from an OS-native TTS wrapper to a multi-engine on-device neural
TTS platform. Breaking vs. the @mhpdev/react-native-speech@1.x line.

Breaking

• Package renamed to @pocketpalai/react-native-speech. Android
  package: com.mhpdev.speech → com.pocketpalai.speech. JNI symbols,
  iOS bundle id, and os_log subsystem moved in lockstep.
• TTSEngineInterface is now generic (TTSEngineInterface<TConfig>).
  Each engine implements with its concrete config type. initialize
  signature changed from config?: any to config?: TConfig.
• Speech.initialize(config) takes a discriminated union
  SpeechInitConfig keyed on engine. [key: string]: any escape
  hatch removed.
• Pocket engine removed. Apps using engine: 'pocket' must migrate
  to another engine.
• src/NeuralAudioPlayer.ts renamed to src/NativeAudioPlayer.ts
  (Turbo Module shim). The orchestrator at
  src/engines/NeuralAudioPlayer.ts kept its name.
• src/types/react-native-fs.d.ts removed. Consumers that imported
  our parallel types should import from @dr.pogodin/react-native-fs
  directly.
• Per-engine class exports tagged @internal. KokoroEngine,
  SupertonicEngine, KittenEngine, OSEngine remain exported but
  their shape is no longer covered by the same semver guarantees as
  the default Speech API.

Added

• Neural TTS engines: Kokoro, Supertonic, Kitten. All run on
  onnxruntime-react-native (optional peer dep). On-device synthesis,
  no network I/O.
• Phonemization stack — dict+hans00 G2P pipeline. Library ships no
  data; consumer apps supply mmap EPD1 dicts via the NativeDict API.
  Default phonemizer is phonemize (MIT, hans00 G2P) requiring no dict.
• Native dict Turbo Module — cpp/native_dict.cpp mmap-backed
  parser hardened against untrusted input (overflow-safe bounds,
  post-open validation pass, madvise(MADV_RANDOM), fuzz harness at
  cpp/tests/fuzz_native_dict.cpp).
• onAudioInterruption JS event — surfaces iOS
  AVAudioSessionInterruptionNotification and Android
  AudioFocusManager transitions to JS. Pauses OS TTS and the neural
  audio player on focus loss.
• Chunked progress tracking — ChunkProgressEvent for per-sentence
  progress on neural engines.
• Benchmark infra — scripts/benchmark-*.sh, benchmarks/schema.json,
  benchmark-compare.py, extract-trace-table.py. Native tracing via
  os_signpost (iOS) and android.os.Trace.
• Cold-start instrumentation — each neural engine logs
  engine_init_ms=<n> on init success.
• docs/ARCHITECTURE.md, docs/LICENSES.md, MIGRATION.md,
  expanded docs/USAGE.md with per-engine quickstarts.
• Hermes-safe UTF-8 decoder (src/utils/utf8.ts) replaces
  TextDecoder which is unavailable on Hermes.

Fixed

• VoiceLoader.ts no longer crashes on Hermes (TextDecoder → manual
  UTF-8 decode, 8 unit tests).
• Native dict parser bounds checks are overflow-safe
  (off > size || len > size - off), post-open validation rejects
  malformed dicts, memcpy avoids alignment hazards.
• Android AudioFocusManager reacts to focus loss (pause, not just a
  boolean flip).
• iOS sets a default AVAudioSessionCategoryPlayback at init so
  interruption notifications fire reliably.
• Kitten ESPEAK_LANGUAGE constant renamed to PHONEMIZER_LANGUAGE;
  espeak-ng is no longer a dependency.

Removed

• third-party/phonemizer-dicts/ (TSV espeak-ng-derived, GPL risk in
  MIT repo; .bin lives in huggingface.co/datasets/palshub).
• Pocket engine (src/engines/pocket/, src/types/Pocket.ts, example
  PocketModelManager.ts).
• Dead src/engines/kokoro/utils/AssetLoader.ts.
• package-lock.json (yarn repo), benchmark-trace-table.csv, and
  three transient planning docs (KOKORO_REFACTORING_PLAN.md,
  SUPERTONIC_REFACTORING_PLAN.md, MLX_KOKORO_IMPLEMENTATION.md).

Internal

• Test coverage expanded from 6 suites / 255 tests to 9 suites / 294
  tests. Kitten, Supertonic, and Kokoro BPE now have unit tests.
• 65 console.* calls migrated to createComponentLogger with levels
  (debug gated behind __DEV__).
• Zero any in src/ (was 28).