@quatrain/voice 1.0.1

package/dist/AbstractVoiceAdapter.d.ts

@@ -0,0 +1,5 @@
+export declare abstract class AbstractVoiceAdapter {
+    abstract init(): void;
+    abstract speak(text: string, options?: any): Promise<void>;
+}
+//# sourceMappingURL=AbstractVoiceAdapter.d.ts.map

package/dist/AbstractVoiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractVoiceAdapter.d.ts","sourceRoot":"","sources":["../src/AbstractVoiceAdapter.ts"],"names":[],"mappings":"AAGA,8BAAsB,oBAAoB;IAIvC,QAAQ,CAAC,IAAI,IAAI,IAAI;IAOrB,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAC5D"}

package/dist/AbstractVoiceAdapter.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractVoiceAdapter = void 0;
+class AbstractVoiceAdapter {
+}
+exports.AbstractVoiceAdapter = AbstractVoiceAdapter;
+//# sourceMappingURL=AbstractVoiceAdapter.js.map

package/dist/AbstractVoiceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractVoiceAdapter.js","sourceRoot":"","sources":["../src/AbstractVoiceAdapter.ts"],"names":[],"mappings":";;;AAGA,MAAsB,oBAAoB;CAYzC;AAZD,oDAYC"}

package/dist/BrowserVoiceAdapter.d.ts

@@ -0,0 +1,8 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter';
+export declare class BrowserVoiceAdapter extends AbstractVoiceAdapter {
+    init(): void;
+    speak(text: string, options?: {
+        lang?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=BrowserVoiceAdapter.d.ts.map

package/dist/BrowserVoiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserVoiceAdapter.d.ts","sourceRoot":"","sources":["../src/BrowserVoiceAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAK7D,qBAAa,mBAAoB,SAAQ,oBAAoB;IAC1D,IAAI,IAAI,IAAI;IAUN,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBvE"}

package/dist/BrowserVoiceAdapter.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserVoiceAdapter = void 0;
+const AbstractVoiceAdapter_1 = require("./AbstractVoiceAdapter");
+class BrowserVoiceAdapter extends AbstractVoiceAdapter_1.AbstractVoiceAdapter {
+    init() {
+    }
+    async speak(text, options) {
+        if (typeof window === 'undefined' || !window.speechSynthesis) {
+            throw new Error('BrowserVoiceAdapter requires a browser environment with SpeechSynthesis support.');
+        }
+        window.speechSynthesis.cancel();
+        const cleanText = text.replace(/[#*`[\]()]/g, '');
+        const utterance = new SpeechSynthesisUtterance(cleanText);
+        if (options?.lang) {
+            utterance.lang = options.lang;
+        }
+        window.speechSynthesis.speak(utterance);
+    }
+}
+exports.BrowserVoiceAdapter = BrowserVoiceAdapter;
+//# sourceMappingURL=BrowserVoiceAdapter.js.map

package/dist/BrowserVoiceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserVoiceAdapter.js","sourceRoot":"","sources":["../src/BrowserVoiceAdapter.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAK7D,MAAa,mBAAoB,SAAQ,2CAAoB;IAC1D,IAAI;IAEJ,CAAC;IAQD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAA2B;QAClD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;QACtG,CAAC;QAGD,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,CAAA;QAG/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;QACjD,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,SAAS,CAAC,CAAA;QAEzD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YACjB,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QAChC,CAAC;QAED,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC1C,CAAC;CACH;AA7BD,kDA6BC"}

package/dist/ElevenLabsVoiceAdapter.d.ts

@@ -0,0 +1,16 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter';
+export declare class ElevenLabsVoiceAdapter extends AbstractVoiceAdapter {
+    private _apiKey;
+    private _voiceId;
+    private _modelId;
+    constructor(config: {
+        apiKey: string;
+        voiceId?: string;
+        modelId?: string;
+    });
+    init(): void;
+    speak(text: string, options?: {
+        voiceId?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=ElevenLabsVoiceAdapter.d.ts.map

package/dist/ElevenLabsVoiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsVoiceAdapter.d.ts","sourceRoot":"","sources":["../src/ElevenLabsVoiceAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAK7D,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC7D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAO1E,IAAI,IAAI,IAAI;IAYN,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiC1E"}

package/dist/ElevenLabsVoiceAdapter.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElevenLabsVoiceAdapter = void 0;
+const AbstractVoiceAdapter_1 = require("./AbstractVoiceAdapter");
+class ElevenLabsVoiceAdapter extends AbstractVoiceAdapter_1.AbstractVoiceAdapter {
+    _apiKey;
+    _voiceId;
+    _modelId;
+    constructor(config) {
+        super();
+        this._apiKey = config.apiKey;
+        this._voiceId = config.voiceId || 'bVsJfghVbJypxgwVISO3';
+        this._modelId = config.modelId || 'eleven_multilingual_v2';
+    }
+    init() {
+        if (!this._apiKey) {
+            throw new Error('ElevenLabsVoiceAdapter requires an apiKey.');
+        }
+    }
+    async speak(text, options) {
+        const voiceId = options?.voiceId || this._voiceId;
+        const cleanText = text.replace(/[#*`[\]()]/g, '');
+        const response = await fetch(`https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'xi-api-key': this._apiKey,
+            },
+            body: JSON.stringify({
+                text: cleanText,
+                model_id: this._modelId,
+                voice_settings: {
+                    stability: 0.5,
+                    similarity_boost: 0.75,
+                },
+            }),
+        });
+        if (!response.ok) {
+            const errText = await response.text();
+            throw new Error(`ElevenLabs TTS request failed: ${response.statusText} - ${errText}`);
+        }
+        const audioBlob = await response.blob();
+        if (typeof window !== 'undefined') {
+            const audioUrl = URL.createObjectURL(audioBlob);
+            const audio = new Audio(audioUrl);
+            await audio.play();
+        }
+    }
+}
+exports.ElevenLabsVoiceAdapter = ElevenLabsVoiceAdapter;
+//# sourceMappingURL=ElevenLabsVoiceAdapter.js.map

package/dist/ElevenLabsVoiceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsVoiceAdapter.js","sourceRoot":"","sources":["../src/ElevenLabsVoiceAdapter.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAK7D,MAAa,sBAAuB,SAAQ,2CAAoB;IACrD,OAAO,CAAQ;IACf,QAAQ,CAAQ;IAChB,QAAQ,CAAQ;IAExB,YAAY,MAA8D;QACvE,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,sBAAsB,CAAA;QACxD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAA;IAC7D,CAAC;IAED,IAAI;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAChE,CAAC;IACJ,CAAC;IAQD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAA8B;QACrD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAA;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;QAEjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+CAA+C,OAAO,EAAE,EAAE;YACpF,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACN,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,IAAI,CAAC,OAAO;aAC5B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBAClB,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,cAAc,EAAE;oBACb,SAAS,EAAE,GAAG;oBACd,gBAAgB,EAAE,IAAI;iBACxB;aACH,CAAC;SACJ,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YACrC,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,UAAU,MAAM,OAAO,EAAE,CAAC,CAAA;QACxF,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAEvC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;YAC/C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;YACjC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC;IACJ,CAAC;CACH;AAzDD,wDAyDC"}

package/dist/Voice.d.ts

@@ -0,0 +1,8 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter';
+export declare class Voice {
+    protected static _adapter: AbstractVoiceAdapter | null;
+    static setAdapter(adapter: AbstractVoiceAdapter): void;
+    static getAdapter(): AbstractVoiceAdapter;
+    static speak(text: string, options?: any): Promise<void>;
+}
+//# sourceMappingURL=Voice.d.ts.map

package/dist/Voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voice.d.ts","sourceRoot":"","sources":["../src/Voice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAK7D,qBAAa,KAAK;IACf,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAO;WAO/C,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;WAW/C,UAAU,IAAI,oBAAoB;WAalC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}

package/dist/Voice.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Voice = void 0;
+class Voice {
+    static _adapter = null;
+    static setAdapter(adapter) {
+        this._adapter = adapter;
+        this._adapter.init();
+    }
+    static getAdapter() {
+        if (!this._adapter) {
+            throw new Error('Voice adapter has not been configured. Call Voice.setAdapter() first.');
+        }
+        return this._adapter;
+    }
+    static speak(text, options) {
+        return this.getAdapter().speak(text, options);
+    }
+}
+exports.Voice = Voice;
+//# sourceMappingURL=Voice.js.map

package/dist/Voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voice.js","sourceRoot":"","sources":["../src/Voice.ts"],"names":[],"mappings":";;;AAKA,MAAa,KAAK;IACL,MAAM,CAAC,QAAQ,GAAgC,IAAI,CAAA;IAOtD,MAAM,CAAC,UAAU,CAAC,OAA6B;QACnD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IAQM,MAAM,CAAC,UAAU;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;QAC3F,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACvB,CAAC;IAQM,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,OAAa;QAC5C,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAChD,CAAC;;AAlCJ,sBAmCC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { AbstractVoiceAdapter } from './AbstractVoiceAdapter';
+export { BrowserVoiceAdapter } from './BrowserVoiceAdapter';
+export { ElevenLabsVoiceAdapter } from './ElevenLabsVoiceAdapter';
+export { Voice } from './Voice';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Voice = exports.ElevenLabsVoiceAdapter = exports.BrowserVoiceAdapter = exports.AbstractVoiceAdapter = void 0;
+var AbstractVoiceAdapter_1 = require("./AbstractVoiceAdapter");
+Object.defineProperty(exports, "AbstractVoiceAdapter", { enumerable: true, get: function () { return AbstractVoiceAdapter_1.AbstractVoiceAdapter; } });
+var BrowserVoiceAdapter_1 = require("./BrowserVoiceAdapter");
+Object.defineProperty(exports, "BrowserVoiceAdapter", { enumerable: true, get: function () { return BrowserVoiceAdapter_1.BrowserVoiceAdapter; } });
+var ElevenLabsVoiceAdapter_1 = require("./ElevenLabsVoiceAdapter");
+Object.defineProperty(exports, "ElevenLabsVoiceAdapter", { enumerable: true, get: function () { return ElevenLabsVoiceAdapter_1.ElevenLabsVoiceAdapter; } });
+var Voice_1 = require("./Voice");
+Object.defineProperty(exports, "Voice", { enumerable: true, get: function () { return Voice_1.Voice; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+DAA6D;AAApD,4HAAA,oBAAoB,OAAA;AAC7B,6DAA2D;AAAlD,0HAAA,mBAAmB,OAAA;AAC5B,mEAAiE;AAAxD,gIAAA,sBAAsB,OAAA;AAC/B,iCAA+B;AAAtB,8FAAA,KAAK,OAAA"}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@quatrain/voice",
+  "version": "1.0.1",
+  "main": "src/index.ts",
+  "license": "AGPL-3.0-only",
+  "devDependencies": {
+    "typescript": "^5.2.2"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Quatrain/CoreUX.git",
+    "directory": "packages/voice"
+  }
+}

package/src/AbstractVoiceAdapter.ts

@@ -0,0 +1,16 @@
+/**
+ * Abstract blueprint for voice synthesis adapters.
+ */
+export abstract class AbstractVoiceAdapter {
+   /**
+    * Adapter specific initialization
+    */
+   abstract init(): void
+
+   /**
+    * Synthesize text to speech
+    * @param text - The plain text to read aloud
+    * @param options - Configuration options such as voice ID, language, speed, etc.
+    */
+   abstract speak(text: string, options?: any): Promise<void>
+}

package/src/BrowserVoiceAdapter.ts

@@ -0,0 +1,35 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter'
+
+/**
+ * Voice synthesis adapter using the native Web Speech API (SpeechSynthesis) in the browser.
+ */
+export class BrowserVoiceAdapter extends AbstractVoiceAdapter {
+   init(): void {
+      // Browser SpeechSynthesis does not need explicit initialization keys
+   }
+
+   /**
+    * Synthesize text using the browser's speechSynthesis engine.
+    * 
+    * @param text - Plain text to synthesize.
+    * @param options - Configuration options. Supports `lang` (e.g. 'fr-FR', 'en-US').
+    */
+   async speak(text: string, options?: { lang?: string }): Promise<void> {
+      if (typeof window === 'undefined' || !window.speechSynthesis) {
+         throw new Error('BrowserVoiceAdapter requires a browser environment with SpeechSynthesis support.')
+      }
+
+      // Cancel any ongoing speech
+      window.speechSynthesis.cancel()
+
+      // Strip markdown syntax for natural reading
+      const cleanText = text.replace(/[#*`[\]()]/g, '')
+      const utterance = new SpeechSynthesisUtterance(cleanText)
+
+      if (options?.lang) {
+         utterance.lang = options.lang
+      }
+
+      window.speechSynthesis.speak(utterance)
+   }
+}

package/src/ElevenLabsVoiceAdapter.ts

@@ -0,0 +1,63 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter'
+
+/**
+ * Voice synthesis adapter using ElevenLabs HTTP API.
+ */
+export class ElevenLabsVoiceAdapter extends AbstractVoiceAdapter {
+   private _apiKey: string
+   private _voiceId: string
+   private _modelId: string
+
+   constructor(config: { apiKey: string; voiceId?: string; modelId?: string }) {
+      super()
+      this._apiKey = config.apiKey
+      this._voiceId = config.voiceId || 'bVsJfghVbJypxgwVISO3' // User's voice
+      this._modelId = config.modelId || 'eleven_multilingual_v2'
+   }
+
+   init(): void {
+      if (!this._apiKey) {
+         throw new Error('ElevenLabsVoiceAdapter requires an apiKey.')
+      }
+   }
+
+   /**
+    * Synthesize text using ElevenLabs API and play the returned audio blob.
+    * 
+    * @param text - Plain text to synthesize.
+    * @param options - Configuration options. Supports `voiceId` override.
+    */
+   async speak(text: string, options?: { voiceId?: string }): Promise<void> {
+      const voiceId = options?.voiceId || this._voiceId
+      const cleanText = text.replace(/[#*`[\]()]/g, '')
+
+      const response = await fetch(`https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`, {
+         method: 'POST',
+         headers: {
+            'Content-Type': 'application/json',
+            'xi-api-key': this._apiKey,
+         },
+         body: JSON.stringify({
+            text: cleanText,
+            model_id: this._modelId,
+            voice_settings: {
+               stability: 0.5,
+               similarity_boost: 0.75,
+            },
+         }),
+      })
+
+      if (!response.ok) {
+         const errText = await response.text()
+         throw new Error(`ElevenLabs TTS request failed: ${response.statusText} - ${errText}`)
+      }
+
+      const audioBlob = await response.blob()
+
+      if (typeof window !== 'undefined') {
+         const audioUrl = URL.createObjectURL(audioBlob)
+         const audio = new Audio(audioUrl)
+         await audio.play()
+      }
+   }
+}

package/src/Voice.ts

@@ -0,0 +1,41 @@
+import { AbstractVoiceAdapter } from './AbstractVoiceAdapter'
+
+/**
+ * Unified static registry to configure and trigger the active voice synthesis adapter.
+ */
+export class Voice {
+   protected static _adapter: AbstractVoiceAdapter | null = null
+
+   /**
+    * Assign and initialize the active voice synthesis adapter.
+    * 
+    * @param adapter - An instance of AbstractVoiceAdapter.
+    */
+   public static setAdapter(adapter: AbstractVoiceAdapter): void {
+      this._adapter = adapter
+      this._adapter.init()
+   }
+
+   /**
+    * Retrieve the currently active voice adapter.
+    * 
+    * @returns The active AbstractVoiceAdapter.
+    * @throws {Error} If no adapter has been set.
+    */
+   public static getAdapter(): AbstractVoiceAdapter {
+      if (!this._adapter) {
+         throw new Error('Voice adapter has not been configured. Call Voice.setAdapter() first.')
+      }
+      return this._adapter
+   }
+
+   /**
+    * Trigger voice synthesis on the active adapter.
+    * 
+    * @param text - Plain text to read.
+    * @param options - Configuration options for synthesis.
+    */
+   public static speak(text: string, options?: any): Promise<void> {
+      return this.getAdapter().speak(text, options)
+   }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { AbstractVoiceAdapter } from './AbstractVoiceAdapter'
+export { BrowserVoiceAdapter } from './BrowserVoiceAdapter'
+export { ElevenLabsVoiceAdapter } from './ElevenLabsVoiceAdapter'
+export { Voice } from './Voice'

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+   "extends": "../../tsconfig.json",
+   "compilerOptions": {
+      "baseUrl": ".",
+      "rootDir": "src",
+      "outDir": "dist",
+      "lib": ["ES2022", "DOM"],
+      "paths": {}
+   },
+   "include": ["src/**/*"],
+   "exclude": ["node_modules", "**/dist"]
+}