misairu 4.1.0 → 5.0.1

package/.eslintignore

@@ -0,0 +1,3 @@
+.eslintrc.js
+dist/
+node_modules/

package/.eslintrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: [
+    '@typescript-eslint',
+    'prettier'
+  ],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'prettier'
+  ],
+  rules: {
+    'prettier/prettier': 'warn',
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/no-non-null-assertion': 'off'
+  }
+} 

package/.prettierignore

@@ -0,0 +1,2 @@
+node_modules/
+dist/

package/.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "semi": false,
+  "printWidth": 100,
+  "singleQuote": true,
+  "bracketSpacing": true
+}

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2017 pixeldesu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2017 pixeldesu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,116 +1,145 @@
-# misairu  
-_ミサイル // MISSILE_  
-
-:rocket: Fire events for specific timeframes easily
-
-## Getting it
-
-**NPM:**
-
-```
-$ npm install misairu
-```
-
-**unpkg:**
-
-```html
-<script src="https://unpkg.com/misairu/misairu.js"></script>
-```
-
-Or you can go the traditional way, grab `misairu.js` from the repository and put it somewhere in your project with a `<script>` tag!
-
-## Usage
-
-**Text:**
-
-```js
-const media = document.getElementById('audioplayer')
-const text = document.getElementById('text')
-
-// define timings, tracks and their functions
-const timings = {
-  "default": {
-    "0": function() {
-      text.innerHTML = 'New text at start'
-    }
-  },
-  "default:2": {
-    "10": function() {
-      document.body.style.backgroundColor = 'lightblue'
-      text.innerHTML = 'New text and background color after 10 seconds'
-    }
-  }
-}
-
-// create misairu instance
-const ev = new misairu(media, timings)
-
-// you only need this if your audiosource is external e.g. a link to an audio file
-document.addEventListener('misairu.ready', function(event) {
-  // start playback once misairu is ready
-  ev.start()
-})
-```
-
-## Reference
-
-### `new misairu(audioSource, timings)`
-
-* **`audioSource`:** (required) Link to an audio file or `<audio>`-Tag DOM Element
-* **`timings`:** (required) Object where the keys represent the time and the values are functions or function references
-
-**Note on `audioSource`:**
-
-If you use a `HTMLMediaElement`, misairu won't fire the `misairu.ready` event, as the content is already given. To be really
-sure that everything starts when you want it to, give your media element the attribute `preload="auto"` to have it pre-buffer
-ahead of usage.
-
-### `misairu.start()`
-
-This will start playback of the specified audio and execute the events at the given time. If your audio source is external, the audio buffer is 
-loaded asynchronously and you should listen to the `misairu.ready` event on `document` and execute this function once
-the event was emitted.
-
-### `misairu.[un]pause()`
-
-Pauses/Resumes playback and event execution.
-
-### `misairu.[un]mute()`
-
-(Un)mutes audio of the misairu instance.
-
-### `misairu.volume = x`
-
-Sets the volume to `x`, can be a value between -80 and 5.
-
-### Anatomy of the `timings` object
-
-```js
-// timings object, you pass this to the misairu constructor
-const timings = {
-  // track object
-  "default": {
-    // timing key - function
-    "0": function (instance, timingKey, track, time) {
-      // instance - misairu instance
-      // timingKey - current timing key ("0")
-      // track - current track ("default")
-      // time - current time (accurate time calculated from the start time and audio context time)
-
-      // >> put some code here <<
-    }
-  }
-}
-```
-
-All of the parameters passed to a timing function are optional and don't need to be used as they are only passed for convenience, so you can omit them.
-
-## Shoutouts
-
-* [Rocket](https://github.com/rocket/rocket) for basically being the "big brother" of this small project
-* [coderobe](https://github.com/coderobe) for [microhues](https://github.com/coderobe/microhues), which helped me understanding the Web Audio APIs
-* [ed](https://github.com/9001), as I'm basically building this to have an easy framework to build as creative things as he does
-
-## License
-
+# misairu  
+_ミサイル // MISSILE_  
+
+:rocket: Fire events for specific timeframes easily
+
+## Getting it
+
+**NPM:**
+
+```
+$ npm install misairu
+```
+
+**unpkg:**
+
+```html
+<script src="https://unpkg.com/misairu/dist/misairu.iife.js"></script>
+```
+
+Or you can go the traditional way, grab `misairu.js` from the repository and put it somewhere in your project with a `<script>` tag!
+
+## Usage
+
+**Text:**
+
+```js
+const media = document.getElementById('audioplayer')
+const text = document.getElementById('text')
+
+// define timings, tracks and their functions
+const timings = {
+  "default": {
+    "0": function() {
+      text.innerHTML = 'New text at start'
+    }
+  },
+  "default:2": {
+    "10": function() {
+      document.body.style.backgroundColor = 'lightblue'
+      text.innerHTML = 'New text and background color after 10 seconds'
+    }
+  }
+}
+
+// create misairu instance
+const ev = new Misairu(media, timings)
+
+// you only need this if your audiosource is external e.g. a link to an audio file
+document.addEventListener('misairu.ready', function(event) {
+  // start playback once misairu is ready
+  ev.start()
+})
+```
+
+## Reference
+
+### `new Misairu(audioSource, timings)`
+
+* **`audioSource`:** (required) Link to an audio file or `<audio>`-Tag DOM Element
+* **`timings`:** (required) Object where the keys represent the time and the values are functions or function references
+
+**Note on `audioSource`:**
+
+If you use a `HTMLMediaElement`, misairu won't fire the `misairu.ready` event, as the content is already given. To be really
+sure that everything starts when you want it to, give your media element the attribute `preload="auto"` to have it pre-buffer
+ahead of usage.
+
+### `misairu.start()`
+
+This will start playback of the specified audio and execute the events at the given time. If your audio source is external, the audio buffer is 
+loaded asynchronously and you should listen to the `misairu.ready` event on `document` and execute this function once
+the event was emitted.
+
+### `misairu.[un]pause()`
+
+Pauses/Resumes playback and event execution.
+
+### `misairu.[un]mute()`
+
+(Un)mutes audio of the misairu instance.
+
+### `misairu.volume = x`
+
+Sets the volume to `x`, can be a value between -80 and 5.
+
+### Anatomy of the `timings` object
+
+```js
+// timings object, you pass this to the misairu constructor
+const timings = {
+  // track object
+  "default": {
+    // timing key - function
+    "0": function (instance, timingKey, track, time) {
+      // instance - misairu instance
+      // timingKey - current timing key ("0")
+      // track - current track ("default")
+      // time - current time (accurate time calculated from the start time and audio context time)
+
+      // >> put some code here <<
+    }
+  }
+}
+```
+
+All of the parameters passed to a timing function are optional and don't need to be used as they are only passed for convenience, so you can omit them.
+
+### `repeat` tracks
+
+It's possible to define repeating actions for a specific timeframe with special track type, following the naming scheme of `repeat:start-time:interval:end-time`.
+
+As an example:
+
+```js
+const timings = {
+  "repeat:1:2:10": myCoolFunction 
+}
+```
+
+On creation of the `misairu` instance, the timing object gets compiled, so the repeat statement will be unfolded into:
+
+```js
+// misairu_instance.timings
+{
+  // the original track "repeat:1:2:10" was deleted 
+  // and replaced with a repeat-randomhash track containing all timed events
+  "repeat-xjas34f": { 
+    "1": myCoolFunction,
+    "3": myCoolFunction,
+    "5": myCoolFunction,
+    "7": myCoolFunction,
+    "9": myCoolFunction
+  }
+}
+```
+
+## Shoutouts
+
+* [Rocket](https://github.com/rocket/rocket) for basically being the "big brother" of this small project
+* [coderobe](https://github.com/coderobe) for [microhues](https://github.com/coderobe/microhues), which helped me understanding the Web Audio APIs
+* [ed](https://github.com/9001), as I'm basically building this to have an easy framework to build as creative things as he does
+
+## License
+
 misairu is licensed under the MIT license

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export { Misairu as default } from './misairu';

package/dist/misairu.d.ts

@@ -0,0 +1,161 @@
+import { TimingObject } from './types';
+/**
+ * Main misairu class
+ */
+export declare class Misairu {
+    /**
+     * The HTML5 AudioContext used for accurately timing our events
+     */
+    private readonly _audioContext;
+    /**
+     * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source
+     *
+     * @default null
+     */
+    private _audioSource;
+    /**
+     * A object containing the last executed time key per track to not execute an event on every tick
+     *
+     * @default {}
+     */
+    private _cache;
+    /**
+     * Reference to the `requestAnimationFrame` handler
+     *
+     * @default null
+     */
+    private _eventHandler;
+    /**
+     * Gain node from our audio context to control audio volume
+     */
+    private readonly _gainNode;
+    /**
+     * Boolean value describing if this instance is currently muted
+     */
+    private _muted;
+    /**
+     * Boolean value describing if this instance is currently paused
+     */
+    private _paused;
+    /**
+     * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called
+     */
+    private _startTime;
+    /**
+     * Object containing all timing tracks and events to be executed
+     */
+    private _timings;
+    /**
+     * Volume of the current instance
+     */
+    private _volume;
+    /**
+     * List of (predefined) track processors
+     */
+    private _processors;
+    get volume(): number;
+    set volume(db: number);
+    /**
+     * misairu constructor
+     *
+     * @param audioSource a string or HTML element to be used as audio source
+     * @param timings a object containing event timing information
+     */
+    constructor(audioSource: string | HTMLMediaElement, timings: TimingObject);
+    /**
+     * Method to figure out the best course of action to take with the passed audio source
+     *
+     * @param audioSource the audio source `Misairu` has been constructed with
+     * @internal
+     */
+    private getOptimalAudioSource;
+    /**
+     * Mutes the instance audio
+     *
+     * @public
+     */
+    mute(): void;
+    /**
+     * Unmutes the instance audio
+     *
+     * @public
+     */
+    unmute(): void;
+    /**
+     * Pauses instance playback
+     *
+     * @public
+     */
+    pause(): void;
+    /**
+     * Resumes instance playback
+     *
+     * @public
+     */
+    unpause(): void;
+    /**
+     * Set a cache entry for the given track
+     *
+     * @param track track to set a cache entry for
+     * @param entry value of the cache entry
+     * @internal
+     */
+    private setCacheEntry;
+    /**
+     * Get cache entry for the given track
+     *
+     * @param track track to get a cache entry for
+     * @returns a cache entry
+     * @internal
+     */
+    private getCacheEntry;
+    /**
+     * Get all tracks from the timing configuration
+     *
+     * @returns a list of all track names
+     * @internal
+     */
+    private getAllTracks;
+    /**
+     * Returns the current active timing key for a given track
+     *
+     * @param track track to get the timing key from
+     * @param currentTime current playback time
+     * @returns the current active timing key
+     * @internal
+     */
+    private getActiveTimingKey;
+    /**
+     * Main method to process special sections in the timing configuration
+     *
+     * @internal
+     */
+    private processTracks;
+    /**
+     * Start audio playback and event handling
+     *
+     * @public
+     */
+    start(): void;
+    /**
+     * Method to start event handler loop
+     *
+     * @internal
+     */
+    private startEventHandling;
+    /**
+     * Event handler method, is running in a loop using `requestAnimationFrame`
+     *
+     * @internal
+     */
+    private handleEvents;
+    /**
+     * Method to execute the event for a given timing key on a given track
+     *
+     * @param track the track to execute the event on
+     * @param timingKey the timing key to execute
+     * @param time current playback time
+     * @internal
+     */
+    private executeEvent;
+}

package/dist/misairu.iife.js

@@ -0,0 +1,2 @@
+var Misairu=function(){var t=new RegExp(/repeat:\d:\d:\d/),e=function(){function e(){this.deleteOriginTrack=!0}var n=e.prototype;return n.matches=function(e){return null!==e.match(t)},n.process=function(t,e){if("function"!=typeof e)throw Error('The value of repeat track "'+e+'" is not a function');var n=t.split(":");if(4!=n.length)throw Error('The repeat track "'+t+'" does not supply the valid amount of arguments');var i=parseFloat(n[1]),o=parseFloat(n[2]),r=parseFloat(n[3]),s=i,a={};do{a[s.toString()]=e,s+=o}while(s<r);return["repeat-"+Math.random().toString(36).substring(7),a]},e}();function n(t){return Math.pow(10,t/20)}return function(){function t(t,n){this._audioContext=void 0,this._audioSource=null,this._cache={},this._eventHandler=null,this._gainNode=void 0,this._muted=!1,this._paused=!1,this._startTime=0,this._timings=void 0,this._volume=0,this._processors=[new e],null===n&&console.error("You need to specify a timings object"),this._timings=n,this._audioContext=new AudioContext,this._gainNode=this._audioContext.createGain(),this._gainNode.connect(this._audioContext.destination),this.getOptimalAudioSource(t),this.processTracks()}var i,o=t.prototype;return o.getOptimalAudioSource=function(t){var e=this;"string"==typeof t?function(t,e){try{var n=e.createBufferSource();return Promise.resolve(fetch(t)).then(function(t){return Promise.resolve(t.arrayBuffer()).then(function(t){return Promise.resolve(e.decodeAudioData(t)).then(function(t){return n.buffer=t,n})})})}catch(t){return Promise.reject(t)}}(t,this._audioContext).then(function(t){e._audioSource=t,e._audioSource.connect(e._gainNode),document.dispatchEvent(new Event("misairu.ready"))}):"object"!=typeof t||"AUDIO"!=t.tagName&&"VIDEO"!=t.tagName||(this._audioSource=function(t,e){return e.createMediaElementSource(t)}(t,this._audioContext),this._audioSource.connect(this._gainNode))},o.mute=function(){this._muted||(this._muted=!0,this._gainNode.gain.value=0)},o.unmute=function(){this._muted&&(this._muted=!1,this._gainNode.gain.value=n(this._volume))},o.pause=function(){this._paused||(this._audioContext.suspend(),this._paused=!0)},o.unpause=function(){this._paused&&(this._audioContext.resume(),this._paused=!1)},o.setCacheEntry=function(t,e){this._cache[t]=e},o.getCacheEntry=function(t){return this._cache[t]},o.getAllTracks=function(){return Object.keys(this._timings)},o.getActiveTimingKey=function(t,e){var n=Object.keys(this._timings[t]).filter(function(t){if(e>=parseFloat(t))return!0});return n[n.length-1]},o.processTracks=function(){var t=this;this.getAllTracks().forEach(function(e){t._processors.forEach(function(n){if(n.matches(e)){var i=n.process(e,t._timings[e]);t._timings[i[0]]=i[1],n.deleteOriginTrack&&delete t._timings[e]}})})},o.start=function(){this._startTime=this._audioContext.currentTime,this._audioSource.start(),this.startEventHandling()},o.startEventHandling=function(){var t=this;null==this._eventHandler&&(this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()}))},o.handleEvents=function(){var t=this,e=this._audioContext.currentTime-this._startTime;this.getAllTracks().forEach(function(n){var i=t.getActiveTimingKey(n,e);null!==i&&t.getCacheEntry(n)!=i&&(t.executeEvent(n,i,e),t.setCacheEntry(n,i))}),this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()})},o.executeEvent=function(t,e,n){this._timings[t][e](this,e,t,n)},(i=[{key:"volume",get:function(){return this._volume},set:function(t){var e;this._volume=(e=t)<-80?-80:e>5?5:e,this._muted||(this._gainNode.gain.value=n(this._volume))}}])&&function(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}(t.prototype,i),t}()}();
+//# sourceMappingURL=misairu.iife.js.map

package/dist/misairu.iife.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misairu.iife.js","sources":["../src/processors/repeat.ts","../src/utilities/audio.ts","../src/misairu.ts","../src/utilities/source.ts"],"sourcesContent":["import { EventFunction, EventTrack, ITrackProcessor } from \"../types\";\r\n\r\nconst REPEAT_NAME_REGEX = new RegExp(/repeat:\\d:\\d:\\d/)\r\n\r\nexport class RepeatTrackProcessor implements ITrackProcessor {\r\n  deleteOriginTrack = true;\r\n\r\n  matches(name: string): boolean {\r\n    return name.match(REPEAT_NAME_REGEX) !== null\r\n  }\r\n\r\n  process(name: string, track: EventFunction): [string, EventTrack] {\r\n    if (typeof track != 'function')\r\n      throw Error(`The value of repeat track \"${track}\" is not a function`)\r\n\r\n    const repeatTrackArgs = name.split(':')\r\n\r\n    if (repeatTrackArgs.length != 4)\r\n      throw Error(`The repeat track \"${name}\" does not supply the valid amount of arguments`)\r\n\r\n    const startTime = parseFloat(repeatTrackArgs[1])\r\n    const interval = parseFloat(repeatTrackArgs[2])\r\n    const endTime = parseFloat(repeatTrackArgs[3])\r\n\r\n    let time = startTime\r\n    const tempTrack = {}\r\n\r\n    do {\r\n      tempTrack[time.toString()] = track\r\n      time += interval\r\n    } while (time < endTime)\r\n\r\n    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]\r\n  }\r\n}","/**\r\n * Method to turn the passed decibel values into volume values for the audio playback\r\n *\r\n * @param db decibel value\r\n * @returns volume value\r\n */\r\nexport function dbToVolume(db: number): number {\r\n  return Math.pow(10, db / 20)\r\n}\r\n\r\n/**\r\n * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures\r\n */\r\nexport function clampGain(volume: number): number {\r\n  if (volume < -80) {\r\n    return -80\r\n  } else if (volume > 5) {\r\n    return 5\r\n  }\r\n\r\n  return volume\r\n}","import { RepeatTrackProcessor } from './processors/repeat'\r\nimport { EventCache, ITrackProcessor, TimingObject } from './types'\r\nimport { dbToVolume, clampGain } from './utilities/audio'\r\nimport { fetchAudioSource, attachAudioElementSource } from './utilities/source'\r\n\r\n/**\r\n * Main misairu class\r\n */\r\nexport class Misairu {\r\n  /**\r\n   * The HTML5 AudioContext used for accurately timing our events\r\n   */\r\n  private readonly _audioContext: AudioContext\r\n\r\n  /**\r\n   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source\r\n   *\r\n   * @default null\r\n   */\r\n  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null\r\n\r\n  /**\r\n   * A object containing the last executed time key per track to not execute an event on every tick\r\n   *\r\n   * @default {}\r\n   */\r\n  private _cache: EventCache = {}\r\n\r\n  /**\r\n   * Reference to the `requestAnimationFrame` handler\r\n   *\r\n   * @default null\r\n   */\r\n  private _eventHandler: number | null = null\r\n\r\n  /**\r\n   * Gain node from our audio context to control audio volume\r\n   */\r\n  private readonly _gainNode: GainNode\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently muted\r\n   */\r\n  private _muted = false\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently paused\r\n   */\r\n  private _paused = false\r\n\r\n  /**\r\n   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called\r\n   */\r\n  private _startTime = 0\r\n\r\n  /**\r\n   * Object containing all timing tracks and events to be executed\r\n   */\r\n  private _timings: TimingObject\r\n\r\n  /**\r\n   * Volume of the current instance\r\n   */\r\n  private _volume = 0\r\n\r\n  /**\r\n   * List of (predefined) track processors\r\n   */\r\n  private _processors: ITrackProcessor[] = [\r\n    new RepeatTrackProcessor()\r\n  ]\r\n\r\n  get volume(): number {\r\n    return this._volume\r\n  }\r\n\r\n  set volume(db: number) {\r\n    this._volume = clampGain(db)\r\n\r\n    if (!this._muted) {\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * misairu constructor\r\n   *\r\n   * @param audioSource a string or HTML element to be used as audio source\r\n   * @param timings a object containing event timing information\r\n   */\r\n  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {\r\n    if (timings === null) console.error('You need to specify a timings object')\r\n    this._timings = timings\r\n\r\n    this._audioContext = new AudioContext()\r\n\r\n    this._gainNode = this._audioContext.createGain()\r\n    this._gainNode.connect(this._audioContext.destination)\r\n\r\n    this.getOptimalAudioSource(audioSource)\r\n\r\n    this.processTracks()\r\n  }\r\n\r\n  /**\r\n   * Method to figure out the best course of action to take with the passed audio source\r\n   *\r\n   * @param audioSource the audio source `Misairu` has been constructed with\r\n   * @internal\r\n   */\r\n  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {\r\n    if (typeof audioSource == 'string') {\r\n      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {\r\n        this._audioSource = audioSource\r\n        this._audioSource.connect(this._gainNode)\r\n\r\n        document.dispatchEvent(new Event('misairu.ready'))\r\n      })\r\n    } else if (\r\n      typeof audioSource == 'object' &&\r\n      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')\r\n    ) {\r\n      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)\r\n      this._audioSource.connect(this._gainNode)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Mutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public mute(): void {\r\n    if (!this._muted) {\r\n      this._muted = true\r\n      this._gainNode.gain.value = 0\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unmutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public unmute(): void {\r\n    if (this._muted) {\r\n      this._muted = false\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Pauses instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public pause(): void {\r\n    if (!this._paused) {\r\n      this._audioContext.suspend()\r\n      this._paused = true\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resumes instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public unpause(): void {\r\n    if (this._paused) {\r\n      this._audioContext.resume()\r\n      this._paused = false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set a cache entry for the given track\r\n   *\r\n   * @param track track to set a cache entry for\r\n   * @param entry value of the cache entry\r\n   * @internal\r\n   */\r\n  private setCacheEntry(track: string, entry: string): void {\r\n    this._cache[track] = entry\r\n  }\r\n\r\n  /**\r\n   * Get cache entry for the given track\r\n   *\r\n   * @param track track to get a cache entry for\r\n   * @returns a cache entry\r\n   * @internal\r\n   */\r\n  private getCacheEntry(track: string): string {\r\n    return this._cache[track]\r\n  }\r\n\r\n  /**\r\n   * Get all tracks from the timing configuration\r\n   *\r\n   * @returns a list of all track names\r\n   * @internal\r\n   */\r\n  private getAllTracks(): string[] {\r\n    return Object.keys(this._timings)\r\n  }\r\n\r\n  /**\r\n   * Returns the current active timing key for a given track\r\n   *\r\n   * @param track track to get the timing key from\r\n   * @param currentTime current playback time\r\n   * @returns the current active timing key\r\n   * @internal\r\n   */\r\n  private getActiveTimingKey(track: string, currentTime: number): string {\r\n    const timingKeys = Object.keys(this._timings[track])\r\n\r\n    const activeTimings = timingKeys.filter((timing) => {\r\n      if (currentTime >= parseFloat(timing)) {\r\n        return true\r\n      }\r\n    })\r\n\r\n    return activeTimings[activeTimings.length - 1]\r\n  }\r\n\r\n  /**\r\n   * Main method to process special sections in the timing configuration\r\n   *\r\n   * @internal\r\n   */\r\n  private processTracks(): void {\r\n    this.getAllTracks().forEach((trackName) => {\r\n      this._processors.forEach((processor: ITrackProcessor) => {\r\n        if (processor.matches(trackName)) {\r\n          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])\r\n\r\n          this._timings[processedTrackName] = eventTrack\r\n\r\n          if (processor.deleteOriginTrack) {\r\n            delete this._timings[trackName]\r\n          }\r\n        }\r\n      })\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Start audio playback and event handling\r\n   *\r\n   * @public\r\n   */\r\n  public start(): void {\r\n    this._startTime = this._audioContext.currentTime\r\n\r\n    ;(this._audioSource as AudioBufferSourceNode).start()\r\n\r\n    this.startEventHandling()\r\n  }\r\n\r\n  /**\r\n   * Method to start event handler loop\r\n   *\r\n   * @internal\r\n   */\r\n  private startEventHandling(): void {\r\n    if (this._eventHandler == null) {\r\n      this._eventHandler = window.requestAnimationFrame(() => {\r\n        this.handleEvents()\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Event handler method, is running in a loop using `requestAnimationFrame`\r\n   *\r\n   * @internal\r\n   */\r\n  private handleEvents(): void {\r\n    const time = this._audioContext.currentTime - this._startTime\r\n\r\n    this.getAllTracks().forEach((track) => {\r\n      const timingKey = this.getActiveTimingKey(track, time)\r\n\r\n      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {\r\n        this.executeEvent(track, timingKey, time)\r\n        this.setCacheEntry(track, timingKey)\r\n      }\r\n    })\r\n\r\n    this._eventHandler = window.requestAnimationFrame(() => {\r\n      this.handleEvents()\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Method to execute the event for a given timing key on a given track\r\n   *\r\n   * @param track the track to execute the event on\r\n   * @param timingKey the timing key to execute\r\n   * @param time current playback time\r\n   * @internal\r\n   */\r\n  private executeEvent(track: string, timingKey: string, time: number): void {\r\n    this._timings[track][timingKey](this, timingKey, track, time)\r\n  }\r\n}\r\n","/**\r\n * Method to fetch the external audio file (if the audio source parameter was a string)\r\n * and turning it into a `AudioBufferSourceNode`\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport async function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode> {\r\n  const source = audioContext.createBufferSource()\r\n\r\n  const response = await fetch(audioSource)\r\n  const arrayBuffer = await response.arrayBuffer()\r\n  const buffer = await audioContext.decodeAudioData(arrayBuffer)\r\n\r\n  source.buffer = buffer\r\n\r\n  return source\r\n}\r\n\r\n/**\r\n * Method to get an `MediaElementAudioSourceNode` from the passed audio source\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode {\r\n  return audioContext.createMediaElementSource(audioSource)\r\n}"],"names":["REPEAT_NAME_REGEX","RegExp","RepeatTrackProcessor","deleteOriginTrack","matches","name","match","process","track","Error","repeatTrackArgs","split","length","startTime","parseFloat","interval","endTime","time","tempTrack","toString","Math","random","substring","dbToVolume","db","pow","audioSource","timings","_audioContext","_audioSource","_cache","_eventHandler","_gainNode","_muted","_paused","_startTime","_timings","_volume","_processors","console","error","this","AudioContext","createGain","connect","destination","getOptimalAudioSource","processTracks","audioContext","source","createBufferSource","fetch","response","arrayBuffer","decodeAudioData","buffer","fetchAudioSource","then","_this","document","dispatchEvent","Event","tagName","createMediaElementSource","attachAudioElementSource","mute","gain","value","unmute","pause","suspend","unpause","resume","setCacheEntry","entry","getCacheEntry","getAllTracks","Object","keys","getActiveTimingKey","currentTime","activeTimings","filter","timing","forEach","trackName","_this2","processor","start","startEventHandling","window","requestAnimationFrame","_this3","handleEvents","timingKey","_this4","executeEvent","volume"],"mappings":"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"}

package/dist/misairu.js

@@ -0,0 +1,2 @@
+var t=new RegExp(/repeat:\d:\d:\d/),e=function(){function e(){this.deleteOriginTrack=!0}var n=e.prototype;return n.matches=function(e){return null!==e.match(t)},n.process=function(t,e){if("function"!=typeof e)throw Error('The value of repeat track "'+e+'" is not a function');var n=t.split(":");if(4!=n.length)throw Error('The repeat track "'+t+'" does not supply the valid amount of arguments');var i=parseFloat(n[1]),o=parseFloat(n[2]),r=parseFloat(n[3]),s=i,a={};do{a[s.toString()]=e,s+=o}while(s<r);return["repeat-"+Math.random().toString(36).substring(7),a]},e}();function n(t){return Math.pow(10,t/20)}module.exports=function(){function t(t,n){this._audioContext=void 0,this._audioSource=null,this._cache={},this._eventHandler=null,this._gainNode=void 0,this._muted=!1,this._paused=!1,this._startTime=0,this._timings=void 0,this._volume=0,this._processors=[new e],null===n&&console.error("You need to specify a timings object"),this._timings=n,this._audioContext=new AudioContext,this._gainNode=this._audioContext.createGain(),this._gainNode.connect(this._audioContext.destination),this.getOptimalAudioSource(t),this.processTracks()}var i,o=t.prototype;return o.getOptimalAudioSource=function(t){var e=this;"string"==typeof t?function(t,e){try{var n=e.createBufferSource();return Promise.resolve(fetch(t)).then(function(t){return Promise.resolve(t.arrayBuffer()).then(function(t){return Promise.resolve(e.decodeAudioData(t)).then(function(t){return n.buffer=t,n})})})}catch(t){return Promise.reject(t)}}(t,this._audioContext).then(function(t){e._audioSource=t,e._audioSource.connect(e._gainNode),document.dispatchEvent(new Event("misairu.ready"))}):"object"!=typeof t||"AUDIO"!=t.tagName&&"VIDEO"!=t.tagName||(this._audioSource=function(t,e){return e.createMediaElementSource(t)}(t,this._audioContext),this._audioSource.connect(this._gainNode))},o.mute=function(){this._muted||(this._muted=!0,this._gainNode.gain.value=0)},o.unmute=function(){this._muted&&(this._muted=!1,this._gainNode.gain.value=n(this._volume))},o.pause=function(){this._paused||(this._audioContext.suspend(),this._paused=!0)},o.unpause=function(){this._paused&&(this._audioContext.resume(),this._paused=!1)},o.setCacheEntry=function(t,e){this._cache[t]=e},o.getCacheEntry=function(t){return this._cache[t]},o.getAllTracks=function(){return Object.keys(this._timings)},o.getActiveTimingKey=function(t,e){var n=Object.keys(this._timings[t]).filter(function(t){if(e>=parseFloat(t))return!0});return n[n.length-1]},o.processTracks=function(){var t=this;this.getAllTracks().forEach(function(e){t._processors.forEach(function(n){if(n.matches(e)){var i=n.process(e,t._timings[e]);t._timings[i[0]]=i[1],n.deleteOriginTrack&&delete t._timings[e]}})})},o.start=function(){this._startTime=this._audioContext.currentTime,this._audioSource.start(),this.startEventHandling()},o.startEventHandling=function(){var t=this;null==this._eventHandler&&(this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()}))},o.handleEvents=function(){var t=this,e=this._audioContext.currentTime-this._startTime;this.getAllTracks().forEach(function(n){var i=t.getActiveTimingKey(n,e);null!==i&&t.getCacheEntry(n)!=i&&(t.executeEvent(n,i,e),t.setCacheEntry(n,i))}),this._eventHandler=window.requestAnimationFrame(function(){t.handleEvents()})},o.executeEvent=function(t,e,n){this._timings[t][e](this,e,t,n)},(i=[{key:"volume",get:function(){return this._volume},set:function(t){var e;this._volume=(e=t)<-80?-80:e>5?5:e,this._muted||(this._gainNode.gain.value=n(this._volume))}}])&&function(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,i.key,i)}}(t.prototype,i),t}();
+//# sourceMappingURL=misairu.js.map

package/dist/misairu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misairu.js","sources":["../src/processors/repeat.ts","../src/utilities/audio.ts","../src/misairu.ts","../src/utilities/source.ts"],"sourcesContent":["import { EventFunction, EventTrack, ITrackProcessor } from \"../types\";\r\n\r\nconst REPEAT_NAME_REGEX = new RegExp(/repeat:\\d:\\d:\\d/)\r\n\r\nexport class RepeatTrackProcessor implements ITrackProcessor {\r\n  deleteOriginTrack = true;\r\n\r\n  matches(name: string): boolean {\r\n    return name.match(REPEAT_NAME_REGEX) !== null\r\n  }\r\n\r\n  process(name: string, track: EventFunction): [string, EventTrack] {\r\n    if (typeof track != 'function')\r\n      throw Error(`The value of repeat track \"${track}\" is not a function`)\r\n\r\n    const repeatTrackArgs = name.split(':')\r\n\r\n    if (repeatTrackArgs.length != 4)\r\n      throw Error(`The repeat track \"${name}\" does not supply the valid amount of arguments`)\r\n\r\n    const startTime = parseFloat(repeatTrackArgs[1])\r\n    const interval = parseFloat(repeatTrackArgs[2])\r\n    const endTime = parseFloat(repeatTrackArgs[3])\r\n\r\n    let time = startTime\r\n    const tempTrack = {}\r\n\r\n    do {\r\n      tempTrack[time.toString()] = track\r\n      time += interval\r\n    } while (time < endTime)\r\n\r\n    return [`repeat-${Math.random().toString(36).substring(7)}`, tempTrack]\r\n  }\r\n}","/**\r\n * Method to turn the passed decibel values into volume values for the audio playback\r\n *\r\n * @param db decibel value\r\n * @returns volume value\r\n */\r\nexport function dbToVolume(db: number): number {\r\n  return Math.pow(10, db / 20)\r\n}\r\n\r\n/**\r\n * Clamps the volume to a min/max value to prevent accidental oversetting to way too loud measures\r\n */\r\nexport function clampGain(volume: number): number {\r\n  if (volume < -80) {\r\n    return -80\r\n  } else if (volume > 5) {\r\n    return 5\r\n  }\r\n\r\n  return volume\r\n}","import { RepeatTrackProcessor } from './processors/repeat'\r\nimport { EventCache, ITrackProcessor, TimingObject } from './types'\r\nimport { dbToVolume, clampGain } from './utilities/audio'\r\nimport { fetchAudioSource, attachAudioElementSource } from './utilities/source'\r\n\r\n/**\r\n * Main misairu class\r\n */\r\nexport class Misairu {\r\n  /**\r\n   * The HTML5 AudioContext used for accurately timing our events\r\n   */\r\n  private readonly _audioContext: AudioContext\r\n\r\n  /**\r\n   * A source node to play our audio from, either a buffered source from a downloaded media file or a media element source\r\n   *\r\n   * @default null\r\n   */\r\n  private _audioSource: HTMLMediaElement | AudioBufferSourceNode | MediaElementAudioSourceNode | null = null\r\n\r\n  /**\r\n   * A object containing the last executed time key per track to not execute an event on every tick\r\n   *\r\n   * @default {}\r\n   */\r\n  private _cache: EventCache = {}\r\n\r\n  /**\r\n   * Reference to the `requestAnimationFrame` handler\r\n   *\r\n   * @default null\r\n   */\r\n  private _eventHandler: number | null = null\r\n\r\n  /**\r\n   * Gain node from our audio context to control audio volume\r\n   */\r\n  private readonly _gainNode: GainNode\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently muted\r\n   */\r\n  private _muted = false\r\n\r\n  /**\r\n   * Boolean value describing if this instance is currently paused\r\n   */\r\n  private _paused = false\r\n\r\n  /**\r\n   * The time when event handling was started, based on the audio contexts `currentTime` when `start()` was called\r\n   */\r\n  private _startTime = 0\r\n\r\n  /**\r\n   * Object containing all timing tracks and events to be executed\r\n   */\r\n  private _timings: TimingObject\r\n\r\n  /**\r\n   * Volume of the current instance\r\n   */\r\n  private _volume = 0\r\n\r\n  /**\r\n   * List of (predefined) track processors\r\n   */\r\n  private _processors: ITrackProcessor[] = [\r\n    new RepeatTrackProcessor()\r\n  ]\r\n\r\n  get volume(): number {\r\n    return this._volume\r\n  }\r\n\r\n  set volume(db: number) {\r\n    this._volume = clampGain(db)\r\n\r\n    if (!this._muted) {\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * misairu constructor\r\n   *\r\n   * @param audioSource a string or HTML element to be used as audio source\r\n   * @param timings a object containing event timing information\r\n   */\r\n  constructor(audioSource: string | HTMLMediaElement, timings: TimingObject) {\r\n    if (timings === null) console.error('You need to specify a timings object')\r\n    this._timings = timings\r\n\r\n    this._audioContext = new AudioContext()\r\n\r\n    this._gainNode = this._audioContext.createGain()\r\n    this._gainNode.connect(this._audioContext.destination)\r\n\r\n    this.getOptimalAudioSource(audioSource)\r\n\r\n    this.processTracks()\r\n  }\r\n\r\n  /**\r\n   * Method to figure out the best course of action to take with the passed audio source\r\n   *\r\n   * @param audioSource the audio source `Misairu` has been constructed with\r\n   * @internal\r\n   */\r\n  private getOptimalAudioSource(audioSource: string | HTMLMediaElement): void {\r\n    if (typeof audioSource == 'string') {\r\n      fetchAudioSource(audioSource, this._audioContext).then((audioSource) => {\r\n        this._audioSource = audioSource\r\n        this._audioSource.connect(this._gainNode)\r\n\r\n        document.dispatchEvent(new Event('misairu.ready'))\r\n      })\r\n    } else if (\r\n      typeof audioSource == 'object' &&\r\n      (audioSource.tagName == 'AUDIO' || audioSource.tagName == 'VIDEO')\r\n    ) {\r\n      this._audioSource = attachAudioElementSource(audioSource, this._audioContext)\r\n      this._audioSource.connect(this._gainNode)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Mutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public mute(): void {\r\n    if (!this._muted) {\r\n      this._muted = true\r\n      this._gainNode.gain.value = 0\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Unmutes the instance audio\r\n   *\r\n   * @public\r\n   */\r\n  public unmute(): void {\r\n    if (this._muted) {\r\n      this._muted = false\r\n      this._gainNode.gain.value = dbToVolume(this._volume)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Pauses instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public pause(): void {\r\n    if (!this._paused) {\r\n      this._audioContext.suspend()\r\n      this._paused = true\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resumes instance playback\r\n   *\r\n   * @public\r\n   */\r\n  public unpause(): void {\r\n    if (this._paused) {\r\n      this._audioContext.resume()\r\n      this._paused = false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set a cache entry for the given track\r\n   *\r\n   * @param track track to set a cache entry for\r\n   * @param entry value of the cache entry\r\n   * @internal\r\n   */\r\n  private setCacheEntry(track: string, entry: string): void {\r\n    this._cache[track] = entry\r\n  }\r\n\r\n  /**\r\n   * Get cache entry for the given track\r\n   *\r\n   * @param track track to get a cache entry for\r\n   * @returns a cache entry\r\n   * @internal\r\n   */\r\n  private getCacheEntry(track: string): string {\r\n    return this._cache[track]\r\n  }\r\n\r\n  /**\r\n   * Get all tracks from the timing configuration\r\n   *\r\n   * @returns a list of all track names\r\n   * @internal\r\n   */\r\n  private getAllTracks(): string[] {\r\n    return Object.keys(this._timings)\r\n  }\r\n\r\n  /**\r\n   * Returns the current active timing key for a given track\r\n   *\r\n   * @param track track to get the timing key from\r\n   * @param currentTime current playback time\r\n   * @returns the current active timing key\r\n   * @internal\r\n   */\r\n  private getActiveTimingKey(track: string, currentTime: number): string {\r\n    const timingKeys = Object.keys(this._timings[track])\r\n\r\n    const activeTimings = timingKeys.filter((timing) => {\r\n      if (currentTime >= parseFloat(timing)) {\r\n        return true\r\n      }\r\n    })\r\n\r\n    return activeTimings[activeTimings.length - 1]\r\n  }\r\n\r\n  /**\r\n   * Main method to process special sections in the timing configuration\r\n   *\r\n   * @internal\r\n   */\r\n  private processTracks(): void {\r\n    this.getAllTracks().forEach((trackName) => {\r\n      this._processors.forEach((processor: ITrackProcessor) => {\r\n        if (processor.matches(trackName)) {\r\n          const [processedTrackName, eventTrack] = processor.process(trackName, this._timings[trackName])\r\n\r\n          this._timings[processedTrackName] = eventTrack\r\n\r\n          if (processor.deleteOriginTrack) {\r\n            delete this._timings[trackName]\r\n          }\r\n        }\r\n      })\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Start audio playback and event handling\r\n   *\r\n   * @public\r\n   */\r\n  public start(): void {\r\n    this._startTime = this._audioContext.currentTime\r\n\r\n    ;(this._audioSource as AudioBufferSourceNode).start()\r\n\r\n    this.startEventHandling()\r\n  }\r\n\r\n  /**\r\n   * Method to start event handler loop\r\n   *\r\n   * @internal\r\n   */\r\n  private startEventHandling(): void {\r\n    if (this._eventHandler == null) {\r\n      this._eventHandler = window.requestAnimationFrame(() => {\r\n        this.handleEvents()\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Event handler method, is running in a loop using `requestAnimationFrame`\r\n   *\r\n   * @internal\r\n   */\r\n  private handleEvents(): void {\r\n    const time = this._audioContext.currentTime - this._startTime\r\n\r\n    this.getAllTracks().forEach((track) => {\r\n      const timingKey = this.getActiveTimingKey(track, time)\r\n\r\n      if (timingKey !== null && !(this.getCacheEntry(track) == timingKey)) {\r\n        this.executeEvent(track, timingKey, time)\r\n        this.setCacheEntry(track, timingKey)\r\n      }\r\n    })\r\n\r\n    this._eventHandler = window.requestAnimationFrame(() => {\r\n      this.handleEvents()\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Method to execute the event for a given timing key on a given track\r\n   *\r\n   * @param track the track to execute the event on\r\n   * @param timingKey the timing key to execute\r\n   * @param time current playback time\r\n   * @internal\r\n   */\r\n  private executeEvent(track: string, timingKey: string, time: number): void {\r\n    this._timings[track][timingKey](this, timingKey, track, time)\r\n  }\r\n}\r\n","/**\r\n * Method to fetch the external audio file (if the audio source parameter was a string)\r\n * and turning it into a `AudioBufferSourceNode`\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport async function fetchAudioSource(audioSource: string, audioContext: AudioContext): Promise<AudioBufferSourceNode> {\r\n  const source = audioContext.createBufferSource()\r\n\r\n  const response = await fetch(audioSource)\r\n  const arrayBuffer = await response.arrayBuffer()\r\n  const buffer = await audioContext.decodeAudioData(arrayBuffer)\r\n\r\n  source.buffer = buffer\r\n\r\n  return source\r\n}\r\n\r\n/**\r\n * Method to get an `MediaElementAudioSourceNode` from the passed audio source\r\n *\r\n * @param audioSource the audio source `Misairu` has been constructed with\r\n * @internal\r\n */\r\nexport function attachAudioElementSource(audioSource: HTMLMediaElement, audioContext: AudioContext): MediaElementAudioSourceNode {\r\n  return audioContext.createMediaElementSource(audioSource)\r\n}"],"names":["REPEAT_NAME_REGEX","RegExp","RepeatTrackProcessor","deleteOriginTrack","matches","name","match","process","track","Error","repeatTrackArgs","split","length","startTime","parseFloat","interval","endTime","time","tempTrack","toString","Math","random","substring","dbToVolume","db","pow","audioSource","timings","_audioContext","_audioSource","_cache","_eventHandler","_gainNode","_muted","_paused","_startTime","_timings","_volume","_processors","console","error","this","AudioContext","createGain","connect","destination","getOptimalAudioSource","processTracks","audioContext","source","createBufferSource","fetch","response","arrayBuffer","decodeAudioData","buffer","fetchAudioSource","then","_this","document","dispatchEvent","Event","tagName","createMediaElementSource","attachAudioElementSource","mute","gain","value","unmute","pause","suspend","unpause","resume","setCacheEntry","entry","getCacheEntry","getAllTracks","Object","keys","getActiveTimingKey","currentTime","activeTimings","filter","timing","forEach","trackName","_this2","processor","start","startEventHandling","window","requestAnimationFrame","_this3","handleEvents","timingKey","_this4","executeEvent","volume"],"mappings":"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"}

package/dist/misairu.modern.js

@@ -0,0 +1,2 @@
+const t=new RegExp(/repeat:\d:\d:\d/);class e{constructor(){this.deleteOriginTrack=!0}matches(e){return null!==e.match(t)}process(t,e){if("function"!=typeof e)throw Error(`The value of repeat track "${e}" is not a function`);const i=t.split(":");if(4!=i.length)throw Error(`The repeat track "${t}" does not supply the valid amount of arguments`);const s=parseFloat(i[1]),n=parseFloat(i[2]),a=parseFloat(i[3]);let o=s;const r={};do{r[o.toString()]=e,o+=n}while(o<a);return[`repeat-${Math.random().toString(36).substring(7)}`,r]}}function i(t){return Math.pow(10,t/20)}class s{get volume(){return this._volume}set volume(t){var e;this._volume=(e=t)<-80?-80:e>5?5:e,this._muted||(this._gainNode.gain.value=i(this._volume))}constructor(t,i){this._audioContext=void 0,this._audioSource=null,this._cache={},this._eventHandler=null,this._gainNode=void 0,this._muted=!1,this._paused=!1,this._startTime=0,this._timings=void 0,this._volume=0,this._processors=[new e],null===i&&console.error("You need to specify a timings object"),this._timings=i,this._audioContext=new AudioContext,this._gainNode=this._audioContext.createGain(),this._gainNode.connect(this._audioContext.destination),this.getOptimalAudioSource(t),this.processTracks()}getOptimalAudioSource(t){"string"==typeof t?async function(t,e){const i=e.createBufferSource(),s=await fetch(t),n=await s.arrayBuffer(),a=await e.decodeAudioData(n);return i.buffer=a,i}(t,this._audioContext).then(t=>{this._audioSource=t,this._audioSource.connect(this._gainNode),document.dispatchEvent(new Event("misairu.ready"))}):"object"!=typeof t||"AUDIO"!=t.tagName&&"VIDEO"!=t.tagName||(this._audioSource=function(t,e){return e.createMediaElementSource(t)}(t,this._audioContext),this._audioSource.connect(this._gainNode))}mute(){this._muted||(this._muted=!0,this._gainNode.gain.value=0)}unmute(){this._muted&&(this._muted=!1,this._gainNode.gain.value=i(this._volume))}pause(){this._paused||(this._audioContext.suspend(),this._paused=!0)}unpause(){this._paused&&(this._audioContext.resume(),this._paused=!1)}setCacheEntry(t,e){this._cache[t]=e}getCacheEntry(t){return this._cache[t]}getAllTracks(){return Object.keys(this._timings)}getActiveTimingKey(t,e){const i=Object.keys(this._timings[t]).filter(t=>{if(e>=parseFloat(t))return!0});return i[i.length-1]}processTracks(){this.getAllTracks().forEach(t=>{this._processors.forEach(e=>{if(e.matches(t)){const[i,s]=e.process(t,this._timings[t]);this._timings[i]=s,e.deleteOriginTrack&&delete this._timings[t]}})})}start(){this._startTime=this._audioContext.currentTime,this._audioSource.start(),this.startEventHandling()}startEventHandling(){null==this._eventHandler&&(this._eventHandler=window.requestAnimationFrame(()=>{this.handleEvents()}))}handleEvents(){const t=this._audioContext.currentTime-this._startTime;this.getAllTracks().forEach(e=>{const i=this.getActiveTimingKey(e,t);null!==i&&this.getCacheEntry(e)!=i&&(this.executeEvent(e,i,t),this.setCacheEntry(e,i))}),this._eventHandler=window.requestAnimationFrame(()=>{this.handleEvents()})}executeEvent(t,e,i){this._timings[t][e](this,e,t,i)}}export{s as default};
+//# sourceMappingURL=misairu.modern.js.map