@sv443-network/userutils 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @sv443-network/userutils
 
+## 0.5.0
+
+### Minor Changes
+
+- 54e7905: Features:
+
+  - add function `amplifyMedia()` to boost the volume of a MediaElement past its default maximum
+  - allow all `MutationObserver.observe()` options to be passed to `initOnSelector()`
+
+  Fixes:
+
+  - fix `onSelector()` not triggering correctly
+
 ## 0.4.1
 
 ### Patch Changes
@@ -11,12 +24,12 @@
 ### Minor Changes
 
 - 231a79c: Refactored code and documentation and added new functions:
-  - mapRange() to map a number from one range to the same spot in another range
-  - randRange() to generate a random number between a min and max boundary
-  - randomItem() to return a random item from an array
-  - randomItemIndex() to return a tuple of a random item and its index from an array
-  - takeRandomItem() to return a random item from an array and mutate it to remove the item
-  - randomizeArray() to return a copy of the array with its items in a random order
+  - `mapRange()` to map a number from one range to the same spot in another range
+  - `randRange()` to generate a random number between a min and max boundary
+  - `randomItem()` to return a random item from an array
+  - `randomItemIndex()` to return a tuple of a random item and its index from an array
+  - `takeRandomItem()` to return a random item from an array and mutate it to remove the item
+  - `randomizeArray()` to return a copy of the array with its items in a random order
 
 ### Patch Changes
 
@@ -26,13 +39,13 @@
 
 ### Minor Changes
 
-- 07ec443: add getSelectorMap() to return all currently registered selectors
+- 07ec443: add `getSelectorMap()` to return all currently registered selectors
 
 ## 0.2.0
 
 ### Minor Changes
 
-- 0cf2254: add onSelector() to call a listener once a selector is found in the DOM
+- 0cf2254: add `onSelector()` to call a listener once a selector is found in the DOM
 
 ## 0.1.1
 

package/README.md

@@ -2,14 +2,17 @@
 
 ## UserUtils
 Library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, modify the DOM more easily and more.  
-Contains builtin TypeScript declarations. Webpack compatible and supports ESM and CJS.
+Contains builtin TypeScript declarations. Webpack compatible and supports ESM and CJS.  
+If you like using this library, please consider [supporting the development ❤️](https://github.com/sponsors/Sv443)
 
 </div>
 <br>
 
 ## Table of Contents:
-- [Installation](#installation)
-- [Features](#features)
+- [**Installation**](#installation)
+- [**Preamble**](#preamble)
+- [**License**](#license)
+- [**Features**](#features)
   - [DOM:](#dom)
     - [onSelector()](#onselector) - call a listener once a selector is found in the DOM
     - [initOnSelector()](#initonselector) - needs to be called once to be able to use `onSelector()`
@@ -22,8 +25,9 @@ Contains builtin TypeScript declarations. Webpack compatible and supports ESM an
     - [openInNewTab()](#openinnewtab) - open a link in a new tab
     - [interceptEvent()](#interceptevent) - conditionally intercepts events registered by `addEventListener()` on any given EventTarget object
     - [interceptWindowEvent()](#interceptwindowevent) - conditionally intercepts events registered by `addEventListener()` on the window object
+    - [amplifyMedia()](#amplifymedia) - amplify an audio or video element's volume past the maximum of 100%
   - [Math:](#math)
-    - [clamp()](#clamp) - clamp a number between a min and max value
+    - [clamp()](#clamp) - constrain a number between a min and max value
     - [mapRange()](#maprange) - map a number from one range to the same spot in another range
     - [randRange()](#randrange) - generate a random number between a min and max boundary
   - [Misc:](#misc)
@@ -36,7 +40,6 @@ Contains builtin TypeScript declarations. Webpack compatible and supports ESM an
     - [randomItemIndex()](#randomitemindex) - returns a tuple of a random item and its index from an array
     - [takeRandomItem()](#takerandomitem) - returns a random item from an array and mutates it to remove the item
     - [randomizeArray()](#randomizearray) - returns a copy of the array with its items in a random order
-- [License](#license)
 
 <br><br>
 
@@ -60,14 +63,29 @@ Contains builtin TypeScript declarations. Webpack compatible and supports ESM an
   // @require https://greasyfork.org/scripts/TODO
   ```
 
-<br>
+<br><br>
 
-If you like using this library, please consider [supporting development](https://github.com/sponsors/Sv443)
+## Preamble:
+This library is written in TypeScript and contains builtin TypeScript declarations.  
+The usages and examples in this readme are written in TypeScript, but the library can also be used in plain JavaScript.  
+  
+Some functions require the `@run-at` or `@grant` directives to be tweaked in the userscript header or have other requirements.  
+Their documentation will contain a section marked by a warning emoji (⚠️) that will go into more detail.  
+  
+If the usage contains multiple definitions of the function, each line represents an overload and you can choose which one you want to use.
+
+<br><br>
+
+## License:
+This library is licensed under the MIT License.  
+See the [license file](./LICENSE.txt) for details.
 
 <br><br>
 
 ## Features:
 
+<br>
+
 ## DOM:
 
 ### onSelector()
@@ -125,22 +143,22 @@ onSelector<HTMLInputElement>("input[value=\"5\"]", {
 ### initOnSelector()
 Usage:  
 ```ts
-initOnSelector(options?: {
-  attributes?: boolean,
-  characterData?: boolean,
-}): void
+initOnSelector(options?: MutationObserverInit): void
 ```
 
 Initializes the MutationObserver that is used by [`onSelector()`](#onselector) to check for the registered selectors whenever a DOM change occurs on the `<body>`  
 By default, this only checks if elements are added or removed (at any depth).  
-  
-Set `attributes` to `true` to also check for attribute changes on every single descendant of the `<body>` (defaults to false).  
-Set `characterData` to `true` to also check for character data changes on every single descendant of the `<body>` (defaults to false).  
-  
-⚠️ Using these extra options can have a performance impact on larger sites or sites with a constantly changing DOM.  
-  
+
 ⚠️ This function needs to be run after the DOM has loaded (when using `@run-at document-end` or after `DOMContentLoaded` has fired).  
   
+The options object is passed directly to the MutationObserver.observe() method.  
+Note that `options.subtree` and `options.childList` will be set to true by default.  
+You may see all options [here](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#options), but these are the important ones:  
+> Set `options.attributes` to `true` to also check for attribute changes on every single descendant of the `<body>` (defaults to false).  
+> Set `options.characterData` to `true` to also check for character data changes on every single descendant of the `<body>` (defaults to false).  
+>   
+> ⚠️ Using these extra options can have a performance impact on larger sites or sites with a constantly changing DOM.
+  
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
@@ -315,7 +333,7 @@ Usage: `openInNewTab(url: string): void`
   
 Creates an invisible anchor with a `_blank` target and clicks it.  
 Contrary to `window.open()`, this has a lesser chance to get blocked by the browser's popup blocker and doesn't open the URL as a new window.  
-This function has to be run in relatively quick succession in response to a user interaction event, else the browser might reject it.  
+This function has to be run in response to a user interaction event, else the browser might reject it.  
   
 ⚠️ This function needs to be run after the DOM has loaded (when using `@run-at document-end` or after `DOMContentLoaded` has fired).  
   
@@ -369,6 +387,50 @@ interceptWindowEvent("beforeunload", () => {
 
 </details>
 
+<br>
+
+### amplifyMedia()
+Usage: `amplifyMedia(mediaElement: HTMLMediaElement, multiplier?: number): AmplifyMediaResult`  
+  
+Amplifies the gain of a media element (like `<audio>` or `<video>`) by a given multiplier (defaults to 1.0).  
+This is how you can increase the volume of a media element beyond the default maximum volume of 1.0 or 100%.  
+Make sure to limit the multiplier to a reasonable value ([clamp()](#clamp) is good for this), as it may cause clipping or bleeding eardrums.  
+  
+⚠️ This function has to be run in response to a user interaction event, else the browser will reject it because of the strict autoplay policy.  
+  
+Returns an object with the following properties:
+| Property | Description |
+| :-- | :-- |
+| `mediaElement` | The passed media element |
+| `amplify()` | A function to change the amplification level |
+| `getAmpLevel()` | A function to return the current amplification level |
+| `context` | The AudioContext instance |
+| `source` | The MediaElementSourceNode instance |
+| `gain` | The GainNode instance |
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+const audio = document.querySelector<HTMLAudioElement>("audio");
+const button = document.querySelector<HTMLButtonElement>("button");
+
+// amplifyMedia needs to be called in response to a user interaction event:
+button.addEventListener("click", () => {
+  const { amplify, getAmpLevel } = amplifyMedia(audio);
+
+  const setGain = (value: number) => {
+    // constrain the value to between 0 and 5
+    amplify(clamp(value, 0, 5));
+    console.log("Gain set to", getAmpLevel());
+  }
+
+  setGain(2);    // set gain to 2x
+  setGain(3.5);  // set gain to 3.5x
+
+  console.log(getAmpLevel()); // 3.5
+});
+```
+
 <br><br>
 
 ## Math:
@@ -599,14 +661,7 @@ randomizeArray([1, 2, 3, 4, 5, 6]); // [3, 1, 5, 2, 4, 6]
 
 <br>
 
-
-<br><br>
-
-## License:
-This library is licensed under the MIT License.  
-See the [license file](./LICENSE.txt) for details.
-
-<br><br>
+<br><br><br><br>
 
 <div style="text-align: center;" align="center">
 

package/dist/index.d.mts

@@ -40,7 +40,7 @@ declare function preloadImages(srcUrls: string[], rejects?: boolean): Promise<Pr
  * Creates an invisible anchor with a `_blank` target and clicks it.
  * Contrary to `window.open()`, this has a lesser chance to get blocked by the browser's popup blocker and doesn't open the URL as a new window.
  *
- * This function has to be run in relatively quick succession in response to a user interaction event, else the browser might reject it.
+ * This function has to be run in response to a user interaction event, else the browser might reject it.
  */
 declare function openInNewTab(href: string): void;
 /**
@@ -55,6 +55,30 @@ declare function interceptEvent<TEvtObj extends EventTarget>(eventObject: TEvtOb
  * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
  */
 declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate: () => boolean): void;
+/**
+ * Amplifies the gain of the passed media element's audio by the specified multiplier.
+ * This function supports any media element like `<audio>` or `<video>`
+ *
+ * This function has to be run in response to a user interaction event, else the browser will reject it because of the strict autoplay policy.
+ *
+ * @returns Returns an object with the following properties:
+ * | Property | Description |
+ * | :-- | :-- |
+ * | `mediaElement` | The passed media element |
+ * | `amplify()` | A function to change the amplification level |
+ * | `getAmpLevel()` | A function to return the current amplification level |
+ * | `context` | The AudioContext instance |
+ * | `source` | The MediaElementSourceNode instance |
+ * | `gain` | The GainNode instance |
+ */
+declare function amplifyMedia<TElem extends HTMLMediaElement>(mediaElement: TElem, multiplier?: number): {
+    mediaElement: TElem;
+    amplify: (multiplier: number) => void;
+    getAmpLevel: () => number;
+    context: AudioContext;
+    source: MediaElementAudioSourceNode;
+    gain: GainNode;
+};
 
 /** Ensures the passed `value` always stays between `min` and `max` */
 declare function clamp(value: number, min: number, max: number): number;
@@ -68,12 +92,6 @@ declare function randRange(min: number, max: number): number;
 /** Returns a random number between 0 and `max` (inclusive) */
 declare function randRange(max: number): number;
 
-type InitOnSelectorOpts = {
-    /** Set to true if mutations to any element's attributes are to also trigger the onSelector check (warning: this might draw a lot of performance on larger sites) */
-    attributes?: boolean;
-    /** Set to true if mutations to any element's character data are to also trigger the onSelector check (warning: this might draw a lot of performance on larger sites) */
-    characterData?: boolean;
-};
 type OnSelectorOpts<TElem extends Element = HTMLElement> = SelectorOptsOne<TElem> | SelectorOptsAll<TElem>;
 type SelectorOptsOne<TElem extends Element> = SelectorOptsBase & {
     /** Whether to use `querySelectorAll()` instead - default is false */
@@ -128,10 +146,10 @@ declare function onSelector<TElem extends Element = HTMLElement>(selector: strin
 declare function removeOnSelector(selector: string): boolean;
 /**
  * Initializes a MutationObserver that checks for all registered selectors whenever an element is added to or removed from the `<body>`
- * @param opts For fine-tuning when the MutationObserver checks for the selectors
+ * @param options For fine-tuning what triggers the MutationObserver's checking function - `subtree` and `childList` are set to true by default
  */
-declare function initOnSelector(opts?: InitOnSelectorOpts): void;
+declare function initOnSelector(options?: MutationObserverInit): void;
 /** Returns all currently registered selectors, as a map of selector strings to their associated options */
 declare function getSelectorMap(): Map<string, OnSelectorOpts[]>;
 
-export { FetchAdvancedOpts, InitOnSelectorOpts, OnSelectorOpts, addGlobalStyle, addParent, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, randomItem, randomItemIndex, randomizeArray, removeOnSelector, takeRandomItem };
+export { FetchAdvancedOpts, OnSelectorOpts, addGlobalStyle, addParent, amplifyMedia, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, randomItem, randomItemIndex, randomizeArray, removeOnSelector, takeRandomItem };

package/dist/index.d.ts

@@ -40,7 +40,7 @@ declare function preloadImages(srcUrls: string[], rejects?: boolean): Promise<Pr
  * Creates an invisible anchor with a `_blank` target and clicks it.
  * Contrary to `window.open()`, this has a lesser chance to get blocked by the browser's popup blocker and doesn't open the URL as a new window.
  *
- * This function has to be run in relatively quick succession in response to a user interaction event, else the browser might reject it.
+ * This function has to be run in response to a user interaction event, else the browser might reject it.
  */
 declare function openInNewTab(href: string): void;
 /**
@@ -55,6 +55,30 @@ declare function interceptEvent<TEvtObj extends EventTarget>(eventObject: TEvtOb
  * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
  */
 declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate: () => boolean): void;
+/**
+ * Amplifies the gain of the passed media element's audio by the specified multiplier.
+ * This function supports any media element like `<audio>` or `<video>`
+ *
+ * This function has to be run in response to a user interaction event, else the browser will reject it because of the strict autoplay policy.
+ *
+ * @returns Returns an object with the following properties:
+ * | Property | Description |
+ * | :-- | :-- |
+ * | `mediaElement` | The passed media element |
+ * | `amplify()` | A function to change the amplification level |
+ * | `getAmpLevel()` | A function to return the current amplification level |
+ * | `context` | The AudioContext instance |
+ * | `source` | The MediaElementSourceNode instance |
+ * | `gain` | The GainNode instance |
+ */
+declare function amplifyMedia<TElem extends HTMLMediaElement>(mediaElement: TElem, multiplier?: number): {
+    mediaElement: TElem;
+    amplify: (multiplier: number) => void;
+    getAmpLevel: () => number;
+    context: AudioContext;
+    source: MediaElementAudioSourceNode;
+    gain: GainNode;
+};
 
 /** Ensures the passed `value` always stays between `min` and `max` */
 declare function clamp(value: number, min: number, max: number): number;
@@ -68,12 +92,6 @@ declare function randRange(min: number, max: number): number;
 /** Returns a random number between 0 and `max` (inclusive) */
 declare function randRange(max: number): number;
 
-type InitOnSelectorOpts = {
-    /** Set to true if mutations to any element's attributes are to also trigger the onSelector check (warning: this might draw a lot of performance on larger sites) */
-    attributes?: boolean;
-    /** Set to true if mutations to any element's character data are to also trigger the onSelector check (warning: this might draw a lot of performance on larger sites) */
-    characterData?: boolean;
-};
 type OnSelectorOpts<TElem extends Element = HTMLElement> = SelectorOptsOne<TElem> | SelectorOptsAll<TElem>;
 type SelectorOptsOne<TElem extends Element> = SelectorOptsBase & {
     /** Whether to use `querySelectorAll()` instead - default is false */
@@ -128,10 +146,10 @@ declare function onSelector<TElem extends Element = HTMLElement>(selector: strin
 declare function removeOnSelector(selector: string): boolean;
 /**
  * Initializes a MutationObserver that checks for all registered selectors whenever an element is added to or removed from the `<body>`
- * @param opts For fine-tuning when the MutationObserver checks for the selectors
+ * @param options For fine-tuning what triggers the MutationObserver's checking function - `subtree` and `childList` are set to true by default
  */
-declare function initOnSelector(opts?: InitOnSelectorOpts): void;
+declare function initOnSelector(options?: MutationObserverInit): void;
 /** Returns all currently registered selectors, as a map of selector strings to their associated options */
 declare function getSelectorMap(): Map<string, OnSelectorOpts[]>;
 
-export { FetchAdvancedOpts, InitOnSelectorOpts, OnSelectorOpts, addGlobalStyle, addParent, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, randomItem, randomItemIndex, randomizeArray, removeOnSelector, takeRandomItem };
+export { FetchAdvancedOpts, OnSelectorOpts, addGlobalStyle, addParent, amplifyMedia, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, randomItem, randomItemIndex, randomizeArray, removeOnSelector, takeRandomItem };

package/dist/index.js

@@ -1,27 +1,28 @@
 'use strict';
 
-var h=Object.defineProperty,y=Object.defineProperties;var w=Object.getOwnPropertyDescriptors;var f=Object.getOwnPropertySymbols;var g=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var b=(t,e,n)=>e in t?h(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,a=(t,e)=>{for(var n in e||(e={}))g.call(e,n)&&b(t,n,e[n]);if(f)for(var n of f(e))v.call(e,n)&&b(t,n,e[n]);return t},d=(t,e)=>y(t,w(e));var T=(t,e,n)=>new Promise((r,o)=>{var i=c=>{try{m(n.next(c));}catch(l){o(l);}},u=c=>{try{m(n.throw(c));}catch(l){o(l);}},m=c=>c.done?r(c.value):Promise.resolve(c.value).then(i,u);m((n=n.apply(t,e)).next());});function S(t,e,n){return Math.max(Math.min(t,n),e)}function N(t,e,n,r,o){return Number(e)===0&&Number(r)===0?t*(o/n):(t-e)*((o-r)/(n-e))+r}function p(...t){let e,n;if(typeof t[0]=="number"&&typeof t[1]=="number")[e,n]=t;else if(typeof t[0]=="number"&&typeof t[1]!="number")e=0,n=t[0];else throw new TypeError(`Wrong parameter(s) provided - expected: "number" and "number|undefined", got: "${typeof t[0]}" and "${typeof t[1]}"`);if(e=Number(e),n=Number(n),isNaN(e)||isNaN(n))throw new TypeError(`Parameters "min" and "max" can't be NaN`);if(e>n)throw new TypeError(`Parameter "min" can't be bigger than "max"`);return Math.floor(Math.random()*(n-e+1))+e}function I(t){return x(t)[0]}function x(t){if(t.length===0)return [void 0,void 0];let e=p(t.length-1);return [t[e],e]}function H(t){let[e,n]=x(t);if(n!==void 0)return t.splice(n,1),e}function P(t){let e=[...t];if(t.length===0)return t;for(let n=e.length-1;n>0;n--){let r=Math.floor(p(0,1e4)/1e4*(n+1));[e[n],e[r]]=[e[r],e[n]];}return e}function O(){try{return unsafeWindow}catch(t){return window}}function C(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function R(t,e){let n=t.parentNode;if(!n)throw new Error("Element doesn't have a parent node");return n.replaceChild(e,t),e.appendChild(t),e}function F(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function W(t,e=!1){let n=t.map(r=>new Promise((o,i)=>{let u=new Image;u.src=r,u.addEventListener("load",()=>o(u)),u.addEventListener("error",m=>e&&i(m));}));return Promise.allSettled(n)}function $(t){let e=document.createElement("a");Object.assign(e,{className:"userutils-open-in-new-tab",target:"_blank",rel:"noopener noreferrer",href:t}),e.style.display="none",document.body.appendChild(e),e.click(),setTimeout(e.remove,50);}function L(t,e,n){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){element.__proto__.addEventListener=function(...o){if(!(o[0]===e&&n()))return r.apply(this,o)};}(t.__proto__.addEventListener);}function q(t,e){return L(O(),t,e)}function B(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function G(t){return new Promise(e=>{setTimeout(e,t);})}function U(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function D(n){return T(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),u=yield fetch(t,d(a({},e),{signal:o.signal}));return clearTimeout(i),u})}var s=new Map;function Q(t,e){let n=[];s.has(t)&&(n=s.get(t)),n.push(e),s.set(t,n),E(t,n);}function V(t){return s.delete(t)}function E(t,e){let n=[];if(e.forEach((r,o)=>{try{let i=r.all?document.querySelectorAll(t):document.querySelector(t);i&&(r.listener(i),r.continuous||n.push(o));}catch(i){console.error(`Couldn't call listener for selector '${t}'`,i);}}),n.length>0){let r=e.filter((o,i)=>!n.includes(i));r.length===0?s.delete(t):s.set(t,r);}}function X(t={}){new MutationObserver(()=>{for(let[n,r]of s.entries())E(n,r);}).observe(document.body,d(a({},t),{childList:!0}));}function Y(){return s}
+var h=Object.defineProperty,y=Object.defineProperties;var g=Object.getOwnPropertyDescriptors;var p=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var f=(n,e,t)=>e in n?h(n,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):n[e]=t,m=(n,e)=>{for(var t in e||(e={}))w.call(e,t)&&f(n,t,e[t]);if(p)for(var t of p(e))v.call(e,t)&&f(n,t,e[t]);return n},b=(n,e)=>y(n,g(e));var x=(n,e,t)=>new Promise((r,o)=>{var i=s=>{try{a(t.next(s));}catch(l){o(l);}},u=s=>{try{a(t.throw(s));}catch(l){o(l);}},a=s=>s.done?r(s.value):Promise.resolve(s.value).then(i,u);a((t=t.apply(n,e)).next());});function A(n,e,t){return Math.max(Math.min(n,t),e)}function N(n,e,t,r,o){return Number(e)===0&&Number(r)===0?n*(o/t):(n-e)*((o-r)/(t-e))+r}function d(...n){let e,t;if(typeof n[0]=="number"&&typeof n[1]=="number")[e,t]=n;else if(typeof n[0]=="number"&&typeof n[1]!="number")e=0,t=n[0];else throw new TypeError(`Wrong parameter(s) provided - expected: "number" and "number|undefined", got: "${typeof n[0]}" and "${typeof n[1]}"`);if(e=Number(e),t=Number(t),isNaN(e)||isNaN(t))throw new TypeError(`Parameters "min" and "max" can't be NaN`);if(e>t)throw new TypeError(`Parameter "min" can't be bigger than "max"`);return Math.floor(Math.random()*(t-e+1))+e}function H(n){return T(n)[0]}function T(n){if(n.length===0)return [void 0,void 0];let e=d(n.length-1);return [n[e],e]}function I(n){let[e,t]=T(n);if(t!==void 0)return n.splice(t,1),e}function C(n){let e=[...n];if(n.length===0)return n;for(let t=e.length-1;t>0;t--){let r=Math.floor(d(0,1e4)/1e4*(t+1));[e[t],e[r]]=[e[r],e[t]];}return e}function L(){try{return unsafeWindow}catch(n){return window}}function j(n,e){var t;return (t=n.parentNode)==null||t.insertBefore(e,n.nextSibling),e}function R(n,e){let t=n.parentNode;if(!t)throw new Error("Element doesn't have a parent node");return t.replaceChild(e,n),e.appendChild(n),e}function F(n){let e=document.createElement("style");e.innerHTML=n,document.head.appendChild(e);}function W(n,e=!1){let t=n.map(r=>new Promise((o,i)=>{let u=new Image;u.src=r,u.addEventListener("load",()=>o(u)),u.addEventListener("error",a=>e&&i(a));}));return Promise.allSettled(t)}function $(n){let e=document.createElement("a");Object.assign(e,{className:"userutils-open-in-new-tab",target:"_blank",rel:"noopener noreferrer",href:n}),e.style.display="none",document.body.appendChild(e),e.click(),setTimeout(e.remove,50);}function M(n,e,t){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){element.__proto__.addEventListener=function(...o){if(!(o[0]===e&&t()))return r.apply(this,o)};}(n.__proto__.addEventListener);}function q(n,e){return M(L(),n,e)}function G(n,e=1){let t=new(window.AudioContext||window.webkitAudioContext),r={mediaElement:n,amplify:o=>{r.gain.gain.value=o;},getAmpLevel:()=>r.gain.gain.value,context:t,source:t.createMediaElementSource(n),gain:t.createGain()};return r.source.connect(r.gain),r.gain.connect(t.destination),r.amplify(e),r}function B(n,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${n}${e===1?"":"s"}`}function U(n){return new Promise(e=>{setTimeout(e,n);})}function D(n,e=300){let t;return function(...r){clearTimeout(t),t=setTimeout(()=>n.apply(this,r),e);}}function J(t){return x(this,arguments,function*(n,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),u=yield fetch(n,b(m({},e),{signal:o.signal}));return clearTimeout(i),u})}var c=new Map;function V(n,e){let t=[];c.has(n)&&(t=c.get(n)),t.push(e),c.set(n,t),E(n,t);}function X(n){return c.delete(n)}function E(n,e){let t=[];if(e.forEach((r,o)=>{try{let i=r.all?document.querySelectorAll(n):document.querySelector(n);(i!==null&&i instanceof NodeList&&i.length>0||i!==null)&&(r.listener(i),r.continuous||t.push(o));}catch(i){console.error(`Couldn't call listener for selector '${n}'`,i);}}),t.length>0){let r=e.filter((o,i)=>!t.includes(i));r.length===0?c.delete(n):c.set(n,r);}}function Y(n={}){new MutationObserver(()=>{for(let[t,r]of c.entries())E(t,r);}).observe(document.body,m({subtree:!0,childList:!0},n));}function Z(){return c}
 
 exports.addGlobalStyle = F;
 exports.addParent = R;
+exports.amplifyMedia = G;
 exports.autoPlural = B;
-exports.clamp = S;
-exports.debounce = U;
-exports.fetchAdvanced = D;
-exports.getSelectorMap = Y;
-exports.getUnsafeWindow = O;
-exports.initOnSelector = X;
-exports.insertAfter = C;
-exports.interceptEvent = L;
+exports.clamp = A;
+exports.debounce = D;
+exports.fetchAdvanced = J;
+exports.getSelectorMap = Z;
+exports.getUnsafeWindow = L;
+exports.initOnSelector = Y;
+exports.insertAfter = j;
+exports.interceptEvent = M;
 exports.interceptWindowEvent = q;
 exports.mapRange = N;
-exports.onSelector = Q;
+exports.onSelector = V;
 exports.openInNewTab = $;
-exports.pauseFor = G;
+exports.pauseFor = U;
 exports.preloadImages = W;
-exports.randRange = p;
-exports.randomItem = I;
-exports.randomItemIndex = x;
-exports.randomizeArray = P;
-exports.removeOnSelector = V;
-exports.takeRandomItem = H;
+exports.randRange = d;
+exports.randomItem = H;
+exports.randomItemIndex = T;
+exports.randomizeArray = C;
+exports.removeOnSelector = X;
+exports.takeRandomItem = I;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-var h=Object.defineProperty,y=Object.defineProperties;var w=Object.getOwnPropertyDescriptors;var f=Object.getOwnPropertySymbols;var g=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var b=(t,e,n)=>e in t?h(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,a=(t,e)=>{for(var n in e||(e={}))g.call(e,n)&&b(t,n,e[n]);if(f)for(var n of f(e))v.call(e,n)&&b(t,n,e[n]);return t},d=(t,e)=>y(t,w(e));var T=(t,e,n)=>new Promise((r,o)=>{var i=c=>{try{m(n.next(c));}catch(l){o(l);}},u=c=>{try{m(n.throw(c));}catch(l){o(l);}},m=c=>c.done?r(c.value):Promise.resolve(c.value).then(i,u);m((n=n.apply(t,e)).next());});function S(t,e,n){return Math.max(Math.min(t,n),e)}function N(t,e,n,r,o){return Number(e)===0&&Number(r)===0?t*(o/n):(t-e)*((o-r)/(n-e))+r}function p(...t){let e,n;if(typeof t[0]=="number"&&typeof t[1]=="number")[e,n]=t;else if(typeof t[0]=="number"&&typeof t[1]!="number")e=0,n=t[0];else throw new TypeError(`Wrong parameter(s) provided - expected: "number" and "number|undefined", got: "${typeof t[0]}" and "${typeof t[1]}"`);if(e=Number(e),n=Number(n),isNaN(e)||isNaN(n))throw new TypeError(`Parameters "min" and "max" can't be NaN`);if(e>n)throw new TypeError(`Parameter "min" can't be bigger than "max"`);return Math.floor(Math.random()*(n-e+1))+e}function I(t){return x(t)[0]}function x(t){if(t.length===0)return [void 0,void 0];let e=p(t.length-1);return [t[e],e]}function H(t){let[e,n]=x(t);if(n!==void 0)return t.splice(n,1),e}function P(t){let e=[...t];if(t.length===0)return t;for(let n=e.length-1;n>0;n--){let r=Math.floor(p(0,1e4)/1e4*(n+1));[e[n],e[r]]=[e[r],e[n]];}return e}function O(){try{return unsafeWindow}catch(t){return window}}function C(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function R(t,e){let n=t.parentNode;if(!n)throw new Error("Element doesn't have a parent node");return n.replaceChild(e,t),e.appendChild(t),e}function F(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function W(t,e=!1){let n=t.map(r=>new Promise((o,i)=>{let u=new Image;u.src=r,u.addEventListener("load",()=>o(u)),u.addEventListener("error",m=>e&&i(m));}));return Promise.allSettled(n)}function $(t){let e=document.createElement("a");Object.assign(e,{className:"userutils-open-in-new-tab",target:"_blank",rel:"noopener noreferrer",href:t}),e.style.display="none",document.body.appendChild(e),e.click(),setTimeout(e.remove,50);}function L(t,e,n){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){element.__proto__.addEventListener=function(...o){if(!(o[0]===e&&n()))return r.apply(this,o)};}(t.__proto__.addEventListener);}function q(t,e){return L(O(),t,e)}function B(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function G(t){return new Promise(e=>{setTimeout(e,t);})}function U(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function D(n){return T(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),u=yield fetch(t,d(a({},e),{signal:o.signal}));return clearTimeout(i),u})}var s=new Map;function Q(t,e){let n=[];s.has(t)&&(n=s.get(t)),n.push(e),s.set(t,n),E(t,n);}function V(t){return s.delete(t)}function E(t,e){let n=[];if(e.forEach((r,o)=>{try{let i=r.all?document.querySelectorAll(t):document.querySelector(t);i&&(r.listener(i),r.continuous||n.push(o));}catch(i){console.error(`Couldn't call listener for selector '${t}'`,i);}}),n.length>0){let r=e.filter((o,i)=>!n.includes(i));r.length===0?s.delete(t):s.set(t,r);}}function X(t={}){new MutationObserver(()=>{for(let[n,r]of s.entries())E(n,r);}).observe(document.body,d(a({},t),{childList:!0}));}function Y(){return s}
+var h=Object.defineProperty,y=Object.defineProperties;var g=Object.getOwnPropertyDescriptors;var p=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var f=(n,e,t)=>e in n?h(n,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):n[e]=t,m=(n,e)=>{for(var t in e||(e={}))w.call(e,t)&&f(n,t,e[t]);if(p)for(var t of p(e))v.call(e,t)&&f(n,t,e[t]);return n},b=(n,e)=>y(n,g(e));var x=(n,e,t)=>new Promise((r,o)=>{var i=s=>{try{a(t.next(s));}catch(l){o(l);}},u=s=>{try{a(t.throw(s));}catch(l){o(l);}},a=s=>s.done?r(s.value):Promise.resolve(s.value).then(i,u);a((t=t.apply(n,e)).next());});function A(n,e,t){return Math.max(Math.min(n,t),e)}function N(n,e,t,r,o){return Number(e)===0&&Number(r)===0?n*(o/t):(n-e)*((o-r)/(t-e))+r}function d(...n){let e,t;if(typeof n[0]=="number"&&typeof n[1]=="number")[e,t]=n;else if(typeof n[0]=="number"&&typeof n[1]!="number")e=0,t=n[0];else throw new TypeError(`Wrong parameter(s) provided - expected: "number" and "number|undefined", got: "${typeof n[0]}" and "${typeof n[1]}"`);if(e=Number(e),t=Number(t),isNaN(e)||isNaN(t))throw new TypeError(`Parameters "min" and "max" can't be NaN`);if(e>t)throw new TypeError(`Parameter "min" can't be bigger than "max"`);return Math.floor(Math.random()*(t-e+1))+e}function H(n){return T(n)[0]}function T(n){if(n.length===0)return [void 0,void 0];let e=d(n.length-1);return [n[e],e]}function I(n){let[e,t]=T(n);if(t!==void 0)return n.splice(t,1),e}function C(n){let e=[...n];if(n.length===0)return n;for(let t=e.length-1;t>0;t--){let r=Math.floor(d(0,1e4)/1e4*(t+1));[e[t],e[r]]=[e[r],e[t]];}return e}function L(){try{return unsafeWindow}catch(n){return window}}function j(n,e){var t;return (t=n.parentNode)==null||t.insertBefore(e,n.nextSibling),e}function R(n,e){let t=n.parentNode;if(!t)throw new Error("Element doesn't have a parent node");return t.replaceChild(e,n),e.appendChild(n),e}function F(n){let e=document.createElement("style");e.innerHTML=n,document.head.appendChild(e);}function W(n,e=!1){let t=n.map(r=>new Promise((o,i)=>{let u=new Image;u.src=r,u.addEventListener("load",()=>o(u)),u.addEventListener("error",a=>e&&i(a));}));return Promise.allSettled(t)}function $(n){let e=document.createElement("a");Object.assign(e,{className:"userutils-open-in-new-tab",target:"_blank",rel:"noopener noreferrer",href:n}),e.style.display="none",document.body.appendChild(e),e.click(),setTimeout(e.remove,50);}function M(n,e,t){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){element.__proto__.addEventListener=function(...o){if(!(o[0]===e&&t()))return r.apply(this,o)};}(n.__proto__.addEventListener);}function q(n,e){return M(L(),n,e)}function G(n,e=1){let t=new(window.AudioContext||window.webkitAudioContext),r={mediaElement:n,amplify:o=>{r.gain.gain.value=o;},getAmpLevel:()=>r.gain.gain.value,context:t,source:t.createMediaElementSource(n),gain:t.createGain()};return r.source.connect(r.gain),r.gain.connect(t.destination),r.amplify(e),r}function B(n,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${n}${e===1?"":"s"}`}function U(n){return new Promise(e=>{setTimeout(e,n);})}function D(n,e=300){let t;return function(...r){clearTimeout(t),t=setTimeout(()=>n.apply(this,r),e);}}function J(t){return x(this,arguments,function*(n,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),u=yield fetch(n,b(m({},e),{signal:o.signal}));return clearTimeout(i),u})}var c=new Map;function V(n,e){let t=[];c.has(n)&&(t=c.get(n)),t.push(e),c.set(n,t),E(n,t);}function X(n){return c.delete(n)}function E(n,e){let t=[];if(e.forEach((r,o)=>{try{let i=r.all?document.querySelectorAll(n):document.querySelector(n);(i!==null&&i instanceof NodeList&&i.length>0||i!==null)&&(r.listener(i),r.continuous||t.push(o));}catch(i){console.error(`Couldn't call listener for selector '${n}'`,i);}}),t.length>0){let r=e.filter((o,i)=>!t.includes(i));r.length===0?c.delete(n):c.set(n,r);}}function Y(n={}){new MutationObserver(()=>{for(let[t,r]of c.entries())E(t,r);}).observe(document.body,m({subtree:!0,childList:!0},n));}function Z(){return c}
 
-export { F as addGlobalStyle, R as addParent, B as autoPlural, S as clamp, U as debounce, D as fetchAdvanced, Y as getSelectorMap, O as getUnsafeWindow, X as initOnSelector, C as insertAfter, L as interceptEvent, q as interceptWindowEvent, N as mapRange, Q as onSelector, $ as openInNewTab, G as pauseFor, W as preloadImages, p as randRange, I as randomItem, x as randomItemIndex, P as randomizeArray, V as removeOnSelector, H as takeRandomItem };
+export { F as addGlobalStyle, R as addParent, G as amplifyMedia, B as autoPlural, A as clamp, D as debounce, J as fetchAdvanced, Z as getSelectorMap, L as getUnsafeWindow, Y as initOnSelector, j as insertAfter, M as interceptEvent, q as interceptWindowEvent, N as mapRange, V as onSelector, $ as openInNewTab, U as pauseFor, W as preloadImages, d as randRange, H as randomItem, T as randomItemIndex, C as randomizeArray, X as removeOnSelector, I as takeRandomItem };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sv443-network/userutils",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Library with various utilities for userscripts - register listeners for when CSS selectors exist, intercept events, modify the DOM more easily and more ",
   "main": "dist/index.js",
   "module": "dist/index.mjs",