@mkmonkeycat/dom-utils 0.1.0 → 1.0.0

package/README.md

@@ -0,0 +1,18 @@
+# dom-utils
+
+A TypeScript utility library for DOM manipulation and common web development tasks.
+
+[![npm](https://img.shields.io/npm/v/@mkmonkeycat/dom-utils)](https://www.npmjs.com/package/@mkmonkeycat/dom-utils)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+npm install @mkmonkeycat/dom-utils
+# or
+yarn add @mkmonkeycat/dom-utils
+# or
+pnpm add @mkmonkeycat/dom-utils
+```
+
+## Usage

package/dist/index.d.ts

@@ -1,2 +1,3 @@
+export declare const VERSION = "0.0.1";
 export * from './dom';
 export * from './utils';

package/dist/mkdomutils.cjs.js

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

package/dist/mkdomutils.iife.js

@@ -1 +1 @@
-var MKDomUtils=(function(i){"use strict";const E=(...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)?E(...t):E(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))}}),v(o,n),o):(v(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},v=(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"),l=parseFloat(s.marginBottom||"0");n+=t+c,o+=a+l}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},p=(e,r)=>(Object.defineProperty(e,r,{value:!0}),e),V=(e,r)=>!!e[r],w=e=>p(e,"__mkEvent"),W=(e,r,n={})=>{const{event:o="mousedown",capture:s=!0,exclude:t=[]}=n,c=w(a=>{const l=a.target;e.contains(l)||t.some(u=>u?.contains(l))||r(a)});return document.addEventListener(o,c,s),()=>document.removeEventListener(o,c,s)},b=(e,r,n={})=>{const{preventDefault:o=!1,stopPropagation:s=!1,event:t="keydown",target:c=document}=n,a=Array.isArray(e)?e:[e],l=w(u=>{a.includes(u.key)&&(o&&u.preventDefault(),s&&u.stopPropagation(),r(u))});return c.addEventListener(t,l),()=>c.removeEventListener(t,l)},z=(e,r={})=>b("Escape",e,r),K=(e,r={})=>b("Enter",e,r),$=(e,r,n={})=>{const{duration:o=500,threshold:s=10}=n;let t=null,c=0,a=0;const l=m=>"touches"in m?m.touches[0]:m,u=w(m=>{const h=l(m);c=h.clientX,a=h.clientY,t=setTimeout(()=>{r(m)},o)}),g=w(m=>{if(!t)return;const h=l(m),te=Math.abs(h.clientX-c),ne=Math.abs(h.clientY-a);(te>s||ne>s)&&d()}),d=w(()=>{t&&(clearTimeout(t),t=null)}),f=T(e,{mousedown:u,mousemove:g,mouseup:d,mouseleave:d,touchstart:u,touchmove:g,touchend:d,touchcancel:d});return()=>{f(),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 l=new MutationObserver(()=>{const f=o.querySelector(e);f&&(d(),t(f))});l.observe(o,{childList:!0,subtree:!0});const u=setInterval(()=>{const f=o.querySelector(e);f&&(d(),t(f))},s),g=setTimeout(()=>{d(),c(new Error(`Timeout: Element "${e}" not found within ${n}ms`))},n),d=()=>{l.disconnect(),clearTimeout(g),clearInterval(u)}})},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)||(l(),s())});a.observe(n,{childList:!0,subtree:!0}),o&&(c=setTimeout(()=>{l(),t(new Error(`Timeout: Element not removed within ${o}ms`))},o));const l=()=>{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(l=>c?.(l));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)}}},y=typeof unsafeWindow<"u"?unsafeWindow:window,q=y.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:y}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 l=Date.now();if(o=a,s===0)e(...a),s=l;else{const u=l-s;u>=r?(e(...a),s=l,t()):(t(),n=setTimeout(()=>{e(...o),s=Date.now(),n=null},r-u))}};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 l=s?o*Math.pow(2,c-1):o;await new Promise(u=>setTimeout(u,l))}}throw t||new Error("Retry failed")};return 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=y,i.injectStyle=Z,i.isMarkedAs=V,i.markFunc=p,i.noop=x,i.onClickOutside=W,i.onEnter=K,i.onEscape=z,i.onKeyPress=b,i.onLongPress=$,i.parseClass=E,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"}),i})({});
+var MKDomUtils=(function(i){"use strict";const E=(...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)?E(...t):E(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))}}),v(o,n),o):(v(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},v=(e,r)=>{r.forEach(n=>{typeof n=="string"?e.appendChild(document.createTextNode(n)):e.appendChild(n)})},A=e=>({width:e.offsetWidth,height:e.offsetHeight}),O=e=>({top:e.offsetTop,left:e.offsetLeft}),F=(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"),l=parseFloat(s.marginBottom||"0");n+=t+c,o+=a+l}return{width:n,height:o}},R=e=>e.getBoundingClientRect(),V=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},T=(e,r)=>(Object.defineProperty(e,r,{value:!0}),e),j=(e,r)=>!!e[r],w=e=>T(e,"__mkEvent"),W=(e,r,n={})=>{const{event:o="mousedown",capture:s=!0,exclude:t=[]}=n,c=w(a=>{const l=a.target;e.contains(l)||t.some(u=>u?.contains(l))||r(a)});return document.addEventListener(o,c,s),()=>document.removeEventListener(o,c,s)},b=(e,r,n={})=>{const{preventDefault:o=!1,stopPropagation:s=!1,event:t="keydown",target:c=document}=n,a=Array.isArray(e)?e:[e],l=w(u=>{a.includes(u.key)&&(o&&u.preventDefault(),s&&u.stopPropagation(),r(u))});return c.addEventListener(t,l),()=>c.removeEventListener(t,l)},z=(e,r={})=>b("Escape",e,r),K=(e,r={})=>b("Enter",e,r),N=(e,r,n={})=>{const{duration:o=500,threshold:s=10}=n;let t=null,c=0,a=0;const l=m=>"touches"in m?m.touches[0]:m,u=w(m=>{const h=l(m);c=h.clientX,a=h.clientY,t=setTimeout(()=>{r(m)},o)}),g=w(m=>{if(!t)return;const h=l(m),ne=Math.abs(h.clientX-c),oe=Math.abs(h.clientY-a);(ne>s||oe>s)&&d()}),d=w(()=>{t&&(clearTimeout(t),t=null)}),f=p(e,{mousedown:u,mousemove:g,mouseup:d,mouseleave:d,touchstart:u,touchmove:g,touchend:d,touchcancel:d});return()=>{f(),t&&clearTimeout(t)}},p=(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)})}},$=(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 l=new MutationObserver(()=>{const f=o.querySelector(e);f&&(d(),t(f))});l.observe(o,{childList:!0,subtree:!0});const u=setInterval(()=>{const f=o.querySelector(e);f&&(d(),t(f))},s),g=setTimeout(()=>{d(),c(new Error(`Timeout: Element "${e}" not found within ${n}ms`))},n),d=()=>{l.disconnect(),clearTimeout(g),clearInterval(u)}})},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)||(l(),s())});a.observe(n,{childList:!0,subtree:!0}),o&&(c=setTimeout(()=>{l(),t(new Error(`Timeout: Element not removed within ${o}ms`))},o));const l=()=>{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(l=>c?.(l));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)}}},y=typeof unsafeWindow<"u"?unsafeWindow:window,q=y.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:y}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 l=Date.now();if(o=a,s===0)e(...a),s=l;else{const u=l-s;u>=r?(e(...a),s=l,t()):(t(),n=setTimeout(()=>{e(...o),s=Date.now(),n=null},r-u))}};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 l=s?o*Math.pow(2,c-1):o;await new Promise(u=>setTimeout(u,l))}}throw t||new Error("Retry failed")},te="0.0.1";return i.VERSION=te,i.addEventsListener=p,i.camelToKebab=H,i.createElement=C,i.createFragment=L,i.createSVGFromString=V,i.debounce=U,i.delay=S,i.getComputedStyle=F,i.getInnerSize=M,i.getOffset=O,i.getOuterSize=D,i.getRect=R,i.getSize=A,i.getWin=B,i.globalDoc=q,i.globalWin=y,i.injectStyle=Z,i.isMarkedAs=j,i.markFunc=T,i.noop=x,i.onClickOutside=W,i.onEnter=K,i.onEscape=z,i.onKeyPress=b,i.onLongPress=N,i.parseClass=E,i.pascalToKebab=_,i.retry=ee,i.scrollIntoView=I,i.scrollTo=P,i.sleep=Q,i.throttle=J,i.timeout=k,i.waitForElement=$,i.waitForElementRemoval=X,i.watchElementChanges=Y,i.watchElementRemoval=G,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"}),i})({});

package/dist/mkdomutils.js

@@ -1,4 +1,4 @@
-const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/).filter(Boolean) : r || []), A = (t, r, ...n) => {
+const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/).filter(Boolean) : r || []), S = (t, r, ...n) => {
   const o = document.createElement(t);
   return r ? (Object.entries(r).forEach(([s, e]) => {
     if (e != null) {
@@ -25,7 +25,7 @@ const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/
       s in o ? o[s] = e : o.setAttribute(s, String(e));
     }
   }), E(o, n), o) : (E(o, n), o);
-}, S = (...t) => {
+}, A = (...t) => {
   const r = document.createDocumentFragment();
   return t.forEach((n) => {
     typeof n == "string" ? r.appendChild(document.createTextNode(n)) : r.appendChild(n);
@@ -34,13 +34,13 @@ const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/
   r.forEach((n) => {
     typeof n == "string" ? t.appendChild(document.createTextNode(n)) : t.appendChild(n);
   });
-}, P = (t) => ({
+}, O = (t) => ({
   width: t.offsetWidth,
   height: t.offsetHeight
-}), O = (t) => ({
+}), P = (t) => ({
   top: t.offsetTop,
   left: t.offsetLeft
-}), F = (t, r) => window.getComputedStyle(t).getPropertyValue(r).trim(), I = (t, r) => {
+}), I = (t, r) => window.getComputedStyle(t).getPropertyValue(r).trim(), F = (t, r) => {
   t && (t === document.documentElement || t === document.body ? window.scrollTo(r) : t.scrollTo?.(r));
 }, M = (t, r) => {
   t.scrollIntoView?.(r);
@@ -54,12 +54,12 @@ const h = (...t) => t.flatMap((r) => typeof r == "string" ? r.trim().split(/\s+/
     n += e + i, o += c + u;
   }
   return { width: n, height: o };
-}, j = (t) => t.getBoundingClientRect(), V = (t) => {
+}, V = (t) => t.getBoundingClientRect(), j = (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 = {}) => {
+}, T = (t, r) => (Object.defineProperty(t, r, { value: !0 }), t), R = (t, r) => !!t[r], p = (t) => T(t, "__mkEvent"), W = (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);
@@ -241,29 +241,30 @@ const H = (t) => t.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, "$1-$2").toLowerCase(
       }
     }
   throw e || new Error("Retry failed");
-};
+}, nt = "0.0.1";
 export {
+  nt as VERSION,
   L as addEventsListener,
   H as camelToKebab,
-  A as createElement,
-  S as createFragment,
-  V as createSVGFromString,
+  S as createElement,
+  A as createFragment,
+  j as createSVGFromString,
   U as debounce,
   C as delay,
-  F as getComputedStyle,
+  I as getComputedStyle,
   D as getInnerSize,
-  O as getOffset,
+  P as getOffset,
   x as getOuterSize,
-  j as getRect,
-  P as getSize,
+  V as getRect,
+  O as getSize,
   G as getWin,
   B as globalDoc,
   y as globalWin,
   q as injectStyle,
-  W as isMarkedAs,
+  R as isMarkedAs,
   T as markFunc,
   tt as noop,
-  R as onClickOutside,
+  W as onClickOutside,
   N as onEnter,
   $ as onEscape,
   g as onKeyPress,
@@ -272,7 +273,7 @@ export {
   _ as pascalToKebab,
   et as retry,
   M as scrollIntoView,
-  I as scrollTo,
+  F as scrollTo,
   Q as sleep,
   J as throttle,
   k as timeout,

package/dist/mkdomutils.umd.js

@@ -1 +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"})}));
+(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}),O=e=>({top:e.offsetTop,left:e.offsetLeft}),F=(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}},R=e=>e.getBoundingClientRect(),V=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),j=(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),N=(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),ne=Math.abs(g.clientX-c),oe=Math.abs(g.clientY-a);(ne>s||oe>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)})}},$=(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")},te="0.0.1";i.VERSION=te,i.addEventsListener=T,i.camelToKebab=H,i.createElement=C,i.createFragment=L,i.createSVGFromString=V,i.debounce=U,i.delay=S,i.getComputedStyle=F,i.getInnerSize=M,i.getOffset=O,i.getOuterSize=D,i.getRect=R,i.getSize=A,i.getWin=B,i.globalDoc=q,i.globalWin=b,i.injectStyle=Z,i.isMarkedAs=j,i.markFunc=v,i.noop=x,i.onClickOutside=W,i.onEnter=K,i.onEscape=z,i.onKeyPress=y,i.onLongPress=N,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=$,i.waitForElementRemoval=X,i.watchElementChanges=Y,i.watchElementRemoval=G,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,12 +1,26 @@
 {
   "name": "@mkmonkeycat/dom-utils",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "A TypeScript utility library for DOM manipulation and common web development tasks.",
+  "homepage": "https://github.com/MKMonkeyCat/dom-utils#readme",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "repository": "https://github.com/MKMonkeyCat/dom-utils.git",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MKMonkeyCat/dom-utils.git"
+  },
   "bugs": {
     "url": "https://github.com/MKMonkeyCat/dom-utils/issues"
   },

package/.eslintignore

@@ -1,2 +0,0 @@
-dist/
-node_modules/

package/.github/workflows/release.yml

@@ -1,39 +0,0 @@
-name: Release
-on:
-  push:
-    branches:
-      - main
-
-permissions:
-  contents: read
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      issues: write
-      pull-requests: write
-      id-token: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
-        with:
-          node-version: lts/*
-
-      - name: Install dependencies
-        run: npm clean-install
-
-      - name: Verify the integrity of provenance attestations and registry signatures for installed dependencies
-        run: npm audit signatures
-
-      - name: Release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: npx semantic-release

package/.prettierignore

@@ -1 +0,0 @@
-node_modules/

package/.prettierrc.yml

@@ -1,9 +0,0 @@
-semi: true
-singleQuote: true
-trailingComma: all
-printWidth: 100
-tabWidth: 2
-bracketSpacing: true
-arrowParens: always
-endOfLine: auto
-quoteProps: as-needed

package/eslint.config.mjs

@@ -1,33 +0,0 @@
-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

@@ -1,13 +0,0 @@
-<!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/src/dom/element.ts

@@ -1,252 +0,0 @@
-/**
- * Parses class names from various input formats into a flat array of class names.
- * @param classNames - Class names as strings, arrays of strings, or undefined.
- * @returns An array of individual class names.
- */
-export const parseClass = (...classNames: (string | string[] | undefined)[]): string[] => {
-  return classNames.flatMap((className) => {
-    if (typeof className === 'string') {
-      return className.trim().split(/\s+/).filter(Boolean);
-    }
-    return className || [];
-  });
-};
-
-/**
- * Creates an HTML element with specified attributes and children.
- * @param tag - The tag name of the HTML element to create.
- * @param attributes - An object containing attributes, styles, event handlers, and dataset entries to set on the element.
- * @param children - Child nodes or strings to append to the created element.
- * @returns The created HTML element.
- */
-export const createElement = <K extends keyof HTMLElementTagNameMap>(
-  tag: K,
-  attributes?: ElementAttributes<HTMLElementTagNameMap[K]>,
-  ...children: (Node | string)[]
-): HTMLElementTagNameMap[K] => {
-  const element = document.createElement(tag);
-
-  if (!attributes) {
-    addChildren(element, children);
-    return element;
-  }
-
-  Object.entries(attributes).forEach(([key, value]) => {
-    if (value == null) return;
-
-    if (key === 'className' || key === 'class') {
-      const classes = Array.isArray(value) ? parseClass(...value) : parseClass(value as string);
-      element.className = classes.join(' ');
-      return;
-    }
-
-    if (key === 'style') {
-      if (typeof value === 'string') {
-        element.style.cssText = value;
-      } else if (typeof value === 'object') {
-        Object.assign(element.style, value);
-      }
-      return;
-    }
-
-    if (key === 'dataset' && typeof value === 'object') {
-      Object.assign(element.dataset, value as Record<string, string>);
-      return;
-    }
-
-    if (key.startsWith('on')) {
-      const eventName = key.slice(2).toLowerCase();
-      if (typeof value === 'function') {
-        element.addEventListener(eventName, value as EventListener);
-      } else if (Array.isArray(value)) {
-        value.forEach((handler) => {
-          if (typeof handler === 'function') {
-            element.addEventListener(eventName, handler);
-          }
-        });
-      }
-      return;
-    }
-
-    if (key in element) {
-      (element as Record<string, unknown>)[key] = value;
-    } else {
-      element.setAttribute(key, String(value));
-    }
-  });
-
-  addChildren(element, children);
-  return element;
-};
-
-/**
- * Creates a DocumentFragment for batch DOM operations.
- * @param children - Child nodes or strings to add to the fragment.
- * @returns A DocumentFragment containing the children.
- */
-export const createFragment = (...children: (Node | string)[]): DocumentFragment => {
-  const frag = document.createDocumentFragment();
-  children.forEach((child) => {
-    if (typeof child === 'string') {
-      frag.appendChild(document.createTextNode(child));
-    } else {
-      frag.appendChild(child);
-    }
-  });
-  return frag;
-};
-
-const addChildren = (element: HTMLElement, children: (Node | string)[]) => {
-  children.forEach((child) => {
-    if (typeof child === 'string') {
-      element.appendChild(document.createTextNode(child));
-    } else {
-      element.appendChild(child);
-    }
-  });
-};
-
-export type CSSProperties = Partial<CSSStyleDeclaration> | string;
-
-export type EventHandlers = {
-  [K in keyof HTMLElementEventMap as `on${Capitalize<K>}`]?: (
-    event: HTMLElementEventMap[K],
-  ) => void;
-};
-
-export type ElementAttributes<T extends HTMLElement = HTMLElement> = {
-  className?: string | string[];
-  class?: string | string[];
-  style?: CSSProperties;
-  dataset?: Record<string, string>;
-} & EventHandlers &
-  Partial<Omit<T, 'style' | 'children' | 'className' | 'classList' | 'dataset'>> & {
-    [key: string]: unknown;
-  };
-
-/**
- * Gets the width and height of an element (including padding and border).
- * @param element - The element to measure.
- * @returns An object with width and height properties.
- */
-export const getSize = (element: HTMLElement): { width: number; height: number } => {
-  return {
-    width: element.offsetWidth,
-    height: element.offsetHeight,
-  };
-};
-
-/**
- * Gets the offset position of an element relative to the document.
- * @param element - The element to measure.
- * @returns An object with top and left properties.
- */
-export const getOffset = (element: HTMLElement): { top: number; left: number } => {
-  return {
-    top: element.offsetTop,
-    left: element.offsetLeft,
-  };
-};
-
-/**
- * Gets a computed style value for an element.
- * @param element - The element to query.
- * @param property - The CSS property name.
- * @returns The computed style value.
- */
-export const getComputedStyle = (element: HTMLElement, property: string): string => {
-  return window.getComputedStyle(element).getPropertyValue(property).trim();
-};
-
-/**
- * Scrolls the element to a specific position (or to view if no position specified).
- * @param element - The element to scroll.
- * @param options - Scroll behavior options.
- */
-export const scrollTo = (
-  element: HTMLElement,
-  options?: ScrollToOptions | { top?: number; left?: number },
-): void => {
-  if (!element) return;
-  if (element === document.documentElement || element === document.body) {
-    window.scrollTo(options as ScrollToOptions);
-  } else {
-    element.scrollTo?.(options as ScrollToOptions);
-  }
-};
-
-/**
- * Scrolls the element into the viewport.
- * @param element - The element to scroll into view.
- * @param options - Scroll behavior options.
- */
-export const scrollIntoView = (
-  element: HTMLElement,
-  options?: ScrollIntoViewOptions | boolean,
-): void => {
-  element.scrollIntoView?.(options);
-};
-
-/**
- * Gets the inner size of an element (client width/height: includes padding, excludes border and scrollbar).
- * @param element - The element to measure.
- * @returns An object with width and height properties.
- */
-export const getInnerSize = (element: HTMLElement): { width: number; height: number } => {
-  return {
-    width: element.clientWidth,
-    height: element.clientHeight,
-  };
-};
-
-/**
- * Gets the outer size of an element (offset size). Optionally includes margins.
- * @param element - The element to measure.
- * @param includeMargin - Whether to include margins in the calculation.
- * @returns An object with width and height properties.
- */
-export const getOuterSize = (
-  element: HTMLElement,
-  includeMargin = false,
-): { width: number; height: number } => {
-  let width = element.offsetWidth;
-  let height = element.offsetHeight;
-
-  if (includeMargin) {
-    const styles = window.getComputedStyle(element);
-    const ml = parseFloat(styles.marginLeft || '0');
-    const mr = parseFloat(styles.marginRight || '0');
-    const mt = parseFloat(styles.marginTop || '0');
-    const mb = parseFloat(styles.marginBottom || '0');
-    width += ml + mr;
-    height += mt + mb;
-  }
-
-  return { width, height };
-};
-
-/**
- * Gets the bounding client rect of an element.
- * @param element - The element to measure.
- * @returns The DOMRect representing the element's bounding box.
- */
-export const getRect = (element: HTMLElement): DOMRect => {
-  return element.getBoundingClientRect();
-};
-
-/**
- * Creates an SVG element from an SVG string.
- * @param svgString - The SVG markup as a string.
- * @returns The parsed SVGElement.
- * @throws Error if the SVG string is invalid or contains multiple root elements.
- */
-export const createSVGFromString = (svgString: string): SVGElement => {
-  const parser = new DOMParser();
-  const doc = parser.parseFromString(svgString, 'image/svg+xml');
-
-  if (doc.documentElement.nodeName === 'parsererror') {
-    throw new Error('Invalid SVG string: Failed to parse SVG');
-  }
-
-  return doc.documentElement as unknown as SVGElement;
-};