@symbiote-native/speech 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @symbiote-native/speech
+
+Read text aloud with the device's text-to-speech engine, with a choice of voice, language, pitch and
+rate. One API for every [SymbioteNative](../../README.md) adapter (React, Vue, Svelte, Solid and
+Angular).
+
+It wraps [`expo-speech`](https://github.com/expo/expo/tree/main/packages/expo-speech) the same way
+[`@symbiote-native/print`](../print) wraps its upstream: `expo-modules-core` is a direct
+dependency and the upstream JS is hand-ported into `core/`. See the `symbiote-expo-native-module`
+project skill for the full mechanism.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --speech
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --speech
+```
+
+Either way: installs `@symbiote-native/speech` and wires the native autolinking automatically -
+see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/speech
+```
+
+`expo-speech` and `expo-modules-core` come along as regular, pinned dependencies - never install
+either yourself, and never add the `expo` meta-package to this project.
+
+### Required one-time step: native autolinking wiring
+
+Same one-time app wiring every `expo-modules-core` package shares - see
+[`@symbiote-native/print`'s README](../print/README.md#required-one-time-step-native-autolinking-wiring)
+for the full table; nothing package-specific here.
+
+### No app-level permission, no config plugin
+
+- **No runtime permission request from this package.** Android needs a `<queries>` entry
+  declaring the `android.intent.action.TTS_SERVICE` intent to see installed TTS engines on
+  API 30+ - `expo-speech`'s own bundled `AndroidManifest.xml` already carries it, and Android's
+  manifest merger folds it into the app automatically. No `native-link.json` entry exists for
+  this (there is no such field, and none is needed).
+- **No config plugin.** Upstream ships none.
+
+</details>
+
+## Shape
+
+```
+src/core/                 the whole API: speak, getAvailableVoicesAsync, isSpeakingAsync, stop,
+                          pause, resume, maxSpeechInputLength, VoiceQuality. native-module.ts
+                          resolves ExpoSpeech through expo-modules-core's requireNativeModule.
+src/angular/              @symbiote-native/speech/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/` -
+every export here is a stateless function or constant, nothing to wrap in a hook/composable.
+
+## Use it
+
+```ts
+import { speak, stop, isSpeakingAsync } from '@symbiote-native/speech';
+
+speak('Hello world', {
+  language: 'en-US',
+  onDone: () => console.log('done'),
+});
+
+if (await isSpeakingAsync()) {
+  await stop();
+}
+```
+
+## API
+
+| Export                    | Signature                                              | Notes                                        |
+| -------------------------- | -------------------------------------------------------- | ----------------------------------------------- |
+| `speak`                   | `(text: string, options?: ISpeechOptions) => void`        | Queues onto any in-flight utterance.           |
+| `getAvailableVoicesAsync`  | `() => Promise<IVoice[]>`                                 | Throws `UnavailabilityError` if unsupported.   |
+| `isSpeakingAsync`         | `() => Promise<boolean>`                                  | `true` even while paused.                      |
+| `stop`                    | `() => Promise<void>`                                     | Interrupts and clears the whole queue.         |
+| `pause` / `resume`        | `() => Promise<void>`                                     | iOS only - throws `UnavailabilityError` on Android. |
+| `maxSpeechInputLength`    | `number`                                                  | `Number.MAX_VALUE` on iOS.                     |
+| `VoiceQuality`            | `{ Default, Enhanced }`                                   | Enum on `IVoice.quality`.                      |
+
+## Notes
+
+- **No sound in iOS silent mode.** On a physical iPhone `speak` is silent while the device is in
+  silent mode, so it can look like the call did nothing.
+- **`speak` queues, it does not interrupt.** Call `stop()` first to replace what is being said.
+- **Android rejects text longer than `maxSpeechInputLength`.** Split long text into sentences and
+  queue them.
+- **Web-only fields dropped.** Upstream's `Speech.types.ts` also carries `WebVoice`,
+  `SpeechEventCallback` (a raw DOM `SpeechSynthesisEvent` callback shape), `_voiceIndex`, and
+  `onMark`/`onPause`/`onResume` - all reachable only through `expo-speech`'s separate web
+  implementation. This package only wraps the apple/android native modules (`expo-speech`'s own
+  `expo-module.config.json` lists no `"web"` platform either), so none of it applies here.
+
+## Common questions
+
+- **No sound on iOS.** Check silent mode first (a physical iPhone is silent then).
+- **`voice` ignored, short voice list.** Pass an `identifier` from `getAvailableVoicesAsync()`
+  exactly; the voices installed differ by device and iOS version.
+- **Non-English speech wrong on Android.** Set `language` to a BCP 47 code and install that voice in
+  the device's text-to-speech settings.
+- **`onDone` missing after pause/resume.** Pause reports `onStopped`; track state yourself.
+- **Long text rejected.** Android limits input to `maxSpeechInputLength`; queue sentences.
+
+Sources: [Expo docs: Speech](https://docs.expo.dev/versions/latest/sdk/speech/),
+[expo/expo#10827](https://github.com/expo/expo/issues/10827),
+[expo/expo#12654](https://github.com/expo/expo/issues/12654),
+[expo/expo#7260](https://github.com/expo/expo/issues/7260).
+
+## Test it
+
+```bash
+pnpm vitest run packages/speech
+```
+
+Upstream ships no test suite of its own (`expo-speech`'s `src/` has no `__tests__`), so nothing to
+port - every test here is net-new coverage of the ported logic (the callback registry, per-id
+event routing, the listen/unlisten toggle, and every `UnavailabilityError` branch).

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service - plain re-export.
+export * from '../core/index.js';

package/build/core/index.d.ts

@@ -0,0 +1,3 @@
+export { getAvailableVoicesAsync, isSpeakingAsync, maxSpeechInputLength, pause, resume, speak, stop, } from './speech';
+export { VoiceQuality } from './types';
+export type { INativeBoundaryEvent, INativeBoundaryEventCallback, ISpeechOptions, IVoice, } from './types';

package/build/core/index.js

@@ -0,0 +1,2 @@
+export { getAvailableVoicesAsync, isSpeakingAsync, maxSpeechInputLength, pause, resume, speak, stop, } from './speech.js';
+export { VoiceQuality } from './types.js';

package/build/core/native-module.d.ts

@@ -0,0 +1,31 @@
+import { NativeModule } from 'expo-modules-core';
+import type { ISpeechOptions, IVoice } from './types';
+type ISpeechEventParams = {
+    id: string;
+};
+export type ISpeechEventsMap = {
+    'Exponent.speakingStarted': (params: ISpeechEventParams) => void;
+    'Exponent.speakingWillSayNextString': (params: ISpeechEventParams & {
+        charIndex: number;
+        charLength: number;
+    }) => void;
+    'Exponent.speakingDone': (params: ISpeechEventParams) => void;
+    'Exponent.speakingStopped': (params: ISpeechEventParams) => void;
+    /** Android only supplies `error`; iOS never emits this event at all. */
+    'Exponent.speakingError': (params: ISpeechEventParams & {
+        error?: string;
+    }) => void;
+};
+export declare class NativeSpeechModule extends NativeModule<ISpeechEventsMap> {
+    maxSpeechInputLength?: number;
+    speak(utteranceId: string, text: string, options: ISpeechOptions): Promise<void>;
+    getVoices?(): Promise<IVoice[]>;
+    isSpeaking(): Promise<boolean>;
+    stop(): Promise<void>;
+    /** iOS only; absent on Android's native module. */
+    pause?(): Promise<void>;
+    /** iOS only; absent on Android's native module. */
+    resume?(): Promise<void>;
+}
+export declare const expoSpeech: NativeSpeechModule;
+export {};

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { NativeModule, requireNativeModule } from 'expo-modules-core';
+const EXPO_SPEECH_MODULE_NAME = 'ExpoSpeech';
+export const expoSpeech = requireNativeModule(EXPO_SPEECH_MODULE_NAME);

package/build/core/speech.d.ts

@@ -0,0 +1,14 @@
+import type { ISpeechOptions, IVoice } from './types';
+/** Adds `text` to the speech queue. Calling this while another utterance is speaking queues it. */
+export declare function speak(text: string, options?: ISpeechOptions): void;
+export declare function getAvailableVoicesAsync(): Promise<IVoice[]>;
+/** `true` even while paused. */
+export declare function isSpeakingAsync(): Promise<boolean>;
+/** Interrupts current speech and clears the queue. */
+export declare function stop(): Promise<void>;
+/** iOS only; throws `UnavailabilityError` on Android. */
+export declare function pause(): Promise<void>;
+/** iOS only; throws `UnavailabilityError` on Android. */
+export declare function resume(): Promise<void>;
+/** Platform-dependent; iOS returns `Number.MAX_VALUE`. */
+export declare const maxSpeechInputLength: number;

package/build/core/speech.js

@@ -0,0 +1,90 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoSpeech } from './native-module.js';
+const callbacksById = {};
+let nextCallbackId = 1;
+let hasRegisteredListeners = false;
+function makeCallbackId() {
+    return String(nextCallbackId++);
+}
+function unregisterListenersIfNoneNeeded() {
+    if (Object.keys(callbacksById).length > 0)
+        return;
+    removeSpeakingListener('Exponent.speakingStarted');
+    removeSpeakingListener('Exponent.speakingWillSayNextString');
+    removeSpeakingListener('Exponent.speakingDone');
+    removeSpeakingListener('Exponent.speakingStopped');
+    removeSpeakingListener('Exponent.speakingError');
+    hasRegisteredListeners = false;
+}
+function registerListenersIfNeeded() {
+    if (hasRegisteredListeners)
+        return;
+    hasRegisteredListeners = true;
+    setSpeakingListener('Exponent.speakingStarted', ({ id }) => {
+        callbacksById[id]?.onStart?.();
+    });
+    setSpeakingListener('Exponent.speakingWillSayNextString', ({ id, charIndex, charLength }) => {
+        callbacksById[id]?.onBoundary?.({ charIndex, charLength });
+    });
+    setSpeakingListener('Exponent.speakingDone', ({ id }) => {
+        callbacksById[id]?.onDone?.();
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+    setSpeakingListener('Exponent.speakingStopped', ({ id }) => {
+        callbacksById[id]?.onStopped?.();
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+    setSpeakingListener('Exponent.speakingError', ({ id, error }) => {
+        callbacksById[id]?.onError?.(new Error(error));
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+}
+function setSpeakingListener(eventName, listener) {
+    if (expoSpeech.listenerCount(eventName) > 0) {
+        expoSpeech.removeAllListeners(eventName);
+    }
+    expoSpeech.addListener(eventName, listener);
+}
+function removeSpeakingListener(eventName) {
+    expoSpeech.removeAllListeners(eventName);
+}
+/** Adds `text` to the speech queue. Calling this while another utterance is speaking queues it. */
+export function speak(text, options = {}) {
+    const id = makeCallbackId();
+    callbacksById[id] = options;
+    registerListenersIfNeeded();
+    expoSpeech.speak(id, text, options);
+}
+export async function getAvailableVoicesAsync() {
+    if (!expoSpeech.getVoices) {
+        throw new UnavailabilityError('Speech', 'getVoices');
+    }
+    return expoSpeech.getVoices();
+}
+/** `true` even while paused. */
+export async function isSpeakingAsync() {
+    return expoSpeech.isSpeaking();
+}
+/** Interrupts current speech and clears the queue. */
+export async function stop() {
+    return expoSpeech.stop();
+}
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function pause() {
+    if (!expoSpeech.pause) {
+        throw new UnavailabilityError('Speech', 'pause');
+    }
+    return expoSpeech.pause();
+}
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function resume() {
+    if (!expoSpeech.resume) {
+        throw new UnavailabilityError('Speech', 'resume');
+    }
+    return expoSpeech.resume();
+}
+/** Platform-dependent; iOS returns `Number.MAX_VALUE`. */
+export const maxSpeechInputLength = expoSpeech.maxSpeechInputLength ?? Number.MAX_VALUE;

package/build/core/types.d.ts

@@ -0,0 +1,34 @@
+export declare enum VoiceQuality {
+    Default = "Default",
+    Enhanced = "Enhanced"
+}
+export type IVoice = {
+    identifier: string;
+    name: string;
+    quality: VoiceQuality;
+    language: string;
+};
+export type INativeBoundaryEvent = {
+    charIndex: number;
+    charLength: number;
+};
+export type INativeBoundaryEventCallback = (event: INativeBoundaryEvent) => void;
+export type ISpeechOptions = {
+    /** IETF BCP 47 language code. */
+    language?: string;
+    /** `1.0` is the normal pitch. */
+    pitch?: number;
+    /** `1.0` is the normal rate. */
+    rate?: number;
+    /** iOS only — `false` lets the system manage a separate audio session for the speech. */
+    useApplicationAudioSession?: boolean;
+    onStart?: () => void;
+    /** Invoked when speaking is stopped by calling `stop()`. */
+    onStopped?: () => void;
+    onDone?: () => void;
+    onError?: (error: Error) => void;
+    /** `0.0` (muted) to `1.0` (max volume). Default `1.0`. */
+    volume?: number;
+    voice?: string;
+    onBoundary?: INativeBoundaryEventCallback | null;
+};

package/build/core/types.js

@@ -0,0 +1,5 @@
+export var VoiceQuality;
+(function (VoiceQuality) {
+    VoiceQuality["Default"] = "Default";
+    VoiceQuality["Enhanced"] = "Enhanced";
+})(VoiceQuality || (VoiceQuality = {}));

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service - plain re-export.
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,SAAS,CAAC"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,3 @@
+export { getAvailableVoicesAsync, isSpeakingAsync, maxSpeechInputLength, pause, resume, speak, stop, } from './speech';
+export { VoiceQuality } from './types';
+export type { INativeBoundaryEvent, INativeBoundaryEventCallback, ISpeechOptions, IVoice, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { getAvailableVoicesAsync, isSpeakingAsync, maxSpeechInputLength, pause, resume, speak, stop, } from './speech';
+export { VoiceQuality } from './types';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,MAAM,EACN,KAAK,EACL,IAAI,GACL,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,31 @@
+import { NativeModule } from 'expo-modules-core';
+import type { ISpeechOptions, IVoice } from './types';
+type ISpeechEventParams = {
+    id: string;
+};
+export type ISpeechEventsMap = {
+    'Exponent.speakingStarted': (params: ISpeechEventParams) => void;
+    'Exponent.speakingWillSayNextString': (params: ISpeechEventParams & {
+        charIndex: number;
+        charLength: number;
+    }) => void;
+    'Exponent.speakingDone': (params: ISpeechEventParams) => void;
+    'Exponent.speakingStopped': (params: ISpeechEventParams) => void;
+    /** Android only supplies `error`; iOS never emits this event at all. */
+    'Exponent.speakingError': (params: ISpeechEventParams & {
+        error?: string;
+    }) => void;
+};
+export declare class NativeSpeechModule extends NativeModule<ISpeechEventsMap> {
+    maxSpeechInputLength?: number;
+    speak(utteranceId: string, text: string, options: ISpeechOptions): Promise<void>;
+    getVoices?(): Promise<IVoice[]>;
+    isSpeaking(): Promise<boolean>;
+    stop(): Promise<void>;
+    /** iOS only; absent on Android's native module. */
+    pause?(): Promise<void>;
+    /** iOS only; absent on Android's native module. */
+    resume?(): Promise<void>;
+}
+export declare const expoSpeech: NativeSpeechModule;
+export {};

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { NativeModule, requireNativeModule } from 'expo-modules-core';
+const EXPO_SPEECH_MODULE_NAME = 'ExpoSpeech';
+export const expoSpeech = requireNativeModule(EXPO_SPEECH_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAiC7C,MAAM,CAAC,MAAM,UAAU,GAAG,mBAAmB,CAC3C,uBAAuB,CACxB,CAAC"}

package/build-ngc/core/speech.d.ts

@@ -0,0 +1,14 @@
+import type { ISpeechOptions, IVoice } from './types';
+/** Adds `text` to the speech queue. Calling this while another utterance is speaking queues it. */
+export declare function speak(text: string, options?: ISpeechOptions): void;
+export declare function getAvailableVoicesAsync(): Promise<IVoice[]>;
+/** `true` even while paused. */
+export declare function isSpeakingAsync(): Promise<boolean>;
+/** Interrupts current speech and clears the queue. */
+export declare function stop(): Promise<void>;
+/** iOS only; throws `UnavailabilityError` on Android. */
+export declare function pause(): Promise<void>;
+/** iOS only; throws `UnavailabilityError` on Android. */
+export declare function resume(): Promise<void>;
+/** Platform-dependent; iOS returns `Number.MAX_VALUE`. */
+export declare const maxSpeechInputLength: number;

package/build-ngc/core/speech.js

@@ -0,0 +1,91 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoSpeech } from './native-module';
+const callbacksById = {};
+let nextCallbackId = 1;
+let hasRegisteredListeners = false;
+function makeCallbackId() {
+    return String(nextCallbackId++);
+}
+function unregisterListenersIfNoneNeeded() {
+    if (Object.keys(callbacksById).length > 0)
+        return;
+    removeSpeakingListener('Exponent.speakingStarted');
+    removeSpeakingListener('Exponent.speakingWillSayNextString');
+    removeSpeakingListener('Exponent.speakingDone');
+    removeSpeakingListener('Exponent.speakingStopped');
+    removeSpeakingListener('Exponent.speakingError');
+    hasRegisteredListeners = false;
+}
+function registerListenersIfNeeded() {
+    if (hasRegisteredListeners)
+        return;
+    hasRegisteredListeners = true;
+    setSpeakingListener('Exponent.speakingStarted', ({ id }) => {
+        callbacksById[id]?.onStart?.();
+    });
+    setSpeakingListener('Exponent.speakingWillSayNextString', ({ id, charIndex, charLength }) => {
+        callbacksById[id]?.onBoundary?.({ charIndex, charLength });
+    });
+    setSpeakingListener('Exponent.speakingDone', ({ id }) => {
+        callbacksById[id]?.onDone?.();
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+    setSpeakingListener('Exponent.speakingStopped', ({ id }) => {
+        callbacksById[id]?.onStopped?.();
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+    setSpeakingListener('Exponent.speakingError', ({ id, error }) => {
+        callbacksById[id]?.onError?.(new Error(error));
+        delete callbacksById[id];
+        unregisterListenersIfNoneNeeded();
+    });
+}
+function setSpeakingListener(eventName, listener) {
+    if (expoSpeech.listenerCount(eventName) > 0) {
+        expoSpeech.removeAllListeners(eventName);
+    }
+    expoSpeech.addListener(eventName, listener);
+}
+function removeSpeakingListener(eventName) {
+    expoSpeech.removeAllListeners(eventName);
+}
+/** Adds `text` to the speech queue. Calling this while another utterance is speaking queues it. */
+export function speak(text, options = {}) {
+    const id = makeCallbackId();
+    callbacksById[id] = options;
+    registerListenersIfNeeded();
+    expoSpeech.speak(id, text, options);
+}
+export async function getAvailableVoicesAsync() {
+    if (!expoSpeech.getVoices) {
+        throw new UnavailabilityError('Speech', 'getVoices');
+    }
+    return expoSpeech.getVoices();
+}
+/** `true` even while paused. */
+export async function isSpeakingAsync() {
+    return expoSpeech.isSpeaking();
+}
+/** Interrupts current speech and clears the queue. */
+export async function stop() {
+    return expoSpeech.stop();
+}
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function pause() {
+    if (!expoSpeech.pause) {
+        throw new UnavailabilityError('Speech', 'pause');
+    }
+    return expoSpeech.pause();
+}
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function resume() {
+    if (!expoSpeech.resume) {
+        throw new UnavailabilityError('Speech', 'resume');
+    }
+    return expoSpeech.resume();
+}
+/** Platform-dependent; iOS returns `Number.MAX_VALUE`. */
+export const maxSpeechInputLength = expoSpeech.maxSpeechInputLength ?? Number.MAX_VALUE;
+//# sourceMappingURL=speech.js.map

package/build-ngc/core/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../src/core/speech.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,MAAM,aAAa,GAAmC,EAAE,CAAC;AACzD,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,SAAS,cAAc;IACrB,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,+BAA+B;IACtC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAClD,sBAAsB,CAAC,0BAA0B,CAAC,CAAC;IACnD,sBAAsB,CAAC,oCAAoC,CAAC,CAAC;IAC7D,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IAChD,sBAAsB,CAAC,0BAA0B,CAAC,CAAC;IACnD,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;IACjD,sBAAsB,GAAG,KAAK,CAAC;AACjC,CAAC;AAED,SAAS,yBAAyB;IAChC,IAAI,sBAAsB;QAAE,OAAO;IACnC,sBAAsB,GAAG,IAAI,CAAC;IAE9B,mBAAmB,CAAC,0BAA0B,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACzD,aAAa,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,mBAAmB,CACjB,oCAAoC,EACpC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;QAChC,aAAa,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC,CACF,CAAC;IACF,mBAAmB,CAAC,uBAAuB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACtD,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QACzB,+BAA+B,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,mBAAmB,CAAC,0BAA0B,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;QACzD,aAAa,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;QACjC,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QACzB,+BAA+B,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,mBAAmB,CAAC,wBAAwB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9D,aAAa,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QACzB,+BAA+B,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,SAAgB,EAChB,QAAiC;IAEjC,IAAI,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,UAAU,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAiC;IAC/D,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,UAA0B,EAAE;IAC9D,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAC5B,yBAAyB,EAAE,CAAC;IAC5B,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC;AAChC,CAAC;AAED,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAC/B,UAAU,CAAC,oBAAoB,IAAI,MAAM,CAAC,SAAS,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,34 @@
+export declare enum VoiceQuality {
+    Default = "Default",
+    Enhanced = "Enhanced"
+}
+export type IVoice = {
+    identifier: string;
+    name: string;
+    quality: VoiceQuality;
+    language: string;
+};
+export type INativeBoundaryEvent = {
+    charIndex: number;
+    charLength: number;
+};
+export type INativeBoundaryEventCallback = (event: INativeBoundaryEvent) => void;
+export type ISpeechOptions = {
+    /** IETF BCP 47 language code. */
+    language?: string;
+    /** `1.0` is the normal pitch. */
+    pitch?: number;
+    /** `1.0` is the normal rate. */
+    rate?: number;
+    /** iOS only — `false` lets the system manage a separate audio session for the speech. */
+    useApplicationAudioSession?: boolean;
+    onStart?: () => void;
+    /** Invoked when speaking is stopped by calling `stop()`. */
+    onStopped?: () => void;
+    onDone?: () => void;
+    onError?: (error: Error) => void;
+    /** `0.0` (muted) to `1.0` (max volume). Default `1.0`. */
+    volume?: number;
+    voice?: string;
+    onBoundary?: INativeBoundaryEventCallback | null;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,6 @@
+export var VoiceQuality;
+(function (VoiceQuality) {
+    VoiceQuality["Default"] = "Default";
+    VoiceQuality["Enhanced"] = "Enhanced";
+})(VoiceQuality || (VoiceQuality = {}));
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;AACvB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-speech",
+    "modules": [
+      {
+        "importPath": "expo.modules.speech.SpeechModule",
+        "className": "SpeechModule",
+        "nativeName": "ExpoSpeech"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/speech",
+  "version": "0.1.0",
+  "description": "expo-speech wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Text-to-speech.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-speech",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "speech",
+    "tts"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/speech"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/speech#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-speech": "57.0.3",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/solid": "^3.0.5",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/svelte": "3.0.5",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/vue": "3.1.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service - plain re-export.
+export * from '../core';

package/src/core/index.ts

@@ -0,0 +1,16 @@
+export {
+  getAvailableVoicesAsync,
+  isSpeakingAsync,
+  maxSpeechInputLength,
+  pause,
+  resume,
+  speak,
+  stop,
+} from './speech';
+export { VoiceQuality } from './types';
+export type {
+  INativeBoundaryEvent,
+  INativeBoundaryEventCallback,
+  ISpeechOptions,
+  IVoice,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,39 @@
+import { NativeModule, requireNativeModule } from 'expo-modules-core';
+import type { ISpeechOptions, IVoice } from './types';
+
+const EXPO_SPEECH_MODULE_NAME = 'ExpoSpeech';
+
+type ISpeechEventParams = { id: string };
+
+export type ISpeechEventsMap = {
+  'Exponent.speakingStarted': (params: ISpeechEventParams) => void;
+  'Exponent.speakingWillSayNextString': (
+    params: ISpeechEventParams & { charIndex: number; charLength: number },
+  ) => void;
+  'Exponent.speakingDone': (params: ISpeechEventParams) => void;
+  'Exponent.speakingStopped': (params: ISpeechEventParams) => void;
+  /** Android only supplies `error`; iOS never emits this event at all. */
+  'Exponent.speakingError': (
+    params: ISpeechEventParams & { error?: string },
+  ) => void;
+};
+
+export declare class NativeSpeechModule extends NativeModule<ISpeechEventsMap> {
+  maxSpeechInputLength?: number;
+  speak(
+    utteranceId: string,
+    text: string,
+    options: ISpeechOptions,
+  ): Promise<void>;
+  getVoices?(): Promise<IVoice[]>;
+  isSpeaking(): Promise<boolean>;
+  stop(): Promise<void>;
+  /** iOS only; absent on Android's native module. */
+  pause?(): Promise<void>;
+  /** iOS only; absent on Android's native module. */
+  resume?(): Promise<void>;
+}
+
+export const expoSpeech = requireNativeModule<NativeSpeechModule>(
+  EXPO_SPEECH_MODULE_NAME,
+);

package/src/core/speech.ts

@@ -0,0 +1,111 @@
+import { UnavailabilityError } from 'expo-modules-core';
+import { expoSpeech } from './native-module';
+import type { ISpeechEventsMap } from './native-module';
+import type { ISpeechOptions, IVoice } from './types';
+
+const callbacksById: Record<string, ISpeechOptions> = {};
+let nextCallbackId = 1;
+let hasRegisteredListeners = false;
+
+function makeCallbackId(): string {
+  return String(nextCallbackId++);
+}
+
+function unregisterListenersIfNoneNeeded(): void {
+  if (Object.keys(callbacksById).length > 0) return;
+  removeSpeakingListener('Exponent.speakingStarted');
+  removeSpeakingListener('Exponent.speakingWillSayNextString');
+  removeSpeakingListener('Exponent.speakingDone');
+  removeSpeakingListener('Exponent.speakingStopped');
+  removeSpeakingListener('Exponent.speakingError');
+  hasRegisteredListeners = false;
+}
+
+function registerListenersIfNeeded(): void {
+  if (hasRegisteredListeners) return;
+  hasRegisteredListeners = true;
+
+  setSpeakingListener('Exponent.speakingStarted', ({ id }) => {
+    callbacksById[id]?.onStart?.();
+  });
+  setSpeakingListener(
+    'Exponent.speakingWillSayNextString',
+    ({ id, charIndex, charLength }) => {
+      callbacksById[id]?.onBoundary?.({ charIndex, charLength });
+    },
+  );
+  setSpeakingListener('Exponent.speakingDone', ({ id }) => {
+    callbacksById[id]?.onDone?.();
+    delete callbacksById[id];
+    unregisterListenersIfNoneNeeded();
+  });
+  setSpeakingListener('Exponent.speakingStopped', ({ id }) => {
+    callbacksById[id]?.onStopped?.();
+    delete callbacksById[id];
+    unregisterListenersIfNoneNeeded();
+  });
+  setSpeakingListener('Exponent.speakingError', ({ id, error }) => {
+    callbacksById[id]?.onError?.(new Error(error));
+    delete callbacksById[id];
+    unregisterListenersIfNoneNeeded();
+  });
+}
+
+function setSpeakingListener<TName extends keyof ISpeechEventsMap>(
+  eventName: TName,
+  listener: ISpeechEventsMap[TName],
+): void {
+  if (expoSpeech.listenerCount(eventName) > 0) {
+    expoSpeech.removeAllListeners(eventName);
+  }
+  expoSpeech.addListener(eventName, listener);
+}
+
+function removeSpeakingListener(eventName: keyof ISpeechEventsMap): void {
+  expoSpeech.removeAllListeners(eventName);
+}
+
+/** Adds `text` to the speech queue. Calling this while another utterance is speaking queues it. */
+export function speak(text: string, options: ISpeechOptions = {}): void {
+  const id = makeCallbackId();
+  callbacksById[id] = options;
+  registerListenersIfNeeded();
+  expoSpeech.speak(id, text, options);
+}
+
+export async function getAvailableVoicesAsync(): Promise<IVoice[]> {
+  if (!expoSpeech.getVoices) {
+    throw new UnavailabilityError('Speech', 'getVoices');
+  }
+  return expoSpeech.getVoices();
+}
+
+/** `true` even while paused. */
+export async function isSpeakingAsync(): Promise<boolean> {
+  return expoSpeech.isSpeaking();
+}
+
+/** Interrupts current speech and clears the queue. */
+export async function stop(): Promise<void> {
+  return expoSpeech.stop();
+}
+
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function pause(): Promise<void> {
+  if (!expoSpeech.pause) {
+    throw new UnavailabilityError('Speech', 'pause');
+  }
+  return expoSpeech.pause();
+}
+
+/** iOS only; throws `UnavailabilityError` on Android. */
+export async function resume(): Promise<void> {
+  if (!expoSpeech.resume) {
+    throw new UnavailabilityError('Speech', 'resume');
+  }
+  return expoSpeech.resume();
+}
+
+/** Platform-dependent; iOS returns `Number.MAX_VALUE`. */
+export const maxSpeechInputLength: number =
+  expoSpeech.maxSpeechInputLength ?? Number.MAX_VALUE;

package/src/core/types.ts

@@ -0,0 +1,36 @@
+export enum VoiceQuality {
+  Default = 'Default',
+  Enhanced = 'Enhanced',
+}
+
+export type IVoice = {
+  identifier: string;
+  name: string;
+  quality: VoiceQuality;
+  language: string;
+};
+
+export type INativeBoundaryEvent = { charIndex: number; charLength: number };
+export type INativeBoundaryEventCallback = (
+  event: INativeBoundaryEvent,
+) => void;
+
+export type ISpeechOptions = {
+  /** IETF BCP 47 language code. */
+  language?: string;
+  /** `1.0` is the normal pitch. */
+  pitch?: number;
+  /** `1.0` is the normal rate. */
+  rate?: number;
+  /** iOS only — `false` lets the system manage a separate audio session for the speech. */
+  useApplicationAudioSession?: boolean;
+  onStart?: () => void;
+  /** Invoked when speaking is stopped by calling `stop()`. */
+  onStopped?: () => void;
+  onDone?: () => void;
+  onError?: (error: Error) => void;
+  /** `0.0` (muted) to `1.0` (max volume). Default `1.0`. */
+  volume?: number;
+  voice?: string;
+  onBoundary?: INativeBoundaryEventCallback | null;
+};