billy-herrington-utils 1.0.0

package/README.md

@@ -0,0 +1,34 @@
+### _daddy told us not to be ashamed of our utils_
+![](https://i.imgur.com/wwfRj0R.jpeg)
+
+* stringToWords
+* sanitizeStr
+* timeToSeconds
+* parseCSSUrl
+* parseDataParams
+* parseIntegerOr
+* Observer
+* LazyImgLoader
+* circularShift
+* MOBILE_UA
+* fetchHtml
+* fetchText
+* fetchWith
+* objectToFormData
+* Tick
+* listenEvents
+* parseDom
+* copyAttributes
+* downloader
+* findNextSibling
+* getAllUniqueParents
+* replaceElementTag
+* waitForElementExists
+* watchDomChangesWithThrottle
+* watchElementChildrenCount
+* isMob
+* computeAsyncOneAtTime
+* SyncPull
+* wait
+* chunks
+* range

package/biome.json

@@ -0,0 +1,35 @@
+{
+	"$schema": "https://biomejs.dev/schemas/1.8.3/schema.json",
+	"organizeImports": {
+		"enabled": true
+	},
+	"formatter": {
+		"enabled": true,
+		"indentWidth": 2,
+		"indentStyle": "space",
+		"lineWidth": 100,
+		"lineEnding": "lf"
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "single",
+			"semicolons": "always"
+		}
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"style": {
+				"useNumberNamespace": "off"
+			},
+			"complexity": {
+				"noStaticOnlyClass": "off",
+				"noForEach": "off"
+			},
+			"suspicious": {
+				"noRedundantUseStrict": "off"
+			}
+		}
+	}
+}

package/dist/billy-herrington-utils.es.js

@@ -0,0 +1,242 @@
+var b = Object.defineProperty;
+var d = (e, t, r) => t in e ? b(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var o = (e, t, r) => d(e, typeof t != "symbol" ? t + "" : t, r);
+function I(e) {
+  return e.split(",").map((t) => t.trim().toLowerCase()).filter((t) => t);
+}
+function A(e) {
+  return (e == null ? void 0 : e.replace(/\n|\t/, " ").replace(/ {2,}/, " ").trim().toLowerCase()) || "";
+}
+function E(e) {
+  return ((e == null ? void 0 : e.match(/\d+/gm)) || [0]).reverse().map((t, r) => parseInt(t) * 60 ** r).reduce((t, r) => t + r);
+}
+function T(e, t) {
+  return Number.isInteger(parseInt(e)) ? parseInt(e) : t;
+}
+function L(e) {
+  const t = e.split(";").flatMap((r) => {
+    const n = r.match(/([\+\w+]+):(\w+)?/), i = n == null ? void 0 : n[2];
+    if (i) return n[1].split("+").map((s) => ({ [s]: i }));
+  }).filter((r) => r);
+  return Object.assign({}, ...t);
+}
+function O(e) {
+  return e.replace(/url\("|\"\).*/g, "");
+}
+class l {
+  constructor(t) {
+    o(this, "observer");
+    this.callback = t, this.observer = new IntersectionObserver(this.handleIntersection.bind(this));
+  }
+  observe(t) {
+    this.observer.observe(t);
+  }
+  throttle(t, r) {
+    this.observer.unobserve(t), setTimeout(() => this.observer.observe(t), r);
+  }
+  handleIntersection(t) {
+    for (const r of t)
+      r.isIntersecting && this.callback(r.target);
+  }
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  static observeWhile(t, r, n) {
+    const i = new l(async (s) => {
+      await r() && i.throttle(s, n);
+    });
+    return i.observe(t), i;
+  }
+}
+class u {
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  constructor(t, r = "data-lazy-load", n = !0) {
+    o(this, "lazyImgObserver");
+    o(this, "delazify", (t) => {
+      this.lazyImgObserver.observer.unobserve(t), t.src = t.getAttribute(this.attributeName), this.removeTagAfter && t.removeAttribute(this.attributeName);
+    });
+    this.attributeName = r, this.removeTagAfter = n, this.lazyImgObserver = new l((i) => {
+      t(i, this.delazify);
+    });
+  }
+  lazify(t, r, n) {
+    !r || !n || (r.setAttribute(this.attributeName, n), r.src = "", this.lazyImgObserver.observe(r));
+  }
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  static create(t) {
+    return new u((n, i) => {
+      t(n) && i(n);
+    });
+  }
+}
+function M(e, t = 6, r = 1) {
+  return (e + r) % t || t;
+}
+function h(e) {
+  const t = new DOMParser().parseFromString(e, "text/html").body;
+  return t.children.length > 1 ? t : t.firstElementChild;
+}
+function m(e, t) {
+  for (const r of t.attributes)
+    r.nodeValue && e.setAttribute(r.nodeName, r.nodeValue);
+}
+function S(e, t) {
+  var n;
+  const r = document.createElement(t);
+  return m(r, e), r.innerHTML = e.innerHTML, (n = e.parentNode) == null || n.replaceChild(r, e), r;
+}
+function z(e) {
+  return Array.from(e).reduce((t, r) => (r.parentElement && t.includes(r.parentElement) && t.push(r.parentElement), t), []);
+}
+function p(e) {
+  return e.nextElementSibling ? e.nextElementSibling : e.parentElement ? p(e.parentElement) : null;
+}
+function v(e, t, r) {
+  const n = new MutationObserver((i) => {
+    const s = e.querySelector(t);
+    s && (n.disconnect(), r(s));
+  });
+  n.observe(document.body, { childList: !0, subtree: !0 });
+}
+function F(e, t) {
+  let r = e.children.length;
+  new MutationObserver((i, s) => {
+    for (const a of i)
+      a.type === "childList" && r !== e.children.length && (r = e.children.length, t(s, r));
+  }).observe(e, { childList: !0 });
+}
+function P(e, t, r = 1e3, n = { childList: !0, subtree: !0, attributes: !0 }) {
+  let i, s;
+  new MutationObserver((y, w) => {
+    const c = Date.now();
+    i && c - i < r && s && clearTimeout(s), s = setTimeout(t, r), i = c;
+  }).observe(e, n);
+}
+function x(e = { append: "", after: "", button: "", cbBefore: () => {
+} }) {
+  var r, n;
+  const t = h(e.button);
+  e.append && ((r = document.querySelector(e.append)) == null || r.append(t)), e.after && ((n = document.querySelector(e.after)) == null || n.after(t)), t.addEventListener("click", (i) => {
+    i.preventDefault(), e.cbBefore && e.cbBefore(), v(document.body, "video", (s) => {
+      window.location.href = s.getAttribute("src");
+    });
+  });
+}
+const g = [
+  "Mozilla/5.0 (Linux; Android 10; K)",
+  "AppleWebKit/537.36 (KHTML, like Gecko)",
+  "Chrome/114.0.0.0 Mobile Safari/537.36"
+].join(" ");
+function f(e, t = { html: !1, mobile: !1 }) {
+  const r = {};
+  return t.mobile && Object.assign(r, { headers: new Headers({ "User-Agent": g }) }), fetch(e, r).then((n) => n.text()).then((n) => t.html ? h(n) : n);
+}
+const C = (e) => f(e, { html: !0 }), D = (e) => f(e);
+function H(e) {
+  const t = new FormData();
+  return Object.entries(e).forEach(([r, n]) => t.append(r, n)), t;
+}
+function N(e, t, r) {
+  for (const n of t)
+    e.addEventListener(n, r, !0);
+}
+class j {
+  constructor(t, r = !0) {
+    o(this, "tick");
+    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    o(this, "callbackFinal");
+    this.delay = t, this.startImmediate = r, this.tick = null, this.delay = t, this.startImmediate = r;
+  }
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  start(t, r = null) {
+    this.stop(), this.callbackFinal = r, this.startImmediate && t(), this.tick = setInterval(t, this.delay);
+  }
+  stop() {
+    this.tick !== null && (clearInterval(this.tick), this.tick = null), this.callbackFinal && (this.callbackFinal(), this.callbackFinal = null);
+  }
+}
+function q() {
+  return /iPhone|Android/i.test(navigator.userAgent);
+}
+async function W(e) {
+  const t = [];
+  for await (const r of e)
+    t.push(await r());
+  return t;
+}
+function B(e) {
+  return new Promise((t) => setTimeout(t, e));
+}
+class U {
+  constructor() {
+    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    o(this, "pull", []);
+    o(this, "lock", !1);
+  }
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  getHighPriorityFirst(t = 0) {
+    if (t > 3 || this.pull.length === 0) return;
+    const r = this.pull.findIndex((n) => n.p === t);
+    if (r >= 0) {
+      const n = this.pull[r].v;
+      return this.pull = this.pull.slice(0, r).concat(this.pull.slice(r + 1)), n;
+    }
+    return this.getHighPriorityFirst(t + 1);
+  }
+  *pullGenerator() {
+    for (; this.pull.length > 0; )
+      yield this.getHighPriorityFirst();
+  }
+  async processPull() {
+    if (!this.lock) {
+      this.lock = !0;
+      for await (const t of this.pullGenerator())
+        await t();
+      this.lock = !1;
+    }
+  }
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  push(t) {
+    this.pull.push(t), this.processPull();
+  }
+}
+function _(e, t) {
+  const r = [];
+  for (let n = 0; n < e.length; n += t)
+    r.push(e.slice(n, n + t));
+  return r;
+}
+function G(e, t = 1) {
+  return [...Array(e).keys()].map((r) => r + t);
+}
+export {
+  u as LazyImgLoader,
+  g as MOBILE_UA,
+  l as Observer,
+  U as SyncPull,
+  j as Tick,
+  _ as chunks,
+  M as circularShift,
+  W as computeAsyncOneAtTime,
+  m as copyAttributes,
+  x as downloader,
+  C as fetchHtml,
+  D as fetchText,
+  f as fetchWith,
+  p as findNextSibling,
+  z as getAllUniqueParents,
+  q as isMob,
+  N as listenEvents,
+  H as objectToFormData,
+  O as parseCSSUrl,
+  L as parseDataParams,
+  h as parseDom,
+  T as parseIntegerOr,
+  G as range,
+  S as replaceElementTag,
+  A as sanitizeStr,
+  I as stringToWords,
+  E as timeToSeconds,
+  B as wait,
+  v as waitForElementExists,
+  P as watchDomChangesWithThrottle,
+  F as watchElementChildrenCount
+};

package/dist/billy-herrington-utils.umd.js

@@ -0,0 +1 @@
+(function(i,l){typeof exports=="object"&&typeof module<"u"?l(exports):typeof define=="function"&&define.amd?define(["exports"],l):(i=typeof globalThis<"u"?globalThis:i||self,l(i.bhutils={}))})(this,function(i){"use strict";var B=Object.defineProperty;var _=(i,l,c)=>l in i?B(i,l,{enumerable:!0,configurable:!0,writable:!0,value:c}):i[l]=c;var o=(i,l,c)=>_(i,typeof l!="symbol"?l+"":l,c);function l(n){return n.split(",").map(e=>e.trim().toLowerCase()).filter(e=>e)}function c(n){return(n==null?void 0:n.replace(/\n|\t/," ").replace(/ {2,}/," ").trim().toLowerCase())||""}function w(n){return((n==null?void 0:n.match(/\d+/gm))||[0]).reverse().map((e,t)=>parseInt(e)*60**t).reduce((e,t)=>e+t)}function T(n,e){return Number.isInteger(parseInt(n))?parseInt(n):e}function E(n){const e=n.split(";").flatMap(t=>{const r=t.match(/([\+\w+]+):(\w+)?/),s=r==null?void 0:r[2];if(s)return r[1].split("+").map(a=>({[a]:s}))}).filter(t=>t);return Object.assign({},...e)}function k(n){return n.replace(/url\("|\"\).*/g,"")}class u{constructor(e){o(this,"observer");this.callback=e,this.observer=new IntersectionObserver(this.handleIntersection.bind(this))}observe(e){this.observer.observe(e)}throttle(e,t){this.observer.unobserve(e),setTimeout(()=>this.observer.observe(e),t)}handleIntersection(e){for(const t of e)t.isIntersecting&&this.callback(t.target)}static observeWhile(e,t,r){const s=new u(async a=>{await t()&&s.throttle(a,r)});return s.observe(e),s}}class h{constructor(e,t="data-lazy-load",r=!0){o(this,"lazyImgObserver");o(this,"delazify",e=>{this.lazyImgObserver.observer.unobserve(e),e.src=e.getAttribute(this.attributeName),this.removeTagAfter&&e.removeAttribute(this.attributeName)});this.attributeName=t,this.removeTagAfter=r,this.lazyImgObserver=new u(s=>{e(s,this.delazify)})}lazify(e,t,r){!t||!r||(t.setAttribute(this.attributeName,r),t.src="",this.lazyImgObserver.observe(t))}static create(e){return new h((r,s)=>{e(r)&&s(r)})}}function A(n,e=6,t=1){return(n+t)%e||e}function f(n){const e=new DOMParser().parseFromString(n,"text/html").body;return e.children.length>1?e:e.firstElementChild}function m(n,e){for(const t of e.attributes)t.nodeValue&&n.setAttribute(t.nodeName,t.nodeValue)}function I(n,e){var r;const t=document.createElement(e);return m(t,n),t.innerHTML=n.innerHTML,(r=n.parentNode)==null||r.replaceChild(t,n),t}function S(n){return Array.from(n).reduce((e,t)=>(t.parentElement&&e.includes(t.parentElement)&&e.push(t.parentElement),e),[])}function v(n){return n.nextElementSibling?n.nextElementSibling:n.parentElement?v(n.parentElement):null}function g(n,e,t){const r=new MutationObserver(s=>{const a=n.querySelector(e);a&&(r.disconnect(),t(a))});r.observe(document.body,{childList:!0,subtree:!0})}function O(n,e){let t=n.children.length;new MutationObserver((s,a)=>{for(const b of s)b.type==="childList"&&t!==n.children.length&&(t=n.children.length,e(a,t))}).observe(n,{childList:!0})}function L(n,e,t=1e3,r={childList:!0,subtree:!0,attributes:!0}){let s,a;new MutationObserver((G,K)=>{const y=Date.now();s&&y-s<t&&a&&clearTimeout(a),a=setTimeout(e,t),s=y}).observe(n,r)}function M(n={append:"",after:"",button:"",cbBefore:()=>{}}){var t,r;const e=f(n.button);n.append&&((t=document.querySelector(n.append))==null||t.append(e)),n.after&&((r=document.querySelector(n.after))==null||r.after(e)),e.addEventListener("click",s=>{s.preventDefault(),n.cbBefore&&n.cbBefore(),g(document.body,"video",a=>{window.location.href=a.getAttribute("src")})})}const p=["Mozilla/5.0 (Linux; Android 10; K)","AppleWebKit/537.36 (KHTML, like Gecko)","Chrome/114.0.0.0 Mobile Safari/537.36"].join(" ");function d(n,e={html:!1,mobile:!1}){const t={};return e.mobile&&Object.assign(t,{headers:new Headers({"User-Agent":p})}),fetch(n,t).then(r=>r.text()).then(r=>e.html?f(r):r)}const P=n=>d(n,{html:!0}),z=n=>d(n);function F(n){const e=new FormData;return Object.entries(n).forEach(([t,r])=>e.append(t,r)),e}function C(n,e,t){for(const r of e)n.addEventListener(r,t,!0)}class D{constructor(e,t=!0){o(this,"tick");o(this,"callbackFinal");this.delay=e,this.startImmediate=t,this.tick=null,this.delay=e,this.startImmediate=t}start(e,t=null){this.stop(),this.callbackFinal=t,this.startImmediate&&e(),this.tick=setInterval(e,this.delay)}stop(){this.tick!==null&&(clearInterval(this.tick),this.tick=null),this.callbackFinal&&(this.callbackFinal(),this.callbackFinal=null)}}function H(){return/iPhone|Android/i.test(navigator.userAgent)}async function N(n){const e=[];for await(const t of n)e.push(await t());return e}function j(n){return new Promise(e=>setTimeout(e,n))}class W{constructor(){o(this,"pull",[]);o(this,"lock",!1)}getHighPriorityFirst(e=0){if(e>3||this.pull.length===0)return;const t=this.pull.findIndex(r=>r.p===e);if(t>=0){const r=this.pull[t].v;return this.pull=this.pull.slice(0,t).concat(this.pull.slice(t+1)),r}return this.getHighPriorityFirst(e+1)}*pullGenerator(){for(;this.pull.length>0;)yield this.getHighPriorityFirst()}async processPull(){if(!this.lock){this.lock=!0;for await(const e of this.pullGenerator())await e();this.lock=!1}}push(e){this.pull.push(e),this.processPull()}}function U(n,e){const t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function q(n,e=1){return[...Array(n).keys()].map(t=>t+e)}i.LazyImgLoader=h,i.MOBILE_UA=p,i.Observer=u,i.SyncPull=W,i.Tick=D,i.chunks=U,i.circularShift=A,i.computeAsyncOneAtTime=N,i.copyAttributes=m,i.downloader=M,i.fetchHtml=P,i.fetchText=z,i.fetchWith=d,i.findNextSibling=v,i.getAllUniqueParents=S,i.isMob=H,i.listenEvents=C,i.objectToFormData=F,i.parseCSSUrl=k,i.parseDataParams=E,i.parseDom=f,i.parseIntegerOr=T,i.range=q,i.replaceElementTag=I,i.sanitizeStr=c,i.stringToWords=l,i.timeToSeconds=w,i.wait=j,i.waitForElementExists=g,i.watchDomChangesWithThrottle=L,i.watchElementChildrenCount=O,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})});

package/index.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Document</title>
+  <style>
+    body {
+      background: radial-gradient(red, green, blue);
+      height: 100vh;
+      overflow: hidden;
+      margin: 0;
+    }
+  </style>
+  <script src="./dist/billy-herrington-utils.umd.js"></script>
+</head>
+
+<body>
+  <script>
+  </script>
+</body>
+
+</html>

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "billy-herrington-utils",
+  "description": "daddy told us not to be ashamed of our utils",
+  "version": "1.0.0",
+  "license": "MIT",
+  "keywords": ["utils", "observer", "dom", "fetch", "arrays"],
+  "author": "smartacephale atm.mormon@protonmail.com (https://github.com/smartacephale)",
+  "type": "module",
+  "homepage": "https://github.com/smartacephale/billy-herrington-utils#readme",
+  "main": "./dist/billy-herrington-utils.umd.js",
+  "module": "./dist/billy-herrington-utils.es.js",
+  "repository": "github:smartacephale/billy-herrington-utils",
+  "bugs": {
+    "url": "https://github.com/smartacephale/billy-herrington-utils/issues",
+    "email": "atm.mormon@protonmail.com"
+  },
+  "browser": "./dist/billy-herrington-utils.es.js",
+  "unpkg": "./dist/billy-herrington-utils.es.js",
+  "exports": {
+    ".": {
+      "import": "./dist/billy-herrington-utils.es.js",
+      "require": "./dist/billy-herrington-utils.umd.cjs"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.3",
+    "vite": "^5.4.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+export { stringToWords, sanitizeStr } from "./utils/strings";
+export { timeToSeconds, parseCSSUrl, parseDataParams, parseIntegerOr } from "./utils/parsers";
+export { Observer, LazyImgLoader } from "./utils/observers";
+export { circularShift } from "./utils/math";
+export { MOBILE_UA, fetchHtml, fetchText, fetchWith, objectToFormData } from "./utils/fetch";
+export { Tick, listenEvents } from "./utils/events";
+export {
+  parseDom,
+  copyAttributes,
+  downloader,
+  findNextSibling,
+  getAllUniqueParents,
+  replaceElementTag,
+  waitForElementExists,
+  watchDomChangesWithThrottle,
+  watchElementChildrenCount
+} from "./utils/dom";
+export { isMob } from "./utils/device";
+export { computeAsyncOneAtTime, SyncPull, wait } from "./utils/async";
+export { chunks, range } from "./utils/arrays";

package/src/utils/arrays/index.ts

@@ -0,0 +1,11 @@
+export function chunks<T>(arr: Array<T>, n: number): Array<Array<T>> {
+  const res = [];
+  for (let i = 0; i < arr.length; i += n) {
+    res.push(arr.slice(i, i + n));
+  }
+  return res;
+}
+
+export function range(size: number, startAt = 1): Array<number> {
+  return [...Array(size).keys()].map(i => i + startAt);
+}

package/src/utils/async/index.ts

@@ -0,0 +1,54 @@
+// https://2ality.com/2016/10/asynchronous-iteration.html
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+export async function computeAsyncOneAtTime(iterable: Iterable<any>) {
+  const res = [];
+  for await (const f of iterable) {
+    res.push(await f());
+  }
+  return res;
+}
+
+export function wait(milliseconds: number) {
+  return new Promise(resolve => setTimeout(resolve, milliseconds));
+}
+
+// do async one at time
+export class SyncPull {
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  pull: Array<any> = [];
+  lock = false;
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  getHighPriorityFirst(p = 0): any {
+    if (p > 3 || this.pull.length === 0) return undefined;
+    const i = this.pull.findIndex(e => e.p === p);
+    if (i >= 0) {
+      const res = this.pull[i].v;
+      this.pull = this.pull.slice(0, i).concat(this.pull.slice(i + 1));
+      return res;
+    }
+    return this.getHighPriorityFirst(p + 1);
+  }
+
+  *pullGenerator() {
+    while (this.pull.length > 0) {
+      yield this.getHighPriorityFirst();
+    }
+  }
+
+  async processPull() {
+    if (!this.lock) {
+      this.lock = true;
+      for await (const f of this.pullGenerator()) {
+        await f();
+      }
+      this.lock = false;
+    }
+  }
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  push(x: any) {
+    this.pull.push(x);
+    this.processPull();
+  }
+}

package/src/utils/device/index.ts

@@ -0,0 +1,3 @@
+export function isMob() {
+  return /iPhone|Android/i.test(navigator.userAgent);
+}

package/src/utils/dom/index.ts

@@ -0,0 +1,92 @@
+export function parseDom(html: string): HTMLElement {
+  const parsed = new DOMParser().parseFromString(html, 'text/html').body;
+  return parsed.children.length > 1 ? parsed : parsed.firstElementChild as HTMLElement;
+}
+
+export function copyAttributes(target: HTMLElement | Element, source: HTMLElement | Element) {
+  for (const attr of source.attributes) {
+    attr.nodeValue && target.setAttribute(attr.nodeName, attr.nodeValue);
+  }
+}
+
+export function replaceElementTag(e: HTMLElement | Element, tagName: string) {
+  const newTagElement = document.createElement(tagName);
+  copyAttributes(newTagElement, e);
+  newTagElement.innerHTML = e.innerHTML;
+  e.parentNode?.replaceChild(newTagElement, e);
+  return newTagElement;
+}
+
+export function getAllUniqueParents(elements: HTMLCollection): Array<HTMLElement | Element> {
+  return Array.from(elements).reduce((acc, v) => {
+    if (v.parentElement && acc.includes(v.parentElement as HTMLElement)) { acc.push(v.parentElement); }
+    return acc;
+  }, [] as Array<HTMLElement | Element>);
+}
+
+export function findNextSibling(el: HTMLElement | Element) {
+  if (el.nextElementSibling) return el.nextElementSibling;
+  if (el.parentElement) return findNextSibling(el.parentElement);
+  return null;
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+export function waitForElementExists(parent: HTMLElement | Element, selector: string, callback: any): void {
+  const observer = new MutationObserver((_mutations) => {
+    const el = parent.querySelector(selector);
+    if (el) {
+      observer.disconnect();
+      callback(el);
+    }
+  });
+  observer.observe(document.body, { childList: true, subtree: true });
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+export function watchElementChildrenCount(element: HTMLElement | Element, callback: any): void {
+  let count = element.children.length;
+  const observer = new MutationObserver((mutationList, observer) => {
+    for (const mutation of mutationList) {
+      if (mutation.type === "childList") {
+        if (count !== element.children.length) {
+          count = element.children.length;
+          callback(observer, count);
+        }
+      }
+    }
+  });
+  observer.observe(element, { childList: true });
+}
+
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+export function watchDomChangesWithThrottle(element: HTMLElement | Element, callback: any,
+  throttle = 1000, options: Record<string, boolean> = { childList: true, subtree: true, attributes: true }) {
+  let lastMutationTime: number;
+  let timeout: number;
+  const observer = new MutationObserver((_mutationList, _observer) => {
+    const now = Date.now();
+    if (lastMutationTime && now - lastMutationTime < throttle) {
+      timeout && clearTimeout(timeout);
+    }
+    timeout = setTimeout(callback, throttle);
+    lastMutationTime = now;
+  });
+  observer.observe(element, options);
+}
+
+export function downloader(options = { append: "", after: "", button: "", cbBefore: () => { } }) {
+  const btn = parseDom(options.button);
+
+  if (options.append) document.querySelector(options.append)?.append(btn);
+  if (options.after) document.querySelector(options.after)?.after(btn);
+
+  btn.addEventListener('click', (e) => {
+    e.preventDefault();
+
+    if (options.cbBefore) options.cbBefore();
+
+    waitForElementExists(document.body, 'video', (video: HTMLVideoElement) => {
+      window.location.href = video.getAttribute('src') as string;
+    });
+  });
+}

package/src/utils/events/index.ts

@@ -0,0 +1,37 @@
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+export function listenEvents(dom: HTMLElement | Element, events: Array<string>, callback: any): void {
+  for (const e of events) {
+    dom.addEventListener(e, callback, true);
+  }
+}
+
+export class Tick {
+  private tick: null | number;
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  private callbackFinal: any;
+
+  constructor(private delay: number, private startImmediate = true) {
+    this.tick = null;
+    this.delay = delay;
+    this.startImmediate = startImmediate;
+  }
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  start(callback: any, callbackFinal = null) {
+    this.stop();
+    this.callbackFinal = callbackFinal;
+    if (this.startImmediate) callback();
+    this.tick = setInterval(callback, this.delay);
+  }
+
+  stop() {
+    if (this.tick !== null) {
+      clearInterval(this.tick);
+      this.tick = null;
+    }
+    if (this.callbackFinal) {
+      this.callbackFinal();
+      this.callbackFinal = null;
+    }
+  }
+}

package/src/utils/fetch/index.ts

@@ -0,0 +1,22 @@
+import { parseDom } from "../dom";
+
+export const MOBILE_UA = [
+  'Mozilla/5.0 (Linux; Android 10; K)',
+  'AppleWebKit/537.36 (KHTML, like Gecko)',
+  'Chrome/114.0.0.0 Mobile Safari/537.36'].join(' ');
+
+export function fetchWith(url: string, options: Record<string, boolean> = { html: false, mobile: false }) {
+  const reqOpts = {};
+  if (options.mobile) Object.assign(reqOpts, { headers: new Headers({ "User-Agent": MOBILE_UA }) });
+  return fetch(url, reqOpts).then((r) => r.text()).then(r => options.html ? parseDom(r) : r);
+}
+
+export const fetchHtml = (url: string) => fetchWith(url, { html: true });
+
+export const fetchText = (url: string) => fetchWith(url);
+
+export function objectToFormData(object: Record<string, number | boolean | string>): FormData {
+  const formData = new FormData();
+  Object.entries(object).forEach(([k, v]) => formData.append(k, v as string));
+  return formData;
+}

package/src/utils/math/index.ts

@@ -0,0 +1,3 @@
+export function circularShift(n: number, c = 6, s = 1): number {
+  return (n + s) % c || c;
+}

package/src/utils/observers/index.ts

@@ -0,0 +1,67 @@
+export class Observer {
+  public observer: IntersectionObserver;
+  constructor(private callback: (entry: Element) => void) {
+    this.observer = new IntersectionObserver(this.handleIntersection.bind(this));
+  }
+
+  observe(target: Element) {
+    this.observer.observe(target);
+  }
+
+  throttle(target: Element, throttleTime: number) {
+    this.observer.unobserve(target);
+    setTimeout(() => this.observer.observe(target), throttleTime);
+  }
+
+  handleIntersection(entries: Iterable<IntersectionObserverEntry>) {
+    for (const entry of entries) {
+      if (entry.isIntersecting) {
+        this.callback(entry.target);
+      }
+    }
+  }
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  static observeWhile(target: Element, callback: any, throttleTime: number) {
+    const observer_ = new Observer(async (target: Element) => {
+      const condition = await callback();
+      if (condition) observer_.throttle(target, throttleTime);
+    });
+    observer_.observe(target);
+    return observer_;
+  }
+}
+
+export class LazyImgLoader {
+  public lazyImgObserver: Observer;
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  constructor(callback: any, private attributeName = 'data-lazy-load', private removeTagAfter = true) {
+    this.lazyImgObserver = new Observer((target: Element) => {
+      callback(target, this.delazify);
+    });
+  }
+
+  lazify(_target: Element, img: HTMLImageElement, imgSrc: string) {
+    if (!img || !imgSrc) return;
+    img.setAttribute(this.attributeName, imgSrc);
+    img.src = '';
+    this.lazyImgObserver.observe(img);
+  }
+
+  delazify = (target: HTMLImageElement) => {
+    this.lazyImgObserver.observer.unobserve(target);
+    target.src = target.getAttribute(this.attributeName) as string;
+    if (this.removeTagAfter) target.removeAttribute(this.attributeName);
+  }
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  static create(callback: any) {
+    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    const lazyImgLoader = new LazyImgLoader((target: Element, delazify: any) => {
+      if (callback(target)) {
+        delazify(target);
+      }
+    });
+    return lazyImgLoader;
+  }
+}

package/src/utils/parsers/index.ts

@@ -0,0 +1,24 @@
+export function timeToSeconds(t: string): number {
+  return (t?.match(/\d+/gm) || [0])
+    .reverse()
+    .map((s, i) => parseInt(s as string) * 60 ** i)
+    .reduce((a, b) => a + b);
+}
+
+export function parseIntegerOr(n: string | number, or: number): number {
+  return Number.isInteger(parseInt(n as string)) ? parseInt(n as string) : or;
+}
+
+// "data:02;body+head:async;void:;zero:;"
+export function parseDataParams(str: string) {
+  const params = str.split(';').flatMap(s => {
+    const parsed = s.match(/([\+\w+]+):(\w+)?/);
+    const value = parsed?.[2];
+    if (value) return parsed[1].split('+').map(p => ({ [p]: value }));
+  }).filter(_ => _);
+  return Object.assign({}, ...params);
+}
+
+export function parseCSSUrl(s: string) {
+  return s.replace(/url\("|\"\).*/g, '');
+}

package/src/utils/strings/index.ts

@@ -0,0 +1,7 @@
+export function stringToWords(s: string): Array<string> {
+  return s.split(",").map(s => s.trim().toLowerCase()).filter(_ => _);
+}
+
+export function sanitizeStr(s: string) {
+  return s?.replace(/\n|\t/, ' ').replace(/ {2,}/, ' ').trim().toLowerCase() || "";
+}

package/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src", "main.js"]
+}

package/vite.config.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { defineConfig, loadEnv } from "vite";
+
+export default ({ mode }) => {
+  return defineConfig({
+    define: {
+      "process.env": {},
+    },
+    run: {
+      entry: path.resolve(__dirname, "./src/index.html")
+    },
+    resolve: {
+      alias: {
+        vue: 'vue/dist/vue.esm-bundler.js',
+      }
+    },
+    build: {
+      watch: false,
+      lib: {
+        minify: true,
+        entry: path.resolve(__dirname, "./src/index.ts"),
+        name: "bhutils",
+        fileName: (format) => `billy-herrington-utils.${format}.js`,
+      }
+    },
+  });
+};