@rzl-zone/utils-js 3.13.1 → 3.14.0

package/dist/assertions/index.d.ts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as assertIsBigInt, i as assertIsNumber, n as assertIsPlainObject, o as assertIsBoolean, r as assertIsArray, t as assertIsString } from "../index-B1VQ6USF.js";
+import { a as assertIsBigInt, i as assertIsNumber, n as assertIsPlainObject, o as assertIsBoolean, r as assertIsArray, t as assertIsString } from "../index-DqYMKSmd.js";
 export { assertIsArray, assertIsBigInt, assertIsBoolean, assertIsNumber, assertIsPlainObject, assertIsString };

package/dist/assertions/index.js

@@ -2,16 +2,18 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { T as assertIsPlainObject, b as hasOwnProp, n as resolveErrorMessageAssertions, t as assertIsBoolean, w as isNumber } from "../assertIsBoolean-CWUs-I5l.js";
-import { t as isBigInt } from "../isBigInt-y7s3rsKc.js";
-import { t as assertIsArray } from "../assertIsArray-HgzPQIAM.js";
-import { t as assertIsString } from "../assertIsString-CY_WkCLr.js";
-const assertIsBigInt = (value, options = {}) => {
+import { n as assertIsBoolean, r as resolveErrorMessageAssertions } from "../logger-Wxl_Krg6.js";
+import { t as isBigInt } from "../isBigInt-DdFRCpeE.js";
+import { t as isNumber } from "../isNumber-C1mOuBuA.js";
+import { t as assertIsArray } from "../assertIsArray-DmlqnTiq.js";
+import { t as assertIsPlainObject } from "../assertIsPlainObject-CIzDchLs.js";
+import { t as assertIsString } from "../assertIsString-sgY3ml5f.js";
+const assertIsBigInt = (value, options) => {
 	if (isBigInt(value)) return;
 	resolveErrorMessageAssertions({
 		value,
@@ -19,8 +21,8 @@ const assertIsBigInt = (value, options = {}) => {
 		requiredValidType: "bigint"
 	});
 };
-const assertIsNumber = (value, options = {}) => {
-	if (isNumber(value, { includeNaN: hasOwnProp(options, "includeNaN") ? options.includeNaN : void 0 })) return;
+const assertIsNumber = (value, options) => {
+	if (isNumber(value, { includeNaN: options?.includeNaN ?? void 0 })) return;
 	resolveErrorMessageAssertions({
 		value,
 		options,

package/dist/assertions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/assertions/number/assertIsBigInt.ts","../../src/assertions/number/assertIsNumber.ts"],"sourcesContent":["import { isBigInt } from \"@/predicates/is/isBigInt\";\n\nimport {\n  resolveErrorMessageAssertions,\n  type OptionsAssertIs\n} from \"../_private/assertIs\";\n\n/** -------------------------------------------------------\n * * ***Type guard assertion: `assertIsBigInt`.***\n * -------------------------------------------------------\n * **This function is an **assertion function**.**\n * - **Behavior:**\n *    - Validates that the given `value` is a **bigint**.\n *    - After it returns successfully, TypeScript narrows the type of `value` to `bigint`.\n *    - ✅ If `value` is a `bigint` ➔ execution continues normally.\n *    - ❌ If `value` is not a `bigint` ➔ throws a built-in error with either:\n *      - A custom error message (`options.message`), or\n *      - A default message including the actual type.\n *  - **ℹ️ Note:**\n *    - A `bigint` refers strictly to the JavaScript `bigint` primitive type (e.g., `123n`, `0n`, `-999999999999999999999n`).\n *    - This excludes `BigInt` objects created with `Object(BigInt(123))`.\n *  - **⚠️ Error type selection (`options.errorType`):**\n *    - You can override the type of error thrown when validation fails.\n *    - Must be one of the standard JavaScript built-in errors:\n *      - [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) |\n *        [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) |\n *        [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) |\n *        [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) |\n *        [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) |\n *        [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) |\n *        [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError)\n *    - **Default:** `\"TypeError\"` if not provided or invalid.\n * @param {*} value - ***The value to validate.***\n * @param {OptionsAssertIs} [options]\n *  ***Optional configuration:***\n *    - `message`: A custom error message (`string` or `function`).\n *    - `errorType`: Built-in JavaScript error type to throw on failure (default `\"TypeError\"`).\n *    - `formatCase`: Controls how detected type names are formatted case in error messages.\n *    - `useAcronyms`: Control uppercase preservation of recognized acronyms during formatting.\n * @returns {boolean} Narrows `value` to `bigint` if no error is thrown.\n * @throws [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) | [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) | [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) | [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) | [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) | [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) | [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError) if the value is not a bigint.\n * @example\n * ```ts\n * // ✅ Simple usage\n * assertIsBigInt(123n);\n * // No error, value is bigint\n *\n * // ❌ Throws TypeError (default behavior)\n * assertIsBigInt(42);\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `bigint`, but received: `number`.\"\n *\n * // ❌ Throws a TypeError with a custom string static message\n * assertIsBigInt(\"123\", { message: \"Must be a bigint!\" });\n * // ➔ TypeError: \"Must be a bigint!\"\n *\n * // ❌ Throws custom error type (e.g., RangeError)\n * assertIsBigInt(async function () {}, { errorType: \"RangeError\" });\n * // ➔ RangeError: \"Parameter input (`value`) must be of type `bigint`, but received: `async-function`.\"\n *\n * // ❌ Throws a TypeError with a custom message function and formatCase\n * assertIsBigInt(/regex/, {\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n *   formatCase: \"toPascalCaseSpace\"\n * });\n * // ➔ TypeError: \"Expected bigint but got (Reg Exp).\"\n *\n * // ❌ Throws a TypeError with a custom useAcronyms option\n * // Case 1:\n * assertIsBigInt(new URL(\"https://example.com\"),{\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (url).\"\n * assertIsBigInt(new URL(\"https://example.com\"), {\n *   useAcronyms: true,\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (URL).\"\n *\n * // Case 2:\n * assertIsBigInt(new URLSearchParams, {\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (UrlSearchParams).\"\n * assertIsBigInt(new URLSearchParams, {\n *   useAcronyms: true,\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (URLSearchParams).\"\n * ```\n * -------------------------------------------------------\n * ✅ ***Real-world usage example***:\n * ```ts\n * const mixedValue: string | bigint | undefined = getUserInput();\n *\n * // Runtime assertion: throws if `mixedValue` is not a `bigint`\n * assertIsBigInt(mixedValue, {\n *   errorType: \"RangeError\",\n *   message: \"Must be bigint!\"\n * });\n *\n * // ✅ If no error thrown, TypeScript narrows `mixedValue` to `bigint` here\n * const result: bigint = mixedValue; // ➔ Safe type assignment\n * console.log(result + 100n);        // ➔ Safe to operation\n * ```\n */\nexport const assertIsBigInt: (\n  value: unknown,\n  options?: OptionsAssertIs\n) => asserts value is bigint = (\n  value: unknown,\n  options: OptionsAssertIs = {}\n): asserts value is bigint => {\n  if (isBigInt(value)) return;\n\n  resolveErrorMessageAssertions({\n    value,\n    options,\n    requiredValidType: \"bigint\"\n  });\n};\n","import { isNumber, type IsNumberOptions } from \"@/predicates/is/isNumber\";\n\nimport {\n  resolveErrorMessageAssertions,\n  type OptionsAssertIs\n} from \"../_private/assertIs\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\n\ntype OptionsAssertIsNumber = OptionsAssertIs & IsNumberOptions;\n\n/** -------------------------------------------------------\n * * ***Type guard assertion: `assertIsNumber`.***\n * -------------------------------------------------------\n * **This function is an **assertion function**.**\n * - **Behavior:**\n *    - Validates that the given `value` is a **number**.\n *    - After it returns successfully, TypeScript narrows the type of `value` to `number`.\n *    - ✅ If `value` is a `number` ➔ execution continues normally.\n *    - ❌ If `value` is not a `number` ➔ throws a built-in error with either:\n *      - A custom error message (`options.message`), or\n *      - A default message including the actual type.\n * - **ℹ️ Note:**\n *    - A `number` refers strictly to the JavaScript `number` primitive type (e.g., `42`, `3.14`, `-1`, `0`).\n *    - This excludes `Number` objects created with `new Number(123)`.\n *    - By default, `NaN` is **not considered** valid, you can allow it with `{ includeNaN: true }`.\n * - **⚠️ Error type selection (`options.errorType`):**\n *    - You can override the type of error thrown when validation fails.\n *    - Must be one of the standard JavaScript built-in errors:\n *      - [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) |\n *        [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) |\n *        [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) |\n *        [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) |\n *        [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) |\n *        [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) |\n *        [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError)\n *    - **Default:** `\"TypeError\"` if not provided or invalid.\n * @param {*} value - ***The value to validate.***\n * @param {OptionsAssertIsNumber} [options]\n *  ***Optional configuration:***\n *    - `message`: A custom error message (`string` or `function`).\n *    - `errorType`: Built-in JavaScript error type to throw on failure (default `\"TypeError\"`).\n *    - `formatCase`: Controls how detected type names are formatted case in error messages.\n *    - `useAcronyms`: Control uppercase preservation of recognized acronyms during formatting.\n *    - `includeNaN`: Whether to treat `NaN` as valid.\n * @returns {boolean} Narrows `value` to `number` if no error is thrown.\n * @throws [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) | [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) | [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) | [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) | [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) | [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) | [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError) if the value is not a number (or is `NaN` when `includeNaN` is `false`).\n * @example\n * ```ts\n * // ✅ Simple usage\n * assertIsNumber(123);\n * assertIsNumber(NaN, { includeNaN: true });\n * // No error, value is number\n *\n * // ❌ Throws TypeError (default behavior)\n * // Case 1: Invalid input type — received a string instead of a number\n * assertIsNumber(\"42\");\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `string`.\"\n *\n * // Case 2: Default option includeNaN is false\n * assertIsNumber(NaN);\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `NaN`.\"\n *\n * // Case 3: The new Number() is a Number object (constructor), not a primitive number\n * assertIsNumber(new Number(\"123\"));\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `number-constructor`.\"\n *\n * // ❌ Throws custom error type (e.g., RangeError)\n * assertIsNumber(async function () {}, { errorType: \"RangeError\" });\n * // ➔ RangeError: \"Parameter input (`value`) must be of type `number`, but received: `async-function`.\"\n *\n * // ❌ Throws a TypeError with a custom string static message\n * assertIsNumber(\"123\", { message: \"Must be a number!\" });\n * // ➔ TypeError: \"Must be a number!\"\n *\n * // ❌ Throws a TypeError with a custom message function and formatCase\n * assertIsNumber(/regex/, {\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n *   formatCase: \"toPascalCaseSpace\"\n * });\n * // ➔ TypeError: \"Expected number but got (Reg Exp).\"\n *\n * // ❌ Throws a TypeError with a custom useAcronyms option\n * // Case 1:\n * assertIsNumber(new URL(\"https://example.com\"),{\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (url).\"\n * assertIsNumber(new URL(\"https://example.com\"), {\n *   useAcronyms: true,\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (URL).\"\n *\n * // Case 2:\n * assertIsNumber(new URLSearchParams, {\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (UrlSearchParams).\"\n * assertIsNumber(new URLSearchParams, {\n *   useAcronyms: true,\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (URLSearchParams).\"\n * ```\n * -------------------------------------------------------\n * ✅ ***Real-world usage example***:\n * ```ts\n * const mixedValue: string | number | undefined = getUserInput();\n *\n * // Runtime assertion: throws if `mixedValue` is not a `number`\n * assertIsNumber(mixedValue, {\n *   errorType: \"RangeError\",\n *   message: \"Must be number!\"\n * });\n *\n * // ✅ If no error thrown, TypeScript narrows `mixedValue` to `number` here\n * const result: number = mixedValue; // ➔ Safe type assignment\n * console.log(result + 100);         // ➔ Safe to operation\n * ```\n */\nexport const assertIsNumber: (\n  value: unknown,\n  options?: OptionsAssertIsNumber\n) => asserts value is number = (\n  value: unknown,\n  options: OptionsAssertIsNumber = {}\n): asserts value is number => {\n  const includeNaN = hasOwnProp(options, \"includeNaN\")\n    ? options.includeNaN\n    : undefined;\n\n  if (isNumber(value, { includeNaN })) return;\n\n  resolveErrorMessageAssertions({\n    value,\n    options,\n    requiredValidType: \"number\"\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqHA,MAAa,kBAIX,OACA,UAA2B,CAAC,MACA;CAC5B,IAAI,SAAS,KAAK,GAAG;CAErB,8BAA8B;EAC5B;EACA;EACA,mBAAmB;CACrB,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACCA,MAAa,kBAIX,OACA,UAAiC,CAAC,MACN;CAK5B,IAAI,SAAS,OAAO,EAAE,YAJH,WAAW,SAAS,YAAY,IAC/C,QAAQ,aACR,OAE6B,CAAC,GAAG;CAErC,8BAA8B;EAC5B;EACA;EACA,mBAAmB;CACrB,CAAC;AACH"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/assertions/number/assertIsBigInt.ts","../../src/assertions/number/assertIsNumber.ts"],"sourcesContent":["import { isBigInt } from \"@/predicates/is/isBigInt\";\n\nimport {\n  resolveErrorMessageAssertions,\n  type OptionsAssertIs\n} from \"../_private/assertIs\";\n\n/** --------------------------------------------------------------------------------\n * * ***Type guard assertion: `assertIsBigInt`.***\n * ---------------------------------------------------------------------------------\n * **This function is an **assertion function**.**\n *\n * - **Behavior:**\n *     - Validates that the given `value` is a **bigint**.\n *     - After it returns successfully, TypeScript narrows the type of `value` to `bigint`.\n *     - If `value` is a `bigint` ➔ execution continues normally.\n *     - If `value` is not a `bigint` ➔ throws a built-in error with either:\n *       - A custom error message (`options.message`), or\n *       - A default message including the actual type.\n * - **Note:**\n *     - A `bigint` refers strictly to the JavaScript `bigint` primitive type (e.g., `123n`, `0n`, `-999999999999999999999n`).\n *     - This excludes `BigInt` objects created with `Object(BigInt(123))`.\n * - **Error type selection (`options.errorType`):**\n *     - You can override the type of error thrown when validation fails.\n *     - Must be one of the standard JavaScript built-in errors:\n *       - [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) |\n *         [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) |\n *         [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) |\n *         [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) |\n *         [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) |\n *         [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) |\n *         [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError).\n *     - **Default:** `\"TypeError\"` if not provided or invalid.\n *\n * @param {*} value - ***The value to validate.***\n * @param {OptionsAssertIs} [options]\n *  ***Optional configuration:***\n *     - `message`: A custom error message (`string` or `function`).\n *     - `errorType`: Built-in JavaScript error type to throw on failure (default `\"TypeError\"`).\n *     - `formatCase`: Controls how detected type names are formatted case in error messages.\n *     - `useAcronyms`: Control uppercase preservation of recognized acronyms during formatting.\n *\n * @throws [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) | [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) | [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) | [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) | [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) | [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) | [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError) if the value is not a bigint.\n * @returns {boolean} Narrows `value` to `bigint` if no error is thrown.\n *\n * @example\n * ```ts\n * // ✅ Simple usage\n * assertIsBigInt(123n);\n * // No error, value is bigint\n *\n * // ❌ Throws TypeError (default behavior)\n * assertIsBigInt(42);\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `bigint`, but received: `number`.\"\n *\n * // ❌ Throws a TypeError with a custom string static message\n * assertIsBigInt(\"123\", { message: \"Must be a bigint!\" });\n * // ➔ TypeError: \"Must be a bigint!\"\n *\n * // ❌ Throws custom error type (e.g., RangeError)\n * assertIsBigInt(async function () {}, { errorType: \"RangeError\" });\n * // ➔ RangeError: \"Parameter input (`value`) must be of type `bigint`, but received: `async-function`.\"\n *\n * // ❌ Throws a TypeError with a custom message function and formatCase\n * assertIsBigInt(/regex/, {\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n *   formatCase: \"toPascalCaseSpace\"\n * });\n * // ➔ TypeError: \"Expected bigint but got (Reg Exp).\"\n *\n * // ❌ Throws a TypeError with a custom useAcronyms option\n * // Case 1:\n * assertIsBigInt(new URL(\"https://example.com\"),{\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (url).\"\n * assertIsBigInt(new URL(\"https://example.com\"), {\n *   useAcronyms: true,\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (URL).\"\n *\n * // Case 2:\n * assertIsBigInt(new URLSearchParams, {\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (UrlSearchParams).\"\n * assertIsBigInt(new URLSearchParams, {\n *   useAcronyms: true,\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected bigint but got (URLSearchParams).\"\n * ```\n * -------------------------------------------------------\n * ✅ ***Real-world usage example***:\n * ```ts\n * const mixedValue: string | bigint | undefined = getUserInput();\n *\n * // Runtime assertion: throws if `mixedValue` is not a `bigint`\n * assertIsBigInt(mixedValue, {\n *   errorType: \"RangeError\",\n *   message: \"Must be bigint!\"\n * });\n *\n * // ✅ If no error thrown, TypeScript narrows `mixedValue` to `bigint` here\n * const result: bigint = mixedValue; // ➔ Safe type assignment\n * console.log(result + 100n);        // ➔ Safe to operation\n * ```\n */\nexport const assertIsBigInt: (\n  value: unknown,\n  options?: OptionsAssertIs\n) => asserts value is bigint = (\n  value: unknown,\n  options?: OptionsAssertIs\n): asserts value is bigint => {\n  if (isBigInt(value)) return;\n\n  resolveErrorMessageAssertions({\n    value,\n    options,\n    requiredValidType: \"bigint\"\n  });\n};\n","import { isNumber, type IsNumberOptions } from \"@/predicates/is/isNumber\";\n\nimport {\n  resolveErrorMessageAssertions,\n  type OptionsAssertIs\n} from \"../_private/assertIs\";\n\ntype OptionsAssertIsNumber = OptionsAssertIs & IsNumberOptions;\n\n/** --------------------------------------------------------------------------------\n * * ***Type guard assertion: `assertIsNumber`.***\n * ---------------------------------------------------------------------------------\n * **This function is an **assertion function**.**\n *\n * - **Behavior:**\n *     - Validates that the given `value` is a **number**.\n *     - After it returns successfully, TypeScript narrows the type of `value` to `number`.\n *     - If `value` is a `number` ➔ execution continues normally.\n *     - If `value` is not a `number` ➔ throws a built-in error with either:\n *       - A custom error message (`options.message`), or\n *       - A default message including the actual type.\n * - **Note:**\n *     - A `number` refers strictly to the JavaScript `number` primitive type (e.g., `42`, `3.14`, `-1`, `0`).\n *     - This excludes `Number` objects created with `new Number(123)`.\n *     - By default, `NaN` is **not considered** valid, you can allow it with `{ includeNaN: true }`.\n * - **Error type selection (`options.errorType`):**\n *     - You can override the type of error thrown when validation fails.\n *     - Must be one of the standard JavaScript built-in errors:\n *       - [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) |\n *         [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) |\n *         [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) |\n *         [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) |\n *         [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) |\n *         [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) |\n *         [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError).\n *     - **Default:** `\"TypeError\"` if not provided or invalid.\n *\n * @param {*} value - ***The value to validate.***\n * @param {OptionsAssertIsNumber} [options]\n *  ***Optional configuration:***\n *     - `message`: A custom error message (`string` or `function`).\n *     - `errorType`: Built-in JavaScript error type to throw on failure (default `\"TypeError\"`).\n *     - `formatCase`: Controls how detected type names are formatted case in error messages.\n *     - `useAcronyms`: Control uppercase preservation of recognized acronyms during formatting.\n *     - `includeNaN`: Whether to treat `NaN` as valid.\n *\n * @throws [`TypeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypeError) | [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) | [`EvalError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError) | [`RangeError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RangeError) | [`ReferenceError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError) | [`SyntaxError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError) | [`URIError`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/URIError) if the value is not a number (or is `NaN` when `includeNaN` is `false`).\n * @returns {boolean} Narrows `value` to `number` if no error is thrown.\n *\n * @example\n * ```ts\n * // ✅ Simple usage\n * assertIsNumber(123);\n * assertIsNumber(NaN, { includeNaN: true });\n * // No error, value is number\n *\n * // ❌ Throws TypeError (default behavior)\n * // Case 1: Invalid input type — received a string instead of a number\n * assertIsNumber(\"42\");\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `string`.\"\n *\n * // Case 2: Default option includeNaN is false\n * assertIsNumber(NaN);\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `NaN`.\"\n *\n * // Case 3: The new Number() is a Number object (constructor), not a primitive number\n * assertIsNumber(new Number(\"123\"));\n * // ➔ TypeError: \"Parameter input (`value`) must be of type `number`, but received: `number-constructor`.\"\n *\n * // ❌ Throws custom error type (e.g., RangeError)\n * assertIsNumber(async function () {}, { errorType: \"RangeError\" });\n * // ➔ RangeError: \"Parameter input (`value`) must be of type `number`, but received: `async-function`.\"\n *\n * // ❌ Throws a TypeError with a custom string static message\n * assertIsNumber(\"123\", { message: \"Must be a number!\" });\n * // ➔ TypeError: \"Must be a number!\"\n *\n * // ❌ Throws a TypeError with a custom message function and formatCase\n * assertIsNumber(/regex/, {\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n *   formatCase: \"toPascalCaseSpace\"\n * });\n * // ➔ TypeError: \"Expected number but got (Reg Exp).\"\n *\n * // ❌ Throws a TypeError with a custom useAcronyms option\n * // Case 1:\n * assertIsNumber(new URL(\"https://example.com\"),{\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (url).\"\n * assertIsNumber(new URL(\"https://example.com\"), {\n *   useAcronyms: true,\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (URL).\"\n *\n * // Case 2:\n * assertIsNumber(new URLSearchParams, {\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (UrlSearchParams).\"\n * assertIsNumber(new URLSearchParams, {\n *   useAcronyms: true,\n *   formatCase: \"toPascalCase\",\n *   message: ({ currentType, validType }) => {\n *     return `Expected ${validType} but got (${currentType}).`\n *   },\n * });\n * // ➔ TypeError: \"Expected number but got (URLSearchParams).\"\n * ```\n * -------------------------------------------------------\n * ✅ ***Real-world usage example***:\n * ```ts\n * const mixedValue: string | number | undefined = getUserInput();\n *\n * // Runtime assertion: throws if `mixedValue` is not a `number`\n * assertIsNumber(mixedValue, {\n *   errorType: \"RangeError\",\n *   message: \"Must be number!\"\n * });\n *\n * // ✅ If no error thrown, TypeScript narrows `mixedValue` to `number` here\n * const result: number = mixedValue; // ➔ Safe type assignment\n * console.log(result + 100);         // ➔ Safe to operation\n * ```\n */\nexport const assertIsNumber: (\n  value: unknown,\n  options?: OptionsAssertIsNumber\n) => asserts value is number = (\n  value: unknown,\n  options?: OptionsAssertIsNumber\n): asserts value is number => {\n  const includeNaN = options?.includeNaN ?? undefined;\n\n  if (isNumber(value, { includeNaN })) return;\n\n  resolveErrorMessageAssertions({\n    value,\n    options,\n    requiredValidType: \"number\"\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHA,MAAa,kBAIX,OACA,YAC4B;CAC5B,IAAI,SAAS,KAAK,GAAG;CAErB,8BAA8B;EAC5B;EACA;EACA,mBAAmB;CACrB,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACAA,MAAa,kBAIX,OACA,YAC4B;CAG5B,IAAI,SAAS,OAAO,EAAE,YAFH,SAAS,cAAc,OAET,CAAC,GAAG;CAErC,8BAA8B;EAC5B;EACA;EACA,mBAAmB;CACrB,CAAC;AACH"}

package/dist/conversions/index.cjs

@@ -2,18 +2,18 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_toStringArrayUnRecursive = require('../toStringArrayUnRecursive-pfk2oP8C.cjs');
-const require_conversions = require('../conversions-B3Rf8uId.cjs');
-const require_safeStableStringify = require('../safeStableStringify-Cmi6GyWj.cjs');
-const require_parsing = require('../parsing-BCZGco7n.cjs');
-const require_safeJsonParse = require('../safeJsonParse-sFqVXf-e.cjs');
+const require_toStringArrayUnRecursive = require('../toStringArrayUnRecursive-_lJEmBlf.cjs');
+const require_conversions = require('../conversions-UdMB90xR.cjs');
+const require_safeStableStringify = require('../safeStableStringify-MuBiT-4B.cjs');
+const require_parsing = require('../parsing-DB_S0WFz.cjs');
+const require_safeJsonParse = require('../safeJsonParse-B5F8XtrZ.cjs');
 exports.cleanParsedData = require_safeJsonParse.cleanParsedData;
 exports.convertType = require_conversions.convertType;
 exports.dedupeArray = require_conversions.dedupeArray;

package/dist/conversions/index.d.cts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { _ as dedupeArray, a as removeObjectPaths, c as parseCustomDate, d as parseCurrencyString, f as toBooleanLoose, g as filterNilArray, h as toBooleanContent, i as safeStableStringify, l as cleanParsedData, m as toBooleanContentDeep, n as toStringDeep, o as extractDigits, p as toBooleanExplicit, r as toNumberDeep, s as safeJsonParse, t as toStringDeepForce, u as convertType, v as toStringArrayUnRecursive, y as toNumberArrayUnRecursive } from "../index-Dig1fIhZ.cjs";
+import { _ as dedupeArray, a as removeObjectPaths, c as parseCustomDate, d as parseCurrencyString, f as toBooleanLoose, g as filterNilArray, h as toBooleanContent, i as safeStableStringify, l as cleanParsedData, m as toBooleanContentDeep, n as toStringDeep, o as extractDigits, p as toBooleanExplicit, r as toNumberDeep, s as safeJsonParse, t as toStringDeepForce, u as convertType, v as toStringArrayUnRecursive, y as toNumberArrayUnRecursive } from "../index-zAqCZxGr.cjs";
 export { cleanParsedData, convertType, dedupeArray, extractDigits, filterNilArray, parseCurrencyString, parseCustomDate, removeObjectPaths, safeJsonParse, safeStableStringify, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringArrayUnRecursive, toStringDeep, toStringDeepForce };

package/dist/conversions/index.d.ts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { _ as dedupeArray, a as removeObjectPaths, c as parseCustomDate, d as parseCurrencyString, f as toBooleanLoose, g as filterNilArray, h as toBooleanContent, i as safeStableStringify, l as cleanParsedData, m as toBooleanContentDeep, n as toStringDeep, o as extractDigits, p as toBooleanExplicit, r as toNumberDeep, s as safeJsonParse, t as toStringDeepForce, u as convertType, v as toStringArrayUnRecursive, y as toNumberArrayUnRecursive } from "../index-Dig1fIhZ.js";
+import { _ as dedupeArray, a as removeObjectPaths, c as parseCustomDate, d as parseCurrencyString, f as toBooleanLoose, g as filterNilArray, h as toBooleanContent, i as safeStableStringify, l as cleanParsedData, m as toBooleanContentDeep, n as toStringDeep, o as extractDigits, p as toBooleanExplicit, r as toNumberDeep, s as safeJsonParse, t as toStringDeepForce, u as convertType, v as toStringArrayUnRecursive, y as toNumberArrayUnRecursive } from "../index-BcoUy2oV.js";
 export { cleanParsedData, convertType, dedupeArray, extractDigits, filterNilArray, parseCurrencyString, parseCustomDate, removeObjectPaths, safeJsonParse, safeStableStringify, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringArrayUnRecursive, toStringDeep, toStringDeepForce };

package/dist/conversions/index.js

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { n as filterNilArray, t as toStringArrayUnRecursive } from "../toStringArrayUnRecursive-OOHGazks.js";
-import { a as toBooleanLoose, c as toBooleanContent, d as toNumberArrayUnRecursive, i as convertType, l as dedupeArray, n as toNumberDeep, o as toBooleanExplicit, r as removeObjectPaths, s as toBooleanContentDeep, t as toStringDeep, u as toStringDeepForce } from "../conversions-1s7xMBe_.js";
-import { t as safeStableStringify } from "../safeStableStringify-B2KTTS3r.js";
-import { t as parseCurrencyString } from "../parsing-Bfaw85Hd.js";
-import { i as parseCustomDate, n as extractDigits, r as cleanParsedData, t as safeJsonParse } from "../safeJsonParse-OnUwG2El.js";
+import { n as filterNilArray, t as toStringArrayUnRecursive } from "../toStringArrayUnRecursive-U-nkEIDs.js";
+import { a as toBooleanLoose, c as toBooleanContent, d as toNumberArrayUnRecursive, i as convertType, l as dedupeArray, n as toNumberDeep, o as toBooleanExplicit, r as removeObjectPaths, s as toBooleanContentDeep, t as toStringDeep, u as toStringDeepForce } from "../conversions-BkxqYXxy.js";
+import { t as safeStableStringify } from "../safeStableStringify-CDSYnLUz.js";
+import { t as parseCurrencyString } from "../parsing-DhIQhWpX.js";
+import { i as parseCustomDate, n as extractDigits, r as cleanParsedData, t as safeJsonParse } from "../safeJsonParse-DYSkUnhM.js";
 export { cleanParsedData, convertType, dedupeArray, extractDigits, filterNilArray, parseCurrencyString, parseCustomDate, removeObjectPaths, safeJsonParse, safeStableStringify, toBooleanContent, toBooleanContentDeep, toBooleanExplicit, toBooleanLoose, toNumberArrayUnRecursive, toNumberDeep, toStringArrayUnRecursive, toStringDeep, toStringDeepForce };

package/dist/{conversions-1s7xMBe_.js → conversions-BkxqYXxy.js}

@@ -2,25 +2,26 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.13.1`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, C as isSymbol, D as isNaN, E as isNull, F as isBoolean, M as isArray, N as isNil, O as isNumberObject, P as isFunction, S as isUndefined, T as assertIsPlainObject, _ as isBuffer, b as hasOwnProp, f as isSet, g as isStringObject, h as isBooleanObject, j as isObject, k as isString, m as isInfinityNumber, r as getPreciseType, t as assertIsBoolean, v as isError, w as isNumber, x as isObjectOrArray, y as isNonEmptyString } from "./assertIsBoolean-CWUs-I5l.js";
-import { t as isBigInt } from "./isBigInt-y7s3rsKc.js";
-import { t as assertIsArray } from "./assertIsArray-HgzPQIAM.js";
-import { t as assertIsString } from "./assertIsString-CY_WkCLr.js";
-import { n as isEmptyArray, t as isEmptyObject } from "./isEmptyObject-DPGR9iPj.js";
-import { n as filterNilArray } from "./toStringArrayUnRecursive-OOHGazks.js";
-import { n as isDate, r as isMap, t as safeStableStringify } from "./safeStableStringify-B2KTTS3r.js";
-import { i as isRegExp, t as isEqual } from "./isEqual-DM4S_kWh.js";
-import { t as isEmptyString } from "./isEmptyString-BYMz_wt9.js";
-import { n as isNonEmptyValue, t as isTypedArray } from "./isTypedArray-XiBnifLN.js";
+import { A as isFunction, C as isNumberObject, D as isObject, E as isPlainObject, O as isArray, S as isNaN, T as isString, _ as isBooleanObject, b as isError, g as isObjectOrArray, h as isInfinityNumber, i as getPreciseType, j as isBoolean, k as isNil, n as assertIsBoolean, p as isSet, t as createMessage, v as isStringObject, w as isNonEmptyString, x as isNull, y as isBuffer } from "./logger-Wxl_Krg6.js";
+import { t as isBigInt } from "./isBigInt-DdFRCpeE.js";
+import { t as isNumber } from "./isNumber-C1mOuBuA.js";
+import { t as assertIsArray } from "./assertIsArray-DmlqnTiq.js";
+import { t as assertIsPlainObject } from "./assertIsPlainObject-CIzDchLs.js";
+import { t as assertIsString } from "./assertIsString-sgY3ml5f.js";
+import { n as isEmptyObject, r as isEmptyArray } from "./isEmptyValue-h97JT4pD.js";
+import { n as filterNilArray } from "./toStringArrayUnRecursive-U-nkEIDs.js";
+import { a as isMap, i as isDate, n as isSymbol, r as isUndefined, t as safeStableStringify } from "./safeStableStringify-CDSYnLUz.js";
+import { n as isNonEmptyValue, o as isRegExp, r as isEqual, t as isTypedArray } from "./isTypedArray-BY8CIj3k.js";
+import { t as isEmptyString } from "./isEmptyString-B6ubItgT.js";
 function toNumberArrayUnRecursive(array, options = {}) {
-	assertIsPlainObject(options, { message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-	const riv = hasOwnProp(options, "removeInvalidValueNumber") ? options.removeInvalidValueNumber : true;
-	assertIsBoolean(riv, { message: ({ currentType, validType }) => `Parameter \`removeInvalidValueNumber\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
+	if (!isPlainObject(options)) options = {};
+	const riv = options.removeInvalidValueNumber ?? true;
+	assertIsBoolean(riv, { message: ({ currentType, validType }) => createMessage("toNumberArrayUnRecursive", `Parameter \`removeInvalidValueNumber\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`) });
 	if (isArray(array)) {
 		const result = Array.from(array, (x) => {
 			if (isBigInt(x)) return Number(x);
@@ -31,7 +32,7 @@ function toNumberArrayUnRecursive(array, options = {}) {
 	}
 }
 function toStringDeepForce(value, forceToString) {
-	if (!(forceToString === false || forceToString === "stringOrNumber" || forceToString === "primitives" || forceToString === "all")) throw new TypeError(`Second parameter \`forceToString\` must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(forceToString)}\`, with value: \`${safeStableStringify(forceToString, { keepUndefined: true })}\`.`);
+	if (!(forceToString === false || forceToString === "stringOrNumber" || forceToString === "primitives" || forceToString === "all")) throw new TypeError(createMessage("toStringDeepForce", `Second parameter \`forceToString\` must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(forceToString)}\`, with value: \`${safeStableStringify(forceToString, { keepUndefined: true })}\`.`));
 	if (isNaN(value)) return forceToString === "primitives" || forceToString === "all" ? "NaN" : NaN;
 	if (isString(value) || isNumber(value)) return forceToString === "stringOrNumber" || forceToString === "primitives" || forceToString === "all" ? String(value) : value;
 	if (isBoolean(value) || isBigInt(value) || isNil(value)) return forceToString === "primitives" || forceToString === "all" ? String(value) : value;
@@ -52,12 +53,12 @@ function toStringDeepForce(value, forceToString) {
 	return value;
 }
 const dedupeArray = (inputArray, options = {}) => {
-	assertIsArray(inputArray, { message: ({ currentType, validType }) => `First parameter (\`inputArray\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.` });
-	assertIsPlainObject(options, { message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-	const flatten = hasOwnProp(options, "flatten") ? options.flatten : false;
-	const forceToString = hasOwnProp(options, "forceToString") ? options.forceToString : false;
-	if (!(forceToString === false || forceToString === "stringOrNumber" || forceToString === "primitives" || forceToString === "all")) throw new TypeError(`Parameter \`forceToString\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(forceToString)}\`, with value: \`${safeStableStringify(forceToString, { keepUndefined: true })}\`.`);
-	assertIsBoolean(flatten, { message: ({ currentType, validType }) => `Parameter \`flatten\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
+	assertIsArray(inputArray, { message: ({ currentType, validType }) => errorMsg$1(`First parameter (\`inputArray\`) must be of type \`${validType}\` (array literal or instance), but received: \`${currentType}\`.`) });
+	assertIsPlainObject(options, { message: ({ currentType, validType }) => errorMsg$1(`Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`) });
+	const flatten = options.flatten ?? false;
+	const forceToString = options.forceToString ?? false;
+	if (!(forceToString === false || forceToString === "stringOrNumber" || forceToString === "primitives" || forceToString === "all")) throw new TypeError(errorMsg$1(`Parameter \`forceToString\` property of the \`options\` (second parameter) must be of type \`false\` or \`string\` with value one of "stringOrNumber" | "primitives" | "all", but received: \`${getPreciseType(forceToString)}\`, with value: \`${safeStableStringify(forceToString, { keepUndefined: true })}\`.`));
+	assertIsBoolean(flatten, { message: ({ currentType, validType }) => errorMsg$1(`Parameter \`flatten\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`) });
 	const process = (arr) => {
 		const seen = [];
 		return arr.reduce((acc, item) => {
@@ -77,6 +78,7 @@ const dedupeArray = (inputArray, options = {}) => {
 	};
 	return flatten ? process(deepFlatten(inputArray)) : process(inputArray);
 };
+const errorMsg$1 = (msg) => createMessage("dedupeArray", msg);
 const toBooleanContent = (value) => {
 	if (isNil(value)) return false;
 	if (isString(value)) return isNonEmptyString(value);
@@ -97,10 +99,10 @@ const toBooleanContentDeep = (value) => {
 const toBooleanExplicit = (value, options = {}) => {
 	if (isNil(value)) return false;
 	if (!isPlainObject(options)) options = {};
-	const ci = hasOwnProp(options, "caseInsensitive") ? options.caseInsensitive : false;
-	const ts = hasOwnProp(options, "trimString") ? options.trimString : true;
-	const incInd = hasOwnProp(options, "includeIndeterminate") ? options.includeIndeterminate : false;
-	if (!isBoolean(ci) || !isBoolean(ts) || !isBoolean(incInd)) throw new TypeError(`Parameters \`caseInsensitive\`, \`trimString\` and \`includeIndeterminate\` property of the \`options\` (second parameter) expected to be a \`boolean\` type, but received: ['caseInsensitive': \`${getPreciseType(ci)}\`, 'trimString': \`${getPreciseType(ts)}\`, 'includeIndeterminate': \`${getPreciseType(incInd)}\`].`);
+	const ci = options.caseInsensitive ?? false;
+	const ts = options.trimString ?? true;
+	const incInd = options.includeIndeterminate ?? false;
+	if (!isBoolean(ci) || !isBoolean(ts) || !isBoolean(incInd)) throw new TypeError(createMessage("toBooleanExplicit", `Parameters \`caseInsensitive\`, \`trimString\` and \`includeIndeterminate\` property of the \`options\` (second parameter) expected to be a \`boolean\` type, but received: ['caseInsensitive': \`${getPreciseType(ci)}\`, 'trimString': \`${getPreciseType(ts)}\`, 'includeIndeterminate': \`${getPreciseType(incInd)}\`].`));
 	if (isString(value)) {
 		let normalized = value;
 		if (ts) normalized = normalized.trim();
@@ -170,25 +172,26 @@ const deleteExactPathOnce = (obj, path) => {
 };
 function removeObjectPaths(object, keysToDelete, deepClone = true) {
 	if (isEmptyObject(object, { checkSymbols: true })) return {};
-	assertIsArray(keysToDelete, { message: ({ currentType, validType }) => `Second parameter (\`keysToDelete\`) must be of type \`${validType}\` with value of { key: string, deep?: boolean } plain-object, but received: \`${currentType}\`, with value: \`${safeStableStringify(keysToDelete, { keepUndefined: true })}\`.` });
-	if (!keysToDelete.every((k) => isPlainObject(k) && "key" in k)) throw new TypeError(`Each element in Second Parameter (\`keysToDelete\`) must be of type \`plain-object\` with at least a "key" property (optionally "deep"), but received: \`${safeStableStringify(keysToDelete, { keepUndefined: true })}\`.`);
+	assertIsArray(keysToDelete, { message: ({ currentType, validType }) => errorMsg(`Second parameter (\`keysToDelete\`) must be of type \`${validType}\` with value of { key: string, deep?: boolean } plain-object, but received: \`${currentType}\`, with value: \`${safeStableStringify(keysToDelete, { keepUndefined: true })}\`.`) });
+	if (!keysToDelete.every((k) => isPlainObject(k) && "key" in k)) throw new TypeError(errorMsg(`Each element in Second Parameter (\`keysToDelete\`) must be of type \`plain-object\` with at least a "key" property (optionally "deep"), but received: \`${safeStableStringify(keysToDelete, { keepUndefined: true })}\`.`));
 	let result = deepClone ? deepCloneSafe(object) : object;
 	for (const { key, deep } of keysToDelete) {
-		assertIsString(key, { message: ({ currentType, validType }) => `Parameter \`key\` at Second Parameter (\`keysToDelete\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-		if (!isUndefined(deep) && !isBoolean(deep)) throw new TypeError(`Parameter \`deep\` at Second Parameter (\`keysToDelete\`) ➔ (key: "${key}", deep: ${deep}) must be of type \`boolean\` or \`undefined\`, but received: \`${getPreciseType(deep)}\`.`);
+		assertIsString(key, { message: ({ currentType, validType }) => errorMsg(`Parameter \`key\` at Second Parameter (\`keysToDelete\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`) });
+		if (!isUndefined(deep) && !isBoolean(deep)) throw new TypeError(errorMsg(`Parameter \`deep\` at Second Parameter (\`keysToDelete\`) ➔ (key: "${key}", deep: ${deep}) must be of type \`boolean\` or \`undefined\`, but received: \`${getPreciseType(deep)}\`.`));
 		const path = key.split(".");
 		result = deep ? deleteNestedKey(result, path) : deleteExactPathOnce(result, path);
 	}
 	return result;
 }
-function toNumberDeep(input, options = {}) {
-	assertIsPlainObject(options, { message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-	const removeEmptyObjects = hasOwnProp(options, "removeEmptyObjects") ? options.removeEmptyObjects : false;
-	const removeEmptyArrays = hasOwnProp(options, "removeEmptyArrays") ? options.removeEmptyArrays : false;
+const errorMsg = (msg) => createMessage("removeObjectPaths", msg);
+function toNumberDeep(input, options) {
+	if (!isPlainObject(options)) options = {};
+	const removeEmptyObjects = options.removeEmptyObjects ?? false;
+	const removeEmptyArrays = options.removeEmptyArrays ?? false;
 	function _internal(input, options) {
 		if (isNil(input) || isRegExp(input)) return void 0;
 		const { removeEmptyArrays, removeEmptyObjects, isRoot } = options;
-		if (!isBoolean(removeEmptyObjects) || !isBoolean(removeEmptyArrays)) throw new TypeError(`Parameters \`removeEmptyObjects\` and \`removeEmptyArrays\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: ['removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`].`);
+		if (!isBoolean(removeEmptyObjects) || !isBoolean(removeEmptyArrays)) throw new TypeError(createMessage("toNumberDeep", `Parameters \`removeEmptyObjects\` and \`removeEmptyArrays\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: ['removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`].`));
 		if (isNumber(input) || isBoolean(input) || isNonEmptyString(input)) {
 			const num = Number(input);
 			return isInfinityNumber(num) || isNaN(num) ? void 0 : num;
@@ -284,14 +287,14 @@ function toNumberDeep(input, options = {}) {
 		isRoot: true
 	});
 }
-function toStringDeep(input, options = {}) {
-	assertIsPlainObject(options, { message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.` });
-	const removeEmptyObjects = hasOwnProp(options, "removeEmptyObjects") ? options.removeEmptyObjects : false;
-	const removeEmptyArrays = hasOwnProp(options, "removeEmptyArrays") ? options.removeEmptyArrays : false;
+function toStringDeep(input, options) {
+	if (!isPlainObject(options)) options = {};
+	const removeEmptyObjects = options.removeEmptyObjects ?? false;
+	const removeEmptyArrays = options.removeEmptyArrays ?? false;
 	function _internal(input, options) {
 		if (isNil(input) || isInfinityNumber(input)) return void 0;
 		const { removeEmptyArrays, removeEmptyObjects, isRoot } = options;
-		if (!isBoolean(removeEmptyObjects) || !isBoolean(removeEmptyArrays)) throw new TypeError(`Parameters \`removeEmptyObjects\` and \`removeEmptyArrays\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: ['removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`].`);
+		if (!isBoolean(removeEmptyObjects) || !isBoolean(removeEmptyArrays)) throw new TypeError(createMessage("toStringDeep", `Parameters \`removeEmptyObjects\` and \`removeEmptyArrays\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: ['removeEmptyObjects': \`${getPreciseType(removeEmptyObjects)}\`, 'removeEmptyArrays': \`${getPreciseType(removeEmptyArrays)}\`].`));
 		if (isNumber(input) || isString(input) || isBoolean(input)) return String(input);
 		if (isNumberObject(input)) {
 			const valOf = input.valueOf();
@@ -377,4 +380,4 @@ function toStringDeep(input, options = {}) {
 	});
 }
 export { toBooleanLoose as a, toBooleanContent as c, toNumberArrayUnRecursive as d, convertType as i, dedupeArray as l, toNumberDeep as n, toBooleanExplicit as o, removeObjectPaths as r, toBooleanContentDeep as s, toStringDeep as t, toStringDeepForce as u };
-//# sourceMappingURL=conversions-1s7xMBe_.js.map
+//# sourceMappingURL=conversions-BkxqYXxy.js.map