@untemps/utils 3.0.0 → 3.1.1

package/README.md

@@ -16,4 +16,27 @@ A complete documentation of utils is available here: [Docs](https://utils.untemp
 
 ```bash
 yarn add @untemps/utils
+```
+
+This package ships with full TypeScript declarations. No additional `@types/*` package needed.
+
+## Usage
+
+### ESM / TypeScript
+
+```ts
+import { isNil, interpolate, createElement } from '@untemps/utils'
+```
+
+### Per-module (tree-shakeable)
+
+```ts
+import { isNil } from '@untemps/utils/lang/isNil'
+import { interpolate } from '@untemps/utils/string/interpolate'
+```
+
+### CommonJS
+
+```js
+const { isNil } = require('@untemps/utils')
 ```

package/dist/array/extractByIndices.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=(t,e)=>(t==null?void 0:t.filter((y,l)=>e==null?void 0:e.includes(l)))??[];exports.extractByIndices=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>e?.filter((e,n)=>t?.includes(n))??[];exports.extractByIndices=e;

package/dist/array/extractByIndices.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module array/extractByIndices
+ */
+/**
+ * @function
+ * @example
+ * import { extractByIndices } from '@untemps/utils/array/extractByIndices'
+ *
+ * const source = ['foo', 'bar', 'gag', 'pol', 'zux']
+ * const indices = [1, 3]
+ * extractByIndices(source, indices) // ['bar', 'pol']
+ *
+ * @param source    - The source array from which extract the values.
+ * @param indices   - An array of indices.
+ * @returns A new array containing the values at the specified indices only.
+ */
+export declare const extractByIndices: <T>(source?: T[], indices?: number[]) => T[];
+//# sourceMappingURL=extractByIndices.d.ts.map

package/dist/array/extractByIndices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractByIndices.d.ts","sourceRoot":"","sources":["../../src/array/extractByIndices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,UAAU,MAAM,EAAE,KAAG,CAAC,EACnB,CAAA"}

package/dist/array/extractByIndices.js

@@ -1,4 +1,4 @@
-const f = (t, l) => (t == null ? void 0 : t.filter((a, x) => l == null ? void 0 : l.includes(x))) ?? [];
-export {
-  f as extractByIndices
-};
+//#region src/array/extractByIndices.ts
+var e = (e, t) => e?.filter((e, n) => t?.includes(n)) ?? [];
+//#endregion
+export { e as extractByIndices };

package/dist/async/standby.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=(e=128)=>new Promise(t=>setTimeout(t,e));exports.standby=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e=128)=>new Promise(t=>setTimeout(t,e));exports.standby=e;

package/dist/async/standby.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module async/standby
+ */
+/**
+ * @function
+ * @example
+ * import { standby } from '@untemps/utils/async/standby'
+ *
+ * const fn = async () => {
+ *   console.log("Start delay")
+ *   await standby(3000)
+ *   console.log("End delay")
+ * }
+ * fn()
+ *
+ * @param timeout  - The delay before resolving the promise (in milliseconds).
+ * @returns The promise to be resolved.
+ */
+export declare const standby: (timeout?: number) => Promise<void>;
+//# sourceMappingURL=standby.d.ts.map

package/dist/async/standby.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standby.d.ts","sourceRoot":"","sources":["../../src/async/standby.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,OAAO,GAAI,gBAAa,KAAG,OAAO,CAAC,IAAI,CAA2D,CAAA"}

package/dist/async/standby.js

@@ -1,4 +1,4 @@
-const o = (e = 128) => new Promise((t) => setTimeout(t, e));
-export {
-  o as standby
-};
+//#region src/async/standby.ts
+var e = (e = 128) => new Promise((t) => setTimeout(t, e));
+//#endregion
+export { e as standby };

package/dist/dom/createElement.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=({tag:o="div",attributes:l={},content:t=null,textContent:n=null,parent:u=null,parentSelector:c=null,boundingClientRect:d=null}={})=>{const e=document.createElement(o);for(let i in l)e.setAttribute(i,l[i]);t&&e.appendChild(t),n&&!e.hasChildNodes()&&e.appendChild(document.createTextNode(n));const r=u||document.querySelector(c);return r&&r.appendChild(e),d&&(e.getBoundingClientRect=()=>d),e};exports.createElement=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=({tag:e=`div`,attributes:t={},content:n=null,textContent:r=null,parent:i=null,parentSelector:a=null,boundingClientRect:o=null}={})=>{let s=document.createElement(e);for(let e in t)s.setAttribute(e,t[e]);n&&s.appendChild(n),r&&!s.hasChildNodes()&&s.appendChild(document.createTextNode(r));let c=i||document.querySelector(a);return c&&c.appendChild(s),o&&(s.getBoundingClientRect=()=>o),s};exports.createElement=e;

package/dist/dom/createElement.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @module dom/createElement
+ */
+/**
+ * Partial bounding rect used to mock getBoundingClientRect in jsdom environments.
+ */
+export interface BoundingClientRectInit {
+    x?: number;
+    y?: number;
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+    width?: number;
+    height?: number;
+}
+/**
+ * Configuration object for createElement.
+ */
+export interface CreateElementConfig {
+    /** The tag name of the new DOM element to create. All valid HTML tags are accepted. */
+    tag?: string;
+    /** The attributes to pass to the new DOM element. */
+    attributes?: Record<string, string> | null;
+    /** A DOM element to append as child. Has precedence over textContent. */
+    content?: HTMLElement | null;
+    /** A text to append as child of the new DOM element. */
+    textContent?: string | null;
+    /** A DOM element to which append the new DOM element. Has precedence over parentSelector. */
+    parent?: HTMLElement | null;
+    /** A selector of a DOM element to which append the new DOM element. */
+    parentSelector?: string | null;
+    /** The values returned by getBoundingClientRect. Useful in jsdom environment. */
+    boundingClientRect?: BoundingClientRectInit | null;
+}
+/**
+ * @function
+ * @example
+ * import { createElement } from '@untemps/utils/dom/createElement'
+ *
+ * createElement({
+ *  tag: 'p',
+ *  attributes: { id: 'foo', style: 'font-weight: bold' },
+ *  textContent: 'Foo',
+ *  parentSelector: 'body'
+ * }) // <p id="foo" style="font-weight: bold">Foo</p>
+ *
+ * @param config - The configuration object for the new DOM element.
+ * @returns The new DOM element.
+ */
+export declare const createElement: ({ tag, attributes, content, textContent, parent, parentSelector, boundingClientRect, }?: CreateElementConfig) => HTMLElement;
+//# sourceMappingURL=createElement.d.ts.map

package/dist/dom/createElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createElement.d.ts","sourceRoot":"","sources":["../../src/dom/createElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAC1C,yEAAyE;IACzE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC5B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,yFAQ3B,mBAAwB,KAAG,WAmB7B,CAAA"}

package/dist/dom/createElement.js

@@ -1,19 +1,10 @@
-const p = ({
-  tag: r = "div",
-  attributes: l = {},
-  content: n = null,
-  textContent: d = null,
-  parent: u = null,
-  parentSelector: c = null,
-  boundingClientRect: t = null
-} = {}) => {
-  const e = document.createElement(r);
-  for (let o in l)
-    e.setAttribute(o, l[o]);
-  n && e.appendChild(n), d && !e.hasChildNodes() && e.appendChild(document.createTextNode(d));
-  const i = u || document.querySelector(c);
-  return i && i.appendChild(e), t && (e.getBoundingClientRect = () => t), e;
-};
-export {
-  p as createElement
+//#region src/dom/createElement.ts
+var e = ({ tag: e = "div", attributes: t = {}, content: n = null, textContent: r = null, parent: i = null, parentSelector: a = null, boundingClientRect: o = null } = {}) => {
+	let s = document.createElement(e);
+	for (let e in t) s.setAttribute(e, t[e]);
+	n && s.appendChild(n), r && !s.hasChildNodes() && s.appendChild(document.createTextNode(r));
+	let c = i || document.querySelector(a);
+	return c && c.appendChild(s), o && (s.getBoundingClientRect = () => o), s;
 };
+//#endregion
+export { e as createElement };

package/dist/dom/doElementsOverlap.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=(t,e)=>{const{left:o,right:n,top:l,bottom:r}=t.getBoundingClientRect(),{left:i,right:g,top:c,bottom:m}=e.getBoundingClientRect();return!(l>m||n<i||r<c||o>g)};exports.doElementsOverlap=p;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>{let{left:n,right:r,top:i,bottom:a}=e.getBoundingClientRect(),{left:o,right:s,top:c,bottom:l}=t.getBoundingClientRect();return!(i>l||r<o||a<c||n>s)};exports.doElementsOverlap=e;

package/dist/dom/doElementsOverlap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module dom/doElementsOverlap
+ */
+/**
+ * @function
+ * @example
+ * import { doElementsOverlap } from '@untemps/utils/dom/doElementsOverlap'
+ *
+ * const element1 = document.createElement('div')
+ * element1.style = 'width: 140px; height: 140px; position: absolute; background-color: red;'
+ * document.body.appendChild(element1)
+ *
+ * const element2 = document.createElement('div')
+ * element2.style = 'width: 130px; height: 130px; position: absolute; background-color: green;'
+ * document.body.appendChild(element2)
+ *
+ * const element3 = document.createElement('div')
+ * element3.style = 'width: 130px; height: 130px; left: 250px; top: 250px; position: absolute; background-color: blue;'
+ * document.body.appendChild(element3)
+ *
+ * doElementsOverlap(element1, element2) // true
+ * doElementsOverlap(element1, element3) // false
+ *
+ * @param element1  - The first DOM element to compare.
+ * @param element2  - The second DOM element to compare.
+ * @returns `true` if the two DOM elements overlap.
+ */
+export declare const doElementsOverlap: (element1: Element, element2: Element) => boolean;
+//# sourceMappingURL=doElementsOverlap.d.ts.map

package/dist/dom/doElementsOverlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doElementsOverlap.d.ts","sourceRoot":"","sources":["../../src/dom/doElementsOverlap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,OAAO,EAAE,UAAU,OAAO,KAAG,OAIxE,CAAA"}

package/dist/dom/doElementsOverlap.js

@@ -1,7 +1,7 @@
-const m = (t, o) => {
-  const { left: e, right: n, top: g, bottom: i } = t.getBoundingClientRect(), { left: l, right: r, top: p, bottom: c } = o.getBoundingClientRect();
-  return !(g > c || n < l || i < p || e > r);
-};
-export {
-  m as doElementsOverlap
+//#region src/dom/doElementsOverlap.ts
+var e = (e, t) => {
+	let { left: n, right: r, top: i, bottom: a } = e.getBoundingClientRect(), { left: o, right: s, top: c, bottom: l } = t.getBoundingClientRect();
+	return !(i > l || r < o || a < c || n > s);
 };
+//#endregion
+export { e as doElementsOverlap };

package/dist/dom/getCSSDeclaration.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=(t,r=!1)=>{var o;if(t&&(t=t.startsWith(".")?t:`.${t}`,(o=document.styleSheets)!=null&&o.length)){for(let{cssRules:l}of document.styleSheets)for(let{selectorText:n,style:e}of l)if(n===t&&e)return r?e.cssText:e}return null};exports.getCSSDeclaration=f;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t=!1)=>{if(e&&(e=e.startsWith(`.`)?e:`.${e}`,document.styleSheets?.length))for(let n of document.styleSheets)for(let r of n.cssRules){let n=r;if(n.selectorText===e&&n.style)return t?n.style.cssText:n.style}return null};exports.getCSSDeclaration=e;

package/dist/dom/getCSSDeclaration.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module dom/getCSSDeclaration
+ */
+/**
+ * @function
+ * @example
+ * import { getCSSDeclaration } from '@untemps/utils/dom/getCSSDeclaration'
+ *
+ * const styleElement = document.createElement('style')
+ * styleElement.textContent = '.drag { background-color: black; }'
+ * document.head.appendChild(styleElement)
+ *
+ * const className = '.drag'
+ * const returnText = true
+ * getCSSDeclaration(className, returnText) // background-color: black;
+ *
+ * @param className            - The name of the CSS declaration to return. You may ignore the starting dot.
+ * @param returnText  - `true` to get a string representation of the CSS declaration.
+ * @returns The CSS declaration or null if the CSS declaration is not found.
+ */
+export declare const getCSSDeclaration: (className: string, returnText?: boolean) => CSSStyleDeclaration | string | null;
+//# sourceMappingURL=getCSSDeclaration.d.ts.map

package/dist/dom/getCSSDeclaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCSSDeclaration.d.ts","sourceRoot":"","sources":["../../src/dom/getCSSDeclaration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,oBAAkB,KAAG,mBAAmB,GAAG,MAAM,GAAG,IAexG,CAAA"}

package/dist/dom/getCSSDeclaration.js

@@ -1,13 +1,10 @@
-const l = (t, r = !1) => {
-  var o;
-  if (t && (t = t.startsWith(".") ? t : `.${t}`, (o = document.styleSheets) != null && o.length)) {
-    for (let { cssRules: f } of document.styleSheets)
-      for (let { selectorText: n, style: e } of f)
-        if (n === t && e)
-          return r ? e.cssText : e;
-  }
-  return null;
-};
-export {
-  l as getCSSDeclaration
+//#region src/dom/getCSSDeclaration.ts
+var e = (e, t = !1) => {
+	if (e && (e = e.startsWith(".") ? e : `.${e}`, document.styleSheets?.length)) for (let n of document.styleSheets) for (let r of n.cssRules) {
+		let n = r;
+		if (n.selectorText === e && n.style) return t ? n.style.cssText : n.style;
+	}
+	return null;
 };
+//#endregion
+export { e as getCSSDeclaration };

package/dist/dom/getElement.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=e=>document.querySelector(e);exports.getElement=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>document.querySelector(e);exports.getElement=e;

package/dist/dom/getElement.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module dom/getElement
+ */
+/**
+ * @function
+ * @example
+ * import { getElement } from '@untemps/utils/dom/getElement'
+ *
+ * const element = document.createElement('div')
+ * element.id = 'my-element'
+ * document.body.appendChild(element)
+ *
+ * getElement('#my-element') // <div id="my-element"></div>
+ *
+ * @param selector - The selector of the DOM element to return.
+ * @returns The DOM element corresponding to the selector.
+ */
+export declare const getElement: <T extends Element = HTMLElement>(selector: string) => T | null;
+//# sourceMappingURL=getElement.d.ts.map

package/dist/dom/getElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getElement.d.ts","sourceRoot":"","sources":["../../src/dom/getElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,GAAG,WAAW,EAAE,UAAU,MAAM,KAAG,CAAC,GAAG,IAC/C,CAAA"}

package/dist/dom/getElement.js

@@ -1,4 +1,4 @@
-const t = (e) => document.querySelector(e);
-export {
-  t as getElement
-};
+//#region src/dom/getElement.ts
+var e = (e) => document.querySelector(e);
+//#endregion
+export { e as getElement };

package/dist/dom/isElement.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=e=>(e==null?void 0:e.nodeType)===1;exports.isElement=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>e?.nodeType===1;exports.isElement=e;

package/dist/dom/isElement.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module dom/isElement
+ */
+/**
+ * @function
+ * @example
+ * import { isElement } from '@untemps/utils/dom/isElement'
+ *
+ * isElement(document.createElement('div')) // true
+ * isElement(42) // false
+ *
+ * @param value   - The value to check.
+ * @returns `true` whether the value is a DOM element.
+ */
+export declare const isElement: (value: unknown) => value is Element;
+//# sourceMappingURL=isElement.d.ts.map

package/dist/dom/isElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isElement.d.ts","sourceRoot":"","sources":["../../src/dom/isElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAA6C,CAAA"}

package/dist/dom/isElement.js

@@ -1,4 +1,4 @@
-const o = (n) => (n == null ? void 0 : n.nodeType) === 1;
-export {
-  o as isElement
-};
+//#region src/dom/isElement.ts
+var e = (e) => e?.nodeType === 1;
+//#endregion
+export { e as isElement };

package/dist/dom/modifyElement.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../string/isString.cjs"),o=(t,r={})=>{let e=t;n.isString(t)&&(e=document.querySelector(t));for(let i in r)r[i]===void 0||r[i]===null?e==null||e.removeAttribute(i):e==null||e.setAttribute(i,r[i]);return e};exports.modifyElement=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../string/isString.cjs`);var t=(t,n={})=>{let r=e.isString(t)?document.querySelector(t):t;for(let e in n)n[e]===void 0||n[e]===null?r?.removeAttribute(e):r?.setAttribute(e,n[e]);return r};exports.modifyElement=t;

package/dist/dom/modifyElement.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module dom/modifyElement
+ */
+/**
+ * @function
+ * @example
+ * import { modifyElement } from '@untemps/utils/dom/modifyElement'
+ *
+ * const element = document.createElement('div')
+ * element.className = 'foo'
+ * document.body.appendChild(element)
+ *
+ * modifyElement(element, { className: 'bar' }) // <div class="bar"></div>
+ *
+ * @param element    - The DOM element or selector of the DOM element to modify.
+ * @param attributes - The new attributes to set to the DOM element.
+ * @returns The modified DOM element.
+ */
+export declare const modifyElement: (element: HTMLElement | string, attributes?: Record<string, string | null | undefined>) => HTMLElement | null;
+//# sourceMappingURL=modifyElement.d.ts.map

package/dist/dom/modifyElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifyElement.d.ts","sourceRoot":"","sources":["../../src/dom/modifyElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACzB,SAAS,WAAW,GAAG,MAAM,EAC7B,aAAY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAM,KACxD,WAAW,GAAG,IAUhB,CAAA"}

package/dist/dom/modifyElement.js

@@ -1,11 +1,9 @@
-import { isString as n } from "../string/isString.js";
-const t = (i, e = {}) => {
-  let o = i;
-  n(i) && (o = document.querySelector(i));
-  for (let r in e)
-    e[r] === void 0 || e[r] === null ? o == null || o.removeAttribute(r) : o == null || o.setAttribute(r, e[r]);
-  return o;
-};
-export {
-  t as modifyElement
+import { isString as e } from "../string/isString.js";
+//#region src/dom/modifyElement.ts
+var t = (t, n = {}) => {
+	let r = e(t) ? document.querySelector(t) : t;
+	for (let e in n) n[e] === void 0 || n[e] === null ? r?.removeAttribute(e) : r?.setAttribute(e, n[e]);
+	return r;
 };
+//#endregion
+export { t as modifyElement };

package/dist/dom/removeElement.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../string/isString.cjs"),i=r=>{var t;let e=r;return o.isString(r)&&(e=document.querySelector(r)),(t=e==null?void 0:e.parentNode)==null?void 0:t.removeChild(e)};exports.removeElement=i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../string/isString.cjs`);var t=t=>{let n=e.isString(t)?document.querySelector(t):t;return n?.parentNode?.removeChild(n)};exports.removeElement=t;

package/dist/dom/removeElement.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module dom/removeElement
+ */
+/**
+ * @function
+ * @example
+ * import { removeElement } from '@untemps/utils/dom/removeElement'
+ *
+ * const element = document.createElement('div')
+ * element.className = 'foo'
+ * document.body.appendChild(element)
+ *
+ * removeElement(element) // <div class="foo"></div>
+ *
+ * @param element  - The DOM element or the selector of the DOM element to remove.
+ * @returns The removed DOM element.
+ */
+export declare const removeElement: (element: HTMLElement | string) => HTMLElement | undefined;
+//# sourceMappingURL=removeElement.d.ts.map

package/dist/dom/removeElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeElement.d.ts","sourceRoot":"","sources":["../../src/dom/removeElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,WAAW,GAAG,MAAM,KAAG,WAAW,GAAG,SAG3E,CAAA"}

package/dist/dom/removeElement.js

@@ -1,9 +1,8 @@
-import { isString as t } from "../string/isString.js";
-const m = (o) => {
-  var e;
-  let r = o;
-  return t(o) && (r = document.querySelector(o)), (e = r == null ? void 0 : r.parentNode) == null ? void 0 : e.removeChild(r);
-};
-export {
-  m as removeElement
+import { isString as e } from "../string/isString.js";
+//#region src/dom/removeElement.ts
+var t = (t) => {
+	let n = e(t) ? document.querySelector(t) : t;
+	return n?.parentNode?.removeChild(n);
 };
+//#endregion
+export { t as removeElement };

package/dist/dom/resolveClassName.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=r=>r!=null&&r.length?r.reduce((o,e)=>{if(Array.isArray(e)){const[s,t,n]=e;e=s?t:n}return y(e)?[...o,e]:o},[]).join(" "):"",y=r=>r&&typeof r=="string"?r:null;exports.resolveClassName=l;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>e?.length?e.reduce((e,n)=>{let r;if(Array.isArray(n)){let[e,t,i]=n;r=e?t:i}else r=n;return t(r)?[...e,r]:e},[]).join(` `):``,t=e=>e&&typeof e==`string`?e:null;exports.resolveClassName=e;

package/dist/dom/resolveClassName.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module dom/resolveClassName
+ */
+export type ClassConditionTuple = [condition: unknown, truthyValue: string, falsyValue?: string];
+export type ClassEntry = string | ClassConditionTuple;
+/**
+ * @function
+ * @example
+ * import { resolveClassName } from '@untemps/utils/dom/resolveClassName'
+ *
+ * const input = [
+ *  [true, 'foo', 'bar'],
+ *  [false, 'foo', 'bar'],
+ *  'gag',
+ * ]
+ * resolveClassName(input) // 'foo bar gag'
+ *
+ * @param input - Array of conditions to evaluate. A condition is an array with 3 items: [condition, class if true, class if false]. You may pass a classname as string instead of a condition.
+ * @returns The aggregated class names.
+ */
+export declare const resolveClassName: (input?: ClassEntry[]) => string;
+//# sourceMappingURL=resolveClassName.d.ts.map

package/dist/dom/resolveClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveClassName.d.ts","sourceRoot":"","sources":["../../src/dom/resolveClassName.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;AAChG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAErD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,UAAU,EAAE,KAAG,MAcvD,CAAA"}

package/dist/dom/resolveClassName.js

@@ -1,10 +1,11 @@
-const f = (r) => r != null && r.length ? r.reduce((s, o) => {
-  if (Array.isArray(o)) {
-    const [e, n, t] = o;
-    o = e ? n : t;
-  }
-  return y(o) ? [...s, o] : s;
-}, []).join(" ") : "", y = (r) => r && typeof r == "string" ? r : null;
-export {
-  f as resolveClassName
-};
+//#region src/dom/resolveClassName.ts
+var e = (e) => e?.length ? e.reduce((e, n) => {
+	let r;
+	if (Array.isArray(n)) {
+		let [e, t, i] = n;
+		r = e ? t : i;
+	} else r = n;
+	return t(r) ? [...e, r] : e;
+}, []).join(" ") : "", t = (e) => e && typeof e == "string" ? e : null;
+//#endregion
+export { e as resolveClassName };

package/dist/function/isFunction.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=t=>typeof t=="function";exports.isFunction=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>typeof e==`function`;exports.isFunction=e;

package/dist/function/isFunction.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module function/isFunction
+ */
+/**
+ * @function
+ * @example
+ * import { isFunction } from '@untemps/utils/function/isFunction'
+ *
+ * isFunction(() => {}) // true
+ * isFunction(42) // false
+ *
+ * @param value   - The value to check.
+ * @returns `true` whether the value is a function.
+ */
+export declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+//# sourceMappingURL=isFunction.d.ts.map

package/dist/function/isFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isFunction.d.ts","sourceRoot":"","sources":["../../src/function/isFunction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAsC,CAAA"}

package/dist/function/isFunction.js

@@ -1,4 +1,4 @@
-const o = (n) => typeof n == "function";
-export {
-  o as isFunction
-};
+//#region src/function/isFunction.ts
+var e = (e) => typeof e == "function";
+//#endregion
+export { e as isFunction };

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./array/extractByIndices.cjs`),t=require(`./async/standby.cjs`),n=require(`./dom/createElement.cjs`),r=require(`./dom/doElementsOverlap.cjs`),i=require(`./dom/getCSSDeclaration.cjs`),a=require(`./dom/getElement.cjs`),o=require(`./dom/isElement.cjs`),s=require(`./string/isString.cjs`),c=require(`./dom/modifyElement.cjs`),l=require(`./dom/removeElement.cjs`),u=require(`./dom/resolveClassName.cjs`),d=require(`./function/isFunction.cjs`),f=require(`./lang/isNil.cjs`),p=require(`./number/normalizeMinMax.cjs`),m=require(`./number/getRandomInteger.cjs`),h=require(`./object/isObject.cjs`),g=require(`./object/deepMerge.cjs`),_=require(`./string/generateText.cjs`),v=require(`./string/generateTokenizedText.cjs`),y=require(`./string/interpolate.cjs`),b=require(`./string/interpolateLiteral.cjs`);exports.createElement=n.createElement,exports.deepMerge=g.deepMerge,exports.doElementsOverlap=r.doElementsOverlap,exports.extractByIndices=e.extractByIndices,exports.generateText=_.generateText,exports.generateTokenizedText=v.generateTokenizedText,exports.getCSSDeclaration=i.getCSSDeclaration,exports.getElement=a.getElement,exports.getRandomInteger=m.getRandomInteger,exports.interpolate=y.interpolate,exports.interpolateLiteral=b.interpolateLiteral,exports.isElement=o.isElement,exports.isFunction=d.isFunction,exports.isNil=f.isNil,exports.isObject=h.isObject,exports.isString=s.isString,exports.modifyElement=c.modifyElement,exports.normalizeMinMax=p.normalizeMinMax,exports.removeElement=l.removeElement,exports.resolveClassName=u.resolveClassName,exports.standby=t.standby;

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { extractByIndices } from './array/extractByIndices';
+export { standby } from './async/standby';
+export { createElement } from './dom/createElement';
+export type { BoundingClientRectInit, CreateElementConfig } from './dom/createElement';
+export { doElementsOverlap } from './dom/doElementsOverlap';
+export { getCSSDeclaration } from './dom/getCSSDeclaration';
+export { getElement } from './dom/getElement';
+export { isElement } from './dom/isElement';
+export { modifyElement } from './dom/modifyElement';
+export { removeElement } from './dom/removeElement';
+export { resolveClassName } from './dom/resolveClassName';
+export type { ClassConditionTuple, ClassEntry } from './dom/resolveClassName';
+export { isFunction } from './function/isFunction';
+export { isNil } from './lang/isNil';
+export { getRandomInteger } from './number/getRandomInteger';
+export { normalizeMinMax } from './number/normalizeMinMax';
+export { deepMerge } from './object/deepMerge';
+export { isObject } from './object/isObject';
+export { generateText } from './string/generateText';
+export type { GenerateTextConfig } from './string/generateText';
+export { generateTokenizedText } from './string/generateTokenizedText';
+export type { GenerateTokenizedTextConfig } from './string/generateTokenizedText';
+export { interpolate } from './string/interpolate';
+export { interpolateLiteral } from './string/interpolateLiteral';
+export { isString } from './string/isString';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,YAAY,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA"}