@untemps/utils 3.2.1 → 4.0.0-beta.10

package/dist/async/debounce.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>{let n=null,r=((...r)=>{n!==null&&clearTimeout(n),n=setTimeout(()=>{n=null,e(...r)},t)});return r.cancel=()=>{n!==null&&(clearTimeout(n),n=null)},r};exports.debounce=e;

package/dist/async/debounce.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @module async/debounce
+ */
+export interface DebouncedFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+}
+/**
+ * @function
+ * @example
+ * import { debounce } from '@untemps/utils/async/debounce'
+ *
+ * const handler = debounce((value: string) => console.log(value), 300)
+ * handler('a')
+ * handler('b')
+ * handler('c') // Only 'c' is logged after 300ms
+ *
+ * handler.cancel() // Cancel any pending invocation
+ *
+ * @param fn     - The function to debounce.
+ * @param delay  - The debounce delay in milliseconds.
+ * @returns A debounced version of the function with a `.cancel()` method.
+ */
+export declare const debounce: <T extends (...args: never[]) => void>(fn: T, delay: number) => DebouncedFunction<T>;
+//# sourceMappingURL=debounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/async/debounce.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;IACtE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,MAAM,KAAG,iBAAiB,CAAC,CAAC,CAqBxG,CAAA"}

package/dist/async/debounce.js

@@ -0,0 +1,13 @@
+//#region src/async/debounce.ts
+var e = (e, t) => {
+	let n = null, r = ((...r) => {
+		n !== null && clearTimeout(n), n = setTimeout(() => {
+			n = null, e(...r);
+		}, t);
+	});
+	return r.cancel = () => {
+		n !== null && (clearTimeout(n), n = null);
+	}, r;
+};
+//#endregion
+export { e as debounce };

package/dist/async/throttle.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>{let n=-1/0,r=null,i=null,a=((...a)=>{let o=Date.now(),s=t-(o-n);i=a,s<=0?(r!==null&&(clearTimeout(r),r=null),n=o,i=null,e(...a)):r===null&&(r=setTimeout(()=>{if(n=Date.now(),r=null,i!==null){let t=i;i=null,e(...t)}},s))});return a.cancel=()=>{r!==null&&(clearTimeout(r),r=null),i=null,n=-1/0},a};exports.throttle=e;

package/dist/async/throttle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module async/throttle
+ */
+export interface ThrottledFunction<T extends (...args: never[]) => void> {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+}
+/**
+ * @function
+ * @example
+ * import { throttle } from '@untemps/utils/async/throttle'
+ *
+ * const handler = throttle((event: MouseEvent) => console.log(event), 200)
+ * window.addEventListener('scroll', handler)
+ *
+ * handler.cancel() // Cancel any pending trailing invocation
+ *
+ * @param fn        - The function to throttle.
+ * @param interval  - The minimum interval between invocations in milliseconds.
+ * @returns A throttled version of the function with a `.cancel()` method.
+ */
+export declare const throttle: <T extends (...args: never[]) => void>(fn: T, interval: number) => ThrottledFunction<T>;
+//# sourceMappingURL=throttle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/async/throttle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;IACtE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,MAAM,KAAG,iBAAiB,CAAC,CAAC,CA0C3G,CAAA"}

package/dist/async/throttle.js

@@ -0,0 +1,17 @@
+//#region src/async/throttle.ts
+var e = (e, t) => {
+	let n = -Infinity, r = null, i = null, a = ((...a) => {
+		let o = Date.now(), s = t - (o - n);
+		i = a, s <= 0 ? (r !== null && (clearTimeout(r), r = null), n = o, i = null, e(...a)) : r === null && (r = setTimeout(() => {
+			if (n = Date.now(), r = null, i !== null) {
+				let t = i;
+				i = null, e(...t);
+			}
+		}, s));
+	});
+	return a.cancel = () => {
+		r !== null && (clearTimeout(r), r = null), i = null, n = -Infinity;
+	}, a;
+};
+//#endregion
+export { e as throttle };

package/dist/dom/createElement.cjs

@@ -1 +1 @@
-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);if(t)for(let[e,n]of Object.entries(t))s.setAttribute(e,n);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;
+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);if(t)for(let[e,n]of Object.entries(t))s.setAttribute(e,n);n&&s.appendChild(n),r&&!s.hasChildNodes()&&s.appendChild(document.createTextNode(r));let c=i||document.querySelector(a);if(c&&c.appendChild(s),o){let{x:e,y:t,top:n,right:r,bottom:i,left:a,width:c,height:l}=o,u=e??a??0,d=t??n??0,f=a??u,p=n??d,m=c??(r===void 0?0:r-f),h=l??(i===void 0?0:i-p),g={x:u,y:d,width:m,height:h,top:p,right:r??u+m,bottom:i??d+h,left:f},_=Object.defineProperty({...g},`toJSON`,{value:()=>({...g})});s.getBoundingClientRect=()=>_}return s};exports.createElement=e;

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

@@ -1 +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,WAqB7B,CAAA"}
+{"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,WAuC7B,CAAA"}

package/dist/dom/createElement.js

@@ -4,7 +4,20 @@ var e = ({ tag: e = "div", attributes: t = {}, content: n = null, textContent: r
 	if (t) for (let [e, n] of Object.entries(t)) s.setAttribute(e, n);
 	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;
+	if (c && c.appendChild(s), o) {
+		let { x: e, y: t, top: n, right: r, bottom: i, left: a, width: c, height: l } = o, u = e ?? a ?? 0, d = t ?? n ?? 0, f = a ?? u, p = n ?? d, m = c ?? (r === void 0 ? 0 : r - f), h = l ?? (i === void 0 ? 0 : i - p), g = {
+			x: u,
+			y: d,
+			width: m,
+			height: h,
+			top: p,
+			right: r ?? u + m,
+			bottom: i ?? d + h,
+			left: f
+		}, _ = Object.defineProperty({ ...g }, "toJSON", { value: () => ({ ...g }) });
+		s.getBoundingClientRect = () => _;
+	}
+	return s;
 };
 //#endregion
 export { e as createElement };

package/dist/dom/modifyElement.cjs

@@ -1 +1 @@
-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;
+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,t]of Object.entries(n))t==null?r?.removeAttribute(e):r?.setAttribute(e,t);return r};exports.modifyElement=t;

package/dist/dom/modifyElement.js

@@ -2,7 +2,7 @@ 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]);
+	for (let [e, t] of Object.entries(n)) t == null ? r?.removeAttribute(e) : r?.setAttribute(e, t);
 	return r;
 };
 //#endregion

package/dist/index.cjs

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

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 export { extractByIndices } from './array/extractByIndices';
+export { debounce } from './async/debounce';
+export type { DebouncedFunction } from './async/debounce';
 export { standby } from './async/standby';
+export { throttle } from './async/throttle';
+export type { ThrottledFunction } from './async/throttle';
 export { createElement } from './dom/createElement';
 export type { BoundingClientRectInit, CreateElementConfig } from './dom/createElement';
 export { doElementsOverlap } from './dom/doElementsOverlap';
@@ -15,6 +19,7 @@ export { isNil } from './lang/isNil';
 export { clamp } from './number/clamp';
 export { getRandomInteger } from './number/getRandomInteger';
 export { normalizeMinMax } from './number/normalizeMinMax';
+export { deepClone } from './object/deepClone';
 export { deepMerge } from './object/deepMerge';
 export { isObject } from './object/isObject';
 export { generateText } from './string/generateText';

package/dist/index.d.ts.map

@@ -1 +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,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,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,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,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,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"}

package/dist/index.js

@@ -1,23 +1,26 @@
 import { extractByIndices as e } from "./array/extractByIndices.js";
-import { standby as t } from "./async/standby.js";
-import { createElement as n } from "./dom/createElement.js";
-import { doElementsOverlap as r } from "./dom/doElementsOverlap.js";
-import { getCSSDeclaration as i } from "./dom/getCSSDeclaration.js";
-import { getElement as a } from "./dom/getElement.js";
-import { isElement as o } from "./dom/isElement.js";
-import { isString as s } from "./string/isString.js";
-import { modifyElement as c } from "./dom/modifyElement.js";
-import { removeElement as l } from "./dom/removeElement.js";
-import { resolveClassName as u } from "./dom/resolveClassName.js";
-import { isFunction as d } from "./function/isFunction.js";
-import { isNil as f } from "./lang/isNil.js";
-import { normalizeMinMax as p } from "./number/normalizeMinMax.js";
-import { clamp as m } from "./number/clamp.js";
-import { getRandomInteger as h } from "./number/getRandomInteger.js";
-import { isObject as g } from "./object/isObject.js";
-import { deepMerge as _ } from "./object/deepMerge.js";
-import { generateText as v } from "./string/generateText.js";
-import { generateTokenizedText as y } from "./string/generateTokenizedText.js";
-import { interpolate as b } from "./string/interpolate.js";
-import { interpolateLiteral as x } from "./string/interpolateLiteral.js";
-export { m as clamp, n as createElement, _ as deepMerge, r as doElementsOverlap, e as extractByIndices, v as generateText, y as generateTokenizedText, i as getCSSDeclaration, a as getElement, h as getRandomInteger, b as interpolate, x as interpolateLiteral, o as isElement, d as isFunction, f as isNil, g as isObject, s as isString, c as modifyElement, p as normalizeMinMax, l as removeElement, u as resolveClassName, t as standby };
+import { debounce as t } from "./async/debounce.js";
+import { standby as n } from "./async/standby.js";
+import { throttle as r } from "./async/throttle.js";
+import { createElement as i } from "./dom/createElement.js";
+import { doElementsOverlap as a } from "./dom/doElementsOverlap.js";
+import { getCSSDeclaration as o } from "./dom/getCSSDeclaration.js";
+import { getElement as s } from "./dom/getElement.js";
+import { isElement as c } from "./dom/isElement.js";
+import { isString as l } from "./string/isString.js";
+import { modifyElement as u } from "./dom/modifyElement.js";
+import { removeElement as d } from "./dom/removeElement.js";
+import { resolveClassName as f } from "./dom/resolveClassName.js";
+import { isFunction as p } from "./function/isFunction.js";
+import { isNil as m } from "./lang/isNil.js";
+import { normalizeMinMax as h } from "./number/normalizeMinMax.js";
+import { clamp as g } from "./number/clamp.js";
+import { getRandomInteger as _ } from "./number/getRandomInteger.js";
+import { deepClone as v } from "./object/deepClone.js";
+import { isObject as y } from "./object/isObject.js";
+import { deepMerge as b } from "./object/deepMerge.js";
+import { generateText as x } from "./string/generateText.js";
+import { generateTokenizedText as S } from "./string/generateTokenizedText.js";
+import { interpolate as C } from "./string/interpolate.js";
+import { interpolateLiteral as w } from "./string/interpolateLiteral.js";
+export { g as clamp, i as createElement, t as debounce, v as deepClone, b as deepMerge, a as doElementsOverlap, e as extractByIndices, x as generateText, S as generateTokenizedText, o as getCSSDeclaration, s as getElement, _ as getRandomInteger, C as interpolate, w as interpolateLiteral, c as isElement, p as isFunction, m as isNil, y as isObject, l as isString, u as modifyElement, h as normalizeMinMax, d as removeElement, f as resolveClassName, n as standby, r as throttle };

package/dist/object/deepClone.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>structuredClone(e);exports.deepClone=e;

package/dist/object/deepClone.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module object/deepClone
+ */
+/**
+ * @function
+ * @example
+ * import { deepClone } from '@untemps/utils/object/deepClone'
+ *
+ * const original = { a: 1, b: { c: [2, 3] } }
+ * const clone = deepClone(original)
+ * clone.b.c.push(4)
+ * console.log(original.b.c) // [2, 3]
+ *
+ * @param value - The value to deep clone. Must be serialisable by the structured clone algorithm (functions and DOM nodes are not supported).
+ * @returns A deep clone of the value.
+ */
+export declare const deepClone: <T>(value: T) => T;
+//# sourceMappingURL=deepClone.d.ts.map

package/dist/object/deepClone.d.ts.map

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

package/dist/object/deepClone.js

@@ -0,0 +1,4 @@
+//#region src/object/deepClone.ts
+var e = (e) => structuredClone(e);
+//#endregion
+export { e as deepClone };

package/dist/object/deepMerge.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./isObject.cjs`);var t=(n,r)=>{for(let i of Object.keys(n))e.isObject(n[i])&&i in r&&Object.assign(n[i],t(n[i],r[i]));return Object.assign(r||{},n),r};exports.deepMerge=t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./isObject.cjs`);var t=(n,r,i=!1)=>{let a=i?r:structuredClone(r);for(let r of Object.keys(n))if(r in a&&e.isObject(n[r])&&e.isObject(a[r]))a[r]=t(n[r],a[r],i);else{let e=n[r];a[r]=typeof e==`object`&&e?structuredClone(e):e}return a};exports.deepMerge=t;

package/dist/object/deepMerge.d.ts

@@ -12,7 +12,8 @@
  *
  * @param source - The object to merge into the target.
  * @param target - The target object where source will be merged.
- * @returns The target object containing both source and target keys with source precedence.
+ * @param mutate - If true, merges directly into target without cloning. Defaults to false.
+ * @returns The merged object — a new object when mutate is false, target itself when mutate is true.
  */
-export declare const deepMerge: (source: Record<string, unknown>, target: Record<string, unknown>) => Record<string, unknown>;
+export declare const deepMerge: (source: Record<string, unknown>, target: Record<string, unknown>, mutate?: boolean) => Record<string, unknown>;
 //# sourceMappingURL=deepMerge.d.ts.map

package/dist/object/deepMerge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/object/deepMerge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAWxB,CAAA"}
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/object/deepMerge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,gBAAc,KACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAexB,CAAA"}

package/dist/object/deepMerge.js

@@ -1,8 +1,13 @@
 import { isObject as e } from "./isObject.js";
 //#region src/object/deepMerge.ts
-var t = (n, r) => {
-	for (let i of Object.keys(n)) e(n[i]) && i in r && Object.assign(n[i], t(n[i], r[i]));
-	return Object.assign(r || {}, n), r;
+var t = (n, r, i = !1) => {
+	let a = i ? r : structuredClone(r);
+	for (let r of Object.keys(n)) if (r in a && e(n[r]) && e(a[r])) a[r] = t(n[r], a[r], i);
+	else {
+		let e = n[r];
+		a[r] = typeof e == "object" && e ? structuredClone(e) : e;
+	}
+	return a;
 };
 //#endregion
 export { t as deepMerge };

package/dist/string/generateText.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../number/normalizeMinMax.cjs`),t=require(`../number/getRandomInteger.cjs`);var n=`year.learn.key.cook.crosswalk.script.chief.plan.meat.vague.demonstrator.dictionary.visible.bomber.variation.leader.channel.litigation.royalty.impulse.package.oppose.privilege.begin.operation.herd.hemisphere.incongruous.horror.pipe.start.vertical.worry.reform.unlike.exhibition.disagree.allow.patrol.combine.impress.invisible.cage.log.snow.undertake.division.ethics.damage.responsible`.split(`.`),r=(t,n)=>{let{min:r,max:i}=e.normalizeMinMax(Math.abs(t),Math.abs(n)),a=Math.max(r,1);return{min:a,max:Math.max(i,a)}},i=({minWords:e=10,maxWords:i=50,dictionary:a=n}={})=>{let o=``,{min:s,max:c}=r(e,i),l=t.getRandomInteger(s,c);for(let e=0;e<l;e++){let t=a[Math.floor(Math.random()*a.length)];o+=`${e>0?` `:``}${t}`}return o};exports.generateText=i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../number/normalizeMinMax.cjs`),t=require(`../number/getRandomInteger.cjs`);var n=`year.learn.key.cook.crosswalk.script.chief.plan.meat.vague.demonstrator.dictionary.visible.bomber.variation.leader.channel.litigation.royalty.impulse.package.oppose.privilege.begin.operation.herd.hemisphere.incongruous.horror.pipe.start.vertical.worry.reform.unlike.exhibition.disagree.allow.patrol.combine.impress.invisible.cage.log.snow.undertake.division.ethics.damage.responsible`.split(`.`),r=(t,n)=>{let{min:r,max:i}=e.normalizeMinMax(Math.abs(t),Math.abs(n)),a=Math.max(r,1);return{min:a,max:Math.max(i,a)}},i=({minWords:e=10,maxWords:i=50,dictionary:a=n}={})=>{if(!a?.length)throw RangeError(`dictionary must not be empty`);let o=``,{min:s,max:c}=r(e,i),l=t.getRandomInteger(s,c);for(let e=0;e<l;e++){let t=a[Math.floor(Math.random()*a.length)];o+=`${e>0?` `:``}${t}`}return o};exports.generateText=i;

package/dist/string/generateText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateText.d.ts","sourceRoot":"","sources":["../../src/string/generateText.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,qCAAsD,kBAAuB,KAAG,MAS5G,CAAA"}
+{"version":3,"file":"generateText.d.ts","sourceRoot":"","sources":["../../src/string/generateText.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,qCAAsD,kBAAuB,KAAG,MAU5G,CAAA"}

package/dist/string/generateText.js

@@ -8,6 +8,7 @@ var n = /* @__PURE__ */ "year.learn.key.cook.crosswalk.script.chief.plan.meat.va
 		max: Math.max(i, a)
 	};
 }, i = ({ minWords: e = 10, maxWords: i = 50, dictionary: a = n } = {}) => {
+	if (!a?.length) throw RangeError("dictionary must not be empty");
 	let o = "", { min: s, max: c } = r(e, i), l = t(s, c);
 	for (let e = 0; e < l; e++) {
 		let t = a[Math.floor(Math.random() * a.length)];

package/dist/string/interpolate.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../lang/isNil.cjs`);var t=e=>{let t=RegExp(`([\\[\\^\\$\\.|\\?\\*\\+\\(\\)])+`,`g`);return e.replace(t,e=>e.split(``).map(e=>`\\`+e).join(``))},n=e=>Object.keys(e).reduce((e,t,n)=>`${e}${n>0?`|`:``}${t}`,``),r=(r,i={},a=`%`)=>{let o=t(a),s=n(i),c=RegExp(`${o}(${s})${o}`,`g`);return r.replace(c,(t,n)=>e.isNil(i[n])?n:String(i[n]))};exports.interpolate=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../lang/isNil.cjs`);var t=e=>e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`),n=e=>Object.keys(e).reduce((e,t,n)=>`${e}${n>0?`|`:``}${t}`,``),r=(r,i={},a=`%`)=>{let o=t(a),s=n(i),c=RegExp(`${o}(${s})${o}`,`g`);return r.replace(c,(t,n)=>e.isNil(i[n])?n:String(i[n]))};exports.interpolate=r;

package/dist/string/interpolate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/string/interpolate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,gBAAa,KAAG,MAKhG,CAAA"}
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/string/interpolate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,gBAAa,KAAG,MAKhG,CAAA"}

package/dist/string/interpolate.js

@@ -1,9 +1,6 @@
 import { isNil as e } from "../lang/isNil.js";
 //#region src/string/interpolate.ts
-var t = (e) => {
-	let t = /* @__PURE__ */ RegExp("([\\[\\^\\$\\.|\\?\\*\\+\\(\\)])+", "g");
-	return e.replace(t, (e) => e.split("").map((e) => "\\" + e).join(""));
-}, n = (e) => Object.keys(e).reduce((e, t, n) => `${e}${n > 0 ? "|" : ""}${t}`, ""), r = (r, i = {}, a = "%") => {
+var t = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), n = (e) => Object.keys(e).reduce((e, t, n) => `${e}${n > 0 ? "|" : ""}${t}`, ""), r = (r, i = {}, a = "%") => {
 	let o = t(a), s = n(i), c = RegExp(`${o}(${s})${o}`, "g");
 	return r.replace(c, (t, n) => e(i[n]) ? n : String(i[n]));
 };

package/dist/string/interpolateLiteral.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>Function(...Object.keys(t),`return \`${e}\``)(...Object.values(t));exports.interpolateLiteral=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t={})=>e.replace(/\$\{(\w+)\}/g,(e,n)=>{if(!Object.hasOwn(t,n))throw ReferenceError(`${n} is not defined`);return String(t[n])});exports.interpolateLiteral=e;

package/dist/string/interpolateLiteral.d.ts

@@ -15,8 +15,8 @@
  * interpolateLiteral(value, tokens) // A bird with 3 "wings" and a lot of dignity
  *
  * @param value   - The literal-like string value to interpolate.
- * @param tokens  - An object of key/value pairs to replace the tokens.
+ * @param tokens  - An object of key/value pairs to replace the tokens. Keys must be valid identifiers (`\w+`). Defaults to `{}`.
  * @returns The interpolated string.
  */
-export declare const interpolateLiteral: (value: string, tokens: Record<string, unknown>) => string;
+export declare const interpolateLiteral: (value: string, tokens?: Record<string, unknown>) => string;
 //# sourceMappingURL=interpolateLiteral.d.ts.map

package/dist/string/interpolateLiteral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolateLiteral.d.ts","sourceRoot":"","sources":["../../src/string/interpolateLiteral.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAGnF,CAAA"}
+{"version":3,"file":"interpolateLiteral.d.ts","sourceRoot":"","sources":["../../src/string/interpolateLiteral.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KAAG,MAKxF,CAAA"}

package/dist/string/interpolateLiteral.js

@@ -1,4 +1,7 @@
 //#region src/string/interpolateLiteral.ts
-var e = (e, t) => Function(...Object.keys(t), `return \`${e}\``)(...Object.values(t));
+var e = (e, t = {}) => e.replace(/\$\{(\w+)\}/g, (e, n) => {
+	if (!Object.hasOwn(t, n)) throw ReferenceError(`${n} is not defined`);
+	return String(t[n]);
+});
 //#endregion
 export { e as interpolateLiteral };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@untemps/utils",
-	"version": "3.2.1",
+	"version": "4.0.0-beta.10",
 	"description": "Utils for @untemps packages",
 	"repository": "git@github.com:untemps/utils.git",
 	"keywords": [],