@untemps/utilsZero-dependency TypeScript utilities

Installation ​

yarn add @untemps/utils

// Barrel import (tree-shaken)
import { isNil, interpolate, createElement } from '@untemps/utils'

// Or per-module, for the leanest bundles
import { isNil } from '@untemps/utils/lang/isNil'

Requirements: Node.js >= 20.

Catalog ​

array ​

• extractByIndices — extract values from an array at the given indices

async ​

• debounce — delay invocation until after a quiet period
• standby — resolve a promise after the given delay
• throttle — invoke at most once per interval

dom ​

• createElement — create a DOM element from a configuration object
• doElementsOverlap — check whether two elements overlap on screen
• getCSSDeclaration — find a CSS rule by class name across 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 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 } ordered so min <= max

object ​

• deepClone — structured-clone deep copy
• deepMerge — recursively merge objects 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, also returning 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