expo-speech 9.2.0 → 10.0.2

package/build/Speech.types.d.ts

@@ -1,13 +1,39 @@
 export declare type SpeechEventCallback = (this: SpeechSynthesisUtterance, ev: SpeechSynthesisEvent) => any;
 export declare type SpeechOptions = {
+    /**
+     * The code of a language that should be used to read the `text`, refer to IETF BCP 47 to see
+     * valid codes.
+     */
     language?: string;
+    /**
+     * Pitch of the voice to speak `text`. `1.0` is the normal pitch.
+     */
     pitch?: number;
+    /**
+     * Rate of the voice to speak `text`. `1.0` is the normal rate.
+     */
     rate?: number;
+    /**
+     * A callback that is invoked when speaking starts.
+     */
     onStart?: () => void | SpeechEventCallback;
+    /**
+     * A callback that is invoked when speaking is stopped by calling `Speech.stop()`.
+     */
     onStopped?: () => void | SpeechEventCallback;
+    /**
+     * A callback that is invoked when speaking finishes.
+     */
     onDone?: () => void | SpeechEventCallback;
+    /**
+     * __(Android only).__ A callback that is invoked when an error occurred while speaking.
+     * @param error
+     */
     onError?: (error: Error) => void | SpeechEventCallback;
     volume?: number;
+    /**
+     * Voice identifier.
+     */
     voice?: string;
     _voiceIndex?: number;
     onBoundary?: SpeechEventCallback | null;
@@ -15,14 +41,32 @@ export declare type SpeechOptions = {
     onPause?: SpeechEventCallback | null;
     onResume?: SpeechEventCallback | null;
 };
+/**
+ * Enum representing the voice quality.
+ */
 export declare enum VoiceQuality {
     Default = "Default",
     Enhanced = "Enhanced"
 }
+/**
+ * Object describing the available voices on the device.
+ */
 export declare type Voice = {
+    /**
+     * Voice unique identifier.
+     */
     identifier: string;
+    /**
+     * Voice name.
+     */
     name: string;
+    /**
+     * Voice quality.
+     */
     quality: VoiceQuality;
+    /**
+     * Voice language.
+     */
     language: string;
 };
 export declare type WebVoice = Voice & {

package/build/Speech.types.js

@@ -1,3 +1,7 @@
+// @needsAudit
+/**
+ * Enum representing the voice quality.
+ */
 export var VoiceQuality;
 (function (VoiceQuality) {
     VoiceQuality["Default"] = "Default";

package/build/Speech.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Speech.types.js","sourceRoot":"","sources":["../src/Speech/Speech.types.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;AACvB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB","sourcesContent":["export type SpeechEventCallback = (this: SpeechSynthesisUtterance, ev: SpeechSynthesisEvent) => any;\n\nexport type SpeechOptions = {\n  language?: string;\n  pitch?: number;\n  rate?: number;\n  onStart?: () => void | SpeechEventCallback;\n  onStopped?: () => void | SpeechEventCallback;\n  onDone?: () => void | SpeechEventCallback;\n  onError?: (error: Error) => void | SpeechEventCallback;\n\n  volume?: number;\n  voice?: string;\n  _voiceIndex?: number;\n  onBoundary?: SpeechEventCallback | null;\n  onMark?: SpeechEventCallback | null;\n  onPause?: SpeechEventCallback | null;\n  onResume?: SpeechEventCallback | null;\n};\n\nexport enum VoiceQuality {\n  Default = 'Default',\n  Enhanced = 'Enhanced',\n}\n\nexport type Voice = {\n  identifier: string;\n  name: string;\n  quality: VoiceQuality;\n  language: string;\n};\n\nexport type WebVoice = Voice & {\n  isDefault: boolean;\n  localService: boolean;\n  name: string;\n  voiceURI: string;\n};\n"]}
+{"version":3,"file":"Speech.types.js","sourceRoot":"","sources":["../src/Speech/Speech.types.ts"],"names":[],"mappings":"AA8CA,cAAc;AACd;;GAEG;AACH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;AACvB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB","sourcesContent":["export type SpeechEventCallback = (this: SpeechSynthesisUtterance, ev: SpeechSynthesisEvent) => any;\n\n// @needsAudit @docsMissing\nexport type SpeechOptions = {\n  /**\n   * The code of a language that should be used to read the `text`, refer to IETF BCP 47 to see\n   * valid codes.\n   */\n  language?: string;\n  /**\n   * Pitch of the voice to speak `text`. `1.0` is the normal pitch.\n   */\n  pitch?: number;\n  /**\n   * Rate of the voice to speak `text`. `1.0` is the normal rate.\n   */\n  rate?: number;\n  /**\n   * A callback that is invoked when speaking starts.\n   */\n  onStart?: () => void | SpeechEventCallback;\n  /**\n   * A callback that is invoked when speaking is stopped by calling `Speech.stop()`.\n   */\n  onStopped?: () => void | SpeechEventCallback;\n  /**\n   * A callback that is invoked when speaking finishes.\n   */\n  onDone?: () => void | SpeechEventCallback;\n  /**\n   * __(Android only).__ A callback that is invoked when an error occurred while speaking.\n   * @param error\n   */\n  onError?: (error: Error) => void | SpeechEventCallback;\n  volume?: number;\n  /**\n   * Voice identifier.\n   */\n  voice?: string;\n  _voiceIndex?: number;\n  onBoundary?: SpeechEventCallback | null;\n  onMark?: SpeechEventCallback | null;\n  onPause?: SpeechEventCallback | null;\n  onResume?: SpeechEventCallback | null;\n};\n\n// @needsAudit\n/**\n * Enum representing the voice quality.\n */\nexport enum VoiceQuality {\n  Default = 'Default',\n  Enhanced = 'Enhanced',\n}\n\n// @needsAudit\n/**\n * Object describing the available voices on the device.\n */\nexport type Voice = {\n  /**\n   * Voice unique identifier.\n   */\n  identifier: string;\n  /**\n   * Voice name.\n   */\n  name: string;\n  /**\n   * Voice quality.\n   */\n  quality: VoiceQuality;\n  /**\n   * Voice language.\n   */\n  language: string;\n};\n\n// @docsMissing\nexport type WebVoice = Voice & {\n  isDefault: boolean;\n  localService: boolean;\n  name: string;\n  voiceURI: string;\n};\n"]}

package/ios/EXSpeech/EXSpeech.h

@@ -1,9 +1,9 @@
 // Copyright 2015-present 650 Industries. All rights reserved.
 
-#import <UMCore/UMExportedModule.h>
-#import <UMCore/UMModuleRegistryConsumer.h>
-#import <UMCore/UMEventEmitter.h>
+#import <ExpoModulesCore/EXExportedModule.h>
+#import <ExpoModulesCore/EXModuleRegistryConsumer.h>
+#import <ExpoModulesCore/EXEventEmitter.h>
 
-@interface EXSpeech : UMExportedModule <UMEventEmitter, UMModuleRegistryConsumer>
+@interface EXSpeech : EXExportedModule <EXEventEmitter, EXModuleRegistryConsumer>
 
 @end

package/ios/EXSpeech/EXSpeech.m

@@ -2,7 +2,7 @@
 
 #import <AVFoundation/AVFoundation.h>
 
-#import <UMCore/UMEventEmitterService.h>
+#import <ExpoModulesCore/EXEventEmitterService.h>
 #import <EXSpeech/EXSpeech.h>
 
 @interface EXSpeechUtteranceWithId : AVSpeechUtterance
@@ -32,15 +32,15 @@ static NSString *const INVALID_VOICE_ERROR_MSG = @"Cannot find voice with identi
 @interface EXSpeech () <AVSpeechSynthesizerDelegate>
 
 @property (nonatomic, strong) AVSpeechSynthesizer *synthesizer;
-@property (nonatomic, weak) UMModuleRegistry *moduleRegistry;
+@property (nonatomic, weak) EXModuleRegistry *moduleRegistry;
 
 @end
 
 @implementation EXSpeech
 
-UM_EXPORT_MODULE(ExponentSpeech)
+EX_EXPORT_MODULE(ExponentSpeech)
 
-- (void)setModuleRegistry:(UMModuleRegistry *)moduleRegistry
+- (void)setModuleRegistry:(EXModuleRegistry *)moduleRegistry
 {
   _moduleRegistry = moduleRegistry;
 }
@@ -61,7 +61,7 @@ UM_EXPORT_MODULE(ExponentSpeech)
 - (void)speechSynthesizer:(AVSpeechSynthesizer *)synthesizer
   didStartSpeechUtterance:(AVSpeechUtterance *)utterance
 {
-  id<UMEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(UMEventEmitterService)];
+  id<EXEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(EXEventEmitterService)];
   if (emitter != nil) {
     [emitter sendEventWithName:@"Exponent.speakingStarted" body:@{ @"id": ((EXSpeechUtteranceWithId *) utterance).utteranceId }];
   }
@@ -70,7 +70,7 @@ UM_EXPORT_MODULE(ExponentSpeech)
 - (void)speechSynthesizer:(AVSpeechSynthesizer *)synthesizer
  didCancelSpeechUtterance:(AVSpeechUtterance *)utterance
 {
-  id<UMEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(UMEventEmitterService)];
+  id<EXEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(EXEventEmitterService)];
   if (emitter != nil) {
     [emitter sendEventWithName:@"Exponent.speakingStopped" body:@{ @"id": ((EXSpeechUtteranceWithId *) utterance).utteranceId }];
   }
@@ -79,19 +79,19 @@ UM_EXPORT_MODULE(ExponentSpeech)
 - (void)speechSynthesizer:(AVSpeechSynthesizer *)synthesizer
  didFinishSpeechUtterance:(AVSpeechUtterance *)utterance
 {
-  id<UMEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(UMEventEmitterService)];
+  id<EXEventEmitterService> emitter = [_moduleRegistry getModuleImplementingProtocol:@protocol(EXEventEmitterService)];
   if (emitter != nil) {
     [emitter sendEventWithName:@"Exponent.speakingDone" body:@{ @"id": ((EXSpeechUtteranceWithId *) utterance).utteranceId }];
   }
 }
 
 
-UM_EXPORT_METHOD_AS(speak,
+EX_EXPORT_METHOD_AS(speak,
                     speak:(nonnull NSString *)utteranceId
                     text:(nonnull NSString *)text
                     options:(NSDictionary *)options
-                    resolver:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+                    resolver:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   if (_synthesizer == nil) {
     _synthesizer = [[AVSpeechSynthesizer alloc] init];
     _synthesizer.delegate = self;
@@ -125,9 +125,9 @@ UM_EXPORT_METHOD_AS(speak,
   resolve(nil);
 }
 
-UM_EXPORT_METHOD_AS(getVoices,
-                    getVoices:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+EX_EXPORT_METHOD_AS(getVoices,
+                    getVoices:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   NSArray<AVSpeechSynthesisVoice *> *availableVoices = [AVSpeechSynthesisVoice speechVoices];
   NSMutableArray<NSDictionary *> *availableVoicesResult = [NSMutableArray array];
   for (AVSpeechSynthesisVoice* voice in availableVoices) {
@@ -146,30 +146,30 @@ UM_EXPORT_METHOD_AS(getVoices,
   resolve([availableVoicesResult mutableCopy]);
 }
 
-UM_EXPORT_METHOD_AS(stop,
-                    stop:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+EX_EXPORT_METHOD_AS(stop,
+                    stop:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   [_synthesizer stopSpeakingAtBoundary:AVSpeechBoundaryImmediate];
   resolve(nil);
 }
 
-UM_EXPORT_METHOD_AS(pause,
-                    pause:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+EX_EXPORT_METHOD_AS(pause,
+                    pause:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   [_synthesizer pauseSpeakingAtBoundary:AVSpeechBoundaryImmediate];
   resolve(nil);
 }
 
-UM_EXPORT_METHOD_AS(resume,
-                    resume:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+EX_EXPORT_METHOD_AS(resume,
+                    resume:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   [_synthesizer continueSpeaking];
   resolve(nil);
 }
 
-UM_EXPORT_METHOD_AS(isSpeaking,
-                    isSpeaking:(UMPromiseResolveBlock)resolve
-                    rejecter:(UMPromiseRejectBlock)reject) {
+EX_EXPORT_METHOD_AS(isSpeaking,
+                    isSpeaking:(EXPromiseResolveBlock)resolve
+                    rejecter:(EXPromiseRejectBlock)reject) {
   resolve(@([_synthesizer isSpeaking]));
 }
 

package/ios/EXSpeech.podspec

@@ -10,10 +10,11 @@ Pod::Spec.new do |s|
   s.license        = package['license']
   s.author         = package['author']
   s.homepage       = package['homepage']
-  s.platform       = :ios, '11.0'
+  s.platform       = :ios, '12.0'
   s.source         = { git: 'https://github.com/expo/expo.git' }
+  s.static_framework = true
 
-  s.dependency 'UMCore'
+  s.dependency 'ExpoModulesCore'
 
   if !$ExpoUseSources&.include?(package['name']) && ENV['EXPO_USE_SOURCE'].to_i == 0 && File.exist?("#{s.name}.xcframework") && Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.10.0')
     s.source_files = "#{s.name}/**/*.h"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-speech",
-  "version": "9.2.0",
+  "version": "10.0.2",
   "description": "Provides text-to-speech functionality.",
   "main": "build/Speech.js",
   "types": "build/Speech.d.ts",
@@ -31,12 +31,15 @@
   },
   "author": "650 Industries, Inc.",
   "license": "MIT",
-  "homepage": "https://docs.expo.io/versions/latest/sdk/speech/",
+  "homepage": "https://docs.expo.dev/versions/latest/sdk/speech/",
   "jest": {
     "preset": "expo-module-scripts/ios"
   },
+  "dependencies": {
+    "expo-modules-core": "~0.4.3"
+  },
   "devDependencies": {
     "expo-module-scripts": "^2.0.0"
   },
-  "gitHead": "b33f5e224578564c3e4b1b467f258cc119b3b786"
+  "gitHead": "d23e1ac491da96b51c25eb2533efcd56499ee287"
 }

package/src/Speech/ExponentSpeech.ts

@@ -1,2 +1,2 @@
-import { NativeModulesProxy } from '@unimodules/core';
+import { NativeModulesProxy } from 'expo-modules-core';
 export default NativeModulesProxy.ExponentSpeech;

package/src/Speech/ExponentSpeech.web.ts

@@ -1,10 +1,28 @@
-import { SyntheticPlatformEmitter, CodedError } from '@unimodules/core';
+import { SyntheticPlatformEmitter, CodedError } from 'expo-modules-core';
 
 import { SpeechOptions, WebVoice, VoiceQuality } from './Speech.types';
 
 //https://developer.mozilla.org/en-US/docs/Web/API/SpeechSynthesisUtterance/text
 const MAX_SPEECH_INPUT_LENGTH = 32767;
 
+async function getVoices(): Promise<SpeechSynthesisVoice[]> {
+  return new Promise<SpeechSynthesisVoice[]>((resolve) => {
+    const voices = window.speechSynthesis.getVoices();
+
+    if (voices.length > 0) {
+      resolve(voices);
+      return;
+    }
+
+    // when a page loads it takes some amount of time to populate the voices list
+    // see https://stackoverflow.com/a/52005323/4337317
+    window.speechSynthesis.onvoiceschanged = function () {
+      const voices = window.speechSynthesis.getVoices();
+      resolve(voices);
+    };
+  });
+}
+
 export default {
   get name(): string {
     return 'ExponentSpeech';
@@ -32,9 +50,19 @@ export default {
       message.volume = options.volume;
     }
     if ('_voiceIndex' in options && options._voiceIndex != null) {
-      const voices = window.speechSynthesis.getVoices();
+      const voices = await getVoices();
       message.voice = voices[Math.min(voices.length - 1, Math.max(0, options._voiceIndex))];
     }
+    if (typeof options.voice === 'string') {
+      const voices = await getVoices();
+      message.voice =
+        voices[
+          Math.max(
+            0,
+            voices.findIndex((voice) => voice.voiceURI === options.voice)
+          )
+        ];
+    }
     if (typeof options.onResume === 'function') {
       message.onresume = options.onResume;
     }
@@ -64,9 +92,9 @@ export default {
 
     return message;
   },
-  getVoices(): WebVoice[] {
-    const voices = window.speechSynthesis.getVoices();
-    return voices.map(voice => ({
+  async getVoices(): Promise<WebVoice[]> {
+    const voices = await getVoices();
+    return voices.map((voice) => ({
       identifier: voice.voiceURI,
       quality: VoiceQuality.Default,
       isDefault: voice.default,

package/src/Speech/Speech.ts

@@ -1,12 +1,12 @@
-import { UnavailabilityError } from '@unimodules/core';
+import { UnavailabilityError } from 'expo-modules-core';
 import { NativeEventEmitter } from 'react-native';
 
 import ExponentSpeech from './ExponentSpeech';
-import { SpeechOptions, SpeechEventCallback, VoiceQuality, Voice } from './Speech.types';
+import { SpeechOptions, SpeechEventCallback, VoiceQuality, Voice, WebVoice } from './Speech.types';
 
 const SpeechEventEmitter = ExponentSpeech && new NativeEventEmitter(ExponentSpeech);
 
-export { SpeechOptions, SpeechEventCallback, VoiceQuality, Voice };
+export { SpeechOptions, SpeechEventCallback, VoiceQuality, Voice, WebVoice };
 
 const _CALLBACKS = {};
 let _nextCallbackId = 1;
@@ -57,6 +57,13 @@ function _registerListenersIfNeeded() {
   });
 }
 
+// @needsAudit
+/**
+ * Speak out loud the text given options. Calling this when another text is being spoken adds
+ * an utterance to queue.
+ * @param text The text to be spoken. Cannot be longer than [`Speech.maxSpeechInputLength`](#speechmaxspeechinputlength).
+ * @param options A `SpeechOptions` object.
+ */
 export function speak(text: string, options: SpeechOptions = {}) {
   const id = _nextCallbackId++;
   _CALLBACKS[id] = options;
@@ -64,6 +71,11 @@ export function speak(text: string, options: SpeechOptions = {}) {
   ExponentSpeech.speak(String(id), text, options);
 }
 
+// @needsAudit
+/**
+ * Returns list of all available voices.
+ * @return List of `Voice` objects.
+ */
 export async function getAvailableVoicesAsync(): Promise<Voice[]> {
   if (!ExponentSpeech.getVoices) {
     throw new UnavailabilityError('Speech', 'getVoices');
@@ -71,14 +83,28 @@ export async function getAvailableVoicesAsync(): Promise<Voice[]> {
   return ExponentSpeech.getVoices();
 }
 
+//@needsAudit
+/**
+ * Determine whether the Text-to-speech utility is currently speaking. Will return `true` if speaker
+ * is paused.
+ * @return Returns a Promise that fulfils with a boolean, `true` if speaking, `false` if not.
+ */
 export async function isSpeakingAsync(): Promise<boolean> {
   return ExponentSpeech.isSpeaking();
 }
 
+// @needsAudit
+/**
+ * Interrupts current speech and deletes all in queue.
+ */
 export async function stop(): Promise<void> {
   return ExponentSpeech.stop();
 }
 
+// @needsAudit
+/**
+ * Pauses current speech. This method is not available on Android.
+ */
 export async function pause(): Promise<void> {
   if (!ExponentSpeech.pause) {
     throw new UnavailabilityError('Speech', 'pause');
@@ -86,6 +112,11 @@ export async function pause(): Promise<void> {
   return ExponentSpeech.pause();
 }
 
+// @needsAudit
+/**
+ * Resumes speaking previously paused speech or does nothing if there's none. This method is not
+ * available on Android.
+ */
 export async function resume(): Promise<void> {
   if (!ExponentSpeech.resume) {
     throw new UnavailabilityError('Speech', 'resume');
@@ -95,7 +126,13 @@ export async function resume(): Promise<void> {
 }
 
 function setSpeakingListener(eventName, callback) {
-  if (SpeechEventEmitter.listeners(eventName).length > 0) {
+  // @ts-ignore: the EventEmitter interface has been changed in react-native@0.64.0
+  const listenerCount = SpeechEventEmitter.listenerCount
+    ? // @ts-ignore: this is available since 0.64
+      SpeechEventEmitter.listenerCount(eventName)
+    : // @ts-ignore: this is available in older versions
+      SpeechEventEmitter.listeners(eventName).length;
+  if (listenerCount > 0) {
     SpeechEventEmitter.removeAllListeners(eventName);
   }
   SpeechEventEmitter.addListener(eventName, callback);
@@ -105,4 +142,9 @@ function removeSpeakingListener(eventName) {
   SpeechEventEmitter.removeAllListeners(eventName);
 }
 
+// @needsAudit
+/**
+ * Maximum possible text length acceptable by `Speech.speak()` method. It is platform-dependent.
+ * On iOS, this returns `Number.MAX_VALUE`.
+ */
 export const maxSpeechInputLength: number = ExponentSpeech.maxSpeechInputLength || Number.MAX_VALUE;

package/src/Speech/Speech.types.ts

@@ -1,15 +1,41 @@
 export type SpeechEventCallback = (this: SpeechSynthesisUtterance, ev: SpeechSynthesisEvent) => any;
 
+// @needsAudit @docsMissing
 export type SpeechOptions = {
+  /**
+   * The code of a language that should be used to read the `text`, refer to IETF BCP 47 to see
+   * valid codes.
+   */
   language?: string;
+  /**
+   * Pitch of the voice to speak `text`. `1.0` is the normal pitch.
+   */
   pitch?: number;
+  /**
+   * Rate of the voice to speak `text`. `1.0` is the normal rate.
+   */
   rate?: number;
+  /**
+   * A callback that is invoked when speaking starts.
+   */
   onStart?: () => void | SpeechEventCallback;
+  /**
+   * A callback that is invoked when speaking is stopped by calling `Speech.stop()`.
+   */
   onStopped?: () => void | SpeechEventCallback;
+  /**
+   * A callback that is invoked when speaking finishes.
+   */
   onDone?: () => void | SpeechEventCallback;
+  /**
+   * __(Android only).__ A callback that is invoked when an error occurred while speaking.
+   * @param error
+   */
   onError?: (error: Error) => void | SpeechEventCallback;
-
   volume?: number;
+  /**
+   * Voice identifier.
+   */
   voice?: string;
   _voiceIndex?: number;
   onBoundary?: SpeechEventCallback | null;
@@ -18,18 +44,39 @@ export type SpeechOptions = {
   onResume?: SpeechEventCallback | null;
 };
 
+// @needsAudit
+/**
+ * Enum representing the voice quality.
+ */
 export enum VoiceQuality {
   Default = 'Default',
   Enhanced = 'Enhanced',
 }
 
+// @needsAudit
+/**
+ * Object describing the available voices on the device.
+ */
 export type Voice = {
+  /**
+   * Voice unique identifier.
+   */
   identifier: string;
+  /**
+   * Voice name.
+   */
   name: string;
+  /**
+   * Voice quality.
+   */
   quality: VoiceQuality;
+  /**
+   * Voice language.
+   */
   language: string;
 };
 
+// @docsMissing
 export type WebVoice = Voice & {
   isDefault: boolean;
   localService: boolean;

package/android/src/main/java/expo/modules/speech/LanguageUtils.java

@@ -1,48 +0,0 @@
-package expo.modules.speech;
-
-import java.util.HashMap;
-import java.util.Locale;
-import java.util.Map;
-
-// Lazy load the ISO codes into a Map then transform the codes to match other localization patterns in Expo
-public class LanguageUtils {
-
-  private static Map<String, Locale> countryISOCodes;
-
-  private static Map<String, Locale> languageISOCodes;
-
-  private static String transformCountryISO(String code) {
-    if (countryISOCodes == null) {
-      String[] countries = Locale.getISOCountries();
-      countryISOCodes = new HashMap<>(countries.length);
-      for (String country : countries) {
-        Locale locale = new Locale("", country);
-        countryISOCodes.put(locale.getISO3Country().toUpperCase(), locale);
-      }
-    }
-    return countryISOCodes.get(code).getCountry();
-  }
-
-  private static String transformLanguageISO(String code) {
-    if (languageISOCodes == null) {
-      String[] languages = Locale.getISOLanguages();
-      languageISOCodes = new HashMap<>(languages.length);
-      for (String language : languages) {
-        Locale locale = new Locale(language);
-        languageISOCodes.put(locale.getISO3Language(), locale);
-      }
-    }
-    return languageISOCodes.get(code).getLanguage();
-  }
-
-  static String getISOCode(Locale locale) {
-    String language = transformLanguageISO(locale.getISO3Language());
-    String country = locale.getISO3Country();
-    if (!country.equals("")) {
-      String countryCode = transformCountryISO(country);
-      language += "-" + countryCode;
-    }
-    return language;
-  }
-}
-