annyang 2.6.1 → 3.0.0

package/dist/annyang.d.cts

@@ -0,0 +1,288 @@
+interface CallbackMap {
+    start: () => void;
+    end: () => void;
+    soundstart: () => void;
+    result: (phrases: string[]) => void;
+    resultMatch: (userSaid: string, commandText: string, phrases: string[]) => void;
+    resultNoMatch: (phrases: string[]) => void;
+    error: (event: SpeechRecognitionErrorEvent) => void;
+    errorNetwork: (event: SpeechRecognitionErrorEvent) => void;
+    errorPermissionBlocked: (event: SpeechRecognitionErrorEvent) => void;
+    errorPermissionDenied: (event: SpeechRecognitionErrorEvent) => void;
+}
+type CallbackType = keyof CallbackMap;
+/**
+ * Is SpeechRecognition supported in this environment?
+ *
+ * @returns {boolean} true if SpeechRecognition is supported by the browser
+ */
+declare const isSpeechRecognitionSupported: () => boolean;
+type CommandCallback = (...args: string[]) => void;
+interface CommandsList {
+    [key: string]: CommandCallback | {
+        regexp: RegExp;
+        callback: CommandCallback;
+    };
+}
+/**
+ * Add commands that annyang will respond to.
+ * By default this will add to the existing commands. Pass `true` as the second parameter to remove all existing commands first.
+ *
+ * #### Examples:
+ * ````javascript
+ * const commands1 = {'hello :name': helloFunction, 'howdy': helloFunction};
+ * const commands2 = {'hi': helloFunction};
+ *
+ * annyang.addCommands(commands1);
+ * annyang.addCommands(commands2);
+ * // annyang will now listen for all three commands defined in commands1 and commands2
+ *
+ * annyang.addCommands(commands2, true);
+ * // annyang will now only listen for the command in commands2
+ * ````
+ *
+ * @param {Object} commands - Commands that annyang should listen for
+ * @param {boolean} [resetCommands=false] - Remove all existing commands before adding new commands? * @see [Commands Object](#commands-object)
+ */
+declare const addCommands: (commands: CommandsList, resetCommands?: boolean) => void;
+/**
+ * Remove existing commands. Called with a single phrase, an array of phrases, or with no params to remove all commands.
+ *
+ * #### Examples:
+ * ````javascript
+ * const commands = {'hello': helloFunction, 'howdy': helloFunction, 'hi': helloFunction};
+ *
+ * // Remove all existing commands
+ * annyang.removeCommands();
+ *
+ * // Add some commands
+ * annyang.addCommands(commands);
+ *
+ * // Don't respond to hello
+ * annyang.removeCommands('hello');
+ *
+ * // Don't respond to howdy or hi
+ * annyang.removeCommands(['howdy', 'hi']);
+ * ````
+ * @param {string|string[]|undefined} [commandsToRemove] - Commands to remove
+ */
+declare const removeCommands: (commandsToRemove?: string | string[] | undefined) => void;
+interface StartOptions {
+    autoRestart?: boolean;
+    continuous?: boolean;
+    paused?: boolean;
+}
+/**
+ * Start listening.
+ * It's a good idea to call this after adding some commands first (but not mandatory)
+ *
+ * Receives an optional options object which supports the following options:
+ *
+ * - `autoRestart`  (boolean) Should annyang restart itself if it is closed indirectly (e.g. because of silence or window conflicts)?
+ * - `continuous`   (boolean) Allow forcing continuous mode on or off. annyang is pretty smart about this, so only set this if you know what you're doing.
+ * - `paused`       (boolean) Start annyang in paused mode.
+ *
+ * #### Examples:
+ * ````javascript
+ * // Start listening, don't restart automatically
+ * annyang.start({ autoRestart: false });
+ * // Start listening, don't restart automatically, stop recognition after first phrase recognized
+ * annyang.start({ autoRestart: false, continuous: false });
+ * ````
+ * @param {Object} [options] - Optional options.
+ */
+declare const start: (options?: StartOptions) => void;
+/**
+ * Stop listening and turn off the mic.
+ *
+ * Alternatively, to only temporarily pause annyang responding to commands without stopping the SpeechRecognition engine or closing the mic, use pause() instead.
+ * @see [pause()](#pause)
+ */
+declare const abort: () => void;
+/**
+ * Pause listening. annyang will stop responding to commands (until the resume or start methods are called), without turning off the browser's SpeechRecognition engine or the mic.
+ *
+ * Alternatively, to stop the SpeechRecognition engine and close the mic, use abort() instead.
+ * @see [abort()](#abort)
+ */
+declare const pause: () => void;
+/**
+ * Resumes listening and restore command callback execution when a command is matched.
+ * If SpeechRecognition was aborted (stopped), start it.
+ */
+declare const resume: () => void;
+/**
+ * Add a callback function to be called in case one of the following events happens:
+ *
+ * * `start` - Fired as soon as the browser's Speech Recognition engine starts listening.
+ *
+ * * `soundstart` - Fired as soon as any sound (possibly speech) has been detected.
+ *
+ *     This will fire once per Speech Recognition starting. See https://is.gd/annyang_sound_start.
+ *
+ * * `error` - Fired when the browser's Speech Recognition engine returns an error, this generic error callback will be followed by more accurate error callbacks (both will fire if both are defined).
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorNetwork` - Fired when Speech Recognition fails because of a network error.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorPermissionBlocked` - Fired when the browser blocks the permission request to use Speech Recognition.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorPermissionDenied` - Fired when the user blocks the permission request to use Speech Recognition.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `end` - Fired when the browser's Speech Recognition engine stops.
+ *
+ * * `result` - Fired as soon as some speech was identified. This generic callback will be followed by either the `resultMatch` or `resultNoMatch` callbacks.
+ *
+ *     The Callback functions for this event will be called with an array of possible phrases the user said as the first argument.
+ *
+ * * `resultMatch` - Fired when annyang was able to match between what the user said and a registered command.
+ *
+ *     The Callback functions for this event will be called with three arguments in the following order:
+ *
+ *     * The phrase the user said that matched a command.
+ *     * The command that was matched.
+ *     * An array of possible alternative phrases the user might have said.
+ *
+ * * `resultNoMatch` - Fired when what the user said didn't match any of the registered commands.
+ *
+ *     Callback functions for this event will be called with an array of possible phrases the user might have said as the first argument.
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.addCallback('resultMatch', (userSaid, commandText, phrases) => {
+ *   console.log(userSaid); // sample output: 'hello'
+ *   console.log(commandText); // sample output: 'hello (there)'
+ *   console.log(phrases); // sample output: ['hello', 'halo', 'yellow', 'polo', 'hello kitty']
+ * });
+ *
+ * // Returns an unsubscribe function
+ * const unsubscribe = annyang.addCallback('error', () => {
+ *   console.log('There was an error!');
+ * });
+ * unsubscribe(); // removes the callback
+ * ````
+ * @param {string} type - Name of event that will trigger this callback
+ * @param {function} callback - The function to call when event is triggered
+ * @param {Object} [context] - Optional context for the callback function
+ * @returns {function} A function that removes this callback when called
+ */
+declare const addCallback: <T extends CallbackType>(type: T, callback: CallbackMap[T], context?: object | undefined) => (() => void);
+/**
+ * Remove callbacks from events.
+ *
+ * - Pass an event name and a callback command to remove that callback command from that event type.
+ * - Pass just an event name to remove all callback commands from that event type.
+ * - Pass undefined as event name and a callback command to remove that callback command from all event types.
+ * - Pass no params to remove all callback commands from all event types.
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.addCallback('start', myFunction1);
+ * annyang.addCallback('start', myFunction2);
+ * annyang.addCallback('end', myFunction1);
+ * annyang.addCallback('end', myFunction2);
+ *
+ * // Remove all callbacks from all events:
+ * annyang.removeCallback();
+ *
+ * // Remove all callbacks attached to end event:
+ * annyang.removeCallback('end');
+ *
+ * // Remove myFunction2 from being called on start:
+ * annyang.removeCallback('start', myFunction2);
+ *
+ * // Remove myFunction1 from being called on all events:
+ * annyang.removeCallback(undefined, myFunction1);
+ * ````
+ *
+ * @param type Name of event type to remove callback from
+ * @param callback The callback function to remove
+ * @returns undefined
+ */
+declare const removeCallback: (type?: CallbackType, callback?: CallbackMap[CallbackType]) => void;
+/**
+ * Returns true if speech recognition is currently on.
+ * Returns false if speech recognition is off or annyang is paused.
+ *
+ * @returns true if SpeechRecognition is on and annyang is not paused
+ */
+declare const isListening: () => boolean;
+type AnnyangState = 'idle' | 'listening' | 'paused';
+/**
+ * Returns the current state of annyang.
+ *
+ * @returns {'idle' | 'listening' | 'paused'} The current state
+ */
+declare const getState: () => AnnyangState;
+/**
+ * Set the language the user will speak in. If this method is not called, annyang defaults to 'en-US'.
+ *
+ * @param {string} language - The language (locale)
+ * @see [Languages](https://github.com/TalAter/annyang/blob/master/docs/FAQ.md#what-languages-are-supported)
+ */
+declare const setLanguage: (language: string) => void;
+/**
+ * Turn on the output of debug messages to the console.
+ *
+ * @param {boolean} [newState=true] - Turn debug messages on or off
+ */
+declare const debug: (newState?: boolean) => void;
+/**
+ * Match text against registered commands and fire the corresponding callbacks.
+ * Works independently of the speech recognition engine — does not require `start()`, and works even in
+ * environments where SpeechRecognition is not supported.
+ *
+ * Can accept either a string containing a single sentence or an array containing multiple sentences to be checked
+ * in order until one of them matches a command (similar to the way Speech Recognition Alternatives are parsed)
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.trigger('Time for some thrilling heroics');
+ * annyang.trigger(
+ *     ['Time for some thrilling heroics', 'Time for some thrilling aerobics']
+ *   );
+ * ````
+ *
+ * @param sentences - A sentence as a string or an array of strings of possible sentences
+ */
+declare const trigger: (sentences?: string | string[]) => void;
+/**
+ * Returns the instance of the browser's SpeechRecognition object used by annyang.
+ * Useful in case you want direct access to the browser's Speech Recognition engine.
+ *
+ * @returns SpeechRecognition The browser's Speech Recognizer instance currently used by annyang
+ */
+declare const getSpeechRecognizer: () => SpeechRecognition | undefined;
+/**
+ * @deprecated annyang no longer requires manual initialization. It initializes automatically on `start()` or `addCommands()`. Remove any calls to `init()`.
+ */
+declare const initDeprecated: () => void;
+
+declare const annyang: {
+    readonly isSpeechRecognitionSupported: () => boolean;
+    readonly addCommands: (commands: CommandsList, resetCommands?: boolean) => void;
+    readonly removeCommands: (commandsToRemove?: string | string[] | undefined) => void;
+    readonly start: (options?: StartOptions) => void;
+    readonly abort: () => void;
+    readonly pause: () => void;
+    readonly resume: () => void;
+    readonly addCallback: <T extends CallbackType>(type: T, callback: CallbackMap[T], context?: object | undefined) => (() => void);
+    readonly removeCallback: (type?: CallbackType, callback?: CallbackMap[CallbackType]) => void;
+    readonly isListening: () => boolean;
+    readonly setLanguage: (language: string) => void;
+    readonly trigger: (sentences?: string | string[]) => void;
+    readonly debug: (newState?: boolean) => void;
+    readonly getSpeechRecognizer: () => SpeechRecognition | undefined;
+    readonly getState: () => AnnyangState;
+    readonly init: () => void;
+    readonly state: AnnyangState;
+};
+
+export { type AnnyangState, type CallbackMap, type CallbackType, type CommandCallback, type CommandsList, type StartOptions, abort, addCallback, addCommands, debug, annyang as default, getSpeechRecognizer, getState, initDeprecated as init, isListening, isSpeechRecognitionSupported, pause, removeCallback, removeCommands, resume, setLanguage, start, trigger };

package/dist/annyang.d.ts

@@ -0,0 +1,288 @@
+interface CallbackMap {
+    start: () => void;
+    end: () => void;
+    soundstart: () => void;
+    result: (phrases: string[]) => void;
+    resultMatch: (userSaid: string, commandText: string, phrases: string[]) => void;
+    resultNoMatch: (phrases: string[]) => void;
+    error: (event: SpeechRecognitionErrorEvent) => void;
+    errorNetwork: (event: SpeechRecognitionErrorEvent) => void;
+    errorPermissionBlocked: (event: SpeechRecognitionErrorEvent) => void;
+    errorPermissionDenied: (event: SpeechRecognitionErrorEvent) => void;
+}
+type CallbackType = keyof CallbackMap;
+/**
+ * Is SpeechRecognition supported in this environment?
+ *
+ * @returns {boolean} true if SpeechRecognition is supported by the browser
+ */
+declare const isSpeechRecognitionSupported: () => boolean;
+type CommandCallback = (...args: string[]) => void;
+interface CommandsList {
+    [key: string]: CommandCallback | {
+        regexp: RegExp;
+        callback: CommandCallback;
+    };
+}
+/**
+ * Add commands that annyang will respond to.
+ * By default this will add to the existing commands. Pass `true` as the second parameter to remove all existing commands first.
+ *
+ * #### Examples:
+ * ````javascript
+ * const commands1 = {'hello :name': helloFunction, 'howdy': helloFunction};
+ * const commands2 = {'hi': helloFunction};
+ *
+ * annyang.addCommands(commands1);
+ * annyang.addCommands(commands2);
+ * // annyang will now listen for all three commands defined in commands1 and commands2
+ *
+ * annyang.addCommands(commands2, true);
+ * // annyang will now only listen for the command in commands2
+ * ````
+ *
+ * @param {Object} commands - Commands that annyang should listen for
+ * @param {boolean} [resetCommands=false] - Remove all existing commands before adding new commands? * @see [Commands Object](#commands-object)
+ */
+declare const addCommands: (commands: CommandsList, resetCommands?: boolean) => void;
+/**
+ * Remove existing commands. Called with a single phrase, an array of phrases, or with no params to remove all commands.
+ *
+ * #### Examples:
+ * ````javascript
+ * const commands = {'hello': helloFunction, 'howdy': helloFunction, 'hi': helloFunction};
+ *
+ * // Remove all existing commands
+ * annyang.removeCommands();
+ *
+ * // Add some commands
+ * annyang.addCommands(commands);
+ *
+ * // Don't respond to hello
+ * annyang.removeCommands('hello');
+ *
+ * // Don't respond to howdy or hi
+ * annyang.removeCommands(['howdy', 'hi']);
+ * ````
+ * @param {string|string[]|undefined} [commandsToRemove] - Commands to remove
+ */
+declare const removeCommands: (commandsToRemove?: string | string[] | undefined) => void;
+interface StartOptions {
+    autoRestart?: boolean;
+    continuous?: boolean;
+    paused?: boolean;
+}
+/**
+ * Start listening.
+ * It's a good idea to call this after adding some commands first (but not mandatory)
+ *
+ * Receives an optional options object which supports the following options:
+ *
+ * - `autoRestart`  (boolean) Should annyang restart itself if it is closed indirectly (e.g. because of silence or window conflicts)?
+ * - `continuous`   (boolean) Allow forcing continuous mode on or off. annyang is pretty smart about this, so only set this if you know what you're doing.
+ * - `paused`       (boolean) Start annyang in paused mode.
+ *
+ * #### Examples:
+ * ````javascript
+ * // Start listening, don't restart automatically
+ * annyang.start({ autoRestart: false });
+ * // Start listening, don't restart automatically, stop recognition after first phrase recognized
+ * annyang.start({ autoRestart: false, continuous: false });
+ * ````
+ * @param {Object} [options] - Optional options.
+ */
+declare const start: (options?: StartOptions) => void;
+/**
+ * Stop listening and turn off the mic.
+ *
+ * Alternatively, to only temporarily pause annyang responding to commands without stopping the SpeechRecognition engine or closing the mic, use pause() instead.
+ * @see [pause()](#pause)
+ */
+declare const abort: () => void;
+/**
+ * Pause listening. annyang will stop responding to commands (until the resume or start methods are called), without turning off the browser's SpeechRecognition engine or the mic.
+ *
+ * Alternatively, to stop the SpeechRecognition engine and close the mic, use abort() instead.
+ * @see [abort()](#abort)
+ */
+declare const pause: () => void;
+/**
+ * Resumes listening and restore command callback execution when a command is matched.
+ * If SpeechRecognition was aborted (stopped), start it.
+ */
+declare const resume: () => void;
+/**
+ * Add a callback function to be called in case one of the following events happens:
+ *
+ * * `start` - Fired as soon as the browser's Speech Recognition engine starts listening.
+ *
+ * * `soundstart` - Fired as soon as any sound (possibly speech) has been detected.
+ *
+ *     This will fire once per Speech Recognition starting. See https://is.gd/annyang_sound_start.
+ *
+ * * `error` - Fired when the browser's Speech Recognition engine returns an error, this generic error callback will be followed by more accurate error callbacks (both will fire if both are defined).
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorNetwork` - Fired when Speech Recognition fails because of a network error.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorPermissionBlocked` - Fired when the browser blocks the permission request to use Speech Recognition.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `errorPermissionDenied` - Fired when the user blocks the permission request to use Speech Recognition.
+ *
+ *     The Callback function will be called with the error event as the first argument.
+ *
+ * * `end` - Fired when the browser's Speech Recognition engine stops.
+ *
+ * * `result` - Fired as soon as some speech was identified. This generic callback will be followed by either the `resultMatch` or `resultNoMatch` callbacks.
+ *
+ *     The Callback functions for this event will be called with an array of possible phrases the user said as the first argument.
+ *
+ * * `resultMatch` - Fired when annyang was able to match between what the user said and a registered command.
+ *
+ *     The Callback functions for this event will be called with three arguments in the following order:
+ *
+ *     * The phrase the user said that matched a command.
+ *     * The command that was matched.
+ *     * An array of possible alternative phrases the user might have said.
+ *
+ * * `resultNoMatch` - Fired when what the user said didn't match any of the registered commands.
+ *
+ *     Callback functions for this event will be called with an array of possible phrases the user might have said as the first argument.
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.addCallback('resultMatch', (userSaid, commandText, phrases) => {
+ *   console.log(userSaid); // sample output: 'hello'
+ *   console.log(commandText); // sample output: 'hello (there)'
+ *   console.log(phrases); // sample output: ['hello', 'halo', 'yellow', 'polo', 'hello kitty']
+ * });
+ *
+ * // Returns an unsubscribe function
+ * const unsubscribe = annyang.addCallback('error', () => {
+ *   console.log('There was an error!');
+ * });
+ * unsubscribe(); // removes the callback
+ * ````
+ * @param {string} type - Name of event that will trigger this callback
+ * @param {function} callback - The function to call when event is triggered
+ * @param {Object} [context] - Optional context for the callback function
+ * @returns {function} A function that removes this callback when called
+ */
+declare const addCallback: <T extends CallbackType>(type: T, callback: CallbackMap[T], context?: object | undefined) => (() => void);
+/**
+ * Remove callbacks from events.
+ *
+ * - Pass an event name and a callback command to remove that callback command from that event type.
+ * - Pass just an event name to remove all callback commands from that event type.
+ * - Pass undefined as event name and a callback command to remove that callback command from all event types.
+ * - Pass no params to remove all callback commands from all event types.
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.addCallback('start', myFunction1);
+ * annyang.addCallback('start', myFunction2);
+ * annyang.addCallback('end', myFunction1);
+ * annyang.addCallback('end', myFunction2);
+ *
+ * // Remove all callbacks from all events:
+ * annyang.removeCallback();
+ *
+ * // Remove all callbacks attached to end event:
+ * annyang.removeCallback('end');
+ *
+ * // Remove myFunction2 from being called on start:
+ * annyang.removeCallback('start', myFunction2);
+ *
+ * // Remove myFunction1 from being called on all events:
+ * annyang.removeCallback(undefined, myFunction1);
+ * ````
+ *
+ * @param type Name of event type to remove callback from
+ * @param callback The callback function to remove
+ * @returns undefined
+ */
+declare const removeCallback: (type?: CallbackType, callback?: CallbackMap[CallbackType]) => void;
+/**
+ * Returns true if speech recognition is currently on.
+ * Returns false if speech recognition is off or annyang is paused.
+ *
+ * @returns true if SpeechRecognition is on and annyang is not paused
+ */
+declare const isListening: () => boolean;
+type AnnyangState = 'idle' | 'listening' | 'paused';
+/**
+ * Returns the current state of annyang.
+ *
+ * @returns {'idle' | 'listening' | 'paused'} The current state
+ */
+declare const getState: () => AnnyangState;
+/**
+ * Set the language the user will speak in. If this method is not called, annyang defaults to 'en-US'.
+ *
+ * @param {string} language - The language (locale)
+ * @see [Languages](https://github.com/TalAter/annyang/blob/master/docs/FAQ.md#what-languages-are-supported)
+ */
+declare const setLanguage: (language: string) => void;
+/**
+ * Turn on the output of debug messages to the console.
+ *
+ * @param {boolean} [newState=true] - Turn debug messages on or off
+ */
+declare const debug: (newState?: boolean) => void;
+/**
+ * Match text against registered commands and fire the corresponding callbacks.
+ * Works independently of the speech recognition engine — does not require `start()`, and works even in
+ * environments where SpeechRecognition is not supported.
+ *
+ * Can accept either a string containing a single sentence or an array containing multiple sentences to be checked
+ * in order until one of them matches a command (similar to the way Speech Recognition Alternatives are parsed)
+ *
+ * #### Examples:
+ * ````javascript
+ * annyang.trigger('Time for some thrilling heroics');
+ * annyang.trigger(
+ *     ['Time for some thrilling heroics', 'Time for some thrilling aerobics']
+ *   );
+ * ````
+ *
+ * @param sentences - A sentence as a string or an array of strings of possible sentences
+ */
+declare const trigger: (sentences?: string | string[]) => void;
+/**
+ * Returns the instance of the browser's SpeechRecognition object used by annyang.
+ * Useful in case you want direct access to the browser's Speech Recognition engine.
+ *
+ * @returns SpeechRecognition The browser's Speech Recognizer instance currently used by annyang
+ */
+declare const getSpeechRecognizer: () => SpeechRecognition | undefined;
+/**
+ * @deprecated annyang no longer requires manual initialization. It initializes automatically on `start()` or `addCommands()`. Remove any calls to `init()`.
+ */
+declare const initDeprecated: () => void;
+
+declare const annyang: {
+    readonly isSpeechRecognitionSupported: () => boolean;
+    readonly addCommands: (commands: CommandsList, resetCommands?: boolean) => void;
+    readonly removeCommands: (commandsToRemove?: string | string[] | undefined) => void;
+    readonly start: (options?: StartOptions) => void;
+    readonly abort: () => void;
+    readonly pause: () => void;
+    readonly resume: () => void;
+    readonly addCallback: <T extends CallbackType>(type: T, callback: CallbackMap[T], context?: object | undefined) => (() => void);
+    readonly removeCallback: (type?: CallbackType, callback?: CallbackMap[CallbackType]) => void;
+    readonly isListening: () => boolean;
+    readonly setLanguage: (language: string) => void;
+    readonly trigger: (sentences?: string | string[]) => void;
+    readonly debug: (newState?: boolean) => void;
+    readonly getSpeechRecognizer: () => SpeechRecognition | undefined;
+    readonly getState: () => AnnyangState;
+    readonly init: () => void;
+    readonly state: AnnyangState;
+};
+
+export { type AnnyangState, type CallbackMap, type CallbackType, type CommandCallback, type CommandsList, type StartOptions, abort, addCallback, addCommands, debug, annyang as default, getSpeechRecognizer, getState, initDeprecated as init, isListening, isSpeechRecognitionSupported, pause, removeCallback, removeCommands, resume, setLanguage, start, trigger };

package/dist/annyang.iife.min.js

@@ -0,0 +1 @@
+"use strict";var annyang=(()=>{var R=Object.defineProperty;var F=Object.getOwnPropertyDescriptor;var B=Object.getOwnPropertyNames;var G=Object.prototype.hasOwnProperty;var W=(e,t)=>{for(var n in t)R(e,n,{get:t[n],enumerable:!0})},U=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of B(t))!G.call(e,s)&&s!==n&&R(e,s,{get:()=>t[s],enumerable:!(o=F(t,s))||o.enumerable});return e};var q=e=>U(R({},"__esModule",{value:!0}),e);var ne={};W(ne,{abort:()=>N,addCallback:()=>L,addCommands:()=>w,debug:()=>O,default:()=>te,getSpeechRecognizer:()=>j,getState:()=>C,init:()=>z,isListening:()=>P,isSpeechRecognitionSupported:()=>h,pause:()=>_,removeCallback:()=>$,removeCommands:()=>M,resume:()=>I,setLanguage:()=>D,start:()=>m,trigger:()=>V});var r,b=!1,u=!0,E=!1,p="font-weight: bold; color: #00f;",f=new Map,a=new Map([["start",[]],["error",[]],["end",[]],["soundstart",[]],["result",[]],["resultMatch",[]],["resultNoMatch",[]],["errorNetwork",[]],["errorPermissionBlocked",[]],["errorPermissionDenied",[]]]),S=0,k=0,l=!1,H=/\s*\((.*?)\)\s*/g,J=/(\(\?:[^)]+\))\?/g,K=/(\(\?)?:\w+/g,Q=/\*\w+/g,X=/[-{}[\]+?.,\\^$|#]/g,Y=e=>{let t=e.replace(X,"\\$&").replace(H,"(?:$1)?").replace(K,(n,o)=>o?n:"([^\\s]+)").replace(Q,"(.*?)").replace(J,"\\s*$1?\\s*");return new RegExp(`^${t}$`,"i")},y=()=>globalThis.SpeechRecognition||globalThis.webkitSpeechRecognition,x=()=>r!==void 0,c=(e,t)=>{E&&(e.indexOf("%c")===-1&&!t?console.log(e):console.log(e,t||p))},T=(e,t,n)=>{f.set(n,{command:e,callback:t}),c(`Command successfully loaded: %c${n}`,p)},i=(e=[],...t)=>{e.forEach(n=>{n.callback.apply(n.context,t)})},Z=()=>{y()&&(r&&r.abort&&r.abort(),r=new(y()),r.maxAlternatives=5,r.continuous=globalThis.location.protocol==="http:",r.lang="en-US",r.onstart=()=>{b=!0,i(a.get("start"))},r.onsoundstart=()=>{i(a.get("soundstart"))},r.onerror=e=>{switch(i(a.get("error"),e),e.error){case"network":i(a.get("errorNetwork"),e);break;case"not-allowed":case"service-not-allowed":u=!1,new Date().getTime()-S<200?i(a.get("errorPermissionBlocked"),e):i(a.get("errorPermissionDenied"),e);break;default:break}},r.onend=()=>{if(b=!1,i(a.get("end")),u){let e=new Date().getTime()-S;k+=1,k%10===0&&c("Speech Recognition is repeatedly stopping and starting. See http://is.gd/annyang_restarts for tips."),e<1e3?setTimeout(()=>{m({paused:l})},1e3-e):m({paused:l})}},r.onresult=e=>{if(l){c("Speech heard, but annyang is paused");return}let t=e.results[e.resultIndex],n=Array.from(t,o=>o.transcript);v(n)})},A=()=>{x()||Z()},v=e=>{i(a.get("result"),e);for(let t of e)c(`Speech recognized: %c${t.trim()}`,p);for(let t of e){let n=t.trim();for(let[o,s]of f){let d=s.command.exec(n);if(d){let g=d.slice(1);c(`command matched: %c${o}`,p),g.length&&c("with parameters",g),s.callback(...g),i(a.get("resultMatch"),n,o,e);return}}}i(a.get("resultNoMatch"),e)},h=()=>!!y(),w=(e,t=!1)=>{t&&f.clear();for(let n of Object.keys(e)){let o=e[n];typeof o=="function"?T(Y(n),o,n):typeof o=="object"&&o.regexp instanceof RegExp?T(new RegExp(o.regexp.source,"i"),o.callback,n):c(`Can not register command: %c${n}`,p)}},M=e=>{e===void 0?f.clear():(Array.isArray(e)?e:[e]).forEach(n=>f.delete(n))},m=(e={})=>{if(h()){A(),l=!!e.paused,e.autoRestart!==void 0?u=!!e.autoRestart:u=!0,e.continuous!==void 0&&(r.continuous=!!e.continuous),S=new Date().getTime();try{r.start()}catch(t){c(t instanceof Error?t.message:String(t))}}},N=()=>{u=!1,k=0,x()&&r.abort()},_=()=>{l=!0},I=()=>{m()},L=(e,t,n=void 0)=>{let o=a.get(e);if(typeof t=="function"&&o){let s={callback:t,context:n};return o.push(s),()=>{let d=a.get(e);if(d){let g=d.indexOf(s);g!==-1&&d.splice(g,1)}}}return()=>{}},$=(e,t)=>{a.forEach((n,o)=>{(e===void 0||e===o)&&(t===void 0?a.get(o).length=0:a.set(o,n.filter(s=>s.callback!==t)))})},P=()=>b&&!l,C=()=>b?l?"paused":"listening":"idle",D=e=>{h()&&(A(),r.lang=e)},O=(e=!0)=>{E=!!e},V=(e=[])=>{v(Array.isArray(e)?e:[e])},j=()=>r,z=()=>{console.warn("annyang.init() is deprecated and no longer needed. annyang initializes automatically on start() or addCommands(). Remove this call.")};var ee={isSpeechRecognitionSupported:h,addCommands:w,removeCommands:M,start:m,abort:N,pause:_,resume:I,addCallback:L,removeCallback:$,isListening:P,setLanguage:D,trigger:V,debug:O,getSpeechRecognizer:j,getState:C,init:z,get state(){return C()}},te=ee;return q(ne);})();