@rzl-zone/utils-js 3.7.1 → 3.8.0

package/dist/predicates/index.d.ts

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import{NumberRangeUnion,Prettify,IsPositive,ParseNumber,Extends,IsStringLiteral,CharAt,AnyString,AnyFunction,IsEmptyString,Trim,IsAny,IsUnknown,IsNever,IsReadonlyArray,IsArray,AnObjectNonArray,OrArr,TypedArray}from'@rzl-zone/ts-types-plus';import{a as IsPlainObjectResult,c as IsHasKeysObject}from'../isPlainObject-FWmcJF6k.js';export{G as GetPreciseTypeOptions,I as IsNumberOptions,g as getPreciseType,i as isNumber,b as isPlainObject}from'../isPlainObject-FWmcJF6k.js';
+import{NumberRangeUnion,Prettify,IsPositive,ParseNumber,Extends,IsStringLiteral,CharAt,AnyString,AnyFunction,IsEmptyString,Trim,IsAny,AnObjectNonArray,IsArray,OrArr,IsNever,TypedArray}from'@rzl-zone/ts-types-plus';import{a as IsPlainObjectResult,c as IsHasKeysObject}from'../isPlainObject-BTPjv6zB.js';export{G as GetPreciseTypeOptions,I as IsNumberOptions,g as getPreciseType,i as isNumber,b as isPlainObject}from'../isPlainObject-BTPjv6zB.js';
 /** ----------------------------------------------------------
  * * ***Predicate: `areArraysEqual`.***
  * ----------------------------------------------------------
@@ -23,8 +23,7 @@ import{NumberRangeUnion,Prettify,IsPositive,ParseNumber,Extends,IsStringLiteral,
  *    - If `true`, will sort both arrays recursively before comparing, default is `false`.
  * @returns {boolean}
  *    Returns `true` if both arrays are deeply equal, otherwise `false`.
- * @throws {TypeError}
- *    Throws if `array1` or `array2` are not arrays, or if `ignoreOrder` is not a boolean.
+ * @throws **{@link TypeError | `TypeError`}** if `array1` or `array2` are not arrays, or if `ignoreOrder` is not a boolean.
  * @example
  * ```ts
  * areArraysEqual([1, 2, 3], [1, 2, 3]);
@@ -578,8 +577,6 @@ declare function hasOwnProp<Obj>(obj:IsAny<Obj>extends true?Obj:never,key:Proper
  * // ➔ false
  */
 declare const isArguments:(value:unknown)=>value is IArguments;
-/** @deprecated bugs */
-type IsArrayResult<T>=IsUnknown<T>extends true?unknown[] & T:IsNever<T>extends true?[]:IsReadonlyArray<T>extends true?T:IsArray<T>extends true?T:unknown[];
 /** ----------------------------------------------------------
  * * ***Type guard: `isArray`.***
  * ----------------------------------------------------------
@@ -642,7 +639,7 @@ declare function isArrayLike<T extends{__anyHack:unknown;}>(value:T):boolean;dec
 /** ----------------------------------------------------
  * * ***Type guard: `isArrayLikeObject`.***
  * ----------------------------------------------------
- * **This method is like ***{@link isArrayLike | `isArrayLike`}*** except that
+ * **This method is like ***`isArrayLike` utility function*** except that
  *   it also checks if `value` is an object.**
  * @template T - The type of the value being checked.
  * @param {*} value The value to check.
@@ -731,7 +728,7 @@ declare const isBuffer:(value:unknown)=>value is Buffer;
  * * ***Predicate: `isCurrencyLike`.***
  * -----------------------------------------------------------
  * **Determines if the given `input` can be interpreted as a currency-like number,
- * using the same **multi-locale parsing logic** as ***{@link parseCurrencyString | `parseCurrencyString`}***.**
+ * using the same **multi-locale parsing logic** as ***`parseCurrencyString`***.**
  * - **Highlights:**
  *    - *Supports strings or numbers like:*
  *      - `"15.000,10"` ***(European)***.
@@ -742,7 +739,7 @@ declare const isBuffer:(value:unknown)=>value is Buffer;
  *    - Also accepts simple numbers (`15300.95`).
  * - **ℹ️ Note:**
  *    - Uses the same core logic as
- *      ***{@link parseCurrencyString | `parseCurrencyString`}*** but
+ *      ***`parseCurrencyString`*** but
  *      just checks if a final parsed float is sensible.
  * @param {*} input - The input value to check.
  * @returns {boolean} Return `true` if it can be reasonably parsed into a currency-like number, `false` otherwise.
@@ -952,7 +949,7 @@ type List<T>=ArrayLike<T>;
  *    - **Functions** are considered empty if they have no own enumerable keys.
  * - **ℹ️ Note:**
  *    - For more `Strict`, you can use
- *      **{@link isEmptyValue | `isEmptyValue`}** instead.
+ *      ***`isEmptyValue` utility function*** instead.
  * @template T - The type of the value being checked.
  * @param {*} value The value to check.
  * @returns {boolean} Returns `true` if `value` is empty, else `false`.
@@ -1267,7 +1264,7 @@ stack:unknown)=>boolean|undefined;
  * **Performs a deep comparison between two values with support for a
  * customizer function.**
  * @description
- * This method is like **{@link isEqual | `isEqual`}** except that it
+ * This method is like ***`isEqual` utility function*** except that it
  * accepts a `customizer` which is invoked to compare values.
  * - **Behavior:**
  *     - If `customizer` returns `undefined`, the comparison is handled by
@@ -1641,7 +1638,7 @@ declare function isNative(value:unknown):value is AnyFunction;
 /** ----------------------------------------------------
  * * ***Type guard: `isNil`.***
  * ----------------------------------------------------------
- * **Checks if a value is `null` or `undefined`.**
+ * **Checks if a value is **[`null`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/null)** or **[`undefined`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)**.**
  * - **Behavior:**
  *    - Narrows type to `null` or `undefined` when true.
  * @param {*} value - The value to check.
@@ -1686,7 +1683,7 @@ trim?:boolean;};
  * @description
  * Determines whether the given `value` is a string containing at least one non-whitespace character, with optional trimming behavior.
  * - **Behavior:**
- *    - Ensures the value is a string using **{@link isString | `isString`}**.
+ *    - Ensures the value is a string using ***`isString` utility function***.
  *    - Optionally trims whitespace before checking (`trim` defaults to `true`).
  *    - Narrows type to `string` when true.
  * @param {*} value - The value to test.
@@ -1830,8 +1827,8 @@ declare function isNumberObject(value:unknown):value is Number;type IsObject<T>=
  *    - Boxed primitives: `new String()`, `new Number()`, `new Boolean()`
  *    - `undefined` (including `NaN`, which is a primitive number)
  * - **ℹ️ Note:**
- *    - If you specifically need to check for ***plain-objects*** only, use **{@link isPlainObject}** instead.
- *    - If you specifically need to check for ***object***, ***plain-objects***, and include ***array***, use **{@link isObjectOrArray}** instead.
+ *    - If you specifically need to check for ***plain-objects*** only, use ***`isPlainObject` utility function*** instead.
+ *    - If you specifically need to check for ***object***, ***plain-objects***, and include ***array***, use ***`isObjectOrArray` utility function*** instead.
  * @template T - The type of the value being checked.
  * @param {*} value - The value to check.
  * @returns {boolean} Returns `true` if the value is a ***plain-objects***, otherwise `false`.
@@ -1853,7 +1850,7 @@ declare function isObject<T extends object>(value:T):value is IsObject<T>;declar
  * * ***Type guard: `isObjectLoose`.***
  * ----------------------------------------------------------
  * **Checks if a value is the
- * [ECMAScript language type **Object**](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types).**
+ * [ECMAScript language type ***Object***](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types).**
  * - **✅ Returns `true` for:**
  *    - Plain objects (`{}`)
  *    - Arrays (`[]`)
@@ -1873,7 +1870,7 @@ declare function isObject<T extends object>(value:T):value is IsObject<T>;declar
  *      - `symbol`
  *      - `bigint`
  * - **ℹ️ Note:**
- *    - **For More Strict Object Use {@link isObject} or {@link isPlainObject} instead.**
+ *    - **For More Strict Object Use ***`isObject`*** or ***`isPlainObject` utility function*** instead.**
  * @template T - The type of the value being checked.
  * @param {*} value The value to check.
  * @returns {boolean} Returns `true` if `value` is an object, else `false`.
@@ -2239,34 +2236,24 @@ allowProtocol?:boolean;};
  * @example
  * isValidDomain("google.com");
  * // ➔ true
- *
  * isValidDomain("пример.рф", { allowUnicode: true });
  * // ➔ true
- *
  * isValidDomain("sub.example.com", { subdomain: false });
  * // ➔ false
- *
  * isValidDomain("*.example.com", { wildcard: true });
  * // ➔ true
- *
  * isValidDomain("com", { topLevel: true });
  * // ➔ false (common TLD rejected because it's part of SLD)
- *
  * isValidDomain("ai.", { topLevel: true });
  * // ➔ true (country-code TLD accepted)
- *
  * isValidDomain("localhost", { allowLocalhost: true });
  * // ➔ true
- *
  * isValidDomain("localhost:3000", { allowLocalhost: true, allowPort: true });
  * // ➔ true
- *
  * isValidDomain("example.com:8080", { allowPort: true });
  * // ➔ true
- *
  * isValidDomain("https://example.com/foo/bar", { allowProtocol: true });
  * // ➔ true (protocol stripped and hostname validated)
- *
  * isValidDomain("invalid_domain.com");
  * // ➔ false
  */
@@ -2309,4 +2296,4 @@ declare const isValidURL:(url:unknown)=>boolean;
  * isWeakMap(new Map);
  * // ➔ false
  */
-declare function isWeakMap<K extends object=object,V=unknown>(value:unknown):value is WeakMap<K,V>;export{type IsArrayResult,IsPlainObjectResult,areArraysEqual,areObjectsEqual,areURLsEqualPath,areURLsIdentical,arrayHasAnyMatch,doesKeyExist,hasOwnProp,isArguments,isArray,isArrayBuffer,isArrayLike,isArrayLikeObject,isBigInt,isBoolean,isBooleanObject,isBuffer,isCurrencyLike,isDate,isDeepEqual,isElement,isEmpty,isEmptyArray,isEmptyDeep,isEmptyObject,isEmptyString,isEmptyValue,isEqual,isEqualWith,isError,isFinite,isFunction,isInfinityNumber,isInteger,isLength,isMap,isMatch,isMatchWith,isNaN,isNative,isNil,isNonEmptyArray,isNonEmptyString,isNonEmptyValue,isNull,isNumberObject,isObject,isObjectLoose,isObjectOrArray,isPropertyKey,isRegExp,isSafeInteger,isServer,isSet,isString,isStringObject,isSymbol,isTypedArray,isURL,isUndefined,isValidDomain,isValidURL,isWeakMap,textContainsAll,textContainsAny};
+declare function isWeakMap<K extends object=object,V=unknown>(value:unknown):value is WeakMap<K,V>;export{IsPlainObjectResult,areArraysEqual,areObjectsEqual,areURLsEqualPath,areURLsIdentical,arrayHasAnyMatch,doesKeyExist,hasOwnProp,isArguments,isArray,isArrayBuffer,isArrayLike,isArrayLikeObject,isBigInt,isBoolean,isBooleanObject,isBuffer,isCurrencyLike,isDate,isDeepEqual,isElement,isEmpty,isEmptyArray,isEmptyDeep,isEmptyObject,isEmptyString,isEmptyValue,isEqual,isEqualWith,isError,isFinite,isFunction,isInfinityNumber,isInteger,isLength,isMap,isMatch,isMatchWith,isNaN,isNative,isNil,isNonEmptyArray,isNonEmptyString,isNonEmptyValue,isNull,isNumberObject,isObject,isObjectLoose,isObjectOrArray,isPropertyKey,isRegExp,isSafeInteger,isServer,isSet,isString,isStringObject,isSymbol,isTypedArray,isURL,isUndefined,isValidDomain,isValidURL,isWeakMap,textContainsAll,textContainsAny};

package/dist/predicates/index.js

@@ -2,7 +2,7 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================

package/dist/promises/index.cjs

@@ -2,14 +2,14 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
 'use strict';
 
-var chunk2CQI36UD_cjs = require('../chunk-2CQI36UD.cjs');
+var chunkRJYWBVGD_cjs = require('../chunk-RJYWBVGD.cjs');
 require('../chunk-DVMHRLKP.cjs');
 require('../chunk-YC7AK3KX.cjs');
 require('../chunk-UDA26MCU.cjs');
@@ -17,9 +17,9 @@ require('../chunk-F3WBQKRI.cjs');
 
 Object.defineProperty(exports, "CustomPromise", {
   enumerable: true,
-  get: function () { return chunk2CQI36UD_cjs.CustomPromise; }
+  get: function () { return chunkRJYWBVGD_cjs.CustomPromise; }
 });
 Object.defineProperty(exports, "delay", {
   enumerable: true,
-  get: function () { return chunk2CQI36UD_cjs.delay; }
+  get: function () { return chunkRJYWBVGD_cjs.delay; }
 });

package/dist/promises/index.d.ts

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-import{CustomPromiseType}from'@rzl-zone/ts-types-plus';
+import{CustomPromiseType}from'@rzl-zone/ts-types-plus';export{CustomPromiseType}from'@rzl-zone/ts-types-plus';
 /** -------------------------------------------------------------
  * * ***Utility Class: `CustomPromise`.***
  * -------------------------------------------------------------
@@ -30,8 +30,8 @@ import{CustomPromiseType}from'@rzl-zone/ts-types-plus';
  * @template Error    Type of the rejection reason (default `unknown`).
  * @example
  * ```ts
- * import type { CustomPromiseType } from "@rzl-zone/types";
- * import { CustomPromise } from "@rzl-zone/promises";
+ * import type { CustomPromiseType } from "@rzl-zone/ts-types-plus";
+ * import { CustomPromise } from "@rzl-zone/utils-js/promises";
  *
  * type User = { id: number; name: string };
  * type ApiError = { message: string };
@@ -99,11 +99,10 @@ finish(cb:(val?:Success,err?:Error)=>void):this;}
  * @returns {Promise<void>}
  *  A promise that resolves after the specified delay or
  *  rejects with an `AbortError` if aborted.
- * @throws {TypeError} Validates `milliSeconds` and `signal`:
+ * @throws **{@link TypeError | `TypeError`}** while validates `milliSeconds` and `signal`:
  *  - If `milliSeconds` **is not a valid** an `integer-number`, `NaN`, `negative-number`, or `≤ 0`.
  *  - If `signal` **is not a valid** an`AbortSignal`.
- * @throws {DOMException}
- * If the delay is aborted using the signal, rejects with `"AbortError"`.
+ * @throws **{@link DOMException | `DOMException`}** if the delay is aborted using the signal, rejects with `AbortError`.
  * @example
  * // Waits for 2 seconds
  * await delay(2000);

package/dist/promises/index.js

@@ -2,12 +2,12 @@
  * ====================================================
  * Rzl Utils-JS.
  * ----------------------------------------------------
- * Version: 3.7.1.
+ * Version: 3.8.0.
  * Author: Rizalvin Dwiky.
  * Repository: https://github.com/rzl-zone/utils-js.
  * ====================================================
  */
-export { CustomPromise, delay } from '../chunk-VNADVWSJ.js';
+export { CustomPromise, delay } from '../chunk-JIROTDOU.js';
 import '../chunk-WVSPXFTY.js';
 import '../chunk-2VO2CBTU.js';
 import '../chunk-QNKGP5DY.js';