@zero-dependency/dom 1.0.1 → 1.1.1

package/dist/html.d.ts

@@ -2,9 +2,33 @@ type Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{
     style: Partial<CSSStyleDeclaration>;
 } & Omit<HTMLElementTagNameMap[T], 'style'>>;
 type Children = (string | Node | HTMLElement)[];
-export declare function el<T extends keyof HTMLElementTagNameMap>(tag: T, attributes?: Children | Attributes<T>, ...children: Children): HTMLElementTagNameMap[T];
-export declare function text(str: string): Text;
+/**
+ * Create an element
+ * @param tag The tag name of the element to create
+ * @param attributes The attributes or children to set on the element
+ * @param children The children to append to the element
+ * @returns The created element
+ * @example
+ * el('div', { id: 'foo' }, 'Hello world')
+ * el('div', 'Hello world')
+ * el('div', [el('span', 'Hello'), el('span', 'world')])
+ * el('div', el('span', 'Hello world'))
+ * el('div', el('span', 'Hello'), el('span', 'world'))
+ * el('div', el('span', 'Hello world'), 'world')
+ */
+export declare function el<T extends keyof HTMLElementTagNameMap>(tag: T, attributes?: Attributes<T> | Children, ...children: Children): HTMLElementTagNameMap[T];
+/**
+ * Create a text node
+ * @param text The string to create a text node from
+ */
+export declare function text(text: string): Text;
+/**
+ * A non-breaking space
+ */
 export declare function nbsp(): Text;
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/DOMContentLoaded_event
+ * @returns A promise that resolves when the DOM is ready
+ */
 export declare function domReady(): Promise<void>;
-export declare function isDisabled(element: HTMLElement): boolean;
 export {};

package/dist/index.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(s,e,...n){const t=document.createElement(s);return typeof e=="string"?t.append(i(e)):Array.isArray(e)?t.append(...e):(Object.assign(t,e),Object.assign(t.style,e?.style)),n.length&&t.append(...n),t}function i(s){return document.createTextNode(s)}function a(){return i(" ")}async function d(){return new Promise(s=>{document.readyState=="loading"?document.addEventListener("DOMContentLoaded",()=>s(),{once:!0}):s()})}function h(s){return!!s.getAttribute("disabled")||!!s.getAttribute("aria-disabled")}class f{#e={};on(e,n){const t=this.#e[e];return t?t.push(n):this.#e[e]=[n],this}addListener(e,n){return this.on(e,n)}once(e,n){const t=(...r)=>{this.off(e,t),n(...r)};return this.on(e,t),this}emit(e,...n){const t=this.#e[e]||[];for(let r=0;r<t.length;r++)t[r](...n);return!!t.length}off(e,n){return this.#e[e]&&(this.#e[e]=this.#e[e].filter(t=>t!==n)),this}removeListener(e,n){return this.off(e,n)}removeAllListeners(e){return e?delete this.#e[e]:this.#e={},this}eventNames(){return Reflect.ownKeys(this.#e)}listeners(e){return this.#e[e]}listenerCount(e){return this.#e[e]?.length??0}}class p extends f{constructor(){super();const{history:e,location:n}=window,{pushState:t,replaceState:r}=e;e.pushState=(...o)=>{t.apply(e,o),this.emit("pushState",n,o[0])},e.replaceState=(...o)=>{r.apply(e,o),this.emit("replaceState",n,o[0])},window.addEventListener("popstate",o=>{this.emit("popState",n,o)})}}function c(s,e,n){const t=new MutationObserver((r,o)=>{for(const u of r)e(u,o)});return t.observe(s,{childList:!0,subtree:!0,...n}),()=>t.disconnect()}function m(s,e=document.documentElement){return new Promise(n=>{function t(){const r=e.querySelector(s);r&&n(r)}c(e,(r,o)=>{t(),o.disconnect()})})}exports.LocationObserver=p;exports.domReady=d;exports.el=l;exports.isDisabled=h;exports.nbsp=a;exports.observeElement=c;exports.text=i;exports.waitElement=m;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(s,e,...n){const t=document.createElement(s);return typeof e=="string"?t.append(i(e)):Array.isArray(e)?t.append(...e):(Object.assign(t,e),Object.assign(t.style,e?.style)),n.length&&t.append(...n),t}function i(s){return document.createTextNode(s)}function a(){return i(" ")}async function d(){return new Promise(s=>{document.readyState=="loading"?document.addEventListener("DOMContentLoaded",()=>s(),{once:!0}):s()})}class h{#e={};on(e,n){const t=this.#e[e];return t?t.push(n):this.#e[e]=[n],this}addListener(e,n){return this.on(e,n)}once(e,n){const t=(...o)=>{this.off(e,t),n(...o)};return this.on(e,t),this}emit(e,...n){const t=this.#e[e]||[];for(let o=0;o<t.length;o++)t[o](...n);return!!t.length}off(e,n){return this.#e[e]&&(this.#e[e]=this.#e[e].filter(t=>t!==n)),this}removeListener(e,n){return this.off(e,n)}removeAllListeners(e){return e?delete this.#e[e]:this.#e={},this}eventNames(){return Reflect.ownKeys(this.#e)}listeners(e){return this.#e[e]??[]}listenerCount(e){return this.#e[e]?.length??0}}class p extends h{constructor(){super();const{history:e,location:n}=window,{pushState:t,replaceState:o}=e;e.pushState=(...r)=>{t.apply(e,r),this.emit("pushState",n,r[0])},e.replaceState=(...r)=>{o.apply(e,r),this.emit("replaceState",n,r[0])},window.addEventListener("popstate",r=>{this.emit("popState",n,r)})}}function c(s,e,n){const t=new MutationObserver((o,r)=>{for(const u of o)e(u,r)});return t.observe(s,{childList:!0,subtree:!0,...n}),()=>t.disconnect()}function m(s,e=document.documentElement){return new Promise(n=>{c(e,(t,o)=>{const r=e.querySelector(s);r&&(o.disconnect(),n(r))})})}exports.LocationObserver=p;exports.domReady=d;exports.el=l;exports.nbsp=a;exports.observeElement=c;exports.text=i;exports.waitElement=m;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Children | Attributes<T>,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\nexport function text(str: string): Text {\n  return document.createTextNode(str)\n}\n\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n\nexport function isDisabled(element: HTMLElement): boolean {\n  return (\n    Boolean(element.getAttribute('disabled')) === true ||\n    Boolean(element.getAttribute('aria-disabled')) === true\n  )\n}\n","class n {\n  #t = {};\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  listeners(t) {\n    return this.#t[t];\n  }\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    function resolveElement() {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        resolve(el)\n      }\n    }\n\n    observeElement(target, (_, observer) => {\n      resolveElement()\n      observer.disconnect()\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","str","nbsp","domReady","resolve","isDisabled","element","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","resolveElement","_"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\n/**\n * Create an element\n * @param tag The tag name of the element to create\n * @param attributes The attributes or children to set on the element\n * @param children The children to append to the element\n * @returns The created element\n * @example\n * el('div', { id: 'foo' }, 'Hello world')\n * el('div', 'Hello world')\n * el('div', [el('span', 'Hello'), el('span', 'world')])\n * el('div', el('span', 'Hello world'))\n * el('div', el('span', 'Hello'), el('span', 'world'))\n * el('div', el('span', 'Hello world'), 'world')\n */\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Attributes<T> | Children,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\n/**\n * Create a text node\n * @param text The string to create a text node from\n */\nexport function text(text: string): Text {\n  return document.createTextNode(text)\n}\n\n/**\n * A non-breaking space\n */\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\n/**\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/DOMContentLoaded_event\n * @returns A promise that resolves when the DOM is ready\n */\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n","class n {\n  #t = {};\n  /**\n   * Add an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  /**\n   * Alias for `addListener`\n   */\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  /**\n   * Add an event listener that will be called only once\n   * @note The listener is wrapped in a wrapper function, so it cannot be equal to the original listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  /**\n   * Emit an event\n   * @param event The event name\n   * @param args The arguments to pass to the listeners\n   * @returns `true` if the event had listeners, `false` otherwise\n   */\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  /**\n   * Remove an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  /**\n   * Alias for `off`\n   */\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  /**\n   * Remove all event listeners\n   * @param event The event name\n   * @returns The emitter\n   */\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  /**\n   * Get the list of event names\n   * @returns An array of event names\n   */\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  /**\n   * Get the list of listeners for an event\n   * @param event The event name\n   * @returns An array of listeners\n   */\n  listeners(t) {\n    return this.#t[t] ?? [];\n  }\n  /**\n   * Get the number of listeners for an event\n   * @param event The event name\n   * @returns The number of listeners for the event\n   */\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\n/**\n * Observe changes to the location\n * @example\n * const observer = new LocationObserver<{ id: string }>()\n * observer.on('pushState', (location, state) => {\n *   console.log(state.id)\n * })\n */\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\n/**\n * Observe mutations on an element\n * @param el The element to observe\n * @param callback The callback to call when a mutation occurs\n * @param options The options to pass to the `MutationObserver`\n * @returns A function to disconnect the observer\n */\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\n/**\n * Wait for an element to appear in the DOM\n * @param selector The selector to wait for\n * @param target The element to search in\n * @returns A promise that resolves when the element is found\n */\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    observeElement(target, (_, observer) => {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        observer.disconnect()\n        resolve(el)\n      }\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","nbsp","domReady","resolve","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","_"],"mappings":"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"}

package/dist/index.es.js

@@ -5,55 +5,102 @@ function a(s, e, ...n) {
 function i(s) {
   return document.createTextNode(s);
 }
-function d() {
+function h() {
   return i(" ");
 }
-async function h() {
+async function d() {
   return new Promise((s) => {
     document.readyState == "loading" ? document.addEventListener("DOMContentLoaded", () => s(), {
       once: !0
     }) : s();
   });
 }
-function f(s) {
-  return !!s.getAttribute("disabled") || !!s.getAttribute("aria-disabled");
-}
 class u {
   #e = {};
+  /**
+   * Add an event listener
+   * @param event The event name
+   * @param listener The listener function
+   * @returns The emitter
+   */
   on(e, n) {
     const t = this.#e[e];
     return t ? t.push(n) : this.#e[e] = [n], this;
   }
+  /**
+   * Alias for `addListener`
+   */
   addListener(e, n) {
     return this.on(e, n);
   }
+  /**
+   * Add an event listener that will be called only once
+   * @note The listener is wrapped in a wrapper function, so it cannot be equal to the original listener
+   * @param event The event name
+   * @param listener The listener function
+   * @returns The emitter
+   */
   once(e, n) {
-    const t = (...r) => {
-      this.off(e, t), n(...r);
+    const t = (...o) => {
+      this.off(e, t), n(...o);
     };
     return this.on(e, t), this;
   }
+  /**
+   * Emit an event
+   * @param event The event name
+   * @param args The arguments to pass to the listeners
+   * @returns `true` if the event had listeners, `false` otherwise
+   */
   emit(e, ...n) {
     const t = this.#e[e] || [];
-    for (let r = 0; r < t.length; r++)
-      t[r](...n);
+    for (let o = 0; o < t.length; o++)
+      t[o](...n);
     return !!t.length;
   }
+  /**
+   * Remove an event listener
+   * @param event The event name
+   * @param listener The listener function
+   * @returns The emitter
+   */
   off(e, n) {
     return this.#e[e] && (this.#e[e] = this.#e[e].filter((t) => t !== n)), this;
   }
+  /**
+   * Alias for `off`
+   */
   removeListener(e, n) {
     return this.off(e, n);
   }
+  /**
+   * Remove all event listeners
+   * @param event The event name
+   * @returns The emitter
+   */
   removeAllListeners(e) {
     return e ? delete this.#e[e] : this.#e = {}, this;
   }
+  /**
+   * Get the list of event names
+   * @returns An array of event names
+   */
   eventNames() {
     return Reflect.ownKeys(this.#e);
   }
+  /**
+   * Get the list of listeners for an event
+   * @param event The event name
+   * @returns An array of listeners
+   */
   listeners(e) {
-    return this.#e[e];
+    return this.#e[e] ?? [];
   }
+  /**
+   * Get the number of listeners for an event
+   * @param event The event name
+   * @returns The number of listeners for the event
+   */
   listenerCount(e) {
     return this.#e[e]?.length ?? 0;
   }
@@ -61,20 +108,20 @@ class u {
 class p extends u {
   constructor() {
     super();
-    const { history: e, location: n } = window, { pushState: t, replaceState: r } = e;
-    e.pushState = (...o) => {
-      t.apply(e, o), this.emit("pushState", n, o[0]);
-    }, e.replaceState = (...o) => {
-      r.apply(e, o), this.emit("replaceState", n, o[0]);
-    }, window.addEventListener("popstate", (o) => {
-      this.emit("popState", n, o);
+    const { history: e, location: n } = window, { pushState: t, replaceState: o } = e;
+    e.pushState = (...r) => {
+      t.apply(e, r), this.emit("pushState", n, r[0]);
+    }, e.replaceState = (...r) => {
+      o.apply(e, r), this.emit("replaceState", n, r[0]);
+    }, window.addEventListener("popstate", (r) => {
+      this.emit("popState", n, r);
     });
   }
 }
 function l(s, e, n) {
-  const t = new MutationObserver((r, o) => {
-    for (const c of r)
-      e(c, o);
+  const t = new MutationObserver((o, r) => {
+    for (const c of o)
+      e(c, r);
   });
   return t.observe(s, {
     childList: !0,
@@ -82,25 +129,21 @@ function l(s, e, n) {
     ...n
   }), () => t.disconnect();
 }
-function m(s, e = document.documentElement) {
+function f(s, e = document.documentElement) {
   return new Promise((n) => {
-    function t() {
+    l(e, (t, o) => {
       const r = e.querySelector(s);
-      r && n(r);
-    }
-    l(e, (r, o) => {
-      t(), o.disconnect();
+      r && (o.disconnect(), n(r));
     });
   });
 }
 export {
   p as LocationObserver,
-  h as domReady,
+  d as domReady,
   a as el,
-  f as isDisabled,
-  d as nbsp,
+  h as nbsp,
   l as observeElement,
   i as text,
-  m as waitElement
+  f as waitElement
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Children | Attributes<T>,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\nexport function text(str: string): Text {\n  return document.createTextNode(str)\n}\n\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n\nexport function isDisabled(element: HTMLElement): boolean {\n  return (\n    Boolean(element.getAttribute('disabled')) === true ||\n    Boolean(element.getAttribute('aria-disabled')) === true\n  )\n}\n","class n {\n  #t = {};\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  listeners(t) {\n    return this.#t[t];\n  }\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    function resolveElement() {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        resolve(el)\n      }\n    }\n\n    observeElement(target, (_, observer) => {\n      resolveElement()\n      observer.disconnect()\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","str","nbsp","domReady","resolve","isDisabled","element","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","resolveElement","_"],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\n/**\n * Create an element\n * @param tag The tag name of the element to create\n * @param attributes The attributes or children to set on the element\n * @param children The children to append to the element\n * @returns The created element\n * @example\n * el('div', { id: 'foo' }, 'Hello world')\n * el('div', 'Hello world')\n * el('div', [el('span', 'Hello'), el('span', 'world')])\n * el('div', el('span', 'Hello world'))\n * el('div', el('span', 'Hello'), el('span', 'world'))\n * el('div', el('span', 'Hello world'), 'world')\n */\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Attributes<T> | Children,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\n/**\n * Create a text node\n * @param text The string to create a text node from\n */\nexport function text(text: string): Text {\n  return document.createTextNode(text)\n}\n\n/**\n * A non-breaking space\n */\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\n/**\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/DOMContentLoaded_event\n * @returns A promise that resolves when the DOM is ready\n */\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n","class n {\n  #t = {};\n  /**\n   * Add an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  /**\n   * Alias for `addListener`\n   */\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  /**\n   * Add an event listener that will be called only once\n   * @note The listener is wrapped in a wrapper function, so it cannot be equal to the original listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  /**\n   * Emit an event\n   * @param event The event name\n   * @param args The arguments to pass to the listeners\n   * @returns `true` if the event had listeners, `false` otherwise\n   */\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  /**\n   * Remove an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  /**\n   * Alias for `off`\n   */\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  /**\n   * Remove all event listeners\n   * @param event The event name\n   * @returns The emitter\n   */\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  /**\n   * Get the list of event names\n   * @returns An array of event names\n   */\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  /**\n   * Get the list of listeners for an event\n   * @param event The event name\n   * @returns An array of listeners\n   */\n  listeners(t) {\n    return this.#t[t] ?? [];\n  }\n  /**\n   * Get the number of listeners for an event\n   * @param event The event name\n   * @returns The number of listeners for the event\n   */\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\n/**\n * Observe changes to the location\n * @example\n * const observer = new LocationObserver<{ id: string }>()\n * observer.on('pushState', (location, state) => {\n *   console.log(state.id)\n * })\n */\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\n/**\n * Observe mutations on an element\n * @param el The element to observe\n * @param callback The callback to call when a mutation occurs\n * @param options The options to pass to the `MutationObserver`\n * @returns A function to disconnect the observer\n */\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\n/**\n * Wait for an element to appear in the DOM\n * @param selector The selector to wait for\n * @param target The element to search in\n * @returns A promise that resolves when the element is found\n */\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    observeElement(target, (_, observer) => {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        observer.disconnect()\n        resolve(el)\n      }\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","nbsp","domReady","resolve","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","_"],"mappings":"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"}

package/dist/index.umd.js

@@ -1,2 +1,2 @@
-(function(s,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(s=typeof globalThis<"u"?globalThis:s||self,u(s["@zero-dependency/dom"]={}))})(this,function(s){"use strict";function u(i,e,...n){const t=document.createElement(i);return typeof e=="string"?t.append(c(e)):Array.isArray(e)?t.append(...e):(Object.assign(t,e),Object.assign(t.style,e?.style)),n.length&&t.append(...n),t}function c(i){return document.createTextNode(i)}function l(){return c(" ")}async function a(){return new Promise(i=>{document.readyState=="loading"?document.addEventListener("DOMContentLoaded",()=>i(),{once:!0}):i()})}function f(i){return!!i.getAttribute("disabled")||!!i.getAttribute("aria-disabled")}class h{#e={};on(e,n){const t=this.#e[e];return t?t.push(n):this.#e[e]=[n],this}addListener(e,n){return this.on(e,n)}once(e,n){const t=(...o)=>{this.off(e,t),n(...o)};return this.on(e,t),this}emit(e,...n){const t=this.#e[e]||[];for(let o=0;o<t.length;o++)t[o](...n);return!!t.length}off(e,n){return this.#e[e]&&(this.#e[e]=this.#e[e].filter(t=>t!==n)),this}removeListener(e,n){return this.off(e,n)}removeAllListeners(e){return e?delete this.#e[e]:this.#e={},this}eventNames(){return Reflect.ownKeys(this.#e)}listeners(e){return this.#e[e]}listenerCount(e){return this.#e[e]?.length??0}}class m extends h{constructor(){super();const{history:e,location:n}=window,{pushState:t,replaceState:o}=e;e.pushState=(...r)=>{t.apply(e,r),this.emit("pushState",n,r[0])},e.replaceState=(...r)=>{o.apply(e,r),this.emit("replaceState",n,r[0])},window.addEventListener("popstate",r=>{this.emit("popState",n,r)})}}function d(i,e,n){const t=new MutationObserver((o,r)=>{for(const y of o)e(y,r)});return t.observe(i,{childList:!0,subtree:!0,...n}),()=>t.disconnect()}function p(i,e=document.documentElement){return new Promise(n=>{function t(){const o=e.querySelector(i);o&&n(o)}d(e,(o,r)=>{t(),r.disconnect()})})}s.LocationObserver=m,s.domReady=a,s.el=u,s.isDisabled=f,s.nbsp=l,s.observeElement=d,s.text=c,s.waitElement=p,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+(function(s,c){typeof exports=="object"&&typeof module<"u"?c(exports):typeof define=="function"&&define.amd?define(["exports"],c):(s=typeof globalThis<"u"?globalThis:s||self,c(s["@zero-dependency/dom"]={}))})(this,function(s){"use strict";function c(i,e,...n){const t=document.createElement(i);return typeof e=="string"?t.append(u(e)):Array.isArray(e)?t.append(...e):(Object.assign(t,e),Object.assign(t.style,e?.style)),n.length&&t.append(...n),t}function u(i){return document.createTextNode(i)}function l(){return u(" ")}async function a(){return new Promise(i=>{document.readyState=="loading"?document.addEventListener("DOMContentLoaded",()=>i(),{once:!0}):i()})}class f{#e={};on(e,n){const t=this.#e[e];return t?t.push(n):this.#e[e]=[n],this}addListener(e,n){return this.on(e,n)}once(e,n){const t=(...r)=>{this.off(e,t),n(...r)};return this.on(e,t),this}emit(e,...n){const t=this.#e[e]||[];for(let r=0;r<t.length;r++)t[r](...n);return!!t.length}off(e,n){return this.#e[e]&&(this.#e[e]=this.#e[e].filter(t=>t!==n)),this}removeListener(e,n){return this.off(e,n)}removeAllListeners(e){return e?delete this.#e[e]:this.#e={},this}eventNames(){return Reflect.ownKeys(this.#e)}listeners(e){return this.#e[e]??[]}listenerCount(e){return this.#e[e]?.length??0}}class h extends f{constructor(){super();const{history:e,location:n}=window,{pushState:t,replaceState:r}=e;e.pushState=(...o)=>{t.apply(e,o),this.emit("pushState",n,o[0])},e.replaceState=(...o)=>{r.apply(e,o),this.emit("replaceState",n,o[0])},window.addEventListener("popstate",o=>{this.emit("popState",n,o)})}}function d(i,e,n){const t=new MutationObserver((r,o)=>{for(const p of r)e(p,o)});return t.observe(i,{childList:!0,subtree:!0,...n}),()=>t.disconnect()}function m(i,e=document.documentElement){return new Promise(n=>{d(e,(t,r)=>{const o=e.querySelector(i);o&&(r.disconnect(),n(o))})})}s.LocationObserver=h,s.domReady=a,s.el=c,s.nbsp=l,s.observeElement=d,s.text=u,s.waitElement=m,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Children | Attributes<T>,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\nexport function text(str: string): Text {\n  return document.createTextNode(str)\n}\n\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n\nexport function isDisabled(element: HTMLElement): boolean {\n  return (\n    Boolean(element.getAttribute('disabled')) === true ||\n    Boolean(element.getAttribute('aria-disabled')) === true\n  )\n}\n","class n {\n  #t = {};\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  listeners(t) {\n    return this.#t[t];\n  }\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    function resolveElement() {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        resolve(el)\n      }\n    }\n\n    observeElement(target, (_, observer) => {\n      resolveElement()\n      observer.disconnect()\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","str","nbsp","domReady","resolve","isDisabled","element","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","resolveElement","_"],"mappings":"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"}
+{"version":3,"file":"index.umd.js","sources":["../src/html.ts","../../emitter/dist/index.es.js","../src/location-observer.ts","../src/mutation-observers.ts"],"sourcesContent":["// prettier-ignore\ntype Attributes<T extends keyof HTMLElementTagNameMap> = Partial<{\n  style: Partial<CSSStyleDeclaration>\n} & Omit<HTMLElementTagNameMap[T], 'style'>>\n\ntype Children = (string | Node | HTMLElement)[]\n\n/**\n * Create an element\n * @param tag The tag name of the element to create\n * @param attributes The attributes or children to set on the element\n * @param children The children to append to the element\n * @returns The created element\n * @example\n * el('div', { id: 'foo' }, 'Hello world')\n * el('div', 'Hello world')\n * el('div', [el('span', 'Hello'), el('span', 'world')])\n * el('div', el('span', 'Hello world'))\n * el('div', el('span', 'Hello'), el('span', 'world'))\n * el('div', el('span', 'Hello world'), 'world')\n */\nexport function el<T extends keyof HTMLElementTagNameMap>(\n  tag: T,\n  attributes?: Attributes<T> | Children,\n  ...children: Children\n): HTMLElementTagNameMap[T] {\n  const el = document.createElement(tag)\n\n  if (typeof attributes === 'string') {\n    el.append(text(attributes))\n  } else if (Array.isArray(attributes)) {\n    el.append(...attributes)\n  } else {\n    Object.assign(el, attributes)\n    Object.assign(el.style, attributes?.style)\n  }\n\n  if (children.length) {\n    el.append(...children)\n  }\n\n  return el\n}\n\n/**\n * Create a text node\n * @param text The string to create a text node from\n */\nexport function text(text: string): Text {\n  return document.createTextNode(text)\n}\n\n/**\n * A non-breaking space\n */\nexport function nbsp(): Text {\n  return text('\\u00a0')\n}\n\n/**\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/DOMContentLoaded_event\n * @returns A promise that resolves when the DOM is ready\n */\nexport async function domReady(): Promise<void> {\n  return new Promise((resolve) => {\n    if (document.readyState == 'loading') {\n      document.addEventListener('DOMContentLoaded', () => resolve(), {\n        once: true\n      })\n    } else {\n      resolve()\n    }\n  })\n}\n","class n {\n  #t = {};\n  /**\n   * Add an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  on(t, e) {\n    const s = this.#t[t];\n    return s ? s.push(e) : this.#t[t] = [e], this;\n  }\n  /**\n   * Alias for `addListener`\n   */\n  addListener(t, e) {\n    return this.on(t, e);\n  }\n  /**\n   * Add an event listener that will be called only once\n   * @note The listener is wrapped in a wrapper function, so it cannot be equal to the original listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  once(t, e) {\n    const s = (...i) => {\n      this.off(t, s), e(...i);\n    };\n    return this.on(t, s), this;\n  }\n  /**\n   * Emit an event\n   * @param event The event name\n   * @param args The arguments to pass to the listeners\n   * @returns `true` if the event had listeners, `false` otherwise\n   */\n  emit(t, ...e) {\n    const s = this.#t[t] || [];\n    for (let i = 0; i < s.length; i++)\n      s[i](...e);\n    return !!s.length;\n  }\n  /**\n   * Remove an event listener\n   * @param event The event name\n   * @param listener The listener function\n   * @returns The emitter\n   */\n  off(t, e) {\n    return this.#t[t] && (this.#t[t] = this.#t[t].filter((s) => s !== e)), this;\n  }\n  /**\n   * Alias for `off`\n   */\n  removeListener(t, e) {\n    return this.off(t, e);\n  }\n  /**\n   * Remove all event listeners\n   * @param event The event name\n   * @returns The emitter\n   */\n  removeAllListeners(t) {\n    return t ? delete this.#t[t] : this.#t = {}, this;\n  }\n  /**\n   * Get the list of event names\n   * @returns An array of event names\n   */\n  eventNames() {\n    return Reflect.ownKeys(this.#t);\n  }\n  /**\n   * Get the list of listeners for an event\n   * @param event The event name\n   * @returns An array of listeners\n   */\n  listeners(t) {\n    return this.#t[t] ?? [];\n  }\n  /**\n   * Get the number of listeners for an event\n   * @param event The event name\n   * @returns The number of listeners for the event\n   */\n  listenerCount(t) {\n    return this.#t[t]?.length ?? 0;\n  }\n}\nexport {\n  n as Emitter\n};\n//# sourceMappingURL=index.es.js.map\n","import { Emitter } from '@zero-dependency/emitter'\n\ntype LocationCallback<T = any> = (location: Location, args: T) => void\n\ntype Events<T> = {\n  pushState: LocationCallback<T>\n  replaceState: LocationCallback<T>\n  popState: LocationCallback<\n    Omit<PopStateEvent, 'state'> & { readonly state: T }\n  >\n}\n\n/**\n * Observe changes to the location\n * @example\n * const observer = new LocationObserver<{ id: string }>()\n * observer.on('pushState', (location, state) => {\n *   console.log(state.id)\n * })\n */\nexport class LocationObserver<T> extends Emitter<Events<T>> {\n  constructor() {\n    super()\n\n    const { history, location } = window\n    const { pushState, replaceState } = history\n\n    history.pushState = (...args) => {\n      pushState.apply(history, args)\n      this.emit('pushState', location, args[0])\n    }\n\n    history.replaceState = (...args) => {\n      replaceState.apply(history, args)\n      this.emit('replaceState', location, args[0])\n    }\n\n    window.addEventListener('popstate', (event) => {\n      this.emit('popState', location, event)\n    })\n  }\n}\n","type Disconnect = () => void\n\n/**\n * Observe mutations on an element\n * @param el The element to observe\n * @param callback The callback to call when a mutation occurs\n * @param options The options to pass to the `MutationObserver`\n * @returns A function to disconnect the observer\n */\nexport function observeElement<T extends Element = Element>(\n  el: T,\n  callback: (mutation: MutationRecord, observer: MutationObserver) => void,\n  options?: MutationObserverInit\n): Disconnect {\n  const observe = new MutationObserver((mutations, observer) => {\n    for (const mutation of mutations) {\n      callback(mutation, observer)\n    }\n  })\n\n  observe.observe(el, {\n    childList: true,\n    subtree: true,\n    ...options\n  })\n\n  return () => observe.disconnect()\n}\n\n/**\n * Wait for an element to appear in the DOM\n * @param selector The selector to wait for\n * @param target The element to search in\n * @returns A promise that resolves when the element is found\n */\nexport function waitElement<T extends Element = Element>(\n  selector: string,\n  target = document.documentElement\n): Promise<T> {\n  return new Promise((resolve) => {\n    observeElement(target, (_, observer) => {\n      const el = target.querySelector<T>(selector)\n      if (el) {\n        observer.disconnect()\n        resolve(el)\n      }\n    })\n  })\n}\n"],"names":["el","tag","attributes","children","text","nbsp","domReady","resolve","n","#t","t","e","s","i","LocationObserver","Emitter","history","location","pushState","replaceState","args","event","observeElement","callback","options","observe","mutations","observer","mutation","waitElement","selector","target","_"],"mappings":"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"}

package/dist/location-observer.d.ts

@@ -7,6 +7,14 @@ type Events<T> = {
         readonly state: T;
     }>;
 };
+/**
+ * Observe changes to the location
+ * @example
+ * const observer = new LocationObserver<{ id: string }>()
+ * observer.on('pushState', (location, state) => {
+ *   console.log(state.id)
+ * })
+ */
 export declare class LocationObserver<T> extends Emitter<Events<T>> {
     constructor();
 }

package/dist/mutation-observers.d.ts

@@ -1,4 +1,17 @@
 type Disconnect = () => void;
+/**
+ * Observe mutations on an element
+ * @param el The element to observe
+ * @param callback The callback to call when a mutation occurs
+ * @param options The options to pass to the `MutationObserver`
+ * @returns A function to disconnect the observer
+ */
 export declare function observeElement<T extends Element = Element>(el: T, callback: (mutation: MutationRecord, observer: MutationObserver) => void, options?: MutationObserverInit): Disconnect;
+/**
+ * Wait for an element to appear in the DOM
+ * @param selector The selector to wait for
+ * @param target The element to search in
+ * @returns A promise that resolves when the element is found
+ */
 export declare function waitElement<T extends Element = Element>(selector: string, target?: HTMLElement): Promise<T>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zero-dependency/dom",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "type": "module",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.umd.js",
@@ -34,7 +34,7 @@
     "vitest": "^0.29.8"
   },
   "dependencies": {
-    "@zero-dependency/emitter": "1.1.3"
+    "@zero-dependency/emitter": "1.1.4"
   },
   "scripts": {
     "dev": "vite build --watch",