@mkmonkeycat/dom-utils 0.1.0

package/dist/mkdomutils.js

@@ -0,0 +1,283 @@
+const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/).filter(Boolean) : r || []), A = (t, r, ...n) => {
+  const o = document.createElement(t);
+  return r ? (Object.entries(r).forEach(([s, e]) => {
+    if (e != null) {
+      if (s === "className" || s === "class") {
+        const i = Array.isArray(e) ? h(...e) : h(e);
+        o.className = i.join(" ");
+        return;
+      }
+      if (s === "style") {
+        typeof e == "string" ? o.style.cssText = e : typeof e == "object" && Object.assign(o.style, e);
+        return;
+      }
+      if (s === "dataset" && typeof e == "object") {
+        Object.assign(o.dataset, e);
+        return;
+      }
+      if (s.startsWith("on")) {
+        const i = s.slice(2).toLowerCase();
+        typeof e == "function" ? o.addEventListener(i, e) : Array.isArray(e) && e.forEach((c) => {
+          typeof c == "function" && o.addEventListener(i, c);
+        });
+        return;
+      }
+      s in o ? o[s] = e : o.setAttribute(s, String(e));
+    }
+  }), E(o, n), o) : (E(o, n), o);
+}, S = (...t) => {
+  const r = document.createDocumentFragment();
+  return t.forEach((n) => {
+    typeof n == "string" ? r.appendChild(document.createTextNode(n)) : r.appendChild(n);
+  }), r;
+}, E = (t, r) => {
+  r.forEach((n) => {
+    typeof n == "string" ? t.appendChild(document.createTextNode(n)) : t.appendChild(n);
+  });
+}, P = (t) => ({
+  width: t.offsetWidth,
+  height: t.offsetHeight
+}), O = (t) => ({
+  top: t.offsetTop,
+  left: t.offsetLeft
+}), F = (t, r) => window.getComputedStyle(t).getPropertyValue(r).trim(), I = (t, r) => {
+  t && (t === document.documentElement || t === document.body ? window.scrollTo(r) : t.scrollTo?.(r));
+}, M = (t, r) => {
+  t.scrollIntoView?.(r);
+}, D = (t) => ({
+  width: t.clientWidth,
+  height: t.clientHeight
+}), x = (t, r = !1) => {
+  let n = t.offsetWidth, o = t.offsetHeight;
+  if (r) {
+    const s = window.getComputedStyle(t), e = parseFloat(s.marginLeft || "0"), i = parseFloat(s.marginRight || "0"), c = parseFloat(s.marginTop || "0"), u = parseFloat(s.marginBottom || "0");
+    n += e + i, o += c + u;
+  }
+  return { width: n, height: o };
+}, j = (t) => t.getBoundingClientRect(), V = (t) => {
+  const n = new DOMParser().parseFromString(t, "image/svg+xml");
+  if (n.documentElement.nodeName === "parsererror")
+    throw new Error("Invalid SVG string: Failed to parse SVG");
+  return n.documentElement;
+}, T = (t, r) => (Object.defineProperty(t, r, { value: !0 }), t), W = (t, r) => !!t[r], p = (t) => T(t, "__mkEvent"), R = (t, r, n = {}) => {
+  const { event: o = "mousedown", capture: s = !0, exclude: e = [] } = n, i = p((c) => {
+    const u = c.target;
+    t.contains(u) || e.some((a) => a?.contains(u)) || r(c);
+  });
+  return document.addEventListener(o, i, s), () => document.removeEventListener(o, i, s);
+}, g = (t, r, n = {}) => {
+  const {
+    preventDefault: o = !1,
+    stopPropagation: s = !1,
+    event: e = "keydown",
+    target: i = document
+  } = n, c = Array.isArray(t) ? t : [t], u = p((a) => {
+    c.includes(a.key) && (o && a.preventDefault(), s && a.stopPropagation(), r(a));
+  });
+  return i.addEventListener(e, u), () => i.removeEventListener(e, u);
+}, $ = (t, r = {}) => g("Escape", t, r), N = (t, r = {}) => g("Enter", t, r), z = (t, r, n = {}) => {
+  const { duration: o = 500, threshold: s = 10 } = n;
+  let e = null, i = 0, c = 0;
+  const u = (d) => "touches" in d ? d.touches[0] : d, a = p((d) => {
+    const m = u(d);
+    i = m.clientX, c = m.clientY, e = setTimeout(() => {
+      r(d);
+    }, o);
+  }), w = p((d) => {
+    if (!e) return;
+    const m = u(d), v = Math.abs(m.clientX - i), b = Math.abs(m.clientY - c);
+    (v > s || b > s) && l();
+  }), l = p(() => {
+    e && (clearTimeout(e), e = null);
+  }), f = L(t, {
+    mousedown: a,
+    mousemove: w,
+    mouseup: l,
+    mouseleave: l,
+    touchstart: a,
+    touchmove: w,
+    touchend: l,
+    touchcancel: l
+  });
+  return () => {
+    f(), e && clearTimeout(e);
+  };
+}, L = (t, r, n) => {
+  const o = [];
+  return Object.entries(r).forEach(([s, e]) => {
+    if (!e) return;
+    const i = s;
+    Array.isArray(e) ? e.forEach((c) => {
+      t.addEventListener(i, c, n), o.push([i, c]);
+    }) : (t.addEventListener(i, e, n), o.push([i, e]));
+  }), () => {
+    o.forEach(([s, e]) => {
+      t.removeEventListener(s, e, n);
+    });
+  };
+}, K = (t, r = {}) => {
+  const { timeout: n = 5e3, root: o = document.body, interval: s = 100 } = r;
+  return new Promise((e, i) => {
+    const c = o.querySelector(t);
+    if (c) {
+      e(c);
+      return;
+    }
+    const u = new MutationObserver(() => {
+      const f = o.querySelector(t);
+      f && (l(), e(f));
+    });
+    u.observe(o, {
+      childList: !0,
+      subtree: !0
+    });
+    const a = setInterval(() => {
+      const f = o.querySelector(t);
+      f && (l(), e(f));
+    }, s), w = setTimeout(() => {
+      l(), i(new Error(`Timeout: Element "${t}" not found within ${n}ms`));
+    }, n), l = () => {
+      u.disconnect(), clearTimeout(w), clearInterval(a);
+    };
+  });
+}, X = (t, r = {}) => {
+  const { onRemove: n, root: o = document.body } = r, s = new MutationObserver(() => {
+    o.contains(t) || (n?.(), s.disconnect());
+  });
+  return s.observe(o, {
+    childList: !0,
+    subtree: !0
+  }), () => s.disconnect();
+}, Y = (t, r = {}) => {
+  const { root: n = document.body, timeout: o } = r;
+  return new Promise((s, e) => {
+    if (!n.contains(t)) {
+      s();
+      return;
+    }
+    let i;
+    const c = new MutationObserver(() => {
+      n.contains(t) || (u(), s());
+    });
+    c.observe(n, {
+      childList: !0,
+      subtree: !0
+    }), o && (i = setTimeout(() => {
+      u(), e(new Error(`Timeout: Element not removed within ${o}ms`));
+    }, o));
+    const u = () => {
+      c.disconnect(), i && clearTimeout(i);
+    };
+  });
+}, Z = (t, r = {}) => {
+  const {
+    attributes: n = !0,
+    childList: o = !0,
+    characterData: s = !1,
+    subtree: e = !1,
+    onMutation: i
+  } = r, c = new MutationObserver((u) => i?.(u));
+  return c.observe(t, {
+    attributes: n,
+    childList: o,
+    characterData: s,
+    subtree: e
+  }), () => c.disconnect();
+}, q = (t, r = {}) => {
+  const { id: n, nonce: o, target: s = document.head } = r, e = document.createElement("style");
+  return n && (e.id = n), o && e.setAttribute("nonce", o), e.textContent = t, s.appendChild(e), { style: e, remove: () => {
+    e.parentNode?.removeChild(e);
+  } };
+}, y = typeof unsafeWindow < "u" ? unsafeWindow : window, B = y.document;
+function G(t) {
+  return t ? t instanceof Window ? t : t instanceof UIEvent && t.view ? t.view : t instanceof Document ? t.defaultView : t instanceof ShadowRoot ? t.host.ownerDocument?.defaultView ?? null : t instanceof Node ? t.ownerDocument?.defaultView ?? null : null : y;
+}
+const H = (t) => t.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, "$1-$2").toLowerCase(), _ = (t) => t.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, "$1-$2").toLowerCase(), U = (t, r) => {
+  let n = null, o = null;
+  const s = (...e) => {
+    o = e, n && clearTimeout(n), n = setTimeout(() => {
+      t(...o), n = null, o = null;
+    }, r);
+  };
+  return s.cancel = () => {
+    n && clearTimeout(n), n = null, o = null;
+  }, s.flush = () => {
+    n && (t(...o), clearTimeout(n), n = null, o = null);
+  }, s;
+}, J = (t, r) => {
+  let n = null, o = null, s = 0;
+  const e = () => {
+    n && (clearTimeout(n), n = null);
+  }, i = (...c) => {
+    const u = Date.now();
+    if (o = c, s === 0)
+      t(...c), s = u;
+    else {
+      const a = u - s;
+      a >= r ? (t(...c), s = u, e()) : (e(), n = setTimeout(() => {
+        t(...o), s = Date.now(), n = null;
+      }, r - a));
+    }
+  };
+  return i.cancel = () => {
+    e(), s = 0, o = null;
+  }, i.flush = () => {
+    s > 0 && o !== null && t(...o), e(), s = 0, o = null;
+  }, i;
+}, C = (t) => new Promise((r) => setTimeout(r, t)), Q = (t) => C(t), k = (t, r, n = `Operation timed out after ${r}ms`) => Promise.race([
+  t,
+  new Promise((o, s) => setTimeout(() => s(new Error(n)), r))
+]), tt = () => {
+}, et = async (t, r = {}) => {
+  const { maxAttempts: n = 3, delay: o = 1e3, exponential: s = !1 } = r;
+  let e;
+  for (let i = 1; i <= n; i++)
+    try {
+      return await t();
+    } catch (c) {
+      if (e = c instanceof Error ? c : new Error(String(c)), i < n) {
+        const u = s ? o * Math.pow(2, i - 1) : o;
+        await new Promise((a) => setTimeout(a, u));
+      }
+    }
+  throw e || new Error("Retry failed");
+};
+export {
+  L as addEventsListener,
+  H as camelToKebab,
+  A as createElement,
+  S as createFragment,
+  V as createSVGFromString,
+  U as debounce,
+  C as delay,
+  F as getComputedStyle,
+  D as getInnerSize,
+  O as getOffset,
+  x as getOuterSize,
+  j as getRect,
+  P as getSize,
+  G as getWin,
+  B as globalDoc,
+  y as globalWin,
+  q as injectStyle,
+  W as isMarkedAs,
+  T as markFunc,
+  tt as noop,
+  R as onClickOutside,
+  N as onEnter,
+  $ as onEscape,
+  g as onKeyPress,
+  z as onLongPress,
+  h as parseClass,
+  _ as pascalToKebab,
+  et as retry,
+  M as scrollIntoView,
+  I as scrollTo,
+  Q as sleep,
+  J as throttle,
+  k as timeout,
+  K as waitForElement,
+  Y as waitForElementRemoval,
+  Z as watchElementChanges,
+  X as watchElementRemoval
+};

package/dist/mkdomutils.umd.js

@@ -0,0 +1 @@
+(function(i,m){typeof exports=="object"&&typeof module<"u"?m(exports):typeof define=="function"&&define.amd?define(["exports"],m):(i=typeof globalThis<"u"?globalThis:i||self,m(i.MKDomUtils={}))})(this,(function(i){"use strict";const m=(...e)=>e.flatMap(r=>typeof r=="string"?r.trim().split(/\s+/).filter(Boolean):r||[]),C=(e,r,...n)=>{const o=document.createElement(e);return r?(Object.entries(r).forEach(([s,t])=>{if(t!=null){if(s==="className"||s==="class"){const c=Array.isArray(t)?m(...t):m(t);o.className=c.join(" ");return}if(s==="style"){typeof t=="string"?o.style.cssText=t:typeof t=="object"&&Object.assign(o.style,t);return}if(s==="dataset"&&typeof t=="object"){Object.assign(o.dataset,t);return}if(s.startsWith("on")){const c=s.slice(2).toLowerCase();typeof t=="function"?o.addEventListener(c,t):Array.isArray(t)&&t.forEach(a=>{typeof a=="function"&&o.addEventListener(c,a)});return}s in o?o[s]=t:o.setAttribute(s,String(t))}}),p(o,n),o):(p(o,n),o)},L=(...e)=>{const r=document.createDocumentFragment();return e.forEach(n=>{typeof n=="string"?r.appendChild(document.createTextNode(n)):r.appendChild(n)}),r},p=(e,r)=>{r.forEach(n=>{typeof n=="string"?e.appendChild(document.createTextNode(n)):e.appendChild(n)})},A=e=>({width:e.offsetWidth,height:e.offsetHeight}),F=e=>({top:e.offsetTop,left:e.offsetLeft}),O=(e,r)=>window.getComputedStyle(e).getPropertyValue(r).trim(),P=(e,r)=>{e&&(e===document.documentElement||e===document.body?window.scrollTo(r):e.scrollTo?.(r))},I=(e,r)=>{e.scrollIntoView?.(r)},M=e=>({width:e.clientWidth,height:e.clientHeight}),D=(e,r=!1)=>{let n=e.offsetWidth,o=e.offsetHeight;if(r){const s=window.getComputedStyle(e),t=parseFloat(s.marginLeft||"0"),c=parseFloat(s.marginRight||"0"),a=parseFloat(s.marginTop||"0"),u=parseFloat(s.marginBottom||"0");n+=t+c,o+=a+u}return{width:n,height:o}},j=e=>e.getBoundingClientRect(),R=e=>{const n=new DOMParser().parseFromString(e,"image/svg+xml");if(n.documentElement.nodeName==="parsererror")throw new Error("Invalid SVG string: Failed to parse SVG");return n.documentElement},v=(e,r)=>(Object.defineProperty(e,r,{value:!0}),e),V=(e,r)=>!!e[r],w=e=>v(e,"__mkEvent"),W=(e,r,n={})=>{const{event:o="mousedown",capture:s=!0,exclude:t=[]}=n,c=w(a=>{const u=a.target;e.contains(u)||t.some(l=>l?.contains(u))||r(a)});return document.addEventListener(o,c,s),()=>document.removeEventListener(o,c,s)},y=(e,r,n={})=>{const{preventDefault:o=!1,stopPropagation:s=!1,event:t="keydown",target:c=document}=n,a=Array.isArray(e)?e:[e],u=w(l=>{a.includes(l.key)&&(o&&l.preventDefault(),s&&l.stopPropagation(),r(l))});return c.addEventListener(t,u),()=>c.removeEventListener(t,u)},z=(e,r={})=>y("Escape",e,r),K=(e,r={})=>y("Enter",e,r),$=(e,r,n={})=>{const{duration:o=500,threshold:s=10}=n;let t=null,c=0,a=0;const u=f=>"touches"in f?f.touches[0]:f,l=w(f=>{const g=u(f);c=g.clientX,a=g.clientY,t=setTimeout(()=>{r(f)},o)}),E=w(f=>{if(!t)return;const g=u(f),te=Math.abs(g.clientX-c),ne=Math.abs(g.clientY-a);(te>s||ne>s)&&d()}),d=w(()=>{t&&(clearTimeout(t),t=null)}),h=T(e,{mousedown:l,mousemove:E,mouseup:d,mouseleave:d,touchstart:l,touchmove:E,touchend:d,touchcancel:d});return()=>{h(),t&&clearTimeout(t)}},T=(e,r,n)=>{const o=[];return Object.entries(r).forEach(([s,t])=>{if(!t)return;const c=s;Array.isArray(t)?t.forEach(a=>{e.addEventListener(c,a,n),o.push([c,a])}):(e.addEventListener(c,t,n),o.push([c,t]))}),()=>{o.forEach(([s,t])=>{e.removeEventListener(s,t,n)})}},N=(e,r={})=>{const{timeout:n=5e3,root:o=document.body,interval:s=100}=r;return new Promise((t,c)=>{const a=o.querySelector(e);if(a){t(a);return}const u=new MutationObserver(()=>{const h=o.querySelector(e);h&&(d(),t(h))});u.observe(o,{childList:!0,subtree:!0});const l=setInterval(()=>{const h=o.querySelector(e);h&&(d(),t(h))},s),E=setTimeout(()=>{d(),c(new Error(`Timeout: Element "${e}" not found within ${n}ms`))},n),d=()=>{u.disconnect(),clearTimeout(E),clearInterval(l)}})},G=(e,r={})=>{const{onRemove:n,root:o=document.body}=r,s=new MutationObserver(()=>{o.contains(e)||(n?.(),s.disconnect())});return s.observe(o,{childList:!0,subtree:!0}),()=>s.disconnect()},X=(e,r={})=>{const{root:n=document.body,timeout:o}=r;return new Promise((s,t)=>{if(!n.contains(e)){s();return}let c;const a=new MutationObserver(()=>{n.contains(e)||(u(),s())});a.observe(n,{childList:!0,subtree:!0}),o&&(c=setTimeout(()=>{u(),t(new Error(`Timeout: Element not removed within ${o}ms`))},o));const u=()=>{a.disconnect(),c&&clearTimeout(c)}})},Y=(e,r={})=>{const{attributes:n=!0,childList:o=!0,characterData:s=!1,subtree:t=!1,onMutation:c}=r,a=new MutationObserver(u=>c?.(u));return a.observe(e,{attributes:n,childList:o,characterData:s,subtree:t}),()=>a.disconnect()},Z=(e,r={})=>{const{id:n,nonce:o,target:s=document.head}=r,t=document.createElement("style");return n&&(t.id=n),o&&t.setAttribute("nonce",o),t.textContent=e,s.appendChild(t),{style:t,remove:()=>{t.parentNode?.removeChild(t)}}},b=typeof unsafeWindow<"u"?unsafeWindow:window,q=b.document;function B(e){return e?e instanceof Window?e:e instanceof UIEvent&&e.view?e.view:e instanceof Document?e.defaultView:e instanceof ShadowRoot?e.host.ownerDocument?.defaultView??null:e instanceof Node?e.ownerDocument?.defaultView??null:null:b}const H=e=>e.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g,"$1-$2").toLowerCase(),_=e=>e.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g,"$1-$2").toLowerCase(),U=(e,r)=>{let n=null,o=null;const s=(...t)=>{o=t,n&&clearTimeout(n),n=setTimeout(()=>{e(...o),n=null,o=null},r)};return s.cancel=()=>{n&&clearTimeout(n),n=null,o=null},s.flush=()=>{n&&(e(...o),clearTimeout(n),n=null,o=null)},s},J=(e,r)=>{let n=null,o=null,s=0;const t=()=>{n&&(clearTimeout(n),n=null)},c=(...a)=>{const u=Date.now();if(o=a,s===0)e(...a),s=u;else{const l=u-s;l>=r?(e(...a),s=u,t()):(t(),n=setTimeout(()=>{e(...o),s=Date.now(),n=null},r-l))}};return c.cancel=()=>{t(),s=0,o=null},c.flush=()=>{s>0&&o!==null&&e(...o),t(),s=0,o=null},c},S=e=>new Promise(r=>setTimeout(r,e)),Q=e=>S(e),k=(e,r,n=`Operation timed out after ${r}ms`)=>Promise.race([e,new Promise((o,s)=>setTimeout(()=>s(new Error(n)),r))]),x=()=>{},ee=async(e,r={})=>{const{maxAttempts:n=3,delay:o=1e3,exponential:s=!1}=r;let t;for(let c=1;c<=n;c++)try{return await e()}catch(a){if(t=a instanceof Error?a:new Error(String(a)),c<n){const u=s?o*Math.pow(2,c-1):o;await new Promise(l=>setTimeout(l,u))}}throw t||new Error("Retry failed")};i.addEventsListener=T,i.camelToKebab=H,i.createElement=C,i.createFragment=L,i.createSVGFromString=R,i.debounce=U,i.delay=S,i.getComputedStyle=O,i.getInnerSize=M,i.getOffset=F,i.getOuterSize=D,i.getRect=j,i.getSize=A,i.getWin=B,i.globalDoc=q,i.globalWin=b,i.injectStyle=Z,i.isMarkedAs=V,i.markFunc=v,i.noop=x,i.onClickOutside=W,i.onEnter=K,i.onEscape=z,i.onKeyPress=y,i.onLongPress=$,i.parseClass=m,i.pascalToKebab=_,i.retry=ee,i.scrollIntoView=I,i.scrollTo=P,i.sleep=Q,i.throttle=J,i.timeout=k,i.waitForElement=N,i.waitForElementRemoval=X,i.watchElementChanges=Y,i.watchElementRemoval=G,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './string';
+export * from './tag';
+export * from './timing';
+export * from './types';

package/dist/utils/string.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converts a camelCase string to kebab-case.
+ * @param str - The camelCase string to convert.
+ * @returns The kebab-case string.
+ */
+export declare const camelToKebab: (str: string) => string;
+/**
+ * Converts a PascalCase string to kebab-case.
+ * @param str - The PascalCase string to convert.
+ * @returns The kebab-case string.
+ */
+export declare const pascalToKebab: (str: string) => string;

package/dist/utils/tag.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Type representing a function tagged with a specific string.
+ */
+export type TaggedFunction<F extends CallableFunction, T extends string> = F & {
+    readonly [K in T]?: true;
+};
+/**
+ * Marks a function with a specific tag.
+ * @param func - The function to mark.
+ * @param tag - The tag to assign.
+ * @returns The marked function.
+ */
+export declare const markFunc: <F extends CallableFunction, T extends string>(func: F, tag: T) => TaggedFunction<F, T>;
+/**
+ * Checks if a function is marked with a specific tag.
+ * @param func - The function to check.
+ * @param tag - The tag to look for.
+ * @returns True if the function is marked with the tag, false otherwise.
+ */
+export declare const isMarkedAs: <F extends CallableFunction, T extends string>(func: F, tag: T) => func is TaggedFunction<F, T>;

package/dist/utils/timing.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Debounce function that delays the execution of a callback until after a specified wait time has elapsed.
+ * @param callback - The function to debounce.
+ * @param wait - The delay in milliseconds.
+ * @returns A debounced function with cancel and flush methods.
+ */
+export declare const debounce: <T extends (...args: unknown[]) => unknown>(callback: T, wait: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+    flush: () => void;
+};
+/**
+ * Throttle function that executes a callback at most once every specified wait time.
+ * @param callback - The function to throttle.
+ * @param wait - The minimum interval in milliseconds between executions.
+ * @returns A throttled function with cancel and flush methods.
+ */
+export declare const throttle: <T extends (...args: unknown[]) => unknown>(callback: T, wait: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+    flush: () => void;
+};
+/**
+ * Creates a promise that resolves after a specified delay.
+ * @param ms - The delay in milliseconds.
+ * @returns A promise that resolves after the delay.
+ */
+export declare const delay: (ms: number) => Promise<void>;
+/**
+ * Pauses execution for a specified duration in async contexts.
+ * @param ms - The duration to sleep in milliseconds.
+ * @returns A promise that resolves after the sleep duration.
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Creates a promise that rejects if the given promise doesn't resolve within the specified timeout.
+ * @param promise - The promise to apply a timeout to.
+ * @param ms - The timeout duration in milliseconds.
+ * @param message - Optional error message for the timeout error.
+ * @returns A promise that resolves with the original promise's value or rejects on timeout.
+ */
+export declare const timeout: <T>(promise: Promise<T>, ms: number, message?: string) => Promise<T>;
+/**
+ * A no-operation function that does nothing when called.
+ */
+export declare const noop: () => void;
+/**
+ * Retries a function until it succeeds or reaches the maximum number of attempts.
+ * @param fn - The async function to retry.
+ * @param options - Configuration options for retry behavior.
+ * @returns A promise that resolves with the function result or rejects if all attempts fail.
+ */
+export declare const retry: <T>(fn: () => Promise<T>, options?: {
+    /** Maximum number of attempts. Default: 3 */
+    maxAttempts?: number;
+    /** Delay in milliseconds between attempts. Default: 1000 */
+    delay?: number;
+    /** Whether to use exponential backoff. Default: false */
+    exponential?: boolean;
+}) => Promise<T>;

package/dist/utils/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A type that represents a value that can be either a single instance of type T or an array of type T.
+ */
+export type SingleOrArray<T> = T | T[];
+/**
+ * A type that represents a value that can be either a direct value of type T or a Promise that resolves to type T.
+ */
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * A type that represents a value that can be null or undefined.
+ */
+export type Nullable<T> = T | null | undefined;

package/eslint.config.mjs

@@ -0,0 +1,33 @@
+import { defineConfig } from 'eslint/config';
+import prettier from 'eslint-plugin-prettier';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import tseslint from 'typescript-eslint';
+
+export default defineConfig([
+  { ignores: ['dist/**', 'node_modules/**', 'example-dist/**'] },
+  ...tseslint.configs.recommended,
+  {
+    name: 'globals-and-rules',
+    languageOptions: {
+      ecmaVersion: 2024,
+      sourceType: 'module',
+      globals: {
+        window: 'readonly',
+        document: 'readonly',
+        navigator: 'readonly',
+      },
+    },
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+      prettier,
+    },
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+      'simple-import-sort/imports': 'warn',
+      'simple-import-sort/exports': 'warn',
+      'prettier/prettier': ['warn', { endOfLine: 'auto' }],
+      'no-console': 'warn',
+      'no-debugger': 'warn',
+    },
+  },
+]);

package/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>tt</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@mkmonkeycat/dom-utils",
+  "version": "0.1.0",
+  "description": "A TypeScript utility library for DOM manipulation and common web development tasks.",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": "https://github.com/MKMonkeyCat/dom-utils.git",
+  "bugs": {
+    "url": "https://github.com/MKMonkeyCat/dom-utils/issues"
+  },
+  "author": "MKMonkeyCat <a102009102009@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "typescript",
+    "dom",
+    "utilities",
+    "utils",
+    "library",
+    "web",
+    "frontend"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint:fix": "eslint ./src --ext .ts,.tsx --quiet --fix",
+    "lint:format": "prettier --log-level warn --write \"./**/*.{ts,tsx,css,md,json}\"",
+    "lint": "yarn lint:format && yarn lint:fix"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "happy-dom": "^20.0.11",
+    "jsdom": "^27.3.0",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.1",
+    "vite": "^7.3.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {}
+}