@happyvertical/smrt-svelte 0.55.6 → 0.55.8

package/dist/browser-ai/adapters/tts/browser-synthesis.js

@@ -14,8 +14,12 @@ export class BrowserSynthesisTTSAdapter {
     synthesis = null;
     options;
     voices = [];
-    // biome-ignore lint/correctness/noUnusedPrivateClassMembers: Used in speak/stop/pause
     currentUtterance = null;
+    operationGeneration = 0;
+    initializationGeneration = 0;
+    initialization = null;
+    cancelVoiceLoad = null;
+    settleCurrentSpeech = null;
     // Event listeners
     startListeners = new Set();
     endListeners = new Set();
@@ -36,58 +40,60 @@ export class BrowserSynthesisTTSAdapter {
     async ensureInitialized(_onProgress) {
         if (this._initState === 'ready')
             return;
-        if (this._initState === 'initializing') {
-            // Wait for existing initialization
-            return new Promise((resolve, reject) => {
-                const check = () => {
-                    if (this._initState === 'ready')
-                        resolve();
-                    else if (this._initState === 'error')
-                        reject(new Error('Initialization failed'));
-                    else
-                        setTimeout(check, 50);
-                };
-                check();
-            });
-        }
+        if (this.initialization)
+            return this.initialization;
+        const generation = this.initializationGeneration;
         this._initState = 'initializing';
-        try {
-            if (typeof window === 'undefined' || !window.speechSynthesis) {
-                throw new CapabilityNotAvailableError('Web Speech Synthesis API', 'browser-synthesis');
+        const initialization = (async () => {
+            try {
+                if (typeof window === 'undefined' || !window.speechSynthesis) {
+                    throw new CapabilityNotAvailableError('Web Speech Synthesis API', 'browser-synthesis');
+                }
+                this.synthesis = window.speechSynthesis;
+                await this.loadVoices(this.synthesis);
+                if (generation === this.initializationGeneration) {
+                    this._initState = 'ready';
+                }
+            }
+            catch (error) {
+                if (generation === this.initializationGeneration) {
+                    this._initState = 'error';
+                }
+                throw error;
             }
-            this.synthesis = window.speechSynthesis;
-            // Load voices - they may load asynchronously
-            await this.loadVoices();
-            this._initState = 'ready';
+        })();
+        this.initialization = initialization;
+        try {
+            await initialization;
         }
-        catch (error) {
-            this._initState = 'error';
-            throw error;
+        finally {
+            if (this.initialization === initialization)
+                this.initialization = null;
         }
     }
-    async loadVoices() {
-        if (!this.synthesis)
+    async loadVoices(synthesis) {
+        this.voices = synthesis.getVoices();
+        if (this.voices.length > 0)
             return;
-        // Get voices - may be empty initially in some browsers
-        this.voices = this.synthesis.getVoices();
-        if (this.voices.length === 0) {
-            // Wait for voices to load
-            await new Promise((resolve) => {
-                const handleVoicesChanged = () => {
-                    this.voices = this.synthesis?.getVoices() ?? [];
-                    if (this.voices.length > 0) {
-                        this.synthesis?.removeEventListener('voiceschanged', handleVoicesChanged);
-                        resolve();
-                    }
-                };
-                this.synthesis?.addEventListener('voiceschanged', handleVoicesChanged);
-                // Timeout after 2 seconds - some browsers may not fire the event
-                setTimeout(() => {
-                    this.voices = this.synthesis?.getVoices() ?? [];
-                    resolve();
-                }, 2000);
-            });
-        }
+        await new Promise((resolve) => {
+            const finish = () => {
+                clearTimeout(timeout);
+                synthesis.removeEventListener('voiceschanged', handleVoicesChanged);
+                this.cancelVoiceLoad = null;
+                resolve();
+            };
+            const handleVoicesChanged = () => {
+                this.voices = synthesis.getVoices();
+                if (this.voices.length > 0)
+                    finish();
+            };
+            const timeout = setTimeout(() => {
+                this.voices = synthesis.getVoices();
+                finish();
+            }, 2000);
+            this.cancelVoiceLoad = finish;
+            synthesis.addEventListener('voiceschanged', handleVoicesChanged);
+        });
     }
     getCapabilities() {
         return {
@@ -133,12 +139,15 @@ export class BrowserSynthesisTTSAdapter {
         return this.voices.find((v) => v.default) || this.voices[0];
     }
     async speak(text, options = {}) {
+        // Invalidate previous requests before the asynchronous voices wait.
+        this.stop();
+        const generation = this.operationGeneration;
         await this.ensureInitialized();
+        if (generation !== this.operationGeneration)
+            return;
         if (!this.synthesis) {
             throw new Error('Synthesis not initialized');
         }
-        // Cancel any current speech
-        this.stop();
         return new Promise((resolve, reject) => {
             const utterance = new SpeechSynthesisUtterance(text);
             // Set voice
@@ -154,21 +163,34 @@ export class BrowserSynthesisTTSAdapter {
             utterance.rate = options.rate ?? this.options.defaultRate ?? 1;
             utterance.pitch = options.pitch ?? this.options.defaultPitch ?? 1;
             utterance.volume = options.volume ?? this.options.defaultVolume ?? 1;
+            const isCurrent = () => generation === this.operationGeneration &&
+                this.currentUtterance === utterance;
+            const settle = () => {
+                this.currentUtterance = null;
+                this.settleCurrentSpeech = null;
+                resolve();
+            };
             // Set up event handlers
             utterance.onstart = () => {
+                if (!isCurrent())
+                    return;
                 for (const cb of this.startListeners) {
                     cb();
                 }
             };
             utterance.onend = () => {
-                this.currentUtterance = null;
+                if (!isCurrent())
+                    return;
+                settle();
                 for (const cb of this.endListeners) {
                     cb();
                 }
-                resolve();
             };
             utterance.onerror = (event) => {
+                if (!isCurrent())
+                    return;
                 this.currentUtterance = null;
+                this.settleCurrentSpeech = null;
                 const error = new Error(`Speech synthesis error: ${event.error}`);
                 for (const cb of this.errorListeners) {
                     cb(error);
@@ -176,19 +198,22 @@ export class BrowserSynthesisTTSAdapter {
                 reject(error);
             };
             utterance.onboundary = (event) => {
+                if (!isCurrent())
+                    return;
                 for (const cb of this.boundaryListeners) {
                     cb(event.charIndex, event.charLength || 1);
                 }
             };
             this.currentUtterance = utterance;
+            this.settleCurrentSpeech = settle;
             this.synthesis?.speak(utterance);
         });
     }
     stop() {
-        if (this.synthesis) {
-            this.synthesis.cancel();
-            this.currentUtterance = null;
-        }
+        ++this.operationGeneration;
+        // Settle before native cancel: it may emit synchronous callbacks or none.
+        this.settleCurrentSpeech?.();
+        this.synthesis?.cancel();
     }
     pause() {
         if (this.synthesis) {
@@ -224,6 +249,9 @@ export class BrowserSynthesisTTSAdapter {
     }
     async dispose() {
         this.stop();
+        ++this.initializationGeneration;
+        this.cancelVoiceLoad?.();
+        this.initialization = null;
         this.synthesis = null;
         this.voices = [];
         this.startListeners.clear();

package/dist/browser-ai/capabilities/speech-probe.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Should a host offer local (downloadable) speech recognition?
+ *
+ * The browser's own speech recognition (`SpeechRecognition`) is a thin
+ * client for a vendor speech service, so "the API exists" does not mean it
+ * works. This looks only at what the browser exposes: it makes no network
+ * request and never opens the microphone (so there is no permission prompt).
+ *
+ * - `'works'`: Chrome-family browsers with the API (Chrome, Edge, Safari).
+ * - `'missing'`: no `SpeechRecognition` at all (Firefox).
+ * - `'unreliable'`: the API is there but has no speech service behind it:
+ *   Brave (it ends instantly or fails with `network`), or an embedded
+ *   Chromium (Electron) with no vendor speech key.
+ *
+ * Anything but `'works'` is a reason to offer the local model. A recogniser
+ * that still turns out to end instantly is caught later by smrt-ui's
+ * dictation state machine, which reports it as an error.
+ */
+export type BrowserSpeechSupport = 'works' | 'missing' | 'unreliable';
+/** The browser objects the probe reads; injectable for tests. */
+export interface BrowserSpeechProbeEnv {
+    window?: Record<string, unknown>;
+    navigator?: {
+        userAgent?: string;
+        brave?: unknown;
+    };
+}
+export declare function probeBrowserSpeech(env?: BrowserSpeechProbeEnv): Promise<BrowserSpeechSupport>;
+//# sourceMappingURL=speech-probe.d.ts.map

package/dist/browser-ai/capabilities/speech-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech-probe.d.ts","sourceRoot":"","sources":["../../../src/browser-ai/capabilities/speech-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;AAEtE,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrD;AAED,wBAAsB,kBAAkB,CACtC,GAAG,GAAE,qBAA0B,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAiB/B"}

package/dist/browser-ai/capabilities/speech-probe.js

@@ -0,0 +1,19 @@
+export async function probeBrowserSpeech(env = {}) {
+    const win = env.window ??
+        (typeof window !== 'undefined'
+            ? window
+            : undefined);
+    const nav = env.navigator ?? (typeof navigator !== 'undefined' ? navigator : undefined);
+    if (!win)
+        return 'missing';
+    if (!('SpeechRecognition' in win) && !('webkitSpeechRecognition' in win)) {
+        return 'missing';
+    }
+    // Brave defines `navigator.brave`; its recogniser has no service behind it.
+    if (nav && 'brave' in nav && nav.brave)
+        return 'unreliable';
+    // Electron ships the API without the vendor speech key.
+    if (/\bElectron\//.test(nav?.userAgent ?? ''))
+        return 'unreliable';
+    return 'works';
+}

package/dist/browser-ai/core/errors.d.ts

@@ -21,6 +21,15 @@ export declare class InitializationError extends BrowserAIError {
 export declare class CapabilityNotAvailableError extends BrowserAIError {
     constructor(capability: string, adapter?: string);
 }
+/**
+ * Thrown when something needs an on-device model that is not stored on this
+ * device yet and was asked not to download it. `dictationKind` lets smrt-ui's
+ * `Dictation` show "The speech model isn't downloaded yet".
+ */
+export declare class ModelNotDownloadedError extends BrowserAIError {
+    readonly dictationKind = "model-missing";
+    constructor(model: string, adapter?: string);
+}
 /**
  * Thrown when a model download fails
  */

package/dist/browser-ai/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/browser-ai/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAK1B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,cAAc;gBACjD,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAEtC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAEvC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQnE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQzE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE;CAO1D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/browser-ai/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM;gBAFvB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,YAAA;CAK1B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,cAAc;gBACjD,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQjD;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;IACzD,QAAQ,CAAC,aAAa,mBAAmB;gBAC7B,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQ5C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAEtC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAEvC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQnE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAIjD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;gBACvC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQzE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE;CAO1D"}

package/dist/browser-ai/core/errors.js

@@ -32,6 +32,18 @@ export class CapabilityNotAvailableError extends BrowserAIError {
         this.name = 'CapabilityNotAvailableError';
     }
 }
+/**
+ * Thrown when something needs an on-device model that is not stored on this
+ * device yet and was asked not to download it. `dictationKind` lets smrt-ui's
+ * `Dictation` show "The speech model isn't downloaded yet".
+ */
+export class ModelNotDownloadedError extends BrowserAIError {
+    dictationKind = 'model-missing';
+    constructor(model, adapter) {
+        super(`The speech model isn't downloaded yet (${model})`, 'MODEL_NOT_DOWNLOADED', adapter);
+        this.name = 'ModelNotDownloadedError';
+    }
+}
 /**
  * Thrown when a model download fails
  */

package/dist/browser-ai/index.d.ts

@@ -8,5 +8,6 @@ export * from './adapters/llm/index.js';
 export * from './adapters/stt/index.js';
 export * from './adapters/tts/index.js';
 export * from './capabilities/detector.js';
+export * from './capabilities/speech-probe.js';
 export * from './core/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/browser-ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser-ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AAExC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser-ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AAExC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,iBAAiB,CAAC"}

package/dist/browser-ai/index.js

@@ -12,5 +12,6 @@ export * from './adapters/stt/index.js';
 export * from './adapters/tts/index.js';
 // Capability detection
 export * from './capabilities/detector.js';
+export * from './capabilities/speech-probe.js';
 // Core types and errors
 export * from './core/index.js';