@untemps/utils 4.0.0-beta.15 → 4.0.0-beta.17

package/README.md

@@ -39,4 +39,49 @@ import { interpolate } from '@untemps/utils/string/interpolate'
 
 ```js
 const { isNil } = require('@untemps/utils')
-```
+```
+
+## Available utilities
+
+Every utility is exported both from the package root and per-module at `@untemps/utils/<category>/<name>`. See the [Docs](https://utils.untemps.net) for full signatures, parameters, and examples.
+
+### array
+- **`extractByIndices`** — extract values from an array at the given indices
+
+### async
+- **`debounce`** — delay invocation until after a quiet period; returns a function with `.cancel()`
+- **`standby`** — return a promise that resolves after the given delay
+- **`throttle`** — invoke at most once per interval (leading + trailing); returns a function with `.cancel()`
+
+### dom
+- **`createElement`** — create a DOM element from a configuration object
+- **`doElementsOverlap`** — check whether two DOM elements overlap on screen
+- **`getCSSDeclaration`** — find a CSS rule by class name across `document.styleSheets`
+- **`getElement`** — query a DOM element by selector
+- **`isElement`** — check whether a value is a DOM element
+- **`modifyElement`** — set attributes on a DOM element (by reference or selector)
+- **`removeElement`** — remove a DOM element (by reference or selector)
+- **`resolveClassName`** — aggregate class names from strings or `[condition, ifTrue, ifFalse]` tuples
+
+### function
+- **`isFunction`** — check whether a value is a function
+
+### lang
+- **`isNil`** — check whether a value is `null` or `undefined`
+
+### number
+- **`clamp`** — clamp a number between two bounds
+- **`getRandomInteger`** — return a pseudo-random integer in `[min, max]`
+- **`normalizeMinMax`** — return `[min, max]` ensuring `min <= max`
+
+### object
+- **`deepClone`** — structured-clone deep copy (functions and DOM nodes are not supported)
+- **`deepMerge`** — recursively merge a source into a target with circular-reference support
+- **`isObject`** — check whether a value is a plain object
+
+### string
+- **`generateText`** — generate a string from a dictionary using configurable rules
+- **`generateTokenizedText`** — like `generateText` but also returns token indices
+- **`interpolate`** — replace `%key%`-style tokens in a string
+- **`interpolateLiteral`** — replace `${key}`-style tokens in a literal-like string
+- **`isString`** — check whether a value is a string

package/dist/dom/getCSSDeclaration.cjs

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

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

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

package/dist/dom/getCSSDeclaration.js

@@ -1,8 +1,16 @@
 //#region src/dom/getCSSDeclaration.ts
 var e = (e, t = !1) => {
-	if (e && (e = e.startsWith(".") ? e : `.${e}`, document.styleSheets?.length)) for (let n of document.styleSheets) for (let r of n.cssRules) {
-		let n = r;
-		if (n.selectorText === e && n.style) return t ? n.style.cssText : n.style;
+	if (e && (e = e.startsWith(".") ? e : `.${e}`, document.styleSheets?.length)) for (let n of document.styleSheets) {
+		let r;
+		try {
+			r = n.cssRules;
+		} catch {
+			continue;
+		}
+		for (let n of r) {
+			let r = n;
+			if (r.selectorText === e && r.style) return t ? r.style.cssText : r.style;
+		}
 	}
 	return null;
 };

package/dist/string/interpolate.cjs

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

package/dist/string/interpolate.js

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

package/package.json

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