@pie-players/pie-tts 0.3.65 → 0.3.66

package/README.md

@@ -49,8 +49,12 @@ import type {
 } from '@pie-players/pie-tts';
 
 class MyTTSImplementation implements ITTSProviderImplementation {
+  onPlaybackStart?: () => void;
+
   async speak(text: string): Promise<void> {
-    // Your implementation
+    await myEngine.speak(text, {
+      onStart: () => this.onPlaybackStart?.(),
+    });
   }
 
   pause(): void { /* ... */ }

package/dist/provider-interface.d.ts

@@ -18,8 +18,12 @@ export interface StandardTTSConfig {
     /**
      * Voice identifier (provider-specific)
      *
+     * For the Browser provider, prefer `SpeechSynthesisVoice.voiceURI`; the
+     * exposed voice `name` is also accepted. An explicit Browser identifier must
+     * resolve to a voice exposed by that browser.
+     *
      * @standard W3C Web Speech API (concept)
-     * @example "Joanna" (Polly), "en-US-Standard-A" (Google), browser voice name
+     * @example "Joanna" (Polly), "en-US-Standard-A" (Google), browser voiceURI or name
      */
     voice?: string;
     /**
@@ -172,6 +176,12 @@ export interface ITTSProviderImplementation {
      * Check if paused
      */
     isPaused(): boolean;
+    /**
+     * Playback-start callback (optional).
+     * Providers that expose it call it only when native/media playback actually
+     * begins, allowing service state and highlighting to follow audible playback.
+     */
+    onPlaybackStart?: () => void;
     /**
      * Word boundary callback (optional)
      * Called during speech for word highlighting

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-tts",
-	"version": "0.3.65",
+	"version": "0.3.66",
 	"author": "PIE Framework",
 	"repository": {
 		"type": "git",