## Everything you constantly need for development (and probably still copy-pasting from other projects) The promise: - **✅ 1 package**: say goodbye to lodash, faker, and the other package you don't recall the name of. - **⭕ 0 dependencies**: keep it simple and lightweight. - **🏆 Pick the best**: the code is minimal and uses the best practices for max performance. - **🤖 AI**: Functions are reviewed by AI to make sure all corner cases are covered. - **👪🏼 Typescript**: use it, support it and export it. - **🌊 Intuitive**: favour always the most intuitive API and common usage, _never_ throw error unless asked to. - **🙈 Semantic**: use simple function names that are easy to remember, no complicated options. Contributions always welcome! ### Validators - `isArray()` - `isArrayIncluded()` - `isBoolean()` - `isBrowser()` to detect if you are on the browser - `isBuffer()` if it's a buffer - `isClient()` same as isBrowser - `isEmail()` this is a relaxed check, use your own validation if you need to be strict - ⭐ `isEmpty()` to check for empty object, empty array, empty string, null or undefined - `isEmptyString()` trims the string and checks if something is left - `isEmptyArray()` checks if the array has no items - `isEmptyObject()` checks if the object has no keys - `isFile()` if it's a file - `isFunction()` - `isJsDate()` if it's a **valid** javascript's Date - `isBetweenDates()` check if date falls between two other dates (left inclusive: includes start, excludes end) - `isInDateRange()` alias of `isBetweenDates()` - `isFutureDate()` check if date is in the future, optionally against a reference date - `isPastDate()` check if date is in the past, optionally against a reference date - `isSameUTCDay()` same calendar day in UTC - `isStringDate()` also checks if the string passed is a **valid** date - `isKey()` is a real key of an object - `isLastIndex()` is the index is the last item of array - `isNotEmptyString()` must have some text, checks for spaces-only - `isNumber()` if the arg is number, and also usable (no infinity) - `isInt()` if it's an integer - `isEven()` - `isOdd()` - `isPositiveInt()` - `isNegativeInt()` - `isBigInt()` if the arg is a bigint - `isBigIntString()` if the string is a valid bigint literal - `isOutsideInt4()` if a number is outside PostgreSQL `int4` range - `isNumeric()` if string is representing a number - `isNumericId()` if it's a valid numeric ID - ⭐ `isObject()` if it's a js plain Object - `isPromise()` if it's a promise - `isPWA()` to detect if you are on a PWA - `isReactElement()` if it's a valid React Element - `isRegExp()` if it's a valid RegExp - ⭐ `isSame()` Compare if dates, functions, arrays, objects or anything else are the same - `isSequence()` if the array is a perfect sequence - `isServer()` if you are on the server - `isSpacedString()` if string contains spaces - `isString()` - `isURL()` - `isUUID()` if it's a valid UUID - `isValue()` if it's a defined value (not null, undefined, or empty string) ### Dates - `getDateRangeSeries()` generate a series of dates within a range - `getDateSeriesRange()` get the smallest and biggest dates from an array of dates - `groupByDateBucket()` group items into date buckets based on their dates and specified time intervals - `isOver18()` check if someone is over 18 years old - `startOfDay()` get the start of a specific day - `startOfNextMonth()` - `startOfNextWeek()` - `startOfThisWeek()` - `startOfToday()` - `startOfTomorrow()` - `startOfYesterday()` - `startOfUTCDay()` get the start of a specific day in UTC - `startOfUTCTomorrow()` get the start of tomorrow in UTC ### Math - `average()` - `countDecimals()` count the number of decimal places in a number - `isBetween()` - `isOutside()` - `isStrictlyBetween()` - `max()` - `min()` - `multiply()` - `normaliseArray()` - `normaliseNumber()` - `percentageChange()` - `sum()` ### Helpers - `array()` create an arbitrary array based on a function - `arrayDiff()` get the difference of two arrays - `arrayIntersection()` get the intersection of two arrays - `capitalize()` word => Word - `chunkArray()` split array into chunks - `chunkText()` split text into chunks of a given character size, optionally preserving sentence boundaries via `Intl.Segmenter` - `chunkedAll()` process all items in chunks - `chunkedAsync()` process async operations in chunks - `chunkedDynamic()` process with dynamic chunk sizes - `clamp()` clamp number in a range - `cleanSpaces()` trims and turns double spaces into single space - `copyToClipboard()` copy a string to the system clipboard (browser only) - `cyclicalItem()` get item from array with cyclical indexing - `dir()` get directory listing - `enumKeys()` enum FRUIT { APPLE, PEAR } => ["APPLE", "PEAR"] - `enumValues()` enum FRUIT { APPLE = 1, PEAR = 3 } => [1, 3] - `filterAlphanumeric()` remove non-alphanumeric characters - `first()` get the first element of an array - `firstKey()` get the first key of an object - `firstValue()` get the first value of an object - `getCookieByName()` get cookie value by name - `getKeys()` get all keys from an object - `getUrlSearchParam()` get URL search param - `getUrlSearchParams()` get URL search params - `groupByKey()` - `incrementalId()` autoincremental SQL-like, process-unique numeric id - `keysLength()` get the length of keys in an object - `last()` get the last element of an array - `lastIndex()` get the last index of an array - `mapByKey()` - ⭐ `merge()` deep merge objects - `mergeArrays()` merge multiple arrays - `moveToFirst()` move array element to first - `moveToIndex()` move array element to desired index - `moveToLast()` move array element to last - `normalizeNumber()` normalizes between 0 and 1 - `normalizeString()` trim, strip diacritics (Unicode NFD), lowercase - `noop()` no-op function - `omit()` omit properties from object - ⭐ `parseDate()` pass anything Date-Like, and get a JS Date back - `parseArray()` split a string into parsed primitives (comma-separated by default) - `parsePrimitive()` coerce a string to boolean, number, null, undefined, or trimmed string - `pickObjectKeys()` pick specific keys from object - `pickObjectValues()` pick specific values from object - `pluck()` make array of value from object keys - `prismaDateRange()` `{ gte, lt }` window from a start/end range for Prisma filters - `promiseWithTimeout()` takes a promise, a timeoutMs, and an option error as arguments. Returns a new Promise that either resolves with the value of the input promise or rejects with the provided error or a default error message if the input promise does not resolve or reject within the specified timeoutMs. - `removeUndefinedValues()` remove undefined values from object - `scrambleText()` replace alpha chars with random chars - `serialize()` serialize object to string - `seriesAsync()` executes promises in series, and returns all results - `setObjectPath()` set a value in an object by path - `setUrlSearchParams()` set URL search params - `formatTrpcInputQueryString()` serialize a tRPC procedure input to `URLSearchParams` - `shuffle()` shuffles elements in an array - `singleton()` lazily-initialized singleton from a factory (sync or async) - `sleep()` promise-based sleep - `stringify()` stringify anything, without breaking on circular dependencies - `toggleArrayValue()` remove/add value in array - `truncate()` truncate text, does not break emojis - `uniqueValues()` gets unique values in an array ### Formatters - `formatCamelCase()` "hello-world" => "helloWorld" - `formatCookies()` { cookie1: "1", cookie2: "2" } => "cookie1=1; cookie2=2" - `formatCount()` "#items: 3, #users: 5" - `formatDateRange()` "2026-02-09T00:00... ⮕ 2026-02-10T00:00..." - `formatIndexProgress()` => "[2/10]" - `formatInitials()` first letters of the first one or two words, capitalized - `formatProgress()` progress string with optional id prefix - `formatNumber()` 1000 => "1,000" or "1K" or 0.112 => "11.2%" - `formatPascalCase()` "hello-world" => "HelloWorld" - `formatPercentage()` 0.11 => "11%" - `formatPercentageNumber()` numeric percentage (e.g. 0.123 => 12.35) before formatting as string - `formatSlug()` transliterate and format a URL/identifier slug; supports `strict`, custom `map` / replacement - `stringToCSSUnicode()` "hello" => "\000068\000065\00006c\00006c\00006f" use this for CSS - `stringToUnicode()` "hello" => "\u0068\u0065\u006c\u006c\u006f" ### Random data generators These functions are optimized for low entropy random data generation useful for Unit Testing, Storybook, Pass real validations, Reverse hacking, Penetration testing... - `randomAddress()` - `randomAlphaNumericCode()` - `randomArray()` - ⭐ `randomArrayItem()` now supporting non-uniform distribution - `randomBankAccount()` - `randomBool()` - `randomChar()` - `randomCompany()` - ⭐ `randomCoords()` - `randomLat()` - `randomLng()` - `randomDate()` a safe range in decade - `randomMaxDate()` a range in the Max dates allowed by JS - `randomFutureDate()` - `randomPastDate()` - `randomDateRange()` => { startDate, endDate } - `randomEmail()` - `randomEmoji()` - `randomEmptyValue()` random empty value (null, undefined, empty string) - `randomEnumKey()` enum FRUIT { APPLE, PEAR } => APPLE - `randomEnumValue()` enum FRUIT { APPLE = 1, PEAR = 3 } => 3 - `randomFile()` - `randomFloat()` - `randomFormattedPercentage()` random percentage string for tests - `randomObject()` - `randomObjectKey()` get a random key from an object - `randomObjectValue()` get a random value from an object - `randomHandle()` useful for social identifiers, or slugs - `randomHexColor()` - `randomHexValue()` - `randomHtmlColorName()` - `randomIBAN()` - `randomInt()` - `randomBigInt()` - `randomMaxInt()` Range within the Maximum integer supported by js - `randomMaxSafeInt()` Range of very BIG integers, which are still safe to use tho - `randomNegativeInt()` < 0 - `randomPositiveInt()` > 0 - `randomIP()` - `randomName()` - `randomFirstName()` - `randomLastName()` - `randomFullName()` - `randomNumericCode()` - `randomObject()` - `randomParagraph()` - `randomPassword()` - `randomPath()` /path/to/something - `randomPhoneNumber()` - `randomString()` - `randomSymbol()` - `randomUUID()` lightweight uuid generation, passing UUID validation - `randomValue()` - `randomWord()` - `randomNoun()` - `randomVerb()` ### TypeScript Helpers & Generics - `Coords` - `DateLike` - `Defined` - `Dimensions` - `Function` - `HashMap<>` - `BoolMap` - `NumberMap` - `StringMap` - `TrueMap` - `Key` - `Matrix` - `Maybe<>` - `MaybePromise<>` - `MaybePromiseOrValue<>` - `MaybePromiseOrValueArray<>` - `NonUndefined` - `Object` - `PickDefined` - `PickRequired` - `PlainKey` - `Point` - `PrismaSelect` - `Serialized` - `Tuple` ## Development After changes, run ``` pnpm release ``` To bump the version. CI will take care of publishing the package when merged.