@rzl-zone/utils-js 3.14.0-beta.0 → 3.14.0

package/dist/generators/index.d.ts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 randomInt, i as randomIntByLength, n as randomUUID, o as getRandomItem, r as randomStr, t as noop } from "../index-BP3sUrAx.js";
+import { a as randomInt, i as randomIntByLength, n as randomUUID, o as getRandomItem, r as randomStr, t as noop } from "../index-k_rjVRjU.js";
 export { getRandomItem, noop, randomInt, randomIntByLength, randomStr, randomUUID };

package/dist/generators/index.js

@@ -2,17 +2,17 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { E as isPlainObject, S as isNaN, i as getPreciseType, j as isBoolean, m as isNonEmptyArray, n as assertIsBoolean, t as createMessage, w as isNonEmptyString } from "../logger-CLWnKRKE.js";
-import { t as isNumber } from "../isNumber-BCWD4dW0.js";
-import { t as safeStableStringify } from "../safeStableStringify-DfwxmiWn.js";
-import { t as noop } from "../noop-qxrcogt5.js";
-import { t as isInteger } from "../isInteger-aZgzTTZG.js";
-import { n as joinLines } from "../formatter-ekJQF_bA-xLD9mGk4.js";
+import { E as isPlainObject, S as isNaN, i as getPreciseType, j as isBoolean, m as isNonEmptyArray, n as assertIsBoolean, t as createMessage, w as isNonEmptyString } from "../logger-Wxl_Krg6.js";
+import { t as isNumber } from "../isNumber-C1mOuBuA.js";
+import { t as safeStableStringify } from "../safeStableStringify-CDSYnLUz.js";
+import { t as noop } from "../noop-D8aGbjbP.js";
+import { t as isInteger } from "../isInteger-BtA3flbk.js";
+import { n as joinLines } from "../formatter-BFgV1HhV-BtIJs2H2.js";
 function getRandomItem(array) {
 	if (!isNonEmptyArray(array)) return void 0;
 	return array[Math.floor(Math.random() * (array.length || 0))];

package/dist/{hasOwnProp-D9Tpgokd.cjs → hasOwnProp-DTWYqy7S.cjs}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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";
-const require_logger = require('./logger-CUacYy3D.cjs');
-const require_isNumber = require('./isNumber-BkzwAe50.cjs');
-const require_safeStableStringify = require('./safeStableStringify-C5HHKUdn.cjs');
+const require_logger = require('./logger-BXg2xufj.cjs');
+const require_isNumber = require('./isNumber-CM1vdNcW.cjs');
+const require_safeStableStringify = require('./safeStableStringify-MuBiT-4B.cjs');
 function hasOwnProp(obj, key, options = {}) {
 	if (!require_logger.isString(obj) && !require_logger.isObjectOrArray(obj) && !require_logger.isFunction(obj)) return false;
 	if (!require_logger.isPlainObject(options)) options = {};
@@ -50,4 +50,4 @@ Object.defineProperty(exports, 'hasOwnProp', {
     return hasOwnProp;
   }
 });
-//# sourceMappingURL=hasOwnProp-D9Tpgokd.cjs.map
+//# sourceMappingURL=hasOwnProp-DTWYqy7S.cjs.map

package/dist/{hasOwnProp-D9Tpgokd.cjs.map → hasOwnProp-DTWYqy7S.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"hasOwnProp-D9Tpgokd.cjs","names":["isString","isObjectOrArray","isFunction","isPlainObject","isNumber","isNaN","isSymbol","isNull","isUndefined","createMessage"],"sources":["../src/predicates/has/hasOwnProp.ts"],"sourcesContent":["import type {\n  AnyFunction,\n  AnyString,\n  IsAny,\n  IsStringLiteral\n} from \"@rzl-zone/ts-types-plus\";\nimport type {\n  DeepRequiredSymbolHasOwnProp,\n  GuardedHasOwnProp,\n  HasOwnPropOptions,\n  NestedKeyOfHasOwnProp,\n  SmartDetectArrayFuncHasOwnProp,\n  SmartDetectUnknownKeyHasOwnProp,\n  NumericKeyHasOwnPropMapped,\n  NumericKeyOfHasOwnProp,\n  SmartDetectStringHasOwnProp\n} from \"./hasOwnProp.types\";\n\nimport { createMessage } from \"@/_private/logger\";\n\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\nimport { isNaN } from \"../is/isNaN\";\nimport { isNull } from \"../is/isNull\";\nimport { isString } from \"../is/isString\";\nimport { isNumber } from \"../is/isNumber\";\nimport { isSymbol } from \"../is/isSymbol\";\nimport { isFunction } from \"../is/isFunction\";\nimport { isUndefined } from \"../is/isUndefined\";\nimport { isObjectOrArray } from \"../is/isObjectOrArray\";\nimport { isPlainObject, type IsPlainObjectResult } from \"../is/isPlainObject\";\n\n// ------------------- HAS OWN PROP OVERLOADS -------------------\n\n/** -------------------------------------------------------\n * * ***Type guard: `hasOwnProp`.***\n * --------------------------------------------------------\n * **A **type-safe** replacement for `Object.prototype.hasOwnProperty` with runtime validation and **TypeScript-aware type narrowing**.**\n *\n * ---\n * - #### *Supported Targets:*\n *       - **Plain objects** ➔ `{ foo: \"bar\" }`.\n *       - **Arrays** ➔ `[ { id: 1 }, { id: 2 } ]`.\n *       - **Strings** ➔ `\"hello\"` (as array-like objects with `.length`, index, etc.).\n *       - **Functions** ➔ callable objects with extra props.\n *       - **Symbols** ➔ own property symbols.\n *       ---\n * - #### *Key Advantages over `in` or `obj.hasOwnProperty(key)`:*\n *       - Supports **dot/bracket path notation** (e.g. `\"user.address.city\"`, `\"addresses[0].zip\"`).\n *       - Handles **symbol** keys safely.\n *       - **Narrows** the type of `obj` in TypeScript (stronger type safety).\n *       - Configurable handling of **`undefined`** and **`null`**.\n *       ---\n * - #### *Runtime Behavior:*\n *       - #### Returns `true` if:\n *            - Value `obj` is an object/array/string/function **and** the property\n *              exists **and**, it passes the `options` checks.\n *            ---\n *       - #### Returns `false` if:\n *            - Value `obj` is not a valid type.\n *            - The property does not exist.\n *            - The value is `undefined` and `discardUndefined: true` (**default**).\n *            - The value is `null` and `discardNull: true`.\n *            - The `key` (after trimming) is an **empty string** ➔ treated as **invalid**.\n *       ---\n * - #### *TypeScript Behavior:*\n *       - #### Inside an `if (hasOwnProp(...)) {}` block:\n *            - The property is **guaranteed to exist**.\n *            - Depending on `options`, the property type is narrowed to exclude\n *              `undefined` and/or `null`.\n *       ---\n * - #### *Caveats:*\n *       - #### Empty keys are invalid:\n *            - If the `key` string is empty (`\"\"`) after trimming whitespace or other characters,\n *              it will **not** be considered a valid property and always returns `false`.\n *            ---\n *       - #### Arrays are limited by TypeScript inference:\n *            - Checking index `[0]` only narrows **that specific index**, not the rest, example:\n *               1. `hasOwnProp(users, \"[0].id\")` does **not** imply `users[1].id` exists.\n *                   - For different indices, use **optional chaining** (`users[1]?.id`).\n *            ---\n *       - #### Autocomplete limitation for array indices:\n *            - Autocompletion for `[index]` is only supported up to **5** (`[0]` ➔ `[4]`).\n *            - This limit is intentional for **performance and safety:**\n *               1. Generating infinite union types for all possible indices would cause\n *                 **TypeScript IntelliSense to hang or crash**.\n *                   - You can still check higher indices manually (e.g. `\"[999].id\"`),\n *                     but they will not show up in IntelliSense suggestions.\n *\n * ---\n * @param {HasOwnPropOptions} [options] - ***Optional configuration object.***\n * @param {HasOwnPropOptions[\"discardUndefined\"]} [options.discardUndefined=true]\n *  ***If `true`, properties with `undefined` values are treated as **missing**, default: `true`.***\n * @param {HasOwnPropOptions[\"discardNull\"]} [options.discardNull=false]\n *  ***If `true`, properties with `null` values are treated as **missing**, default: `false`.***\n * @param {*} obj ***The `object`, `array`, `string`, `function`, or `other value` to check against.***\n * @param {PropertyKey} key\n *  ***The property key to check, can be:***\n *    - `string` (supports dot/bracket paths, e.g. `\"user.address.city\"`, `\"[0].id\"`).\n *    - `number` (array-like index).\n *    - `symbol` (own property symbols).\n *\n * ---\n * @returns {boolean} Return `true` if the property exists (and passes `options`), otherwise `false`.\n *\n * ---\n * @example\n *\n * - #### Objects:\n *   ```ts\n *   const obj: { name?: string | null } = {};\n *\n *   if (hasOwnProp(obj, \"name\")) {\n *     // obj is now ➔ { name: string | null }\n *     console.log(obj.name); // string | null\n *   }\n *\n *   if (hasOwnProp(obj, \"name\", { discardUndefined: true, discardNull: true })) {\n *     // obj is now ➔ { name: string }\n *     console.log(obj.name.toUpperCase()); // safe\n *   }\n *   ```\n * - #### Arrays:\n *   ```ts\n *   const users = [{ id: 1 }, { id: 2 }];\n *\n *   if (hasOwnProp(users, \"[1].id\")) {\n *     // ➔ users[1].id is guaranteed to exist\n *     console.log(users[1].id); // number\n *   }\n *\n *   // Caveat: narrowing only applies to checked index\n *   if (hasOwnProp(users, \"[0].id\")) {\n *     console.log(users[0].id); // safe\n *     console.log(users[1].id); // not guaranteed!\n *   }\n *\n *   // Solution: optional chaining\n *   console.log(users[1]?.id);\n *   // ➔ safe, even without narrowing\n *   ```\n *\n * - #### Symbols:\n *   ```ts\n *   const secret = Symbol(\"secret\");\n *   const obj2 = { [secret]: 42 };\n *\n *   if (hasOwnProp(obj2, secret)) {\n *     console.log(obj2[secret] + 1);\n *     // ➔ 43\n *   }\n *   ```\n * - #### Strings:\n *   ```ts\n *   if (hasOwnProp(\"hello\", \"length\")) {\n *     console.log(\"hello\".length);\n *     // ➔ 5\n *   }\n *\n *   if (hasOwnProp(\"hello\", 1)) {\n *     console.log(\"hello\"[1]);\n *     // ➔ \"e\"\n *   }\n *   ```\n * - #### Functions:\n *   ```ts\n *   function fn() {}\n *   fn.extra = 123;\n *\n *   if (hasOwnProp(fn, \"extra\")) {\n *     console.log(fn.extra);\n *     // ➔ 123\n *   }\n *   ```\n * - #### Empty key:\n *   ```ts\n *   const obj = { a: 1 };\n *\n *   hasOwnProp(obj, \"\");\n *   // ➔ false (invalid key)\n *   hasOwnProp(obj, \"   \");\n *   // ➔ false (trimmed to empty)\n *   ```\n */\nexport function hasOwnProp<Obj>(\n  obj: IsAny<Obj> extends true ? Obj : never,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force `any` to `unknown` at result */\n): obj is unknown;\n\nexport function hasOwnProp<Obj extends null | undefined>(\n  obj: Obj,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n): false;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Key extends NestedKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is GuardedHasOwnProp<Obj, Key, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object,\n  Num extends NumericKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Num,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is NumericKeyHasOwnPropMapped<Obj, Num, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Sym extends symbol,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Sym,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is DeepRequiredSymbolHasOwnProp<Obj, Sym, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends string | null | undefined,\n  Key extends string | number\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is IsStringLiteral<SmartDetectStringHasOwnProp<Obj, Key>> extends true\n  ? AnyString | SmartDetectStringHasOwnProp<Obj, Key>\n  : SmartDetectStringHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown[] | AnyFunction,\n  Key extends PropertyKey\n>(\n  obj: Obj,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n): obj is SmartDetectArrayFuncHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown | AnyFunction,\n  Key extends PropertyKey,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj,\n  key:\n    | Key\n    | \"length\"\n    | (IsPlainObjectResult<Obj> extends never ? never : keyof Obj),\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is SmartDetectUnknownKeyHasOwnProp<\n  Obj,\n  Key,\n  DiscardUndefined,\n  DiscardNull\n>;\n\n// ------------------- IMPLEMENTATION -------------------\nexport function hasOwnProp(\n  obj: unknown,\n  key: PropertyKey,\n  options: HasOwnPropOptions<boolean, boolean> = {}\n): unknown {\n  if (!isString(obj) && !isObjectOrArray(obj) && !isFunction(obj)) return false;\n\n  if (!isPlainObject(options)) options = {};\n\n  // defaults: undef ➔ true, null ➔ false\n  const discardUndefined =\n    options.discardUndefined === undefined ? true : options.discardUndefined;\n  const discardNull =\n    options.discardNull === undefined ? false : options.discardNull;\n\n  assertIsBoolean(discardUndefined, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardUndefined\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  assertIsBoolean(discardNull, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardNull\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  // Parse key ➔ path\n  const path: (string | number | symbol)[] = [];\n  //todo: keep use manually check for length string value for avoid Maximum infinity loop function.!!!\n  if (\n    (isString(key) && key.trim().length > 0) ||\n    isNumber(key, { includeNaN: true })\n  ) {\n    const strKey = isNumber(key, { includeNaN: true }) ? String(key) : key;\n    strKey.split(\".\").forEach((k) => {\n      const bracketMatch = k.match(/^\\[(\\d+)\\]$/);\n      const symbolMatch = k.match(/^Symbol\\((.+)\\)$/);\n      if (bracketMatch) path.push(Number(bracketMatch[1]));\n      else if (symbolMatch) path.push(Symbol.for(symbolMatch[1]));\n      else if (!isNaN(Number(k))) path.push(Number(k));\n      else path.push(k);\n    });\n  } else if (isSymbol(key)) {\n    path.push(key);\n  } else {\n    return false;\n  }\n\n  // Traverse\n  let current: unknown =\n    isString(obj) && obj.trim().length > 0 ? Object(obj) : obj;\n  for (const k of path) {\n    if (\n      (isString(k) && k.trim().length > 0) ||\n      isNumber(k, { includeNaN: true })\n    ) {\n      if (\n        isNull(current) ||\n        !Object.prototype.hasOwnProperty.call(current, k)\n      ) {\n        return false;\n      }\n      current = (current as Record<PropertyKey, unknown>)[k];\n    } else if (isSymbol(k)) {\n      if (\n        isNull(current) ||\n        (typeof current !== \"object\" && !isFunction(current))\n      ) {\n        return false;\n      }\n      const symbols = Object.getOwnPropertySymbols(current);\n      const matched = symbols.find(\n        (s) => s === k || s.description === k.description\n      );\n      if (!matched) return false;\n      current = (current as Record<PropertyKey, unknown>)[matched];\n    } else {\n      return false;\n    }\n  }\n  // early fail for undefined if requested\n  if (discardUndefined && isUndefined(current)) return false;\n\n  // final null check (only if requested)\n  if (discardNull && isNull(current)) return false;\n\n  return true;\n}\n\n/**\n * @internal ***`Not part of the public API.`***\n */\nconst errorMsg = (msg: string) => createMessage(\"hasOwnProp\", msg);\n"],"mappings":";;;;;;;;;;;;;;;AAmRA,SAAgB,WACd,KACA,KACA,UAA+C,CAAC,GACvC;CACT,IAAI,CAACA,wBAAS,GAAG,KAAK,CAACC,+BAAgB,GAAG,KAAK,CAACC,0BAAW,GAAG,GAAG,OAAO;CAExE,IAAI,CAACC,6BAAc,OAAO,GAAG,UAAU,CAAC;CAGxC,MAAM,mBACJ,QAAQ,qBAAqB,SAAY,OAAO,QAAQ;CAC1D,MAAM,cACJ,QAAQ,gBAAgB,SAAY,QAAQ,QAAQ;CAEtD,+BAAgB,kBAAkB,EAChC,UAAU,EAAE,aAAa,gBACvB,SACE,kGAAkG,UAAU,sBAAsB,YAAY,IAChJ,EACJ,CAAC;CAED,+BAAgB,aAAa,EAC3B,UAAU,EAAE,aAAa,gBACvB,SACE,6FAA6F,UAAU,sBAAsB,YAAY,IAC3I,EACJ,CAAC;CAGD,MAAM,OAAqC,CAAC;CAE5C,IACGH,wBAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,KACtCI,0BAAS,KAAK,EAAE,YAAY,KAAK,CAAC,GAGlC,CADeA,0BAAS,KAAK,EAAE,YAAY,KAAK,CAAC,IAAI,OAAO,GAAG,IAAI,KAC5D,MAAM,GAAG,EAAE,SAAS,MAAM;EAC/B,MAAM,eAAe,EAAE,MAAM,aAAa;EAC1C,MAAM,cAAc,EAAE,MAAM,kBAAkB;EAC9C,IAAI,cAAc,KAAK,KAAK,OAAO,aAAa,EAAE,CAAC;OAC9C,IAAI,aAAa,KAAK,KAAK,OAAO,IAAI,YAAY,EAAE,CAAC;OACrD,IAAI,CAACC,qBAAM,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC;OAC1C,KAAK,KAAK,CAAC;CAClB,CAAC;MACI,IAAIC,qCAAS,GAAG,GACrB,KAAK,KAAK,GAAG;MAEb,OAAO;CAIT,IAAI,UACFN,wBAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,IAAI,OAAO,GAAG,IAAI;CACzD,KAAK,MAAM,KAAK,MACd,IACGA,wBAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,KAClCI,0BAAS,GAAG,EAAE,YAAY,KAAK,CAAC,GAChC;EACA,IACEG,sBAAO,OAAO,KACd,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,CAAC,GAEhD,OAAO;EAET,UAAW,QAAyC;CACtD,OAAO,IAAID,qCAAS,CAAC,GAAG;EACtB,IACEC,sBAAO,OAAO,KACb,OAAO,YAAY,YAAY,CAACL,0BAAW,OAAO,GAEnD,OAAO;EAGT,MAAM,UADU,OAAO,sBAAsB,OACvB,EAAE,MACrB,MAAM,MAAM,KAAK,EAAE,gBAAgB,EAAE,WACxC;EACA,IAAI,CAAC,SAAS,OAAO;EACrB,UAAW,QAAyC;CACtD,OACE,OAAO;CAIX,IAAI,oBAAoBM,wCAAY,OAAO,GAAG,OAAO;CAGrD,IAAI,eAAeD,sBAAO,OAAO,GAAG,OAAO;CAE3C,OAAO;AACT;;;;AAKA,MAAM,YAAY,QAAgBE,6BAAc,cAAc,GAAG"}
+{"version":3,"file":"hasOwnProp-DTWYqy7S.cjs","names":["isString","isObjectOrArray","isFunction","isPlainObject","isNumber","isNaN","isSymbol","isNull","isUndefined","createMessage"],"sources":["../src/predicates/has/hasOwnProp.ts"],"sourcesContent":["import type {\n  AnyFunction,\n  AnyString,\n  IsAny,\n  IsStringLiteral\n} from \"@rzl-zone/ts-types-plus\";\nimport type {\n  DeepRequiredSymbolHasOwnProp,\n  GuardedHasOwnProp,\n  HasOwnPropOptions,\n  NestedKeyOfHasOwnProp,\n  SmartDetectArrayFuncHasOwnProp,\n  SmartDetectUnknownKeyHasOwnProp,\n  NumericKeyHasOwnPropMapped,\n  NumericKeyOfHasOwnProp,\n  SmartDetectStringHasOwnProp\n} from \"./hasOwnProp.types\";\n\nimport { createMessage } from \"@/_private/logger\";\n\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\nimport { isNaN } from \"../is/isNaN\";\nimport { isNull } from \"../is/isNull\";\nimport { isString } from \"../is/isString\";\nimport { isNumber } from \"../is/isNumber\";\nimport { isSymbol } from \"../is/isSymbol\";\nimport { isFunction } from \"../is/isFunction\";\nimport { isUndefined } from \"../is/isUndefined\";\nimport { isObjectOrArray } from \"../is/isObjectOrArray\";\nimport { isPlainObject, type IsPlainObjectResult } from \"../is/isPlainObject\";\n\n// ------------------- HAS OWN PROP OVERLOADS -------------------\n\n/** -------------------------------------------------------\n * * ***Type guard: `hasOwnProp`.***\n * --------------------------------------------------------\n * **A **type-safe** replacement for `Object.prototype.hasOwnProperty` with runtime validation and **TypeScript-aware type narrowing**.**\n *\n * ---\n * - #### *Supported Targets:*\n *       - **Plain objects** ➔ `{ foo: \"bar\" }`.\n *       - **Arrays** ➔ `[ { id: 1 }, { id: 2 } ]`.\n *       - **Strings** ➔ `\"hello\"` (as array-like objects with `.length`, index, etc.).\n *       - **Functions** ➔ callable objects with extra props.\n *       - **Symbols** ➔ own property symbols.\n *       ---\n * - #### *Key Advantages over `in` or `obj.hasOwnProperty(key)`:*\n *       - Supports **dot/bracket path notation** (e.g. `\"user.address.city\"`, `\"addresses[0].zip\"`).\n *       - Handles **symbol** keys safely.\n *       - **Narrows** the type of `obj` in TypeScript (stronger type safety).\n *       - Configurable handling of **`undefined`** and **`null`**.\n *       ---\n * - #### *Runtime Behavior:*\n *       - #### Returns `true` if:\n *            - Value `obj` is an object/array/string/function **and** the property\n *              exists **and**, it passes the `options` checks.\n *            ---\n *       - #### Returns `false` if:\n *            - Value `obj` is not a valid type.\n *            - The property does not exist.\n *            - The value is `undefined` and `discardUndefined: true` (**default**).\n *            - The value is `null` and `discardNull: true`.\n *            - The `key` (after trimming) is an **empty string** ➔ treated as **invalid**.\n *       ---\n * - #### *TypeScript Behavior:*\n *       - #### Inside an `if (hasOwnProp(...)) {}` block:\n *            - The property is **guaranteed to exist**.\n *            - Depending on `options`, the property type is narrowed to exclude\n *              `undefined` and/or `null`.\n *       ---\n * - #### *Caveats:*\n *       - #### Empty keys are invalid:\n *            - If the `key` string is empty (`\"\"`) after trimming whitespace or other characters,\n *              it will **not** be considered a valid property and always returns `false`.\n *            ---\n *       - #### Arrays are limited by TypeScript inference:\n *            - Checking index `[0]` only narrows **that specific index**, not the rest, example:\n *               1. `hasOwnProp(users, \"[0].id\")` does **not** imply `users[1].id` exists.\n *                   - For different indices, use **optional chaining** (`users[1]?.id`).\n *            ---\n *       - #### Autocomplete limitation for array indices:\n *            - Autocompletion for `[index]` is only supported up to **5** (`[0]` ➔ `[4]`).\n *            - This limit is intentional for **performance and safety:**\n *               1. Generating infinite union types for all possible indices would cause\n *                 **TypeScript IntelliSense to hang or crash**.\n *                   - You can still check higher indices manually (e.g. `\"[999].id\"`),\n *                     but they will not show up in IntelliSense suggestions.\n *\n * ---\n * @param {HasOwnPropOptions} [options] - ***Optional configuration object.***\n * @param {HasOwnPropOptions[\"discardUndefined\"]} [options.discardUndefined=true]\n *  ***If `true`, properties with `undefined` values are treated as **missing**, default: `true`.***\n * @param {HasOwnPropOptions[\"discardNull\"]} [options.discardNull=false]\n *  ***If `true`, properties with `null` values are treated as **missing**, default: `false`.***\n * @param {*} obj ***The `object`, `array`, `string`, `function`, or `other value` to check against.***\n * @param {PropertyKey} key\n *  ***The property key to check, can be:***\n *    - `string` (supports dot/bracket paths, e.g. `\"user.address.city\"`, `\"[0].id\"`).\n *    - `number` (array-like index).\n *    - `symbol` (own property symbols).\n *\n * ---\n * @returns {boolean} Return `true` if the property exists (and passes `options`), otherwise `false`.\n *\n * ---\n * @example\n *\n * - #### Objects:\n *   ```ts\n *   const obj: { name?: string | null } = {};\n *\n *   if (hasOwnProp(obj, \"name\")) {\n *     // obj is now ➔ { name: string | null }\n *     console.log(obj.name); // string | null\n *   }\n *\n *   if (hasOwnProp(obj, \"name\", { discardUndefined: true, discardNull: true })) {\n *     // obj is now ➔ { name: string }\n *     console.log(obj.name.toUpperCase()); // safe\n *   }\n *   ```\n * - #### Arrays:\n *   ```ts\n *   const users = [{ id: 1 }, { id: 2 }];\n *\n *   if (hasOwnProp(users, \"[1].id\")) {\n *     // ➔ users[1].id is guaranteed to exist\n *     console.log(users[1].id); // number\n *   }\n *\n *   // Caveat: narrowing only applies to checked index\n *   if (hasOwnProp(users, \"[0].id\")) {\n *     console.log(users[0].id); // safe\n *     console.log(users[1].id); // not guaranteed!\n *   }\n *\n *   // Solution: optional chaining\n *   console.log(users[1]?.id);\n *   // ➔ safe, even without narrowing\n *   ```\n *\n * - #### Symbols:\n *   ```ts\n *   const secret = Symbol(\"secret\");\n *   const obj2 = { [secret]: 42 };\n *\n *   if (hasOwnProp(obj2, secret)) {\n *     console.log(obj2[secret] + 1);\n *     // ➔ 43\n *   }\n *   ```\n * - #### Strings:\n *   ```ts\n *   if (hasOwnProp(\"hello\", \"length\")) {\n *     console.log(\"hello\".length);\n *     // ➔ 5\n *   }\n *\n *   if (hasOwnProp(\"hello\", 1)) {\n *     console.log(\"hello\"[1]);\n *     // ➔ \"e\"\n *   }\n *   ```\n * - #### Functions:\n *   ```ts\n *   function fn() {}\n *   fn.extra = 123;\n *\n *   if (hasOwnProp(fn, \"extra\")) {\n *     console.log(fn.extra);\n *     // ➔ 123\n *   }\n *   ```\n * - #### Empty key:\n *   ```ts\n *   const obj = { a: 1 };\n *\n *   hasOwnProp(obj, \"\");\n *   // ➔ false (invalid key)\n *   hasOwnProp(obj, \"   \");\n *   // ➔ false (trimmed to empty)\n *   ```\n */\nexport function hasOwnProp<Obj>(\n  obj: IsAny<Obj> extends true ? Obj : never,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force `any` to `unknown` at result */\n): obj is unknown;\n\nexport function hasOwnProp<Obj extends null | undefined>(\n  obj: Obj,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n): false;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Key extends NestedKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is GuardedHasOwnProp<Obj, Key, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object,\n  Num extends NumericKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Num,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is NumericKeyHasOwnPropMapped<Obj, Num, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Sym extends symbol,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Sym,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is DeepRequiredSymbolHasOwnProp<Obj, Sym, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends string | null | undefined,\n  Key extends string | number\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is IsStringLiteral<SmartDetectStringHasOwnProp<Obj, Key>> extends true\n  ? AnyString | SmartDetectStringHasOwnProp<Obj, Key>\n  : SmartDetectStringHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown[] | AnyFunction,\n  Key extends PropertyKey\n>(\n  obj: Obj,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n): obj is SmartDetectArrayFuncHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown | AnyFunction,\n  Key extends PropertyKey,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj,\n  key:\n    | Key\n    | \"length\"\n    | (IsPlainObjectResult<Obj> extends never ? never : keyof Obj),\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is SmartDetectUnknownKeyHasOwnProp<\n  Obj,\n  Key,\n  DiscardUndefined,\n  DiscardNull\n>;\n\n// ------------------- IMPLEMENTATION -------------------\nexport function hasOwnProp(\n  obj: unknown,\n  key: PropertyKey,\n  options: HasOwnPropOptions<boolean, boolean> = {}\n): unknown {\n  if (!isString(obj) && !isObjectOrArray(obj) && !isFunction(obj)) return false;\n\n  if (!isPlainObject(options)) options = {};\n\n  // defaults: undef ➔ true, null ➔ false\n  const discardUndefined =\n    options.discardUndefined === undefined ? true : options.discardUndefined;\n  const discardNull =\n    options.discardNull === undefined ? false : options.discardNull;\n\n  assertIsBoolean(discardUndefined, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardUndefined\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  assertIsBoolean(discardNull, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardNull\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  // Parse key ➔ path\n  const path: (string | number | symbol)[] = [];\n  //todo: keep use manually check for length string value for avoid Maximum infinity loop function.!!!\n  if (\n    (isString(key) && key.trim().length > 0) ||\n    isNumber(key, { includeNaN: true })\n  ) {\n    const strKey = isNumber(key, { includeNaN: true }) ? String(key) : key;\n    strKey.split(\".\").forEach((k) => {\n      const bracketMatch = k.match(/^\\[(\\d+)\\]$/);\n      const symbolMatch = k.match(/^Symbol\\((.+)\\)$/);\n      if (bracketMatch) path.push(Number(bracketMatch[1]));\n      else if (symbolMatch) path.push(Symbol.for(symbolMatch[1]));\n      else if (!isNaN(Number(k))) path.push(Number(k));\n      else path.push(k);\n    });\n  } else if (isSymbol(key)) {\n    path.push(key);\n  } else {\n    return false;\n  }\n\n  // Traverse\n  let current: unknown =\n    isString(obj) && obj.trim().length > 0 ? Object(obj) : obj;\n  for (const k of path) {\n    if (\n      (isString(k) && k.trim().length > 0) ||\n      isNumber(k, { includeNaN: true })\n    ) {\n      if (\n        isNull(current) ||\n        !Object.prototype.hasOwnProperty.call(current, k)\n      ) {\n        return false;\n      }\n      current = (current as Record<PropertyKey, unknown>)[k];\n    } else if (isSymbol(k)) {\n      if (\n        isNull(current) ||\n        (typeof current !== \"object\" && !isFunction(current))\n      ) {\n        return false;\n      }\n      const symbols = Object.getOwnPropertySymbols(current);\n      const matched = symbols.find(\n        (s) => s === k || s.description === k.description\n      );\n      if (!matched) return false;\n      current = (current as Record<PropertyKey, unknown>)[matched];\n    } else {\n      return false;\n    }\n  }\n  // early fail for undefined if requested\n  if (discardUndefined && isUndefined(current)) return false;\n\n  // final null check (only if requested)\n  if (discardNull && isNull(current)) return false;\n\n  return true;\n}\n\n/**\n * @internal ***`Not part of the public API.`***\n */\nconst errorMsg = (msg: string) => createMessage(\"hasOwnProp\", msg);\n"],"mappings":";;;;;;;;;;;;;;;AAmRA,SAAgB,WACd,KACA,KACA,UAA+C,CAAC,GACvC;CACT,IAAI,CAACA,wBAAS,GAAG,KAAK,CAACC,+BAAgB,GAAG,KAAK,CAACC,0BAAW,GAAG,GAAG,OAAO;CAExE,IAAI,CAACC,6BAAc,OAAO,GAAG,UAAU,CAAC;CAGxC,MAAM,mBACJ,QAAQ,qBAAqB,SAAY,OAAO,QAAQ;CAC1D,MAAM,cACJ,QAAQ,gBAAgB,SAAY,QAAQ,QAAQ;CAEtD,+BAAgB,kBAAkB,EAChC,UAAU,EAAE,aAAa,gBACvB,SACE,kGAAkG,UAAU,sBAAsB,YAAY,IAChJ,EACJ,CAAC;CAED,+BAAgB,aAAa,EAC3B,UAAU,EAAE,aAAa,gBACvB,SACE,6FAA6F,UAAU,sBAAsB,YAAY,IAC3I,EACJ,CAAC;CAGD,MAAM,OAAqC,CAAC;CAE5C,IACGH,wBAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,KACtCI,0BAAS,KAAK,EAAE,YAAY,KAAK,CAAC,GAGlC,CADeA,0BAAS,KAAK,EAAE,YAAY,KAAK,CAAC,IAAI,OAAO,GAAG,IAAI,KAC5D,MAAM,GAAG,EAAE,SAAS,MAAM;EAC/B,MAAM,eAAe,EAAE,MAAM,aAAa;EAC1C,MAAM,cAAc,EAAE,MAAM,kBAAkB;EAC9C,IAAI,cAAc,KAAK,KAAK,OAAO,aAAa,EAAE,CAAC;OAC9C,IAAI,aAAa,KAAK,KAAK,OAAO,IAAI,YAAY,EAAE,CAAC;OACrD,IAAI,CAACC,qBAAM,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC;OAC1C,KAAK,KAAK,CAAC;CAClB,CAAC;MACI,IAAIC,qCAAS,GAAG,GACrB,KAAK,KAAK,GAAG;MAEb,OAAO;CAIT,IAAI,UACFN,wBAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,IAAI,OAAO,GAAG,IAAI;CACzD,KAAK,MAAM,KAAK,MACd,IACGA,wBAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,KAClCI,0BAAS,GAAG,EAAE,YAAY,KAAK,CAAC,GAChC;EACA,IACEG,sBAAO,OAAO,KACd,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,CAAC,GAEhD,OAAO;EAET,UAAW,QAAyC;CACtD,OAAO,IAAID,qCAAS,CAAC,GAAG;EACtB,IACEC,sBAAO,OAAO,KACb,OAAO,YAAY,YAAY,CAACL,0BAAW,OAAO,GAEnD,OAAO;EAGT,MAAM,UADU,OAAO,sBAAsB,OACvB,EAAE,MACrB,MAAM,MAAM,KAAK,EAAE,gBAAgB,EAAE,WACxC;EACA,IAAI,CAAC,SAAS,OAAO;EACrB,UAAW,QAAyC;CACtD,OACE,OAAO;CAIX,IAAI,oBAAoBM,wCAAY,OAAO,GAAG,OAAO;CAGrD,IAAI,eAAeD,sBAAO,OAAO,GAAG,OAAO;CAE3C,OAAO;AACT;;;;AAKA,MAAM,YAAY,QAAgBE,6BAAc,cAAc,GAAG"}

package/dist/{hasOwnProp-CVIhlD1i.js → hasOwnProp-yVVsxPin.js}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 isFunction, E as isPlainObject, S as isNaN, T as isString, g as isObjectOrArray, n as assertIsBoolean, t as createMessage, x as isNull } from "./logger-CLWnKRKE.js";
-import { t as isNumber } from "./isNumber-BCWD4dW0.js";
-import { n as isSymbol, r as isUndefined } from "./safeStableStringify-DfwxmiWn.js";
+import { A as isFunction, E as isPlainObject, S as isNaN, T as isString, g as isObjectOrArray, n as assertIsBoolean, t as createMessage, x as isNull } from "./logger-Wxl_Krg6.js";
+import { t as isNumber } from "./isNumber-C1mOuBuA.js";
+import { n as isSymbol, r as isUndefined } from "./safeStableStringify-CDSYnLUz.js";
 function hasOwnProp(obj, key, options = {}) {
 	if (!isString(obj) && !isObjectOrArray(obj) && !isFunction(obj)) return false;
 	if (!isPlainObject(options)) options = {};
@@ -44,4 +44,4 @@ function hasOwnProp(obj, key, options = {}) {
 }
 const errorMsg = (msg) => createMessage("hasOwnProp", msg);
 export { hasOwnProp as t };
-//# sourceMappingURL=hasOwnProp-CVIhlD1i.js.map
+//# sourceMappingURL=hasOwnProp-yVVsxPin.js.map

package/dist/{hasOwnProp-CVIhlD1i.js.map → hasOwnProp-yVVsxPin.js.map}

@@ -1 +1 @@
-{"version":3,"file":"hasOwnProp-CVIhlD1i.js","names":[],"sources":["../src/predicates/has/hasOwnProp.ts"],"sourcesContent":["import type {\n  AnyFunction,\n  AnyString,\n  IsAny,\n  IsStringLiteral\n} from \"@rzl-zone/ts-types-plus\";\nimport type {\n  DeepRequiredSymbolHasOwnProp,\n  GuardedHasOwnProp,\n  HasOwnPropOptions,\n  NestedKeyOfHasOwnProp,\n  SmartDetectArrayFuncHasOwnProp,\n  SmartDetectUnknownKeyHasOwnProp,\n  NumericKeyHasOwnPropMapped,\n  NumericKeyOfHasOwnProp,\n  SmartDetectStringHasOwnProp\n} from \"./hasOwnProp.types\";\n\nimport { createMessage } from \"@/_private/logger\";\n\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\nimport { isNaN } from \"../is/isNaN\";\nimport { isNull } from \"../is/isNull\";\nimport { isString } from \"../is/isString\";\nimport { isNumber } from \"../is/isNumber\";\nimport { isSymbol } from \"../is/isSymbol\";\nimport { isFunction } from \"../is/isFunction\";\nimport { isUndefined } from \"../is/isUndefined\";\nimport { isObjectOrArray } from \"../is/isObjectOrArray\";\nimport { isPlainObject, type IsPlainObjectResult } from \"../is/isPlainObject\";\n\n// ------------------- HAS OWN PROP OVERLOADS -------------------\n\n/** -------------------------------------------------------\n * * ***Type guard: `hasOwnProp`.***\n * --------------------------------------------------------\n * **A **type-safe** replacement for `Object.prototype.hasOwnProperty` with runtime validation and **TypeScript-aware type narrowing**.**\n *\n * ---\n * - #### *Supported Targets:*\n *       - **Plain objects** ➔ `{ foo: \"bar\" }`.\n *       - **Arrays** ➔ `[ { id: 1 }, { id: 2 } ]`.\n *       - **Strings** ➔ `\"hello\"` (as array-like objects with `.length`, index, etc.).\n *       - **Functions** ➔ callable objects with extra props.\n *       - **Symbols** ➔ own property symbols.\n *       ---\n * - #### *Key Advantages over `in` or `obj.hasOwnProperty(key)`:*\n *       - Supports **dot/bracket path notation** (e.g. `\"user.address.city\"`, `\"addresses[0].zip\"`).\n *       - Handles **symbol** keys safely.\n *       - **Narrows** the type of `obj` in TypeScript (stronger type safety).\n *       - Configurable handling of **`undefined`** and **`null`**.\n *       ---\n * - #### *Runtime Behavior:*\n *       - #### Returns `true` if:\n *            - Value `obj` is an object/array/string/function **and** the property\n *              exists **and**, it passes the `options` checks.\n *            ---\n *       - #### Returns `false` if:\n *            - Value `obj` is not a valid type.\n *            - The property does not exist.\n *            - The value is `undefined` and `discardUndefined: true` (**default**).\n *            - The value is `null` and `discardNull: true`.\n *            - The `key` (after trimming) is an **empty string** ➔ treated as **invalid**.\n *       ---\n * - #### *TypeScript Behavior:*\n *       - #### Inside an `if (hasOwnProp(...)) {}` block:\n *            - The property is **guaranteed to exist**.\n *            - Depending on `options`, the property type is narrowed to exclude\n *              `undefined` and/or `null`.\n *       ---\n * - #### *Caveats:*\n *       - #### Empty keys are invalid:\n *            - If the `key` string is empty (`\"\"`) after trimming whitespace or other characters,\n *              it will **not** be considered a valid property and always returns `false`.\n *            ---\n *       - #### Arrays are limited by TypeScript inference:\n *            - Checking index `[0]` only narrows **that specific index**, not the rest, example:\n *               1. `hasOwnProp(users, \"[0].id\")` does **not** imply `users[1].id` exists.\n *                   - For different indices, use **optional chaining** (`users[1]?.id`).\n *            ---\n *       - #### Autocomplete limitation for array indices:\n *            - Autocompletion for `[index]` is only supported up to **5** (`[0]` ➔ `[4]`).\n *            - This limit is intentional for **performance and safety:**\n *               1. Generating infinite union types for all possible indices would cause\n *                 **TypeScript IntelliSense to hang or crash**.\n *                   - You can still check higher indices manually (e.g. `\"[999].id\"`),\n *                     but they will not show up in IntelliSense suggestions.\n *\n * ---\n * @param {HasOwnPropOptions} [options] - ***Optional configuration object.***\n * @param {HasOwnPropOptions[\"discardUndefined\"]} [options.discardUndefined=true]\n *  ***If `true`, properties with `undefined` values are treated as **missing**, default: `true`.***\n * @param {HasOwnPropOptions[\"discardNull\"]} [options.discardNull=false]\n *  ***If `true`, properties with `null` values are treated as **missing**, default: `false`.***\n * @param {*} obj ***The `object`, `array`, `string`, `function`, or `other value` to check against.***\n * @param {PropertyKey} key\n *  ***The property key to check, can be:***\n *    - `string` (supports dot/bracket paths, e.g. `\"user.address.city\"`, `\"[0].id\"`).\n *    - `number` (array-like index).\n *    - `symbol` (own property symbols).\n *\n * ---\n * @returns {boolean} Return `true` if the property exists (and passes `options`), otherwise `false`.\n *\n * ---\n * @example\n *\n * - #### Objects:\n *   ```ts\n *   const obj: { name?: string | null } = {};\n *\n *   if (hasOwnProp(obj, \"name\")) {\n *     // obj is now ➔ { name: string | null }\n *     console.log(obj.name); // string | null\n *   }\n *\n *   if (hasOwnProp(obj, \"name\", { discardUndefined: true, discardNull: true })) {\n *     // obj is now ➔ { name: string }\n *     console.log(obj.name.toUpperCase()); // safe\n *   }\n *   ```\n * - #### Arrays:\n *   ```ts\n *   const users = [{ id: 1 }, { id: 2 }];\n *\n *   if (hasOwnProp(users, \"[1].id\")) {\n *     // ➔ users[1].id is guaranteed to exist\n *     console.log(users[1].id); // number\n *   }\n *\n *   // Caveat: narrowing only applies to checked index\n *   if (hasOwnProp(users, \"[0].id\")) {\n *     console.log(users[0].id); // safe\n *     console.log(users[1].id); // not guaranteed!\n *   }\n *\n *   // Solution: optional chaining\n *   console.log(users[1]?.id);\n *   // ➔ safe, even without narrowing\n *   ```\n *\n * - #### Symbols:\n *   ```ts\n *   const secret = Symbol(\"secret\");\n *   const obj2 = { [secret]: 42 };\n *\n *   if (hasOwnProp(obj2, secret)) {\n *     console.log(obj2[secret] + 1);\n *     // ➔ 43\n *   }\n *   ```\n * - #### Strings:\n *   ```ts\n *   if (hasOwnProp(\"hello\", \"length\")) {\n *     console.log(\"hello\".length);\n *     // ➔ 5\n *   }\n *\n *   if (hasOwnProp(\"hello\", 1)) {\n *     console.log(\"hello\"[1]);\n *     // ➔ \"e\"\n *   }\n *   ```\n * - #### Functions:\n *   ```ts\n *   function fn() {}\n *   fn.extra = 123;\n *\n *   if (hasOwnProp(fn, \"extra\")) {\n *     console.log(fn.extra);\n *     // ➔ 123\n *   }\n *   ```\n * - #### Empty key:\n *   ```ts\n *   const obj = { a: 1 };\n *\n *   hasOwnProp(obj, \"\");\n *   // ➔ false (invalid key)\n *   hasOwnProp(obj, \"   \");\n *   // ➔ false (trimmed to empty)\n *   ```\n */\nexport function hasOwnProp<Obj>(\n  obj: IsAny<Obj> extends true ? Obj : never,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force `any` to `unknown` at result */\n): obj is unknown;\n\nexport function hasOwnProp<Obj extends null | undefined>(\n  obj: Obj,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n): false;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Key extends NestedKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is GuardedHasOwnProp<Obj, Key, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object,\n  Num extends NumericKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Num,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is NumericKeyHasOwnPropMapped<Obj, Num, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Sym extends symbol,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Sym,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is DeepRequiredSymbolHasOwnProp<Obj, Sym, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends string | null | undefined,\n  Key extends string | number\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is IsStringLiteral<SmartDetectStringHasOwnProp<Obj, Key>> extends true\n  ? AnyString | SmartDetectStringHasOwnProp<Obj, Key>\n  : SmartDetectStringHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown[] | AnyFunction,\n  Key extends PropertyKey\n>(\n  obj: Obj,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n): obj is SmartDetectArrayFuncHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown | AnyFunction,\n  Key extends PropertyKey,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj,\n  key:\n    | Key\n    | \"length\"\n    | (IsPlainObjectResult<Obj> extends never ? never : keyof Obj),\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is SmartDetectUnknownKeyHasOwnProp<\n  Obj,\n  Key,\n  DiscardUndefined,\n  DiscardNull\n>;\n\n// ------------------- IMPLEMENTATION -------------------\nexport function hasOwnProp(\n  obj: unknown,\n  key: PropertyKey,\n  options: HasOwnPropOptions<boolean, boolean> = {}\n): unknown {\n  if (!isString(obj) && !isObjectOrArray(obj) && !isFunction(obj)) return false;\n\n  if (!isPlainObject(options)) options = {};\n\n  // defaults: undef ➔ true, null ➔ false\n  const discardUndefined =\n    options.discardUndefined === undefined ? true : options.discardUndefined;\n  const discardNull =\n    options.discardNull === undefined ? false : options.discardNull;\n\n  assertIsBoolean(discardUndefined, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardUndefined\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  assertIsBoolean(discardNull, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardNull\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  // Parse key ➔ path\n  const path: (string | number | symbol)[] = [];\n  //todo: keep use manually check for length string value for avoid Maximum infinity loop function.!!!\n  if (\n    (isString(key) && key.trim().length > 0) ||\n    isNumber(key, { includeNaN: true })\n  ) {\n    const strKey = isNumber(key, { includeNaN: true }) ? String(key) : key;\n    strKey.split(\".\").forEach((k) => {\n      const bracketMatch = k.match(/^\\[(\\d+)\\]$/);\n      const symbolMatch = k.match(/^Symbol\\((.+)\\)$/);\n      if (bracketMatch) path.push(Number(bracketMatch[1]));\n      else if (symbolMatch) path.push(Symbol.for(symbolMatch[1]));\n      else if (!isNaN(Number(k))) path.push(Number(k));\n      else path.push(k);\n    });\n  } else if (isSymbol(key)) {\n    path.push(key);\n  } else {\n    return false;\n  }\n\n  // Traverse\n  let current: unknown =\n    isString(obj) && obj.trim().length > 0 ? Object(obj) : obj;\n  for (const k of path) {\n    if (\n      (isString(k) && k.trim().length > 0) ||\n      isNumber(k, { includeNaN: true })\n    ) {\n      if (\n        isNull(current) ||\n        !Object.prototype.hasOwnProperty.call(current, k)\n      ) {\n        return false;\n      }\n      current = (current as Record<PropertyKey, unknown>)[k];\n    } else if (isSymbol(k)) {\n      if (\n        isNull(current) ||\n        (typeof current !== \"object\" && !isFunction(current))\n      ) {\n        return false;\n      }\n      const symbols = Object.getOwnPropertySymbols(current);\n      const matched = symbols.find(\n        (s) => s === k || s.description === k.description\n      );\n      if (!matched) return false;\n      current = (current as Record<PropertyKey, unknown>)[matched];\n    } else {\n      return false;\n    }\n  }\n  // early fail for undefined if requested\n  if (discardUndefined && isUndefined(current)) return false;\n\n  // final null check (only if requested)\n  if (discardNull && isNull(current)) return false;\n\n  return true;\n}\n\n/**\n * @internal ***`Not part of the public API.`***\n */\nconst errorMsg = (msg: string) => createMessage(\"hasOwnProp\", msg);\n"],"mappings":";;;;;;;;;;;;;;;AAmRA,SAAgB,WACd,KACA,KACA,UAA+C,CAAC,GACvC;CACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,WAAW,GAAG,GAAG,OAAO;CAExE,IAAI,CAAC,cAAc,OAAO,GAAG,UAAU,CAAC;CAGxC,MAAM,mBACJ,QAAQ,qBAAqB,SAAY,OAAO,QAAQ;CAC1D,MAAM,cACJ,QAAQ,gBAAgB,SAAY,QAAQ,QAAQ;CAEtD,gBAAgB,kBAAkB,EAChC,UAAU,EAAE,aAAa,gBACvB,SACE,kGAAkG,UAAU,sBAAsB,YAAY,IAChJ,EACJ,CAAC;CAED,gBAAgB,aAAa,EAC3B,UAAU,EAAE,aAAa,gBACvB,SACE,6FAA6F,UAAU,sBAAsB,YAAY,IAC3I,EACJ,CAAC;CAGD,MAAM,OAAqC,CAAC;CAE5C,IACG,SAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,KACtC,SAAS,KAAK,EAAE,YAAY,KAAK,CAAC,GAGlC,CADe,SAAS,KAAK,EAAE,YAAY,KAAK,CAAC,IAAI,OAAO,GAAG,IAAI,KAC5D,MAAM,GAAG,EAAE,SAAS,MAAM;EAC/B,MAAM,eAAe,EAAE,MAAM,aAAa;EAC1C,MAAM,cAAc,EAAE,MAAM,kBAAkB;EAC9C,IAAI,cAAc,KAAK,KAAK,OAAO,aAAa,EAAE,CAAC;OAC9C,IAAI,aAAa,KAAK,KAAK,OAAO,IAAI,YAAY,EAAE,CAAC;OACrD,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC;OAC1C,KAAK,KAAK,CAAC;CAClB,CAAC;MACI,IAAI,SAAS,GAAG,GACrB,KAAK,KAAK,GAAG;MAEb,OAAO;CAIT,IAAI,UACF,SAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,IAAI,OAAO,GAAG,IAAI;CACzD,KAAK,MAAM,KAAK,MACd,IACG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,KAClC,SAAS,GAAG,EAAE,YAAY,KAAK,CAAC,GAChC;EACA,IACE,OAAO,OAAO,KACd,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,CAAC,GAEhD,OAAO;EAET,UAAW,QAAyC;CACtD,OAAO,IAAI,SAAS,CAAC,GAAG;EACtB,IACE,OAAO,OAAO,KACb,OAAO,YAAY,YAAY,CAAC,WAAW,OAAO,GAEnD,OAAO;EAGT,MAAM,UADU,OAAO,sBAAsB,OACvB,EAAE,MACrB,MAAM,MAAM,KAAK,EAAE,gBAAgB,EAAE,WACxC;EACA,IAAI,CAAC,SAAS,OAAO;EACrB,UAAW,QAAyC;CACtD,OACE,OAAO;CAIX,IAAI,oBAAoB,YAAY,OAAO,GAAG,OAAO;CAGrD,IAAI,eAAe,OAAO,OAAO,GAAG,OAAO;CAE3C,OAAO;AACT;;;;AAKA,MAAM,YAAY,QAAgB,cAAc,cAAc,GAAG"}
+{"version":3,"file":"hasOwnProp-yVVsxPin.js","names":[],"sources":["../src/predicates/has/hasOwnProp.ts"],"sourcesContent":["import type {\n  AnyFunction,\n  AnyString,\n  IsAny,\n  IsStringLiteral\n} from \"@rzl-zone/ts-types-plus\";\nimport type {\n  DeepRequiredSymbolHasOwnProp,\n  GuardedHasOwnProp,\n  HasOwnPropOptions,\n  NestedKeyOfHasOwnProp,\n  SmartDetectArrayFuncHasOwnProp,\n  SmartDetectUnknownKeyHasOwnProp,\n  NumericKeyHasOwnPropMapped,\n  NumericKeyOfHasOwnProp,\n  SmartDetectStringHasOwnProp\n} from \"./hasOwnProp.types\";\n\nimport { createMessage } from \"@/_private/logger\";\n\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\nimport { isNaN } from \"../is/isNaN\";\nimport { isNull } from \"../is/isNull\";\nimport { isString } from \"../is/isString\";\nimport { isNumber } from \"../is/isNumber\";\nimport { isSymbol } from \"../is/isSymbol\";\nimport { isFunction } from \"../is/isFunction\";\nimport { isUndefined } from \"../is/isUndefined\";\nimport { isObjectOrArray } from \"../is/isObjectOrArray\";\nimport { isPlainObject, type IsPlainObjectResult } from \"../is/isPlainObject\";\n\n// ------------------- HAS OWN PROP OVERLOADS -------------------\n\n/** -------------------------------------------------------\n * * ***Type guard: `hasOwnProp`.***\n * --------------------------------------------------------\n * **A **type-safe** replacement for `Object.prototype.hasOwnProperty` with runtime validation and **TypeScript-aware type narrowing**.**\n *\n * ---\n * - #### *Supported Targets:*\n *       - **Plain objects** ➔ `{ foo: \"bar\" }`.\n *       - **Arrays** ➔ `[ { id: 1 }, { id: 2 } ]`.\n *       - **Strings** ➔ `\"hello\"` (as array-like objects with `.length`, index, etc.).\n *       - **Functions** ➔ callable objects with extra props.\n *       - **Symbols** ➔ own property symbols.\n *       ---\n * - #### *Key Advantages over `in` or `obj.hasOwnProperty(key)`:*\n *       - Supports **dot/bracket path notation** (e.g. `\"user.address.city\"`, `\"addresses[0].zip\"`).\n *       - Handles **symbol** keys safely.\n *       - **Narrows** the type of `obj` in TypeScript (stronger type safety).\n *       - Configurable handling of **`undefined`** and **`null`**.\n *       ---\n * - #### *Runtime Behavior:*\n *       - #### Returns `true` if:\n *            - Value `obj` is an object/array/string/function **and** the property\n *              exists **and**, it passes the `options` checks.\n *            ---\n *       - #### Returns `false` if:\n *            - Value `obj` is not a valid type.\n *            - The property does not exist.\n *            - The value is `undefined` and `discardUndefined: true` (**default**).\n *            - The value is `null` and `discardNull: true`.\n *            - The `key` (after trimming) is an **empty string** ➔ treated as **invalid**.\n *       ---\n * - #### *TypeScript Behavior:*\n *       - #### Inside an `if (hasOwnProp(...)) {}` block:\n *            - The property is **guaranteed to exist**.\n *            - Depending on `options`, the property type is narrowed to exclude\n *              `undefined` and/or `null`.\n *       ---\n * - #### *Caveats:*\n *       - #### Empty keys are invalid:\n *            - If the `key` string is empty (`\"\"`) after trimming whitespace or other characters,\n *              it will **not** be considered a valid property and always returns `false`.\n *            ---\n *       - #### Arrays are limited by TypeScript inference:\n *            - Checking index `[0]` only narrows **that specific index**, not the rest, example:\n *               1. `hasOwnProp(users, \"[0].id\")` does **not** imply `users[1].id` exists.\n *                   - For different indices, use **optional chaining** (`users[1]?.id`).\n *            ---\n *       - #### Autocomplete limitation for array indices:\n *            - Autocompletion for `[index]` is only supported up to **5** (`[0]` ➔ `[4]`).\n *            - This limit is intentional for **performance and safety:**\n *               1. Generating infinite union types for all possible indices would cause\n *                 **TypeScript IntelliSense to hang or crash**.\n *                   - You can still check higher indices manually (e.g. `\"[999].id\"`),\n *                     but they will not show up in IntelliSense suggestions.\n *\n * ---\n * @param {HasOwnPropOptions} [options] - ***Optional configuration object.***\n * @param {HasOwnPropOptions[\"discardUndefined\"]} [options.discardUndefined=true]\n *  ***If `true`, properties with `undefined` values are treated as **missing**, default: `true`.***\n * @param {HasOwnPropOptions[\"discardNull\"]} [options.discardNull=false]\n *  ***If `true`, properties with `null` values are treated as **missing**, default: `false`.***\n * @param {*} obj ***The `object`, `array`, `string`, `function`, or `other value` to check against.***\n * @param {PropertyKey} key\n *  ***The property key to check, can be:***\n *    - `string` (supports dot/bracket paths, e.g. `\"user.address.city\"`, `\"[0].id\"`).\n *    - `number` (array-like index).\n *    - `symbol` (own property symbols).\n *\n * ---\n * @returns {boolean} Return `true` if the property exists (and passes `options`), otherwise `false`.\n *\n * ---\n * @example\n *\n * - #### Objects:\n *   ```ts\n *   const obj: { name?: string | null } = {};\n *\n *   if (hasOwnProp(obj, \"name\")) {\n *     // obj is now ➔ { name: string | null }\n *     console.log(obj.name); // string | null\n *   }\n *\n *   if (hasOwnProp(obj, \"name\", { discardUndefined: true, discardNull: true })) {\n *     // obj is now ➔ { name: string }\n *     console.log(obj.name.toUpperCase()); // safe\n *   }\n *   ```\n * - #### Arrays:\n *   ```ts\n *   const users = [{ id: 1 }, { id: 2 }];\n *\n *   if (hasOwnProp(users, \"[1].id\")) {\n *     // ➔ users[1].id is guaranteed to exist\n *     console.log(users[1].id); // number\n *   }\n *\n *   // Caveat: narrowing only applies to checked index\n *   if (hasOwnProp(users, \"[0].id\")) {\n *     console.log(users[0].id); // safe\n *     console.log(users[1].id); // not guaranteed!\n *   }\n *\n *   // Solution: optional chaining\n *   console.log(users[1]?.id);\n *   // ➔ safe, even without narrowing\n *   ```\n *\n * - #### Symbols:\n *   ```ts\n *   const secret = Symbol(\"secret\");\n *   const obj2 = { [secret]: 42 };\n *\n *   if (hasOwnProp(obj2, secret)) {\n *     console.log(obj2[secret] + 1);\n *     // ➔ 43\n *   }\n *   ```\n * - #### Strings:\n *   ```ts\n *   if (hasOwnProp(\"hello\", \"length\")) {\n *     console.log(\"hello\".length);\n *     // ➔ 5\n *   }\n *\n *   if (hasOwnProp(\"hello\", 1)) {\n *     console.log(\"hello\"[1]);\n *     // ➔ \"e\"\n *   }\n *   ```\n * - #### Functions:\n *   ```ts\n *   function fn() {}\n *   fn.extra = 123;\n *\n *   if (hasOwnProp(fn, \"extra\")) {\n *     console.log(fn.extra);\n *     // ➔ 123\n *   }\n *   ```\n * - #### Empty key:\n *   ```ts\n *   const obj = { a: 1 };\n *\n *   hasOwnProp(obj, \"\");\n *   // ➔ false (invalid key)\n *   hasOwnProp(obj, \"   \");\n *   // ➔ false (trimmed to empty)\n *   ```\n */\nexport function hasOwnProp<Obj>(\n  obj: IsAny<Obj> extends true ? Obj : never,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force `any` to `unknown` at result */\n): obj is unknown;\n\nexport function hasOwnProp<Obj extends null | undefined>(\n  obj: Obj,\n  key: PropertyKey,\n  options?: HasOwnPropOptions<boolean, boolean>\n): false;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Key extends NestedKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is GuardedHasOwnProp<Obj, Key, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object,\n  Num extends NumericKeyOfHasOwnProp<Obj>,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Num,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is NumericKeyHasOwnPropMapped<Obj, Num, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends object | AnyFunction,\n  Sym extends symbol,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj | null | undefined,\n  key: Sym,\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is DeepRequiredSymbolHasOwnProp<Obj, Sym, DiscardUndefined, DiscardNull>;\n\nexport function hasOwnProp<\n  Obj extends string | null | undefined,\n  Key extends string | number\n>(\n  obj: Obj | null | undefined,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is IsStringLiteral<SmartDetectStringHasOwnProp<Obj, Key>> extends true\n  ? AnyString | SmartDetectStringHasOwnProp<Obj, Key>\n  : SmartDetectStringHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown[] | AnyFunction,\n  Key extends PropertyKey\n>(\n  obj: Obj,\n  key: Key,\n  options?: HasOwnPropOptions<boolean, boolean>\n): obj is SmartDetectArrayFuncHasOwnProp<Obj, Key>;\n\nexport function hasOwnProp<\n  Obj extends unknown | AnyFunction,\n  Key extends PropertyKey,\n  DiscardUndefined extends boolean = true,\n  DiscardNull extends boolean = false\n>(\n  obj: Obj,\n  key:\n    | Key\n    | \"length\"\n    | (IsPlainObjectResult<Obj> extends never ? never : keyof Obj),\n  options?: HasOwnPropOptions<DiscardUndefined, DiscardNull>\n  /** @ts-expect-error we force to override recursive type result */\n): obj is SmartDetectUnknownKeyHasOwnProp<\n  Obj,\n  Key,\n  DiscardUndefined,\n  DiscardNull\n>;\n\n// ------------------- IMPLEMENTATION -------------------\nexport function hasOwnProp(\n  obj: unknown,\n  key: PropertyKey,\n  options: HasOwnPropOptions<boolean, boolean> = {}\n): unknown {\n  if (!isString(obj) && !isObjectOrArray(obj) && !isFunction(obj)) return false;\n\n  if (!isPlainObject(options)) options = {};\n\n  // defaults: undef ➔ true, null ➔ false\n  const discardUndefined =\n    options.discardUndefined === undefined ? true : options.discardUndefined;\n  const discardNull =\n    options.discardNull === undefined ? false : options.discardNull;\n\n  assertIsBoolean(discardUndefined, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardUndefined\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  assertIsBoolean(discardNull, {\n    message: ({ currentType, validType }) =>\n      errorMsg(\n        `Parameter \\`discardNull\\` property of the \\`options\\` (third parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n      )\n  });\n\n  // Parse key ➔ path\n  const path: (string | number | symbol)[] = [];\n  //todo: keep use manually check for length string value for avoid Maximum infinity loop function.!!!\n  if (\n    (isString(key) && key.trim().length > 0) ||\n    isNumber(key, { includeNaN: true })\n  ) {\n    const strKey = isNumber(key, { includeNaN: true }) ? String(key) : key;\n    strKey.split(\".\").forEach((k) => {\n      const bracketMatch = k.match(/^\\[(\\d+)\\]$/);\n      const symbolMatch = k.match(/^Symbol\\((.+)\\)$/);\n      if (bracketMatch) path.push(Number(bracketMatch[1]));\n      else if (symbolMatch) path.push(Symbol.for(symbolMatch[1]));\n      else if (!isNaN(Number(k))) path.push(Number(k));\n      else path.push(k);\n    });\n  } else if (isSymbol(key)) {\n    path.push(key);\n  } else {\n    return false;\n  }\n\n  // Traverse\n  let current: unknown =\n    isString(obj) && obj.trim().length > 0 ? Object(obj) : obj;\n  for (const k of path) {\n    if (\n      (isString(k) && k.trim().length > 0) ||\n      isNumber(k, { includeNaN: true })\n    ) {\n      if (\n        isNull(current) ||\n        !Object.prototype.hasOwnProperty.call(current, k)\n      ) {\n        return false;\n      }\n      current = (current as Record<PropertyKey, unknown>)[k];\n    } else if (isSymbol(k)) {\n      if (\n        isNull(current) ||\n        (typeof current !== \"object\" && !isFunction(current))\n      ) {\n        return false;\n      }\n      const symbols = Object.getOwnPropertySymbols(current);\n      const matched = symbols.find(\n        (s) => s === k || s.description === k.description\n      );\n      if (!matched) return false;\n      current = (current as Record<PropertyKey, unknown>)[matched];\n    } else {\n      return false;\n    }\n  }\n  // early fail for undefined if requested\n  if (discardUndefined && isUndefined(current)) return false;\n\n  // final null check (only if requested)\n  if (discardNull && isNull(current)) return false;\n\n  return true;\n}\n\n/**\n * @internal ***`Not part of the public API.`***\n */\nconst errorMsg = (msg: string) => createMessage(\"hasOwnProp\", msg);\n"],"mappings":";;;;;;;;;;;;;;;AAmRA,SAAgB,WACd,KACA,KACA,UAA+C,CAAC,GACvC;CACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,WAAW,GAAG,GAAG,OAAO;CAExE,IAAI,CAAC,cAAc,OAAO,GAAG,UAAU,CAAC;CAGxC,MAAM,mBACJ,QAAQ,qBAAqB,SAAY,OAAO,QAAQ;CAC1D,MAAM,cACJ,QAAQ,gBAAgB,SAAY,QAAQ,QAAQ;CAEtD,gBAAgB,kBAAkB,EAChC,UAAU,EAAE,aAAa,gBACvB,SACE,kGAAkG,UAAU,sBAAsB,YAAY,IAChJ,EACJ,CAAC;CAED,gBAAgB,aAAa,EAC3B,UAAU,EAAE,aAAa,gBACvB,SACE,6FAA6F,UAAU,sBAAsB,YAAY,IAC3I,EACJ,CAAC;CAGD,MAAM,OAAqC,CAAC;CAE5C,IACG,SAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,KACtC,SAAS,KAAK,EAAE,YAAY,KAAK,CAAC,GAGlC,CADe,SAAS,KAAK,EAAE,YAAY,KAAK,CAAC,IAAI,OAAO,GAAG,IAAI,KAC5D,MAAM,GAAG,EAAE,SAAS,MAAM;EAC/B,MAAM,eAAe,EAAE,MAAM,aAAa;EAC1C,MAAM,cAAc,EAAE,MAAM,kBAAkB;EAC9C,IAAI,cAAc,KAAK,KAAK,OAAO,aAAa,EAAE,CAAC;OAC9C,IAAI,aAAa,KAAK,KAAK,OAAO,IAAI,YAAY,EAAE,CAAC;OACrD,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC;OAC1C,KAAK,KAAK,CAAC;CAClB,CAAC;MACI,IAAI,SAAS,GAAG,GACrB,KAAK,KAAK,GAAG;MAEb,OAAO;CAIT,IAAI,UACF,SAAS,GAAG,KAAK,IAAI,KAAK,EAAE,SAAS,IAAI,OAAO,GAAG,IAAI;CACzD,KAAK,MAAM,KAAK,MACd,IACG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,KAClC,SAAS,GAAG,EAAE,YAAY,KAAK,CAAC,GAChC;EACA,IACE,OAAO,OAAO,KACd,CAAC,OAAO,UAAU,eAAe,KAAK,SAAS,CAAC,GAEhD,OAAO;EAET,UAAW,QAAyC;CACtD,OAAO,IAAI,SAAS,CAAC,GAAG;EACtB,IACE,OAAO,OAAO,KACb,OAAO,YAAY,YAAY,CAAC,WAAW,OAAO,GAEnD,OAAO;EAGT,MAAM,UADU,OAAO,sBAAsB,OACvB,EAAE,MACrB,MAAM,MAAM,KAAK,EAAE,gBAAgB,EAAE,WACxC;EACA,IAAI,CAAC,SAAS,OAAO;EACrB,UAAW,QAAyC;CACtD,OACE,OAAO;CAIX,IAAI,oBAAoB,YAAY,OAAO,GAAG,OAAO;CAGrD,IAAI,eAAe,OAAO,OAAO,GAAG,OAAO;CAE3C,OAAO;AACT;;;;AAKA,MAAM,YAAY,QAAgB,cAAc,cAAc,GAAG"}

package/dist/{index-BVovC-yK.d.cts → index-9Ql1W3gt.d.cts}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { M as PickStrict, N as Prettify } from "./index-DZHiYYR7.cjs";
-import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-CAe_ElKO.cjs";
+import { M as PickStrict, N as Prettify } from "./index-or0oP9i2.cjs";
+import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-Y__iykWN.cjs";
 /** -----------------------------------------------------------------------------
 * * ***Shape of the object passed to custom error message functions.***
 * ------------------------------------------------------------------------------

package/dist/{index-9JsU_wMu.d.ts → index-BD0J8wkE.d.cts}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 OverrideTypes, N as Prettify, O as OmitStrict, c as ExtractStrict, i as AnyString } from "./index-DZHiYYR7.js";
-import { FormatOptions, Locale } from "date-fns";
+import { A as OverrideTypes, N as Prettify, O as OmitStrict, c as ExtractStrict, i as AnyString } from "./index-or0oP9i2.cjs";
 import { CountryCode, NumberFormat } from "libphonenumber-js";
+import { FormatOptions, Locale } from "date-fns";
 type NegativeFormatOptionCustom = {
   /**
   * * ***Custom formatter function for the final formatted negative string, if provided, it ***OVERRIDES*** style & space entirely.***

package/dist/{index-CjpbuJF4.d.ts → index-BcoUy2oV.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { D as NumberRangeUnion, E as Nullish, L as TypedArray, N as Prettify, P as RemoveEmptyArrayElements, R as WebApiObjects, b as KeepNull, f as IfNotExtends, k as OrArr, l as FixNeverArrayRecursive, m as IsAny, n as AndArr, p as IntlObjects, r as AnyFunction, s as Extends, u as IfExtends, w as NormalizeEmptyArraysRecursive, x as KeepUndef } from "./index-DZHiYYR7.js";
+import { D as NumberRangeUnion, E as Nullish, L as TypedArray, N as Prettify, P as RemoveEmptyArrayElements, R as WebApiObjects, b as KeepNull, f as IfNotExtends, k as OrArr, l as FixNeverArrayRecursive, m as IsAny, n as AndArr, p as IntlObjects, r as AnyFunction, s as Extends, u as IfExtends, w as NormalizeEmptyArraysRecursive, x as KeepUndef } from "./index-or0oP9i2.js";
 type NormalizeInputToNumberArrayUnRecursive<T> = T extends string | bigint | boolean | number | Nullish ? T : HasNonNumberLikeNonNullish<T>;
 /** Detects whether `T` contains any number-like type (`string | number | bigint`).
 *

package/dist/{index-hOqBIL7F.d.ts → index-Bpk3YwGW.d.ts}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { D as NumberRangeUnion, I as Trim, L as TypedArray, N as Prettify, _ as IsNever, a as CharAt, g as IsEmptyString, h as IsArray, i as AnyString, j as ParseNumber, k as OrArr, m as IsAny, r as AnyFunction, s as Extends, t as AnObjectNonArray, v as IsPositive, y as IsStringLiteral } from "./index-DZHiYYR7.js";
-import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-CJvRG4Je.js";
+import { D as NumberRangeUnion, I as Trim, L as TypedArray, N as Prettify, _ as IsNever, a as CharAt, g as IsEmptyString, h as IsArray, i as AnyString, j as ParseNumber, k as OrArr, m as IsAny, r as AnyFunction, s as Extends, t as AnObjectNonArray, v as IsPositive, y as IsStringLiteral } from "./index-or0oP9i2.js";
+import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-DQoM4DGQ.js";
 /** ----------------------------------------------------------
 * * ***Predicate: `areArraysEqual`.***
 * -----------------------------------------------------------

package/dist/{index-Dm4a___O.d.ts → index-CTMG8cZV.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { S as Nilable, s as Extends } from "./index-DZHiYYR7.js";
+import { S as Nilable, s as Extends } from "./index-or0oP9i2.js";
 type CapitalizeFirstOptions = {
   /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.
   *

package/dist/{index-C1X6ha9s.d.cts → index-DUBCXPy4.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { S as Nilable, s as Extends } from "./index-DZHiYYR7.cjs";
+import { S as Nilable, s as Extends } from "./index-or0oP9i2.cjs";
 type CapitalizeFirstOptions = {
   /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.
   *

package/dist/{index-Dwduk7ez.d.cts → index-DhUTzQ_o.d.ts}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 OverrideTypes, N as Prettify, O as OmitStrict, c as ExtractStrict, i as AnyString } from "./index-DZHiYYR7.cjs";
-import { CountryCode, NumberFormat } from "libphonenumber-js";
+import { A as OverrideTypes, N as Prettify, O as OmitStrict, c as ExtractStrict, i as AnyString } from "./index-or0oP9i2.js";
 import { FormatOptions, Locale } from "date-fns";
+import { CountryCode, NumberFormat } from "libphonenumber-js";
 type NegativeFormatOptionCustom = {
   /**
   * * ***Custom formatter function for the final formatted negative string, if provided, it ***OVERRIDES*** style & space entirely.***

package/dist/{index-jyuOZMX7.d.ts → index-DqYMKSmd.d.ts}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { M as PickStrict, N as Prettify } from "./index-DZHiYYR7.js";
-import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-CJvRG4Je.js";
+import { M as PickStrict, N as Prettify } from "./index-or0oP9i2.js";
+import { a as IsNumberOptions, c as GetPreciseTypeOptions, i as ArrayFallback, t as IsPlainObjectResult } from "./isPlainObject-DQoM4DGQ.js";
 /** -----------------------------------------------------------------------------
 * * ***Shape of the object passed to custom error message functions.***
 * ------------------------------------------------------------------------------

package/dist/{index-DlyDmXUo.d.ts → index-JfwSupYB.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { F as Stringify } from "./index-DZHiYYR7.js";
+import { F as Stringify } from "./index-or0oP9i2.js";
 import { ClassNameValue, ConfigExtension } from "tailwind-merge-v2";
 import { ClassNameValue as ClassNameValue$1, ConfigExtension as ConfigExtension$1 } from "tailwind-merge-v3";
 import { Config } from "tailwindcss";

package/dist/{index-BP3sUrAx.d.ts → index-O2q2f-pu.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 NullToUndefined, d as IfNonEmptyArray, l as FixNeverArrayRecursive, s as Extends } from "./index-DZHiYYR7.js";
+import { T as NullToUndefined, d as IfNonEmptyArray, l as FixNeverArrayRecursive, s as Extends } from "./index-or0oP9i2.cjs";
 /** -------------------------------------------------------------------------------------
 * * ***Utility: `getRandomItem`.***
 * --------------------------------------------------------------------------------------

package/dist/{index-I5V6RbZM.d.cts → index-VgNZ6ndx.d.cts}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { D as NumberRangeUnion, I as Trim, L as TypedArray, N as Prettify, _ as IsNever, a as CharAt, g as IsEmptyString, h as IsArray, i as AnyString, j as ParseNumber, k as OrArr, m as IsAny, r as AnyFunction, s as Extends, t as AnObjectNonArray, v as IsPositive, y as IsStringLiteral } from "./index-DZHiYYR7.cjs";
-import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-CAe_ElKO.cjs";
+import { D as NumberRangeUnion, I as Trim, L as TypedArray, N as Prettify, _ as IsNever, a as CharAt, g as IsEmptyString, h as IsArray, i as AnyString, j as ParseNumber, k as OrArr, m as IsAny, r as AnyFunction, s as Extends, t as AnObjectNonArray, v as IsPositive, y as IsStringLiteral } from "./index-or0oP9i2.cjs";
+import { i as ArrayFallback, r as IsHasKeysObject, t as IsPlainObjectResult } from "./isPlainObject-Y__iykWN.cjs";
 /** ----------------------------------------------------------
 * * ***Predicate: `areArraysEqual`.***
 * -----------------------------------------------------------

package/dist/{index-lI0b7iUz.d.cts → index-k_rjVRjU.d.ts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  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 NullToUndefined, d as IfNonEmptyArray, l as FixNeverArrayRecursive, s as Extends } from "./index-DZHiYYR7.cjs";
+import { T as NullToUndefined, d as IfNonEmptyArray, l as FixNeverArrayRecursive, s as Extends } from "./index-or0oP9i2.js";
 /** -------------------------------------------------------------------------------------
 * * ***Utility: `getRandomItem`.***
 * --------------------------------------------------------------------------------------

package/dist/{index-DZHiYYR7.d.ts → index-or0oP9i2.d.cts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -11,7 +11,7 @@
 * ========================================================================
 *  @rzl-zone/ts-types-plus
 * ------------------------------------------------------------------------
-*  Version: `0.1.8-beta.0`
+*  Version: `0.1.8`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/ts-types-plus`
 * ========================================================================

package/dist/{index-DZHiYYR7.d.cts → index-or0oP9i2.d.ts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -11,7 +11,7 @@
 * ========================================================================
 *  @rzl-zone/ts-types-plus
 * ------------------------------------------------------------------------
-*  Version: `0.1.8-beta.0`
+*  Version: `0.1.8`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/ts-types-plus`
 * ========================================================================

package/dist/{index-CcPQZ41G.d.cts → index-u4-Euidh.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { F as Stringify } from "./index-DZHiYYR7.cjs";
+import { F as Stringify } from "./index-or0oP9i2.cjs";
 import { Config } from "tailwindcss";
 import { ClassNameValue, ConfigExtension } from "tailwind-merge-v2";
 import { ClassNameValue as ClassNameValue$1, ConfigExtension as ConfigExtension$1 } from "tailwind-merge-v3";

package/dist/{index-CssrQyHh.d.cts → index-zAqCZxGr.d.cts}

@@ -2,13 +2,13 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { D as NumberRangeUnion, E as Nullish, L as TypedArray, N as Prettify, P as RemoveEmptyArrayElements, R as WebApiObjects, b as KeepNull, f as IfNotExtends, k as OrArr, l as FixNeverArrayRecursive, m as IsAny, n as AndArr, p as IntlObjects, r as AnyFunction, s as Extends, u as IfExtends, w as NormalizeEmptyArraysRecursive, x as KeepUndef } from "./index-DZHiYYR7.cjs";
+import { D as NumberRangeUnion, E as Nullish, L as TypedArray, N as Prettify, P as RemoveEmptyArrayElements, R as WebApiObjects, b as KeepNull, f as IfNotExtends, k as OrArr, l as FixNeverArrayRecursive, m as IsAny, n as AndArr, p as IntlObjects, r as AnyFunction, s as Extends, u as IfExtends, w as NormalizeEmptyArraysRecursive, x as KeepUndef } from "./index-or0oP9i2.cjs";
 type NormalizeInputToNumberArrayUnRecursive<T> = T extends string | bigint | boolean | number | Nullish ? T : HasNonNumberLikeNonNullish<T>;
 /** Detects whether `T` contains any number-like type (`string | number | bigint`).
 *

package/dist/{isBigInt-Cez32M69.js → isBigInt-DdFRCpeE.js}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -11,4 +11,4 @@ const isBigInt = (value) => {
 	return typeof value === "bigint";
 };
 export { isBigInt as t };
-//# sourceMappingURL=isBigInt-Cez32M69.js.map
+//# sourceMappingURL=isBigInt-DdFRCpeE.js.map

package/dist/{isBigInt-Cez32M69.js.map → isBigInt-DdFRCpeE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"isBigInt-Cez32M69.js","names":[],"sources":["../src/predicates/is/isBigInt.ts"],"sourcesContent":["/** ----------------------------------------------------------\n * * ***Type guard: `isBigInt`.***\n * -----------------------------------------------------------\n * **Checks if a value is of type **[`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)**.**\n *\n * ---\n * - **Behavior:**\n *     - Uses `typeof value === \"bigint\"` for strict type checking.\n *     - Supports TypeScript type narrowing with `value is bigint`.\n *     - Returns `false` for `BigInt` object (object-wrapped), e.g:\n *       - `Object(BigInt(123))`.\n *\n * ---\n * @param {*} value - The value to check.\n *\n * ---\n * @returns {boolean} Return `true` if value is a primitive bigint.\n *\n * ---\n * @example\n * isBigInt(123n);\n * // ➔ true\n * isBigInt(BigInt(123));\n * // ➔ true\n * isBigInt(\"123\");\n * // ➔ false\n * isBigInt(Object(BigInt(1)));\n * // ➔ false\n */\nexport const isBigInt = (value: unknown): value is bigint => {\n  return typeof value === \"bigint\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY,UAAoC;CAC3D,OAAO,OAAO,UAAU;AAC1B"}
+{"version":3,"file":"isBigInt-DdFRCpeE.js","names":[],"sources":["../src/predicates/is/isBigInt.ts"],"sourcesContent":["/** ----------------------------------------------------------\n * * ***Type guard: `isBigInt`.***\n * -----------------------------------------------------------\n * **Checks if a value is of type **[`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)**.**\n *\n * ---\n * - **Behavior:**\n *     - Uses `typeof value === \"bigint\"` for strict type checking.\n *     - Supports TypeScript type narrowing with `value is bigint`.\n *     - Returns `false` for `BigInt` object (object-wrapped), e.g:\n *       - `Object(BigInt(123))`.\n *\n * ---\n * @param {*} value - The value to check.\n *\n * ---\n * @returns {boolean} Return `true` if value is a primitive bigint.\n *\n * ---\n * @example\n * isBigInt(123n);\n * // ➔ true\n * isBigInt(BigInt(123));\n * // ➔ true\n * isBigInt(\"123\");\n * // ➔ false\n * isBigInt(Object(BigInt(1)));\n * // ➔ false\n */\nexport const isBigInt = (value: unknown): value is bigint => {\n  return typeof value === \"bigint\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY,UAAoC;CAC3D,OAAO,OAAO,UAAU;AAC1B"}

package/dist/{isBigInt-YgpNKTbA.cjs → isBigInt-LkCpVJ3E.cjs}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.14.0-beta.0`
+*  Version: `3.14.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -17,4 +17,4 @@ Object.defineProperty(exports, 'isBigInt', {
     return isBigInt;
   }
 });
-//# sourceMappingURL=isBigInt-YgpNKTbA.cjs.map
+//# sourceMappingURL=isBigInt-LkCpVJ3E.cjs.map

package/dist/{isBigInt-YgpNKTbA.cjs.map → isBigInt-LkCpVJ3E.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"isBigInt-YgpNKTbA.cjs","names":[],"sources":["../src/predicates/is/isBigInt.ts"],"sourcesContent":["/** ----------------------------------------------------------\n * * ***Type guard: `isBigInt`.***\n * -----------------------------------------------------------\n * **Checks if a value is of type **[`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)**.**\n *\n * ---\n * - **Behavior:**\n *     - Uses `typeof value === \"bigint\"` for strict type checking.\n *     - Supports TypeScript type narrowing with `value is bigint`.\n *     - Returns `false` for `BigInt` object (object-wrapped), e.g:\n *       - `Object(BigInt(123))`.\n *\n * ---\n * @param {*} value - The value to check.\n *\n * ---\n * @returns {boolean} Return `true` if value is a primitive bigint.\n *\n * ---\n * @example\n * isBigInt(123n);\n * // ➔ true\n * isBigInt(BigInt(123));\n * // ➔ true\n * isBigInt(\"123\");\n * // ➔ false\n * isBigInt(Object(BigInt(1)));\n * // ➔ false\n */\nexport const isBigInt = (value: unknown): value is bigint => {\n  return typeof value === \"bigint\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY,UAAoC;CAC3D,OAAO,OAAO,UAAU;AAC1B"}
+{"version":3,"file":"isBigInt-LkCpVJ3E.cjs","names":[],"sources":["../src/predicates/is/isBigInt.ts"],"sourcesContent":["/** ----------------------------------------------------------\n * * ***Type guard: `isBigInt`.***\n * -----------------------------------------------------------\n * **Checks if a value is of type **[`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)**.**\n *\n * ---\n * - **Behavior:**\n *     - Uses `typeof value === \"bigint\"` for strict type checking.\n *     - Supports TypeScript type narrowing with `value is bigint`.\n *     - Returns `false` for `BigInt` object (object-wrapped), e.g:\n *       - `Object(BigInt(123))`.\n *\n * ---\n * @param {*} value - The value to check.\n *\n * ---\n * @returns {boolean} Return `true` if value is a primitive bigint.\n *\n * ---\n * @example\n * isBigInt(123n);\n * // ➔ true\n * isBigInt(BigInt(123));\n * // ➔ true\n * isBigInt(\"123\");\n * // ➔ false\n * isBigInt(Object(BigInt(1)));\n * // ➔ false\n */\nexport const isBigInt = (value: unknown): value is bigint => {\n  return typeof value === \"bigint\";\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,YAAY,UAAoC;CAC3D,OAAO,OAAO,UAAU;AAC1B"}