@hypernym/utils 3.4.4 → 3.4.5

package/LICENSE.txt

@@ -1,6 +1,7 @@
 MIT License
 
-Copyright (c) 2025 Ivo Dolenc, Hypernym Studio
+Copyright (c) 2025, Ivo Dolenc <https://github.com/ivodolenc>
+Copyright (c) 2025, Hypernym Studio <https://github.com/hypernym-studio>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,4 +1,4 @@
-<h1 align="center">Utils</h1>
+<h1 align="center">@hypernym/utils</h1>
 
 <p align="center">A collection of reusable utilities.</p>
 
@@ -72,7 +72,7 @@ Also, it is possible to download files manually and serve them accordingly.
 
 ## Usage
 
-After installation, import `Hyperutils` into your project:
+After installation, import `utils` into your project:
 
 ```ts
 // ESM & TS
@@ -104,7 +104,7 @@ Returns a boolean if the given value is a `null`.
 ```ts
 import { isNull } from '@hypernym/utils'
 
-isNull(null) // => true
+isNull(null) // true
 ```
 
 ### isUndefined
@@ -114,7 +114,7 @@ Returns a boolean if the given value is a `undefined`.
 ```ts
 import { isUndefined } from '@hypernym/utils'
 
-isUndefined(undefined) // => true
+isUndefined(undefined) // true
 ```
 
 ### isString
@@ -124,7 +124,307 @@ Returns a boolean if the given value is a `string`.
 ```ts
 import { isString } from '@hypernym/utils'
 
-isString('@hypernym/utils') // => true
+isString('@hypernym/utils') // true
+```
+
+### isStringEmpty
+
+Returns a boolean if the given value is an empty `string`.
+
+```ts
+import { isStringEmpty } from '@hypernym/utils'
+
+isStringEmpty('') // true
+```
+
+### isBoolean
+
+Returns a boolean if the given value is a `boolean`.
+
+```ts
+import { isBoolean } from '@hypernym/utils'
+
+isBoolean(true) // true
+```
+
+### isTrue
+
+Returns a boolean if the given value is a `true`.
+
+```ts
+import { isTrue } from '@hypernym/utils'
+
+isTrue(true) // true
+```
+
+### isFalse
+
+Returns a boolean if the given value is a `false`.
+
+```ts
+import { isFalse } from '@hypernym/utils'
+
+isFalse(false) // true
+```
+
+### isNumber
+
+Returns a boolean if the given value is a `number`.
+
+```ts
+import { isNumber } from '@hypernym/utils'
+
+isNumber(33) // true
+```
+
+### isArray
+
+Returns a boolean if the given value is a `array`.
+
+```ts
+import { isArray } from '@hypernym/utils'
+
+isArray([]) // true
+```
+
+### isArrayEmpty
+
+Returns a boolean if the given value is an empty `array`.
+
+```ts
+import { isArrayEmpty } from '@hypernym/utils'
+
+isArrayEmpty([]) // true
+```
+
+### isObject
+
+Returns a boolean if the given value is a `object`.
+
+```ts
+import { isObject } from '@hypernym/utils'
+
+isObject({}) // true
+```
+
+### isObjectEmpty
+
+Returns a boolean if the given value is an empty `object`.
+
+```ts
+import { isObjectEmpty } from '@hypernym/utils'
+
+isObjectEmpty({}) // true
+```
+
+### isFunction
+
+Returns a boolean if the given value is a `Function`.
+
+```ts
+import { isFunction } from '@hypernym/utils'
+
+isFunction(() => {}) // true
+```
+
+### isNanValue
+
+Returns a boolean if the given value is a `NaN`.
+
+```ts
+import { isNaNValue } from '@hypernym/utils'
+
+isNaNValue(NaN) // true
+```
+
+### isRegExp
+
+Returns a boolean if the given value is a `RegExp`.
+
+```ts
+import { isRegExp } from '@hypernym/utils'
+
+isRegExp(/^hypernym/) // true
+```
+
+### isMap
+
+Returns a boolean if the given value is a `Map`.
+
+```ts
+import { isMap } from '@hypernym/utils'
+
+isMap(new Map()) // true
+```
+
+### isWeakMap
+
+Returns a boolean if the given value is a `WeakMap`.
+
+```ts
+import { isWeakMap } from '@hypernym/utils'
+
+isWeakMap(new WeakMap()) // true
+```
+
+### isSet
+
+Returns a boolean if the given value is a `Set`.
+
+```ts
+import { isSet } from '@hypernym/utils'
+
+isSet(new Set()) // true
+```
+
+### isWeakSet
+
+Returns a boolean if the given value is a `WeakSet`.
+
+```ts
+import { isWeakSet } from '@hypernym/utils'
+
+isWeakSet(new WeakSet()) // true
+```
+
+### isSymbol
+
+Returns a boolean if the given value is a `symbol`.
+
+```ts
+import { isSymbol } from '@hypernym/utils'
+
+isSymbol(Symboly('hypernym')) // true
+```
+
+### isDate
+
+Returns a boolean if the given value is a `Date`.
+
+```ts
+import { isDate } from '@hypernym/utils'
+
+isDate(new Date()) // true
+```
+
+### isBigInt
+
+Returns a boolean if the given value is a `bigint`.
+
+```ts
+import { isBigInt } from '@hypernym/utils'
+
+isBigInt(1n) // true
+```
+
+### isInfinity
+
+Returns a boolean if the given value is a `Infinity`.
+
+```ts
+import { isInfinity } from '@hypernym/utils'
+
+isInfinity(Infinity) // true
+```
+
+### isURL
+
+Returns a boolean if the given value is a `URL`.
+
+```ts
+import { isURL } from '@hypernym/utils'
+
+isURL(new URL('https://localhost:3000')) // true
+```
+
+### isError
+
+Returns a boolean if the given value is a `Error`.
+
+```ts
+import { isError } from '@hypernym/utils'
+
+isError(new Error()) // true
+```
+
+### isPrimitive
+
+Returns a boolean if the given value is a `Primitive`.
+
+```ts
+import { isPrimitive } from '@hypernym/utils'
+
+isPrimitive(true) // true
+```
+
+### isElement
+
+Returns a boolean if the given value is a `Element`.
+
+```ts
+import { isElement } from '@hypernym/utils'
+
+isElement(el) // true
+```
+
+### isHtmlElement
+
+Returns a boolean if the given value is a `HTMLElement`.
+
+```ts
+import { isHtmlElement } from '@hypernym/utils'
+
+isHtmlElement(htmlEl) // true
+```
+
+### isSvgElement
+
+Returns a boolean if the given value is a `SVGElement`.
+
+```ts
+import { isSvgElement } from '@hypernym/utils'
+
+isSvgElement(svgEl) // true
+```
+
+### isNodeList
+
+Returns a boolean if the given value is a `NodeList`.
+
+```ts
+import { isNodeList } from '@hypernym/utils'
+
+isNodeList(document.querySelectorAll('div')) // true
+```
+
+### isNodeListEmpty
+
+Returns a boolean if the given value is an empty `NodeList`.
+
+```ts
+import { isNodeListEmpty } from '@hypernym/utils'
+
+isNodeListEmpty(document.querySelectorAll('divs')) // true
+```
+
+### isHtmlCollection
+
+Returns a boolean if the given value is a `HTMLCollection`.
+
+```ts
+import { isHtmlCollection } from '@hypernym/utils'
+
+isHtmlCollection(document.getElementsByClassName('el')) // true
+```
+
+### isHtmlCollectionEmpty
+
+Returns a boolean if the given value is an empty `HTMLCollection`.
+
+```ts
+import { isHtmlCollectionEmpty } from '@hypernym/utils'
+
+isHtmlCollectionEmpty(document.getElementsByClassName('els')) // true
 ```
 
 ## fs
@@ -136,7 +436,7 @@ Checks if the `file` or `directory` exists.
 ```ts
 import { exists } from '@hypernym/utils/fs'
 
-await exists('dir/file.ts') // => true
+await exists('dir/file.ts') // true
 ```
 
 ### read
@@ -207,6 +507,66 @@ await remove('src/subdir/file.ts')
 
 ## Types
 
+### Primitive
+
+Matches any primitive value.
+
+```ts
+import type { Primitive } from '@hypernym/utils'
+
+type OnlyPrimitives<T> = T extends Primitive ? T : never
+
+type Filtered = OnlyPrimitives<string | number | {} | Date> // string | number
+```
+
+### BuiltIn
+
+Matches any `Primitive`, `Date` or `RegExp` value.
+
+```ts
+import type { BuiltIn } from '@hypernym/utils'
+
+type OnlyBuiltIns<T> = T extends BuiltIn ? T : never
+
+type Filtered = OnlyBuiltIns<string | Date | {} | RegExp> // string | Date | RegExp
+```
+
+### IsNull
+
+Returns a boolean if the given type is a `null`.
+
+```ts
+import type { IsNull } from '@hypernym/utils'
+
+type A = IsNull<null> // true
+type B = IsNull<string> // false
+type C = IsNull<undefined> // false
+```
+
+### IsAny
+
+Returns a boolean if the given type is a `any`.
+
+```ts
+import type { IsAny } from '@hypernym/utils'
+
+type A = IsAny<any> // true
+type B = IsAny<string> // false
+type C = IsAny<unknown> // false
+```
+
+### IsNever
+
+Returns a boolean if the given type is a `never`.
+
+```ts
+import type { IsNever } from '@hypernym/utils'
+
+type A = IsNever<never> // true
+type B = IsNever<number> // false
+type C = IsNever<undefined> // false
+```
+
 ### PartialDeep
 
 Constructs a type by recursively setting all properties as optional.
@@ -214,6 +574,8 @@ Constructs a type by recursively setting all properties as optional.
 Use `Partial<T>` for one level.
 
 ```ts
+import type { PartialDeep } from '@hypernym/utils'
+
 type PartialObject = PartialDeep<Object>
 
 // Disables recursive mode for arrays and tuples.
@@ -227,18 +589,14 @@ Constructs a type by recursively setting all properties as required.
 Use `Required<T>` for one level.
 
 ```ts
+import type { RequiredDeep } from '@hypernym/utils'
+
 type RequiredObject = RequiredDeep<Object>
 
 // Disables recursive mode for arrays and tuples.
 type RequiredObject = RequiredDeep<Object, { arrays: false }>
 ```
 
-## Community
-
-Feel free to ask questions or share new ideas.
-
-Use the official [discussions](https://github.com/hypernym-studio/utils/discussions) to get involved.
-
 ## License
 
 Developed in 🇭🇷 Croatia, © Hypernym Studio.

package/dist/fs/index.d.mts

@@ -9,7 +9,7 @@ import { writeFile as writeFile$1 } from 'node:fs/promises';
  * ```ts
  * import { exists } from '@hypernym/utils/fs'
  *
- * await exists('dir/file.ts') // => true
+ * await exists('dir/file.ts') // true
  * ```
  */
 declare function exists(path: string): Promise<boolean>;

package/dist/index.d.mts

@@ -18,17 +18,37 @@ declare const noop: () => void;
  * ```ts
  * import { toString } from '@hypernym/utils'
  *
- * toString({}) // => 'Object'
+ * toString({}) // 'Object'
  * ```
  */
 declare const toString: (v: any) => string;
 
 /**
  * Matches any primitive value.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { Primitive } from '@hypernym/utils'
+ *
+ * type OnlyPrimitives<T> = T extends Primitive ? T : never
+ *
+ * type Filtered = OnlyPrimitives<string | number | {} | Date> // string | number
+ * ```
  */
 type Primitive = null | undefined | string | number | boolean | symbol | bigint;
 /**
  * Matches any `Primitive`, `Date` or `RegExp` value.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { BuiltIn } from '@hypernym/utils'
+ *
+ * type OnlyBuiltIns<T> = T extends BuiltIn ? T : never
+ *
+ * type Filtered = OnlyBuiltIns<string | Date | {} | RegExp> // string | Date | RegExp
+ * ```
  */
 type BuiltIn = Primitive | Date | RegExp;
 
@@ -52,7 +72,7 @@ declare const isBrowser: boolean;
  * ```ts
  * import { isNull } from '@hypernym/utils'
  *
- * isNull(null) // => true
+ * isNull(null) // true
  * ```
  */
 declare const isNull: (v: any) => v is null;
@@ -64,7 +84,7 @@ declare const isNull: (v: any) => v is null;
  * ```ts
  * import { isUndefined } from '@hypernym/utils'
  *
- * isUndefined(undefined) // => true
+ * isUndefined(undefined) // true
  * ```
  */
 declare const isUndefined: (v: any) => v is undefined;
@@ -76,7 +96,7 @@ declare const isUndefined: (v: any) => v is undefined;
  * ```ts
  * import { isString } from '@hypernym/utils'
  *
- * isString('@hypernym/utils') // => true
+ * isString('@hypernym/utils') // true
  * ```
  */
 declare const isString: (v: any) => v is string;
@@ -88,7 +108,7 @@ declare const isString: (v: any) => v is string;
  * ```ts
  * import { isStringEmpty } from '@hypernym/utils'
  *
- * isStringEmpty('') // => true
+ * isStringEmpty('') // true
  * ```
  */
 declare const isStringEmpty: (v: any) => v is string;
@@ -100,7 +120,7 @@ declare const isStringEmpty: (v: any) => v is string;
  * ```ts
  * import { isBoolean } from '@hypernym/utils'
  *
- * isBoolean(true) // => true
+ * isBoolean(true) // true
  * ```
  */
 declare const isBoolean: (v: any) => v is boolean;
@@ -112,7 +132,7 @@ declare const isBoolean: (v: any) => v is boolean;
  * ```ts
  * import { isTrue } from '@hypernym/utils'
  *
- * isTrue(true) // => true
+ * isTrue(true) // true
  * ```
  */
 declare const isTrue: (v: any) => v is true;
@@ -124,7 +144,7 @@ declare const isTrue: (v: any) => v is true;
  * ```ts
  * import { isFalse } from '@hypernym/utils'
  *
- * isFalse(false) // => true
+ * isFalse(false) // true
  * ```
  */
 declare const isFalse: (v: any) => v is false;
@@ -136,7 +156,7 @@ declare const isFalse: (v: any) => v is false;
  * ```ts
  * import { isNumber } from '@hypernym/utils'
  *
- * isNumber(33) // => true
+ * isNumber(33) // true
  * ```
  */
 declare const isNumber: (v: any) => v is number;
@@ -148,7 +168,7 @@ declare const isNumber: (v: any) => v is number;
  * ```ts
  * import { isArray } from '@hypernym/utils'
  *
- * isArray([]) // => true
+ * isArray([]) // true
  * ```
  */
 declare const isArray: (v: any) => v is any[];
@@ -160,7 +180,7 @@ declare const isArray: (v: any) => v is any[];
  * ```ts
  * import { isArrayEmpty } from '@hypernym/utils'
  *
- * isArrayEmpty([]) // => true
+ * isArrayEmpty([]) // true
  * ```
  */
 declare const isArrayEmpty: (v: any) => v is any[];
@@ -172,7 +192,7 @@ declare const isArrayEmpty: (v: any) => v is any[];
  * ```ts
  * import { isObject } from '@hypernym/utils'
  *
- * isObject({}) // => true
+ * isObject({}) // true
  * ```
  */
 declare const isObject: (v: any) => v is object;
@@ -184,7 +204,7 @@ declare const isObject: (v: any) => v is object;
  * ```ts
  * import { isObjectEmpty } from '@hypernym/utils'
  *
- * isObjectEmpty({}) // => true
+ * isObjectEmpty({}) // true
  * ```
  */
 declare const isObjectEmpty: (v: any) => v is object;
@@ -196,7 +216,7 @@ declare const isObjectEmpty: (v: any) => v is object;
  * ```ts
  * import { isFunction } from '@hypernym/utils'
  *
- * isFunction(() => {}) // => true
+ * isFunction(() => {}) // true
  * ```
  */
 declare const isFunction: (v: any) => v is (...args: any[]) => unknown;
@@ -208,7 +228,7 @@ declare const isFunction: (v: any) => v is (...args: any[]) => unknown;
  * ```ts
  * import { isNaNValue } from '@hypernym/utils'
  *
- * isNaNValue(NaN) // => true
+ * isNaNValue(NaN) // true
  * ```
  */
 declare const isNaNValue: (v: any) => v is typeof NaN;
@@ -220,7 +240,7 @@ declare const isNaNValue: (v: any) => v is typeof NaN;
  * ```ts
  * import { isRegExp } from '@hypernym/utils'
  *
- * isRegExp(/^hypernym/) // => true
+ * isRegExp(/^hypernym/) // true
  * ```
  */
 declare const isRegExp: (v: any) => v is RegExp;
@@ -232,7 +252,7 @@ declare const isRegExp: (v: any) => v is RegExp;
  * ```ts
  * import { isMap } from '@hypernym/utils'
  *
- * isMap(new Map()) // => true
+ * isMap(new Map()) // true
  * ```
  */
 declare const isMap: (v: any) => v is Map<any, any>;
@@ -244,7 +264,7 @@ declare const isMap: (v: any) => v is Map<any, any>;
  * ```ts
  * import { isWeakMap } from '@hypernym/utils'
  *
- * isWeakMap(new WeakMap()) // => true
+ * isWeakMap(new WeakMap()) // true
  * ```
  */
 declare const isWeakMap: (v: any) => v is WeakMap<any, any>;
@@ -256,7 +276,7 @@ declare const isWeakMap: (v: any) => v is WeakMap<any, any>;
  * ```ts
  * import { isSet } from '@hypernym/utils'
  *
- * isSet(new Set()) // => true
+ * isSet(new Set()) // true
  * ```
  */
 declare const isSet: (v: any) => v is Set<any>;
@@ -268,7 +288,7 @@ declare const isSet: (v: any) => v is Set<any>;
  * ```ts
  * import { isWeakSet } from '@hypernym/utils'
  *
- * isWeakSet(new WeakSet()) // => true
+ * isWeakSet(new WeakSet()) // true
  * ```
  */
 declare const isWeakSet: (v: any) => v is WeakSet<any>;
@@ -280,7 +300,7 @@ declare const isWeakSet: (v: any) => v is WeakSet<any>;
  * ```ts
  * import { isSymbol } from '@hypernym/utils'
  *
- * isSymbol(Symboly('hypernym')) // => true
+ * isSymbol(Symboly('hypernym')) // true
  * ```
  */
 declare const isSymbol: (v: any) => v is symbol;
@@ -292,7 +312,7 @@ declare const isSymbol: (v: any) => v is symbol;
  * ```ts
  * import { isDate } from '@hypernym/utils'
  *
- * isDate(new Date()) // => true
+ * isDate(new Date()) // true
  * ```
  */
 declare const isDate: (v: any) => v is Date;
@@ -304,7 +324,7 @@ declare const isDate: (v: any) => v is Date;
  * ```ts
  * import { isBigInt } from '@hypernym/utils'
  *
- * isBigInt(1n) // => true
+ * isBigInt(1n) // true
  * ```
  */
 declare const isBigInt: (v: any) => v is bigint;
@@ -316,7 +336,7 @@ declare const isBigInt: (v: any) => v is bigint;
  * ```ts
  * import { isInfinity } from '@hypernym/utils'
  *
- * isInfinity(Infinity) // => true
+ * isInfinity(Infinity) // true
  * ```
  */
 declare const isInfinity: (v: any) => v is number;
@@ -328,7 +348,7 @@ declare const isInfinity: (v: any) => v is number;
  * ```ts
  * import { isURL } from '@hypernym/utils'
  *
- * isURL(new URL('https://localhost:3000')) // => true
+ * isURL(new URL('https://localhost:3000')) // true
  * ```
  */
 declare const isURL: (v: any) => v is URL;
@@ -340,7 +360,7 @@ declare const isURL: (v: any) => v is URL;
  * ```ts
  * import { isError } from '@hypernym/utils'
  *
- * isError(new Error()) // => true
+ * isError(new Error()) // true
  * ```
  */
 declare const isError: (v: any) => v is Error;
@@ -352,7 +372,7 @@ declare const isError: (v: any) => v is Error;
  * ```ts
  * import { isPrimitive } from '@hypernym/utils'
  *
- * isPrimitive(true) // => true
+ * isPrimitive(true) // true
  * ```
  */
 declare const isPrimitive: (v: any) => v is Primitive;
@@ -364,7 +384,7 @@ declare const isPrimitive: (v: any) => v is Primitive;
  * ```ts
  * import { isElement } from '@hypernym/utils'
  *
- * isElement(el) // => true
+ * isElement(el) // true
  * ```
  */
 declare const isElement: (v: any) => v is Element;
@@ -376,7 +396,7 @@ declare const isElement: (v: any) => v is Element;
  * ```ts
  * import { isHtmlElement } from '@hypernym/utils'
  *
- * isHtmlElement(htmlEl) // => true
+ * isHtmlElement(htmlEl) // true
  * ```
  */
 declare const isHtmlElement: (v: any) => v is HTMLElement;
@@ -388,7 +408,7 @@ declare const isHtmlElement: (v: any) => v is HTMLElement;
  * ```ts
  * import { isSvgElement } from '@hypernym/utils'
  *
- * isSvgElement(svgEl) // => true
+ * isSvgElement(svgEl) // true
  * ```
  */
 declare const isSvgElement: (v: any) => v is SVGElement;
@@ -400,7 +420,7 @@ declare const isSvgElement: (v: any) => v is SVGElement;
  * ```ts
  * import { isNodeList } from '@hypernym/utils'
  *
- * isNodeList(document.querySelectorAll('div')) // => true
+ * isNodeList(document.querySelectorAll('div')) // true
  * ```
  */
 declare const isNodeList: (v: any) => v is NodeList;
@@ -412,7 +432,7 @@ declare const isNodeList: (v: any) => v is NodeList;
  * ```ts
  * import { isNodeListEmpty } from '@hypernym/utils'
  *
- * isNodeListEmpty(document.querySelectorAll('divs')) // => true
+ * isNodeListEmpty(document.querySelectorAll('divs')) // true
  * ```
  */
 declare const isNodeListEmpty: (v: any) => v is NodeList;
@@ -424,7 +444,7 @@ declare const isNodeListEmpty: (v: any) => v is NodeList;
  * ```ts
  * import { isHtmlCollection } from '@hypernym/utils'
  *
- * isHtmlCollection(document.getElementsByClassName('el')) // => true
+ * isHtmlCollection(document.getElementsByClassName('el')) // true
  * ```
  */
 declare const isHtmlCollection: (v: any) => v is HTMLCollection;
@@ -434,21 +454,51 @@ declare const isHtmlCollection: (v: any) => v is HTMLCollection;
  * ```ts
  * import { isHtmlCollectionEmpty } from '@hypernym/utils'
  *
- * isHtmlCollectionEmpty(document.getElementsByClassName('els')) // => true
+ * isHtmlCollectionEmpty(document.getElementsByClassName('els')) // true
  * ```
  */
 declare const isHtmlCollectionEmpty: (v: any) => v is HTMLCollection;
 
 /**
  * Returns a boolean if the given type is a `null`.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { IsNull } from '@hypernym/utils'
+ *
+ * type A = IsNull<null> // true
+ * type B = IsNull<string> // false
+ * type C = IsNull<undefined> // false
+ * ```
  */
 type IsNull<T> = [T] extends [null] ? true : false;
 /**
  * Returns a boolean if the given type is a `any`.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { IsAny } from '@hypernym/utils'
+ *
+ * type A = IsAny<any> // true
+ * type B = IsAny<string> // false
+ * type C = IsAny<unknown> // false
+ * ```
  */
 type IsAny<T> = 0 extends 1 & T ? true : false;
 /**
  * Returns a boolean if the given type is a `never`.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { IsNever } from '@hypernym/utils'
+ *
+ * type A = IsNever<never> // true
+ * type B = IsNever<number> // false
+ * type C = IsNever<undefined> // false
+ * ```
  */
 type IsNever<T> = [T] extends [never] ? true : false;
 
@@ -464,6 +514,17 @@ type PartialOptions = {
  * Constructs a type by recursively setting all properties as optional.
  *
  * Use `Partial<T>` for one level.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { PartialDeep } from '@hypernym/utils'
+ *
+ * type PartialObject = PartialDeep<Object>
+ *
+ * // Disables recursive mode for arrays and tuples.
+ * type PartialObject = PartialDeep<Object, { arrays: false }>
+ * ```
  */
 type PartialDeep<T, Options extends PartialOptions = {
     arrays: true;
@@ -486,6 +547,17 @@ type RequiredOptions = {
  * Constructs a type by recursively setting all properties as required.
  *
  * Use `Required<T>` for one level.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { RequiredDeep } from '@hypernym/utils'
+ *
+ * type RequiredObject = RequiredDeep<Object>
+ *
+ * // Disables recursive mode for arrays and tuples.
+ * type RequiredObject = RequiredDeep<Object, { arrays: false }>
+ * ```
  */
 type RequiredDeep<T, Options extends RequiredOptions = {
     arrays: true;

package/dist/index.iife.js

@@ -1 +1 @@
-var Hyperutils=function(e){"use strict";const g=()=>{},t=i=>Object.prototype.toString.call(i).slice(8,-1),N=typeof window<"u",s=i=>i===null,l=i=>typeof i>"u",n=i=>typeof i=="string",S=i=>n(i)&&i.trim().length===0,a=i=>typeof i=="boolean",b=i=>i===!0,r=i=>i===!1,c=i=>typeof i=="number"&&!isNaN(i),m=i=>Array.isArray(i),d=i=>m(i)&&i.length===0,y=i=>t(i)==="Object",L=i=>y(i)&&Object.keys(i).length===0,H=i=>i instanceof Function,M=i=>typeof i=="number"&&isNaN(i),O=i=>i instanceof RegExp,j=i=>i instanceof Map,k=i=>i instanceof WeakMap,v=i=>i instanceof Set,A=i=>i instanceof WeakSet,o=i=>t(i)==="Symbol",B=i=>i instanceof Date&&!isNaN(i.valueOf()),f=i=>typeof i=="bigint",R=i=>i===1/0||i===-1/0,W=i=>i instanceof URL,h=i=>i instanceof Error,C=i=>n(i)||c(i)||f(i)||a(i)||o(i)||s(i)||l(i),F=i=>i instanceof Element,U=i=>i instanceof HTMLElement,w=i=>i instanceof SVGElement,E=i=>i instanceof NodeList,I=i=>E(i)&&i.length===0,u=i=>i instanceof HTMLCollection,T=i=>u(i)&&i.length===0;return e.isArray=m,e.isArrayEmpty=d,e.isBigInt=f,e.isBoolean=a,e.isBrowser=N,e.isDate=B,e.isElement=F,e.isError=h,e.isFalse=r,e.isFunction=H,e.isHtmlCollection=u,e.isHtmlCollectionEmpty=T,e.isHtmlElement=U,e.isInfinity=R,e.isMap=j,e.isNaNValue=M,e.isNodeList=E,e.isNodeListEmpty=I,e.isNull=s,e.isNumber=c,e.isObject=y,e.isObjectEmpty=L,e.isPrimitive=C,e.isRegExp=O,e.isSet=v,e.isString=n,e.isStringEmpty=S,e.isSvgElement=w,e.isSymbol=o,e.isTrue=b,e.isURL=W,e.isUndefined=l,e.isWeakMap=k,e.isWeakSet=A,e.noop=g,e.toString=t,e}({});
+var Hyperutils=(function(e){"use strict";const g=()=>{},t=i=>Object.prototype.toString.call(i).slice(8,-1),N=typeof window<"u",s=i=>i===null,l=i=>typeof i>"u",n=i=>typeof i=="string",S=i=>n(i)&&i.trim().length===0,a=i=>typeof i=="boolean",b=i=>i===!0,r=i=>i===!1,c=i=>typeof i=="number"&&!isNaN(i),m=i=>Array.isArray(i),d=i=>m(i)&&i.length===0,y=i=>t(i)==="Object",L=i=>y(i)&&Object.keys(i).length===0,H=i=>i instanceof Function,M=i=>typeof i=="number"&&isNaN(i),O=i=>i instanceof RegExp,j=i=>i instanceof Map,k=i=>i instanceof WeakMap,v=i=>i instanceof Set,A=i=>i instanceof WeakSet,o=i=>t(i)==="Symbol",B=i=>i instanceof Date&&!isNaN(i.valueOf()),f=i=>typeof i=="bigint",R=i=>i===1/0||i===-1/0,W=i=>i instanceof URL,h=i=>i instanceof Error,C=i=>n(i)||c(i)||f(i)||a(i)||o(i)||s(i)||l(i),F=i=>i instanceof Element,U=i=>i instanceof HTMLElement,w=i=>i instanceof SVGElement,E=i=>i instanceof NodeList,I=i=>E(i)&&i.length===0,u=i=>i instanceof HTMLCollection,T=i=>u(i)&&i.length===0;return e.isArray=m,e.isArrayEmpty=d,e.isBigInt=f,e.isBoolean=a,e.isBrowser=N,e.isDate=B,e.isElement=F,e.isError=h,e.isFalse=r,e.isFunction=H,e.isHtmlCollection=u,e.isHtmlCollectionEmpty=T,e.isHtmlElement=U,e.isInfinity=R,e.isMap=j,e.isNaNValue=M,e.isNodeList=E,e.isNodeListEmpty=I,e.isNull=s,e.isNumber=c,e.isObject=y,e.isObjectEmpty=L,e.isPrimitive=C,e.isRegExp=O,e.isSet=v,e.isString=n,e.isStringEmpty=S,e.isSvgElement=w,e.isSymbol=o,e.isTrue=b,e.isURL=W,e.isUndefined=l,e.isWeakMap=k,e.isWeakSet=A,e.noop=g,e.toString=t,e})({});

package/dist/index.umd.js

@@ -1 +1 @@
-(function(e,t){typeof exports=="object"&&typeof module<"u"?t(exports):typeof define=="function"&&define.amd?define(["exports"],t):(e=typeof globalThis<"u"?globalThis:e||self,t(e.Hyperutils={}))})(this,function(e){"use strict";const t=()=>{},n=i=>Object.prototype.toString.call(i).slice(8,-1),d=typeof window<"u",l=i=>i===null,a=i=>typeof i>"u",s=i=>typeof i=="string",N=i=>s(i)&&i.trim().length===0,o=i=>typeof i=="boolean",S=i=>i===!0,b=i=>i===!1,f=i=>typeof i=="number"&&!isNaN(i),m=i=>Array.isArray(i),r=i=>m(i)&&i.length===0,c=i=>n(i)==="Object",L=i=>c(i)&&Object.keys(i).length===0,H=i=>i instanceof Function,h=i=>typeof i=="number"&&isNaN(i),j=i=>i instanceof RegExp,M=i=>i instanceof Map,O=i=>i instanceof WeakMap,k=i=>i instanceof Set,A=i=>i instanceof WeakSet,y=i=>n(i)==="Symbol",B=i=>i instanceof Date&&!isNaN(i.valueOf()),u=i=>typeof i=="bigint",R=i=>i===1/0||i===-1/0,T=i=>i instanceof URL,W=i=>i instanceof Error,v=i=>s(i)||f(i)||u(i)||o(i)||y(i)||l(i)||a(i),C=i=>i instanceof Element,F=i=>i instanceof HTMLElement,U=i=>i instanceof SVGElement,E=i=>i instanceof NodeList,w=i=>E(i)&&i.length===0,g=i=>i instanceof HTMLCollection,I=i=>g(i)&&i.length===0;e.isArray=m,e.isArrayEmpty=r,e.isBigInt=u,e.isBoolean=o,e.isBrowser=d,e.isDate=B,e.isElement=C,e.isError=W,e.isFalse=b,e.isFunction=H,e.isHtmlCollection=g,e.isHtmlCollectionEmpty=I,e.isHtmlElement=F,e.isInfinity=R,e.isMap=M,e.isNaNValue=h,e.isNodeList=E,e.isNodeListEmpty=w,e.isNull=l,e.isNumber=f,e.isObject=c,e.isObjectEmpty=L,e.isPrimitive=v,e.isRegExp=j,e.isSet=k,e.isString=s,e.isStringEmpty=N,e.isSvgElement=U,e.isSymbol=y,e.isTrue=S,e.isURL=T,e.isUndefined=a,e.isWeakMap=O,e.isWeakSet=A,e.noop=t,e.toString=n});
+(function(e,t){typeof exports=="object"&&typeof module<"u"?t(exports):typeof define=="function"&&define.amd?define(["exports"],t):(e=typeof globalThis<"u"?globalThis:e||self,t(e.Hyperutils={}))})(this,(function(e){"use strict";const t=()=>{},n=i=>Object.prototype.toString.call(i).slice(8,-1),d=typeof window<"u",l=i=>i===null,a=i=>typeof i>"u",s=i=>typeof i=="string",N=i=>s(i)&&i.trim().length===0,o=i=>typeof i=="boolean",S=i=>i===!0,b=i=>i===!1,f=i=>typeof i=="number"&&!isNaN(i),m=i=>Array.isArray(i),r=i=>m(i)&&i.length===0,c=i=>n(i)==="Object",L=i=>c(i)&&Object.keys(i).length===0,H=i=>i instanceof Function,h=i=>typeof i=="number"&&isNaN(i),j=i=>i instanceof RegExp,M=i=>i instanceof Map,O=i=>i instanceof WeakMap,k=i=>i instanceof Set,A=i=>i instanceof WeakSet,y=i=>n(i)==="Symbol",B=i=>i instanceof Date&&!isNaN(i.valueOf()),u=i=>typeof i=="bigint",R=i=>i===1/0||i===-1/0,T=i=>i instanceof URL,W=i=>i instanceof Error,v=i=>s(i)||f(i)||u(i)||o(i)||y(i)||l(i)||a(i),C=i=>i instanceof Element,F=i=>i instanceof HTMLElement,U=i=>i instanceof SVGElement,E=i=>i instanceof NodeList,w=i=>E(i)&&i.length===0,g=i=>i instanceof HTMLCollection,I=i=>g(i)&&i.length===0;e.isArray=m,e.isArrayEmpty=r,e.isBigInt=u,e.isBoolean=o,e.isBrowser=d,e.isDate=B,e.isElement=C,e.isError=W,e.isFalse=b,e.isFunction=H,e.isHtmlCollection=g,e.isHtmlCollectionEmpty=I,e.isHtmlElement=F,e.isInfinity=R,e.isMap=M,e.isNaNValue=h,e.isNodeList=E,e.isNodeListEmpty=w,e.isNull=l,e.isNumber=f,e.isObject=c,e.isObjectEmpty=L,e.isPrimitive=v,e.isRegExp=j,e.isSet=k,e.isString=s,e.isStringEmpty=N,e.isSvgElement=U,e.isSymbol=y,e.isTrue=S,e.isURL=T,e.isUndefined=a,e.isWeakMap=O,e.isWeakSet=A,e.noop=t,e.toString=n}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypernym/utils",
-  "version": "3.4.4",
+  "version": "3.4.5",
   "author": "Hypernym Studio",
   "description": "A collection of reusable utilities.",
   "license": "MIT",
@@ -37,16 +37,6 @@
     "js",
     "ts"
   ],
-  "scripts": {
-    "dev:browser": "vite playgrounds/browser",
-    "dev:server": "bun --watch playgrounds/server/main.ts",
-    "build": "hyperbundler",
-    "test": "vitest -c test/vitest.config.ts",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
-    "format": "prettier --write .",
-    "prepublishOnly": "npm run build"
-  },
   "peerDependencies": {
     "@types/node": ">=20.0.0",
     "typescript": ">=5.0.0"
@@ -60,14 +50,23 @@
     }
   },
   "devDependencies": {
-    "@hypernym/bundler": "^0.14.3",
-    "@hypernym/eslint-config": "^3.6.1",
-    "@hypernym/prettier-config": "^3.2.4",
-    "@hypernym/tsconfig": "^2.6.1",
-    "@types/node": "^22.15.17",
-    "eslint": "^9.26.0",
-    "prettier": "^3.5.3",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.3"
+    "@hypernym/bundler": "^0.14.4",
+    "@hypernym/eslint-config": "^3.6.3",
+    "@hypernym/prettier-config": "^3.2.6",
+    "@hypernym/tsconfig": "^2.6.2",
+    "@types/node": "^24.3.0",
+    "eslint": "^9.33.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "dev:browser": "vite playgrounds/browser",
+    "dev:server": "bun --watch playgrounds/server/main.ts",
+    "build": "hyperbundler",
+    "test": "vitest -c test/vitest.config.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "format": "prettier --write ."
   }
-}
+}