@tempots/std 0.18.0 → 0.20.0

package/README.md

@@ -1,3 +1,144 @@
-# Tempo Standard Library
+# Tempo Standard Library (@tempots/std)
 
-A standard library for TypeScript.
+A comprehensive standard library for TypeScript that provides utility functions and types commonly used in web applications. This package serves as a natural complement to the Tempo libraries but can be used independently in any TypeScript project.
+
+[![npm version](https://img.shields.io/npm/v/@tempots/std.svg)](https://www.npmjs.com/package/@tempots/std)
+[![license](https://img.shields.io/npm/l/@tempots/std.svg)](https://github.com/fponticelli/tempots/blob/main/LICENSE)
+
+## Installation
+
+```bash
+# npm
+npm install @tempots/std
+
+# yarn
+yarn add @tempots/std
+
+# pnpm
+pnpm add @tempots/std
+```
+
+## Features
+
+The library provides utility functions for working with:
+
+### Array Operations
+
+```typescript
+import { filterArray, mapArray, uniquePrimitives } from '@tempots/std'
+// or
+import { filterArray, mapArray, uniquePrimitives } from '@tempots/std/array'
+
+// Filter an array
+const numbers = [1, 2, 3, 4, 5]
+const evenNumbers = filterArray(numbers, n => n % 2 === 0) // [2, 4]
+
+// Map an array
+const doubled = mapArray(numbers, n => n * 2) // [2, 4, 6, 8, 10]
+
+// Get unique values
+const withDuplicates = [1, 2, 2, 3, 3, 3]
+const unique = uniquePrimitives(withDuplicates) // [1, 2, 3]
+```
+
+### String Utilities
+
+```typescript
+import { capitalizeWords, ellipsis } from '@tempots/std'
+// or
+import { capitalizeWords, ellipsis } from '@tempots/std/string'
+
+// Capitalize words
+const capitalized = capitalizeWords('hello world') // 'Hello World'
+
+// Truncate with ellipsis
+const truncated = ellipsis('This is a very long text', 10) // 'This is a...'
+```
+
+### Async Utilities
+
+```typescript
+import { deferred } from '@tempots/std'
+// or
+import { deferred } from '@tempots/std/deferred'
+
+// Create a deferred promise
+const { promise, resolve, reject } = deferred<number>()
+
+// Use the promise
+promise.then(value => console.log(value))
+
+// Resolve it later
+setTimeout(() => resolve(42), 1000)
+```
+
+### Timer Functions
+
+```typescript
+import { delayed, interval } from '@tempots/std'
+// or
+import { delayed, interval } from '@tempots/std/timer'
+
+// Delay execution
+const cancelDelay = delayed(() => {
+  console.log('Executed after 1 second')
+}, 1000)
+
+// Set up an interval
+const cancelInterval = interval(() => {
+  console.log('Executed every 2 seconds')
+}, 2000)
+
+// Cancel if needed
+cancelDelay() // Cancel the delayed execution
+cancelInterval() // Stop the interval
+```
+
+### Result and Validation
+
+```typescript
+import { Result, success, failure } from '@tempots/std'
+// or
+import { Result, success, failure } from '@tempots/std/result'
+
+// Create success or failure results
+const successResult = success(42)
+const failureResult = failure('Something went wrong')
+
+// Handle results
+successResult.match({
+  success: value => console.log(`Success: ${value}`),
+  failure: error => console.error(`Error: ${error}`)
+})
+```
+
+## Available Modules
+
+The library is organized into the following modules:
+
+- `array` - Array manipulation utilities
+- `async-result` - Asynchronous result handling
+- `bigint` - BigInt utilities
+- `boolean` - Boolean utilities
+- `deferred` - Promise deferral utilities
+- `domain` - Domain-specific types
+- `equal` - Deep equality comparison
+- `error` - Error handling utilities
+- `function` - Function composition and manipulation
+- `json` - JSON utilities
+- `number` - Number utilities
+- `object` - Object manipulation
+- `promise` - Promise utilities
+- `regexp` - Regular expression utilities
+- `result` - Result type for error handling
+- `string` - String manipulation utilities
+- `timer` - Timing utilities
+- `validation` - Data validation utilities
+
+## Documentation
+
+For comprehensive documentation, visit the [Tempo Documentation Site](https://tempo-ts.com/library/tempots-std.html).
+
+## License
+
+This package is licensed under the Apache License 2.0.

package/array.d.ts

@@ -1,23 +1,92 @@
 import { Compare, Maybe, Nothing, Primitive } from './domain';
 /**
- * Applies a function to each element of an array and returns a new array with the results.
- *
- * @typeParam A - The type of the elements in the input array.
- * @typeParam B - The type of the elements in the output array.
- * @param arr - The input array.
- * @param f - The function to apply to each element.
- * @returns The new array with the results of applying the function to each element.
+ * Transforms each element of an array using a mapping function, returning a new array.
+ *
+ * This is a functional programming utility that creates a new array by applying a transformation
+ * function to each element of the input array. The original array is not modified.
+ *
+ * @example
+ * ```typescript
+ * // Transform numbers to strings
+ * const numbers = [1, 2, 3, 4, 5]
+ * const strings = mapArray(numbers, n => `Number: ${n}`)
+ * // Result: ['Number: 1', 'Number: 2', 'Number: 3', 'Number: 4', 'Number: 5']
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Transform objects with index
+ * const users = [{ name: 'Alice' }, { name: 'Bob' }]
+ * const indexed = mapArray(users, (user, index) => ({
+ *   ...user,
+ *   id: index + 1
+ * }))
+ * // Result: [{ name: 'Alice', id: 1 }, { name: 'Bob', id: 2 }]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use with signals in Tempo
+ * const items = prop([1, 2, 3])
+ * const doubled = items.map(arr => mapArray(arr, n => n * 2))
+ * ```
+ *
+ * @typeParam A - The type of elements in the input array
+ * @typeParam B - The type of elements in the output array
+ * @param arr - The input array to transform
+ * @param f - Function that transforms each element (receives element and index)
+ * @returns A new array with the transformed elements
  * @public
  */
 export declare const mapArray: <A, B>(arr: A[], f: (a: A, index: number) => B) => B[];
 /**
- * Applies a mapping function to each element of an array and flattens the result.
- *
- * @param arr - The input array.
- * @param f - The mapping function to apply to each element of the array.
- * @returns A new array with the flattened result of applying the mapping function to each element of the input array.
- * @typeParam A - The type of the elements in the input array.
- * @typeParam B - The type of the elements in the resulting flattened array.
+ * Transforms each element of an array into an array, then flattens all results into a single array.
+ *
+ * This function combines mapping and flattening operations. It applies a transformation function
+ * to each element that returns an array, then concatenates all the resulting arrays into one.
+ * This is useful for operations that need to expand elements into multiple items.
+ *
+ * @example
+ * ```typescript
+ * // Split strings and flatten
+ * const sentences = ['hello world', 'foo bar', 'baz qux']
+ * const words = flatMapArray(sentences, sentence => sentence.split(' '))
+ * // Result: ['hello', 'world', 'foo', 'bar', 'baz', 'qux']
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Expand objects into multiple items
+ * const users = [
+ *   { name: 'Alice', skills: ['JS', 'TS'] },
+ *   { name: 'Bob', skills: ['Python', 'Go'] }
+ * ]
+ * const allSkills = flatMapArray(users, user =>
+ *   user.skills.map(skill => ({ user: user.name, skill }))
+ * )
+ * // Result: [
+ * //   { user: 'Alice', skill: 'JS' },
+ * //   { user: 'Alice', skill: 'TS' },
+ * //   { user: 'Bob', skill: 'Python' },
+ * //   { user: 'Bob', skill: 'Go' }
+ * // ]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Generate ranges
+ * const ranges = [2, 3, 1]
+ * const numbers = flatMapArray(ranges, n =>
+ *   Array.from({ length: n }, (_, i) => i)
+ * )
+ * // Result: [0, 1, 0, 1, 2, 0]
+ * ```
+ *
+ * @typeParam A - The type of elements in the input array
+ * @typeParam B - The type of elements in the resulting flattened array
+ * @param arr - The input array to transform and flatten
+ * @param f - Function that transforms each element into an array
+ * @returns A new flattened array containing all elements from the transformation results
  * @public
  */
 export declare const flatMapArray: <A, B>(arr: A[], f: (a: A) => B[]) => B[];
@@ -44,11 +113,11 @@ export declare const arrayTail: <A>(arr: A[]) => A[];
  * @typeParam T - The type of elements in the arrays.
  * @param a - The first array.
  * @param b - The second array.
- * @param equality - The custom equality function to compare elements.
+ * @param equals - The custom equality function to compare elements.
  * @returns Returns `true` if the arrays are equal, `false` otherwise.
  * @public
  */
-export declare const areArraysEqual: <T>(a: T[], b: T[], equality: (a: T, b: T) => boolean) => boolean;
+export declare const areArraysEqual: <T>(a: T[], b: T[], equals: (a: T, b: T) => boolean) => boolean;
 /**
  * Checks if an array is empty.
  *
@@ -66,12 +135,43 @@ export declare const isArrayEmpty: <T>(arr: T[]) => arr is [];
  */
 export declare const arrayHasValues: <T>(arr: T[]) => arr is [T, ...T[]];
 /**
- * Filters the elements of an array based on a predicate function.
- *
- * @typeParam T - The type of the elements in the array.
- * @param arr - The array to filter.
- * @param predicate - The predicate function used to filter the elements.
- * @returns The filtered array.
+ * Creates a new array containing only elements that satisfy the predicate function.
+ *
+ * This function provides a functional approach to filtering arrays, creating a new array
+ * without modifying the original. Elements are included in the result only if the predicate
+ * function returns `true` for that element.
+ *
+ * @example
+ * ```typescript
+ * // Filter even numbers
+ * const numbers = [1, 2, 3, 4, 5, 6]
+ * const evenNumbers = filterArray(numbers, n => n % 2 === 0)
+ * // Result: [2, 4, 6]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Filter objects by property
+ * const users = [
+ *   { name: 'Alice', active: true },
+ *   { name: 'Bob', active: false },
+ *   { name: 'Charlie', active: true }
+ * ]
+ * const activeUsers = filterArray(users, user => user.active)
+ * // Result: [{ name: 'Alice', active: true }, { name: 'Charlie', active: true }]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use with signals in Tempo
+ * const allItems = prop([1, 2, 3, 4, 5])
+ * const evenItems = allItems.map(arr => filterArray(arr, n => n % 2 === 0))
+ * ```
+ *
+ * @typeParam T - The type of elements in the array
+ * @param arr - The array to filter
+ * @param predicate - Function that tests each element (returns true to include the element)
+ * @returns A new array containing only elements that satisfy the predicate
  * @public
  */
 export declare const filterArray: <T>(arr: T[], predicate: (v: T) => boolean) => T[];
@@ -106,14 +206,50 @@ export declare const filterNullsFromArray: <T>(arr: Array<T | Nothing>) => T[];
  */
 export declare const flattenArray: <T>(arr: T[][]) => T[];
 /**
- * Applies a function to each element of an array, accumulating the result from left to right.
- *
- * @typeParam T - The type of the array elements.
- * @typeParam B - The type of the accumulator.
- * @param arr - The array to iterate over.
- * @param f - The function to apply to each element.
- * @param b - The initial value of the accumulator.
- * @returns The accumulated result.
+ * Reduces an array to a single value by applying an accumulator function from left to right.
+ *
+ * This function processes each element of the array in order, passing the current accumulator
+ * value and the current element to the reducer function. The result becomes the new accumulator
+ * value for the next iteration.
+ *
+ * @example
+ * ```typescript
+ * // Sum all numbers
+ * const numbers = [1, 2, 3, 4, 5]
+ * const sum = foldLeftArray(numbers, (acc, curr) => acc + curr, 0)
+ * // Result: 15
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Build an object from array
+ * const items = ['apple', 'banana', 'cherry']
+ * const indexed = foldLeftArray(
+ *   items,
+ *   (acc, item, index) => ({ ...acc, [index]: item }),
+ *   {} as Record<number, string>
+ * )
+ * // Result: { 0: 'apple', 1: 'banana', 2: 'cherry' }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Count occurrences
+ * const words = ['apple', 'banana', 'apple', 'cherry', 'banana', 'apple']
+ * const counts = foldLeftArray(
+ *   words,
+ *   (acc, word) => ({ ...acc, [word]: (acc[word] || 0) + 1 }),
+ *   {} as Record<string, number>
+ * )
+ * // Result: { apple: 3, banana: 2, cherry: 1 }
+ * ```
+ *
+ * @typeParam T - The type of elements in the array
+ * @typeParam B - The type of the accumulator value
+ * @param arr - The array to reduce
+ * @param f - Function that combines the accumulator with each element
+ * @param b - The initial accumulator value
+ * @returns The final accumulated result
  * @public
  */
 export declare const foldLeftArray: <T, B>(arr: T[], f: (acc: B, curr: T) => B, b: B) => B;
@@ -206,21 +342,104 @@ export declare const generateSequenceArray: (length: number, startAt?: number) =
  */
 export declare const createFilledArray: <A>(length: number, value: A) => A[];
 /**
- * Returns an array containing only the distinct primitive values from the input array.
- *
- * @typeParam T - The type of the input array elements.
- * @param values - The input array.
- * @returns An array containing only the distinct primitive values from the input array.
+ * Removes duplicate primitive values from an array, returning only unique values.
+ *
+ * This function uses JavaScript's Set to efficiently remove duplicates from arrays
+ * containing primitive values (strings, numbers, booleans, symbols). The order of
+ * first occurrence is preserved.
+ *
+ * @example
+ * ```typescript
+ * // Remove duplicate numbers
+ * const numbers = [1, 2, 2, 3, 1, 4, 3]
+ * const unique = uniquePrimitives(numbers)
+ * // Result: [1, 2, 3, 4]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Remove duplicate strings
+ * const tags = ['react', 'vue', 'react', 'angular', 'vue']
+ * const uniqueTags = uniquePrimitives(tags)
+ * // Result: ['react', 'vue', 'angular']
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Mixed primitive types
+ * const mixed = [1, '1', true, 1, 'hello', true, '1']
+ * const uniqueMixed = uniquePrimitives(mixed)
+ * // Result: [1, '1', true, 'hello']
+ * ```
+ *
+ * @typeParam T - The type of primitive elements in the array
+ * @param values - The input array containing primitive values
+ * @returns A new array with duplicate values removed, preserving order of first occurrence
  * @public
  */
 export declare const uniquePrimitives: <T extends Primitive>(values: T[]) => T[];
 /**
- * Returns an array of distinct elements from the input array based on the provided predicate.
- *
- * @typeParam T - The type of elements in the input array.
- * @param values - The input array.
- * @param predicate - The predicate function used to determine uniqueness.
- * @returns An array of distinct elements.
+ * Removes duplicate objects from an array based on a key extraction function.
+ *
+ * This function removes duplicates from arrays of objects by extracting a primitive
+ * key from each object and using that key to determine uniqueness. When duplicates
+ * are found, the first occurrence is kept.
+ *
+ * @example
+ * ```typescript
+ * // Remove users with duplicate IDs
+ * const users = [
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ *   { id: 1, name: 'Alice Clone' },
+ *   { id: 3, name: 'Charlie' }
+ * ]
+ * const uniqueUsers = uniqueByPrimitive(users, user => user.id)
+ * // Result: [
+ * //   { id: 1, name: 'Alice' },
+ * //   { id: 2, name: 'Bob' },
+ * //   { id: 3, name: 'Charlie' }
+ * // ]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Remove products with duplicate names
+ * const products = [
+ *   { name: 'Laptop', price: 1000 },
+ *   { name: 'Mouse', price: 25 },
+ *   { name: 'Laptop', price: 1200 },
+ *   { name: 'Keyboard', price: 75 }
+ * ]
+ * const uniqueProducts = uniqueByPrimitive(products, p => p.name)
+ * // Result: [
+ * //   { name: 'Laptop', price: 1000 },
+ * //   { name: 'Mouse', price: 25 },
+ * //   { name: 'Keyboard', price: 75 }
+ * // ]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use with complex key extraction
+ * const events = [
+ *   { date: '2023-01-01', type: 'click' },
+ *   { date: '2023-01-01', type: 'hover' },
+ *   { date: '2023-01-01', type: 'click' },
+ *   { date: '2023-01-02', type: 'click' }
+ * ]
+ * const uniqueEvents = uniqueByPrimitive(events, e => `${e.date}-${e.type}`)
+ * // Result: [
+ * //   { date: '2023-01-01', type: 'click' },
+ * //   { date: '2023-01-01', type: 'hover' },
+ * //   { date: '2023-01-02', type: 'click' }
+ * // ]
+ * ```
+ *
+ * @typeParam T - The type of elements in the input array
+ * @param values - The input array containing objects to deduplicate
+ * @param predicate - Function that extracts a primitive key from each element for comparison
+ * @returns A new array with duplicate elements removed based on the extracted key
  * @public
  */
 export declare const uniqueByPrimitive: <T>(values: T[], predicate: (a: T) => string | number | symbol) => T[];

package/array.js

@@ -46,7 +46,7 @@ const q = (t, n) => Array.from({ length: t.length }, (e, r) => n(t[r], r)), B =
     if (a !== 0) return a;
   }
   return 0;
-}, C = (t, n) => t.slice().sort(n), d = (t, n) => Array.from({ length: t }, (e, r) => n(r)), L = (t, n = 0) => d(t, (e) => n + e), R = (t, n) => d(t, () => n), V = (t) => Array.from(new Set(t)), W = (t, n) => {
+}, C = (t, n) => t.slice().sort(n), g = (t, n) => Array.from({ length: t }, (e, r) => n(r)), L = (t, n = 0) => g(t, (e) => n + e), R = (t, n) => g(t, () => n), V = (t) => Array.from(new Set(t)), W = (t, n) => {
   const e = {};
   return t.forEach((r) => {
     e[n(r)] = r;
@@ -98,8 +98,8 @@ const q = (t, n) => Array.from({ length: t.length }, (e, r) => n(t[r], r)), B =
   for (let s = 0; s < A.length; s++) {
     const o = e(A[s]), i = m.get(o);
     if (i == null || s === i) continue;
-    const g = e(p[s]);
-    m.delete(g), u.push({ from: s, to: i });
+    const d = e(p[s]);
+    m.delete(d), u.push({ from: s, to: i });
   }
   return r;
 }, U = (t, n) => {
@@ -144,7 +144,7 @@ export {
   D as flattenArray,
   P as foldLeftArray,
   T as forEachElement,
-  d as generateArray,
+  g as generateArray,
   L as generateSequenceArray,
   I as isArrayEmpty,
   X as joinArrayWithConjunction,

package/function.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=e=>e,n=e=>t=>(...r)=>e(t,...r),o=e=>{let t;return()=>(t===void 0&&(t=e()),t)};exports.curryLeft=n;exports.identity=i;exports.memoize=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=e=>e,o=e=>t=>(...r)=>e(t,...r),n=e=>{let t;return()=>(t===void 0&&(t=e()),t)};exports.curryLeft=o;exports.identity=i;exports.memoize=n;

package/function.js

@@ -1,9 +1,9 @@
-const r = (e) => e, i = (e) => (t) => (...n) => e(t, ...n), o = (e) => {
-  let t;
-  return () => (t === void 0 && (t = e()), t);
+const n = (t) => t, o = (t) => (e) => (...r) => t(e, ...r), i = (t) => {
+  let e;
+  return () => (e === void 0 && (e = t()), e);
 };
 export {
-  i as curryLeft,
-  r as identity,
-  o as memoize
+  o as curryLeft,
+  n as identity,
+  i as memoize
 };

package/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./array.cjs"),m=require("./async-result.cjs"),i=require("./bigint.cjs"),p=require("./deferred.cjs"),o=require("./equal.cjs"),l=require("./function.cjs"),a=require("./json.cjs"),t=require("./number.cjs"),s=require("./object.cjs"),y=require("./promise.cjs"),u=require("./regexp.cjs"),c=require("./result-CdwVhaAc.cjs"),e=require("./string.cjs"),n=require("./timer.cjs");exports.allElements=r.allElements;exports.anyElement=r.anyElement;exports.applyArrayDiffOperations=r.applyArrayDiffOperations;exports.areArraysEqual=r.areArraysEqual;exports.arrayDiffOperations=r.arrayDiffOperations;exports.arrayHasValues=r.arrayHasValues;exports.arrayHead=r.arrayHead;exports.arrayOfIterableIterator=r.arrayOfIterableIterator;exports.arrayTail=r.arrayTail;exports.compareArrays=r.compareArrays;exports.concatArrays=r.concatArrays;exports.createFilledArray=r.createFilledArray;exports.filterArray=r.filterArray;exports.filterMapArray=r.filterMapArray;exports.filterNullsFromArray=r.filterNullsFromArray;exports.flatMapArray=r.flatMapArray;exports.flattenArray=r.flattenArray;exports.foldLeftArray=r.foldLeftArray;exports.forEachElement=r.forEachElement;exports.generateArray=r.generateArray;exports.generateSequenceArray=r.generateSequenceArray;exports.isArrayEmpty=r.isArrayEmpty;exports.joinArrayWithConjunction=r.joinArrayWithConjunction;exports.mapArray=r.mapArray;exports.rankArray=r.rankArray;exports.removeAllFromArray=r.removeAllFromArray;exports.removeAllFromArrayByPredicate=r.removeAllFromArrayByPredicate;exports.removeOneFromArray=r.removeOneFromArray;exports.removeOneFromArrayByPredicate=r.removeOneFromArrayByPredicate;exports.sortArray=r.sortArray;exports.uniqueByPrimitive=r.uniqueByPrimitive;exports.uniquePrimitives=r.uniquePrimitives;exports.AsyncResult=m.AsyncResult;exports.biAbs=i.biAbs;exports.biCeilDiv=i.biCeilDiv;exports.biCompare=i.biCompare;exports.biFloorDiv=i.biFloorDiv;exports.biGcd=i.biGcd;exports.biIsEven=i.biIsEven;exports.biIsNegative=i.biIsNegative;exports.biIsOdd=i.biIsOdd;exports.biIsOne=i.biIsOne;exports.biIsPositive=i.biIsPositive;exports.biIsPrime=i.biIsPrime;exports.biIsZero=i.biIsZero;exports.biLcm=i.biLcm;exports.biMax=i.biMax;exports.biMin=i.biMin;exports.biNextPrime=i.biNextPrime;exports.biPow=i.biPow;exports.biPrevPrime=i.biPrevPrime;exports.deferred=p.deferred;exports.deepEqual=o.deepEqual;exports.looseEqual=o.looseEqual;exports.strictEqual=o.strictEqual;exports.curryLeft=l.curryLeft;exports.identity=l.identity;exports.memoize=l.memoize;exports.isJSONArray=a.isJSONArray;exports.isJSONObject=a.isJSONObject;exports.isJSONPrimitive=a.isJSONPrimitive;exports.parseJSON=a.parseJSON;exports.EPSILON=t.EPSILON;exports.angleDifference=t.angleDifference;exports.ceilTo=t.ceilTo;exports.clamp=t.clamp;exports.clampInt=t.clampInt;exports.clampSym=t.clampSym;exports.compareNumbers=t.compareNumbers;exports.floorTo=t.floorTo;exports.interpolate=t.interpolate;exports.interpolateAngle=t.interpolateAngle;exports.interpolateAngleCCW=t.interpolateAngleCCW;exports.interpolateAngleCW=t.interpolateAngleCW;exports.interpolateWidestAngle=t.interpolateWidestAngle;exports.nearEqualAngles=t.nearEqualAngles;exports.nearEquals=t.nearEquals;exports.nearZero=t.nearZero;exports.root=t.root;exports.roundTo=t.roundTo;exports.sign=t.sign;exports.toHex=t.toHex;exports.widestAngleDifference=t.widestAngleDifference;exports.wrap=t.wrap;exports.wrapCircular=t.wrapCircular;exports.isEmptyObject=s.isEmptyObject;exports.isObject=s.isObject;exports.mergeObjects=s.mergeObjects;exports.objectEntries=s.objectEntries;exports.objectFromEntries=s.objectFromEntries;exports.objectKeys=s.objectKeys;exports.objectValues=s.objectValues;exports.removeObjectFields=s.removeObjectFields;exports.sameObjectKeys=s.sameObjectKeys;exports.sleep=y.sleep;exports.mapRegExp=u.mapRegExp;exports.Result=c.Result;exports.Validation=c.Validation;exports.canonicalizeNewlines=e.canonicalizeNewlines;exports.capitalize=e.capitalize;exports.capitalizeWords=e.capitalizeWords;exports.chunkString=e.chunkString;exports.collapseText=e.collapseText;exports.compareCaseInsensitive=e.compareCaseInsensitive;exports.compareStrings=e.compareStrings;exports.containsAllText=e.containsAllText;exports.containsAllTextCaseInsensitive=e.containsAllTextCaseInsensitive;exports.containsAnyText=e.containsAnyText;exports.containsAnyTextCaseInsensitive=e.containsAnyTextCaseInsensitive;exports.countStringOccurrences=e.countStringOccurrences;exports.dasherize=e.dasherize;exports.decodeBase64=e.decodeBase64;exports.deleteFirstFromString=e.deleteFirstFromString;exports.deleteStringAfter=e.deleteStringAfter;exports.deleteStringBefore=e.deleteStringBefore;exports.deleteSubstring=e.deleteSubstring;exports.ellipsis=e.ellipsis;exports.ellipsisMiddle=e.ellipsisMiddle;exports.encodeBase64=e.encodeBase64;exports.filterCharcodes=e.filterCharcodes;exports.filterChars=e.filterChars;exports.humanize=e.humanize;exports.ifEmptyString=e.ifEmptyString;exports.isAlpha=e.isAlpha;exports.isAlphaNum=e.isAlphaNum;exports.isBreakingWhitespace=e.isBreakingWhitespace;exports.isDigitsOnly=e.isDigitsOnly;exports.isEmptyString=e.isEmptyString;exports.isLowerCase=e.isLowerCase;exports.isSpaceAt=e.isSpaceAt;exports.isUpperCase=e.isUpperCase;exports.jsQuote=e.jsQuote;exports.lowerCaseFirst=e.lowerCaseFirst;exports.lpad=e.lpad;exports.mapChars=e.mapChars;exports.quote=e.quote;exports.randomString=e.randomString;exports.randomStringSequence=e.randomStringSequence;exports.randomStringSequenceBase64=e.randomStringSequenceBase64;exports.repeatString=e.repeatString;exports.replaceAll=e.replaceAll;exports.reverseString=e.reverseString;exports.rpad=e.rpad;exports.smartQuote=e.smartQuote;exports.splitStringOnFirst=e.splitStringOnFirst;exports.splitStringOnLast=e.splitStringOnLast;exports.splitStringOnce=e.splitStringOnce;exports.stringContains=e.stringContains;exports.stringEndsWith=e.stringEndsWith;exports.stringEndsWithAny=e.stringEndsWithAny;exports.stringHasContent=e.stringHasContent;exports.stringHashCode=e.stringHashCode;exports.stringStartsWith=e.stringStartsWith;exports.stringStartsWithAny=e.stringStartsWithAny;exports.stringToCharcodes=e.stringToCharcodes;exports.stringToChars=e.stringToChars;exports.stringsDifferAtIndex=e.stringsDifferAtIndex;exports.substringAfter=e.substringAfter;exports.substringAfterLast=e.substringAfterLast;exports.substringBefore=e.substringBefore;exports.substringBeforeLast=e.substringBeforeLast;exports.surroundString=e.surroundString;exports.textContainsCaseInsensitive=e.textContainsCaseInsensitive;exports.textEndsWithAnyCaseInsensitive=e.textEndsWithAnyCaseInsensitive;exports.textEndsWithCaseInsensitive=e.textEndsWithCaseInsensitive;exports.textStartsWithAnyCaseInsensitive=e.textStartsWithAnyCaseInsensitive;exports.textStartsWithCaseInsensitive=e.textStartsWithCaseInsensitive;exports.textToLines=e.textToLines;exports.trimChars=e.trimChars;exports.trimCharsLeft=e.trimCharsLeft;exports.trimCharsRight=e.trimCharsRight;exports.trimStringSlice=e.trimStringSlice;exports.underscore=e.underscore;exports.upperCaseFirst=e.upperCaseFirst;exports.wrapColumns=e.wrapColumns;exports.wrapLine=e.wrapLine;exports.debounce=n.debounce;exports.delayed=n.delayed;exports.interval=n.interval;exports.throttle=n.throttle;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./array.cjs"),p=require("./async-result.cjs"),i=require("./bigint.cjs"),s=require("./boolean.cjs"),y=require("./deferred.cjs"),l=require("./equal.cjs"),c=require("./function.cjs"),o=require("./json.cjs"),t=require("./number.cjs"),a=require("./object.cjs"),u=require("./promise.cjs"),g=require("./regexp.cjs"),m=require("./result-CdwVhaAc.cjs"),e=require("./string.cjs"),n=require("./timer.cjs");exports.allElements=r.allElements;exports.anyElement=r.anyElement;exports.applyArrayDiffOperations=r.applyArrayDiffOperations;exports.areArraysEqual=r.areArraysEqual;exports.arrayDiffOperations=r.arrayDiffOperations;exports.arrayHasValues=r.arrayHasValues;exports.arrayHead=r.arrayHead;exports.arrayOfIterableIterator=r.arrayOfIterableIterator;exports.arrayTail=r.arrayTail;exports.compareArrays=r.compareArrays;exports.concatArrays=r.concatArrays;exports.createFilledArray=r.createFilledArray;exports.filterArray=r.filterArray;exports.filterMapArray=r.filterMapArray;exports.filterNullsFromArray=r.filterNullsFromArray;exports.flatMapArray=r.flatMapArray;exports.flattenArray=r.flattenArray;exports.foldLeftArray=r.foldLeftArray;exports.forEachElement=r.forEachElement;exports.generateArray=r.generateArray;exports.generateSequenceArray=r.generateSequenceArray;exports.isArrayEmpty=r.isArrayEmpty;exports.joinArrayWithConjunction=r.joinArrayWithConjunction;exports.mapArray=r.mapArray;exports.rankArray=r.rankArray;exports.removeAllFromArray=r.removeAllFromArray;exports.removeAllFromArrayByPredicate=r.removeAllFromArrayByPredicate;exports.removeOneFromArray=r.removeOneFromArray;exports.removeOneFromArrayByPredicate=r.removeOneFromArrayByPredicate;exports.sortArray=r.sortArray;exports.uniqueByPrimitive=r.uniqueByPrimitive;exports.uniquePrimitives=r.uniquePrimitives;exports.AsyncResult=p.AsyncResult;exports.biAbs=i.biAbs;exports.biCeilDiv=i.biCeilDiv;exports.biCompare=i.biCompare;exports.biFloorDiv=i.biFloorDiv;exports.biGcd=i.biGcd;exports.biIsEven=i.biIsEven;exports.biIsNegative=i.biIsNegative;exports.biIsOdd=i.biIsOdd;exports.biIsOne=i.biIsOne;exports.biIsPositive=i.biIsPositive;exports.biIsPrime=i.biIsPrime;exports.biIsZero=i.biIsZero;exports.biLcm=i.biLcm;exports.biMax=i.biMax;exports.biMin=i.biMin;exports.biNextPrime=i.biNextPrime;exports.biPow=i.biPow;exports.biPrevPrime=i.biPrevPrime;exports.booleanToInt=s.booleanToInt;exports.canParseBoolean=s.canParseBoolean;exports.compareBooleans=s.compareBooleans;exports.parseBoolean=s.parseBoolean;exports.xorBoolean=s.xorBoolean;exports.deferred=y.deferred;exports.deepEqual=l.deepEqual;exports.looseEqual=l.looseEqual;exports.strictEqual=l.strictEqual;exports.curryLeft=c.curryLeft;exports.identity=c.identity;exports.memoize=c.memoize;exports.isJSONArray=o.isJSONArray;exports.isJSONObject=o.isJSONObject;exports.isJSONPrimitive=o.isJSONPrimitive;exports.parseJSON=o.parseJSON;exports.EPSILON=t.EPSILON;exports.angleDifference=t.angleDifference;exports.ceilTo=t.ceilTo;exports.clamp=t.clamp;exports.clampInt=t.clampInt;exports.clampSym=t.clampSym;exports.compareNumbers=t.compareNumbers;exports.floorTo=t.floorTo;exports.interpolate=t.interpolate;exports.interpolateAngle=t.interpolateAngle;exports.interpolateAngleCCW=t.interpolateAngleCCW;exports.interpolateAngleCW=t.interpolateAngleCW;exports.interpolateWidestAngle=t.interpolateWidestAngle;exports.nearEqual=t.nearEqual;exports.nearEqualAngles=t.nearEqualAngles;exports.nearZero=t.nearZero;exports.root=t.root;exports.roundTo=t.roundTo;exports.sign=t.sign;exports.toHex=t.toHex;exports.widestAngleDifference=t.widestAngleDifference;exports.wrap=t.wrap;exports.wrapCircular=t.wrapCircular;exports.isEmptyObject=a.isEmptyObject;exports.isObject=a.isObject;exports.mergeObjects=a.mergeObjects;exports.objectEntries=a.objectEntries;exports.objectFromEntries=a.objectFromEntries;exports.objectKeys=a.objectKeys;exports.objectValues=a.objectValues;exports.removeObjectFields=a.removeObjectFields;exports.sameObjectKeys=a.sameObjectKeys;exports.sleep=u.sleep;exports.mapRegExp=g.mapRegExp;exports.Result=m.Result;exports.Validation=m.Validation;exports.canonicalizeNewlines=e.canonicalizeNewlines;exports.capitalize=e.capitalize;exports.capitalizeWords=e.capitalizeWords;exports.chunkString=e.chunkString;exports.collapseText=e.collapseText;exports.compareCaseInsensitive=e.compareCaseInsensitive;exports.compareStrings=e.compareStrings;exports.containsAllText=e.containsAllText;exports.containsAllTextCaseInsensitive=e.containsAllTextCaseInsensitive;exports.containsAnyText=e.containsAnyText;exports.containsAnyTextCaseInsensitive=e.containsAnyTextCaseInsensitive;exports.countStringOccurrences=e.countStringOccurrences;exports.dasherize=e.dasherize;exports.decodeBase64=e.decodeBase64;exports.deleteFirstFromString=e.deleteFirstFromString;exports.deleteStringAfter=e.deleteStringAfter;exports.deleteStringBefore=e.deleteStringBefore;exports.deleteSubstring=e.deleteSubstring;exports.ellipsis=e.ellipsis;exports.ellipsisMiddle=e.ellipsisMiddle;exports.encodeBase64=e.encodeBase64;exports.filterCharcodes=e.filterCharcodes;exports.filterChars=e.filterChars;exports.humanize=e.humanize;exports.ifEmptyString=e.ifEmptyString;exports.isAlpha=e.isAlpha;exports.isAlphaNum=e.isAlphaNum;exports.isBreakingWhitespace=e.isBreakingWhitespace;exports.isDigitsOnly=e.isDigitsOnly;exports.isEmptyString=e.isEmptyString;exports.isLowerCase=e.isLowerCase;exports.isSpaceAt=e.isSpaceAt;exports.isUpperCase=e.isUpperCase;exports.jsQuote=e.jsQuote;exports.lowerCaseFirst=e.lowerCaseFirst;exports.lpad=e.lpad;exports.mapChars=e.mapChars;exports.quote=e.quote;exports.randomString=e.randomString;exports.randomStringSequence=e.randomStringSequence;exports.randomStringSequenceBase64=e.randomStringSequenceBase64;exports.repeatString=e.repeatString;exports.replaceAll=e.replaceAll;exports.reverseString=e.reverseString;exports.rpad=e.rpad;exports.smartQuote=e.smartQuote;exports.splitStringOnFirst=e.splitStringOnFirst;exports.splitStringOnLast=e.splitStringOnLast;exports.splitStringOnce=e.splitStringOnce;exports.stringContains=e.stringContains;exports.stringEndsWith=e.stringEndsWith;exports.stringEndsWithAny=e.stringEndsWithAny;exports.stringHasContent=e.stringHasContent;exports.stringHashCode=e.stringHashCode;exports.stringStartsWith=e.stringStartsWith;exports.stringStartsWithAny=e.stringStartsWithAny;exports.stringToCharcodes=e.stringToCharcodes;exports.stringToChars=e.stringToChars;exports.stringsDifferAtIndex=e.stringsDifferAtIndex;exports.substringAfter=e.substringAfter;exports.substringAfterLast=e.substringAfterLast;exports.substringBefore=e.substringBefore;exports.substringBeforeLast=e.substringBeforeLast;exports.surroundString=e.surroundString;exports.textContainsCaseInsensitive=e.textContainsCaseInsensitive;exports.textEndsWithAnyCaseInsensitive=e.textEndsWithAnyCaseInsensitive;exports.textEndsWithCaseInsensitive=e.textEndsWithCaseInsensitive;exports.textStartsWithAnyCaseInsensitive=e.textStartsWithAnyCaseInsensitive;exports.textStartsWithCaseInsensitive=e.textStartsWithCaseInsensitive;exports.textToLines=e.textToLines;exports.trimChars=e.trimChars;exports.trimCharsLeft=e.trimCharsLeft;exports.trimCharsRight=e.trimCharsRight;exports.trimStringSlice=e.trimStringSlice;exports.underscore=e.underscore;exports.upperCaseFirst=e.upperCaseFirst;exports.wrapColumns=e.wrapColumns;exports.wrapLine=e.wrapLine;exports.debounce=n.debounce;exports.delayed=n.delayed;exports.delayedAnimationFrame=n.delayedAnimationFrame;exports.interval=n.interval;exports.intervalAnimationFrame=n.intervalAnimationFrame;exports.throttle=n.throttle;

package/index.d.ts

@@ -1,6 +1,7 @@
 export * from './array';
 export * from './async-result';
 export * from './bigint';
+export * from './boolean';
 export * from './deferred';
 export * from './domain';
 export * from './equal';
@@ -13,4 +14,5 @@ export * from './regexp';
 export * from './result';
 export * from './string';
 export * from './timer';
+export * from './union';
 export * from './validation';

package/index.js

@@ -1,27 +1,28 @@
-import { allElements as t, anyElement as i, applyArrayDiffOperations as s, areArraysEqual as a, arrayDiffOperations as n, arrayHasValues as o, arrayHead as l, arrayOfIterableIterator as m, arrayTail as p, compareArrays as c, concatArrays as y, createFilledArray as g, filterArray as A, filterMapArray as d, filterNullsFromArray as f, flatMapArray as u, flattenArray as b, foldLeftArray as S, forEachElement as C, generateArray as x, generateSequenceArray as h, isArrayEmpty as v, joinArrayWithConjunction as E, mapArray as O, rankArray as I, removeAllFromArray as F, removeAllFromArrayByPredicate as W, removeOneFromArray as j, removeOneFromArrayByPredicate as q, sortArray as P, uniqueByPrimitive as T, uniquePrimitives as L } from "./array.js";
-import { AsyncResult as B } from "./async-result.js";
+import { allElements as t, anyElement as i, applyArrayDiffOperations as a, areArraysEqual as s, arrayDiffOperations as n, arrayHasValues as o, arrayHead as l, arrayOfIterableIterator as m, arrayTail as p, compareArrays as c, concatArrays as y, createFilledArray as A, filterArray as g, filterMapArray as d, filterNullsFromArray as f, flatMapArray as u, flattenArray as b, foldLeftArray as S, forEachElement as x, generateArray as C, generateSequenceArray as h, isArrayEmpty as v, joinArrayWithConjunction as E, mapArray as O, rankArray as I, removeAllFromArray as F, removeAllFromArrayByPredicate as B, removeOneFromArray as W, removeOneFromArrayByPredicate as j, sortArray as P, uniqueByPrimitive as T, uniquePrimitives as q } from "./array.js";
+import { AsyncResult as N } from "./async-result.js";
 import { biAbs as D, biCeilDiv as z, biCompare as H, biFloorDiv as M, biGcd as R, biIsEven as J, biIsNegative as V, biIsOdd as k, biIsOne as K, biIsPositive as Q, biIsPrime as Z, biIsZero as G, biLcm as U, biMax as X, biMin as Y, biNextPrime as _, biPow as $, biPrevPrime as ee } from "./bigint.js";
-import { deferred as te } from "./deferred.js";
-import { deepEqual as se, looseEqual as ae, strictEqual as ne } from "./equal.js";
-import { curryLeft as le, identity as me, memoize as pe } from "./function.js";
-import { isJSONArray as ye, isJSONObject as ge, isJSONPrimitive as Ae, parseJSON as de } from "./json.js";
-import { EPSILON as ue, angleDifference as be, ceilTo as Se, clamp as Ce, clampInt as xe, clampSym as he, compareNumbers as ve, floorTo as Ee, interpolate as Oe, interpolateAngle as Ie, interpolateAngleCCW as Fe, interpolateAngleCW as We, interpolateWidestAngle as je, nearEqualAngles as qe, nearEquals as Pe, nearZero as Te, root as Le, roundTo as Ne, sign as Be, toHex as we, widestAngleDifference as De, wrap as ze, wrapCircular as He } from "./number.js";
-import { isEmptyObject as Re, isObject as Je, mergeObjects as Ve, objectEntries as ke, objectFromEntries as Ke, objectKeys as Qe, objectValues as Ze, removeObjectFields as Ge, sameObjectKeys as Ue } from "./object.js";
-import { sleep as Ye } from "./promise.js";
-import { mapRegExp as $e } from "./regexp.js";
-import { R as rr, V as tr } from "./result-CGd0jCdl.js";
-import { canonicalizeNewlines as sr, capitalize as ar, capitalizeWords as nr, chunkString as or, collapseText as lr, compareCaseInsensitive as mr, compareStrings as pr, containsAllText as cr, containsAllTextCaseInsensitive as yr, containsAnyText as gr, containsAnyTextCaseInsensitive as Ar, countStringOccurrences as dr, dasherize as fr, decodeBase64 as ur, deleteFirstFromString as br, deleteStringAfter as Sr, deleteStringBefore as Cr, deleteSubstring as xr, ellipsis as hr, ellipsisMiddle as vr, encodeBase64 as Er, filterCharcodes as Or, filterChars as Ir, humanize as Fr, ifEmptyString as Wr, isAlpha as jr, isAlphaNum as qr, isBreakingWhitespace as Pr, isDigitsOnly as Tr, isEmptyString as Lr, isLowerCase as Nr, isSpaceAt as Br, isUpperCase as wr, jsQuote as Dr, lowerCaseFirst as zr, lpad as Hr, mapChars as Mr, quote as Rr, randomString as Jr, randomStringSequence as Vr, randomStringSequenceBase64 as kr, repeatString as Kr, replaceAll as Qr, reverseString as Zr, rpad as Gr, smartQuote as Ur, splitStringOnFirst as Xr, splitStringOnLast as Yr, splitStringOnce as _r, stringContains as $r, stringEndsWith as et, stringEndsWithAny as rt, stringHasContent as tt, stringHashCode as it, stringStartsWith as st, stringStartsWithAny as at, stringToCharcodes as nt, stringToChars as ot, stringsDifferAtIndex as lt, substringAfter as mt, substringAfterLast as pt, substringBefore as ct, substringBeforeLast as yt, surroundString as gt, textContainsCaseInsensitive as At, textEndsWithAnyCaseInsensitive as dt, textEndsWithCaseInsensitive as ft, textStartsWithAnyCaseInsensitive as ut, textStartsWithCaseInsensitive as bt, textToLines as St, trimChars as Ct, trimCharsLeft as xt, trimCharsRight as ht, trimStringSlice as vt, underscore as Et, upperCaseFirst as Ot, wrapColumns as It, wrapLine as Ft } from "./string.js";
-import { debounce as jt, delayed as qt, interval as Pt, throttle as Tt } from "./timer.js";
+import { booleanToInt as te, canParseBoolean as ie, compareBooleans as ae, parseBoolean as se, xorBoolean as ne } from "./boolean.js";
+import { deferred as le } from "./deferred.js";
+import { deepEqual as pe, looseEqual as ce, strictEqual as ye } from "./equal.js";
+import { curryLeft as ge, identity as de, memoize as fe } from "./function.js";
+import { isJSONArray as be, isJSONObject as Se, isJSONPrimitive as xe, parseJSON as Ce } from "./json.js";
+import { EPSILON as ve, angleDifference as Ee, ceilTo as Oe, clamp as Ie, clampInt as Fe, clampSym as Be, compareNumbers as We, floorTo as je, interpolate as Pe, interpolateAngle as Te, interpolateAngleCCW as qe, interpolateAngleCW as Le, interpolateWidestAngle as Ne, nearEqual as we, nearEqualAngles as De, nearZero as ze, root as He, roundTo as Me, sign as Re, toHex as Je, widestAngleDifference as Ve, wrap as ke, wrapCircular as Ke } from "./number.js";
+import { isEmptyObject as Ze, isObject as Ge, mergeObjects as Ue, objectEntries as Xe, objectFromEntries as Ye, objectKeys as _e, objectValues as $e, removeObjectFields as er, sameObjectKeys as rr } from "./object.js";
+import { sleep as ir } from "./promise.js";
+import { mapRegExp as sr } from "./regexp.js";
+import { R as or, V as lr } from "./result-CGd0jCdl.js";
+import { canonicalizeNewlines as pr, capitalize as cr, capitalizeWords as yr, chunkString as Ar, collapseText as gr, compareCaseInsensitive as dr, compareStrings as fr, containsAllText as ur, containsAllTextCaseInsensitive as br, containsAnyText as Sr, containsAnyTextCaseInsensitive as xr, countStringOccurrences as Cr, dasherize as hr, decodeBase64 as vr, deleteFirstFromString as Er, deleteStringAfter as Or, deleteStringBefore as Ir, deleteSubstring as Fr, ellipsis as Br, ellipsisMiddle as Wr, encodeBase64 as jr, filterCharcodes as Pr, filterChars as Tr, humanize as qr, ifEmptyString as Lr, isAlpha as Nr, isAlphaNum as wr, isBreakingWhitespace as Dr, isDigitsOnly as zr, isEmptyString as Hr, isLowerCase as Mr, isSpaceAt as Rr, isUpperCase as Jr, jsQuote as Vr, lowerCaseFirst as kr, lpad as Kr, mapChars as Qr, quote as Zr, randomString as Gr, randomStringSequence as Ur, randomStringSequenceBase64 as Xr, repeatString as Yr, replaceAll as _r, reverseString as $r, rpad as et, smartQuote as rt, splitStringOnFirst as tt, splitStringOnLast as it, splitStringOnce as at, stringContains as st, stringEndsWith as nt, stringEndsWithAny as ot, stringHasContent as lt, stringHashCode as mt, stringStartsWith as pt, stringStartsWithAny as ct, stringToCharcodes as yt, stringToChars as At, stringsDifferAtIndex as gt, substringAfter as dt, substringAfterLast as ft, substringBefore as ut, substringBeforeLast as bt, surroundString as St, textContainsCaseInsensitive as xt, textEndsWithAnyCaseInsensitive as Ct, textEndsWithCaseInsensitive as ht, textStartsWithAnyCaseInsensitive as vt, textStartsWithCaseInsensitive as Et, textToLines as Ot, trimChars as It, trimCharsLeft as Ft, trimCharsRight as Bt, trimStringSlice as Wt, underscore as jt, upperCaseFirst as Pt, wrapColumns as Tt, wrapLine as qt } from "./string.js";
+import { debounce as Nt, delayed as wt, delayedAnimationFrame as Dt, interval as zt, intervalAnimationFrame as Ht, throttle as Mt } from "./timer.js";
 export {
-  B as AsyncResult,
-  ue as EPSILON,
-  rr as Result,
-  tr as Validation,
+  N as AsyncResult,
+  ve as EPSILON,
+  or as Result,
+  lr as Validation,
   t as allElements,
-  be as angleDifference,
+  Ee as angleDifference,
   i as anyElement,
-  s as applyArrayDiffOperations,
-  a as areArraysEqual,
+  a as applyArrayDiffOperations,
+  s as areArraysEqual,
   n as arrayDiffOperations,
   o as arrayHasValues,
   l as arrayHead,
@@ -45,152 +46,159 @@ export {
   _ as biNextPrime,
   $ as biPow,
   ee as biPrevPrime,
-  sr as canonicalizeNewlines,
-  ar as capitalize,
-  nr as capitalizeWords,
-  Se as ceilTo,
-  or as chunkString,
-  Ce as clamp,
-  xe as clampInt,
-  he as clampSym,
-  lr as collapseText,
+  te as booleanToInt,
+  ie as canParseBoolean,
+  pr as canonicalizeNewlines,
+  cr as capitalize,
+  yr as capitalizeWords,
+  Oe as ceilTo,
+  Ar as chunkString,
+  Ie as clamp,
+  Fe as clampInt,
+  Be as clampSym,
+  gr as collapseText,
   c as compareArrays,
-  mr as compareCaseInsensitive,
-  ve as compareNumbers,
-  pr as compareStrings,
+  ae as compareBooleans,
+  dr as compareCaseInsensitive,
+  We as compareNumbers,
+  fr as compareStrings,
   y as concatArrays,
-  cr as containsAllText,
-  yr as containsAllTextCaseInsensitive,
-  gr as containsAnyText,
-  Ar as containsAnyTextCaseInsensitive,
-  dr as countStringOccurrences,
-  g as createFilledArray,
-  le as curryLeft,
-  fr as dasherize,
-  jt as debounce,
-  ur as decodeBase64,
-  se as deepEqual,
-  te as deferred,
-  qt as delayed,
-  br as deleteFirstFromString,
-  Sr as deleteStringAfter,
-  Cr as deleteStringBefore,
-  xr as deleteSubstring,
-  hr as ellipsis,
-  vr as ellipsisMiddle,
-  Er as encodeBase64,
-  A as filterArray,
-  Or as filterCharcodes,
-  Ir as filterChars,
+  ur as containsAllText,
+  br as containsAllTextCaseInsensitive,
+  Sr as containsAnyText,
+  xr as containsAnyTextCaseInsensitive,
+  Cr as countStringOccurrences,
+  A as createFilledArray,
+  ge as curryLeft,
+  hr as dasherize,
+  Nt as debounce,
+  vr as decodeBase64,
+  pe as deepEqual,
+  le as deferred,
+  wt as delayed,
+  Dt as delayedAnimationFrame,
+  Er as deleteFirstFromString,
+  Or as deleteStringAfter,
+  Ir as deleteStringBefore,
+  Fr as deleteSubstring,
+  Br as ellipsis,
+  Wr as ellipsisMiddle,
+  jr as encodeBase64,
+  g as filterArray,
+  Pr as filterCharcodes,
+  Tr as filterChars,
   d as filterMapArray,
   f as filterNullsFromArray,
   u as flatMapArray,
   b as flattenArray,
-  Ee as floorTo,
+  je as floorTo,
   S as foldLeftArray,
-  C as forEachElement,
-  x as generateArray,
+  x as forEachElement,
+  C as generateArray,
   h as generateSequenceArray,
-  Fr as humanize,
-  me as identity,
-  Wr as ifEmptyString,
-  Oe as interpolate,
-  Ie as interpolateAngle,
-  Fe as interpolateAngleCCW,
-  We as interpolateAngleCW,
-  je as interpolateWidestAngle,
-  Pt as interval,
-  jr as isAlpha,
-  qr as isAlphaNum,
+  qr as humanize,
+  de as identity,
+  Lr as ifEmptyString,
+  Pe as interpolate,
+  Te as interpolateAngle,
+  qe as interpolateAngleCCW,
+  Le as interpolateAngleCW,
+  Ne as interpolateWidestAngle,
+  zt as interval,
+  Ht as intervalAnimationFrame,
+  Nr as isAlpha,
+  wr as isAlphaNum,
   v as isArrayEmpty,
-  Pr as isBreakingWhitespace,
-  Tr as isDigitsOnly,
-  Re as isEmptyObject,
-  Lr as isEmptyString,
-  ye as isJSONArray,
-  ge as isJSONObject,
-  Ae as isJSONPrimitive,
-  Nr as isLowerCase,
-  Je as isObject,
-  Br as isSpaceAt,
-  wr as isUpperCase,
+  Dr as isBreakingWhitespace,
+  zr as isDigitsOnly,
+  Ze as isEmptyObject,
+  Hr as isEmptyString,
+  be as isJSONArray,
+  Se as isJSONObject,
+  xe as isJSONPrimitive,
+  Mr as isLowerCase,
+  Ge as isObject,
+  Rr as isSpaceAt,
+  Jr as isUpperCase,
   E as joinArrayWithConjunction,
-  Dr as jsQuote,
-  ae as looseEqual,
-  zr as lowerCaseFirst,
-  Hr as lpad,
+  Vr as jsQuote,
+  ce as looseEqual,
+  kr as lowerCaseFirst,
+  Kr as lpad,
   O as mapArray,
-  Mr as mapChars,
-  $e as mapRegExp,
-  pe as memoize,
-  Ve as mergeObjects,
-  qe as nearEqualAngles,
-  Pe as nearEquals,
-  Te as nearZero,
-  ke as objectEntries,
-  Ke as objectFromEntries,
-  Qe as objectKeys,
-  Ze as objectValues,
-  de as parseJSON,
-  Rr as quote,
-  Jr as randomString,
-  Vr as randomStringSequence,
-  kr as randomStringSequenceBase64,
+  Qr as mapChars,
+  sr as mapRegExp,
+  fe as memoize,
+  Ue as mergeObjects,
+  we as nearEqual,
+  De as nearEqualAngles,
+  ze as nearZero,
+  Xe as objectEntries,
+  Ye as objectFromEntries,
+  _e as objectKeys,
+  $e as objectValues,
+  se as parseBoolean,
+  Ce as parseJSON,
+  Zr as quote,
+  Gr as randomString,
+  Ur as randomStringSequence,
+  Xr as randomStringSequenceBase64,
   I as rankArray,
   F as removeAllFromArray,
-  W as removeAllFromArrayByPredicate,
-  Ge as removeObjectFields,
-  j as removeOneFromArray,
-  q as removeOneFromArrayByPredicate,
-  Kr as repeatString,
-  Qr as replaceAll,
-  Zr as reverseString,
-  Le as root,
-  Ne as roundTo,
-  Gr as rpad,
-  Ue as sameObjectKeys,
-  Be as sign,
-  Ye as sleep,
-  Ur as smartQuote,
+  B as removeAllFromArrayByPredicate,
+  er as removeObjectFields,
+  W as removeOneFromArray,
+  j as removeOneFromArrayByPredicate,
+  Yr as repeatString,
+  _r as replaceAll,
+  $r as reverseString,
+  He as root,
+  Me as roundTo,
+  et as rpad,
+  rr as sameObjectKeys,
+  Re as sign,
+  ir as sleep,
+  rt as smartQuote,
   P as sortArray,
-  Xr as splitStringOnFirst,
-  Yr as splitStringOnLast,
-  _r as splitStringOnce,
-  ne as strictEqual,
-  $r as stringContains,
-  et as stringEndsWith,
-  rt as stringEndsWithAny,
-  tt as stringHasContent,
-  it as stringHashCode,
-  st as stringStartsWith,
-  at as stringStartsWithAny,
-  nt as stringToCharcodes,
-  ot as stringToChars,
-  lt as stringsDifferAtIndex,
-  mt as substringAfter,
-  pt as substringAfterLast,
-  ct as substringBefore,
-  yt as substringBeforeLast,
-  gt as surroundString,
-  At as textContainsCaseInsensitive,
-  dt as textEndsWithAnyCaseInsensitive,
-  ft as textEndsWithCaseInsensitive,
-  ut as textStartsWithAnyCaseInsensitive,
-  bt as textStartsWithCaseInsensitive,
-  St as textToLines,
-  Tt as throttle,
-  we as toHex,
-  Ct as trimChars,
-  xt as trimCharsLeft,
-  ht as trimCharsRight,
-  vt as trimStringSlice,
-  Et as underscore,
+  tt as splitStringOnFirst,
+  it as splitStringOnLast,
+  at as splitStringOnce,
+  ye as strictEqual,
+  st as stringContains,
+  nt as stringEndsWith,
+  ot as stringEndsWithAny,
+  lt as stringHasContent,
+  mt as stringHashCode,
+  pt as stringStartsWith,
+  ct as stringStartsWithAny,
+  yt as stringToCharcodes,
+  At as stringToChars,
+  gt as stringsDifferAtIndex,
+  dt as substringAfter,
+  ft as substringAfterLast,
+  ut as substringBefore,
+  bt as substringBeforeLast,
+  St as surroundString,
+  xt as textContainsCaseInsensitive,
+  Ct as textEndsWithAnyCaseInsensitive,
+  ht as textEndsWithCaseInsensitive,
+  vt as textStartsWithAnyCaseInsensitive,
+  Et as textStartsWithCaseInsensitive,
+  Ot as textToLines,
+  Mt as throttle,
+  Je as toHex,
+  It as trimChars,
+  Ft as trimCharsLeft,
+  Bt as trimCharsRight,
+  Wt as trimStringSlice,
+  jt as underscore,
   T as uniqueByPrimitive,
-  L as uniquePrimitives,
-  Ot as upperCaseFirst,
-  De as widestAngleDifference,
-  ze as wrap,
-  He as wrapCircular,
-  It as wrapColumns,
-  Ft as wrapLine
+  q as uniquePrimitives,
+  Pt as upperCaseFirst,
+  Ve as widestAngleDifference,
+  ke as wrap,
+  Ke as wrapCircular,
+  Tt as wrapColumns,
+  qt as wrapLine,
+  ne as xorBoolean
 };

package/number.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./string.cjs"),i=1e-9,l=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},f=(e,t)=>{const n=Math.pow(10,t);return Math.ceil(e*n)/n},c=(e,t,n)=>Math.min(Math.max(e,t),n),g=(e,t,n)=>Math.trunc(c(e,t,n)),u=(e,t)=>c(e,-t,t),M=(e,t)=>e<t?-1:e>t?1:0,h=(e,t)=>{const n=Math.pow(10,t);return Math.floor(e*n)/n},A=(e,t=0)=>p.lpad(e.toString(16),"0",t),s=(e,t,n)=>(t-e)*n+e,d=(e,t,n,r=360)=>o(s(e,e+l(e,t,r),n),r),a=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},w=(e,t,n,r=360)=>o(s(e,e+a(e,t,r),n),r),N=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t<e&&(t+=r),o(s(e,t,n),r)),m=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t>e&&(t-=r),o(s(e,t,n),r)),C=(e,t,n=i)=>isFinite(e)?isFinite(t)?Math.abs(e-t)<=n:!1:isNaN(e)?isNaN(t):isNaN(t)||isFinite(t)?!1:e>0==t>0,S=(e,t,n=360,r=i)=>Math.abs(l(e,t,n))<=r,T=(e,t=i)=>Math.abs(e)<=t,E=(e,t)=>Math.pow(e,1/t),W=(e,t)=>{const n=Math.pow(10,t);return Math.round(e*n)/n},q=e=>e<0?-1:1,y=(e,t,n)=>{const r=n-t+1;return e<t&&(e+=r*((t-e)/r+1)),t+(e-t)%r},o=(e,t)=>(e=e%t,e<0&&(e+=t),e);exports.EPSILON=i;exports.angleDifference=l;exports.ceilTo=f;exports.clamp=c;exports.clampInt=g;exports.clampSym=u;exports.compareNumbers=M;exports.floorTo=h;exports.interpolate=s;exports.interpolateAngle=d;exports.interpolateAngleCCW=m;exports.interpolateAngleCW=N;exports.interpolateWidestAngle=w;exports.nearEqualAngles=S;exports.nearEquals=C;exports.nearZero=T;exports.root=E;exports.roundTo=W;exports.sign=q;exports.toHex=A;exports.widestAngleDifference=a;exports.wrap=y;exports.wrapCircular=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./string.cjs"),s=1e-9,l=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},f=(e,t)=>{const n=Math.pow(10,t);return Math.ceil(e*n)/n},c=(e,t,n)=>Math.min(Math.max(e,t),n),g=(e,t,n)=>Math.trunc(c(e,t,n)),u=(e,t)=>c(e,-t,t),M=(e,t)=>e<t?-1:e>t?1:0,h=(e,t)=>{const n=Math.pow(10,t);return Math.floor(e*n)/n},A=(e,t=0)=>p.lpad(e.toString(16),"0",t),i=(e,t,n)=>(t-e)*n+e,d=(e,t,n,r=360)=>o(i(e,e+l(e,t,r),n),r),a=(e,t,n=360)=>{let r=(t-e)%n;return r<0&&(r+=n),r>n/2&&(r-=n),r},w=(e,t,n,r=360)=>o(i(e,e+a(e,t,r),n),r),N=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t<e&&(t+=r),o(i(e,t,n),r)),m=(e,t,n,r=360)=>(e=o(e,r),t=o(t,r),t>e&&(t-=r),o(i(e,t,n),r)),C=(e,t,n=s)=>isFinite(e)?isFinite(t)?Math.abs(e-t)<=n:!1:isNaN(e)?isNaN(t):isNaN(t)||isFinite(t)?!1:e>0==t>0,S=(e,t,n=360,r=s)=>Math.abs(l(e,t,n))<=r,T=(e,t=s)=>Math.abs(e)<=t,E=(e,t)=>Math.pow(e,1/t),W=(e,t)=>{const n=Math.pow(10,t);return Math.round(e*n)/n},q=e=>e<0?-1:1,y=(e,t,n)=>{const r=n-t+1;return e<t&&(e+=r*((t-e)/r+1)),t+(e-t)%r},o=(e,t)=>(e=e%t,e<0&&(e+=t),e);exports.EPSILON=s;exports.angleDifference=l;exports.ceilTo=f;exports.clamp=c;exports.clampInt=g;exports.clampSym=u;exports.compareNumbers=M;exports.floorTo=h;exports.interpolate=i;exports.interpolateAngle=d;exports.interpolateAngleCCW=m;exports.interpolateAngleCW=N;exports.interpolateWidestAngle=w;exports.nearEqual=C;exports.nearEqualAngles=S;exports.nearZero=T;exports.root=E;exports.roundTo=W;exports.sign=q;exports.toHex=A;exports.widestAngleDifference=a;exports.wrap=y;exports.wrapCircular=o;

package/number.d.ts

@@ -238,7 +238,7 @@ export declare const interpolateAngleCW: (a: number, b: number, t: number, turn?
 export declare const interpolateAngleCCW: (a: number, b: number, t: number, turn?: number) => number;
 /**
  * number numbers can sometime introduce tiny errors even for simple operations.
- * `nearEquals` compares two floats using a tiny tollerance (last optional
+ * `nearEqual` compares two floats using a tiny tollerance (last optional
  * argument). By default it is defined as `EPSILON`.
  *
  * @param a - The first number to compare.
@@ -248,12 +248,12 @@ export declare const interpolateAngleCCW: (a: number, b: number, t: number, turn
  * @public
  * @example
  * ```ts
- * nearEquals(5, 5.000000000000001) // returns true
- * nearEquals(5, 5.000000000001) // returns false
- * nearEquals(5, 5.000000000001, 1e-9) // returns true
+ * nearEqual(5, 5.000000000000001) // returns true
+ * nearEqual(5, 5.000000000001) // returns false
+ * nearEqual(5, 5.000000000001, 1e-9) // returns true
  * ```
  **/
-export declare const nearEquals: (a: number, b: number, tollerance?: number) => boolean;
+export declare const nearEqual: (a: number, b: number, tollerance?: number) => boolean;
 /**
  * number numbers can sometime introduce tiny errors even for simple operations.
  * `nearEqualAngles` compares two angles (default is 360deg) using a tiny

package/number.js

@@ -32,8 +32,8 @@ export {
   C as interpolateAngleCCW,
   m as interpolateAngleCW,
   d as interpolateWidestAngle,
+  E as nearEqual,
   F as nearEqualAngles,
-  E as nearEquals,
   S as nearZero,
   T as root,
   W as roundTo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/std",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "priority": 8,
   "description": "Std library for TypeScript. Natural complement to the Tempo libraries.",
   "keywords": [
@@ -93,6 +93,10 @@
       "import": "./timer.js",
       "require": "./timer.cjs"
     },
+    "./union": {
+      "import": "./union.js",
+      "require": "./union.cjs"
+    },
     "./validation": {
       "import": "./validation.js",
       "require": "./validation.cjs"
@@ -159,6 +163,9 @@
       "timer": [
         "./timer.d.ts"
       ],
+      "union": [
+        "./union.d.ts"
+      ],
       "validation": [
         "./validation.d.ts"
       ]

package/timer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=(e,t)=>{const n=setTimeout(e,t);return()=>clearTimeout(n)},w=(e,t)=>{const n=setInterval(e,t);return()=>clearInterval(n)},b=(e,t,n={})=>{const{noTrailing:s=!1,noLeading:u=!1,debounceMode:c}=n;let o,f=!1,i=0;function d(){o&&clearTimeout(o)}function g(a){const{upcomingOnly:r=!1}=a||{};d(),f=!r}function m(...a){if(f)return;const r=this,T=Date.now()-i;function l(){i=Date.now(),t.apply(r,a)}function p(){o=void 0}!u&&c&&!o&&l(),d(),c===void 0&&T>e?u?(i=Date.now(),s||(o=setTimeout(c?p:l,e))):l():s||(o=setTimeout(c?p:l,c===void 0?e-T:e))}return m.cancel=g,m},D=(e,t,{atBegin:n=!1}={})=>b(e,t,{debounceMode:n!==!1});exports.debounce=D;exports.delayed=v;exports.interval=w;exports.throttle=b;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=(n,e)=>{const t=setTimeout(n,e);return()=>clearTimeout(t)},b=(n,e)=>{const t=setInterval(n,e);return()=>clearInterval(t)},F=(n,e,t={})=>{const{noTrailing:o=!1,noLeading:l=!1,debounceMode:i}=t;let a,m=!1,c=0;function f(){a&&clearTimeout(a)}function T(u){const{upcomingOnly:s=!1}=u||{};f(),m=!s}function d(...u){if(m)return;const s=this,v=Date.now()-c;function r(){c=Date.now(),e.apply(s,u)}function A(){a=void 0}!l&&i&&!a&&r(),f(),i===void 0&&v>n?l?(c=Date.now(),o||(a=setTimeout(i?A:r,n))):r():o||(a=setTimeout(i?A:r,i===void 0?n-v:n))}return d.cancel=T,d},g=(n,e,{atBegin:t=!1}={})=>F(n,e,{debounceMode:t!==!1}),y=n=>{let e=null;const t=l=>{e=null,n(l)};return(()=>{e==null&&(e=requestAnimationFrame(t))})(),()=>{e!=null&&(cancelAnimationFrame(e),e=null)}},I=n=>{let e=null;const t=l=>{e=requestAnimationFrame(t),n(l)};return(()=>{e==null&&(e=requestAnimationFrame(t))})(),()=>{e!=null&&(cancelAnimationFrame(e),e=null)}};exports.debounce=g;exports.delayed=p;exports.delayedAnimationFrame=y;exports.interval=b;exports.intervalAnimationFrame=I;exports.throttle=F;

package/timer.d.ts

@@ -163,3 +163,17 @@ export type DebounceOptions = {
  * @public
  */
 export declare const debounce: <FN extends (...args: unknown[]) => void>(delay: number, callback: FN, { atBegin }?: DebounceOptions) => ThrottledFunction<Parameters<FN>>;
+/**
+ * Delays the execution of a function using requestAnimationFrame.
+ *
+ * @param callback - The function to delay.
+ * @returns A function that, when called, will cancel the delay and prevent the original function from being executed.
+ */
+export declare const delayedAnimationFrame: (callback: (time: DOMHighResTimeStamp) => void) => () => void;
+/**
+ * Executes a function repeatedly using requestAnimationFrame.
+ *
+ * @param callback - The function to execute periodically.
+ * @returns A function that, when called, will cancel the interval and stop future executions.
+ */
+export declare const intervalAnimationFrame: (callback: (time: DOMHighResTimeStamp) => void) => () => void;

package/timer.js

@@ -1,38 +1,60 @@
-const x = (e, n) => {
-  const t = setTimeout(e, n);
+const T = (n, e) => {
+  const t = setTimeout(n, e);
   return () => clearTimeout(t);
-}, D = (e, n) => {
-  const t = setInterval(e, n);
+}, I = (n, e) => {
+  const t = setInterval(n, e);
   return () => clearInterval(t);
-}, w = (e, n, t = {}) => {
-  const { noTrailing: r = !1, noLeading: u = !1, debounceMode: c } = t;
-  let o, f = !1, l = 0;
-  function d() {
+}, F = (n, e, t = {}) => {
+  const { noTrailing: a = !1, noLeading: l = !1, debounceMode: i } = t;
+  let o, f = !1, c = 0;
+  function m() {
     o && clearTimeout(o);
   }
-  function g(s) {
-    const { upcomingOnly: a = !1 } = s || {};
-    d(), f = !a;
+  function A(u) {
+    const { upcomingOnly: s = !1 } = u || {};
+    m(), f = !s;
   }
-  function m(...s) {
+  function d(...u) {
     if (f) return;
-    const a = this, p = Date.now() - l;
-    function i() {
-      l = Date.now(), n.apply(a, s);
+    const s = this, p = Date.now() - c;
+    function r() {
+      c = Date.now(), e.apply(s, u);
     }
-    function T() {
+    function v() {
       o = void 0;
     }
-    !u && c && !o && i(), d(), c === void 0 && p > e ? u ? (l = Date.now(), r || (o = setTimeout(c ? T : i, e))) : i() : r || (o = setTimeout(
-      c ? T : i,
-      c === void 0 ? e - p : e
+    !l && i && !o && r(), m(), i === void 0 && p > n ? l ? (c = Date.now(), a || (o = setTimeout(i ? v : r, n))) : r() : a || (o = setTimeout(
+      i ? v : r,
+      i === void 0 ? n - p : n
     ));
   }
-  return m.cancel = g, m;
-}, b = (e, n, { atBegin: t = !1 } = {}) => w(e, n, { debounceMode: t !== !1 });
+  return d.cancel = A, d;
+}, g = (n, e, { atBegin: t = !1 } = {}) => F(n, e, { debounceMode: t !== !1 }), w = (n) => {
+  let e = null;
+  const t = (l) => {
+    e = null, n(l);
+  };
+  return (() => {
+    e == null && (e = requestAnimationFrame(t));
+  })(), () => {
+    e != null && (cancelAnimationFrame(e), e = null);
+  };
+}, x = (n) => {
+  let e = null;
+  const t = (l) => {
+    e = requestAnimationFrame(t), n(l);
+  };
+  return (() => {
+    e == null && (e = requestAnimationFrame(t));
+  })(), () => {
+    e != null && (cancelAnimationFrame(e), e = null);
+  };
+};
 export {
-  b as debounce,
-  x as delayed,
-  D as interval,
-  w as throttle
+  g as debounce,
+  T as delayed,
+  w as delayedAnimationFrame,
+  I as interval,
+  x as intervalAnimationFrame,
+  F as throttle
 };

package/union.cjs

@@ -0,0 +1 @@
+"use strict";

package/union.d.ts

@@ -0,0 +1 @@
+export type IsUnion<T, U = T> = T extends any ? [U] extends [T] ? false : true : never;

package/union.js

@@ -0,0 +1 @@
+