@sv443-network/userutils 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @sv443-network/userutils
 
+## 0.4.0
+
+### 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
+
+### Patch Changes
+
+- 7edf837: decrease npm bundle size
+
+## 0.3.0
+
+### Minor Changes
+
+- 07ec443: add getSelectorMap() to return all currently registered selectors
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -1,27 +1,41 @@
+<div style="text-align: center;" align="center">
+
 ## 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.
+Contains builtin TypeScript declarations. Webpack compatible and supports ESM and CJS.
 
+</div>
 <br>
 
 ## Table of Contents:
 - [Installation](#installation)
 - [Features](#features)
-  - [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()`
-  - [autoPlural()](#autoplural) - automatically pluralize a string
-  - [clamp()](#clamp) - clamp a number between a min and max value
-  - [pauseFor()](#pausefor) - pause the execution of a function for a given amount of time
-  - [debounce()](#debounce) - call a function only once, after a given amount of time
-  - [getUnsafeWindow()](#getunsafewindow) - get the unsafeWindow object or fall back to the regular window object
-  - [insertAfter()](#insertafter) - insert an element as a sibling after another element
-  - [addParent()](#addparent) - add a parent element around another element
-  - [addGlobalStyle()](#addglobalstyle) - add a global style to the page
-  - [preloadImages()](#preloadimages) - preload images into the browser cache for faster loading later on
-  - [fetchAdvanced()](#fetchadvanced) - wrapper around the fetch API with a timeout option
-  - [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
+  - [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()`
+    - [getSelectorMap()](#getselectormap) - returns all currently registered selectors, listeners and options
+    - [getUnsafeWindow()](#getunsafewindow) - get the unsafeWindow object or fall back to the regular window object
+    - [insertAfter()](#insertafter) - insert an element as a sibling after another element
+    - [addParent()](#addparent) - add a parent element around another element
+    - [addGlobalStyle()](#addglobalstyle) - add a global style to the page
+    - [preloadImages()](#preloadimages) - preload images into the browser cache for faster loading later on
+    - [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
+  - [Math:](#math)
+    - [clamp()](#clamp) - clamp 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)
+    - [autoPlural()](#autoplural) - automatically pluralize a string
+    - [pauseFor()](#pausefor) - pause the execution of a function for a given amount of time
+    - [debounce()](#debounce) - call a function only once, after a given amount of time
+    - [fetchAdvanced()](#fetchadvanced) - wrapper around the fetch API with a timeout option
+  - [Arrays:](#arrays)
+    - [randomItem()](#randomitem) - returns a random item from an array
+    - [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>
@@ -54,6 +68,8 @@ If you like using this library, please consider [supporting development](https:/
 
 ## Features:
 
+## DOM:
+
 ### onSelector()
 Usage:  
 ```ts
@@ -69,7 +85,7 @@ If the selector already exists, the listener will be called immediately.
   
 If `all` is set to `true`, querySelectorAll() will be used instead and the listener will return a NodeList of matching elements.  
 This will also include elements that were already found in a previous listener call.  
-If set to `false` (default), querySelector() will be used and only the first element will be returned.  
+If set to `false` (default), querySelector() will be used and only the first matching element will be returned.  
   
 If `continuous` is set to `true`, the listener will not be deregistered after it was called once (defaults to false).  
   
@@ -86,18 +102,18 @@ Calling onSelector() before `DOMContentLoaded` is fired will not throw an error,
 document.addEventListener("DOMContentLoaded", initOnSelector);
 
 // Continuously checks if `div` elements are added to the DOM, then returns all of them (even previously detected ones) in a NodeList
-onSelector("div", {
-  listener: (element) => {
-    console.log("Elements found:", element);
+onSelector<HTMLDivElement>("div", {
+  listener: (elements) => {
+    console.log("Elements found:", elements); // type = NodeListOf<HTMLDivElement>
   },
   all: true,
   continuous: true,
 });
 
 // Checks if an input element with a value attribute of "5" is added to the DOM, then returns it and deregisters the listener
-onSelector("input[value=\"5\"]", {
+onSelector<HTMLInputElement>("input[value=\"5\"]", {
   listener: (element) => {
-    console.log("Element found:", element);
+    console.log("Element found:", element); // type = HTMLInputElement
   },
 });
 ```
@@ -109,7 +125,7 @@ onSelector("input[value=\"5\"]", {
 ### initOnSelector()
 Usage:  
 ```ts
-initOnSelector(options: {
+initOnSelector(options?: {
   attributes?: boolean,
   characterData?: boolean,
 }): void
@@ -140,76 +156,40 @@ document.addEventListener("DOMContentLoaded", () => {
 
 <br>
 
-### autoPlural()
-Usage: `autoPlural(str: string, num: number | Array | NodeList): string`  
-  
-Automatically pluralizes a string if the given number is not 1.  
-If an array or NodeList is passed, the length of it will be used.  
-  
-<details><summary><b>Example - click to view</b></summary>
-
-```ts
-autoPlural("apple", 0); // "apples"
-autoPlural("apple", 1); // "apple"
-autoPlural("apple", 2); // "apples"
-
-autoPlural("apple", [1]);    // "apple"
-autoPlural("apple", [1, 2]); // "apples"
-```
-
-</details>
-
-<br>
-
-### clamp()
-Usage: `clamp(num: number, min: number, max: number): number`  
-  
-Clamps a number between a min and max value.  
-  
-<details><summary><b>Example - click to view</b></summary>
-
-```ts
-clamp(5, 0, 10);        // 5
-clamp(-1, 0, 10);       // 0
-clamp(Infinity, 0, 10); // 10
-```
-
-</details>
-
-<br>
-
-### pauseFor()
-Usage: `pauseFor(ms: number): Promise<void>`  
+### getSelectorMap()
+Usage: `getSelectorMap(): Map<string, OnSelectorOptions[]>`  
   
-Pauses async execution for a given amount of time.  
+Returns a Map of all currently registered selectors and their options, including listener function.  
+Since multiple listeners can be registered for the same selector, the value of the Map is an array of `OnSelectorOptions` objects.  
   
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-async function run() {
-  console.log("Hello");
-  await pauseFor(3000); // waits for 3 seconds
-  console.log("World");
-}
-```
-
-</details>
+document.addEventListener("DOMContentLoaded", initOnSelector);
 
-<br>
+onSelector<HTMLDivElement>("div", {
+  listener: (elements) => void 0,
+  all: true,
+  continuous: true,
+});
 
-### debounce()
-Usage: `debounce(func: Function, timeout?: number): Function`  
-  
-Debounces a function, meaning that it will only be called once after a given amount of time.  
-This is very useful for functions that are called repeatedly, like event listeners, to remove extraneous calls.  
-The timeout will default to 300ms if left undefined.  
-  
-<details><summary><b>Example - click to view</b></summary>
+onSelector<HTMLDivElement>("div", {
+  listener: (elements) => void 0,
+});
 
-```ts
-window.addEventListener("resize", debounce((event) => {
-  console.log("Window was resized:", event);
-}, 500)); // 500ms timeout
+const selectorMap = getSelectorMap();
+// Map(1) {
+//   "div" => [
+//     {
+//       listener: (elements) => void 0,
+//       all: true,
+//       continuous: true,
+//     },
+//     {
+//       listener: (elements) => void 0,
+//     },
+//   ]
+// }
 ```
 
 </details>
@@ -225,8 +205,13 @@ Userscripts are sandboxed and do not have access to the regular window object, s
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-const mouseEvent = new MouseEvent("click", {
+// trick the site into thinking the mouse was moved:
+const mouseEvent = new MouseEvent("mousemove", {
   view: getUnsafeWindow(),
+  screenY: 69,
+  screenX: 420,
+  movementX: 10,
+  movementY: 0,
 });
 document.body.dispatchEvent(mouseEvent);
 ```
@@ -246,6 +231,7 @@ The passed `afterElement` will be returned.
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
+// insert a <div> as a sibling next to an element
 const beforeElement = document.querySelector("#before");
 const afterElement = document.createElement("div");
 afterElement.innerText = "After";
@@ -267,6 +253,7 @@ Previously registered event listeners are kept intact.
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
+// add an <a> around an element
 const element = document.querySelector("#element");
 const newParent = document.createElement("a");
 newParent.href = "https://example.org/";
@@ -323,6 +310,191 @@ preloadImages([
 
 <br>
 
+### openInNewTab()
+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 needs to be run after the DOM has loaded (when using `@run-at document-end` or after `DOMContentLoaded` has fired).  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+document.querySelector("#my-button").addEventListener("click", () => {
+  openInNewTab("https://example.org/");
+});
+```
+
+</details>
+
+<br>
+
+### interceptEvent()
+Usage: `interceptEvent(eventObject: EventTarget, eventName: string, predicate: () => boolean): void`  
+  
+Intercepts all events dispatched on the `eventObject` and prevents the listeners from being called as long as the predicate function returns a truthy value.  
+Calling this function will set the `Error.stackTraceLimit` to 1000 (if it's not already higher) to ensure the stack trace is preserved.  
+  
+⚠️ This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are *attached* after this function is called.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+interceptEvent(document.body, "click", () => {
+  return true; // prevent all click events on the body element
+});
+```
+
+</details>
+
+<br>
+
+### interceptWindowEvent()
+Usage: `interceptWindowEvent(eventName: string, predicate: () => boolean): void`  
+  
+Intercepts all events dispatched on the `window` object and prevents the listeners from being called as long as the predicate function returns a truthy value.  
+This is essentially the same as [`interceptEvent()`](#interceptevent), but automatically uses the `unsafeWindow` (or falls back to regular `window`).  
+  
+⚠️ This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are *attached* after this function is called.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+interceptWindowEvent("beforeunload", () => {
+  return true; // prevent the pesky "Are you sure you want to leave this page?" popup
+});
+```
+
+</details>
+
+<br><br>
+
+## Math:
+
+### clamp()
+Usage: `clamp(num: number, min: number, max: number): number`  
+  
+Clamps a number between a min and max value.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+clamp(5, 0, 10);        // 5
+clamp(-1, 0, 10);       // 0
+clamp(7, 0, 10);        // 7
+clamp(Infinity, 0, 10); // 10
+```
+
+</details>
+
+<br>
+
+### mapRange()
+Usage: `mapRange(value: number, range_1_min: number, range_1_max: number, range_2_min: number, range_2_max: number): number`  
+  
+Maps a number from one range to the spot it would be in another range.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+mapRange(5, 0, 10, 0, 100); // 50
+mapRange(5, 0, 10, 0, 50);  // 25
+// to calculate a percentage from arbitrary values, use 0 and 100 as the second range:
+mapRange(4, 0, 13, 0, 100); // 30.76923076923077
+```
+
+</details>
+
+<br>
+
+### randRange()
+Usages:  
+```ts
+randRange(min: number, max: number): number
+randRange(max: number): number
+```
+  
+Returns a random number between `min` and `max` (inclusive).  
+If only one argument is passed, it will be used as the `max` value and `min` will be set to 0.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+randRange(0, 10);  // 4
+randRange(10, 20); // 17
+randRange(10);     // 7
+```
+
+</details>
+
+<br><br>
+
+## Misc:
+
+### autoPlural()
+Usage: `autoPlural(str: string, num: number | Array | NodeList): string`  
+  
+Automatically pluralizes a string if the given number is not 1.  
+If an array or NodeList is passed, the length of it will be used.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+autoPlural("apple", 0); // "apples"
+autoPlural("apple", 1); // "apple"
+autoPlural("apple", 2); // "apples"
+
+autoPlural("apple", [1]);    // "apple"
+autoPlural("apple", [1, 2]); // "apples"
+
+const items = [1, 2, 3, 4, "foo", "bar"];
+console.log(`Found ${items.length} ${autoPlural("item", items)}`); // "Found 6 items"
+```
+
+</details>
+
+<br>
+
+### pauseFor()
+Usage: `pauseFor(ms: number): Promise<void>`  
+  
+Pauses async execution for a given amount of time.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+async function run() {
+  console.log("Hello");
+  await pauseFor(3000); // waits for 3 seconds
+  console.log("World");
+}
+```
+
+</details>
+
+<br>
+
+### debounce()
+Usage: `debounce(func: Function, timeout?: number): Function`  
+  
+Debounces a function, meaning that it will only be called once after a given amount of time.  
+This is very useful for functions that are called repeatedly, like event listeners, to remove extraneous calls.  
+The timeout will default to 300ms if left undefined.  
+  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+window.addEventListener("resize", debounce((event) => {
+  console.log("Window was resized:", event);
+}, 500)); // 500ms timeout
+```
+
+</details>
+
+<br>
+
 ### fetchAdvanced()
 Usage:  
 ```ts
@@ -340,6 +512,7 @@ The timeout will default to 10 seconds if left undefined.
 ```ts
 fetchAdvanced("https://api.example.org/data", {
   timeout: 5000,
+  // also accepts any other fetch options like headers:
   headers: {
     "Accept": "application/json",
   },
@@ -350,67 +523,82 @@ fetchAdvanced("https://api.example.org/data", {
 
 </details>
 
-<br>
+<br><br>
 
-### openInNewTab()
-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.  
+## Arrays:
+
+### randomItem()
+Usage: `randomItem(array: Array): any`  
   
-⚠️ This function needs to be run after the DOM has loaded (when using `@run-at document-end` or after `DOMContentLoaded` has fired).  
+Returns a random item from an array.  
+Returns undefined if the array is empty.  
   
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-document.querySelector("#button").addEventListener("click", () => {
-  openInNewTab("https://example.org/");
-});
+randomItem(["foo", "bar", "baz"]); // "bar"
+randomItem([ ]);                   // undefined
 ```
 
 </details>
 
 <br>
 
-### interceptEvent()
-Usage: `interceptEvent(eventObject: EventTarget, eventName: string, predicate: () => boolean): void`  
+### randomItemIndex()
+Usage: `randomItemIndex(array: Array): [item: any, index: number]`  
   
-Intercepts all events dispatched on the `eventObject` and prevents the listeners from being called as long as the predicate function returns a truthy value.  
-Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.  
-  
-⚠️ This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are *attached* after this function is called.  
+Returns a tuple of a random item and its index from an array.  
+If the array is empty, it will return undefined for both values.  
   
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-interceptEvent(document.body, "click", () => {
-  return true; // prevent all click events on the body
-});
+randomItemIndex(["foo", "bar", "baz"]); // ["bar", 1]
+randomItemIndex([ ]);                   // [undefined, undefined]
+// using array destructuring:
+const [item, index] = randomItemIndex(["foo", "bar", "baz"]);
+// or if you only want the index:
+const [, index] = randomItemIndex(["foo", "bar", "baz"]);
 ```
 
 </details>
 
 <br>
 
-### interceptWindowEvent()
-Usage: `interceptWindowEvent(eventName: string, predicate: () => boolean): void`  
+### takeRandomItem()
+Usage: `takeRandomItem(array: Array): any`  
   
-Intercepts all events dispatched on the `window` object and prevents the listeners from being called as long as the predicate function returns a truthy value.  
-This is essentially the same as [`interceptEvent()`](#interceptevent), but automatically uses the `unsafeWindow` (or falls back to regular `window`).  
+Returns a random item from an array and mutates the array by removing the item.  
+Returns undefined if the array is empty.  
   
-⚠️ This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are *attached* after this function is called.  
+<details><summary><b>Example - click to view</b></summary>
+
+```ts
+const arr = ["foo", "bar", "baz"];
+takeRandomItem(arr); // "bar"
+console.log(arr);    // ["foo", "baz"]
+```
+
+</details>
+
+<br>
+
+### randomizeArray()
+Usage: `randomizeArray(array: Array): Array`  
+  
+Returns a copy of the array with its items in a random order.  
+If the array is empty, the originally passed array will be returned.  
   
 <details><summary><b>Example - click to view</b></summary>
 
 ```ts
-interceptWindowEvent("beforeunload", () => {
-  return true; // prevent the pesky "Are you sure you want to leave this page?" popup
-});
+randomizeArray([1, 2, 3, 4, 5, 6]); // [3, 1, 5, 2, 4, 6]
 ```
 
 </details>
 
+<br>
+
 
 <br><br>
 

package/dist/index.d.mts

@@ -1,46 +1,3 @@
-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 */
-    all?: false;
-    /** Gets called whenever the selector was found in the DOM */
-    listener: (element: TElem) => void;
-};
-type SelectorOptsAll<TElem extends Element> = SelectorOptsBase & {
-    /** Whether to use `querySelectorAll()` instead - default is false */
-    all: true;
-    /** Gets called whenever the selector was found in the DOM */
-    listener: (elements: NodeListOf<TElem>) => void;
-};
-type SelectorOptsBase = {
-    /** Whether to call the listener continuously instead of once - default is false */
-    continuous?: boolean;
-};
-type FetchAdvancedOpts = RequestInit & Partial<{
-    /** Timeout in milliseconds after which the fetch call will be canceled with an AbortController signal */
-    timeout: number;
-}>;
-
-/**
- * Automatically appends an `s` to the passed `word`, if `num` is not equal to 1
- * @param word A word in singular form, to auto-convert to plural
- * @param num If this is an array or NodeList, the amount of items is used
- */
-declare function autoPlural(word: string, num: number | unknown[] | NodeList): string;
-/** Ensures the passed `value` always stays between `min` and `max` */
-declare function clamp(value: number, min: number, max: number): number;
-/** Pauses async execution for the specified time in ms */
-declare function pauseFor(time: number): Promise<unknown>;
-/**
- * Calls the passed `func` after the specified `timeout` in ms.
- * Any subsequent calls to this function will reset the timer and discard previous calls.
- */
-declare function debounce<TFunc extends (...args: TArgs[]) => void, TArgs = any>(func: TFunc, timeout?: number): (...args: TArgs[]) => void;
 /**
  * Returns `unsafeWindow` if the `@grant unsafeWindow` is given, otherwise falls back to the regular `window`
  */
@@ -67,8 +24,6 @@ declare function addGlobalStyle(style: string): void;
  * @returns Returns an array of `PromiseSettledResult` - each resolved result will contain the loaded image element, while each rejected result will contain an `ErrorEvent`
  */
 declare function preloadImages(srcUrls: string[], rejects?: boolean): Promise<PromiseSettledResult<unknown>[]>;
-/** Calls the fetch API with special options like a timeout */
-declare function fetchAdvanced(url: string, options?: FetchAdvancedOpts): Promise<Response>;
 /**
  * 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.
@@ -89,6 +44,62 @@ declare function interceptEvent<TEvtObj extends EventTarget>(eventObject: TEvtOb
  */
 declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate: () => boolean): void;
 
+/** Ensures the passed `value` always stays between `min` and `max` */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Transforms the value parameter from the numerical range `range_1_min-range_1_max` to the numerical range `range_2_min-range_2_max`
+ * For example, you can map the value 2 in the range of 0-5 to the range of 0-10 and you'd get a 4 as a result.
+ */
+declare function mapRange(value: number, range_1_min: number, range_1_max: number, range_2_min: number, range_2_max: number): number;
+/** Returns a random number between `min` and `max` (inclusive) */
+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 */
+    all?: false;
+    /** Gets called whenever the selector was found in the DOM */
+    listener: (element: TElem) => void;
+};
+type SelectorOptsAll<TElem extends Element> = SelectorOptsBase & {
+    /** Whether to use `querySelectorAll()` instead - default is false */
+    all: true;
+    /** Gets called whenever the selector was found in the DOM */
+    listener: (elements: NodeListOf<TElem>) => void;
+};
+type SelectorOptsBase = {
+    /** Whether to call the listener continuously instead of once - default is false */
+    continuous?: boolean;
+};
+type FetchAdvancedOpts = RequestInit & Partial<{
+    /** Timeout in milliseconds after which the fetch call will be canceled with an AbortController signal */
+    timeout: number;
+}>;
+
+/**
+ * Automatically appends an `s` to the passed `word`, if `num` is not equal to 1
+ * @param word A word in singular form, to auto-convert to plural
+ * @param num If this is an array or NodeList, the amount of items is used
+ */
+declare function autoPlural(word: string, num: number | unknown[] | NodeList): string;
+/** Pauses async execution for the specified time in ms */
+declare function pauseFor(time: number): Promise<unknown>;
+/**
+ * Calls the passed `func` after the specified `timeout` in ms.
+ * Any subsequent calls to this function will reset the timer and discard previous calls.
+ */
+declare function debounce<TFunc extends (...args: TArgs[]) => void, TArgs = any>(func: TFunc, timeout?: number): (...args: TArgs[]) => void;
+/** Calls the fetch API with special options like a timeout */
+declare function fetchAdvanced(url: string, options?: FetchAdvancedOpts): Promise<Response>;
+
 /**
  * Calls the `listener` as soon as the `selector` exists in the DOM.
  * Listeners are deleted when they are called once, unless `options.continuous` is set.
@@ -98,12 +109,17 @@ declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate
  * @template TElem The type of element that the listener will return as its argument (defaults to the generic HTMLElement)
  */
 declare function onSelector<TElem extends Element = HTMLElement>(selector: string, options: OnSelectorOpts<TElem>): void;
-/** Removes all listeners registered in `onSelector()` that have the given selector */
+/**
+ * Removes all listeners registered in `onSelector()` that have the given selector
+ * @returns Returns true when all listeners with the associated selector were found and removed, false otherwise
+ */
 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
  */
 declare function initOnSelector(opts?: InitOnSelectorOpts): 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, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, onSelector, openInNewTab, pauseFor, preloadImages, removeOnSelector };
+export { FetchAdvancedOpts, InitOnSelectorOpts, OnSelectorOpts, addGlobalStyle, addParent, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, removeOnSelector };

package/dist/index.d.ts

@@ -1,46 +1,3 @@
-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 */
-    all?: false;
-    /** Gets called whenever the selector was found in the DOM */
-    listener: (element: TElem) => void;
-};
-type SelectorOptsAll<TElem extends Element> = SelectorOptsBase & {
-    /** Whether to use `querySelectorAll()` instead - default is false */
-    all: true;
-    /** Gets called whenever the selector was found in the DOM */
-    listener: (elements: NodeListOf<TElem>) => void;
-};
-type SelectorOptsBase = {
-    /** Whether to call the listener continuously instead of once - default is false */
-    continuous?: boolean;
-};
-type FetchAdvancedOpts = RequestInit & Partial<{
-    /** Timeout in milliseconds after which the fetch call will be canceled with an AbortController signal */
-    timeout: number;
-}>;
-
-/**
- * Automatically appends an `s` to the passed `word`, if `num` is not equal to 1
- * @param word A word in singular form, to auto-convert to plural
- * @param num If this is an array or NodeList, the amount of items is used
- */
-declare function autoPlural(word: string, num: number | unknown[] | NodeList): string;
-/** Ensures the passed `value` always stays between `min` and `max` */
-declare function clamp(value: number, min: number, max: number): number;
-/** Pauses async execution for the specified time in ms */
-declare function pauseFor(time: number): Promise<unknown>;
-/**
- * Calls the passed `func` after the specified `timeout` in ms.
- * Any subsequent calls to this function will reset the timer and discard previous calls.
- */
-declare function debounce<TFunc extends (...args: TArgs[]) => void, TArgs = any>(func: TFunc, timeout?: number): (...args: TArgs[]) => void;
 /**
  * Returns `unsafeWindow` if the `@grant unsafeWindow` is given, otherwise falls back to the regular `window`
  */
@@ -67,8 +24,6 @@ declare function addGlobalStyle(style: string): void;
  * @returns Returns an array of `PromiseSettledResult` - each resolved result will contain the loaded image element, while each rejected result will contain an `ErrorEvent`
  */
 declare function preloadImages(srcUrls: string[], rejects?: boolean): Promise<PromiseSettledResult<unknown>[]>;
-/** Calls the fetch API with special options like a timeout */
-declare function fetchAdvanced(url: string, options?: FetchAdvancedOpts): Promise<Response>;
 /**
  * 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.
@@ -89,6 +44,62 @@ declare function interceptEvent<TEvtObj extends EventTarget>(eventObject: TEvtOb
  */
 declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate: () => boolean): void;
 
+/** Ensures the passed `value` always stays between `min` and `max` */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Transforms the value parameter from the numerical range `range_1_min-range_1_max` to the numerical range `range_2_min-range_2_max`
+ * For example, you can map the value 2 in the range of 0-5 to the range of 0-10 and you'd get a 4 as a result.
+ */
+declare function mapRange(value: number, range_1_min: number, range_1_max: number, range_2_min: number, range_2_max: number): number;
+/** Returns a random number between `min` and `max` (inclusive) */
+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 */
+    all?: false;
+    /** Gets called whenever the selector was found in the DOM */
+    listener: (element: TElem) => void;
+};
+type SelectorOptsAll<TElem extends Element> = SelectorOptsBase & {
+    /** Whether to use `querySelectorAll()` instead - default is false */
+    all: true;
+    /** Gets called whenever the selector was found in the DOM */
+    listener: (elements: NodeListOf<TElem>) => void;
+};
+type SelectorOptsBase = {
+    /** Whether to call the listener continuously instead of once - default is false */
+    continuous?: boolean;
+};
+type FetchAdvancedOpts = RequestInit & Partial<{
+    /** Timeout in milliseconds after which the fetch call will be canceled with an AbortController signal */
+    timeout: number;
+}>;
+
+/**
+ * Automatically appends an `s` to the passed `word`, if `num` is not equal to 1
+ * @param word A word in singular form, to auto-convert to plural
+ * @param num If this is an array or NodeList, the amount of items is used
+ */
+declare function autoPlural(word: string, num: number | unknown[] | NodeList): string;
+/** Pauses async execution for the specified time in ms */
+declare function pauseFor(time: number): Promise<unknown>;
+/**
+ * Calls the passed `func` after the specified `timeout` in ms.
+ * Any subsequent calls to this function will reset the timer and discard previous calls.
+ */
+declare function debounce<TFunc extends (...args: TArgs[]) => void, TArgs = any>(func: TFunc, timeout?: number): (...args: TArgs[]) => void;
+/** Calls the fetch API with special options like a timeout */
+declare function fetchAdvanced(url: string, options?: FetchAdvancedOpts): Promise<Response>;
+
 /**
  * Calls the `listener` as soon as the `selector` exists in the DOM.
  * Listeners are deleted when they are called once, unless `options.continuous` is set.
@@ -98,12 +109,17 @@ declare function interceptWindowEvent(eventName: keyof WindowEventMap, predicate
  * @template TElem The type of element that the listener will return as its argument (defaults to the generic HTMLElement)
  */
 declare function onSelector<TElem extends Element = HTMLElement>(selector: string, options: OnSelectorOpts<TElem>): void;
-/** Removes all listeners registered in `onSelector()` that have the given selector */
+/**
+ * Removes all listeners registered in `onSelector()` that have the given selector
+ * @returns Returns true when all listeners with the associated selector were found and removed, false otherwise
+ */
 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
  */
 declare function initOnSelector(opts?: InitOnSelectorOpts): 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, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, onSelector, openInNewTab, pauseFor, preloadImages, removeOnSelector };
+export { FetchAdvancedOpts, InitOnSelectorOpts, OnSelectorOpts, addGlobalStyle, addParent, autoPlural, clamp, debounce, fetchAdvanced, getSelectorMap, getUnsafeWindow, initOnSelector, insertAfter, interceptEvent, interceptWindowEvent, mapRange, onSelector, openInNewTab, pauseFor, preloadImages, randRange, removeOnSelector };

package/dist/index.js

@@ -1,20 +1,23 @@
 'use strict';
 
-var b=Object.defineProperty,v=Object.defineProperties;var y=Object.getOwnPropertyDescriptors;var m=Object.getOwnPropertySymbols;var x=Object.prototype.hasOwnProperty,g=Object.prototype.propertyIsEnumerable;var f=(t,e,n)=>e in t?b(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,u=(t,e)=>{for(var n in e||(e={}))x.call(e,n)&&f(t,n,e[n]);if(m)for(var n of m(e))g.call(e,n)&&f(t,n,e[n]);return t},d=(t,e)=>v(t,y(e));var E=(t,e,n)=>new Promise((r,o)=>{var s=c=>{try{l(n.next(c));}catch(p){o(p);}},i=c=>{try{l(n.throw(c));}catch(p){o(p);}},l=c=>c.done?r(c.value):Promise.resolve(c.value).then(s,i);l((n=n.apply(t,e)).next());});function w(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function M(t,e,n){return Math.max(Math.min(t,n),e)}function S(t){return new Promise(e=>{setTimeout(e,t);})}function A(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function h(){try{return unsafeWindow}catch(t){return window}}function _(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function k(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 H(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function I(t,e=!1){let n=t.map(r=>new Promise((o,s)=>{let i=new Image;i.src=r,i.addEventListener("load",()=>o(i)),i.addEventListener("error",l=>e&&s(l));}));return Promise.allSettled(n)}function j(n){return E(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,s=setTimeout(()=>o.abort(),r),i=yield fetch(t,d(u({},e),{signal:o.signal}));return clearTimeout(s),i})}function N(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 O(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 P(t,e){return O(h(),t,e)}var a=new Map;function W(t,e){let n=[];a.has(t)&&(n=a.get(t)),n.push(e),a.set(t,n),T(t,n);}function q(t){return a.delete(t)}function T(t,e){let n=[];e.forEach((r,o)=>{try{let s=r.all?document.querySelectorAll(t):document.querySelector(t);s&&(r.listener(s),r.continuous||n.push(o));}catch(s){}}),n.length>0&&a.set(t,e.filter((r,o)=>!n.includes(o)));}function $(t={}){new MutationObserver(()=>{for(let[n,r]of a.entries())T(n,r);}).observe(document.body,d(u({},t),{childList:!0}));}
+var x=Object.defineProperty,y=Object.defineProperties;var T=Object.getOwnPropertyDescriptors;var d=Object.getOwnPropertySymbols;var h=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var f=(t,e,n)=>e in t?x(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,m=(t,e)=>{for(var n in e||(e={}))h.call(e,n)&&f(t,n,e[n]);if(d)for(var n of d(e))v.call(e,n)&&f(t,n,e[n]);return t},l=(t,e)=>y(t,T(e));var b=(t,e,n)=>new Promise((r,o)=>{var i=u=>{try{a(n.next(u));}catch(p){o(p);}},s=u=>{try{a(n.throw(u));}catch(p){o(p);}},a=u=>u.done?r(u.value):Promise.resolve(u.value).then(i,s);a((n=n.apply(t,e)).next());});function O(){try{return unsafeWindow}catch(t){return window}}function L(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function M(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 S(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function N(t,e=!1){let n=t.map(r=>new Promise((o,i)=>{let s=new Image;s.src=r,s.addEventListener("load",()=>o(s)),s.addEventListener("error",a=>e&&i(a));}));return Promise.allSettled(n)}function A(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 w(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 k(t,e){return w(O(),t,e)}function P(t,e,n){return Math.max(Math.min(t,n),e)}function I(t,e,n,r,o){return Number(e)===0&&Number(r)===0?t*(o/n):(t-e)*((o-r)/(n-e))+r}function j(...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 F(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function W(t){return new Promise(e=>{setTimeout(e,t);})}function $(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function R(n){return b(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),s=yield fetch(t,l(m({},e),{signal:o.signal}));return clearTimeout(i),s})}var c=new Map;function G(t,e){let n=[];c.has(t)&&(n=c.get(t)),n.push(e),c.set(t,n),E(t,n);}function U(t){return c.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?c.delete(t):c.set(t,r);}}function z(t={}){new MutationObserver(()=>{for(let[n,r]of c.entries())E(n,r);}).observe(document.body,l(m({},t),{childList:!0}));}function D(){return c}
 
-exports.addGlobalStyle = H;
-exports.addParent = k;
-exports.autoPlural = w;
-exports.clamp = M;
-exports.debounce = A;
-exports.fetchAdvanced = j;
-exports.getUnsafeWindow = h;
-exports.initOnSelector = $;
-exports.insertAfter = _;
-exports.interceptEvent = O;
-exports.interceptWindowEvent = P;
-exports.onSelector = W;
-exports.openInNewTab = N;
-exports.pauseFor = S;
-exports.preloadImages = I;
-exports.removeOnSelector = q;
+exports.addGlobalStyle = S;
+exports.addParent = M;
+exports.autoPlural = F;
+exports.clamp = P;
+exports.debounce = $;
+exports.fetchAdvanced = R;
+exports.getSelectorMap = D;
+exports.getUnsafeWindow = O;
+exports.initOnSelector = z;
+exports.insertAfter = L;
+exports.interceptEvent = w;
+exports.interceptWindowEvent = k;
+exports.mapRange = I;
+exports.onSelector = G;
+exports.openInNewTab = A;
+exports.pauseFor = W;
+exports.preloadImages = N;
+exports.randRange = j;
+exports.removeOnSelector = U;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-var b=Object.defineProperty,v=Object.defineProperties;var y=Object.getOwnPropertyDescriptors;var m=Object.getOwnPropertySymbols;var x=Object.prototype.hasOwnProperty,g=Object.prototype.propertyIsEnumerable;var f=(t,e,n)=>e in t?b(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,u=(t,e)=>{for(var n in e||(e={}))x.call(e,n)&&f(t,n,e[n]);if(m)for(var n of m(e))g.call(e,n)&&f(t,n,e[n]);return t},d=(t,e)=>v(t,y(e));var E=(t,e,n)=>new Promise((r,o)=>{var s=c=>{try{l(n.next(c));}catch(p){o(p);}},i=c=>{try{l(n.throw(c));}catch(p){o(p);}},l=c=>c.done?r(c.value):Promise.resolve(c.value).then(s,i);l((n=n.apply(t,e)).next());});function w(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function M(t,e,n){return Math.max(Math.min(t,n),e)}function S(t){return new Promise(e=>{setTimeout(e,t);})}function A(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function h(){try{return unsafeWindow}catch(t){return window}}function _(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function k(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 H(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function I(t,e=!1){let n=t.map(r=>new Promise((o,s)=>{let i=new Image;i.src=r,i.addEventListener("load",()=>o(i)),i.addEventListener("error",l=>e&&s(l));}));return Promise.allSettled(n)}function j(n){return E(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,s=setTimeout(()=>o.abort(),r),i=yield fetch(t,d(u({},e),{signal:o.signal}));return clearTimeout(s),i})}function N(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 O(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 P(t,e){return O(h(),t,e)}var a=new Map;function W(t,e){let n=[];a.has(t)&&(n=a.get(t)),n.push(e),a.set(t,n),T(t,n);}function q(t){return a.delete(t)}function T(t,e){let n=[];e.forEach((r,o)=>{try{let s=r.all?document.querySelectorAll(t):document.querySelector(t);s&&(r.listener(s),r.continuous||n.push(o));}catch(s){}}),n.length>0&&a.set(t,e.filter((r,o)=>!n.includes(o)));}function $(t={}){new MutationObserver(()=>{for(let[n,r]of a.entries())T(n,r);}).observe(document.body,d(u({},t),{childList:!0}));}
+var x=Object.defineProperty,y=Object.defineProperties;var T=Object.getOwnPropertyDescriptors;var d=Object.getOwnPropertySymbols;var h=Object.prototype.hasOwnProperty,v=Object.prototype.propertyIsEnumerable;var f=(t,e,n)=>e in t?x(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,m=(t,e)=>{for(var n in e||(e={}))h.call(e,n)&&f(t,n,e[n]);if(d)for(var n of d(e))v.call(e,n)&&f(t,n,e[n]);return t},l=(t,e)=>y(t,T(e));var b=(t,e,n)=>new Promise((r,o)=>{var i=u=>{try{a(n.next(u));}catch(p){o(p);}},s=u=>{try{a(n.throw(u));}catch(p){o(p);}},a=u=>u.done?r(u.value):Promise.resolve(u.value).then(i,s);a((n=n.apply(t,e)).next());});function O(){try{return unsafeWindow}catch(t){return window}}function L(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function M(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 S(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function N(t,e=!1){let n=t.map(r=>new Promise((o,i)=>{let s=new Image;s.src=r,s.addEventListener("load",()=>o(s)),s.addEventListener("error",a=>e&&i(a));}));return Promise.allSettled(n)}function A(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 w(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 k(t,e){return w(O(),t,e)}function P(t,e,n){return Math.max(Math.min(t,n),e)}function I(t,e,n,r,o){return Number(e)===0&&Number(r)===0?t*(o/n):(t-e)*((o-r)/(n-e))+r}function j(...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 F(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function W(t){return new Promise(e=>{setTimeout(e,t);})}function $(t,e=300){let n;return function(...r){clearTimeout(n),n=setTimeout(()=>t.apply(this,r),e);}}function R(n){return b(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,o=new AbortController,i=setTimeout(()=>o.abort(),r),s=yield fetch(t,l(m({},e),{signal:o.signal}));return clearTimeout(i),s})}var c=new Map;function G(t,e){let n=[];c.has(t)&&(n=c.get(t)),n.push(e),c.set(t,n),E(t,n);}function U(t){return c.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?c.delete(t):c.set(t,r);}}function z(t={}){new MutationObserver(()=>{for(let[n,r]of c.entries())E(n,r);}).observe(document.body,l(m({},t),{childList:!0}));}function D(){return c}
 
-export { H as addGlobalStyle, k as addParent, w as autoPlural, M as clamp, A as debounce, j as fetchAdvanced, h as getUnsafeWindow, $ as initOnSelector, _ as insertAfter, O as interceptEvent, P as interceptWindowEvent, W as onSelector, N as openInNewTab, S as pauseFor, I as preloadImages, q as removeOnSelector };
+export { S as addGlobalStyle, M as addParent, F as autoPlural, P as clamp, $ as debounce, R as fetchAdvanced, D as getSelectorMap, O as getUnsafeWindow, z as initOnSelector, L as insertAfter, w as interceptEvent, k as interceptWindowEvent, I as mapRange, G as onSelector, A as openInNewTab, W as pauseFor, N as preloadImages, j as randRange, U as removeOnSelector };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sv443-network/userutils",
-  "version": "0.2.0",
+  "version": "0.4.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",