@untemps/vocal 2.0.0-beta.20 → 2.0.0-beta.22

package/CHANGELOG.md

@@ -1,3 +1,52 @@
+# [2.0.0-beta.22](https://github.com/untemps/vocal/compare/v2.0.0-beta.21...v2.0.0-beta.22) (2026-05-22)
+
+
+### Code Refactoring
+
+* Move from class-based to functional API ([#88](https://github.com/untemps/vocal/issues/88)) ([1161ce8](https://github.com/untemps/vocal/commit/1161ce8ce983a7f216b5a11803bbc5ad90a68dc5))
+
+
+### BREAKING CHANGES
+
+* every public entry point changes shape:
+- `new Vocal(options)` → `createVocal(options)`
+- `Vocal.isSupported` (static getter) → `isSupported()` (function)
+- `Vocal.eventTypes` (static) → `eventTypes` (named export)
+- `vocal.addEventListener(type, cb)` → `vocal.on(type, cb)`
+- `vocal.removeEventListener(type, cb?)` → `vocal.off(type, cb?)`
+- Side-effect methods (`stop`, `abort`, `on`, `off`, `cleanup`) now
+  return `void` instead of `this` — chaining is no longer supported.
+- The `Vocal` class is no longer exported; the new `VocalInstance`
+  interface describes the object returned by `createVocal()`.
+Migration:
+  // before
+  import { Vocal } from '@untemps/vocal'
+  if (!Vocal.isSupported) throw new Error()
+  const vocal = new Vocal({ lang: 'fr-FR' })
+  vocal.addEventListener('result', cb)
+  // after
+  import { createVocal, isSupported } from '@untemps/vocal'
+  if (!isSupported()) throw new Error()
+  const vocal = createVocal({ lang: 'fr-FR' })
+  vocal.on('result', cb)
+
+# [2.0.0-beta.21](https://github.com/untemps/vocal/compare/v2.0.0-beta.20...v2.0.0-beta.21) (2026-05-20)
+
+
+### Code Refactoring
+
+* Remove once() method ([#87](https://github.com/untemps/vocal/issues/87)) ([3748768](https://github.com/untemps/vocal/commit/3748768c33f61ba170f4ffd09ccba23063e5c8c5))
+
+
+### BREAKING CHANGES
+
+* vocal.once(eventType, callback) is removed. Consumers relying on it must replace the call with a manual addEventListener + removeEventListener pair:
+   const handler = (event, best) => {
+      vocal.removeEventListener('result', handler)
+      // ...
+   }
+   vocal.addEventListener('result', handler)
+
 # [2.0.0-beta.20](https://github.com/untemps/vocal/compare/v2.0.0-beta.19...v2.0.0-beta.20) (2026-05-20)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # @untemps/vocal
 
-Class wrapped around the SpeechRecognition Web API
+Functional wrapper around the SpeechRecognition Web API
 
 ![npm](https://img.shields.io/npm/v/@untemps/vocal?style=for-the-badge)
 ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/untemps/vocal/publish.yml?style=for-the-badge)
@@ -14,27 +14,22 @@ yarn add @untemps/vocal
 
 ## Basic Usage
 
-Import `Vocal` to a file.
-
 ```javascript
-import { Vocal } from '@untemps/vocal'
+import { createVocal, isSupported } from '@untemps/vocal'
 
 // Check whether SpeechRecognition, Permissions and MediaDevices interfaces are supported
-if (!Vocal.isSupported) {
+if (!isSupported()) {
   throw new Error('Vocal is not supported')
 }
 
 // Create a Vocal instance (see below for all available option properties)
-const options = {
-    lang: 'fr-FR',
-}
-const vocal = new Vocal(options)
+const vocal = createVocal({ lang: 'fr-FR' })
 
-// Subscribe to Vocal instance events (see below for all available events)
-vocal.addEventListener('speechstart', (event) => console.log('Vocal starts recording'))
-vocal.addEventListener('speechend', (event) => console.log('Vocal stops recording'))
-vocal.addEventListener('result', (event, bestAlternative, alternatives) => console.log('Vocal catches a result:', bestAlternative, alternatives))
-vocal.addEventListener('error', (event) => console.error(event.error, event.message))
+// Subscribe to instance events (see below for all available events)
+vocal.on('speechstart', (event) => console.log('Vocal starts recording'))
+vocal.on('speechend', (event) => console.log('Vocal stops recording'))
+vocal.on('result', (event, bestAlternative, alternatives) => console.log('Vocal catches a result:', bestAlternative, alternatives))
+vocal.on('error', (event) => console.error(event.error, event.message))
 
 // Start recording — rejects on error
 try {
@@ -49,7 +44,7 @@ vocal.stop()
 // Abort recording entirely
 vocal.abort()
 
-// Remove all attached listeners and delete the Vocal instance
+// Remove all attached listeners and release the internal SpeechRecognition instance
 vocal.cleanup()
 ```
 
@@ -97,17 +92,33 @@ Please refer to [this section](https://developer.mozilla.org/en-US/docs/Web/API/
 | speechstart | Fired when sound recognized by the recognition service as speech has been detected        |
 | start       | fired when the recognition service has begun listening to incoming audio                  |
 
-## Getters
+For convenience, `eventTypes` is exported as a constant map so consumers can reference type strings symbolically:
+
+```js
+import { eventTypes } from '@untemps/vocal'
+vocal.on(eventTypes.RESULT, handler)
+```
+
+## Top-level exports
+
+| Export        | Kind     | Description                                                                                                          |
+| ------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
+| `createVocal` | function | Factory that returns a `VocalInstance`. See [Methods](#methods).                                                     |
+| `isSupported` | function | Returns `true` if the current environment supports the SpeechRecognition Web API. Call it (it is **not** a getter).  |
+| `eventTypes`  | const    | Map of valid event type strings (e.g. `eventTypes.RESULT === 'result'`).                                             |
+
+## Instance getter
 
-| Getter      | Type                      | Description                                                                                                          |
-| ----------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| isSupported | boolean                   | Whether the current environment supports the SpeechRecognition Web API (static)                                      |
-| isRecording | boolean                   | Whether recognition is currently active — `true` after `start()`, `false` after `stop()`, `abort()`, or `end` event |
+| Getter      | Type      | Description                                                                                                          |
+| ----------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
+| isRecording | boolean   | Whether recognition is currently active — `true` after `start()`, `false` after `stop()`, `abort()`, or `end` event |
 
 ## Methods
 
 ### `start({ signal? })`
 
+Starts recognition. Resolves once the engine is active. Rejects if microphone permission cannot be obtained.
+
 | Parameter | Type          | Default     | Description                                                                   |
 | --------- | ------------- | ----------- | ----------------------------------------------------------------------------- |
 | signal    | AbortSignal   | `undefined` | Cancels the in-flight microphone permission request when the signal is aborted |
@@ -122,13 +133,13 @@ controller.abort()
 
 ### `stop()`
 
-Stops recognition gracefully, allowing the current audio to be processed before disconnecting. Sets `isRecording` to `false`.
+Stops recognition gracefully, allowing the current audio to be processed before disconnecting. Sets `isRecording` to `false`. In continuous mode, emits the aggregated `result` event just before `end`.
 
 ### `abort()`
 
-Stops recognition immediately without processing pending audio. Sets `isRecording` to `false`.
+Stops recognition immediately without processing pending audio. Sets `isRecording` to `false`. Discards any aggregated transcript without emitting.
 
-### `addEventListener(eventType, callback)`
+### `on(eventType, callback)`
 
 Registers a callback for the given event type. Multiple callbacks can be registered for the same type — they stack and all fire in registration order.
 
@@ -139,7 +150,7 @@ Registers a callback for the given event type. Multiple callbacks can be registe
 
 Throws if `eventType` is not a valid `EventType`.
 
-### `removeEventListener(eventType, callback?)`
+### `off(eventType, callback?)`
 
 Removes a listener for the given event type.
 
@@ -150,23 +161,26 @@ Removes a listener for the given event type.
 
 Throws if `eventType` is not a valid `EventType`.
 
-### `once(eventType, callback)`
+### `cleanup()`
 
-Registers a one-shot listener that automatically unregisters itself after firing once.
+Stops recognition, removes all registered listeners, and releases the internal `SpeechRecognition` instance. The returned `VocalInstance` cannot be reused after `cleanup()`.
 
-| Parameter | Type                                              | Description                                |
-| --------- | ------------------------------------------------- | ------------------------------------------ |
-| eventType | `EventType`                                       | One of the valid event type strings        |
-| callback  | `ResultEventHandler \| ErrorEventHandler \| GenericEventHandler` | Callback invoked once when the event fires |
+## Migration from the class-based API (v1.x)
 
 ```js
-vocal.once('result', (event, bestAlternative, alternatives) => {
-    console.log(bestAlternative)
-    vocal.stop()
-})
+// Before
+import { Vocal } from '@untemps/vocal'
+if (!Vocal.isSupported) throw new Error()
+const vocal = new Vocal({ lang: 'fr-FR' })
+vocal.addEventListener('result', cb)
+vocal.removeEventListener('result', cb)
+
+// After
+import { createVocal, isSupported } from '@untemps/vocal'
+if (!isSupported()) throw new Error()
+const vocal = createVocal({ lang: 'fr-FR' })
+vocal.on('result', cb)
+vocal.off('result', cb)
 ```
 
-### `cleanup()`
-
-Stops recognition, removes all registered listeners, and releases the internal `SpeechRecognition` instance. The `Vocal` object cannot be reused after `cleanup()`.
-
+Side-effect methods (`stop`, `abort`, `on`, `off`, `cleanup`) now return `void` — method chaining is no longer supported. `Vocal.eventTypes` is now exported as the top-level `eventTypes` const.

package/dist/index.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@untemps/user-permissions-utils`);var t=1e3,n=new Set([`not-allowed`,`service-not-allowed`,`audio-capture`]),r=class r{static defaultOptions={grammars:null,lang:`en-US`,continuous:!1,interimResults:!1,maxAlternatives:1};static eventTypes={AUDIO_END:`audioend`,AUDIO_START:`audiostart`,END:`end`,ERROR:`error`,NO_MATCH:`nomatch`,RESULT:`result`,SOUND_END:`soundend`,SOUND_START:`soundstart`,SPEECH_END:`speechend`,SPEECH_START:`speechstart`,START:`start`};static get isSupported(){return!!r._resolveSpeechRecognition()&&!!(0,e.isNavigatorPermissionsSupported)()&&!!(0,e.isNavigatorMediaDevicesSupported)()}static set isSupported(e){throw Error(`You cannot set isSupported directly.`)}_instance=null;_listeners={};_isRecording=!1;_explicitStop=!1;_lastStartedAt=0;_restartTimeoutId=null;_isRestarting=!1;_finalTranscripts=[];_onEnd=e=>{if(this._shouldAutoRestart()){let n=Math.max(0,t-(Date.now()-this._lastStartedAt));this._isRestarting=!0,this._restartTimeoutId=setTimeout(()=>this._restart(),n),e.stopImmediatePropagation();return}this._isRecording=!1};_onStart=e=>{this._isRestarting&&(e.stopImmediatePropagation(),queueMicrotask(()=>{this._isRestarting=!1}))};_onError=e=>{n.has(e.error)&&(this._explicitStop=!0,this._clearRestartTimeout(),this._isRecording=!1)};_onResult=e=>{let t=e,n=t.results?.[t.resultIndex];n?.isFinal&&this._finalTranscripts.push(r._pickBestAlternative(Array.from(n)).transcript)};constructor(e){let t=r._resolveSpeechRecognition();if(!t)throw new DOMException(`SpeechRecognition not supported`,`NOT_SUPPORTED_ERR`);this._instance=new t;let{grammars:n,...i}={...r.defaultOptions,...e??{}},a=this._instance;if(Object.assign(a,i),n)a.grammars=n;else{let e=r._resolveSpeechGrammarList();a.grammars=e?new e:null}this._instance.addEventListener(r.eventTypes.END,this._onEnd),this._instance.addEventListener(r.eventTypes.START,this._onStart),this._instance.addEventListener(r.eventTypes.ERROR,this._onError),this._instance.addEventListener(r.eventTypes.RESULT,this._onResult)}get isRecording(){return this._isRecording}set isRecording(e){throw Error(`You cannot set isRecording directly.`)}async start({signal:t}={}){if(this._instance)try{if(!await(0,e.getUserMediaStream)(`microphone`,{audio:!0},{signal:t}))throw Error(`Unable to retrieve the stream from media device`);this._explicitStop=!1,this._finalTranscripts=[],this._instance.start(),this._isRecording=!0,this._lastStartedAt=Date.now()}catch(e){if(e instanceof Error&&e.name===`AbortError`)return this;throw e}return this}stop(){return this._instance&&(this._explicitStop=!0,this._clearRestartTimeout(),this._emitAggregatedResult(),this._instance.stop(),this._isRecording=!1),this}abort(){return this._instance&&(this._explicitStop=!0,this._clearRestartTimeout(),this._instance.abort(),this._isRecording=!1,this._finalTranscripts=[]),this}addEventListener(e,t){if(!this._includesEventType(e))throw Error(this._unknownEventTypeMessage(e));if(this._instance){let n=n=>{if(this._isRestarting&&(e===r.eventTypes.END||e===r.eventTypes.START))return;let i=[];if(e===r.eventTypes.RESULT){let e=n;if(e.results?.length>0&&e.resultIndex<e.results.length){let t=Array.from(e.results[e.resultIndex]);i.push(r._pickBestAlternative(t).transcript,t.map(e=>e.transcript))}}t.call(this,n,...i)};this._instance.addEventListener(e,n),this._listeners[e]||(this._listeners[e]=[]),this._listeners[e].push({callback:t,handler:n})}return this}removeEventListener(e,t){if(!this._includesEventType(e))throw Error(this._unknownEventTypeMessage(e));let n=this._instance;if(n&&this._listeners[e])if(t!==void 0){let r=this._listeners[e].findIndex(e=>e.callback===t);r!==-1&&(n.removeEventListener(e,this._listeners[e][r].handler),this._listeners[e].splice(r,1),this._listeners[e].length===0&&delete this._listeners[e])}else this._listeners[e].forEach(({handler:t})=>n.removeEventListener(e,t)),delete this._listeners[e];return this}once(e,t){let n=(...r)=>{t.call(this,...r),this.removeEventListener(e,n)};return this.addEventListener(e,n)}cleanup(){return this.stop(),Object.keys(this._listeners).forEach(e=>this.removeEventListener(e)),this._instance?.removeEventListener(r.eventTypes.END,this._onEnd),this._instance?.removeEventListener(r.eventTypes.START,this._onStart),this._instance?.removeEventListener(r.eventTypes.ERROR,this._onError),this._instance?.removeEventListener(r.eventTypes.RESULT,this._onResult),this._instance=null,this}_restart=()=>{this._restartTimeoutId=null;try{this._instance.start(),this._lastStartedAt=Date.now()}catch{this._isRestarting=!1,this._isRecording=!1}};_emitAggregatedResult(){let e=this._finalTranscripts;if(this._finalTranscripts=[],e.length===0)return;let t=e.join(` `).trim(),n=Object.assign([{transcript:t,confidence:1}],{isFinal:!0}),i=Object.assign(new Event(r.eventTypes.RESULT),{resultIndex:0,results:[n]});[...this._listeners[r.eventTypes.RESULT]??[]].forEach(({handler:e})=>e(i))}static _pickBestAlternative(e){return e.reduce((e,t)=>(t.confidence??0)>(e.confidence??0)?t:e)}_shouldAutoRestart(){return!!this._instance&&!this._explicitStop&&this._instance.continuous}_clearRestartTimeout(){this._restartTimeoutId!==null&&(clearTimeout(this._restartTimeoutId),this._restartTimeoutId=null),this._isRestarting=!1}_includesEventType(e){return Object.values(r.eventTypes).includes(e)}_unknownEventTypeMessage(e){return`Unknown event type "${e}". Valid types are: ${Object.values(r.eventTypes).join(`, `)}.`}static _resolveSpeechRecognition(){if(!(typeof window>`u`))return window.SpeechRecognition??window.webkitSpeechRecognition??window.mozSpeechRecognition??window.msSpeechRecognition}static _resolveSpeechGrammarList(){return window.SpeechGrammarList??window.webkitSpeechGrammarList??window.mozSpeechGrammarList??window.msSpeechGrammarList}};exports.Vocal=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@untemps/user-permissions-utils`);var t={AUDIO_END:`audioend`,AUDIO_START:`audiostart`,END:`end`,ERROR:`error`,NO_MATCH:`nomatch`,RESULT:`result`,SOUND_END:`soundend`,SOUND_START:`soundstart`,SPEECH_END:`speechend`,SPEECH_START:`speechstart`,START:`start`},n=1e3,r=new Set([`not-allowed`,`service-not-allowed`,`audio-capture`]),i={grammars:null,lang:`en-US`,continuous:!1,interimResults:!1,maxAlternatives:1},a=()=>{if(!(typeof window>`u`))return window.SpeechRecognition??window.webkitSpeechRecognition??window.mozSpeechRecognition??window.msSpeechRecognition},o=()=>window.SpeechGrammarList??window.webkitSpeechGrammarList??window.mozSpeechGrammarList??window.msSpeechGrammarList,s=e=>e.reduce((e,t)=>(t.confidence??0)>(e.confidence??0)?t:e),c=e=>Object.values(t).includes(e),l=e=>`Unknown event type "${e}". Valid types are: ${Object.values(t).join(`, `)}.`,u=()=>!!a()&&!!(0,e.isNavigatorPermissionsSupported)()&&!!(0,e.isNavigatorMediaDevicesSupported)(),d=u=>{let d=a();if(!d)throw new DOMException(`SpeechRecognition not supported`,`NOT_SUPPORTED_ERR`);let f=new d,p={},m=!1,h=!1,g=0,_=null,v=!1,y=[],b={...i,...u??{}};if(f.lang=b.lang,f.continuous=b.continuous,f.interimResults=b.interimResults,f.maxAlternatives=b.maxAlternatives,b.grammars)f.grammars=b.grammars;else{let e=o();f.grammars=e?new e:null}let x=()=>{_!==null&&(clearTimeout(_),_=null),v=!1},S=()=>!!f&&!h&&f.continuous,C=()=>{_=null;try{f.start(),g=Date.now()}catch{v=!1,m=!1}},w=()=>{let e=y;if(y=[],e.length===0||!p[t.RESULT]?.length)return;let n=e.join(` `).trim(),r=Object.assign([{transcript:n,confidence:1}],{isFinal:!0}),i=Object.assign(new Event(t.RESULT),{resultIndex:0,results:[r]});[...p[t.RESULT]].forEach(({handler:e})=>e(i))},T=[[t.END,e=>{if(S()){let t=Math.max(0,n-(Date.now()-g));v=!0,_=setTimeout(C,t),e.stopImmediatePropagation();return}m=!1}],[t.START,e=>{v&&(e.stopImmediatePropagation(),queueMicrotask(()=>{v=!1}))}],[t.ERROR,e=>{r.has(e.error)&&(h=!0,x(),m=!1)}],[t.RESULT,e=>{let t=e,n=t.results?.[t.resultIndex];n?.isFinal&&y.push(s(Array.from(n)).transcript)}]];T.forEach(([e,t])=>f.addEventListener(e,t));let E=async({signal:t}={})=>{if(f)try{let n=await(0,e.getUserMediaStream)(`microphone`,{audio:!0},{signal:t});if(t?.aborted)return;if(!n)throw Error(`Unable to retrieve the stream from media device`);h=!1,y=[],f.start(),m=!0,g=Date.now()}catch(e){if(e instanceof Error&&e.name===`AbortError`)return;throw e}},D=()=>{f&&(h=!0,x(),w(),f.stop(),m=!1)},O=()=>{f&&(h=!0,x(),f.abort(),m=!1,y=[])},k=(e,n)=>{if(!c(e))throw Error(l(e));if(!f)return;let r=r=>{if(v&&(e===t.END||e===t.START))return;if(e!==t.RESULT){n(r);return}let i=r;if(!(i.results?.length>0)||i.resultIndex>=i.results.length){n(r);return}let a=Array.from(i.results[i.resultIndex]);n(r,s(a).transcript,a.map(e=>e.transcript))};f.addEventListener(e,r),p[e]||(p[e]=[]),p[e].push({callback:n,handler:r})},A=(e,t)=>{if(!c(e))throw Error(l(e));if(!(!f||!p[e]))if(t!==void 0){let n=p[e].findIndex(e=>e.callback===t);n!==-1&&(f.removeEventListener(e,p[e][n].handler),p[e].splice(n,1),p[e].length===0&&delete p[e])}else p[e].forEach(({handler:t})=>f.removeEventListener(e,t)),delete p[e]};return{get isRecording(){return m},start:E,stop:D,abort:O,on:k,off:A,cleanup:()=>{D(),Object.keys(p).forEach(e=>A(e)),T.forEach(([e,t])=>f?.removeEventListener(e,t)),f=null}}};exports.createVocal=d,exports.eventTypes=t,exports.isSupported=u;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { default as Vocal } from './Vocal';
-export type { VocalOptions, EventType, ResultEventHandler, ErrorEventHandler, GenericEventHandler, EventHandlerFor, } from './Vocal';
+export { createVocal, isSupported, eventTypes } from './Vocal';
+export type { VocalOptions, VocalInstance, EventType, ResultEventHandler, ErrorEventHandler, GenericEventHandler, EventHandlerFor, } from './Vocal';

package/dist/index.es.js

@@ -1,184 +1,141 @@
 import { getUserMediaStream as e, isNavigatorMediaDevicesSupported as t, isNavigatorPermissionsSupported as n } from "@untemps/user-permissions-utils";
 //#region src/Vocal.ts
-var r = 1e3, i = new Set([
+var r = {
+	AUDIO_END: "audioend",
+	AUDIO_START: "audiostart",
+	END: "end",
+	ERROR: "error",
+	NO_MATCH: "nomatch",
+	RESULT: "result",
+	SOUND_END: "soundend",
+	SOUND_START: "soundstart",
+	SPEECH_END: "speechend",
+	SPEECH_START: "speechstart",
+	START: "start"
+}, i = 1e3, a = new Set([
 	"not-allowed",
 	"service-not-allowed",
 	"audio-capture"
-]), a = class a {
-	static defaultOptions = {
-		grammars: null,
-		lang: "en-US",
-		continuous: !1,
-		interimResults: !1,
-		maxAlternatives: 1
+]), o = {
+	grammars: null,
+	lang: "en-US",
+	continuous: !1,
+	interimResults: !1,
+	maxAlternatives: 1
+}, s = () => {
+	if (!(typeof window > "u")) return window.SpeechRecognition ?? window.webkitSpeechRecognition ?? window.mozSpeechRecognition ?? window.msSpeechRecognition;
+}, c = () => window.SpeechGrammarList ?? window.webkitSpeechGrammarList ?? window.mozSpeechGrammarList ?? window.msSpeechGrammarList, l = (e) => e.reduce((e, t) => (t.confidence ?? 0) > (e.confidence ?? 0) ? t : e), u = (e) => Object.values(r).includes(e), d = (e) => `Unknown event type "${e}". Valid types are: ${Object.values(r).join(", ")}.`, f = () => !!s() && !!n() && !!t(), p = (t) => {
+	let n = s();
+	if (!n) throw new DOMException("SpeechRecognition not supported", "NOT_SUPPORTED_ERR");
+	let f = new n(), p = {}, m = !1, h = !1, g = 0, _ = null, v = !1, y = [], b = {
+		...o,
+		...t ?? {}
 	};
-	static eventTypes = {
-		AUDIO_END: "audioend",
-		AUDIO_START: "audiostart",
-		END: "end",
-		ERROR: "error",
-		NO_MATCH: "nomatch",
-		RESULT: "result",
-		SOUND_END: "soundend",
-		SOUND_START: "soundstart",
-		SPEECH_END: "speechend",
-		SPEECH_START: "speechstart",
-		START: "start"
-	};
-	static get isSupported() {
-		return !!a._resolveSpeechRecognition() && !!n() && !!t();
-	}
-	static set isSupported(e) {
-		throw Error("You cannot set isSupported directly.");
-	}
-	_instance = null;
-	_listeners = {};
-	_isRecording = !1;
-	_explicitStop = !1;
-	_lastStartedAt = 0;
-	_restartTimeoutId = null;
-	_isRestarting = !1;
-	_finalTranscripts = [];
-	_onEnd = (e) => {
-		if (this._shouldAutoRestart()) {
-			let t = Math.max(0, r - (Date.now() - this._lastStartedAt));
-			this._isRestarting = !0, this._restartTimeoutId = setTimeout(() => this._restart(), t), e.stopImmediatePropagation();
-			return;
-		}
-		this._isRecording = !1;
-	};
-	_onStart = (e) => {
-		this._isRestarting && (e.stopImmediatePropagation(), queueMicrotask(() => {
-			this._isRestarting = !1;
-		}));
-	};
-	_onError = (e) => {
-		i.has(e.error) && (this._explicitStop = !0, this._clearRestartTimeout(), this._isRecording = !1);
-	};
-	_onResult = (e) => {
-		let t = e, n = t.results?.[t.resultIndex];
-		n?.isFinal && this._finalTranscripts.push(a._pickBestAlternative(Array.from(n)).transcript);
-	};
-	constructor(e) {
-		let t = a._resolveSpeechRecognition();
-		if (!t) throw new DOMException("SpeechRecognition not supported", "NOT_SUPPORTED_ERR");
-		this._instance = new t();
-		let { grammars: n, ...r } = {
-			...a.defaultOptions,
-			...e ?? {}
-		}, i = this._instance;
-		if (Object.assign(i, r), n) i.grammars = n;
-		else {
-			let e = a._resolveSpeechGrammarList();
-			i.grammars = e ? new e() : null;
-		}
-		this._instance.addEventListener(a.eventTypes.END, this._onEnd), this._instance.addEventListener(a.eventTypes.START, this._onStart), this._instance.addEventListener(a.eventTypes.ERROR, this._onError), this._instance.addEventListener(a.eventTypes.RESULT, this._onResult);
-	}
-	get isRecording() {
-		return this._isRecording;
-	}
-	set isRecording(e) {
-		throw Error("You cannot set isRecording directly.");
-	}
-	async start({ signal: t } = {}) {
-		if (this._instance) try {
-			if (!await e("microphone", { audio: !0 }, { signal: t })) throw Error("Unable to retrieve the stream from media device");
-			this._explicitStop = !1, this._finalTranscripts = [], this._instance.start(), this._isRecording = !0, this._lastStartedAt = Date.now();
-		} catch (e) {
-			if (e instanceof Error && e.name === "AbortError") return this;
-			throw e;
-		}
-		return this;
-	}
-	stop() {
-		return this._instance && (this._explicitStop = !0, this._clearRestartTimeout(), this._emitAggregatedResult(), this._instance.stop(), this._isRecording = !1), this;
-	}
-	abort() {
-		return this._instance && (this._explicitStop = !0, this._clearRestartTimeout(), this._instance.abort(), this._isRecording = !1, this._finalTranscripts = []), this;
-	}
-	addEventListener(e, t) {
-		if (!this._includesEventType(e)) throw Error(this._unknownEventTypeMessage(e));
-		if (this._instance) {
-			let n = (n) => {
-				if (this._isRestarting && (e === a.eventTypes.END || e === a.eventTypes.START)) return;
-				let r = [];
-				if (e === a.eventTypes.RESULT) {
-					let e = n;
-					if (e.results?.length > 0 && e.resultIndex < e.results.length) {
-						let t = Array.from(e.results[e.resultIndex]);
-						r.push(a._pickBestAlternative(t).transcript, t.map((e) => e.transcript));
-					}
-				}
-				t.call(this, n, ...r);
-			};
-			this._instance.addEventListener(e, n), this._listeners[e] || (this._listeners[e] = []), this._listeners[e].push({
-				callback: t,
-				handler: n
-			});
-		}
-		return this;
-	}
-	removeEventListener(e, t) {
-		if (!this._includesEventType(e)) throw Error(this._unknownEventTypeMessage(e));
-		let n = this._instance;
-		if (n && this._listeners[e]) if (t !== void 0) {
-			let r = this._listeners[e].findIndex((e) => e.callback === t);
-			r !== -1 && (n.removeEventListener(e, this._listeners[e][r].handler), this._listeners[e].splice(r, 1), this._listeners[e].length === 0 && delete this._listeners[e]);
-		} else this._listeners[e].forEach(({ handler: t }) => n.removeEventListener(e, t)), delete this._listeners[e];
-		return this;
-	}
-	once(e, t) {
-		let n = (...r) => {
-			t.call(this, ...r), this.removeEventListener(e, n);
-		};
-		return this.addEventListener(e, n);
-	}
-	cleanup() {
-		return this.stop(), Object.keys(this._listeners).forEach((e) => this.removeEventListener(e)), this._instance?.removeEventListener(a.eventTypes.END, this._onEnd), this._instance?.removeEventListener(a.eventTypes.START, this._onStart), this._instance?.removeEventListener(a.eventTypes.ERROR, this._onError), this._instance?.removeEventListener(a.eventTypes.RESULT, this._onResult), this._instance = null, this;
-	}
-	_restart = () => {
-		this._restartTimeoutId = null;
+	if (f.lang = b.lang, f.continuous = b.continuous, f.interimResults = b.interimResults, f.maxAlternatives = b.maxAlternatives, b.grammars) f.grammars = b.grammars;
+	else {
+		let e = c();
+		f.grammars = e ? new e() : null;
+	}
+	let x = () => {
+		_ !== null && (clearTimeout(_), _ = null), v = !1;
+	}, S = () => !!f && !h && f.continuous, C = () => {
+		_ = null;
 		try {
-			this._instance.start(), this._lastStartedAt = Date.now();
+			f.start(), g = Date.now();
 		} catch {
-			this._isRestarting = !1, this._isRecording = !1;
+			v = !1, m = !1;
 		}
-	};
-	_emitAggregatedResult() {
-		let e = this._finalTranscripts;
-		if (this._finalTranscripts = [], e.length === 0) return;
+	}, w = () => {
+		let e = y;
+		if (y = [], e.length === 0 || !p[r.RESULT]?.length) return;
 		let t = e.join(" ").trim(), n = Object.assign([{
 			transcript: t,
 			confidence: 1
-		}], { isFinal: !0 }), r = Object.assign(new Event(a.eventTypes.RESULT), {
+		}], { isFinal: !0 }), i = Object.assign(new Event(r.RESULT), {
 			resultIndex: 0,
 			results: [n]
 		});
-		[...this._listeners[a.eventTypes.RESULT] ?? []].forEach(({ handler: e }) => e(r));
-	}
-	static _pickBestAlternative(e) {
-		return e.reduce((e, t) => (t.confidence ?? 0) > (e.confidence ?? 0) ? t : e);
-	}
-	_shouldAutoRestart() {
-		return !!this._instance && !this._explicitStop && this._instance.continuous;
-	}
-	_clearRestartTimeout() {
-		this._restartTimeoutId !== null && (clearTimeout(this._restartTimeoutId), this._restartTimeoutId = null), this._isRestarting = !1;
-	}
-	_includesEventType(e) {
-		return Object.values(a.eventTypes).includes(e);
-	}
-	_unknownEventTypeMessage(e) {
-		return `Unknown event type "${e}". Valid types are: ${Object.values(a.eventTypes).join(", ")}.`;
-	}
-	static _resolveSpeechRecognition() {
-		if (!(typeof window > "u")) return window.SpeechRecognition ?? window.webkitSpeechRecognition ?? window.mozSpeechRecognition ?? window.msSpeechRecognition;
-	}
-	static _resolveSpeechGrammarList() {
-		return window.SpeechGrammarList ?? window.webkitSpeechGrammarList ?? window.mozSpeechGrammarList ?? window.msSpeechGrammarList;
-	}
+		[...p[r.RESULT]].forEach(({ handler: e }) => e(i));
+	}, T = [
+		[r.END, (e) => {
+			if (S()) {
+				let t = Math.max(0, i - (Date.now() - g));
+				v = !0, _ = setTimeout(C, t), e.stopImmediatePropagation();
+				return;
+			}
+			m = !1;
+		}],
+		[r.START, (e) => {
+			v && (e.stopImmediatePropagation(), queueMicrotask(() => {
+				v = !1;
+			}));
+		}],
+		[r.ERROR, (e) => {
+			a.has(e.error) && (h = !0, x(), m = !1);
+		}],
+		[r.RESULT, (e) => {
+			let t = e, n = t.results?.[t.resultIndex];
+			n?.isFinal && y.push(l(Array.from(n)).transcript);
+		}]
+	];
+	T.forEach(([e, t]) => f.addEventListener(e, t));
+	let E = async ({ signal: t } = {}) => {
+		if (f) try {
+			let n = await e("microphone", { audio: !0 }, { signal: t });
+			if (t?.aborted) return;
+			if (!n) throw Error("Unable to retrieve the stream from media device");
+			h = !1, y = [], f.start(), m = !0, g = Date.now();
+		} catch (e) {
+			if (e instanceof Error && e.name === "AbortError") return;
+			throw e;
+		}
+	}, D = () => {
+		f && (h = !0, x(), w(), f.stop(), m = !1);
+	}, O = () => {
+		f && (h = !0, x(), f.abort(), m = !1, y = []);
+	}, k = (e, t) => {
+		if (!u(e)) throw Error(d(e));
+		if (!f) return;
+		let n = (n) => {
+			if (v && (e === r.END || e === r.START)) return;
+			if (e !== r.RESULT) {
+				t(n);
+				return;
+			}
+			let i = n;
+			if (!(i.results?.length > 0) || i.resultIndex >= i.results.length) {
+				t(n);
+				return;
+			}
+			let a = Array.from(i.results[i.resultIndex]);
+			t(n, l(a).transcript, a.map((e) => e.transcript));
+		};
+		f.addEventListener(e, n), p[e] || (p[e] = []), p[e].push({
+			callback: t,
+			handler: n
+		});
+	}, A = (e, t) => {
+		if (!u(e)) throw Error(d(e));
+		if (!(!f || !p[e])) if (t !== void 0) {
+			let n = p[e].findIndex((e) => e.callback === t);
+			n !== -1 && (f.removeEventListener(e, p[e][n].handler), p[e].splice(n, 1), p[e].length === 0 && delete p[e]);
+		} else p[e].forEach(({ handler: t }) => f.removeEventListener(e, t)), delete p[e];
+	};
+	return {
+		get isRecording() {
+			return m;
+		},
+		start: E,
+		stop: D,
+		abort: O,
+		on: k,
+		off: A,
+		cleanup: () => {
+			D(), Object.keys(p).forEach((e) => A(e)), T.forEach(([e, t]) => f?.removeEventListener(e, t)), f = null;
+		}
+	};
 };
 //#endregion
-export { a as Vocal };
+export { p as createVocal, r as eventTypes, f as isSupported };
 
 //# sourceMappingURL=index.es.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@untemps/vocal",
-	"version": "2.0.0-beta.20",
+	"version": "2.0.0-beta.22",
 	"description": "Class wrapped around the SpeechRecognition Web API",
 	"repository": "git@github.com:untemps/vocal.git",
 	"keywords": [