ts-dom-utils 1.0.1 → 2.0.0

package/README.md

@@ -3,6 +3,19 @@ A lightweight TypeScript library that provides simple wrappers around common DOM
 It allows you to write less code.
 Although it's written in TypeScript, it can also be used in JavaScript projects.
 
+## Table of Contents
+
+
+- [Installation](#installation)
+- [Features](#features)
+- [Functions](#functions)
+    - [createElement](#createelement)
+    - [DOMisReady](#domisready)
+    - [qs](#qs)
+    - [qsa](#qsa)
+- [How to Contribute](#how-to-contribute)
+- [Support This Project](#support-this-project)
+
 ## Installation
 
 ```shell
@@ -16,6 +29,7 @@ yarn add ts-dom-utils
 - Strong TypeScript typings for better editor autocompletion and error checking.
 - Compatible with both TypeScript and JavaScript projects.
 - Simple and intuitive API.
+- Tree-shakeable
 
 
 ## Functions
@@ -29,15 +43,16 @@ import { createElement } from 'ts-dom-utils';
 
 const button = createElement('button', {
   id: 'my-button',
-  'aria-expandended': 'false',
   class: ['btn', 'btn-primary'],
   text: 'Click me',
   dataset: {
-    action: 'open-modal',
+    action: 'open-menu',
   },
+  'aria-expandended': 'false',
 });
 
 document.body.appendChild(button);
+// <button id="my-button" class="btn btn-primary" data-action="open-menu" aria-expandended="false">Click me</button>
 ```
 
 | Param   | Default   | Description                                                                                                                                                                                    |
@@ -47,6 +62,34 @@ document.body.appendChild(button);
 | target  | document  | The Document in which to create the element.                                                                                                                                                   |
 ---
 
+## `DOMisReady`
+`DOMisReady` is a function that returns a Promise. This Promise resolves when the provided DOM is ready, i.e., when the document's readyState is not 'loading'. This can be used to delay script execution until the DOM is fully constructed and can be safely manipulated.
+```typescript
+import { DOMisReady, qs } from 'ts-dom-utils';
+
+// using then
+DOMisReady().then(() => {
+  // DOM manipulation code here
+});
+
+// using async/await
+(async function() {
+  await DOMisReady();
+  // DOM manipulation code here
+})();
+
+// checking if an iframe's document is ready
+const iframe = qs<HTMLIFrameElement>('iframe');
+DOMisReady(iframe.contentDocument).then(() => {
+  // iframe DOM manipulation code here
+});
+
+```
+| Param | Default   | Description             |
+|-------|-----------|-------------------------|
+| doc   | document  | The Document to check.  |
+---
+
 ### `qs`
 A wrapper function for `document.querySelector`.
 
@@ -54,8 +97,8 @@ Example
 ```typescript
 import { qs } from 'ts-dom-utils';
 
-const wrapper = qs<HTMLDivElement>('.footer > .buttons');
-const button = qs<HTMLButtonElement>('button', wrapper);
+const container = qs<HTMLDivElement>('.footer > .buttons');
+const button = qs<HTMLButtonElement>('button', container);
 ```
 | Param    | Default    | Description                                         |
 |----------|------------|-----------------------------------------------------|
@@ -72,9 +115,20 @@ Example
 import { qsa } from 'ts-dom-utils';
 
 const buttons = qsa<HTMLButtonElement>('.btn');
+
+const menu = qs<HTMLDivElement>('.menu');
+const menuButtons = qsa<HTMLButtonElement>('.btn', menu);
 ```
 
 | Param    | Default   | Description                                         |
 |----------|-----------|-----------------------------------------------------|
 | selector | undefined | The selector to match against.                      |
 | parent   | document  | The ParentNode in which to search for the selector. |
+
+## How to Contribute
+
+We welcome any contributions! If you have an idea for a new feature or tool, please feel free to open an issue to discuss it. You can also submit a pull request if you've developed a feature or fix that you'd like to contribute back.
+
+### Support This Project
+
+This project is developed and maintained by a single developer. If you find it useful and would like to support its continued development, you can do so through [GitHub Sponsors](https://github.com/rafaucau/ts-dom-utils?sponsor=1). Any amount is appreciated!

package/dist/DOMisReady.cjs

@@ -0,0 +1 @@
+"use strict";var r=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var s=(t,e)=>{for(var d in e)r(t,d,{get:e[d],enumerable:!0})},f=(t,e,d,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of u(e))!m.call(t,n)&&n!==d&&r(t,n,{get:()=>e[n],enumerable:!(i=a(e,n))||i.enumerable});return t};var D=t=>f(r({},"__esModule",{value:!0}),t);var c={};s(c,{default:()=>o});module.exports=D(c);function o(t=document){return new Promise(e=>{if(t.readyState!=="loading")return e();t.addEventListener("DOMContentLoaded",()=>e())})}

package/dist/DOMisReady.d.cts

@@ -0,0 +1,33 @@
+/**
+ * This Promise resolves when the provided DOM is ready.
+ * This can be used to delay script execution until the DOM is fully constructed and can be safely manipulated.
+ *
+ * @param doc - The Document object to check for readiness.
+ * Defaults to the global document.
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * // using then
+ * DOMisReady().then(() => {
+ *   // DOM manipulation code here
+ * });
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * // using async/await
+ * (async function() {
+ *   await DOMisReady();
+ *   // DOM manipulation code here
+ * })();
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * const iframe = document.querySelector('iframe');
+ * // check if the iframe's document is ready
+ * DOMisReady(iframe.contentDocument).then(() => {
+ *   // iframe DOM manipulation code here
+ * });
+ */
+declare function DOMisReady(doc?: Document): Promise<void>;
+
+export { DOMisReady as default };

package/dist/DOMisReady.d.ts

@@ -0,0 +1,33 @@
+/**
+ * This Promise resolves when the provided DOM is ready.
+ * This can be used to delay script execution until the DOM is fully constructed and can be safely manipulated.
+ *
+ * @param doc - The Document object to check for readiness.
+ * Defaults to the global document.
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * // using then
+ * DOMisReady().then(() => {
+ *   // DOM manipulation code here
+ * });
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * // using async/await
+ * (async function() {
+ *   await DOMisReady();
+ *   // DOM manipulation code here
+ * })();
+ *
+ * @example
+ * import { DOMisReady } from 'ts-dom-utils';
+ * const iframe = document.querySelector('iframe');
+ * // check if the iframe's document is ready
+ * DOMisReady(iframe.contentDocument).then(() => {
+ *   // iframe DOM manipulation code here
+ * });
+ */
+declare function DOMisReady(doc?: Document): Promise<void>;
+
+export { DOMisReady as default };

package/dist/DOMisReady.js

@@ -0,0 +1 @@
+import{a}from"./chunk-QYTVIVCC.js";export{a as default};

package/dist/chunk-22TR3O4D.js

@@ -0,0 +1 @@
+function n(e,t=document){return t.querySelectorAll(e)}export{n as a};

package/dist/chunk-AR3IDUAF.js

@@ -0,0 +1 @@
+function o(r,n={},a=document){let e=a.createElement(r);return Object.entries(n).forEach(([s,t])=>{if(s==="class"){Array.isArray(t)?e.classList.add(...t):e.classList.add(t);return}if(s==="dataset"&&typeof t=="object"&&t!==null){Object.entries(t).forEach(([i,c])=>{e.dataset[i]=c});return}if(s==="text"){e.textContent=t;return}e.setAttribute(s,t)}),e}export{o as a};

package/dist/chunk-QYTVIVCC.js

@@ -0,0 +1 @@
+function n(e=document){return new Promise(t=>{if(e.readyState!=="loading")return t();e.addEventListener("DOMContentLoaded",()=>t())})}export{n as a};

package/dist/chunk-YC4DGQBN.js

@@ -0,0 +1 @@
+function n(e,t=document){return t.querySelector(e)}export{n as a};

package/dist/createElement.cjs

@@ -1,52 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/createElement.ts
-var createElement_exports = {};
-__export(createElement_exports, {
-  default: () => createElement
-});
-module.exports = __toCommonJS(createElement_exports);
-function createElement(tagName, options = {}, target = document) {
-  const element = target.createElement(tagName);
-  Object.entries(options).forEach(([key, value]) => {
-    if (key === "class") {
-      if (Array.isArray(value)) {
-        element.classList.add(...value);
-      } else {
-        element.classList.add(value);
-      }
-      return;
-    }
-    if (key === "dataset" && typeof value === "object" && value !== null) {
-      Object.entries(value).forEach(
-        ([dataKey, dataValue]) => {
-          element.dataset[dataKey] = dataValue;
-        }
-      );
-      return;
-    }
-    if (key === "text") {
-      element.textContent = value;
-      return;
-    }
-    element.setAttribute(key, value);
-  });
-  return element;
-}
+"use strict";var i=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var l=(s,t)=>{for(var a in t)i(s,a,{get:t[a],enumerable:!0})},p=(s,t,a,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of f(t))!m.call(s,e)&&e!==a&&i(s,e,{get:()=>t[e],enumerable:!(r=d(t,e))||r.enumerable});return s};var E=s=>p(i({},"__esModule",{value:!0}),s);var x={};l(x,{default:()=>c});module.exports=E(x);function c(s,t={},a=document){let r=a.createElement(s);return Object.entries(t).forEach(([e,n])=>{if(e==="class"){Array.isArray(n)?r.classList.add(...n):r.classList.add(n);return}if(e==="dataset"&&typeof n=="object"&&n!==null){Object.entries(n).forEach(([o,g])=>{r.dataset[o]=g});return}if(e==="text"){r.textContent=n;return}r.setAttribute(e,n)}),r}

package/dist/createElement.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Create a new element with the provided options.
+ * @param tagName - The name of the element type to create.
+ * @param options - The options to use when creating the element.
+ * @param target - The Document in which to create the element. Defaults to the current document.
+ *
+ * @example
+ * import { createElement } from 'ts-dom-utils';
+ *
+ * const button = createElement('button', {
+ *   id: 'my-button',
+ *   class: ['btn', 'btn-primary'],
+ *   text: 'Click me',
+ *   dataset: {
+ *     action: 'open-menu',
+ *   },
+ *   'aria-expandended': 'false',
+ * });
+
+ * document.body.appendChild(button);
+ * // <button id="my-button" class="btn btn-primary" data-action="open-menu" aria-expandended="false">Click me</button>
+ */
+declare function createElement<K extends keyof HTMLElementTagNameMap>(tagName: K, options?: CreateElementOptions, target?: Document): HTMLElementTagNameMap[K];
+type CreateElementOptions = {
+    [key: string]: any;
+    class?: string | string[];
+    dataset?: Record<string, string>;
+    text?: string;
+};
+
+export { CreateElementOptions, createElement as default };

package/dist/createElement.d.ts

@@ -3,6 +3,22 @@
  * @param tagName - The name of the element type to create.
  * @param options - The options to use when creating the element.
  * @param target - The Document in which to create the element. Defaults to the current document.
+ *
+ * @example
+ * import { createElement } from 'ts-dom-utils';
+ *
+ * const button = createElement('button', {
+ *   id: 'my-button',
+ *   class: ['btn', 'btn-primary'],
+ *   text: 'Click me',
+ *   dataset: {
+ *     action: 'open-menu',
+ *   },
+ *   'aria-expandended': 'false',
+ * });
+
+ * document.body.appendChild(button);
+ * // <button id="my-button" class="btn btn-primary" data-action="open-menu" aria-expandended="false">Click me</button>
  */
 declare function createElement<K extends keyof HTMLElementTagNameMap>(tagName: K, options?: CreateElementOptions, target?: Document): HTMLElementTagNameMap[K];
 type CreateElementOptions = {

package/dist/createElement.js

@@ -1,6 +1 @@
-import {
-  createElement
-} from "./chunk-2CYKZHHS.js";
-export {
-  createElement as default
-};
+import{a}from"./chunk-AR3IDUAF.js";export{a as default};

package/dist/index.cjs

@@ -1,72 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  createElement: () => createElement,
-  qs: () => qs,
-  qsa: () => qsa
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/createElement.ts
-function createElement(tagName, options = {}, target = document) {
-  const element = target.createElement(tagName);
-  Object.entries(options).forEach(([key, value]) => {
-    if (key === "class") {
-      if (Array.isArray(value)) {
-        element.classList.add(...value);
-      } else {
-        element.classList.add(value);
-      }
-      return;
-    }
-    if (key === "dataset" && typeof value === "object" && value !== null) {
-      Object.entries(value).forEach(
-        ([dataKey, dataValue]) => {
-          element.dataset[dataKey] = dataValue;
-        }
-      );
-      return;
-    }
-    if (key === "text") {
-      element.textContent = value;
-      return;
-    }
-    element.setAttribute(key, value);
-  });
-  return element;
-}
-
-// src/qs.ts
-function qs(selector, parent = document) {
-  return parent.querySelector(selector);
-}
-
-// src/qsa.ts
-function qsa(selector, parent = document) {
-  return parent.querySelectorAll(selector);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createElement,
-  qs,
-  qsa
-});
+"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(t,e)=>{for(var a in e)o(t,a,{get:e[a],enumerable:!0})},x=(t,e,a,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of E(e))!g.call(t,r)&&r!==a&&o(t,r,{get:()=>e[r],enumerable:!(n=u(e,r))||n.enumerable});return t};var y=t=>x(o({},"__esModule",{value:!0}),t);var O={};p(O,{DOMisReady:()=>d,createElement:()=>i,qs:()=>f,qsa:()=>c});module.exports=y(O);function i(t,e={},a=document){let n=a.createElement(t);return Object.entries(e).forEach(([r,s])=>{if(r==="class"){Array.isArray(s)?n.classList.add(...s):n.classList.add(s);return}if(r==="dataset"&&typeof s=="object"&&s!==null){Object.entries(s).forEach(([l,m])=>{n.dataset[l]=m});return}if(r==="text"){n.textContent=s;return}n.setAttribute(r,s)}),n}function d(t=document){return new Promise(e=>{if(t.readyState!=="loading")return e();t.addEventListener("DOMContentLoaded",()=>e())})}function f(t,e=document){return e.querySelector(t)}function c(t,e=document){return e.querySelectorAll(t)}0&&(module.exports={DOMisReady,createElement,qs,qsa});

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export { default as createElement } from './createElement.cjs';
+export { default as DOMisReady } from './DOMisReady.cjs';
+export { default as qs } from './qs.cjs';
+export { default as qsa } from './qsa.cjs';

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { default as createElement } from './createElement.js';
+export { default as DOMisReady } from './DOMisReady.js';
 export { default as qs } from './qs.js';
 export { default as qsa } from './qsa.js';

package/dist/index.js

@@ -1,14 +1 @@
-import {
-  createElement
-} from "./chunk-2CYKZHHS.js";
-import {
-  qs
-} from "./chunk-QUWBOENH.js";
-import {
-  qsa
-} from "./chunk-MRTNZYZJ.js";
-export {
-  createElement,
-  qs,
-  qsa
-};
+import{a as e}from"./chunk-QYTVIVCC.js";import{a}from"./chunk-AR3IDUAF.js";import{a as t}from"./chunk-YC4DGQBN.js";import{a as r}from"./chunk-22TR3O4D.js";export{e as DOMisReady,a as createElement,t as qs,r as qsa};

package/dist/qs.cjs

@@ -1,28 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/qs.ts
-var qs_exports = {};
-__export(qs_exports, {
-  default: () => qs
-});
-module.exports = __toCommonJS(qs_exports);
-function qs(selector, parent = document) {
-  return parent.querySelector(selector);
-}
+"use strict";var o=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var E=(t,e)=>{for(var r in e)o(t,r,{get:e[r],enumerable:!0})},a=(t,e,r,u)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of l(e))!s.call(t,n)&&n!==r&&o(t,n,{get:()=>e[n],enumerable:!(u=c(e,n))||u.enumerable});return t};var f=t=>a(o({},"__esModule",{value:!0}),t);var i={};E(i,{default:()=>d});module.exports=f(i);function d(t,e=document){return e.querySelector(t)}

package/dist/qs.d.cts

@@ -0,0 +1,14 @@
+/**
+ * QuerySelector wrapper function.
+ * @param selector The selector to match against.
+ * @param parent The ParentNode in which to search for the selector.
+ * @returns The first Element within the document that matches the specified selector, or group of selectors.
+ *
+ * @example
+ * import { qs } from 'ts-dom-utils';
+ * const menu = qs<HTMLDivElement>('.menu');
+ * const menuButtons = qsa<HTMLButtonElement>('.btn', menu);
+ */
+declare function qs<E extends Element>(selector: string, parent?: ParentNode): E | null;
+
+export { qs as default };

package/dist/qs.d.ts

@@ -3,6 +3,11 @@
  * @param selector The selector to match against.
  * @param parent The ParentNode in which to search for the selector.
  * @returns The first Element within the document that matches the specified selector, or group of selectors.
+ *
+ * @example
+ * import { qs } from 'ts-dom-utils';
+ * const menu = qs<HTMLDivElement>('.menu');
+ * const menuButtons = qsa<HTMLButtonElement>('.btn', menu);
  */
 declare function qs<E extends Element>(selector: string, parent?: ParentNode): E | null;
 

package/dist/qs.js

@@ -1,6 +1 @@
-import {
-  qs
-} from "./chunk-QUWBOENH.js";
-export {
-  qs as default
-};
+import{a}from"./chunk-YC4DGQBN.js";export{a as default};

package/dist/qsa.cjs

@@ -1,28 +1 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/qsa.ts
-var qsa_exports = {};
-__export(qsa_exports, {
-  default: () => qsa
-});
-module.exports = __toCommonJS(qsa_exports);
-function qsa(selector, parent = document) {
-  return parent.querySelectorAll(selector);
-}
+"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var a=(t,e)=>{for(var r in e)o(t,r,{get:e[r],enumerable:!0})},c=(t,e,r,d)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of s(e))!E.call(t,n)&&n!==r&&o(t,n,{get:()=>e[n],enumerable:!(d=u(e,n))||d.enumerable});return t};var f=t=>c(o({},"__esModule",{value:!0}),t);var i={};a(i,{default:()=>l});module.exports=f(i);function l(t,e=document){return e.querySelectorAll(t)}

package/dist/qsa.d.cts

@@ -0,0 +1,17 @@
+/**
+ * QuerySelectorAll wrapper function.
+ * @param selector - The selector to match against.
+ * @param parent - The ParentNode in which to search for the selector. Defaults to the entire document.
+ *
+ * @example
+ * import { qsa } from 'ts-dom-utils';
+ * const buttons = qsa<HTMLButtonElement>('.btn');
+ *
+ * @example
+ * import { qsa } from 'ts-dom-utils';
+ * const menu = qs<HtmlNavElement>('.menu');
+ * const menuButtons = qsa<HTMLButtonElement>('.btn', menu);
+ */
+declare function qsa<E extends Element>(selector: string, parent?: ParentNode): NodeListOf<E>;
+
+export { qsa as default };

package/dist/qsa.d.ts

@@ -2,6 +2,15 @@
  * QuerySelectorAll wrapper function.
  * @param selector - The selector to match against.
  * @param parent - The ParentNode in which to search for the selector. Defaults to the entire document.
+ *
+ * @example
+ * import { qsa } from 'ts-dom-utils';
+ * const buttons = qsa<HTMLButtonElement>('.btn');
+ *
+ * @example
+ * import { qsa } from 'ts-dom-utils';
+ * const menu = qs<HtmlNavElement>('.menu');
+ * const menuButtons = qsa<HTMLButtonElement>('.btn', menu);
  */
 declare function qsa<E extends Element>(selector: string, parent?: ParentNode): NodeListOf<E>;
 

package/dist/qsa.js

@@ -1,6 +1 @@
-import {
-  qsa
-} from "./chunk-MRTNZYZJ.js";
-export {
-  qsa as default
-};
+import{a}from"./chunk-22TR3O4D.js";export{a as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-dom-utils",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "description": "A simple utility library for DOM manipulation. Provides TypeScript typings for enhanced development experience in TS environments.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -20,15 +20,16 @@
     "typescript",
     "utilities"
   ],
-  "author": "rafaucau",
+  "author": "rafaucau (https://github.com/rafaucau)",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/rafaucau/ts-dom-utils/issues"
   },
   "homepage": "https://github.com/rafaucau/ts-dom-utils#readme",
+  "funding": "https://github.com/rafaucau/ts-dom-utils?sponsor=1",
   "devDependencies": {
     "prettier": "^2.8.8",
-    "tsup": "^6.7.0",
-    "typescript": "^5.0.4"
+    "tsup": "^7.1.0",
+    "typescript": "^5.1.6"
   }
 }

package/dist/chunk-2CYKZHHS.js

@@ -1,32 +0,0 @@
-// src/createElement.ts
-function createElement(tagName, options = {}, target = document) {
-  const element = target.createElement(tagName);
-  Object.entries(options).forEach(([key, value]) => {
-    if (key === "class") {
-      if (Array.isArray(value)) {
-        element.classList.add(...value);
-      } else {
-        element.classList.add(value);
-      }
-      return;
-    }
-    if (key === "dataset" && typeof value === "object" && value !== null) {
-      Object.entries(value).forEach(
-        ([dataKey, dataValue]) => {
-          element.dataset[dataKey] = dataValue;
-        }
-      );
-      return;
-    }
-    if (key === "text") {
-      element.textContent = value;
-      return;
-    }
-    element.setAttribute(key, value);
-  });
-  return element;
-}
-
-export {
-  createElement
-};

package/dist/chunk-MRTNZYZJ.js

@@ -1,8 +0,0 @@
-// src/qsa.ts
-function qsa(selector, parent = document) {
-  return parent.querySelectorAll(selector);
-}
-
-export {
-  qsa
-};

package/dist/chunk-QUWBOENH.js

@@ -1,8 +0,0 @@
-// src/qs.ts
-function qs(selector, parent = document) {
-  return parent.querySelector(selector);
-}
-
-export {
-  qs
-};