@sv443-network/userutils 0.5.2 → 1.0.0

package/dist/index.js

@@ -1,28 +1,29 @@
 'use strict';
 
-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}
+var v=Object.defineProperty,x=Object.defineProperties;var w=Object.getOwnPropertyDescriptors;var h=Object.getOwnPropertySymbols;var M=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable;var p=(t,e,n)=>e in t?v(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,f=(t,e)=>{for(var n in e||(e={}))M.call(e,n)&&p(t,n,e[n]);if(h)for(var n of h(e))O.call(e,n)&&p(t,n,e[n]);return t},b=(t,e)=>x(t,w(e));var m=(t,e,n)=>(p(t,typeof e!="symbol"?e+"":e,n),n);var l=(t,e,n)=>new Promise((r,i)=>{var o=s=>{try{u(n.next(s));}catch(c){i(c);}},a=s=>{try{u(n.throw(s));}catch(c){i(c);}},u=s=>s.done?r(s.value):Promise.resolve(s.value).then(o,a);u((n=n.apply(t,e)).next());});function D(t,e,n){return Math.max(Math.min(t,n),e)}function L(t,e,n,r,i){return Number(e)===0&&Number(r)===0?t*(i/n):(t-e)*((i-r)/(n-e))+r}function g(...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 V(t){return T(t)[0]}function T(t){if(t.length===0)return [void 0,void 0];let e=g(t.length-1);return [t[e],e]}function $(t){let[e,n]=T(t);if(n!==void 0)return t.splice(n,1),e}function k(t){let e=[...t];if(t.length===0)return t;for(let n=e.length-1;n>0;n--){let r=Math.floor(g(0,1e4)/1e4*(n+1));[e[n],e[r]]=[e[r],e[n]];}return e}var y=class{constructor(e){m(this,"id");m(this,"formatVersion");m(this,"defaultConfig");m(this,"cachedConfig");m(this,"migrations");this.id=e.id,this.formatVersion=e.formatVersion,this.defaultConfig=e.defaultConfig,this.cachedConfig=e.defaultConfig,this.migrations=e.migrations;}loadData(){return l(this,null,function*(){try{let e=yield GM.getValue(`_uucfg-${this.id}`,this.defaultConfig),n=Number(yield GM.getValue(`_uucfgver-${this.id}`));if(typeof e!="string")return yield this.saveDefaultData(),this.defaultConfig;isNaN(n)&&(yield GM.setValue(`_uucfgver-${this.id}`,n=this.formatVersion));let r=JSON.parse(e);return n<this.formatVersion&&this.migrations&&(r=yield this.runMigrations(r,n)),this.cachedConfig=typeof r=="object"?r:void 0}catch(e){return yield this.saveDefaultData(),this.defaultConfig}})}getData(){return this.deepCopy(this.cachedConfig)}setData(e){return this.cachedConfig=e,new Promise(n=>l(this,null,function*(){yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(e)),GM.setValue(`_uucfgver-${this.id}`,this.formatVersion)]),n();}))}saveDefaultData(){return l(this,null,function*(){return this.cachedConfig=this.defaultConfig,new Promise(e=>l(this,null,function*(){yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(this.defaultConfig)),GM.setValue(`_uucfgver-${this.id}`,this.formatVersion)]),e();}))})}deleteConfig(){return l(this,null,function*(){yield Promise.allSettled([GM.deleteValue(`_uucfg-${this.id}`),GM.deleteValue(`_uucfgver-${this.id}`)]);})}runMigrations(e,n){return l(this,null,function*(){if(!this.migrations)return e;let r=e,i=Object.entries(this.migrations).sort(([a],[u])=>Number(a)-Number(u)),o=n;for(let[a,u]of i){let s=Number(a);if(n<this.formatVersion&&n<s)try{let c=u(r);r=c instanceof Promise?yield c:c,o=n=s;}catch(c){console.error(`Error while running migration function for format version ${a}:`,c);}}return yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(r)),GM.setValue(`_uucfgver-${this.id}`,o)]),r})}deepCopy(e){return JSON.parse(JSON.stringify(e))}};function S(){try{return unsafeWindow}catch(t){return window}}function R(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function _(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 j(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function F(t,e=!1){let n=t.map(r=>new Promise((i,o)=>{let a=new Image;a.src=r,a.addEventListener("load",()=>i(a)),a.addEventListener("error",u=>e&&o(u));}));return Promise.allSettled(n)}function J(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 N(t,e,n){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){t.__proto__.addEventListener=function(...i){var a,u;let o=typeof i[1]=="function"?i[1]:(u=(a=i[1])==null?void 0:a.handleEvent)!=null?u:()=>{};i[1]=function(...s){if(!(i[0]===e&&n(Array.isArray(s)?s[0]:s)))return o.apply(this,s)},r.apply(this,i);};}(t.__proto__.addEventListener);}function W(t,e){return N(S(),t,e)}function B(t,e=1){let n=new(window.AudioContext||window.webkitAudioContext),r={mediaElement:t,amplify:i=>{r.gain.gain.value=i;},getAmpLevel:()=>r.gain.gain.value,context:n,source:n.createMediaElementSource(t),gain:n.createGain()};return r.source.connect(r.gain),r.gain.connect(n.destination),r.amplify(e),r}function K(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function z(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 Q(n){return l(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,i=new AbortController,o=setTimeout(()=>i.abort(),r),a=yield fetch(t,b(f({},e),{signal:i.signal}));return clearTimeout(o),a})}var d=new Map;function Z(t,e){let n=[];d.has(t)&&(n=d.get(t)),n.push(e),d.set(t,n),E(t,n);}function ee(t){return d.delete(t)}function E(t,e){let n=[];if(e.forEach((r,i)=>{try{let o=r.all?document.querySelectorAll(t):document.querySelector(t);(o!==null&&o instanceof NodeList&&o.length>0||o!==null)&&(r.listener(o),r.continuous||n.push(i));}catch(o){console.error(`Couldn't call listener for selector '${t}'`,o);}}),n.length>0){let r=e.filter((i,o)=>!n.includes(o));r.length===0?d.delete(t):d.set(t,r);}}function te(t={}){new MutationObserver(()=>{for(let[n,r]of d.entries())E(n,r);}).observe(document.body,f({subtree:!0,childList:!0},t));}function ne(){return d}
 
-exports.addGlobalStyle = F;
-exports.addParent = R;
-exports.amplifyMedia = G;
-exports.autoPlural = B;
-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 = V;
-exports.openInNewTab = $;
-exports.pauseFor = U;
-exports.preloadImages = W;
-exports.randRange = d;
-exports.randomItem = H;
+exports.ConfigManager = y;
+exports.addGlobalStyle = j;
+exports.addParent = _;
+exports.amplifyMedia = B;
+exports.autoPlural = K;
+exports.clamp = D;
+exports.debounce = U;
+exports.fetchAdvanced = Q;
+exports.getSelectorMap = ne;
+exports.getUnsafeWindow = S;
+exports.initOnSelector = te;
+exports.insertAfter = R;
+exports.interceptEvent = N;
+exports.interceptWindowEvent = W;
+exports.mapRange = L;
+exports.onSelector = Z;
+exports.openInNewTab = J;
+exports.pauseFor = z;
+exports.preloadImages = F;
+exports.randRange = g;
+exports.randomItem = V;
 exports.randomItemIndex = T;
-exports.randomizeArray = C;
-exports.removeOnSelector = X;
-exports.takeRandomItem = I;
+exports.randomizeArray = k;
+exports.removeOnSelector = ee;
+exports.takeRandomItem = $;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-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}
+var v=Object.defineProperty,x=Object.defineProperties;var w=Object.getOwnPropertyDescriptors;var h=Object.getOwnPropertySymbols;var M=Object.prototype.hasOwnProperty,O=Object.prototype.propertyIsEnumerable;var p=(t,e,n)=>e in t?v(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n,f=(t,e)=>{for(var n in e||(e={}))M.call(e,n)&&p(t,n,e[n]);if(h)for(var n of h(e))O.call(e,n)&&p(t,n,e[n]);return t},b=(t,e)=>x(t,w(e));var m=(t,e,n)=>(p(t,typeof e!="symbol"?e+"":e,n),n);var l=(t,e,n)=>new Promise((r,i)=>{var o=s=>{try{u(n.next(s));}catch(c){i(c);}},a=s=>{try{u(n.throw(s));}catch(c){i(c);}},u=s=>s.done?r(s.value):Promise.resolve(s.value).then(o,a);u((n=n.apply(t,e)).next());});function D(t,e,n){return Math.max(Math.min(t,n),e)}function L(t,e,n,r,i){return Number(e)===0&&Number(r)===0?t*(i/n):(t-e)*((i-r)/(n-e))+r}function g(...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 V(t){return T(t)[0]}function T(t){if(t.length===0)return [void 0,void 0];let e=g(t.length-1);return [t[e],e]}function $(t){let[e,n]=T(t);if(n!==void 0)return t.splice(n,1),e}function k(t){let e=[...t];if(t.length===0)return t;for(let n=e.length-1;n>0;n--){let r=Math.floor(g(0,1e4)/1e4*(n+1));[e[n],e[r]]=[e[r],e[n]];}return e}var y=class{constructor(e){m(this,"id");m(this,"formatVersion");m(this,"defaultConfig");m(this,"cachedConfig");m(this,"migrations");this.id=e.id,this.formatVersion=e.formatVersion,this.defaultConfig=e.defaultConfig,this.cachedConfig=e.defaultConfig,this.migrations=e.migrations;}loadData(){return l(this,null,function*(){try{let e=yield GM.getValue(`_uucfg-${this.id}`,this.defaultConfig),n=Number(yield GM.getValue(`_uucfgver-${this.id}`));if(typeof e!="string")return yield this.saveDefaultData(),this.defaultConfig;isNaN(n)&&(yield GM.setValue(`_uucfgver-${this.id}`,n=this.formatVersion));let r=JSON.parse(e);return n<this.formatVersion&&this.migrations&&(r=yield this.runMigrations(r,n)),this.cachedConfig=typeof r=="object"?r:void 0}catch(e){return yield this.saveDefaultData(),this.defaultConfig}})}getData(){return this.deepCopy(this.cachedConfig)}setData(e){return this.cachedConfig=e,new Promise(n=>l(this,null,function*(){yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(e)),GM.setValue(`_uucfgver-${this.id}`,this.formatVersion)]),n();}))}saveDefaultData(){return l(this,null,function*(){return this.cachedConfig=this.defaultConfig,new Promise(e=>l(this,null,function*(){yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(this.defaultConfig)),GM.setValue(`_uucfgver-${this.id}`,this.formatVersion)]),e();}))})}deleteConfig(){return l(this,null,function*(){yield Promise.allSettled([GM.deleteValue(`_uucfg-${this.id}`),GM.deleteValue(`_uucfgver-${this.id}`)]);})}runMigrations(e,n){return l(this,null,function*(){if(!this.migrations)return e;let r=e,i=Object.entries(this.migrations).sort(([a],[u])=>Number(a)-Number(u)),o=n;for(let[a,u]of i){let s=Number(a);if(n<this.formatVersion&&n<s)try{let c=u(r);r=c instanceof Promise?yield c:c,o=n=s;}catch(c){console.error(`Error while running migration function for format version ${a}:`,c);}}return yield Promise.allSettled([GM.setValue(`_uucfg-${this.id}`,JSON.stringify(r)),GM.setValue(`_uucfgver-${this.id}`,o)]),r})}deepCopy(e){return JSON.parse(JSON.stringify(e))}};function S(){try{return unsafeWindow}catch(t){return window}}function R(t,e){var n;return (n=t.parentNode)==null||n.insertBefore(e,t.nextSibling),e}function _(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 j(t){let e=document.createElement("style");e.innerHTML=t,document.head.appendChild(e);}function F(t,e=!1){let n=t.map(r=>new Promise((i,o)=>{let a=new Image;a.src=r,a.addEventListener("load",()=>i(a)),a.addEventListener("error",u=>e&&o(u));}));return Promise.allSettled(n)}function J(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 N(t,e,n){typeof Error.stackTraceLimit=="number"&&Error.stackTraceLimit<1e3&&(Error.stackTraceLimit=1e3),function(r){t.__proto__.addEventListener=function(...i){var a,u;let o=typeof i[1]=="function"?i[1]:(u=(a=i[1])==null?void 0:a.handleEvent)!=null?u:()=>{};i[1]=function(...s){if(!(i[0]===e&&n(Array.isArray(s)?s[0]:s)))return o.apply(this,s)},r.apply(this,i);};}(t.__proto__.addEventListener);}function W(t,e){return N(S(),t,e)}function B(t,e=1){let n=new(window.AudioContext||window.webkitAudioContext),r={mediaElement:t,amplify:i=>{r.gain.gain.value=i;},getAmpLevel:()=>r.gain.gain.value,context:n,source:n.createMediaElementSource(t),gain:n.createGain()};return r.source.connect(r.gain),r.gain.connect(n.destination),r.amplify(e),r}function K(t,e){return (Array.isArray(e)||e instanceof NodeList)&&(e=e.length),`${t}${e===1?"":"s"}`}function z(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 Q(n){return l(this,arguments,function*(t,e={}){let{timeout:r=1e4}=e,i=new AbortController,o=setTimeout(()=>i.abort(),r),a=yield fetch(t,b(f({},e),{signal:i.signal}));return clearTimeout(o),a})}var d=new Map;function Z(t,e){let n=[];d.has(t)&&(n=d.get(t)),n.push(e),d.set(t,n),E(t,n);}function ee(t){return d.delete(t)}function E(t,e){let n=[];if(e.forEach((r,i)=>{try{let o=r.all?document.querySelectorAll(t):document.querySelector(t);(o!==null&&o instanceof NodeList&&o.length>0||o!==null)&&(r.listener(o),r.continuous||n.push(i));}catch(o){console.error(`Couldn't call listener for selector '${t}'`,o);}}),n.length>0){let r=e.filter((i,o)=>!n.includes(o));r.length===0?d.delete(t):d.set(t,r);}}function te(t={}){new MutationObserver(()=>{for(let[n,r]of d.entries())E(n,r);}).observe(document.body,f({subtree:!0,childList:!0},t));}function ne(){return d}
 
-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 };
+export { y as ConfigManager, j as addGlobalStyle, _ as addParent, B as amplifyMedia, K as autoPlural, D as clamp, U as debounce, Q as fetchAdvanced, ne as getSelectorMap, S as getUnsafeWindow, te as initOnSelector, R as insertAfter, N as interceptEvent, W as interceptWindowEvent, L as mapRange, Z as onSelector, J as openInNewTab, z as pauseFor, F as preloadImages, g as randRange, V as randomItem, T as randomItemIndex, k as randomizeArray, ee as removeOnSelector, $ as takeRandomItem };

package/dist/lib/array.d.ts

@@ -0,0 +1,11 @@
+/** Returns a random item from the passed array */
+export declare function randomItem<T = unknown>(array: T[]): T | undefined;
+/**
+ * Returns a tuple of a random item and its index from the passed array
+ * Returns `[undefined, undefined]` if the passed array is empty
+ */
+export declare function randomItemIndex<T = unknown>(array: T[]): [item?: T, index?: number];
+/** Returns a random item from the passed array and mutates the array to remove the item */
+export declare function takeRandomItem<T = unknown>(arr: T[]): T | undefined;
+/** Returns a copy of the array with its items in a random order */
+export declare function randomizeArray<T = unknown>(array: T[]): T[];

package/dist/lib/config.d.ts

@@ -0,0 +1,83 @@
+/** Function that takes the data in the old format and returns the data in the new format. Also supports an asynchronous migration. */
+type MigrationFunc = <TOldData = any>(oldData: TOldData) => any | Promise<any>;
+/** Dictionary of format version numbers and the function that migrates to them from the previous whole integer */
+type MigrationsDict = Record<number, MigrationFunc>;
+/** Options for the ConfigManager instance */
+export interface ConfigManagerOptions<TData> {
+    /** A unique internal ID for this configuration - choose wisely as changing it is not supported yet. */
+    id: string;
+    /**
+     * The default config data object to use if no data is saved in persistent storage yet.
+     * Until the data is loaded from persistent storage with `loadData()`, this will be the data returned by `getData()`
+     *
+     * ⚠️ This has to be an object that can be serialized to JSON, so no functions or circular references are allowed, they will cause unexpected behavior.
+     */
+    defaultConfig: TData;
+    /**
+     * An incremental, whole integer version number of the current format of config data.
+     * If the format of the data is changed, this number should be incremented, in which case all necessary functions of the migrations dictionary will be run consecutively.
+     *
+     * ⚠️ Never decrement this number and optimally don't skip any numbers either!
+     */
+    formatVersion: number;
+    /**
+     * A dictionary of functions that can be used to migrate data from older versions of the configuration to newer ones.
+     * The keys of the dictionary should be the format version that the functions can migrate to, from the previous whole integer value.
+     * The values should be functions that take the data in the old format and return the data in the new format.
+     * The functions will be run in order from the oldest to the newest version.
+     * If the current format version is not in the dictionary, no migrations will be run.
+     */
+    migrations?: MigrationsDict;
+}
+/**
+ * Manages a user configuration that is cached in memory and persistently saved across sessions.
+ * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.
+ *
+ * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`
+ * ⚠️ Make sure to call `loadData()` at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+ *
+ * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
+ */
+export declare class ConfigManager<TData = any> {
+    readonly id: string;
+    readonly formatVersion: number;
+    readonly defaultConfig: TData;
+    private cachedConfig;
+    private migrations?;
+    /**
+     * Creates an instance of ConfigManager to manage a user configuration that is cached in memory and persistently saved across sessions.
+     * Supports migrating data from older versions of the configuration to newer ones and populating the cache with default data if no persistent data is found.
+     *
+     * ⚠️ Requires the directives `@grant GM.getValue` and `@grant GM.setValue`
+     * ⚠️ Make sure to call `loadData()` at least once after creating an instance, or the returned data will be the same as `options.defaultConfig`
+     *
+     * @template TData The type of the data that is saved in persistent storage (will be automatically inferred from `config.defaultConfig`) - this should also be the type of the data format associated with the current `options.formatVersion`
+     * @param options The options for this ConfigManager instance
+    */
+    constructor(options: ConfigManagerOptions<TData>);
+    /**
+     * Loads the data saved in persistent storage into the in-memory cache and also returns it.
+     * Automatically populates persistent storage with default data if it doesn't contain any data yet.
+     * Also runs all necessary migration functions if the data format has changed since the last time the data was saved.
+     */
+    loadData(): Promise<TData>;
+    /** Returns a copy of the data from the in-memory cache. Use `loadData()` to get fresh data from persistent storage (usually not necessary since the cache should always exactly reflect persistent storage). */
+    getData(): TData;
+    /** Saves the data synchronously to the in-memory cache and asynchronously to the persistent storage */
+    setData(data: TData): Promise<void>;
+    /** Saves the default configuration data passed in the constructor synchronously to the in-memory cache and asynchronously to persistent storage */
+    saveDefaultData(): Promise<void>;
+    /**
+     * Call this method to clear all persistently stored data associated with this ConfigManager instance.
+     * The in-memory cache will be left untouched, so you may still access the data with `getData()`.
+     * Calling `loadData()` or `setData()` after this method was called will recreate persistent storage with the cached or default data.
+     *
+     * ⚠️ This requires the additional directive `@grant GM.deleteValue`
+     */
+    deleteConfig(): Promise<void>;
+    /** Runs all necessary migration functions consecutively - may be overwritten in a subclass */
+    protected runMigrations(oldData: any, oldFmtVer: number): Promise<TData>;
+    /** Copies a JSON-compatible object and loses its internal references */
+    private deepCopy;
+}
+export {};

package/dist/lib/dom.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Returns `unsafeWindow` if the `@grant unsafeWindow` is given, otherwise falls back to the regular `window`
+ */
+export declare function getUnsafeWindow(): Window;
+/**
+ * Inserts `afterElement` as a sibling just after the provided `beforeElement`
+ * @returns Returns the `afterElement`
+ */
+export declare function insertAfter(beforeElement: HTMLElement, afterElement: HTMLElement): HTMLElement;
+/**
+ * Adds a parent container around the provided element
+ * @returns Returns the new parent element
+ */
+export declare function addParent(element: HTMLElement, newParent: HTMLElement): HTMLElement;
+/**
+ * Adds global CSS style in the form of a `<style>` element in the document's `<head>`
+ * This needs to be run after the `DOMContentLoaded` event has fired on the document object (or instantly if `@run-at document-end` is used).
+ * @param style CSS string
+ */
+export declare function addGlobalStyle(style: string): void;
+/**
+ * Preloads an array of image URLs so they can be loaded instantly from the browser cache later on
+ * @param rejects If set to `true`, the returned PromiseSettledResults will contain rejections for any of the images that failed to load
+ * @returns Returns an array of `PromiseSettledResult` - each resolved result will contain the loaded image element, while each rejected result will contain an `ErrorEvent`
+ */
+export declare function preloadImages(srcUrls: string[], rejects?: boolean): Promise<PromiseSettledResult<unknown>[]>;
+/**
+ * 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 response to a user interaction event, else the browser might reject it.
+ */
+export declare function openInNewTab(href: string): void;
+/**
+ * Intercepts the specified event on the passed object and prevents it from being called if the called `predicate` function returns a truthy value.
+ * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
+ * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
+ */
+export declare function interceptEvent<TEvtObj extends EventTarget, TPredicateEvt extends Event>(eventObject: TEvtObj, eventName: Parameters<TEvtObj["addEventListener"]>[0], predicate: (event: TPredicateEvt) => boolean): void;
+/**
+ * Intercepts the specified event on the window object and prevents it from being called if the called `predicate` function returns a truthy value.
+ * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
+ * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
+ */
+export declare function interceptWindowEvent<TEvtKey extends keyof WindowEventMap>(eventName: TEvtKey, predicate: (event: WindowEventMap[TEvtKey]) => 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 |
+ */
+export declare function amplifyMedia<TElem extends HTMLMediaElement>(mediaElement: TElem, multiplier?: number): {
+    mediaElement: TElem;
+    amplify: (multiplier: number) => void;
+    getAmpLevel: () => number;
+    context: AudioContext;
+    source: MediaElementAudioSourceNode;
+    gain: GainNode;
+};

package/dist/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./array";
+export * from "./config";
+export * from "./dom";
+export * from "./math";
+export * from "./misc";
+export * from "./onSelector";

package/dist/lib/math.d.ts

@@ -0,0 +1,11 @@
+/** Ensures the passed `value` always stays between `min` and `max` */
+export 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.
+ */
+export 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) */
+export declare function randRange(min: number, max: number): number;
+/** Returns a random number between 0 and `max` (inclusive) */
+export declare function randRange(max: number): number;

package/dist/lib/misc.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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
+ */
+export declare function autoPlural(word: string, num: number | unknown[] | NodeList): string;
+/** Pauses async execution for the specified time in ms */
+export declare function pauseFor(time: number): Promise<void>;
+/**
+ * Calls the passed `func` after the specified `timeout` in ms (defaults to 300).
+ * Any subsequent calls to this function will reset the timer and discard previous calls.
+ */
+export declare function debounce<TFunc extends (...args: TArgs[]) => void, TArgs = any>(func: TFunc, timeout?: number): (...args: TArgs[]) => void;
+/** Options for the `fetchAdvanced()` function */
+export type FetchAdvancedOpts = RequestInit & Partial<{
+    /** Timeout in milliseconds after which the fetch call will be canceled with an AbortController signal */
+    timeout: number;
+}>;
+/** Calls the fetch API with special options like a timeout */
+export declare function fetchAdvanced(url: string, options?: FetchAdvancedOpts): Promise<Response>;

package/dist/lib/onSelector.d.ts

@@ -0,0 +1,40 @@
+/** Options for the `onSelector()` function */
+export 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;
+};
+/**
+ * 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.
+ * Multiple listeners with the same selector may be registered.
+ * @param selector The selector to listen for
+ * @param options Used for switching to `querySelectorAll()` and for calling the listener continuously
+ * @template TElem The type of element that the listener will return as its argument (defaults to the generic HTMLElement)
+ */
+export declare function onSelector<TElem extends Element = HTMLElement>(selector: string, options: OnSelectorOpts<TElem>): void;
+/**
+ * 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
+ */
+export 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 options For fine-tuning what triggers the MutationObserver's checking function - `subtree` and `childList` are set to true by default
+ */
+export declare function initOnSelector(options?: MutationObserverInit): void;
+/** Returns all currently registered selectors, as a map of selector strings to their associated options */
+export declare function getSelectorMap(): Map<string, OnSelectorOpts<HTMLElement>[]>;
+export {};

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@sv443-network/userutils",
-  "version": "0.5.2",
+  "version": "1.0.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",
-  "types": "dist/index.d.ts",
+  "types": "dist/lib/index.d.ts",
   "scripts": {
-    "lint": "tsc && eslint .",
-    "build-common": "tsup lib/index.ts --format cjs,esm --dts --clean --treeshake",
-    "build-iife": "tsup lib/index.ts --format cjs,esm,iife --dts --clean --treeshake --minify",
-    "build": "npm run build-common -- --minify",
-    "dev": "npm run build-common -- --sourcemap --watch",
-    "publish-package": "npm run build && changeset publish"
+    "lint": "tsc --noEmit && eslint .",
+    "build-types": "tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build-common": "tsup lib/index.ts --format cjs,esm --clean --treeshake",
+    "build-global": "tsup lib/index.ts --format cjs,esm,iife --treeshake --onSuccess \"npm run post-build-global\"",
+    "build": "npm run build-common -- --minify && npm run build-types",
+    "post-build-global": "npm run node-ts -- ./tools/post-build-global.mts",
+    "dev": "npm run build-common -- --sourcemap --watch --onSuccess \"npm run build-types\"",
+    "publish-package": "npm run build && changeset publish",
+    "node-ts": "node --no-warnings=ExperimentalWarning --enable-source-maps --loader ts-node/esm"
   },
   "repository": {
     "type": "git",
@@ -29,13 +32,15 @@
   "bugs": {
     "url": "https://github.com/Sv443-Network/UserUtils/issues"
   },
-  "homepage": "https://github.com/Sv443-Network/UserUtils#readme",
+  "homepage": "https://github.com/Sv443-Network/UserUtils",
   "devDependencies": {
     "@changesets/cli": "^2.26.2",
     "@types/greasemonkey": "^4.0.4",
+    "@types/node": "^20.5.9",
     "@typescript-eslint/eslint-plugin": "^6.2.1",
     "@typescript-eslint/parser": "^6.2.1",
     "eslint": "^8.46.0",
+    "ts-node": "^10.9.1",
     "tslib": "^2.6.1",
     "tsup": "^7.2.0",
     "typescript": "^5.1.6"
@@ -43,8 +48,7 @@
   "files": [
     "/dist/index.js",
     "/dist/index.mjs",
-    "/dist/index.d.ts",
-    "/dist/index.d.mts",
+    "/dist/lib/**.*",
     "/package.json",
     "/README.md",
     "/CHANGELOG.md",

package/dist/index.d.mts

@@ -1,155 +0,0 @@
-/** Returns a random item from the passed array */
-declare function randomItem<T = unknown>(array: T[]): T | undefined;
-/**
- * Returns a tuple of a random item and its index from the passed array
- * Returns `[undefined, undefined]` if the passed array is empty
- */
-declare function randomItemIndex<T = unknown>(array: T[]): [item?: T, index?: number];
-/** Returns a random item from the passed array and mutates the array to remove the item */
-declare function takeRandomItem<T = unknown>(arr: T[]): T | undefined;
-/** Returns a copy of the array with its items in a random order */
-declare function randomizeArray<T = unknown>(array: T[]): T[];
-
-/**
- * Returns `unsafeWindow` if the `@grant unsafeWindow` is given, otherwise falls back to the regular `window`
- */
-declare function getUnsafeWindow(): Window;
-/**
- * Inserts `afterElement` as a sibling just after the provided `beforeElement`
- * @returns Returns the `afterElement`
- */
-declare function insertAfter(beforeElement: HTMLElement, afterElement: HTMLElement): HTMLElement;
-/**
- * Adds a parent container around the provided element
- * @returns Returns the new parent element
- */
-declare function addParent(element: HTMLElement, newParent: HTMLElement): HTMLElement;
-/**
- * Adds global CSS style in the form of a `<style>` element in the document's `<head>`
- * This needs to be run after the `DOMContentLoaded` event has fired on the document object (or instantly if `@run-at document-end` is used).
- * @param style CSS string
- */
-declare function addGlobalStyle(style: string): void;
-/**
- * Preloads an array of image URLs so they can be loaded instantly from the browser cache later on
- * @param rejects If set to `true`, the returned PromiseSettledResults will contain rejections for any of the images that failed to load
- * @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>[]>;
-/**
- * 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 response to a user interaction event, else the browser might reject it.
- */
-declare function openInNewTab(href: string): void;
-/**
- * Intercepts the specified event on the passed object and prevents it from being called if the called `predicate` function returns a truthy value.
- * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
- * Calling this function will set the `Error.stackTraceLimit` to 1000 to ensure the stack trace is preserved.
- */
-declare function interceptEvent<TEvtObj extends EventTarget>(eventObject: TEvtObj, eventName: Parameters<TEvtObj["addEventListener"]>[0], predicate: () => boolean): void;
-/**
- * Intercepts the specified event on the window object and prevents it from being called if the called `predicate` function returns a truthy value.
- * This function should be called as soon as possible (I recommend using `@run-at document-start`), as it will only intercept events that are added after this function is called.
- * 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;
-/**
- * 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 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.
- * Multiple listeners with the same selector may be registered.
- * @param selector The selector to listen for
- * @param options Used for switching to `querySelectorAll()` and for calling the listener continuously
- * @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
- * @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 options For fine-tuning what triggers the MutationObserver's checking function - `subtree` and `childList` are set to true by default
- */
-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, 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 };