@untemps/utils 3.0.0 → 3.1.1

package/dist/index.js

@@ -0,0 +1,22 @@
+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 { getRandomInteger as m } from "./number/getRandomInteger.js";
+import { isObject as h } from "./object/isObject.js";
+import { deepMerge as g } from "./object/deepMerge.js";
+import { generateText as _ } from "./string/generateText.js";
+import { generateTokenizedText as v } from "./string/generateTokenizedText.js";
+import { interpolate as y } from "./string/interpolate.js";
+import { interpolateLiteral as b } from "./string/interpolateLiteral.js";
+export { n as createElement, g as deepMerge, r as doElementsOverlap, e as extractByIndices, _ as generateText, v as generateTokenizedText, i as getCSSDeclaration, a as getElement, m as getRandomInteger, y as interpolate, b as interpolateLiteral, o as isElement, d as isFunction, f as isNil, h as isObject, s as isString, c as modifyElement, p as normalizeMinMax, l as removeElement, u as resolveClassName, t as standby };

package/dist/lang/isNil.cjs

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

package/dist/lang/isNil.d.ts

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

package/dist/lang/isNil.d.ts.map

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

package/dist/lang/isNil.js

@@ -1,4 +1,4 @@
-const i = (n) => n == null;
-export {
-  i as isNil
-};
+//#region src/lang/isNil.ts
+var e = (e) => e == null;
+//#endregion
+export { e as isNil };

package/dist/number/getRandomInteger.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("./normalizeMinMax.cjs"),o=(n=-Number.MAX_SAFE_INTEGER,r=Number.MAX_SAFE_INTEGER)=>{const{min:e,max:t}=m.normalizeMinMax(n,r);return Math.round(e+Math.random()*(t-e))};exports.getRandomInteger=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./normalizeMinMax.cjs`);var t=(t=-(2**53-1),n=2**53-1)=>{let{min:r,max:i}=e.normalizeMinMax(t,n);return Math.floor(r+Math.random()*(i-r+1))};exports.getRandomInteger=t;

package/dist/number/getRandomInteger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module number/getRandomInteger
+ */
+/**
+ * @function
+ * @example
+ * import { getRandomInteger } from '@untemps/utils/number/getRandomInteger'
+ *
+ * const min = 0
+ * const max = 100
+ * getRandomInteger(min, max) // 42
+ *
+ * @param min  - The minimum value to pick.
+ * @param max  - The maximum value to pick.
+ * @returns A random integer between min and max.
+ */
+export declare const getRandomInteger: (min?: number, max?: number) => number;
+//# sourceMappingURL=getRandomInteger.d.ts.map

package/dist/number/getRandomInteger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRandomInteger.d.ts","sourceRoot":"","sources":["../../src/number/getRandomInteger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAA8B,EAAE,YAA6B,KAAG,MAGhG,CAAA"}

package/dist/number/getRandomInteger.js

@@ -1,8 +1,8 @@
-import { normalizeMinMax as t } from "./normalizeMinMax.js";
-const a = (n = -Number.MAX_SAFE_INTEGER, r = Number.MAX_SAFE_INTEGER) => {
-  const { min: m, max: o } = t(n, r);
-  return Math.round(m + Math.random() * (o - m));
-};
-export {
-  a as getRandomInteger
+import { normalizeMinMax as e } from "./normalizeMinMax.js";
+//#region src/number/getRandomInteger.ts
+var t = (t = -(2 ** 53 - 1), n = 2 ** 53 - 1) => {
+	let { min: r, max: i } = e(t, n);
+	return Math.floor(r + Math.random() * (i - r + 1));
 };
+//#endregion
+export { t as getRandomInteger };

package/dist/number/normalizeMinMax.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=(e,t)=>({min:Math.min(e,t),max:Math.max(e,t)});exports.normalizeMinMax=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>({min:Math.min(e,t),max:Math.max(e,t)});exports.normalizeMinMax=e;

package/dist/number/normalizeMinMax.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module number/normalizeMinMax
+ */
+/**
+ * @function
+ * @example
+ * import { normalizeMinMax } from '@untemps/utils/number/normalizeMinMax'
+ *
+ * const min = 100
+ * const max = 0
+ * normalizeMinMax(min, max) // { min: 0, max: 100 }
+ *
+ * @param min  - The minimum value to evaluate.
+ * @param max  - The maximum value to evaluate.
+ * @returns An object where min and max properties are guaranteed.
+ */
+export declare const normalizeMinMax: (min: number, max: number) => {
+    min: number;
+    max: number;
+};
+//# sourceMappingURL=normalizeMinMax.d.ts.map

package/dist/number/normalizeMinMax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMinMax.d.ts","sourceRoot":"","sources":["../../src/number/normalizeMinMax.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAGnF,CAAA"}

package/dist/number/normalizeMinMax.js

@@ -1,7 +1,7 @@
-const t = (a, n) => ({
-  min: Math.min(a, n),
-  max: Math.max(a, n)
+//#region src/number/normalizeMinMax.ts
+var e = (e, t) => ({
+	min: Math.min(e, t),
+	max: Math.max(e, t)
 });
-export {
-  t as normalizeMinMax
-};
+//#endregion
+export { e as normalizeMinMax };

package/dist/object/deepMerge.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./isObject.cjs"),n=(e,t)=>{for(const i of Object.keys(e))b.isObject(e[i])&&i in t&&Object.assign(e[i],n(e[i],t[i]));return Object.assign(t||{},e),t};exports.deepMerge=n;
+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;

package/dist/object/deepMerge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module object/deepMerge
+ */
+/**
+ * @function
+ * @example
+ * import { deepMerge } from '@untemps/utils/object/deepMerge'
+ *
+ * const source = { foo: 1, bar: { gag: [1, 2, 3], pol: { mur: 'mur' } } }
+ * const target = { foo: 2, zaz: { juv: 1 }, bar: { gag: 'gag' } }
+ * deepMerge(source, target) // { foo: 1, zaz: { juv: 1 }, bar: { gag: [1, 2, 3], pol: { mur: 'mur' } } }
+ *
+ * @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.
+ */
+export declare const deepMerge: (source: Record<string, unknown>, target: Record<string, unknown>) => Record<string, unknown>;
+//# sourceMappingURL=deepMerge.d.ts.map

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

@@ -0,0 +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"}

package/dist/object/deepMerge.js

@@ -1,9 +1,8 @@
-import { isObject as b } from "./isObject.js";
-const f = (i, e) => {
-  for (const n of Object.keys(i))
-    b(i[n]) && n in e && Object.assign(i[n], f(i[n], e[n]));
-  return Object.assign(e || {}, i), e;
-};
-export {
-  f as deepMerge
+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;
 };
+//#endregion
+export { t as deepMerge };

package/dist/object/isObject.cjs

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

package/dist/object/isObject.d.ts

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

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

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

package/dist/object/isObject.js

@@ -1,4 +1,4 @@
-const e = (t) => Object.getPrototypeOf(t) === Object.prototype;
-export {
-  e as isObject
-};
+//#region src/object/isObject.ts
+var e = (e) => Object.getPrototypeOf(e) === Object.prototype;
+//#endregion
+export { e as isObject };

package/dist/string/generateText.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../number/getRandomInteger.cjs"),c=require("../number/normalizeMinMax.cjs"),g=["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"],M=(r,a)=>{const{min:e,max:n}=c.normalizeMinMax(Math.abs(r),Math.abs(a)),t=Math.max(e,1),o=Math.max(n,t);return{min:t,max:o}},h=({minWords:r=10,maxWords:a=50,dictionary:e=g}={})=>{let n="";const{min:t,max:o}=M(r,a),s=m.getRandomInteger(t,o);for(let i=0;i<s;i++){const l=e[Math.floor(Math.random()*e.length)];n+=`${i>0?" ":""}${l}`}return n};exports.generateText=h;
+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;

package/dist/string/generateText.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module string/generateText
+ */
+/**
+ * Configuration object for generateText.
+ */
+export interface GenerateTextConfig {
+    /** The minimum number of words to pick. */
+    minWords?: number;
+    /** The maximum number of words to pick. */
+    maxWords?: number;
+    /** A list of words from which picking the words. */
+    dictionary?: string[];
+}
+/**
+ * @function
+ * @example
+ * import { generateText } from '@untemps/utils/string/generateText'
+ *
+ * const minWords = 5;
+ * const maxWords = 10;
+ * const dictionary = ['foo', 'bar', 'gag'];
+ * generateText({minWords, maxWords, dictionary}) // bar foo foo gag gag bar gag gag
+ *
+ * @param config - The configuration object for the text generation.
+ * @returns The generated string.
+ */
+export declare const generateText: ({ minWords, maxWords, dictionary }?: GenerateTextConfig) => string;
+//# sourceMappingURL=generateText.d.ts.map

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

@@ -0,0 +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"}

package/dist/string/generateText.js

@@ -1,71 +1,19 @@
-import { getRandomInteger as m } from "../number/getRandomInteger.js";
-import { normalizeMinMax as c } from "../number/normalizeMinMax.js";
-const p = [
-  "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"
-], g = (a, n) => {
-  const { min: e, max: o } = c(Math.abs(a), Math.abs(n)), t = Math.max(e, 1), r = Math.max(o, t);
-  return {
-    min: t,
-    max: r
-  };
-}, x = ({ minWords: a = 10, maxWords: n = 50, dictionary: e = p } = {}) => {
-  let o = "";
-  const { min: t, max: r } = g(a, n), s = m(t, r);
-  for (let i = 0; i < s; i++) {
-    const l = e[Math.floor(Math.random() * e.length)];
-    o += `${i > 0 ? " " : ""}${l}`;
-  }
-  return o;
-};
-export {
-  x as generateText
+import { normalizeMinMax as e } from "../number/normalizeMinMax.js";
+import { getRandomInteger as t } from "../number/getRandomInteger.js";
+//#region src/string/generateText.ts
+var n = /* @__PURE__ */ "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(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(s, c);
+	for (let e = 0; e < l; e++) {
+		let t = a[Math.floor(Math.random() * a.length)];
+		o += `${e > 0 ? " " : ""}${t}`;
+	}
+	return o;
 };
+//#endregion
+export { i as generateText };

package/dist/string/generateTokenizedText.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./generateText.cjs");require("../number/getRandomInteger.cjs");require("../number/normalizeMinMax.cjs");const x=({tokens:e=[],divider:r="%",minWords:i=10,maxWords:l=50,dictionary:g=void 0}={})=>{const n=s.generateText({minWords:Math.max(i,e.length),maxWords:Math.max(l,e.length),dictionary:g}).split(" "),o=Math.max(Math.floor((n.length-e.length)/e.length),1),a=[];for(let t=0;t<e.length;t++){const h=Math.floor(Math.random()*o)+o*t;n[h]=`${r}${e[t]}${r}`,a.push(h)}return{indices:a,text:n.join(" ")}};exports.generateTokenizedText=x;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./generateText.cjs`);var t=({tokens:t=[],divider:n=`%`,minWords:r=10,maxWords:i=50,dictionary:a=void 0}={})=>{let o=e.generateText({minWords:Math.max(r,t.length),maxWords:Math.max(i,t.length),dictionary:a}).split(` `),s=Math.max(Math.floor((o.length-t.length)/t.length),1),c=[];for(let e=0;e<t.length;e++){let r=Math.floor(Math.random()*s)+s*e;o[r]=`${n}${t[e]}${n}`,c.push(r)}return{indices:c,text:o.join(` `)}};exports.generateTokenizedText=t;

package/dist/string/generateTokenizedText.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module string/generateTokenizedText
+ */
+/**
+ * Configuration object for generateTokenizedText.
+ */
+export interface GenerateTokenizedTextConfig {
+    /** The list of tokens. */
+    tokens?: string[];
+    /** The symbol that identifies a token. */
+    divider?: string;
+    /** The minimum number of words to pick. */
+    minWords?: number;
+    /** The maximum number of words to pick. */
+    maxWords?: number;
+    /** A list of words from which picking the words. */
+    dictionary?: string[];
+}
+/**
+ * @function
+ * @example
+ * import { generateTokenizedText } from '@untemps/utils/string/generateTokenizedText'
+ *
+ * const tokens = ['pol', 'biz', 'kuy']
+ * const divider = '$'
+ * const minWords = 5
+ * const maxWords = 10
+ * const dictionary = ['foo', 'bar', 'gag']
+ * generateTokenizedText(tokens, divider, minWords, maxWords, dictionary) // {indices: Array(3), text: "foo $pol$ $biz$ bar gag $kuy$ foo gag foo"}}
+ *
+ * @param config - The configuration object for the text generation.
+ * @returns An object containing a list of token indices and the generated string.
+ */
+export declare const generateTokenizedText: ({ tokens, divider, minWords, maxWords, dictionary, }?: GenerateTokenizedTextConfig) => {
+    indices: number[];
+    text: string;
+};
+//# sourceMappingURL=generateTokenizedText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateTokenizedText.d.ts","sourceRoot":"","sources":["../../src/string/generateTokenizedText.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAAI,uDAMnC,2BAAgC,KAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAkBtE,CAAA"}

package/dist/string/generateTokenizedText.js

@@ -1,27 +1,19 @@
-import { generateText as m } from "./generateText.js";
-import "../number/getRandomInteger.js";
-import "../number/normalizeMinMax.js";
-const p = ({
-  tokens: t = [],
-  divider: o = "%",
-  minWords: l = 10,
-  maxWords: x = 50,
-  dictionary: i = void 0
-} = {}) => {
-  const n = m({
-    minWords: Math.max(l, t.length),
-    maxWords: Math.max(x, t.length),
-    dictionary: i
-  }).split(" "), r = Math.max(Math.floor((n.length - t.length) / t.length), 1), h = [];
-  for (let e = 0; e < t.length; e++) {
-    const a = Math.floor(Math.random() * r) + r * e;
-    n[a] = `${o}${t[e]}${o}`, h.push(a);
-  }
-  return {
-    indices: h,
-    text: n.join(" ")
-  };
-};
-export {
-  p as generateTokenizedText
+import { generateText as e } from "./generateText.js";
+//#region src/string/generateTokenizedText.ts
+var t = ({ tokens: t = [], divider: n = "%", minWords: r = 10, maxWords: i = 50, dictionary: a = void 0 } = {}) => {
+	let o = e({
+		minWords: Math.max(r, t.length),
+		maxWords: Math.max(i, t.length),
+		dictionary: a
+	}).split(" "), s = Math.max(Math.floor((o.length - t.length) / t.length), 1), c = [];
+	for (let e = 0; e < t.length; e++) {
+		let r = Math.floor(Math.random() * s) + s * e;
+		o[r] = `${n}${t[e]}${n}`, c.push(r);
+	}
+	return {
+		indices: c,
+		text: o.join(" ")
+	};
 };
+//#endregion
+export { t as generateTokenizedText };

package/dist/string/interpolate.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../lang/isNil.cjs"),p=n=>{const e=new RegExp("([\\[\\^\\$\\.|\\?\\*\\+\\(\\)])+","g");return n.replace(e,r=>r.split("").map(t=>"\\"+t).join(""))},l=n=>Object.keys(n).reduce((r,t,s)=>`${r}${s>0?"|":""}${t}`,""),a=(n,e={},r="%")=>{const t=p(r),s=l(e),o=new RegExp(`${t}(${s})${t}`,"g");return n.replace(o,(g,i)=>c.isNil(e[i])?i:e[i])};exports.interpolate=a;
+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;

package/dist/string/interpolate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module string/interpolate
+ */
+/**
+ * @function
+ * @example
+ * import { interpolate } from '@untemps/utils/string/interpolate'
+ *
+ * const value = 'A %foo% with a "%bar%" wings and a lot of %fun%'
+ * const tokens = {
+ *  foo: 'bird',
+ *  bar: 3,
+ *  fun: 'dignity'
+ * }
+ * const divider = '%'
+ * interpolate(value, tokens, divider) // A bird with a "3" wings and a lot of dignity
+ *
+ * @param value    - The string value to interpolate.
+ * @param tokens   - An object of key/value pairs to replace the tokens.
+ * @param divider  - The symbol that identifies a token.
+ * @returns The interpolated string.
+ */
+export declare const interpolate: (value: string, tokens?: Record<string, unknown>, divider?: string) => string;
+//# sourceMappingURL=interpolate.d.ts.map

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

@@ -0,0 +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"}

package/dist/string/interpolate.js

@@ -1,14 +1,11 @@
-import { isNil as c } from "../lang/isNil.js";
-const i = (t) => {
-  const e = new RegExp("([\\[\\^\\$\\.|\\?\\*\\+\\(\\)])+", "g");
-  return t.replace(
-    e,
-    (o) => o.split("").map((n) => "\\" + n).join("")
-  );
-}, $ = (t) => Object.keys(t).reduce((o, n, p) => `${o}${p > 0 ? "|" : ""}${n}`, ""), d = (t, e = {}, o = "%") => {
-  const n = i(o), p = $(e), s = new RegExp(`${n}(${p})${n}`, "g");
-  return t.replace(s, (a, r) => c(e[r]) ? r : e[r]);
-};
-export {
-  d as interpolate
+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 = "%") => {
+	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]));
 };
+//#endregion
+export { r as interpolate };

package/dist/string/interpolateLiteral.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=(t,e)=>new Function(...Object.keys(e),`return \`${t}\``)(...Object.values(e));exports.interpolateLiteral=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=(e,t)=>Function(...Object.keys(t),`return \`${e}\``)(...Object.values(t));exports.interpolateLiteral=e;

package/dist/string/interpolateLiteral.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module string/interpolateLiteral
+ */
+/**
+ * @function
+ * @example
+ * import { interpolateLiteral } from '@untemps/utils/string/interpolateLiteral'
+ *
+ * const value = 'A ${foo} with ${bar} "wings" and a lot of ${fun}'
+ * const tokens = {
+ *  foo: 'bird',
+ *  bar: 3,
+ *  fun: 'dignity'
+ * }
+ * 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.
+ * @returns The interpolated string.
+ */
+export declare const interpolateLiteral: (value: string, tokens: Record<string, unknown>) => string;
+//# sourceMappingURL=interpolateLiteral.d.ts.map

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

@@ -0,0 +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"}

package/dist/string/interpolateLiteral.js

@@ -1,4 +1,4 @@
-const r = (t, e) => new Function(...Object.keys(e), `return \`${t}\``)(...Object.values(e));
-export {
-  r as interpolateLiteral
-};
+//#region src/string/interpolateLiteral.ts
+var e = (e, t) => Function(...Object.keys(t), `return \`${e}\``)(...Object.values(t));
+//#endregion
+export { e as interpolateLiteral };

package/dist/string/isString.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=t=>typeof t=="string"||Object.prototype.toString.call(t)==="[object String]";exports.isString=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>typeof e==`string`||Object.prototype.toString.call(e)===`[object String]`;exports.isString=e;

package/dist/string/isString.d.ts

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

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

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

package/dist/string/isString.js

@@ -1,4 +1,4 @@
-const o = (t) => typeof t == "string" || Object.prototype.toString.call(t) === "[object String]";
-export {
-  o as isString
-};
+//#region src/string/isString.ts
+var e = (e) => typeof e == "string" || Object.prototype.toString.call(e) === "[object String]";
+//#endregion
+export { e as isString };