@untemps/utils 2.6.0 → 3.1.0

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

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

package/dist/object/deepMerge.cjs

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

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

@@ -0,0 +1,8 @@
+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

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

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

package/dist/string/generateText.cjs

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

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

@@ -0,0 +1,19 @@
+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

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

@@ -0,0 +1,19 @@
+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

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

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

@@ -0,0 +1,11 @@
+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

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

@@ -0,0 +1,4 @@
+//#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

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@untemps/utils",
-	"version": "2.6.0",
-	"description": "",
+	"version": "3.1.0",
+	"description": "Utils for @untemps packages",
 	"repository": "git@github.com:untemps/utils.git",
 	"keywords": [],
 	"author": "Vincent Le Badezet <v.lebadezet@untemps.net>",
@@ -10,63 +10,45 @@
 	"publishConfig": {
 		"access": "public"
 	},
+	"type": "module",
 	"files": [
 		"dist"
 	],
+	"types": "./dist/index.d.ts",
 	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		},
 		"./*": {
-			"import": "./dist/esm/*.js",
-			"require": "./dist/cjs/*.js"
+			"types": "./dist/*.d.ts",
+			"import": "./dist/*.js",
+			"require": "./dist/*.cjs"
 		}
 	},
+	"sideEffects": false,
 	"engines": {
-		"node": ">=14.17"
+		"node": ">=24"
 	},
 	"devDependencies": {
-		"@babel/cli": "^7.17.6",
-		"@babel/core": "^7.17.5",
-		"@babel/plugin-transform-runtime": "^7.17.0",
-		"@babel/preset-env": "^7.16.11",
-		"@commitlint/cli": "^16.2.3",
-		"@commitlint/config-conventional": "^16.2.1",
-		"@rollup/plugin-babel": "^5.3.1",
-		"@rollup/plugin-node-resolve": "^13.1.3",
-		"@rollup/plugin-strip": "^2.1.0",
-		"@semantic-release/changelog": "^6.0.1",
+		"@commitlint/cli": "^20.0.0",
+		"@commitlint/config-conventional": "^20.0.0",
+		"@semantic-release/changelog": "^6.0.3",
 		"@semantic-release/git": "^10.0.1",
-		"@semantic-release/github": "^8.0.2",
-		"@testing-library/dom": "^8.11.3",
-		"@testing-library/jest-dom": "^5.16.2",
-		"babel-jest": "^27.5.1",
-		"clean-jsdoc-theme": "^4.1.8",
-		"commitlint": "^16.2.3",
-		"cross-env": "^7.0.2",
-		"docdash": "^1.2.0",
-		"fast-check": "^2.22.0",
-		"foodoc": "^0.0.9",
-		"glob": "^8.0.3",
-		"husky": "^7.0.0",
-		"jest": "^27.5.1",
-		"jsdoc": "^3.6.11",
-		"prettier": "^2.5.1",
-		"rimraf": "^3.0.2",
-		"rollup": "^2.68.0",
-		"rollup-plugin-filesize": "^9.1.2",
-		"rollup-plugin-multi-input": "^1.3.1",
-		"rollup-plugin-progress": "^1.1.2",
-		"rollup-plugin-terser": "^7.0.2",
-		"semantic-release": "^19.0.2"
-	},
-	"dependencies": {
-		"@babel/runtime": "^7.17.8"
-	},
-	"jest": {
-		"setupFilesAfterEnv": [
-			"<rootDir>/jest-setup.js"
-		],
-		"testEnvironment": "jsdom",
-		"coverageDirectory": "./coverage/",
-		"collectCoverage": true
+		"@semantic-release/github": "^12.0.0",
+		"@testing-library/jest-dom": "^6.0.0",
+		"@types/node": "^25.5.0",
+		"@vitest/coverage-v8": "^3.0.0",
+		"fast-check": "^4.0.0",
+		"husky": "^9.0.0",
+		"jsdom": "^26.0.0",
+		"prettier": "^3.0.0",
+		"semantic-release": "^25.0.0",
+		"typedoc": "^0.28.18",
+		"typescript": "^6.0.2",
+		"vite": "^8.0.0",
+		"vitest": "^3.0.0"
 	},
 	"release": {
 		"branches": [
@@ -97,13 +79,11 @@
 		]
 	},
 	"scripts": {
-		"docs": "rimraf docs && jsdoc -c jsdoc.json",
-		"test": "jest -u --watchAll",
-		"test:ci": "jest -u -b --ci --coverage",
-		"build": "rimraf dist && yarn build:cjs && yarn build:esm",
-		"build:cjs": "cross-env NODE_ENV=production BABEL_ENV=cjs rollup -c",
-		"build:esm": "cross-env NODE_ENV=production BABEL_ENV=esm rollup -c",
-		"prettier": "prettier \"*/**/*.js\" --ignore-path ./.prettierignore --write && git add . && git status",
-		"prepare": "husky install"
+		"docs": "typedoc && node scripts/open-docs.mjs",
+		"test": "vitest",
+		"test:ci": "vitest run --coverage",
+		"build": "vite build && tsc -p tsconfig.build.json",
+		"prettier": "prettier \"src/**/*.ts\" --ignore-path ./.prettierignore --write && git add . && git status",
+		"prepare": "husky"
 	}
 }

package/dist/cjs/array/extractByIndices.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.extractByIndices=function(e,t){var n;return null!==(n=null==e?void 0:e.filter((function(e,n){return null==t?void 0:t.includes(n)})))&&void 0!==n?n:[]};

package/dist/cjs/async/standby.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.standby=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:128;return new Promise((function(t){return setTimeout(t,e)}))};

package/dist/cjs/dom/createElement.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.createElement=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},t=e.tag,n=void 0===t?"div":t,o=e.attributes,d=void 0===o?{}:o,i=e.content,l=void 0===i?null:i,r=e.textContent,u=void 0===r?null:r,a=e.parent,c=void 0===a?null:a,v=e.parentSelector,p=void 0===v?null:v,s=e.boundingClientRect,C=void 0===s?null:s,h=document.createElement(n);for(var g in d)h.setAttribute(g,d[g]);l&&h.appendChild(l),u&&!h.hasChildNodes()&&h.appendChild(document.createTextNode(u));var m=c||document.querySelector(p);return m&&m.appendChild(h),C&&(h.getBoundingClientRect=function(){return C}),h};

package/dist/cjs/dom/doElementsOverlap.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.doElementsOverlap=function(t,e){var o=t.getBoundingClientRect(),n=o.left,r=o.right,i=o.top,l=o.bottom,u=e.getBoundingClientRect(),g=u.left,p=u.right,s=u.top;return!(i>u.bottom||r<g||l<s||n>p)};

package/dist/cjs/dom/getCSSDeclaration.js

@@ -1 +0,0 @@
-"use strict";function t(t,r){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!n){if(Array.isArray(t)||(n=function(t,r){if(!t)return;if("string"==typeof t)return e(t,r);var n=Object.prototype.toString.call(t).slice(8,-1);"Object"===n&&t.constructor&&(n=t.constructor.name);if("Map"===n||"Set"===n)return Array.from(t);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return e(t,r)}(t))||r&&t&&"number"==typeof t.length){n&&(t=n);var o=0,a=function(){};return{s:a,n:function(){return o>=t.length?{done:!0}:{done:!1,value:t[o++]}},e:function(t){throw t},f:a}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var i,l=!0,u=!1;return{s:function(){n=n.call(t)},n:function(){var t=n.next();return l=t.done,t},e:function(t){u=!0,i=t},f:function(){try{l||null==n.return||n.return()}finally{if(u)throw i}}}}function e(t,e){(null==e||e>t.length)&&(e=t.length);for(var r=0,n=new Array(e);r<e;r++)n[r]=t[r];return n}Object.defineProperty(exports,"__esModule",{value:!0});exports.getCSSDeclaration=function(e){var r,n=arguments.length>1&&void 0!==arguments[1]&&arguments[1];if(e&&(e=e.startsWith(".")?e:".".concat(e),null!==(r=document.styleSheets)&&void 0!==r&&r.length)){var o,a=t(document.styleSheets);try{for(a.s();!(o=a.n()).done;){var i,l=o.value.cssRules,u=t(l);try{for(u.s();!(i=u.n()).done;){var c=i.value,f=c.selectorText,s=c.style;if(f===e&&s)return n?s.cssText:s}}catch(t){u.e(t)}finally{u.f()}}}catch(t){a.e(t)}finally{a.f()}}return null};

package/dist/cjs/dom/getElement.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.getElement=function(e){return document.querySelector(e)};

package/dist/cjs/dom/isElement.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.isElement=function(e){return 1===(null==e?void 0:e.nodeType)};

package/dist/cjs/dom/modifyElement.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../string/isString.js");exports.modifyElement=function(r){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},i=r;for(var n in e.isString(r)&&(i=document.querySelector(r)),t){var o,u;if(void 0===t[n]||null===t[n])null===(o=i)||void 0===o||o.removeAttribute(n);else null===(u=i)||void 0===u||u.setAttribute(n,t[n])}return i};

package/dist/cjs/dom/removeElement.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../string/isString.js");exports.removeElement=function(r){var t,i,o=r;return e.isString(r)&&(o=document.querySelector(r)),null===(t=o)||void 0===t||null===(i=t.parentNode)||void 0===i?void 0:i.removeChild(o)};

package/dist/cjs/dom/resolveClassName.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/toConsumableArray"),r=require("@babel/runtime/helpers/slicedToArray");function t(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var n=t(e),u=t(r),l=function(e){return e&&"string"==typeof e?e:null};exports.resolveClassName=function(e){return null!=e&&e.length?e.reduce((function(e,r){if(Array.isArray(r)){var t=r,a=u.default(t,3),o=a[0],i=a[1],s=a[2];r=o?i:s}return l(r)?[].concat(n.default(e),[r]):e}),[]).join(" "):""};

package/dist/cjs/function/isFunction.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.isFunction=function(e){return"function"==typeof e};

package/dist/cjs/lang/isNil.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.isNil=function(e){return null==e};

package/dist/cjs/number/getRandomInteger.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./normalizeMinMax.js");exports.getRandomInteger=function(){var r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:-Number.MAX_SAFE_INTEGER,n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:Number.MAX_SAFE_INTEGER,t=e.normalizeMinMax(r,n),a=t.min,o=t.max;return Math.round(a+Math.random()*(o-a))};

package/dist/cjs/number/normalizeMinMax.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.normalizeMinMax=function(e,t){return{min:Math.min(e,t),max:Math.max(e,t)}};

package/dist/cjs/object/deepMerge.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./isObject.js");exports.deepMerge=function r(t,s){for(var i=0,c=Object.keys(t);i<c.length;i++){var n=c[i];e.isObject(t[n])&&n in s&&Object.assign(t[n],r(t[n],s[n]))}return Object.assign(s||{},t),s};

package/dist/cjs/object/isObject.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.isObject=function(e){return Object.getPrototypeOf(e)===Object.prototype};

package/dist/cjs/string/generateText.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../number/getRandomInteger.js"),r=require("../number/normalizeMinMax.js"),a=["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"],i=function(e,a){var i=r.normalizeMinMax(Math.abs(e),Math.abs(a)),o=i.min,n=i.max,t=Math.max(o,1);return{min:t,max:Math.max(n,t)}};exports.generateText=function(){for(var r=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},o=r.minWords,n=void 0===o?10:o,t=r.maxWords,s=void 0===t?50:t,m=r.dictionary,l=void 0===m?a:m,c="",d=i(n,s),g=d.min,p=d.max,u=e.getRandomInteger(g,p),h=0;h<u;h++){var v=l[Math.floor(Math.random()*l.length)];c+="".concat(h>0?" ":"").concat(v)}return c};

package/dist/cjs/string/generateTokenizedText.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./generateText.js");require("../number/getRandomInteger.js"),require("../number/normalizeMinMax.js");exports.generateTokenizedText=function(){for(var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},r=t.tokens,n=void 0===r?[]:r,o=t.divider,i=void 0===o?"%":o,a=t.minWords,d=void 0===a?10:a,s=t.maxWords,h=void 0===s?50:s,l=t.dictionary,c=void 0===l?void 0:l,g=e.generateText({minWords:Math.max(d,n.length),maxWords:Math.max(h,n.length),dictionary:c}),m=g.split(" "),v=Math.max(Math.floor((m.length-n.length)/n.length),1),x=[],u=0;u<n.length;u++){var M=Math.floor(Math.random()*v)+v*u;m[M]="".concat(i).concat(n[u]).concat(i),x.push(M)}return{indices:x,text:m.join(" ")}};

package/dist/cjs/string/interpolate.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../lang/isNil.js"),n=function(e){var n=new RegExp("([\\[\\^\\$\\.|\\?\\*\\+\\(\\)])+","g");return e.replace(n,(function(e){return e.split("").map((function(e){return"\\"+e})).join("")}))},t=function(e){return Object.keys(e).reduce((function(e,n,t){return"".concat(e).concat(t>0?"|":"").concat(n)}),"")};exports.interpolate=function(r){var c=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},o=arguments.length>2&&void 0!==arguments[2]?arguments[2]:"%",i=n(o),u=t(c),a=new RegExp("".concat(i,"(").concat(u,")").concat(i),"g");return r.replace(a,(function(n,t){return e.isNil(c[t])?t:c[t]}))};

package/dist/cjs/string/interpolateLiteral.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@babel/runtime/helpers/construct"),t=require("@babel/runtime/helpers/toConsumableArray");function r(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var u=r(e),a=r(t);exports.interpolateLiteral=function(e,t){return u.default(Function,a.default(Object.keys(t)).concat(["return `".concat(e,"`")])).apply(void 0,a.default(Object.values(t)))};

package/dist/cjs/string/isString.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.isString=function(t){return"string"==typeof t||"[object String]"===Object.prototype.toString.call(t)};

package/dist/esm/array/extractByIndices.js

@@ -1 +0,0 @@
-var n=function(n,l){var r;return null!==(r=null==n?void 0:n.filter((function(n,r){return null==l?void 0:l.includes(r)})))&&void 0!==r?r:[]};export{n as extractByIndices};

package/dist/esm/async/standby.js

@@ -1 +0,0 @@
-var e=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:128;return new Promise((function(n){return setTimeout(n,e)}))};export{e as standby};

package/dist/esm/dom/createElement.js

@@ -1 +0,0 @@
-var e=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{},t=e.tag,n=void 0===t?"div":t,d=e.attributes,o=void 0===d?{}:d,i=e.content,l=void 0===i?null:i,r=e.textContent,u=void 0===r?null:r,a=e.parent,v=void 0===a?null:a,c=e.parentSelector,p=void 0===c?null:c,C=e.boundingClientRect,h=void 0===C?null:C,g=document.createElement(n);for(var m in o)g.setAttribute(m,o[m]);l&&g.appendChild(l),u&&!g.hasChildNodes()&&g.appendChild(document.createTextNode(u));var s=v||document.querySelector(p);return s&&s.appendChild(g),h&&(g.getBoundingClientRect=function(){return h}),g};export{e as createElement};

package/dist/esm/dom/doElementsOverlap.js

@@ -1 +0,0 @@
-var t=function(t,e){var o=t.getBoundingClientRect(),n=o.left,i=o.right,r=o.top,g=o.bottom,l=e.getBoundingClientRect(),u=l.left,c=l.right,f=l.top;return!(r>l.bottom||i<u||g<f||n>c)};export{t as doElementsOverlap};

package/dist/esm/dom/getCSSDeclaration.js

@@ -1 +0,0 @@
-function t(t,n){var e="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(!e){if(Array.isArray(t)||(e=function(t,n){if(!t)return;if("string"==typeof t)return r(t,n);var e=Object.prototype.toString.call(t).slice(8,-1);"Object"===e&&t.constructor&&(e=t.constructor.name);if("Map"===e||"Set"===e)return Array.from(t);if("Arguments"===e||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(e))return r(t,n)}(t))||n&&t&&"number"==typeof t.length){e&&(t=e);var o=0,a=function(){};return{s:a,n:function(){return o>=t.length?{done:!0}:{done:!1,value:t[o++]}},e:function(t){throw t},f:a}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var i,l=!0,u=!1;return{s:function(){e=e.call(t)},n:function(){var t=e.next();return l=t.done,t},e:function(t){u=!0,i=t},f:function(){try{l||null==e.return||e.return()}finally{if(u)throw i}}}}function r(t,r){(null==r||r>t.length)&&(r=t.length);for(var n=0,e=new Array(r);n<r;n++)e[n]=t[n];return e}var n=function(r){var n,e=arguments.length>1&&void 0!==arguments[1]&&arguments[1];if(r&&(r=r.startsWith(".")?r:".".concat(r),null!==(n=document.styleSheets)&&void 0!==n&&n.length)){var o,a=t(document.styleSheets);try{for(a.s();!(o=a.n()).done;){var i,l=o.value.cssRules,u=t(l);try{for(u.s();!(i=u.n()).done;){var f=i.value,c=f.selectorText,s=f.style;if(c===r&&s)return e?s.cssText:s}}catch(t){u.e(t)}finally{u.f()}}}catch(t){a.e(t)}finally{a.f()}}return null};export{n as getCSSDeclaration};

package/dist/esm/dom/getElement.js

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

package/dist/esm/dom/isElement.js

@@ -1 +0,0 @@
-var n=function(n){return 1===(null==n?void 0:n.nodeType)};export{n as isElement};

package/dist/esm/dom/modifyElement.js

@@ -1 +0,0 @@
-import{isString as r}from"../string/isString.js";var t=function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},i=t;for(var o in r(t)&&(i=document.querySelector(t)),e){var n,l;if(void 0===e[o]||null===e[o])null===(n=i)||void 0===n||n.removeAttribute(o);else null===(l=i)||void 0===l||l.setAttribute(o,e[o])}return i};export{t as modifyElement};

package/dist/esm/dom/removeElement.js

@@ -1 +0,0 @@
-import{isString as r}from"../string/isString.js";var o=function(o){var e,i,n=o;return r(o)&&(n=document.querySelector(o)),null===(e=n)||void 0===e||null===(i=e.parentNode)||void 0===i?void 0:i.removeChild(n)};export{o as removeElement};

package/dist/esm/dom/resolveClassName.js

@@ -1 +0,0 @@
-import r from"@babel/runtime/helpers/toConsumableArray";import e from"@babel/runtime/helpers/slicedToArray";var n=function(n){return null!=n&&n.length?n.reduce((function(n,o){if(Array.isArray(o)){var i=e(o,3),u=i[0],l=i[1],a=i[2];o=u?l:a}return t(o)?[].concat(r(n),[o]):n}),[]).join(" "):""},t=function(r){return r&&"string"==typeof r?r:null};export{n as resolveClassName};

package/dist/esm/function/isFunction.js

@@ -1 +0,0 @@
-var n=function(n){return"function"==typeof n};export{n as isFunction};

package/dist/esm/lang/isNil.js

@@ -1 +0,0 @@
-var n=function(n){return null==n};export{n as isNil};

package/dist/esm/number/getRandomInteger.js

@@ -1 +0,0 @@
-import{normalizeMinMax as r}from"./normalizeMinMax.js";var n=function(){var n=arguments.length>0&&void 0!==arguments[0]?arguments[0]:-Number.MAX_SAFE_INTEGER,o=arguments.length>1&&void 0!==arguments[1]?arguments[1]:Number.MAX_SAFE_INTEGER,a=r(n,o),m=a.min,t=a.max;return Math.round(m+Math.random()*(t-m))};export{n as getRandomInteger};

package/dist/esm/number/normalizeMinMax.js

@@ -1 +0,0 @@
-var a=function(a,n){return{min:Math.min(a,n),max:Math.max(a,n)}};export{a as normalizeMinMax};

package/dist/esm/object/deepMerge.js

@@ -1 +0,0 @@
-import{isObject as r}from"./isObject.js";var t=function t(e,n){for(var s=0,i=Object.keys(e);s<i.length;s++){var a=i[s];r(e[a])&&a in n&&Object.assign(e[a],t(e[a],n[a]))}return Object.assign(n||{},e),n};export{t as deepMerge};