@rzl-zone/utils-js 3.12.1-beta.0 → 3.12.1-beta.1

package/dist/strings/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["isNonEmptyString","isPlainObject","isNonEmptyString","isPlainObject","isString","isEmptyString","isNonEmptyString","isNumber","isString","getPreciseType"],"sources":["../../src/strings/capitalizations/capitalizeFirst.ts","../../src/strings/capitalizations/capitalizeWords.ts","../../src/strings/sanitizations/stripHtmlTags.ts","../../src/strings/utils/getInitialsName.ts","../../src/strings/utils/replaceAt.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeFirstOptions = {\n  /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.\n   *\n   * @default true\n   */\n  lowerCaseNextRest?: boolean;\n  /** If true, the string will trimmed, default: `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeFirst`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of a string, with optionally lowercases the rest and trims whitespace.**\n * @param {string | null | undefined} string - The string to be processed.\n * @param {CapitalizeFirstOptions} [options] - Options to control behavior.\n * @param {CapitalizeFirstOptions[\"lowerCaseNextRest\"]} [options.lowerCaseNextRest=true] - If true, lowercases the rest (next first letter), default: `true`.\n * @param {CapitalizeFirstOptions[\"trim\"]} [options.trim=false] - If true, trims the string before processing, default: `false`.\n * @returns {string} The processed string, returns `\"\"` if input is `null`, `undefined`, or `not a valid string`.\n * @example\n * ```ts\n * capitalizeFirst(\" hello WORLD \");\n * // ➔ \" Hello world\"\n * capitalizeFirst(\" hello WORLD \", { trim: true });\n * // ➔ \"Hello world\"\n * capitalizeFirst(\"FOO\", { lowerCaseNextRest: false });\n * // ➔ \"FOO\"\n * capitalizeFirst(\"   foo BAR   \", { trim: true, lowerCaseNextRest: false });\n * // ➔ \"Foo BAR\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return `\"\"`.\n * ```ts\n * capitalizeFirst(123);\n * capitalizeFirst(null);\n * capitalizeFirst(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeFirst = (\n  string: string | null | undefined,\n  options: CapitalizeFirstOptions = {\n    lowerCaseNextRest: true,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(string)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const lowerCaseNextRest = options.lowerCaseNextRest !== false;\n  const trim = options.trim === true;\n\n  if (trim) string = string.trim();\n\n  return (\n    string[0].toUpperCase() +\n    (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1))\n  );\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeWordsOptions = {\n  /** If `true`, removes leading and trailing spaces, default `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n  /** If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), default `false`.\n   *\n   * @default false\n   */\n  collapseSpaces?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeWords`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of each word in a string while converting the rest to lowercase.**\n * @param {string | null | undefined} value\n *  ***The input string to be processed.***\n *   - If `null` or `undefined`, returns an empty-string (`\"\"`).\n * @param {CapitalizeWordsOptions} [options]\n *  ***Optional settings to control the output:***\n *   - `trim`: If `true`, removes leading and trailing spaces, defaultValue: `false`.\n *   - `collapseSpaces`: If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), defaultValue: `false`.\n * @returns {string} A new string where each word starts with an uppercase letter\n * and the remaining letters are lowercase.\n *  - If `value` is `empty`, `null`, or `undefined`, returns an `empty-string`.\n * @example\n * ```ts\n * capitalizeWords(\"  hello   world  \");\n * // ➔ \"  Hello   World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true });\n * // ➔ \"Hello   World\"\n * capitalizeWords(\"  hello   world  \", { collapseSpaces: true });\n * // ➔ \"  Hello World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true, collapseSpaces: true });\n * // ➔ \"Hello World\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return \"\".\n * ```ts\n * capitalizeWords(123);\n * capitalizeWords(null);\n * capitalizeWords(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeWords = (\n  value: string | null | undefined,\n  options: CapitalizeWordsOptions = {\n    collapseSpaces: false,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  let result = value;\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const collapseSpaces = options.collapseSpaces === true;\n  const trim = options.trim === true;\n\n  if (trim) {\n    result = result.trim();\n  }\n\n  if (collapseSpaces) {\n    const leadingSpaces = result.match(/^\\s*/)?.[0] ?? \"\";\n    const trailingSpaces = result.match(/\\s*$/)?.[0] ?? \"\";\n    result = result.trim().replace(/\\s+/g, \" \");\n    result = `${leadingSpaces}${result}${trailingSpaces}`;\n  }\n\n  return result\n    .toLowerCase()\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n};\n","import type { Extends } from \"@rzl-zone/ts-types-plus\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `stripHtmlTags`.***\n * ----------------------------------------------------------\n * **This function removes valid HTML tags (including nested and self-closing ones)\n * by replacing them with spaces, then collapses multiple whitespaces into a single space.**\n * - **It handles the following cases:**\n *    - If the input is not a string (`null`, `undefined`, or any non-string), it is returned as undefined.\n *    - If the input is an empty or whitespace-only string, it returns an empty string (`\"\"`).\n *    - Otherwise, it returns the cleaned string with tags removed and normalized whitespace.\n * @template T - Input string type (string | null | undefined).\n * @param {string | null | undefined} input - A string potentially containing HTML tags.\n * @returns {string | undefined} Cleaned string if input is string, or original input otherwise.\n * @example\n * stripHtmlTags(\"<p>Hello</p>\");\n * // ➔ \"Hello\"\n * stripHtmlTags(\"<div><b>Bold</b> text</div>\");\n * // ➔ \"Bold text\"\n * stripHtmlTags(\"Line<br/>Break\");\n * // ➔ \"Line Break\"\n * stripHtmlTags(\"2 < 5 and 5 > 2\");\n * // ➔ \"2 < 5 and 5 > 2\"\n * stripHtmlTags(\"\");\n * // ➔ \"\"\n * stripHtmlTags(\"   \");\n * // ➔ \"\"\n * stripHtmlTags(null);\n * // ➔ undefined\n * stripHtmlTags(undefined);\n * // ➔ undefined\n */\nexport function stripHtmlTags(input: string): string;\nexport function stripHtmlTags<T>(\n  input: T\n): Extends<string, T> extends true ? string | undefined : undefined;\nexport function stripHtmlTags(input: unknown) {\n  if (!isString(input)) {\n    return undefined;\n  }\n\n  if (isEmptyString(input)) {\n    return \"\";\n  }\n\n  // return input.replace(/<[^>]*>/g, \"\");\n  const stripped = input.replace(/<\\/?[a-zA-Z][^<>]*\\/?>/g, \" \").trim();\n\n  const cleaned = stripped.replace(/\\s+/g, \" \").trim();\n\n  return cleaned;\n}\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `getInitialsName`.***\n * ----------------------------------------------------------\n * **Extracts initials from the given name string.**\n * - **Behavior:**\n *    - For names with two or more words, returns the first letter of the first and second words.\n *    - For a single word with 2+ characters, returns the first two letters.\n *    - For a single character, returns that character.\n *    - For `empty`, `null`, `undefined` or `whitespace-only input`, returns an empty string (`\"\"`).\n * @param {string | null | undefined} name - The name to extract initials from.\n * @returns {string} The extracted initials (e.g., \"JD\" for \"John Doe\").\n * @example\n * getInitialsName(\"Alice\");             // ➔ \"AL\"\n * getInitialsName(\"John Doe\");          // ➔ \"JD\"\n * getInitialsName(\" Bob Marley \");      // ➔ \"BM\"\n * getInitialsName(\"John Ronald Donal\"); // ➔ \"JR\"\n * getInitialsName(\"Lord John Doe Moe\"); // ➔ \"LJ\"\n * getInitialsName(\"X\");                 // ➔ \"X\"\n * getInitialsName(\"\");                  // ➔ \"\" (empty string)\n * getInitialsName(\"  \");                // ➔ \"\" (empty string)\n * getInitialsName(null);                // ➔ \"\" (null input)\n * getInitialsName(undefined);           // ➔ \"\" (undefined input)\n */\nexport const getInitialsName = (name: string | null | undefined): string => {\n  if (!isNonEmptyString(name)) return \"\"; // Handle empty string case\n\n  // Trim spaces and remove duplicate spaces\n  name = name.replace(/\\s+/g, \" \").trim();\n\n  const nameParts = name.split(\" \");\n\n  if (nameParts.length > 1) {\n    // First letter of first and second words\n    return nameParts[0][0] + nameParts[1][0].toUpperCase();\n  }\n\n  return name.length > 1\n    ? name.substring(0, 2).toUpperCase()\n    : // First two letters for single-word names\n      name[0].toUpperCase();\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\n/** ----------------------------------------------------------\n *  * ***Utility: `replaceAt`.***\n * ----------------------------------------------------------\n * **Replaces exactly one character at the specified index in the original string\n * with the provided `replaceTo` string.**\n * - **Behavior:**\n *    - If `replaceTo` has more than one character,\n * the result will expand accordingly.\n * @param {number} index - The starting index where the replacement should occur.\n * @param {string} originalString - The original string to modify.\n * @param {string} replaceTo - The string to insert at the specified index.\n * @returns {string} The modified string with the replacement applied.\n * @example\n * replaceAt(3, \"hello\", \"X\");\n * // ➔ \"helXo\"\n * replaceAt(1, \"world\", \"AB\");\n * // ➔ \"wABrld\"\n * replaceAt(0, \"cat\", \"br\");\n * // ➔ \"brat\"\n * replaceAt(2, \"12345\", \"-\");\n * // ➔ \"12-45\"\n * replaceAt(4, \"ABCDE\", \"Z\");\n * // ➔ \"ABCDZ\"\n * // ❌ Examples that throw:\n * replaceAt(10, \"short\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(-1, \"test\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(\"1\", \"test\", \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n * replaceAt(2, null, \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n */\nexport const replaceAt = (\n  index: number,\n  originalString: string,\n  replaceTo: string\n): string => {\n  if (!isNumber(index) || !isString(replaceTo) || !isString(originalString)) {\n    throw new TypeError(\n      `First parameter (\\`index\\`) must be of type \\`number\\`, second parameter (\\`originalString\\`) and third parameter (\\`replaceTo\\`) must be of type \\`string\\`, but received: \"['index': \\`${getPreciseType(\n        index\n      )}\\`, 'originalString': \\`${getPreciseType(\n        originalString\n      )}\\`, 'replaceTo': \\`${getPreciseType(replaceTo)}\\`]\".`\n    );\n  }\n\n  // Handle edge cases\n  if (index < 0 || index >= originalString.length) {\n    throw new RangeError(\n      \"First parameter (`index`) is out of range from second parameter (`originalString`).\"\n    );\n  }\n\n  return (\n    originalString.slice(0, index) + // Extract before the index\n    replaceTo + // Insert replacement\n    originalString.slice(index + 1) // Extract after replacement\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,UAAkC;CAChC,mBAAmB;CACnB,MAAM;CACP,KACU;CACX,IAAI,CAACA,yCAAiB,OAAO,EAAE,OAAO;CAEtC,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,oBAAoB,QAAQ,sBAAsB;CAGxD,IAFa,QAAQ,SAAS,MAEpB,SAAS,OAAO,MAAM;CAEhC,OACE,OAAO,GAAG,aAAa,IACtB,oBAAoB,OAAO,MAAM,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfxE,MAAa,mBACX,OACA,UAAkC;CAChC,gBAAgB;CAChB,MAAM;CACP,KACU;CACX,IAAI,CAACC,yCAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,SAAS;CAEb,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,iBAAiB,QAAQ,mBAAmB;CAGlD,IAFa,QAAQ,SAAS,MAG5B,SAAS,OAAO,MAAM;CAGxB,IAAI,gBAAgB;EAClB,MAAM,gBAAgB,OAAO,MAAM,OAAO,GAAG,MAAM;EACnD,MAAM,iBAAiB,OAAO,MAAM,OAAO,GAAG,MAAM;EACpD,SAAS,OAAO,MAAM,CAAC,QAAQ,QAAQ,IAAI;EAC3C,SAAS,GAAG,gBAAgB,SAAS;;CAGvC,OAAO,OACJ,aAAa,CACb,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,IAAI;;;;;AC5Cd,SAAgB,cAAc,OAAgB;CAC5C,IAAI,CAACC,iCAAS,MAAM,EAClB;CAGF,IAAIC,oCAAc,MAAM,EACtB,OAAO;CAQT,OAJiB,MAAM,QAAQ,2BAA2B,IAAI,CAAC,MAEvC,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3BhB,MAAa,mBAAmB,SAA4C;CAC1E,IAAI,CAACC,yCAAiB,KAAK,EAAE,OAAO;CAGpC,OAAO,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM;CAEvC,MAAM,YAAY,KAAK,MAAM,IAAI;CAEjC,IAAI,UAAU,SAAS,GAErB,OAAO,UAAU,GAAG,KAAK,UAAU,GAAG,GAAG,aAAa;CAGxD,OAAO,KAAK,SAAS,IACjB,KAAK,UAAU,GAAG,EAAE,CAAC,aAAa,GAElC,KAAK,GAAG,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACJ3B,MAAa,aACX,OACA,gBACA,cACW;CACX,IAAI,CAACC,iCAAS,MAAM,IAAI,CAACC,iCAAS,UAAU,IAAI,CAACA,iCAAS,eAAe,EACvE,MAAM,IAAI,UACR,4LAA4LC,uCAC1L,MACD,CAAC,0BAA0BA,uCAC1B,eACD,CAAC,qBAAqBA,uCAAe,UAAU,CAAC,OAClD;CAIH,IAAI,QAAQ,KAAK,SAAS,eAAe,QACvC,MAAM,IAAI,WACR,sFACD;CAGH,OACE,eAAe,MAAM,GAAG,MAAM,GAC9B,YACA,eAAe,MAAM,QAAQ,EAAE"}
+{"version":3,"file":"index.cjs","names":["isNonEmptyString","isPlainObject","isNonEmptyString","isPlainObject","isString","isEmptyString","isNonEmptyString","isNumber","isString","getPreciseType"],"sources":["../../src/strings/capitalizations/capitalizeFirst.ts","../../src/strings/capitalizations/capitalizeWords.ts","../../src/strings/sanitizations/stripHtmlTags.ts","../../src/strings/utils/getInitialsName.ts","../../src/strings/utils/replaceAt.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeFirstOptions = {\n  /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.\n   *\n   * @default true\n   */\n  lowerCaseNextRest?: boolean;\n  /** If true, the string will trimmed, default: `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeFirst`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of a string, with optionally lowercases the rest and trims whitespace.**\n * @param {string | null | undefined} string - The string to be processed.\n * @param {CapitalizeFirstOptions} [options] - Options to control behavior.\n * @param {CapitalizeFirstOptions[\"lowerCaseNextRest\"]} [options.lowerCaseNextRest=true] - If true, lowercases the rest (next first letter), default: `true`.\n * @param {CapitalizeFirstOptions[\"trim\"]} [options.trim=false] - If true, trims the string before processing, default: `false`.\n * @returns {string} The processed string, returns `\"\"` if input is `null`, `undefined`, or `not a valid string`.\n * @example\n * ```ts\n * capitalizeFirst(\" hello WORLD \");\n * // ➔ \" Hello world\"\n * capitalizeFirst(\" hello WORLD \", { trim: true });\n * // ➔ \"Hello world\"\n * capitalizeFirst(\"FOO\", { lowerCaseNextRest: false });\n * // ➔ \"FOO\"\n * capitalizeFirst(\"   foo BAR   \", { trim: true, lowerCaseNextRest: false });\n * // ➔ \"Foo BAR\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return `\"\"`.\n * ```ts\n * capitalizeFirst(123);\n * capitalizeFirst(null);\n * capitalizeFirst(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeFirst = (\n  string: string | null | undefined,\n  options: CapitalizeFirstOptions = {\n    lowerCaseNextRest: true,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(string)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const lowerCaseNextRest = options.lowerCaseNextRest !== false;\n  const trim = options.trim === true;\n\n  if (trim) string = string.trim();\n\n  return (\n    (string[0] ? string[0].toUpperCase() : \"\") +\n    (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1))\n  );\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeWordsOptions = {\n  /** If `true`, removes leading and trailing spaces, default `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n  /** If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), default `false`.\n   *\n   * @default false\n   */\n  collapseSpaces?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeWords`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of each word in a string while converting the rest to lowercase.**\n * @param {string | null | undefined} value\n *  ***The input string to be processed.***\n *   - If `null` or `undefined`, returns an empty-string (`\"\"`).\n * @param {CapitalizeWordsOptions} [options]\n *  ***Optional settings to control the output:***\n *   - `trim`: If `true`, removes leading and trailing spaces, defaultValue: `false`.\n *   - `collapseSpaces`: If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), defaultValue: `false`.\n * @returns {string} A new string where each word starts with an uppercase letter\n * and the remaining letters are lowercase.\n *  - If `value` is `empty`, `null`, or `undefined`, returns an `empty-string`.\n * @example\n * ```ts\n * capitalizeWords(\"  hello   world  \");\n * // ➔ \"  Hello   World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true });\n * // ➔ \"Hello   World\"\n * capitalizeWords(\"  hello   world  \", { collapseSpaces: true });\n * // ➔ \"  Hello World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true, collapseSpaces: true });\n * // ➔ \"Hello World\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return \"\".\n * ```ts\n * capitalizeWords(123);\n * capitalizeWords(null);\n * capitalizeWords(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeWords = (\n  value: string | null | undefined,\n  options: CapitalizeWordsOptions = {\n    collapseSpaces: false,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  let result = value;\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const collapseSpaces = options.collapseSpaces === true;\n  const trim = options.trim === true;\n\n  if (trim) {\n    result = result.trim();\n  }\n\n  if (collapseSpaces) {\n    const leadingSpaces = result.match(/^\\s*/)?.[0] ?? \"\";\n    const trailingSpaces = result.match(/\\s*$/)?.[0] ?? \"\";\n    result = result.trim().replace(/\\s+/g, \" \");\n    result = `${leadingSpaces}${result}${trailingSpaces}`;\n  }\n\n  return result\n    .toLowerCase()\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n};\n","import type { Extends } from \"@rzl-zone/ts-types-plus\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `stripHtmlTags`.***\n * ----------------------------------------------------------\n * **This function removes valid HTML tags (including nested and self-closing ones)\n * by replacing them with spaces, then collapses multiple whitespaces into a single space.**\n * - **It handles the following cases:**\n *    - If the input is not a string (`null`, `undefined`, or any non-string), it is returned as undefined.\n *    - If the input is an empty or whitespace-only string, it returns an empty string (`\"\"`).\n *    - Otherwise, it returns the cleaned string with tags removed and normalized whitespace.\n * @template T - Input string type (string | null | undefined).\n * @param {string | null | undefined} input - A string potentially containing HTML tags.\n * @returns {string | undefined} Cleaned string if input is string, or original input otherwise.\n * @example\n * stripHtmlTags(\"<p>Hello</p>\");\n * // ➔ \"Hello\"\n * stripHtmlTags(\"<div><b>Bold</b> text</div>\");\n * // ➔ \"Bold text\"\n * stripHtmlTags(\"Line<br/>Break\");\n * // ➔ \"Line Break\"\n * stripHtmlTags(\"2 < 5 and 5 > 2\");\n * // ➔ \"2 < 5 and 5 > 2\"\n * stripHtmlTags(\"\");\n * // ➔ \"\"\n * stripHtmlTags(\"   \");\n * // ➔ \"\"\n * stripHtmlTags(null);\n * // ➔ undefined\n * stripHtmlTags(undefined);\n * // ➔ undefined\n */\nexport function stripHtmlTags(input: string): string;\nexport function stripHtmlTags<T>(\n  input: T\n): Extends<string, T> extends true ? string | undefined : undefined;\nexport function stripHtmlTags(input: unknown) {\n  if (!isString(input)) {\n    return undefined;\n  }\n\n  if (isEmptyString(input)) {\n    return \"\";\n  }\n\n  // return input.replace(/<[^>]*>/g, \"\");\n  const stripped = input.replace(/<\\/?[a-zA-Z][^<>]*\\/?>/g, \" \").trim();\n\n  const cleaned = stripped.replace(/\\s+/g, \" \").trim();\n\n  return cleaned;\n}\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `getInitialsName`.***\n * ----------------------------------------------------------\n * **Extracts initials from the given name string.**\n * - **Behavior:**\n *    - For names with two or more words, returns the first letter of the first and second words.\n *    - For a single word with 2+ characters, returns the first two letters.\n *    - For a single character, returns that character.\n *    - For `empty`, `null`, `undefined` or `whitespace-only input`, returns an empty string (`\"\"`).\n * @param {string | null | undefined} name - The name to extract initials from.\n * @returns {string} The extracted initials (e.g., \"JD\" for \"John Doe\").\n * @example\n * getInitialsName(\"Alice\");             // ➔ \"AL\"\n * getInitialsName(\"John Doe\");          // ➔ \"JD\"\n * getInitialsName(\" Bob Marley \");      // ➔ \"BM\"\n * getInitialsName(\"John Ronald Donal\"); // ➔ \"JR\"\n * getInitialsName(\"Lord John Doe Moe\"); // ➔ \"LJ\"\n * getInitialsName(\"X\");                 // ➔ \"X\"\n * getInitialsName(\"\");                  // ➔ \"\" (empty string)\n * getInitialsName(\"  \");                // ➔ \"\" (empty string)\n * getInitialsName(null);                // ➔ \"\" (null input)\n * getInitialsName(undefined);           // ➔ \"\" (undefined input)\n */\nexport const getInitialsName = (name: string | null | undefined): string => {\n  if (!isNonEmptyString(name)) return \"\"; // Handle empty string case\n\n  // Trim spaces and remove duplicate spaces\n  name = name.replace(/\\s+/g, \" \").trim();\n\n  const nameParts = name.split(\" \");\n\n  if (nameParts.length > 1) {\n    if (!(nameParts[0] && nameParts[1] && nameParts[1][0])) return \"\";\n\n    // First letter of first and second words\n    return (nameParts[0][0] + nameParts[1][0]).toUpperCase();\n  }\n\n  return name.length > 1\n    ? name.substring(0, 2).toUpperCase()\n    : // First two letters for single-word names\n      (name[0]?.toUpperCase() ?? \"\");\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\n/** ----------------------------------------------------------\n *  * ***Utility: `replaceAt`.***\n * ----------------------------------------------------------\n * **Replaces exactly one character at the specified index in the original string\n * with the provided `replaceTo` string.**\n * - **Behavior:**\n *    - If `replaceTo` has more than one character,\n * the result will expand accordingly.\n * @param {number} index - The starting index where the replacement should occur.\n * @param {string} originalString - The original string to modify.\n * @param {string} replaceTo - The string to insert at the specified index.\n * @returns {string} The modified string with the replacement applied.\n * @example\n * replaceAt(3, \"hello\", \"X\");\n * // ➔ \"helXo\"\n * replaceAt(1, \"world\", \"AB\");\n * // ➔ \"wABrld\"\n * replaceAt(0, \"cat\", \"br\");\n * // ➔ \"brat\"\n * replaceAt(2, \"12345\", \"-\");\n * // ➔ \"12-45\"\n * replaceAt(4, \"ABCDE\", \"Z\");\n * // ➔ \"ABCDZ\"\n * // ❌ Examples that throw:\n * replaceAt(10, \"short\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(-1, \"test\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(\"1\", \"test\", \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n * replaceAt(2, null, \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n */\nexport const replaceAt = (\n  index: number,\n  originalString: string,\n  replaceTo: string\n): string => {\n  if (!isNumber(index) || !isString(replaceTo) || !isString(originalString)) {\n    throw new TypeError(\n      `First parameter (\\`index\\`) must be of type \\`number\\`, second parameter (\\`originalString\\`) and third parameter (\\`replaceTo\\`) must be of type \\`string\\`, but received: \"['index': \\`${getPreciseType(\n        index\n      )}\\`, 'originalString': \\`${getPreciseType(\n        originalString\n      )}\\`, 'replaceTo': \\`${getPreciseType(replaceTo)}\\`]\".`\n    );\n  }\n\n  // Handle edge cases\n  if (index < 0 || index >= originalString.length) {\n    throw new RangeError(\n      \"First parameter (`index`) is out of range from second parameter (`originalString`).\"\n    );\n  }\n\n  return (\n    originalString.slice(0, index) + // Extract before the index\n    replaceTo + // Insert replacement\n    originalString.slice(index + 1) // Extract after replacement\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,UAAkC;CAChC,mBAAmB;CACnB,MAAM;CACP,KACU;CACX,IAAI,CAACA,yCAAiB,OAAO,EAAE,OAAO;CAEtC,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,oBAAoB,QAAQ,sBAAsB;CAGxD,IAFa,QAAQ,SAAS,MAEpB,SAAS,OAAO,MAAM;CAEhC,QACG,OAAO,KAAK,OAAO,GAAG,aAAa,GAAG,OACtC,oBAAoB,OAAO,MAAM,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfxE,MAAa,mBACX,OACA,UAAkC;CAChC,gBAAgB;CAChB,MAAM;CACP,KACU;CACX,IAAI,CAACC,yCAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,SAAS;CAEb,IAAI,CAACC,sCAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,iBAAiB,QAAQ,mBAAmB;CAGlD,IAFa,QAAQ,SAAS,MAG5B,SAAS,OAAO,MAAM;CAGxB,IAAI,gBAAgB;EAClB,MAAM,gBAAgB,OAAO,MAAM,OAAO,GAAG,MAAM;EACnD,MAAM,iBAAiB,OAAO,MAAM,OAAO,GAAG,MAAM;EACpD,SAAS,OAAO,MAAM,CAAC,QAAQ,QAAQ,IAAI;EAC3C,SAAS,GAAG,gBAAgB,SAAS;;CAGvC,OAAO,OACJ,aAAa,CACb,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,IAAI;;;;;AC5Cd,SAAgB,cAAc,OAAgB;CAC5C,IAAI,CAACC,iCAAS,MAAM,EAClB;CAGF,IAAIC,oCAAc,MAAM,EACtB,OAAO;CAQT,OAJiB,MAAM,QAAQ,2BAA2B,IAAI,CAAC,MAEvC,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3BhB,MAAa,mBAAmB,SAA4C;CAC1E,IAAI,CAACC,yCAAiB,KAAK,EAAE,OAAO;CAGpC,OAAO,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM;CAEvC,MAAM,YAAY,KAAK,MAAM,IAAI;CAEjC,IAAI,UAAU,SAAS,GAAG;EACxB,IAAI,EAAE,UAAU,MAAM,UAAU,MAAM,UAAU,GAAG,KAAK,OAAO;EAG/D,QAAQ,UAAU,GAAG,KAAK,UAAU,GAAG,IAAI,aAAa;;CAG1D,OAAO,KAAK,SAAS,IACjB,KAAK,UAAU,GAAG,EAAE,CAAC,aAAa,GAEjC,KAAK,IAAI,aAAa,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACNjC,MAAa,aACX,OACA,gBACA,cACW;CACX,IAAI,CAACC,iCAAS,MAAM,IAAI,CAACC,iCAAS,UAAU,IAAI,CAACA,iCAAS,eAAe,EACvE,MAAM,IAAI,UACR,4LAA4LC,uCAC1L,MACD,CAAC,0BAA0BA,uCAC1B,eACD,CAAC,qBAAqBA,uCAAe,UAAU,CAAC,OAClD;CAIH,IAAI,QAAQ,KAAK,SAAS,eAAe,QACvC,MAAM,IAAI,WACR,sFACD;CAGH,OACE,eAAe,MAAM,GAAG,MAAM,GAC9B,YACA,eAAe,MAAM,QAAQ,EAAE"}

package/dist/strings/index.d.cts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as normalizeString, c as toPascalCaseSpace, d as toKebabCase, f as toDotCase, g as capitalizeFirst, h as capitalizeWords, i as removeSpaces, l as toPascalCase, m as slugify, n as getInitialsName, o as normalizeSpaces, p as toCamelCase, r as stripHtmlTags, s as toSnakeCase, t as replaceAt, u as toLowerCase } from "../index-DPs1_p5G.cjs";
+import { a as normalizeString, c as toPascalCaseSpace, d as toKebabCase, f as toDotCase, g as capitalizeFirst, h as capitalizeWords, i as removeSpaces, l as toPascalCase, m as slugify, n as getInitialsName, o as normalizeSpaces, p as toCamelCase, r as stripHtmlTags, s as toSnakeCase, t as replaceAt, u as toLowerCase } from "../index-DsGxO31H.cjs";
 export { capitalizeFirst, capitalizeWords, getInitialsName, normalizeSpaces, normalizeString, removeSpaces, replaceAt, slugify, stripHtmlTags, toCamelCase, toDotCase, toKebabCase, toLowerCase, toPascalCase, toPascalCaseSpace, toSnakeCase };

package/dist/strings/index.d.ts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as normalizeString, c as toPascalCaseSpace, d as toKebabCase, f as toDotCase, g as capitalizeFirst, h as capitalizeWords, i as removeSpaces, l as toPascalCase, m as slugify, n as getInitialsName, o as normalizeSpaces, p as toCamelCase, r as stripHtmlTags, s as toSnakeCase, t as replaceAt, u as toLowerCase } from "../index-26W7ItWx.js";
+import { a as normalizeString, c as toPascalCaseSpace, d as toKebabCase, f as toDotCase, g as capitalizeFirst, h as capitalizeWords, i as removeSpaces, l as toPascalCase, m as slugify, n as getInitialsName, o as normalizeSpaces, p as toCamelCase, r as stripHtmlTags, s as toSnakeCase, t as replaceAt, u as toLowerCase } from "../index-Hg1qJkjl.js";
 export { capitalizeFirst, capitalizeWords, getInitialsName, normalizeSpaces, normalizeString, removeSpaces, replaceAt, slugify, stripHtmlTags, toCamelCase, toDotCase, toKebabCase, toLowerCase, toPascalCase, toPascalCaseSpace, toSnakeCase };

package/dist/strings/index.js

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, a as toPascalCase, c as toKebabCase, d as slugify, i as toPascalCaseSpace, k as isString, l as toCamelCase, o as toLowerCase, r as getPreciseType, s as toSnakeCase, u as toDotCase, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-BlBct0Fc.js";
-import { t as isEmptyString } from "../isEmptyString-BTUWYTbw.js";
-import { t as normalizeSpaces } from "../normalizeSpaces-WS_iERJk.js";
-import { t as normalizeString } from "../normalizeString-2WLth_Gj.js";
-import { t as removeSpaces } from "../removeSpaces-BE8lfh-4.js";
+import { A as isPlainObject, a as toPascalCase, c as toKebabCase, d as slugify, i as toPascalCaseSpace, k as isString, l as toCamelCase, o as toLowerCase, r as getPreciseType, s as toSnakeCase, u as toDotCase, w as isNumber, y as isNonEmptyString } from "../assertIsBoolean-DR1SaXPD.js";
+import { t as isEmptyString } from "../isEmptyString-BXzKAC2j.js";
+import { t as normalizeSpaces } from "../normalizeSpaces-Bg2IZW7W.js";
+import { t as normalizeString } from "../normalizeString-BDdkaXui.js";
+import { t as removeSpaces } from "../removeSpaces-Bmc5DX4F.js";
 const capitalizeFirst = (string, options = {
 	lowerCaseNextRest: true,
 	trim: false
@@ -20,7 +20,7 @@ const capitalizeFirst = (string, options = {
 	if (!isPlainObject(options)) options = {};
 	const lowerCaseNextRest = options.lowerCaseNextRest !== false;
 	if (options.trim === true) string = string.trim();
-	return string[0].toUpperCase() + (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1));
+	return (string[0] ? string[0].toUpperCase() : "") + (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1));
 };
 const capitalizeWords = (value, options = {
 	collapseSpaces: false,
@@ -48,8 +48,11 @@ const getInitialsName = (name) => {
 	if (!isNonEmptyString(name)) return "";
 	name = name.replace(/\s+/g, " ").trim();
 	const nameParts = name.split(" ");
-	if (nameParts.length > 1) return nameParts[0][0] + nameParts[1][0].toUpperCase();
-	return name.length > 1 ? name.substring(0, 2).toUpperCase() : name[0].toUpperCase();
+	if (nameParts.length > 1) {
+		if (!(nameParts[0] && nameParts[1] && nameParts[1][0])) return "";
+		return (nameParts[0][0] + nameParts[1][0]).toUpperCase();
+	}
+	return name.length > 1 ? name.substring(0, 2).toUpperCase() : name[0]?.toUpperCase() ?? "";
 };
 const replaceAt = (index, originalString, replaceTo) => {
 	if (!isNumber(index) || !isString(replaceTo) || !isString(originalString)) throw new TypeError(`First parameter (\`index\`) must be of type \`number\`, second parameter (\`originalString\`) and third parameter (\`replaceTo\`) must be of type \`string\`, but received: "['index': \`${getPreciseType(index)}\`, 'originalString': \`${getPreciseType(originalString)}\`, 'replaceTo': \`${getPreciseType(replaceTo)}\`]".`);

package/dist/strings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/strings/capitalizations/capitalizeFirst.ts","../../src/strings/capitalizations/capitalizeWords.ts","../../src/strings/sanitizations/stripHtmlTags.ts","../../src/strings/utils/getInitialsName.ts","../../src/strings/utils/replaceAt.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeFirstOptions = {\n  /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.\n   *\n   * @default true\n   */\n  lowerCaseNextRest?: boolean;\n  /** If true, the string will trimmed, default: `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeFirst`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of a string, with optionally lowercases the rest and trims whitespace.**\n * @param {string | null | undefined} string - The string to be processed.\n * @param {CapitalizeFirstOptions} [options] - Options to control behavior.\n * @param {CapitalizeFirstOptions[\"lowerCaseNextRest\"]} [options.lowerCaseNextRest=true] - If true, lowercases the rest (next first letter), default: `true`.\n * @param {CapitalizeFirstOptions[\"trim\"]} [options.trim=false] - If true, trims the string before processing, default: `false`.\n * @returns {string} The processed string, returns `\"\"` if input is `null`, `undefined`, or `not a valid string`.\n * @example\n * ```ts\n * capitalizeFirst(\" hello WORLD \");\n * // ➔ \" Hello world\"\n * capitalizeFirst(\" hello WORLD \", { trim: true });\n * // ➔ \"Hello world\"\n * capitalizeFirst(\"FOO\", { lowerCaseNextRest: false });\n * // ➔ \"FOO\"\n * capitalizeFirst(\"   foo BAR   \", { trim: true, lowerCaseNextRest: false });\n * // ➔ \"Foo BAR\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return `\"\"`.\n * ```ts\n * capitalizeFirst(123);\n * capitalizeFirst(null);\n * capitalizeFirst(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeFirst = (\n  string: string | null | undefined,\n  options: CapitalizeFirstOptions = {\n    lowerCaseNextRest: true,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(string)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const lowerCaseNextRest = options.lowerCaseNextRest !== false;\n  const trim = options.trim === true;\n\n  if (trim) string = string.trim();\n\n  return (\n    string[0].toUpperCase() +\n    (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1))\n  );\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeWordsOptions = {\n  /** If `true`, removes leading and trailing spaces, default `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n  /** If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), default `false`.\n   *\n   * @default false\n   */\n  collapseSpaces?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeWords`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of each word in a string while converting the rest to lowercase.**\n * @param {string | null | undefined} value\n *  ***The input string to be processed.***\n *   - If `null` or `undefined`, returns an empty-string (`\"\"`).\n * @param {CapitalizeWordsOptions} [options]\n *  ***Optional settings to control the output:***\n *   - `trim`: If `true`, removes leading and trailing spaces, defaultValue: `false`.\n *   - `collapseSpaces`: If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), defaultValue: `false`.\n * @returns {string} A new string where each word starts with an uppercase letter\n * and the remaining letters are lowercase.\n *  - If `value` is `empty`, `null`, or `undefined`, returns an `empty-string`.\n * @example\n * ```ts\n * capitalizeWords(\"  hello   world  \");\n * // ➔ \"  Hello   World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true });\n * // ➔ \"Hello   World\"\n * capitalizeWords(\"  hello   world  \", { collapseSpaces: true });\n * // ➔ \"  Hello World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true, collapseSpaces: true });\n * // ➔ \"Hello World\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return \"\".\n * ```ts\n * capitalizeWords(123);\n * capitalizeWords(null);\n * capitalizeWords(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeWords = (\n  value: string | null | undefined,\n  options: CapitalizeWordsOptions = {\n    collapseSpaces: false,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  let result = value;\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const collapseSpaces = options.collapseSpaces === true;\n  const trim = options.trim === true;\n\n  if (trim) {\n    result = result.trim();\n  }\n\n  if (collapseSpaces) {\n    const leadingSpaces = result.match(/^\\s*/)?.[0] ?? \"\";\n    const trailingSpaces = result.match(/\\s*$/)?.[0] ?? \"\";\n    result = result.trim().replace(/\\s+/g, \" \");\n    result = `${leadingSpaces}${result}${trailingSpaces}`;\n  }\n\n  return result\n    .toLowerCase()\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n};\n","import type { Extends } from \"@rzl-zone/ts-types-plus\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `stripHtmlTags`.***\n * ----------------------------------------------------------\n * **This function removes valid HTML tags (including nested and self-closing ones)\n * by replacing them with spaces, then collapses multiple whitespaces into a single space.**\n * - **It handles the following cases:**\n *    - If the input is not a string (`null`, `undefined`, or any non-string), it is returned as undefined.\n *    - If the input is an empty or whitespace-only string, it returns an empty string (`\"\"`).\n *    - Otherwise, it returns the cleaned string with tags removed and normalized whitespace.\n * @template T - Input string type (string | null | undefined).\n * @param {string | null | undefined} input - A string potentially containing HTML tags.\n * @returns {string | undefined} Cleaned string if input is string, or original input otherwise.\n * @example\n * stripHtmlTags(\"<p>Hello</p>\");\n * // ➔ \"Hello\"\n * stripHtmlTags(\"<div><b>Bold</b> text</div>\");\n * // ➔ \"Bold text\"\n * stripHtmlTags(\"Line<br/>Break\");\n * // ➔ \"Line Break\"\n * stripHtmlTags(\"2 < 5 and 5 > 2\");\n * // ➔ \"2 < 5 and 5 > 2\"\n * stripHtmlTags(\"\");\n * // ➔ \"\"\n * stripHtmlTags(\"   \");\n * // ➔ \"\"\n * stripHtmlTags(null);\n * // ➔ undefined\n * stripHtmlTags(undefined);\n * // ➔ undefined\n */\nexport function stripHtmlTags(input: string): string;\nexport function stripHtmlTags<T>(\n  input: T\n): Extends<string, T> extends true ? string | undefined : undefined;\nexport function stripHtmlTags(input: unknown) {\n  if (!isString(input)) {\n    return undefined;\n  }\n\n  if (isEmptyString(input)) {\n    return \"\";\n  }\n\n  // return input.replace(/<[^>]*>/g, \"\");\n  const stripped = input.replace(/<\\/?[a-zA-Z][^<>]*\\/?>/g, \" \").trim();\n\n  const cleaned = stripped.replace(/\\s+/g, \" \").trim();\n\n  return cleaned;\n}\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `getInitialsName`.***\n * ----------------------------------------------------------\n * **Extracts initials from the given name string.**\n * - **Behavior:**\n *    - For names with two or more words, returns the first letter of the first and second words.\n *    - For a single word with 2+ characters, returns the first two letters.\n *    - For a single character, returns that character.\n *    - For `empty`, `null`, `undefined` or `whitespace-only input`, returns an empty string (`\"\"`).\n * @param {string | null | undefined} name - The name to extract initials from.\n * @returns {string} The extracted initials (e.g., \"JD\" for \"John Doe\").\n * @example\n * getInitialsName(\"Alice\");             // ➔ \"AL\"\n * getInitialsName(\"John Doe\");          // ➔ \"JD\"\n * getInitialsName(\" Bob Marley \");      // ➔ \"BM\"\n * getInitialsName(\"John Ronald Donal\"); // ➔ \"JR\"\n * getInitialsName(\"Lord John Doe Moe\"); // ➔ \"LJ\"\n * getInitialsName(\"X\");                 // ➔ \"X\"\n * getInitialsName(\"\");                  // ➔ \"\" (empty string)\n * getInitialsName(\"  \");                // ➔ \"\" (empty string)\n * getInitialsName(null);                // ➔ \"\" (null input)\n * getInitialsName(undefined);           // ➔ \"\" (undefined input)\n */\nexport const getInitialsName = (name: string | null | undefined): string => {\n  if (!isNonEmptyString(name)) return \"\"; // Handle empty string case\n\n  // Trim spaces and remove duplicate spaces\n  name = name.replace(/\\s+/g, \" \").trim();\n\n  const nameParts = name.split(\" \");\n\n  if (nameParts.length > 1) {\n    // First letter of first and second words\n    return nameParts[0][0] + nameParts[1][0].toUpperCase();\n  }\n\n  return name.length > 1\n    ? name.substring(0, 2).toUpperCase()\n    : // First two letters for single-word names\n      name[0].toUpperCase();\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\n/** ----------------------------------------------------------\n *  * ***Utility: `replaceAt`.***\n * ----------------------------------------------------------\n * **Replaces exactly one character at the specified index in the original string\n * with the provided `replaceTo` string.**\n * - **Behavior:**\n *    - If `replaceTo` has more than one character,\n * the result will expand accordingly.\n * @param {number} index - The starting index where the replacement should occur.\n * @param {string} originalString - The original string to modify.\n * @param {string} replaceTo - The string to insert at the specified index.\n * @returns {string} The modified string with the replacement applied.\n * @example\n * replaceAt(3, \"hello\", \"X\");\n * // ➔ \"helXo\"\n * replaceAt(1, \"world\", \"AB\");\n * // ➔ \"wABrld\"\n * replaceAt(0, \"cat\", \"br\");\n * // ➔ \"brat\"\n * replaceAt(2, \"12345\", \"-\");\n * // ➔ \"12-45\"\n * replaceAt(4, \"ABCDE\", \"Z\");\n * // ➔ \"ABCDZ\"\n * // ❌ Examples that throw:\n * replaceAt(10, \"short\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(-1, \"test\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(\"1\", \"test\", \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n * replaceAt(2, null, \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n */\nexport const replaceAt = (\n  index: number,\n  originalString: string,\n  replaceTo: string\n): string => {\n  if (!isNumber(index) || !isString(replaceTo) || !isString(originalString)) {\n    throw new TypeError(\n      `First parameter (\\`index\\`) must be of type \\`number\\`, second parameter (\\`originalString\\`) and third parameter (\\`replaceTo\\`) must be of type \\`string\\`, but received: \"['index': \\`${getPreciseType(\n        index\n      )}\\`, 'originalString': \\`${getPreciseType(\n        originalString\n      )}\\`, 'replaceTo': \\`${getPreciseType(replaceTo)}\\`]\".`\n    );\n  }\n\n  // Handle edge cases\n  if (index < 0 || index >= originalString.length) {\n    throw new RangeError(\n      \"First parameter (`index`) is out of range from second parameter (`originalString`).\"\n    );\n  }\n\n  return (\n    originalString.slice(0, index) + // Extract before the index\n    replaceTo + // Insert replacement\n    originalString.slice(index + 1) // Extract after replacement\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,UAAkC;CAChC,mBAAmB;CACnB,MAAM;CACP,KACU;CACX,IAAI,CAAC,iBAAiB,OAAO,EAAE,OAAO;CAEtC,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,oBAAoB,QAAQ,sBAAsB;CAGxD,IAFa,QAAQ,SAAS,MAEpB,SAAS,OAAO,MAAM;CAEhC,OACE,OAAO,GAAG,aAAa,IACtB,oBAAoB,OAAO,MAAM,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfxE,MAAa,mBACX,OACA,UAAkC;CAChC,gBAAgB;CAChB,MAAM;CACP,KACU;CACX,IAAI,CAAC,iBAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,SAAS;CAEb,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,iBAAiB,QAAQ,mBAAmB;CAGlD,IAFa,QAAQ,SAAS,MAG5B,SAAS,OAAO,MAAM;CAGxB,IAAI,gBAAgB;EAClB,MAAM,gBAAgB,OAAO,MAAM,OAAO,GAAG,MAAM;EACnD,MAAM,iBAAiB,OAAO,MAAM,OAAO,GAAG,MAAM;EACpD,SAAS,OAAO,MAAM,CAAC,QAAQ,QAAQ,IAAI;EAC3C,SAAS,GAAG,gBAAgB,SAAS;;CAGvC,OAAO,OACJ,aAAa,CACb,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,IAAI;;;;;AC5Cd,SAAgB,cAAc,OAAgB;CAC5C,IAAI,CAAC,SAAS,MAAM,EAClB;CAGF,IAAI,cAAc,MAAM,EACtB,OAAO;CAQT,OAJiB,MAAM,QAAQ,2BAA2B,IAAI,CAAC,MAEvC,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3BhB,MAAa,mBAAmB,SAA4C;CAC1E,IAAI,CAAC,iBAAiB,KAAK,EAAE,OAAO;CAGpC,OAAO,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM;CAEvC,MAAM,YAAY,KAAK,MAAM,IAAI;CAEjC,IAAI,UAAU,SAAS,GAErB,OAAO,UAAU,GAAG,KAAK,UAAU,GAAG,GAAG,aAAa;CAGxD,OAAO,KAAK,SAAS,IACjB,KAAK,UAAU,GAAG,EAAE,CAAC,aAAa,GAElC,KAAK,GAAG,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACJ3B,MAAa,aACX,OACA,gBACA,cACW;CACX,IAAI,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,eAAe,EACvE,MAAM,IAAI,UACR,4LAA4L,eAC1L,MACD,CAAC,0BAA0B,eAC1B,eACD,CAAC,qBAAqB,eAAe,UAAU,CAAC,OAClD;CAIH,IAAI,QAAQ,KAAK,SAAS,eAAe,QACvC,MAAM,IAAI,WACR,sFACD;CAGH,OACE,eAAe,MAAM,GAAG,MAAM,GAC9B,YACA,eAAe,MAAM,QAAQ,EAAE"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/strings/capitalizations/capitalizeFirst.ts","../../src/strings/capitalizations/capitalizeWords.ts","../../src/strings/sanitizations/stripHtmlTags.ts","../../src/strings/utils/getInitialsName.ts","../../src/strings/utils/replaceAt.ts"],"sourcesContent":["import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeFirstOptions = {\n  /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.\n   *\n   * @default true\n   */\n  lowerCaseNextRest?: boolean;\n  /** If true, the string will trimmed, default: `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeFirst`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of a string, with optionally lowercases the rest and trims whitespace.**\n * @param {string | null | undefined} string - The string to be processed.\n * @param {CapitalizeFirstOptions} [options] - Options to control behavior.\n * @param {CapitalizeFirstOptions[\"lowerCaseNextRest\"]} [options.lowerCaseNextRest=true] - If true, lowercases the rest (next first letter), default: `true`.\n * @param {CapitalizeFirstOptions[\"trim\"]} [options.trim=false] - If true, trims the string before processing, default: `false`.\n * @returns {string} The processed string, returns `\"\"` if input is `null`, `undefined`, or `not a valid string`.\n * @example\n * ```ts\n * capitalizeFirst(\" hello WORLD \");\n * // ➔ \" Hello world\"\n * capitalizeFirst(\" hello WORLD \", { trim: true });\n * // ➔ \"Hello world\"\n * capitalizeFirst(\"FOO\", { lowerCaseNextRest: false });\n * // ➔ \"FOO\"\n * capitalizeFirst(\"   foo BAR   \", { trim: true, lowerCaseNextRest: false });\n * // ➔ \"Foo BAR\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return `\"\"`.\n * ```ts\n * capitalizeFirst(123);\n * capitalizeFirst(null);\n * capitalizeFirst(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeFirst = (\n  string: string | null | undefined,\n  options: CapitalizeFirstOptions = {\n    lowerCaseNextRest: true,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(string)) return \"\";\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const lowerCaseNextRest = options.lowerCaseNextRest !== false;\n  const trim = options.trim === true;\n\n  if (trim) string = string.trim();\n\n  return (\n    (string[0] ? string[0].toUpperCase() : \"\") +\n    (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1))\n  );\n};\n","import { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\ntype CapitalizeWordsOptions = {\n  /** If `true`, removes leading and trailing spaces, default `false`.\n   *\n   * @default false\n   */\n  trim?: boolean;\n  /** If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), default `false`.\n   *\n   * @default false\n   */\n  collapseSpaces?: boolean;\n};\n\n/** ----------------------------------------------------------\n * * ***Utility: `capitalizeWords`.***\n * ----------------------------------------------------------\n * **Capitalizes the first letter of each word in a string while converting the rest to lowercase.**\n * @param {string | null | undefined} value\n *  ***The input string to be processed.***\n *   - If `null` or `undefined`, returns an empty-string (`\"\"`).\n * @param {CapitalizeWordsOptions} [options]\n *  ***Optional settings to control the output:***\n *   - `trim`: If `true`, removes leading and trailing spaces, defaultValue: `false`.\n *   - `collapseSpaces`: If `true`, collapses multiple spaces **between words** into a single space (while preserving leading/trailing spaces), defaultValue: `false`.\n * @returns {string} A new string where each word starts with an uppercase letter\n * and the remaining letters are lowercase.\n *  - If `value` is `empty`, `null`, or `undefined`, returns an `empty-string`.\n * @example\n * ```ts\n * capitalizeWords(\"  hello   world  \");\n * // ➔ \"  Hello   World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true });\n * // ➔ \"Hello   World\"\n * capitalizeWords(\"  hello   world  \", { collapseSpaces: true });\n * // ➔ \"  Hello World  \"\n * capitalizeWords(\"  hello   world  \", { trim: true, collapseSpaces: true });\n * // ➔ \"Hello World\"\n * ```\n * #### ℹ️ If null, undefined, or not a valid string input, return \"\".\n * ```ts\n * capitalizeWords(123);\n * capitalizeWords(null);\n * capitalizeWords(undefined);\n * // ➔ \"\"\n * ```\n */\nexport const capitalizeWords = (\n  value: string | null | undefined,\n  options: CapitalizeWordsOptions = {\n    collapseSpaces: false,\n    trim: false\n  }\n): string => {\n  if (!isNonEmptyString(value)) return \"\";\n\n  let result = value;\n\n  if (!isPlainObject(options)) {\n    options = {};\n  }\n\n  const collapseSpaces = options.collapseSpaces === true;\n  const trim = options.trim === true;\n\n  if (trim) {\n    result = result.trim();\n  }\n\n  if (collapseSpaces) {\n    const leadingSpaces = result.match(/^\\s*/)?.[0] ?? \"\";\n    const trailingSpaces = result.match(/\\s*$/)?.[0] ?? \"\";\n    result = result.trim().replace(/\\s+/g, \" \");\n    result = `${leadingSpaces}${result}${trailingSpaces}`;\n  }\n\n  return result\n    .toLowerCase()\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n};\n","import type { Extends } from \"@rzl-zone/ts-types-plus\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `stripHtmlTags`.***\n * ----------------------------------------------------------\n * **This function removes valid HTML tags (including nested and self-closing ones)\n * by replacing them with spaces, then collapses multiple whitespaces into a single space.**\n * - **It handles the following cases:**\n *    - If the input is not a string (`null`, `undefined`, or any non-string), it is returned as undefined.\n *    - If the input is an empty or whitespace-only string, it returns an empty string (`\"\"`).\n *    - Otherwise, it returns the cleaned string with tags removed and normalized whitespace.\n * @template T - Input string type (string | null | undefined).\n * @param {string | null | undefined} input - A string potentially containing HTML tags.\n * @returns {string | undefined} Cleaned string if input is string, or original input otherwise.\n * @example\n * stripHtmlTags(\"<p>Hello</p>\");\n * // ➔ \"Hello\"\n * stripHtmlTags(\"<div><b>Bold</b> text</div>\");\n * // ➔ \"Bold text\"\n * stripHtmlTags(\"Line<br/>Break\");\n * // ➔ \"Line Break\"\n * stripHtmlTags(\"2 < 5 and 5 > 2\");\n * // ➔ \"2 < 5 and 5 > 2\"\n * stripHtmlTags(\"\");\n * // ➔ \"\"\n * stripHtmlTags(\"   \");\n * // ➔ \"\"\n * stripHtmlTags(null);\n * // ➔ undefined\n * stripHtmlTags(undefined);\n * // ➔ undefined\n */\nexport function stripHtmlTags(input: string): string;\nexport function stripHtmlTags<T>(\n  input: T\n): Extends<string, T> extends true ? string | undefined : undefined;\nexport function stripHtmlTags(input: unknown) {\n  if (!isString(input)) {\n    return undefined;\n  }\n\n  if (isEmptyString(input)) {\n    return \"\";\n  }\n\n  // return input.replace(/<[^>]*>/g, \"\");\n  const stripped = input.replace(/<\\/?[a-zA-Z][^<>]*\\/?>/g, \" \").trim();\n\n  const cleaned = stripped.replace(/\\s+/g, \" \").trim();\n\n  return cleaned;\n}\n","import { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `getInitialsName`.***\n * ----------------------------------------------------------\n * **Extracts initials from the given name string.**\n * - **Behavior:**\n *    - For names with two or more words, returns the first letter of the first and second words.\n *    - For a single word with 2+ characters, returns the first two letters.\n *    - For a single character, returns that character.\n *    - For `empty`, `null`, `undefined` or `whitespace-only input`, returns an empty string (`\"\"`).\n * @param {string | null | undefined} name - The name to extract initials from.\n * @returns {string} The extracted initials (e.g., \"JD\" for \"John Doe\").\n * @example\n * getInitialsName(\"Alice\");             // ➔ \"AL\"\n * getInitialsName(\"John Doe\");          // ➔ \"JD\"\n * getInitialsName(\" Bob Marley \");      // ➔ \"BM\"\n * getInitialsName(\"John Ronald Donal\"); // ➔ \"JR\"\n * getInitialsName(\"Lord John Doe Moe\"); // ➔ \"LJ\"\n * getInitialsName(\"X\");                 // ➔ \"X\"\n * getInitialsName(\"\");                  // ➔ \"\" (empty string)\n * getInitialsName(\"  \");                // ➔ \"\" (empty string)\n * getInitialsName(null);                // ➔ \"\" (null input)\n * getInitialsName(undefined);           // ➔ \"\" (undefined input)\n */\nexport const getInitialsName = (name: string | null | undefined): string => {\n  if (!isNonEmptyString(name)) return \"\"; // Handle empty string case\n\n  // Trim spaces and remove duplicate spaces\n  name = name.replace(/\\s+/g, \" \").trim();\n\n  const nameParts = name.split(\" \");\n\n  if (nameParts.length > 1) {\n    if (!(nameParts[0] && nameParts[1] && nameParts[1][0])) return \"\";\n\n    // First letter of first and second words\n    return (nameParts[0][0] + nameParts[1][0]).toUpperCase();\n  }\n\n  return name.length > 1\n    ? name.substring(0, 2).toUpperCase()\n    : // First two letters for single-word names\n      (name[0]?.toUpperCase() ?? \"\");\n};\n","import { isNumber } from \"@/predicates/is/isNumber\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\n\n/** ----------------------------------------------------------\n *  * ***Utility: `replaceAt`.***\n * ----------------------------------------------------------\n * **Replaces exactly one character at the specified index in the original string\n * with the provided `replaceTo` string.**\n * - **Behavior:**\n *    - If `replaceTo` has more than one character,\n * the result will expand accordingly.\n * @param {number} index - The starting index where the replacement should occur.\n * @param {string} originalString - The original string to modify.\n * @param {string} replaceTo - The string to insert at the specified index.\n * @returns {string} The modified string with the replacement applied.\n * @example\n * replaceAt(3, \"hello\", \"X\");\n * // ➔ \"helXo\"\n * replaceAt(1, \"world\", \"AB\");\n * // ➔ \"wABrld\"\n * replaceAt(0, \"cat\", \"br\");\n * // ➔ \"brat\"\n * replaceAt(2, \"12345\", \"-\");\n * // ➔ \"12-45\"\n * replaceAt(4, \"ABCDE\", \"Z\");\n * // ➔ \"ABCDZ\"\n * // ❌ Examples that throw:\n * replaceAt(10, \"short\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(-1, \"test\", \"X\");\n * // ➔ ❌ RangeError: First parameter (`index`) is out of range from second parameter `originalString`.\n * replaceAt(\"1\", \"test\", \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n * replaceAt(2, null, \"X\");\n * // ➔ ❌ TypeError: First parameter `index` must be of type `number`, second parameter `originalString` and third parameter `replaceTo` must be of type `string`, but received: \"['index': `string`,...].\"\n */\nexport const replaceAt = (\n  index: number,\n  originalString: string,\n  replaceTo: string\n): string => {\n  if (!isNumber(index) || !isString(replaceTo) || !isString(originalString)) {\n    throw new TypeError(\n      `First parameter (\\`index\\`) must be of type \\`number\\`, second parameter (\\`originalString\\`) and third parameter (\\`replaceTo\\`) must be of type \\`string\\`, but received: \"['index': \\`${getPreciseType(\n        index\n      )}\\`, 'originalString': \\`${getPreciseType(\n        originalString\n      )}\\`, 'replaceTo': \\`${getPreciseType(replaceTo)}\\`]\".`\n    );\n  }\n\n  // Handle edge cases\n  if (index < 0 || index >= originalString.length) {\n    throw new RangeError(\n      \"First parameter (`index`) is out of range from second parameter (`originalString`).\"\n    );\n  }\n\n  return (\n    originalString.slice(0, index) + // Extract before the index\n    replaceTo + // Insert replacement\n    originalString.slice(index + 1) // Extract after replacement\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,mBACX,QACA,UAAkC;CAChC,mBAAmB;CACnB,MAAM;CACP,KACU;CACX,IAAI,CAAC,iBAAiB,OAAO,EAAE,OAAO;CAEtC,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,oBAAoB,QAAQ,sBAAsB;CAGxD,IAFa,QAAQ,SAAS,MAEpB,SAAS,OAAO,MAAM;CAEhC,QACG,OAAO,KAAK,OAAO,GAAG,aAAa,GAAG,OACtC,oBAAoB,OAAO,MAAM,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfxE,MAAa,mBACX,OACA,UAAkC;CAChC,gBAAgB;CAChB,MAAM;CACP,KACU;CACX,IAAI,CAAC,iBAAiB,MAAM,EAAE,OAAO;CAErC,IAAI,SAAS;CAEb,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;CAGd,MAAM,iBAAiB,QAAQ,mBAAmB;CAGlD,IAFa,QAAQ,SAAS,MAG5B,SAAS,OAAO,MAAM;CAGxB,IAAI,gBAAgB;EAClB,MAAM,gBAAgB,OAAO,MAAM,OAAO,GAAG,MAAM;EACnD,MAAM,iBAAiB,OAAO,MAAM,OAAO,GAAG,MAAM;EACpD,SAAS,OAAO,MAAM,CAAC,QAAQ,QAAQ,IAAI;EAC3C,SAAS,GAAG,gBAAgB,SAAS;;CAGvC,OAAO,OACJ,aAAa,CACb,MAAM,IAAI,CACV,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,IAAI;;;;;AC5Cd,SAAgB,cAAc,OAAgB;CAC5C,IAAI,CAAC,SAAS,MAAM,EAClB;CAGF,IAAI,cAAc,MAAM,EACtB,OAAO;CAQT,OAJiB,MAAM,QAAQ,2BAA2B,IAAI,CAAC,MAEvC,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3BhB,MAAa,mBAAmB,SAA4C;CAC1E,IAAI,CAAC,iBAAiB,KAAK,EAAE,OAAO;CAGpC,OAAO,KAAK,QAAQ,QAAQ,IAAI,CAAC,MAAM;CAEvC,MAAM,YAAY,KAAK,MAAM,IAAI;CAEjC,IAAI,UAAU,SAAS,GAAG;EACxB,IAAI,EAAE,UAAU,MAAM,UAAU,MAAM,UAAU,GAAG,KAAK,OAAO;EAG/D,QAAQ,UAAU,GAAG,KAAK,UAAU,GAAG,IAAI,aAAa;;CAG1D,OAAO,KAAK,SAAS,IACjB,KAAK,UAAU,GAAG,EAAE,CAAC,aAAa,GAEjC,KAAK,IAAI,aAAa,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACNjC,MAAa,aACX,OACA,gBACA,cACW;CACX,IAAI,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,eAAe,EACvE,MAAM,IAAI,UACR,4LAA4L,eAC1L,MACD,CAAC,0BAA0B,eAC1B,eACD,CAAC,qBAAqB,eAAe,UAAU,CAAC,OAClD;CAIH,IAAI,QAAQ,KAAK,SAAS,eAAe,QACvC,MAAM,IAAI,WACR,sFACD;CAGH,OACE,eAAe,MAAM,GAAG,MAAM,GAC9B,YACA,eAAe,MAAM,QAAQ,EAAE"}

package/dist/tailwind/index.cjs

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  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_tailwind = require('../tailwind-DJ4cmLUw.cjs');
+const require_tailwind = require('../tailwind-CHIx9uxu.cjs');
 exports.cnV3 = require_tailwind.cnV3;
 exports.cnV4 = require_tailwind.cnV4;
 exports.customCnV3 = require_tailwind.customCnV3;

package/dist/tailwind/index.d.cts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as customCnV4, c as ClassObject, d as cx, i as customCnV3, l as ClassValue, n as twMergeDefaultV3, o as cnV3, r as shouldForwardProp, s as cnV4, t as twMergeDefaultV4, u as ClassValues } from "../index-CpufydcI.cjs";
+import { a as customCnV4, c as ClassObject, d as cx, i as customCnV3, l as ClassValue, n as twMergeDefaultV3, o as cnV3, r as shouldForwardProp, s as cnV4, t as twMergeDefaultV4, u as ClassValues } from "../index-D4fcasfZ.cjs";
 export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };

package/dist/tailwind/index.d.ts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 
-import { a as customCnV4, c as ClassObject, d as cx, i as customCnV3, l as ClassValue, n as twMergeDefaultV3, o as cnV3, r as shouldForwardProp, s as cnV4, t as twMergeDefaultV4, u as ClassValues } from "../index-I4fAzwXV.js";
+import { a as customCnV4, c as ClassObject, d as cx, i as customCnV3, l as ClassValue, n as twMergeDefaultV3, o as cnV3, r as shouldForwardProp, s as cnV4, t as twMergeDefaultV4, u as ClassValues } from "../index-CoiUBVmr.js";
 export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };

package/dist/tailwind/index.js

@@ -2,10 +2,10 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { a as customCnV4, c as cx, i as customCnV3, n as cnV3, o as twMergeDefaultV4, r as cnV4, s as twMergeDefaultV3, t as shouldForwardProp } from "../tailwind-IJvOdkZp.js";
+import { a as customCnV4, c as cx, i as customCnV3, n as cnV3, o as twMergeDefaultV4, r as cnV4, s as twMergeDefaultV3, t as shouldForwardProp } from "../tailwind-B2ssevxq.js";
 export { cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };

package/dist/{tailwind-IJvOdkZp.js → tailwind-B2ssevxq.js}

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, M as isArray, O as isNumberObject, P as isFunction, b as hasOwnProp, g as isStringObject, h as isBooleanObject, k as isString, p as isNonEmptyArray, r as getPreciseType, w as isNumber, x as isObjectOrArray, y as isNonEmptyString } from "./assertIsBoolean-BlBct0Fc.js";
-import { t as assertIsArray } from "./assertIsArray-BfAbIUfa.js";
-import { t as isEmptyString } from "./isEmptyString-BTUWYTbw.js";
+import { A as isPlainObject, M as isArray, O as isNumberObject, P as isFunction, b as hasOwnProp, g as isStringObject, h as isBooleanObject, k as isString, p as isNonEmptyArray, r as getPreciseType, w as isNumber, x as isObjectOrArray, y as isNonEmptyString } from "./assertIsBoolean-DR1SaXPD.js";
+import { t as assertIsArray } from "./assertIsArray-bTA3XLjq.js";
+import { t as isEmptyString } from "./isEmptyString-BXzKAC2j.js";
 import { extendTailwindMerge, getDefaultConfig } from "tailwind-merge-v3";
 import { extendTailwindMerge as extendTailwindMerge$1, getDefaultConfig as getDefaultConfig$1 } from "tailwind-merge-v4";
 function toStringValue(value) {
@@ -196,4 +196,4 @@ const shouldForwardProp = (props) => {
 	};
 };
 export { customCnV4 as a, cx as c, customCnV3 as i, cnV3 as n, twMergeDefaultV4 as o, cnV4 as r, twMergeDefaultV3 as s, shouldForwardProp as t };
-//# sourceMappingURL=tailwind-IJvOdkZp.js.map
+//# sourceMappingURL=tailwind-B2ssevxq.js.map

package/dist/tailwind-B2ssevxq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-B2ssevxq.js","names":["defaultConfig","getDefaultConfig","extendTailwindMerge"],"sources":["../src/tailwind/class-names/cx.ts","../src/tailwind/tw-merge/_private/validate-props.ts","../src/tailwind/tw-merge/v3/twMergeDefault.ts","../src/tailwind/tw-merge/v4/twMergeDefault.ts","../src/tailwind/class-names/customCn.ts","../src/tailwind/class-names/cn.ts","../src/tailwind/tw-macro/shouldForwardProp.ts"],"sourcesContent":["import { isArray } from \"@/predicates/is/isArray\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isStringObject } from \"@/predicates/is/isStringObject\";\nimport { isNumberObject } from \"@/predicates/is/isNumberObject\";\nimport { isBooleanObject } from \"@/predicates/is/isBooleanObject\";\nimport { isObjectOrArray } from \"@/predicates/is/isObjectOrArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassValue`.***\n * ----------------------------------------------------------\n * **Represents a single valid value that can be converted to a CSS class string.**\n * @description\n * - Supports the following types:\n *    - `string` → literal class names (non-empty only)\n *    - `number | bigint` → numeric class names\n *    - `boolean` → only `true` is considered in objects/arrays\n *    - `null | undefined` → ignored\n *    - `ClassObject` → objects where **keys with truthy values** are included\n *    - `ClassValues` → arrays recursively flattened\n * - Used internally by ***`cx` utility function*** to process mixed input values.\n * @example\n * ```ts\n * const val1: ClassValue = \"button\";              // ➔ string\n * const val2: ClassValue = 0;                     // ➔ number\n * const val3: ClassValue = [\"a\", { b: true }];    // ➔ array with object\n * const val4: ClassValue = { d: true, e: false }; // ➔ object\n * const val5: ClassValue = new String(\"foo\");     // ➔ boxed string\n * const val6: ClassValue = new Number(\"123\");     // ➔ boxed number\n * const val7: ClassValue = new Boolean(\"true\");   // ➔ boxed boolean\n * ```\n */\nexport type ClassValue =\n  | ClassValues\n  | ClassObject\n  | string\n  | number\n  | bigint\n  | null\n  | boolean\n  | undefined;\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassObject`.***\n * ----------------------------------------------------------\n * **Represents an object whose keys with truthy values are included in the final class string.**\n * @example\n * ```ts\n * const obj: ClassObject = { \"text-red\": true, \"hidden\": false };\n * // ➔ \"text-red\" when processed by cx\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ClassObject = Record<string, any>;\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassValues`.***\n * ----------------------------------------------------------\n * **Represents an array of {@link ClassValue | `ClassValue's`}, potentially nested.**\n * @example\n * ```ts\n * const arr: ClassValues = [\n *   \"a\",\n *   1,\n *   [\"b\", { c: true, d: false }],\n *   { e: 2 }\n * ];\n * ```\n */\nexport type ClassValues = ClassValue[];\n\n/** ----------------------------------------------------------\n * * ***Utility: `toStringValue`.***\n * ----------------------------------------------------------\n * **Converts a `ClassValue` into a single space-separated string suitable for CSS class usage.**\n * @param {ClassValue} value The mixed value to process.\n * @returns {string} A string containing all valid class names.\n * @description\n * - Arrays are recursively flattened.\n * - Objects include only keys with truthy values.\n * - Skips `null`, `undefined`, and empty strings.\n * - Numbers, strings, and bigint are included as-is.\n * - Boolean `false` is ignored in objects/arrays.\n * - Boxed primitives (`new String()`, `new Number()`, `new Boolean()`) are supported.\n * - Preserves inherited object keys.\n * @example\n * ```ts\n * toStringValue(\"btn\"); // ➔ \"btn\"\n * toStringValue([\"a\", 0, \"b\"]); // ➔ \"a b\"\n * toStringValue({ a: true, b: false, c: 1 }); // ➔ \"a c\"\n * toStringValue([\"a\", [\"b\", { c: true, d: false }]]); // ➔ \"a b c\"\n * toStringValue(new String(\"foo\")); // ➔ \"foo\"\n * toStringValue(new Number(42));    // ➔ \"42\"\n * toStringValue(new Boolean(true)); // ➔ \"true\"\n * toStringValue(new Boolean(false));// ➔ \"\"\n * ```\n */\nfunction toStringValue(value: ClassValue): string {\n  let str = \"\";\n\n  if (isNonEmptyString(value) || isNumber(value)) {\n    str += value;\n  } else if (isObjectOrArray(value)) {\n    if (\n      isStringObject(value) ||\n      isNumberObject(value) ||\n      isBooleanObject(value)\n    ) {\n      const val = value.valueOf();\n      if (val) str += val; // skip falsy\n    } else if (isArray(value)) {\n      for (const item of value) {\n        if (!item) continue; // skip falsy\n        const y = toStringValue(item);\n        if (!y) continue;\n        if (str) str += \" \";\n        str += y;\n      }\n    } else {\n      for (const key in value) {\n        if (!value[key]) continue; // skip falsy\n        if (str) str += \" \";\n        str += key;\n      }\n    }\n  }\n\n  return str;\n}\n\n/** ----------------------------------------------------------\n * * ***Utility: `cx`.***\n * ----------------------------------------------------------\n * **Merge multiple class values into a single, space-separated string suitable for CSS usage.**\n * @description\n * - Supports **nested combinations** of arrays and objects, recursively.\n * - **Falsy values** are skipped:\n *   - `false`, `null`, `undefined`, empty strings `\"\"` are ignored anywhere.\n *   - Numbers `0` are ignored inside nested arrays/objects.\n * - **Boxed primitives** are correctly unwrapped to their primitive value.\n * - **Inherited object keys** are included in the final class string.\n * - Optimized for **CSS class merging** where conditional inclusion is common.\n * @param {ClassValues} values\n *   A list of mixed class values, which can include:\n *   - **Strings** → literal class names.\n *   - **Numbers** → numeric class names.\n *   - **BigInt** → numeric class names larger than JS safe integer limit.\n *   - **Arrays** → recursively flattened, can contain nested arrays or objects.\n *   - **Objects** → include keys whose values are truthy. Inherited keys are also included.\n *   - **Boxed primitives** (`new String()`, `new Number()`, `new Boolean()`) → automatically unwrapped.\n *   - **Falsy values** (`false`, `null`, `undefined`, `\"\"`, `0`) are ignored according to original behavior.\n * @returns {string}\n *   A single space-separated string containing all valid class names.\n * @example\n * ```ts\n * // Basic string merge\n * cx(\"btn\", \"btn-primary\");\n * // ➔ \"btn btn-primary\"\n *\n * // Mixed arrays and objects\n * cx(\"a\", [\"b\", { c: true, d: false }], { e: 1, f: 0 }, null, 2);\n * // ➔ \"a b c e 2\"\n *\n * // Empty and falsy values are ignored\n * cx(\"\", null, undefined, false, 0);\n * // ➔ \"\"\n *\n * // Nested arrays with objects\n * cx([\"a\", [\"b\", { c: true, d: false }]]);\n * // ➔ \"a b c\"\n *\n * // Boxed primitives are unwrapped\n * cx(new String(\"foo\"), new Number(42), new Boolean(true), new Number(0), new Boolean(false));\n * // ➔ \"foo 42 true\"\n *\n * // Inherited keys from objects are included\n * const proto = { inherited: true };\n * const obj = Object.create(proto);\n * obj.own = true;\n * cx(obj);\n * // ➔ \"own inherited\"\n * ```\n */\nexport function cx(...values: ClassValues): string {\n  let str = \"\";\n\n  for (const value of values) {\n    if (!value) continue; // skip falsy arguments\n    const x = toStringValue(value);\n    if (!x) continue;\n    if (str) str += \" \";\n    str += x;\n  }\n\n  return str;\n}\n","import type { Config as TwConfig } from \"tailwindcss\";\nimport type { ConfigExtension } from \"tailwind-merge-v4\";\n\nimport type { OptionsMergeTwClsV4 } from \"../v4/_private/types\";\n\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\n\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nexport type TailwindConfig = TwConfig;\n\n/**\n * @internal\n */\ntype TwMergeConfigExt = ConfigExtension<string, string>;\n\n/**\n * @internal\n */\ntype ValidatorTwMergeReturn = {\n  config: TwConfig;\n  override: TwMergeConfigExt[\"override\"];\n  cacheSize: TwMergeConfigExt[\"cacheSize\"];\n  prefix: TwMergeConfigExt[\"prefix\"];\n  experimentalParseClassName?: TwMergeConfigExt[\"experimentalParseClassName\"];\n  theme: NonNullable<NonNullable<TwMergeConfigExt[\"extend\"]>[\"theme\"]>;\n  classGroups: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"classGroups\"]\n  >;\n  conflictingClassGroupModifiers: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"conflictingClassGroupModifiers\"]\n  >;\n  conflictingClassGroups: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"conflictingClassGroups\"]\n  >;\n  orderSensitiveModifiers: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"orderSensitiveModifiers\"]\n  >;\n};\n\n/**\n * @internal\n */\nexport const validatorPropsTwMerge = (\n  options: OptionsMergeTwClsV4\n): ValidatorTwMergeReturn => {\n  if (!isPlainObject(options)) options = {};\n  let {\n    config,\n    prefix,\n    extend,\n    override,\n    cacheSize,\n    experimentalParseClassName\n  } = options;\n\n  if (!isPlainObject(config)) config = {};\n  if (!isPlainObject(extend)) extend = {};\n  if (!isPlainObject(override)) override = {};\n  if (!isNumber(cacheSize)) cacheSize = undefined;\n  if (!isNonEmptyString(prefix)) prefix = undefined;\n  if (!isFunction(experimentalParseClassName))\n    experimentalParseClassName = undefined;\n\n  const theme = hasOwnProp(extend, \"theme\") ? extend.theme : {};\n  const classGroups = hasOwnProp(extend, \"classGroups\")\n    ? extend.classGroups\n    : {};\n  const conflictingClassGroupModifiers = hasOwnProp(\n    extend,\n    \"conflictingClassGroupModifiers\"\n  )\n    ? extend.conflictingClassGroupModifiers\n    : {};\n\n  const conflictingClassGroups = hasOwnProp(extend, \"conflictingClassGroups\")\n    ? extend.conflictingClassGroups\n    : {};\n  const orderSensitiveModifiers =\n    hasOwnProp(extend, \"orderSensitiveModifiers\") &&\n    isNonEmptyArray(extend.orderSensitiveModifiers)\n      ? extend.orderSensitiveModifiers\n      : [];\n\n  return {\n    config,\n    override,\n    cacheSize,\n    prefix,\n    experimentalParseClassName,\n    theme,\n    classGroups,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    orderSensitiveModifiers\n  };\n};\n","import type { OptionsMergeTwClsV3, TwMergeDefaultFnV3 } from \"./_private/types\";\n\nimport { extendTailwindMerge, getDefaultConfig } from \"tailwind-merge-v3\";\n\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { validatorPropsTwMerge } from \"../_private/validate-props\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 3 with extended rules.***\n * -------------------------------------------------------------\n * **Wraps ***`extendTailwindMerge` from tailwind-merge-v3*** with Tailwind’s default\n * config (_*`getDefaultConfig()` from tailwind-merge-v3*_) to create a **project-ready `twMerge`**.**\n * - 🔑 **When to use it?**\n *    - Your project uses **Tailwind v3**.\n *    - Extend **class groups** (e.g. add `text-shadow`).\n *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).\n *    - Override or fine-tune **merge behavior**.\n *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.\n * @param {OptionsMergeTwClsV3} [options={}]\n * ***Merge options:***\n *    - `config` – Your Tailwind config (from `tailwind.config.ts`).\n *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).\n *    - `extend` – Extra merge rules (classGroups, theme, etc).\n *    - `override` – Fully replace rules.\n *    - `cacheSize` – Parsed class cache size.\n *    - `experimentalParseClassName` – Custom classname parser.\n * @returns {TwMergeDefaultFnV3}\n * Customized Tailwind class merge function version 3 (same signature as `twMerge`).\n * @example\n * #### Example 1: ***Default behavior (same as tailwind-merge).***\n * ```ts\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge = twMergeDefaultV3();\n * twMerge(\"p-2 p-4\");\n * // ➔ \"p-4\"\n * ```\n * #### Example 2: ***Extend class groups.***\n * ```ts\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge2 = twMergeDefaultV3({\n *   extend: {\n *     classGroups: {\n *       shadow: [\"shadow-soft\", \"shadow-hard\"],\n *     },\n *   },\n * });\n * twMerge2(\"shadow-soft shadow-hard\");\n * // ➔ \"shadow-hard\"\n * ```\n * #### Example 3: ***Respect your Tailwind config.***\n * ```ts\n * import config from \"../tailwind.config\";\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge3 = twMergeDefaultV3({ config });\n * twMerge3(\"text-base text-xxs\");\n * // ➔ \"text-xxs\" (resolved from config)\n * ```\n * #### Example 4: ***Project-wide helper (recommended).***\n * ```ts\n * import configTwCss from \"../tailwind.config\";\n * import { customCnV3, twMergeDefaultV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const customTwMerge = twMergeDefaultV3({\n *   config: configTwCss,\n *   extend: {\n *     classGroups: { shadow: [\"shadow-soft\", \"shadow-hard\"] },\n *   },\n * });\n *\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(customTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2 p-4\");                 // ➔ \"p-4\"\n * cnApp(\"shadow-soft shadow-hard\"); // ➔ \"shadow-hard\"\n * cnApp(\"text-base text-xxs\");      // ➔ \"text-xxs\" (uses config)\n *\n * // ⚡ Difference with package-level `cn`\n * import { cnV3, cnV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * cnV3(\"text-base text-xxs\");\n * // or\n * cnV4(\"text-base text-xxs\");\n * // ➔ \"text-base\"  (❌ doesn't know about your config)\n *\n * cnApp(\"text-base text-xxs\");\n * // ➔ \"text-xxs\"  (✅ respects config)\n * ```\n */\nexport const twMergeDefaultV3 = (\n  options: OptionsMergeTwClsV3 = {}\n): TwMergeDefaultFnV3 => {\n  if (!isPlainObject(options)) options = {};\n  const {\n    cacheSize,\n    classGroups,\n    config,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    override,\n    prefix,\n    theme,\n    experimentalParseClassName\n  } = validatorPropsTwMerge(options);\n\n  return extendTailwindMerge<string, string>({\n    prefix: prefix ?? config.prefix,\n    cacheSize: cacheSize || defaultConfig.cacheSize,\n    experimentalParseClassName,\n    override,\n    extend: {\n      conflictingClassGroupModifiers: {\n        ...defaultConfig.conflictingClassGroupModifiers,\n        ...conflictingClassGroupModifiers\n      },\n      theme: { ...defaultConfig.theme, ...theme },\n      conflictingClassGroups: {\n        ...defaultConfig.conflictingClassGroups,\n        ...conflictingClassGroups\n      },\n      classGroups: {\n        ...defaultConfig.classGroups,\n        ...classGroups,\n\n        \"text-shadow\": [\n          \"\",\n          \"-sm\",\n          \"-md\",\n          \"-lg\",\n          \"-xl\",\n          \"-xxl\",\n          \"-none\",\n          \"-default\"\n        ].map((size) => `text-shadow${size}`),\n        \"font-size\": Object.keys({\n          ...(config.theme?.fontSize || {}),\n          ...(config.theme?.extend?.fontSize || {})\n        }).map((size) => `text-${size}`)\n      }\n    }\n  });\n};\n","import type { OptionsMergeTwClsV4, TwMergeDefaultFnV4 } from \"./_private/types\";\n\nimport { extendTailwindMerge, getDefaultConfig } from \"tailwind-merge-v4\";\n\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { validatorPropsTwMerge } from \"../_private/validate-props\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 4 with extended rules.***\n * -------------------------------------------------------------\n * **Wraps ***`extendTailwindMerge` from tailwind-merge-v4*** with Tailwind’s default\n * config (_*`getDefaultConfig()` from tailwind-merge-v4*_) to create a **project-ready `twMerge`**.**\n * - 🔑 **When to use it?**\n *    - Your project uses **Tailwind v4**.\n *    - Extend **class groups** (e.g. add `text-shadow`).\n *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).\n *    - Override or fine-tune **merge behavior**.\n *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.\n * @param {OptionsMergeTwClsV4} [options={}]\n *  ***Merge options:***\n *    - `config` – Your Tailwind config (from `tailwind.config.ts`).\n *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).\n *    - `extend` – Extra merge rules (classGroups, theme, etc).\n *    - `override` – Fully replace rules.\n *    - `cacheSize` – Parsed class cache size.\n *    - `experimentalParseClassName` – Custom classname parser.\n * @returns {TwMergeDefaultFnV4}\n * Customized Tailwind class merge function version 4 (same signature as `twMerge`).\n * @example\n * #### Example 1: ***Default behavior (same as tailwind-merge).***\n * ```ts\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge = twMergeDefaultV4();\n * twMerge(\"p-2 p-4\");\n * // ➔ \"p-4\"\n * ```\n * #### Example 2: ***Extend class groups.***\n * ```ts\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge2 = twMergeDefaultV4({\n *   extend: {\n *     classGroups: {\n *       shadow: [\"shadow-soft\", \"shadow-hard\"],\n *     },\n *   },\n * });\n * twMerge2(\"shadow-soft shadow-hard\");\n * // ➔ \"shadow-hard\"\n * ```\n * #### Example 3: ***Respect your Tailwind config.***\n * ```ts\n * import config from \"../tailwind.config\";\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge3 = twMergeDefaultV4({ config });\n * twMerge3(\"text-base text-xxs\");\n * // ➔ \"text-xxs\" (resolved from config)\n * ```\n * #### Example 4: ***Project-wide helper (recommended).***\n * ```ts\n * import configTwCss from \"../tailwind.config\";\n * import { customCnV4, twMergeDefaultV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const customTwMerge = twMergeDefaultV4({\n *   config: configTwCss,\n *   extend: {\n *     classGroups: { shadow: [\"shadow-soft\", \"shadow-hard\"] },\n *   },\n * });\n *\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(customTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2 p-4\");                 // ➔ \"p-4\"\n * cnApp(\"shadow-soft shadow-hard\"); // ➔ \"shadow-hard\"\n * cnApp(\"text-base text-xxs\");      // ➔ \"text-xxs\" (uses config)\n *\n * // ⚡ Difference with package-level `cn`\n * import { cnV3, cnV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * cnV3(\"text-base text-xxs\");\n * // or\n * cnV4(\"text-base text-xxs\");\n * // ➔ \"text-base\"  (❌ doesn't know about your config)\n *\n * cnApp(\"text-base text-xxs\");\n * // ➔ \"text-xxs\"  (✅ respects config)\n * ```\n */\nexport const twMergeDefaultV4 = (\n  options: OptionsMergeTwClsV4 = {}\n): TwMergeDefaultFnV4 => {\n  if (!isPlainObject(options)) options = {};\n  const {\n    cacheSize,\n    classGroups,\n    config,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    orderSensitiveModifiers,\n    override,\n    prefix,\n    theme,\n    experimentalParseClassName\n  } = validatorPropsTwMerge(options);\n\n  return extendTailwindMerge<string, string>({\n    prefix: prefix || config.prefix,\n    cacheSize: cacheSize || defaultConfig.cacheSize,\n    experimentalParseClassName,\n    override,\n    extend: {\n      conflictingClassGroupModifiers: {\n        ...defaultConfig.conflictingClassGroupModifiers,\n        ...conflictingClassGroupModifiers\n      },\n      theme: { ...defaultConfig.theme, ...theme },\n      conflictingClassGroups: {\n        ...defaultConfig.conflictingClassGroups,\n        ...conflictingClassGroups\n      },\n      orderSensitiveModifiers: [\n        ...defaultConfig.orderSensitiveModifiers,\n        ...orderSensitiveModifiers\n      ],\n      classGroups: {\n        ...defaultConfig.classGroups,\n        ...classGroups,\n\n        \"text-shadow\": [\n          \"\",\n          \"-sm\",\n          \"-md\",\n          \"-lg\",\n          \"-xl\",\n          \"-xxl\",\n          \"-none\",\n          \"-default\"\n        ].map((size) => `text-shadow${size}`),\n        \"font-size\": Object.keys({\n          ...(config.theme?.fontSize || {}),\n          ...(config.theme?.extend?.fontSize || {})\n        }).map((size) => `text-${size}`)\n      }\n    }\n  });\n};\n","import type { TwMergeDefaultFnV3 } from \"../tw-merge/v3/_private/types\";\nimport type { TwMergeDefaultFnV4 } from \"../tw-merge/v4/_private/types\";\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { twMergeDefaultV3 } from \"../tw-merge/v3/twMergeDefault\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { twMergeDefaultV4 } from \"../tw-merge/v4/twMergeDefault\";\n\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { cx, type ClassValues } from \"./cx\";\n\nexport type { ClassValues };\n\n/** -------------------------------------------------------------\n * * ***Factory utility for building a custom `cn` helper (Tailwind `v3`).***\n * -------------------------------------------------------------\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV3 | `twMergeDefaultV3`}).**\n * - 🔑 **When to use it?**\n *      - Your project uses **Tailwind v3**.\n *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).\n *      - You need multiple `cn*` variants across apps/packages.\n * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeDefaultV3 | `twMergeDefaultV3`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV3, customCnV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create a custom merge function\n * const myCustomTwMerge = twMergeDefaultV3({\n *   config: tailwindConfig,\n *   extend: {\n *     classGroups: {\n *       \"text-shadow\": [\"text-shadow\", \"text-shadow-sm\", \"text-shadow-md\"],\n *     },\n *   },\n * });\n *\n * // 2. Build your helper using `customCnV3`\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(myCustomTwMerge, ...classes);\n * };\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");     // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const customCnV3 = (\n  customTwMergeV3: TwMergeDefaultFnV3,\n  ...classes: ClassValues\n): string => {\n  if (!isFunction(customTwMergeV3)) {\n    throw new TypeError(\n      `first Parameter (\\`customTwMergeV3\\`) must be of type \\`function\\`, but received: \\`${getPreciseType(\n        customTwMergeV3\n      )}\\`.`\n    );\n  }\n\n  return customTwMergeV3(cx(...classes));\n};\n\n/** -------------------------------------------------------------\n * * ***Factory utility for building a custom `cn` helper (Tailwind `v4`).***\n * -------------------------------------------------------------\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV4 | `twMergeDefaultV4`}).**\n * - 🔑 **When to use it?**\n *      - Your project uses **Tailwind v4**.\n *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).\n *      - You need multiple `cn*` variants across apps/packages.\n * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeDefaultV4 | `twMergeDefaultV4`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV4, customCnV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create a custom merge function\n * const myCustomTwMerge = twMergeDefaultV4({\n *   config: tailwindConfig,\n *   extend: {\n *     classGroups: {\n *       \"text-shadow\": [\"text-shadow\", \"text-shadow-sm\", \"text-shadow-md\"],\n *     },\n *   },\n * });\n *\n * // 2. Build your helper using `customCnV4`\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(myCustomTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");     // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const customCnV4 = (\n  customTwMergeV4: TwMergeDefaultFnV4,\n  ...classes: ClassValues\n): string => {\n  if (!isFunction(customTwMergeV4)) {\n    throw new TypeError(\n      `first Parameter (\\`customTwMergeV4\\`) must be of type \\`function\\`, but received: \\`${getPreciseType(\n        customTwMergeV4\n      )}\\`.`\n    );\n  }\n\n  return customTwMergeV4(cx(...classes));\n};\n","import type { ClassValues } from \"./cx\";\n\nimport { cx } from \"./cx\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { customCnV3, customCnV4 } from \"./customCn\";\nimport { twMergeDefaultV3 } from \"../tw-merge/v3/twMergeDefault\";\nimport { twMergeDefaultV4 } from \"../tw-merge/v4/twMergeDefault\";\n\nconst defaultTwMergeV3 = twMergeDefaultV3();\nconst defaultTwMergeV4 = twMergeDefaultV4();\n\n/** -------------------------------------------------------------\n * * ***Default `cnV3` utility (Tailwind v3).***\n * -------------------------------------------------------------\n * **Combines class-name values and then deduplicates/resolves\n * conflicts using {@link twMergeDefaultV3 | `twMergeDefaultV3`}\n * with **Tailwind v3 default config only**.**\n * - ✅ **Use this when:**\n *    - Your project uses **Tailwind v3**.\n *    - You need a simple `cn` that works out of the box without a custom config.\n * - ⚡ **Need custom rules?**\n *    - Create a project-wide helper using\n *      {@link twMergeDefaultV3 | `twMergeDefaultV3`} +\n *      {@link customCnV3 | `customCnV3`} (see Example 2).\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * #### Example 1: ✅ Default usage (Tailwind v3).\n * ```ts\n * cnV3(\"p-2\", \"p-4\");\n * // ➔ \"p-4\"\n *\n * cnV3(\"text-red-500\", { \"text-blue-500\": true });\n * // ➔ \"text-blue-500\"\n *\n * cnV3([\"m-2\", [\"m-4\"]], \"m-8\");\n * // ➔ \"m-8\"\n * ```\n * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV3, customCnV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(\n *     twMergeDefaultV3({\n *       config: tailwindConfig,\n *       extend: {\n *         classGroups: {\n *           \"text-shadow\": [\n *             \"text-shadow\",\n *             \"text-shadow-sm\",\n *             \"text-shadow-md\",\n *           ],\n *         },\n *       },\n *     }),\n *     // ...other options classes,\n *   );\n * };\n *\n * cnApp(\"p-2 p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\"); // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");  // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const cnV3 = (...classes: ClassValues): string => {\n  return defaultTwMergeV3(cx(...classes));\n};\n\n/** -------------------------------------------------------------\n * * ***Default `cnV4` utility (Tailwind v4).***\n * -------------------------------------------------------------\n * **Combines class-name values and then deduplicates/resolves\n * conflicts using {@link twMergeDefaultV4 | `twMergeDefaultV4`}\n * with **Tailwind v4 default config only**.**\n * - ✅ **Use this when:**\n *    - Your project uses **Tailwind v4**.\n *    - You need a simple `cn` that works out of the box without a custom config.\n * - ⚡ **Need custom rules?**\n *    - Create a project-wide helper using\n *      {@link twMergeDefaultV4 | `twMergeDefaultV4`} +\n *      {@link customCnV4 | `customCnV4`} (see Example 2).\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * #### Example 1: ✅ Default usage (Tailwind v4).\n * ```ts\n * cnV4(\"p-2\", \"p-4\");\n * // ➔ \"p-4\"\n *\n * cnV4(\"text-red-500\", { \"text-blue-500\": true });\n * // ➔ \"text-blue-500\"\n *\n * cnV4([\"m-2\", [\"m-4\"]], \"m-8\");\n * // ➔ \"m-8\"\n * ```\n * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV4, customCnV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(\n *     twMergeDefaultV4({\n *       config: tailwindConfig,\n *       extend: {\n *         classGroups: {\n *           \"text-shadow\": [\n *             \"text-shadow\",\n *             \"text-shadow-sm\",\n *             \"text-shadow-md\",\n *           ],\n *         },\n *       },\n *     }),\n *     // ...other options classes,\n *   );\n * };\n *\n * cnApp(\"p-2 p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\"); // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");  // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const cnV4 = (...classes: ClassValues): string => {\n  return defaultTwMergeV4(cx(...classes));\n};\n","import type { Stringify } from \"@rzl-zone/ts-types-plus\";\n\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `shouldForwardProp`.***\n * ----------------------------------------------------------\n * **Creates a helper for styled-components `shouldForwardProp`.**\n *\n * @description\n * 1. Returns a **predicate function** that determines whether a given prop\n * should be forwarded to the DOM.\n * 2. Useful for filtering out internal props (e.g., `$size`, `$active`)\n * so they don't become invalid HTML attributes.\n *\n * - **Behavior:**\n *    - Accepts a strict tuple of **string keys** to exclude from forwarding.\n *    - Every key is validated as a **non-empty string** at runtime.\n *    - Throws a `TypeError` if:\n *      - `props` is not an array, or\n *      - any item is not a non-empty string.\n *    - Automatically coerces the tested prop name to string for matching.\n *\n * @template CustomProps\n *   The component props type to validate against.\n *\n * @param {readonly Stringify<keyof CustomProps>[]}\n *   props\n *   The list of prop names (keys of `CustomProps`) to exclude from forwarding.\n *\n * @returns {(propName: keyof CustomProps | ({} & string)) => boolean}\n *   A function that receives a prop name and returns:\n *   - `true`  ➔ the prop **will** be forwarded to the DOM.\n *   - `false` ➔ the prop **will not** be forwarded.\n *\n * @throws **{@link TypeError | `TypeError`}**\n *   when:\n *   - `props` is not an array, or\n *   - any item is not a non-empty string.\n *\n * @example\n * // Basic usage\n * type Props = { $size: string; color: string; visible: boolean };\n * const filter = shouldForwardProp<Props>([\"$size\"]);\n *\n * filter(\"$size\");   // ➔ false (blocked).\n * filter(\"color\");   // ➔ true  (forwarded).\n * filter(\"visible\"); // ➔ true  (forwarded).\n *\n * @example\n * // With styled-components\n * type CustomProps = { $internal: boolean; public: string; another: boolean };\n *\n * styled.div.withConfig({\n *   shouldForwardProp: shouldForwardProp<CustomProps>([\"$internal\"])\n * });\n */\nexport const shouldForwardProp = <CustomProps extends Record<string, unknown>>(\n  props: readonly Stringify<keyof CustomProps>[]\n  // props: Partial<UnionToTupleStrict<keyof CustomProps>>\n): ((propName: keyof CustomProps | ({} & string)) => boolean) => {\n  assertIsArray(props, {\n    message: ({ currentType, validType }) =>\n      `First parameter (\\`props\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const invalidItems: { index: number; reason: string }[] = [];\n\n  props.forEach((p, idx) => {\n    if (!isString(p)) {\n      invalidItems.push({\n        index: idx,\n        reason: `Expected a non-empty string, but received ${getPreciseType(p, {\n          formatCase: \"toPascalCaseSpace\"\n        })}.`\n      });\n    } else if (isEmptyString(p)) {\n      invalidItems.push({\n        index: idx,\n        reason: \"Expected a non-empty string, but received EmptyString.\"\n      });\n    }\n  });\n\n  if (isNonEmptyArray(invalidItems)) {\n    const maxWidth = Math.max(\n      ...invalidItems.map((item) => String(item.index).length)\n    );\n\n    const details = invalidItems\n      .map(\n        (item) =>\n          `• [Index ${String(item.index).padStart(maxWidth, \"0\")}] ${item.reason}`\n      )\n      .join(\"\\n\");\n\n    throw new TypeError(\n      `First parameter (\\`props\\`) contains invalid entries:\\n${details}`\n    );\n  }\n\n  return (propName): boolean => {\n    return !props.map(String).includes(String(propName));\n  };\n};\n"],"mappings":"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"}

package/dist/{tailwind-DJ4cmLUw.cjs → tailwind-CHIx9uxu.cjs}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
-const require_assertIsBoolean = require('./assertIsBoolean-DozdtbNi.cjs');
-const require_assertIsArray = require('./assertIsArray-BChqwPiP.cjs');
-const require_isEmptyString = require('./isEmptyString-CCK3bP74.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-C8WEXVr2.cjs');
+const require_assertIsArray = require('./assertIsArray-DJXkjHZs.cjs');
+const require_isEmptyString = require('./isEmptyString-UiiUsSQj.cjs');
 let tailwind_merge_v3 = require("tailwind-merge-v3");
 let tailwind_merge_v4 = require("tailwind-merge-v4");
 function toStringValue(value) {
@@ -244,4 +244,4 @@ Object.defineProperty(exports, 'twMergeDefaultV4', {
     return twMergeDefaultV4;
   }
 });
-//# sourceMappingURL=tailwind-DJ4cmLUw.cjs.map
+//# sourceMappingURL=tailwind-CHIx9uxu.cjs.map

package/dist/tailwind-CHIx9uxu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-CHIx9uxu.cjs","names":["isNonEmptyString","isNumber","isObjectOrArray","isStringObject","isNumberObject","isBooleanObject","isArray","isPlainObject","isNumber","isNonEmptyString","isFunction","hasOwnProp","isNonEmptyArray","defaultConfig","isPlainObject","isPlainObject","isFunction","getPreciseType","isString","getPreciseType","isEmptyString","isNonEmptyArray"],"sources":["../src/tailwind/class-names/cx.ts","../src/tailwind/tw-merge/_private/validate-props.ts","../src/tailwind/tw-merge/v3/twMergeDefault.ts","../src/tailwind/tw-merge/v4/twMergeDefault.ts","../src/tailwind/class-names/customCn.ts","../src/tailwind/class-names/cn.ts","../src/tailwind/tw-macro/shouldForwardProp.ts"],"sourcesContent":["import { isArray } from \"@/predicates/is/isArray\";\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isStringObject } from \"@/predicates/is/isStringObject\";\nimport { isNumberObject } from \"@/predicates/is/isNumberObject\";\nimport { isBooleanObject } from \"@/predicates/is/isBooleanObject\";\nimport { isObjectOrArray } from \"@/predicates/is/isObjectOrArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassValue`.***\n * ----------------------------------------------------------\n * **Represents a single valid value that can be converted to a CSS class string.**\n * @description\n * - Supports the following types:\n *    - `string` → literal class names (non-empty only)\n *    - `number | bigint` → numeric class names\n *    - `boolean` → only `true` is considered in objects/arrays\n *    - `null | undefined` → ignored\n *    - `ClassObject` → objects where **keys with truthy values** are included\n *    - `ClassValues` → arrays recursively flattened\n * - Used internally by ***`cx` utility function*** to process mixed input values.\n * @example\n * ```ts\n * const val1: ClassValue = \"button\";              // ➔ string\n * const val2: ClassValue = 0;                     // ➔ number\n * const val3: ClassValue = [\"a\", { b: true }];    // ➔ array with object\n * const val4: ClassValue = { d: true, e: false }; // ➔ object\n * const val5: ClassValue = new String(\"foo\");     // ➔ boxed string\n * const val6: ClassValue = new Number(\"123\");     // ➔ boxed number\n * const val7: ClassValue = new Boolean(\"true\");   // ➔ boxed boolean\n * ```\n */\nexport type ClassValue =\n  | ClassValues\n  | ClassObject\n  | string\n  | number\n  | bigint\n  | null\n  | boolean\n  | undefined;\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassObject`.***\n * ----------------------------------------------------------\n * **Represents an object whose keys with truthy values are included in the final class string.**\n * @example\n * ```ts\n * const obj: ClassObject = { \"text-red\": true, \"hidden\": false };\n * // ➔ \"text-red\" when processed by cx\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ClassObject = Record<string, any>;\n\n/** ----------------------------------------------------------\n * * ***Type-Utility: `ClassValues`.***\n * ----------------------------------------------------------\n * **Represents an array of {@link ClassValue | `ClassValue's`}, potentially nested.**\n * @example\n * ```ts\n * const arr: ClassValues = [\n *   \"a\",\n *   1,\n *   [\"b\", { c: true, d: false }],\n *   { e: 2 }\n * ];\n * ```\n */\nexport type ClassValues = ClassValue[];\n\n/** ----------------------------------------------------------\n * * ***Utility: `toStringValue`.***\n * ----------------------------------------------------------\n * **Converts a `ClassValue` into a single space-separated string suitable for CSS class usage.**\n * @param {ClassValue} value The mixed value to process.\n * @returns {string} A string containing all valid class names.\n * @description\n * - Arrays are recursively flattened.\n * - Objects include only keys with truthy values.\n * - Skips `null`, `undefined`, and empty strings.\n * - Numbers, strings, and bigint are included as-is.\n * - Boolean `false` is ignored in objects/arrays.\n * - Boxed primitives (`new String()`, `new Number()`, `new Boolean()`) are supported.\n * - Preserves inherited object keys.\n * @example\n * ```ts\n * toStringValue(\"btn\"); // ➔ \"btn\"\n * toStringValue([\"a\", 0, \"b\"]); // ➔ \"a b\"\n * toStringValue({ a: true, b: false, c: 1 }); // ➔ \"a c\"\n * toStringValue([\"a\", [\"b\", { c: true, d: false }]]); // ➔ \"a b c\"\n * toStringValue(new String(\"foo\")); // ➔ \"foo\"\n * toStringValue(new Number(42));    // ➔ \"42\"\n * toStringValue(new Boolean(true)); // ➔ \"true\"\n * toStringValue(new Boolean(false));// ➔ \"\"\n * ```\n */\nfunction toStringValue(value: ClassValue): string {\n  let str = \"\";\n\n  if (isNonEmptyString(value) || isNumber(value)) {\n    str += value;\n  } else if (isObjectOrArray(value)) {\n    if (\n      isStringObject(value) ||\n      isNumberObject(value) ||\n      isBooleanObject(value)\n    ) {\n      const val = value.valueOf();\n      if (val) str += val; // skip falsy\n    } else if (isArray(value)) {\n      for (const item of value) {\n        if (!item) continue; // skip falsy\n        const y = toStringValue(item);\n        if (!y) continue;\n        if (str) str += \" \";\n        str += y;\n      }\n    } else {\n      for (const key in value) {\n        if (!value[key]) continue; // skip falsy\n        if (str) str += \" \";\n        str += key;\n      }\n    }\n  }\n\n  return str;\n}\n\n/** ----------------------------------------------------------\n * * ***Utility: `cx`.***\n * ----------------------------------------------------------\n * **Merge multiple class values into a single, space-separated string suitable for CSS usage.**\n * @description\n * - Supports **nested combinations** of arrays and objects, recursively.\n * - **Falsy values** are skipped:\n *   - `false`, `null`, `undefined`, empty strings `\"\"` are ignored anywhere.\n *   - Numbers `0` are ignored inside nested arrays/objects.\n * - **Boxed primitives** are correctly unwrapped to their primitive value.\n * - **Inherited object keys** are included in the final class string.\n * - Optimized for **CSS class merging** where conditional inclusion is common.\n * @param {ClassValues} values\n *   A list of mixed class values, which can include:\n *   - **Strings** → literal class names.\n *   - **Numbers** → numeric class names.\n *   - **BigInt** → numeric class names larger than JS safe integer limit.\n *   - **Arrays** → recursively flattened, can contain nested arrays or objects.\n *   - **Objects** → include keys whose values are truthy. Inherited keys are also included.\n *   - **Boxed primitives** (`new String()`, `new Number()`, `new Boolean()`) → automatically unwrapped.\n *   - **Falsy values** (`false`, `null`, `undefined`, `\"\"`, `0`) are ignored according to original behavior.\n * @returns {string}\n *   A single space-separated string containing all valid class names.\n * @example\n * ```ts\n * // Basic string merge\n * cx(\"btn\", \"btn-primary\");\n * // ➔ \"btn btn-primary\"\n *\n * // Mixed arrays and objects\n * cx(\"a\", [\"b\", { c: true, d: false }], { e: 1, f: 0 }, null, 2);\n * // ➔ \"a b c e 2\"\n *\n * // Empty and falsy values are ignored\n * cx(\"\", null, undefined, false, 0);\n * // ➔ \"\"\n *\n * // Nested arrays with objects\n * cx([\"a\", [\"b\", { c: true, d: false }]]);\n * // ➔ \"a b c\"\n *\n * // Boxed primitives are unwrapped\n * cx(new String(\"foo\"), new Number(42), new Boolean(true), new Number(0), new Boolean(false));\n * // ➔ \"foo 42 true\"\n *\n * // Inherited keys from objects are included\n * const proto = { inherited: true };\n * const obj = Object.create(proto);\n * obj.own = true;\n * cx(obj);\n * // ➔ \"own inherited\"\n * ```\n */\nexport function cx(...values: ClassValues): string {\n  let str = \"\";\n\n  for (const value of values) {\n    if (!value) continue; // skip falsy arguments\n    const x = toStringValue(value);\n    if (!x) continue;\n    if (str) str += \" \";\n    str += x;\n  }\n\n  return str;\n}\n","import type { Config as TwConfig } from \"tailwindcss\";\nimport type { ConfigExtension } from \"tailwind-merge-v4\";\n\nimport type { OptionsMergeTwClsV4 } from \"../v4/_private/types\";\n\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\n\nimport { isNumber } from \"@/predicates/is/isNumber\";\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\n\nexport type TailwindConfig = TwConfig;\n\n/**\n * @internal\n */\ntype TwMergeConfigExt = ConfigExtension<string, string>;\n\n/**\n * @internal\n */\ntype ValidatorTwMergeReturn = {\n  config: TwConfig;\n  override: TwMergeConfigExt[\"override\"];\n  cacheSize: TwMergeConfigExt[\"cacheSize\"];\n  prefix: TwMergeConfigExt[\"prefix\"];\n  experimentalParseClassName?: TwMergeConfigExt[\"experimentalParseClassName\"];\n  theme: NonNullable<NonNullable<TwMergeConfigExt[\"extend\"]>[\"theme\"]>;\n  classGroups: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"classGroups\"]\n  >;\n  conflictingClassGroupModifiers: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"conflictingClassGroupModifiers\"]\n  >;\n  conflictingClassGroups: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"conflictingClassGroups\"]\n  >;\n  orderSensitiveModifiers: NonNullable<\n    NonNullable<TwMergeConfigExt[\"extend\"]>[\"orderSensitiveModifiers\"]\n  >;\n};\n\n/**\n * @internal\n */\nexport const validatorPropsTwMerge = (\n  options: OptionsMergeTwClsV4\n): ValidatorTwMergeReturn => {\n  if (!isPlainObject(options)) options = {};\n  let {\n    config,\n    prefix,\n    extend,\n    override,\n    cacheSize,\n    experimentalParseClassName\n  } = options;\n\n  if (!isPlainObject(config)) config = {};\n  if (!isPlainObject(extend)) extend = {};\n  if (!isPlainObject(override)) override = {};\n  if (!isNumber(cacheSize)) cacheSize = undefined;\n  if (!isNonEmptyString(prefix)) prefix = undefined;\n  if (!isFunction(experimentalParseClassName))\n    experimentalParseClassName = undefined;\n\n  const theme = hasOwnProp(extend, \"theme\") ? extend.theme : {};\n  const classGroups = hasOwnProp(extend, \"classGroups\")\n    ? extend.classGroups\n    : {};\n  const conflictingClassGroupModifiers = hasOwnProp(\n    extend,\n    \"conflictingClassGroupModifiers\"\n  )\n    ? extend.conflictingClassGroupModifiers\n    : {};\n\n  const conflictingClassGroups = hasOwnProp(extend, \"conflictingClassGroups\")\n    ? extend.conflictingClassGroups\n    : {};\n  const orderSensitiveModifiers =\n    hasOwnProp(extend, \"orderSensitiveModifiers\") &&\n    isNonEmptyArray(extend.orderSensitiveModifiers)\n      ? extend.orderSensitiveModifiers\n      : [];\n\n  return {\n    config,\n    override,\n    cacheSize,\n    prefix,\n    experimentalParseClassName,\n    theme,\n    classGroups,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    orderSensitiveModifiers\n  };\n};\n","import type { OptionsMergeTwClsV3, TwMergeDefaultFnV3 } from \"./_private/types\";\n\nimport { extendTailwindMerge, getDefaultConfig } from \"tailwind-merge-v3\";\n\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { validatorPropsTwMerge } from \"../_private/validate-props\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 3 with extended rules.***\n * -------------------------------------------------------------\n * **Wraps ***`extendTailwindMerge` from tailwind-merge-v3*** with Tailwind’s default\n * config (_*`getDefaultConfig()` from tailwind-merge-v3*_) to create a **project-ready `twMerge`**.**\n * - 🔑 **When to use it?**\n *    - Your project uses **Tailwind v3**.\n *    - Extend **class groups** (e.g. add `text-shadow`).\n *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).\n *    - Override or fine-tune **merge behavior**.\n *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.\n * @param {OptionsMergeTwClsV3} [options={}]\n * ***Merge options:***\n *    - `config` – Your Tailwind config (from `tailwind.config.ts`).\n *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).\n *    - `extend` – Extra merge rules (classGroups, theme, etc).\n *    - `override` – Fully replace rules.\n *    - `cacheSize` – Parsed class cache size.\n *    - `experimentalParseClassName` – Custom classname parser.\n * @returns {TwMergeDefaultFnV3}\n * Customized Tailwind class merge function version 3 (same signature as `twMerge`).\n * @example\n * #### Example 1: ***Default behavior (same as tailwind-merge).***\n * ```ts\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge = twMergeDefaultV3();\n * twMerge(\"p-2 p-4\");\n * // ➔ \"p-4\"\n * ```\n * #### Example 2: ***Extend class groups.***\n * ```ts\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge2 = twMergeDefaultV3({\n *   extend: {\n *     classGroups: {\n *       shadow: [\"shadow-soft\", \"shadow-hard\"],\n *     },\n *   },\n * });\n * twMerge2(\"shadow-soft shadow-hard\");\n * // ➔ \"shadow-hard\"\n * ```\n * #### Example 3: ***Respect your Tailwind config.***\n * ```ts\n * import config from \"../tailwind.config\";\n * import { twMergeDefaultV3 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge3 = twMergeDefaultV3({ config });\n * twMerge3(\"text-base text-xxs\");\n * // ➔ \"text-xxs\" (resolved from config)\n * ```\n * #### Example 4: ***Project-wide helper (recommended).***\n * ```ts\n * import configTwCss from \"../tailwind.config\";\n * import { customCnV3, twMergeDefaultV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const customTwMerge = twMergeDefaultV3({\n *   config: configTwCss,\n *   extend: {\n *     classGroups: { shadow: [\"shadow-soft\", \"shadow-hard\"] },\n *   },\n * });\n *\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(customTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2 p-4\");                 // ➔ \"p-4\"\n * cnApp(\"shadow-soft shadow-hard\"); // ➔ \"shadow-hard\"\n * cnApp(\"text-base text-xxs\");      // ➔ \"text-xxs\" (uses config)\n *\n * // ⚡ Difference with package-level `cn`\n * import { cnV3, cnV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * cnV3(\"text-base text-xxs\");\n * // or\n * cnV4(\"text-base text-xxs\");\n * // ➔ \"text-base\"  (❌ doesn't know about your config)\n *\n * cnApp(\"text-base text-xxs\");\n * // ➔ \"text-xxs\"  (✅ respects config)\n * ```\n */\nexport const twMergeDefaultV3 = (\n  options: OptionsMergeTwClsV3 = {}\n): TwMergeDefaultFnV3 => {\n  if (!isPlainObject(options)) options = {};\n  const {\n    cacheSize,\n    classGroups,\n    config,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    override,\n    prefix,\n    theme,\n    experimentalParseClassName\n  } = validatorPropsTwMerge(options);\n\n  return extendTailwindMerge<string, string>({\n    prefix: prefix ?? config.prefix,\n    cacheSize: cacheSize || defaultConfig.cacheSize,\n    experimentalParseClassName,\n    override,\n    extend: {\n      conflictingClassGroupModifiers: {\n        ...defaultConfig.conflictingClassGroupModifiers,\n        ...conflictingClassGroupModifiers\n      },\n      theme: { ...defaultConfig.theme, ...theme },\n      conflictingClassGroups: {\n        ...defaultConfig.conflictingClassGroups,\n        ...conflictingClassGroups\n      },\n      classGroups: {\n        ...defaultConfig.classGroups,\n        ...classGroups,\n\n        \"text-shadow\": [\n          \"\",\n          \"-sm\",\n          \"-md\",\n          \"-lg\",\n          \"-xl\",\n          \"-xxl\",\n          \"-none\",\n          \"-default\"\n        ].map((size) => `text-shadow${size}`),\n        \"font-size\": Object.keys({\n          ...(config.theme?.fontSize || {}),\n          ...(config.theme?.extend?.fontSize || {})\n        }).map((size) => `text-${size}`)\n      }\n    }\n  });\n};\n","import type { OptionsMergeTwClsV4, TwMergeDefaultFnV4 } from \"./_private/types\";\n\nimport { extendTailwindMerge, getDefaultConfig } from \"tailwind-merge-v4\";\n\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { validatorPropsTwMerge } from \"../_private/validate-props\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 4 with extended rules.***\n * -------------------------------------------------------------\n * **Wraps ***`extendTailwindMerge` from tailwind-merge-v4*** with Tailwind’s default\n * config (_*`getDefaultConfig()` from tailwind-merge-v4*_) to create a **project-ready `twMerge`**.**\n * - 🔑 **When to use it?**\n *    - Your project uses **Tailwind v4**.\n *    - Extend **class groups** (e.g. add `text-shadow`).\n *    - Respect your own **`tailwind.config.ts`** (colors, spacing, fontSize, etc).\n *    - Override or fine-tune **merge behavior**.\n *    - Create a **project-wide `cn` helper** that replaces raw `twMerge`.\n * @param {OptionsMergeTwClsV4} [options={}]\n *  ***Merge options:***\n *    - `config` – Your Tailwind config (from `tailwind.config.ts`).\n *    - `prefix` - Utility prefix (e.g. `tw-` or `tw`).\n *    - `extend` – Extra merge rules (classGroups, theme, etc).\n *    - `override` – Fully replace rules.\n *    - `cacheSize` – Parsed class cache size.\n *    - `experimentalParseClassName` – Custom classname parser.\n * @returns {TwMergeDefaultFnV4}\n * Customized Tailwind class merge function version 4 (same signature as `twMerge`).\n * @example\n * #### Example 1: ***Default behavior (same as tailwind-merge).***\n * ```ts\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge = twMergeDefaultV4();\n * twMerge(\"p-2 p-4\");\n * // ➔ \"p-4\"\n * ```\n * #### Example 2: ***Extend class groups.***\n * ```ts\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge2 = twMergeDefaultV4({\n *   extend: {\n *     classGroups: {\n *       shadow: [\"shadow-soft\", \"shadow-hard\"],\n *     },\n *   },\n * });\n * twMerge2(\"shadow-soft shadow-hard\");\n * // ➔ \"shadow-hard\"\n * ```\n * #### Example 3: ***Respect your Tailwind config.***\n * ```ts\n * import config from \"../tailwind.config\";\n * import { twMergeDefaultV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const twMerge3 = twMergeDefaultV4({ config });\n * twMerge3(\"text-base text-xxs\");\n * // ➔ \"text-xxs\" (resolved from config)\n * ```\n * #### Example 4: ***Project-wide helper (recommended).***\n * ```ts\n * import configTwCss from \"../tailwind.config\";\n * import { customCnV4, twMergeDefaultV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const customTwMerge = twMergeDefaultV4({\n *   config: configTwCss,\n *   extend: {\n *     classGroups: { shadow: [\"shadow-soft\", \"shadow-hard\"] },\n *   },\n * });\n *\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(customTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2 p-4\");                 // ➔ \"p-4\"\n * cnApp(\"shadow-soft shadow-hard\"); // ➔ \"shadow-hard\"\n * cnApp(\"text-base text-xxs\");      // ➔ \"text-xxs\" (uses config)\n *\n * // ⚡ Difference with package-level `cn`\n * import { cnV3, cnV4 } from \"@rzl-zone/utils-js/tailwind\";\n *\n * cnV3(\"text-base text-xxs\");\n * // or\n * cnV4(\"text-base text-xxs\");\n * // ➔ \"text-base\"  (❌ doesn't know about your config)\n *\n * cnApp(\"text-base text-xxs\");\n * // ➔ \"text-xxs\"  (✅ respects config)\n * ```\n */\nexport const twMergeDefaultV4 = (\n  options: OptionsMergeTwClsV4 = {}\n): TwMergeDefaultFnV4 => {\n  if (!isPlainObject(options)) options = {};\n  const {\n    cacheSize,\n    classGroups,\n    config,\n    conflictingClassGroupModifiers,\n    conflictingClassGroups,\n    orderSensitiveModifiers,\n    override,\n    prefix,\n    theme,\n    experimentalParseClassName\n  } = validatorPropsTwMerge(options);\n\n  return extendTailwindMerge<string, string>({\n    prefix: prefix || config.prefix,\n    cacheSize: cacheSize || defaultConfig.cacheSize,\n    experimentalParseClassName,\n    override,\n    extend: {\n      conflictingClassGroupModifiers: {\n        ...defaultConfig.conflictingClassGroupModifiers,\n        ...conflictingClassGroupModifiers\n      },\n      theme: { ...defaultConfig.theme, ...theme },\n      conflictingClassGroups: {\n        ...defaultConfig.conflictingClassGroups,\n        ...conflictingClassGroups\n      },\n      orderSensitiveModifiers: [\n        ...defaultConfig.orderSensitiveModifiers,\n        ...orderSensitiveModifiers\n      ],\n      classGroups: {\n        ...defaultConfig.classGroups,\n        ...classGroups,\n\n        \"text-shadow\": [\n          \"\",\n          \"-sm\",\n          \"-md\",\n          \"-lg\",\n          \"-xl\",\n          \"-xxl\",\n          \"-none\",\n          \"-default\"\n        ].map((size) => `text-shadow${size}`),\n        \"font-size\": Object.keys({\n          ...(config.theme?.fontSize || {}),\n          ...(config.theme?.extend?.fontSize || {})\n        }).map((size) => `text-${size}`)\n      }\n    }\n  });\n};\n","import type { TwMergeDefaultFnV3 } from \"../tw-merge/v3/_private/types\";\nimport type { TwMergeDefaultFnV4 } from \"../tw-merge/v4/_private/types\";\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { twMergeDefaultV3 } from \"../tw-merge/v3/twMergeDefault\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { twMergeDefaultV4 } from \"../tw-merge/v4/twMergeDefault\";\n\nimport { isFunction } from \"@/predicates/is/isFunction\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { cx, type ClassValues } from \"./cx\";\n\nexport type { ClassValues };\n\n/** -------------------------------------------------------------\n * * ***Factory utility for building a custom `cn` helper (Tailwind `v3`).***\n * -------------------------------------------------------------\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV3 | `twMergeDefaultV3`}).**\n * - 🔑 **When to use it?**\n *      - Your project uses **Tailwind v3**.\n *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).\n *      - You need multiple `cn*` variants across apps/packages.\n * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeDefaultV3 | `twMergeDefaultV3`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV3, customCnV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create a custom merge function\n * const myCustomTwMerge = twMergeDefaultV3({\n *   config: tailwindConfig,\n *   extend: {\n *     classGroups: {\n *       \"text-shadow\": [\"text-shadow\", \"text-shadow-sm\", \"text-shadow-md\"],\n *     },\n *   },\n * });\n *\n * // 2. Build your helper using `customCnV3`\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(myCustomTwMerge, ...classes);\n * };\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");     // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const customCnV3 = (\n  customTwMergeV3: TwMergeDefaultFnV3,\n  ...classes: ClassValues\n): string => {\n  if (!isFunction(customTwMergeV3)) {\n    throw new TypeError(\n      `first Parameter (\\`customTwMergeV3\\`) must be of type \\`function\\`, but received: \\`${getPreciseType(\n        customTwMergeV3\n      )}\\`.`\n    );\n  }\n\n  return customTwMergeV3(cx(...classes));\n};\n\n/** -------------------------------------------------------------\n * * ***Factory utility for building a custom `cn` helper (Tailwind `v4`).***\n * -------------------------------------------------------------\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV4 | `twMergeDefaultV4`}).**\n * - 🔑 **When to use it?**\n *      - Your project uses **Tailwind v4**.\n *      - You extend Tailwind merge rules (`classGroups`, `tailwind.config`).\n *      - You need multiple `cn*` variants across apps/packages.\n * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeDefaultV4 | `twMergeDefaultV4`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV4, customCnV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create a custom merge function\n * const myCustomTwMerge = twMergeDefaultV4({\n *   config: tailwindConfig,\n *   extend: {\n *     classGroups: {\n *       \"text-shadow\": [\"text-shadow\", \"text-shadow-sm\", \"text-shadow-md\"],\n *     },\n *   },\n * });\n *\n * // 2. Build your helper using `customCnV4`\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(myCustomTwMerge, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");     // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const customCnV4 = (\n  customTwMergeV4: TwMergeDefaultFnV4,\n  ...classes: ClassValues\n): string => {\n  if (!isFunction(customTwMergeV4)) {\n    throw new TypeError(\n      `first Parameter (\\`customTwMergeV4\\`) must be of type \\`function\\`, but received: \\`${getPreciseType(\n        customTwMergeV4\n      )}\\`.`\n    );\n  }\n\n  return customTwMergeV4(cx(...classes));\n};\n","import type { ClassValues } from \"./cx\";\n\nimport { cx } from \"./cx\";\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { customCnV3, customCnV4 } from \"./customCn\";\nimport { twMergeDefaultV3 } from \"../tw-merge/v3/twMergeDefault\";\nimport { twMergeDefaultV4 } from \"../tw-merge/v4/twMergeDefault\";\n\nconst defaultTwMergeV3 = twMergeDefaultV3();\nconst defaultTwMergeV4 = twMergeDefaultV4();\n\n/** -------------------------------------------------------------\n * * ***Default `cnV3` utility (Tailwind v3).***\n * -------------------------------------------------------------\n * **Combines class-name values and then deduplicates/resolves\n * conflicts using {@link twMergeDefaultV3 | `twMergeDefaultV3`}\n * with **Tailwind v3 default config only**.**\n * - ✅ **Use this when:**\n *    - Your project uses **Tailwind v3**.\n *    - You need a simple `cn` that works out of the box without a custom config.\n * - ⚡ **Need custom rules?**\n *    - Create a project-wide helper using\n *      {@link twMergeDefaultV3 | `twMergeDefaultV3`} +\n *      {@link customCnV3 | `customCnV3`} (see Example 2).\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * #### Example 1: ✅ Default usage (Tailwind v3).\n * ```ts\n * cnV3(\"p-2\", \"p-4\");\n * // ➔ \"p-4\"\n *\n * cnV3(\"text-red-500\", { \"text-blue-500\": true });\n * // ➔ \"text-blue-500\"\n *\n * cnV3([\"m-2\", [\"m-4\"]], \"m-8\");\n * // ➔ \"m-8\"\n * ```\n * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV3, customCnV3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const cnApp = (...classes: ClassValues) => {\n *   return customCnV3(\n *     twMergeDefaultV3({\n *       config: tailwindConfig,\n *       extend: {\n *         classGroups: {\n *           \"text-shadow\": [\n *             \"text-shadow\",\n *             \"text-shadow-sm\",\n *             \"text-shadow-md\",\n *           ],\n *         },\n *       },\n *     }),\n *     // ...other options classes,\n *   );\n * };\n *\n * cnApp(\"p-2 p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\"); // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");  // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const cnV3 = (...classes: ClassValues): string => {\n  return defaultTwMergeV3(cx(...classes));\n};\n\n/** -------------------------------------------------------------\n * * ***Default `cnV4` utility (Tailwind v4).***\n * -------------------------------------------------------------\n * **Combines class-name values and then deduplicates/resolves\n * conflicts using {@link twMergeDefaultV4 | `twMergeDefaultV4`}\n * with **Tailwind v4 default config only**.**\n * - ✅ **Use this when:**\n *    - Your project uses **Tailwind v4**.\n *    - You need a simple `cn` that works out of the box without a custom config.\n * - ⚡ **Need custom rules?**\n *    - Create a project-wide helper using\n *      {@link twMergeDefaultV4 | `twMergeDefaultV4`} +\n *      {@link customCnV4 | `customCnV4`} (see Example 2).\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n * @example\n * #### Example 1: ✅ Default usage (Tailwind v4).\n * ```ts\n * cnV4(\"p-2\", \"p-4\");\n * // ➔ \"p-4\"\n *\n * cnV4(\"text-red-500\", { \"text-blue-500\": true });\n * // ➔ \"text-blue-500\"\n *\n * cnV4([\"m-2\", [\"m-4\"]], \"m-8\");\n * // ➔ \"m-8\"\n * ```\n * #### Example 2: ⚡ Custom project-wide usage with Tailwind config.\n * ```ts\n * import tailwindConfig from \"../tailwind.config\";\n * import { twMergeDefaultV4, customCnV4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * const cnApp = (...classes: ClassValues) => {\n *   return customCnV4(\n *     twMergeDefaultV4({\n *       config: tailwindConfig,\n *       extend: {\n *         classGroups: {\n *           \"text-shadow\": [\n *             \"text-shadow\",\n *             \"text-shadow-sm\",\n *             \"text-shadow-md\",\n *           ],\n *         },\n *       },\n *     }),\n *     // ...other options classes,\n *   );\n * };\n *\n * cnApp(\"p-2 p-4\");             // ➔ \"p-4\"\n * cnApp(\"shadow-sm shadow-md\"); // ➔ \"shadow-md\"\n * cnApp(\"text-base text-xxs\");  // ➔ \"text-xxs\" (resolved from config)\n * ```\n */\nexport const cnV4 = (...classes: ClassValues): string => {\n  return defaultTwMergeV4(cx(...classes));\n};\n","import type { Stringify } from \"@rzl-zone/ts-types-plus\";\n\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { assertIsArray } from \"@/assertions/objects/assertIsArray\";\n\n/** ----------------------------------------------------------\n * * ***Utility: `shouldForwardProp`.***\n * ----------------------------------------------------------\n * **Creates a helper for styled-components `shouldForwardProp`.**\n *\n * @description\n * 1. Returns a **predicate function** that determines whether a given prop\n * should be forwarded to the DOM.\n * 2. Useful for filtering out internal props (e.g., `$size`, `$active`)\n * so they don't become invalid HTML attributes.\n *\n * - **Behavior:**\n *    - Accepts a strict tuple of **string keys** to exclude from forwarding.\n *    - Every key is validated as a **non-empty string** at runtime.\n *    - Throws a `TypeError` if:\n *      - `props` is not an array, or\n *      - any item is not a non-empty string.\n *    - Automatically coerces the tested prop name to string for matching.\n *\n * @template CustomProps\n *   The component props type to validate against.\n *\n * @param {readonly Stringify<keyof CustomProps>[]}\n *   props\n *   The list of prop names (keys of `CustomProps`) to exclude from forwarding.\n *\n * @returns {(propName: keyof CustomProps | ({} & string)) => boolean}\n *   A function that receives a prop name and returns:\n *   - `true`  ➔ the prop **will** be forwarded to the DOM.\n *   - `false` ➔ the prop **will not** be forwarded.\n *\n * @throws **{@link TypeError | `TypeError`}**\n *   when:\n *   - `props` is not an array, or\n *   - any item is not a non-empty string.\n *\n * @example\n * // Basic usage\n * type Props = { $size: string; color: string; visible: boolean };\n * const filter = shouldForwardProp<Props>([\"$size\"]);\n *\n * filter(\"$size\");   // ➔ false (blocked).\n * filter(\"color\");   // ➔ true  (forwarded).\n * filter(\"visible\"); // ➔ true  (forwarded).\n *\n * @example\n * // With styled-components\n * type CustomProps = { $internal: boolean; public: string; another: boolean };\n *\n * styled.div.withConfig({\n *   shouldForwardProp: shouldForwardProp<CustomProps>([\"$internal\"])\n * });\n */\nexport const shouldForwardProp = <CustomProps extends Record<string, unknown>>(\n  props: readonly Stringify<keyof CustomProps>[]\n  // props: Partial<UnionToTupleStrict<keyof CustomProps>>\n): ((propName: keyof CustomProps | ({} & string)) => boolean) => {\n  assertIsArray(props, {\n    message: ({ currentType, validType }) =>\n      `First parameter (\\`props\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n  });\n\n  const invalidItems: { index: number; reason: string }[] = [];\n\n  props.forEach((p, idx) => {\n    if (!isString(p)) {\n      invalidItems.push({\n        index: idx,\n        reason: `Expected a non-empty string, but received ${getPreciseType(p, {\n          formatCase: \"toPascalCaseSpace\"\n        })}.`\n      });\n    } else if (isEmptyString(p)) {\n      invalidItems.push({\n        index: idx,\n        reason: \"Expected a non-empty string, but received EmptyString.\"\n      });\n    }\n  });\n\n  if (isNonEmptyArray(invalidItems)) {\n    const maxWidth = Math.max(\n      ...invalidItems.map((item) => String(item.index).length)\n    );\n\n    const details = invalidItems\n      .map(\n        (item) =>\n          `• [Index ${String(item.index).padStart(maxWidth, \"0\")}] ${item.reason}`\n      )\n      .join(\"\\n\");\n\n    throw new TypeError(\n      `First parameter (\\`props\\`) contains invalid entries:\\n${details}`\n    );\n  }\n\n  return (propName): boolean => {\n    return !props.map(String).includes(String(propName));\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiGA,SAAS,cAAc,OAA2B;CAChD,IAAI,MAAM;CAEV,IAAIA,yCAAiB,MAAM,IAAIC,iCAAS,MAAM,EAC5C,OAAO;MACF,IAAIC,wCAAgB,MAAM,EAC/B,IACEC,uCAAe,MAAM,IACrBC,uCAAe,MAAM,IACrBC,wCAAgB,MAAM,EACtB;EACA,MAAM,MAAM,MAAM,SAAS;EAC3B,IAAI,KAAK,OAAO;QACX,IAAIC,gCAAQ,MAAM,EACvB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,CAAC,MAAM;EACX,MAAM,IAAI,cAAc,KAAK;EAC7B,IAAI,CAAC,GAAG;EACR,IAAI,KAAK,OAAO;EAChB,OAAO;;MAGT,KAAK,MAAM,OAAO,OAAO;EACvB,IAAI,CAAC,MAAM,MAAM;EACjB,IAAI,KAAK,OAAO;EAChB,OAAO;;CAKb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDT,SAAgB,GAAG,GAAG,QAA6B;CACjD,IAAI,MAAM;CAEV,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,CAAC,OAAO;EACZ,MAAM,IAAI,cAAc,MAAM;EAC9B,IAAI,CAAC,GAAG;EACR,IAAI,KAAK,OAAO;EAChB,OAAO;;CAGT,OAAO;;;;;;;;ACnJT,MAAa,yBACX,YAC2B;CAC3B,IAAI,CAACC,sCAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,IAAI,EACF,QACA,QACA,QACA,UACA,WACA,+BACE;CAEJ,IAAI,CAACA,sCAAc,OAAO,EAAE,SAAS,EAAE;CACvC,IAAI,CAACA,sCAAc,OAAO,EAAE,SAAS,EAAE;CACvC,IAAI,CAACA,sCAAc,SAAS,EAAE,WAAW,EAAE;CAC3C,IAAI,CAACC,iCAAS,UAAU,EAAE,YAAY;CACtC,IAAI,CAACC,yCAAiB,OAAO,EAAE,SAAS;CACxC,IAAI,CAACC,mCAAW,2BAA2B,EACzC,6BAA6B;CAE/B,MAAM,QAAQC,mCAAW,QAAQ,QAAQ,GAAG,OAAO,QAAQ,EAAE;CAC7D,MAAM,cAAcA,mCAAW,QAAQ,cAAc,GACjD,OAAO,cACP,EAAE;CACN,MAAM,iCAAiCA,mCACrC,QACA,iCACD,GACG,OAAO,iCACP,EAAE;CAEN,MAAM,yBAAyBA,mCAAW,QAAQ,yBAAyB,GACvE,OAAO,yBACP,EAAE;CACN,MAAM,0BACJA,mCAAW,QAAQ,0BAA0B,IAC7CC,wCAAgB,OAAO,wBAAwB,GAC3C,OAAO,0BACP,EAAE;CAER,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;;;;;AC3FH,MAAMC,2DAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFxC,MAAa,oBACX,UAA+B,EAAE,KACV;CACvB,IAAI,CAACC,sCAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,MAAM,EACJ,WACA,aACA,QACA,gCACA,wBACA,UACA,QACA,OACA,+BACE,sBAAsB,QAAQ;CAElC,kDAA2C;EACzC,QAAQ,UAAU,OAAO;EACzB,WAAW,aAAaD,gBAAc;EACtC;EACA;EACA,QAAQ;GACN,gCAAgC;IAC9B,GAAGA,gBAAc;IACjB,GAAG;IACJ;GACD,OAAO;IAAE,GAAGA,gBAAc;IAAO,GAAG;IAAO;GAC3C,wBAAwB;IACtB,GAAGA,gBAAc;IACjB,GAAG;IACJ;GACD,aAAa;IACX,GAAGA,gBAAc;IACjB,GAAG;IAEH,eAAe;KACb;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD,CAAC,KAAK,SAAS,cAAc,OAAO;IACrC,aAAa,OAAO,KAAK;KACvB,GAAI,OAAO,OAAO,YAAY,EAAE;KAChC,GAAI,OAAO,OAAO,QAAQ,YAAY,EAAE;KACzC,CAAC,CAAC,KAAK,SAAS,QAAQ,OAAO;IACjC;GACF;EACF,CAAC;;;;;AC3IJ,MAAM,yDAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFxC,MAAa,oBACX,UAA+B,EAAE,KACV;CACvB,IAAI,CAACE,sCAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,MAAM,EACJ,WACA,aACA,QACA,gCACA,wBACA,yBACA,UACA,QACA,OACA,+BACE,sBAAsB,QAAQ;CAElC,kDAA2C;EACzC,QAAQ,UAAU,OAAO;EACzB,WAAW,aAAa,cAAc;EACtC;EACA;EACA,QAAQ;GACN,gCAAgC;IAC9B,GAAG,cAAc;IACjB,GAAG;IACJ;GACD,OAAO;IAAE,GAAG,cAAc;IAAO,GAAG;IAAO;GAC3C,wBAAwB;IACtB,GAAG,cAAc;IACjB,GAAG;IACJ;GACD,yBAAyB,CACvB,GAAG,cAAc,yBACjB,GAAG,wBACJ;GACD,aAAa;IACX,GAAG,cAAc;IACjB,GAAG;IAEH,eAAe;KACb;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACD,CAAC,KAAK,SAAS,cAAc,OAAO;IACrC,aAAa,OAAO,KAAK;KACvB,GAAI,OAAO,OAAO,YAAY,EAAE;KAChC,GAAI,OAAO,OAAO,QAAQ,YAAY,EAAE;KACzC,CAAC,CAAC,KAAK,SAAS,QAAQ,OAAO;IACjC;GACF;EACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrGJ,MAAa,cACX,iBACA,GAAG,YACQ;CACX,IAAI,CAACC,mCAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuFC,uCACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCxC,MAAa,cACX,iBACA,GAAG,YACQ;CACX,IAAI,CAACD,mCAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuFC,uCACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;AC5GxC,MAAM,mBAAmB,kBAAkB;AAC3C,MAAM,mBAAmB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyD3C,MAAa,QAAQ,GAAG,YAAiC;CACvD,OAAO,iBAAiB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DzC,MAAa,QAAQ,GAAG,YAAiC;CACvD,OAAO,iBAAiB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACjEzC,MAAa,qBACX,UAE+D;CAC/D,oCAAc,OAAO,EACnB,UAAU,EAAE,aAAa,gBACvB,iDAAiD,UAAU,sBAAsB,YAAY,MAChG,CAAC;CAEF,MAAM,eAAoD,EAAE;CAE5D,MAAM,SAAS,GAAG,QAAQ;EACxB,IAAI,CAACC,iCAAS,EAAE,EACd,aAAa,KAAK;GAChB,OAAO;GACP,QAAQ,6CAA6CC,uCAAe,GAAG,EACrE,YAAY,qBACb,CAAC,CAAC;GACJ,CAAC;OACG,IAAIC,oCAAc,EAAE,EACzB,aAAa,KAAK;GAChB,OAAO;GACP,QAAQ;GACT,CAAC;GAEJ;CAEF,IAAIC,wCAAgB,aAAa,EAAE;EACjC,MAAM,WAAW,KAAK,IACpB,GAAG,aAAa,KAAK,SAAS,OAAO,KAAK,MAAM,CAAC,OAAO,CACzD;EAED,MAAM,UAAU,aACb,KACE,SACC,YAAY,OAAO,KAAK,MAAM,CAAC,SAAS,UAAU,IAAI,CAAC,IAAI,KAAK,SACnE,CACA,KAAK,KAAK;EAEb,MAAM,IAAI,UACR,0DAA0D,UAC3D;;CAGH,QAAQ,aAAsB;EAC5B,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,OAAO,SAAS,CAAC"}

package/dist/{toStringArrayUnRecursive-xUaU8Ot9.cjs → toStringArrayUnRecursive-C4zYCja7.cjs}

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
-const require_assertIsBoolean = require('./assertIsBoolean-DozdtbNi.cjs');
-const require_isBigInt = require('./isBigInt-B1cijjqm.cjs');
-const require_isEmptyObject = require('./isEmptyObject-DI42NEo0.cjs');
-const require_isFinite = require('./isFinite-sFkps2TY.cjs');
+const require_assertIsBoolean = require('./assertIsBoolean-C8WEXVr2.cjs');
+const require_isBigInt = require('./isBigInt-C4krUeAw.cjs');
+const require_isEmptyObject = require('./isEmptyObject-ZkSwRC_D.cjs');
+const require_isFinite = require('./isFinite-D24ZaE6c.cjs');
 function filterNilArray(input) {
 	if (require_assertIsBoolean.isNil(input)) return void 0;
 	if (!require_assertIsBoolean.isArray(input)) return [];
@@ -48,4 +48,4 @@ Object.defineProperty(exports, 'toStringArrayUnRecursive', {
     return toStringArrayUnRecursive;
   }
 });
-//# sourceMappingURL=toStringArrayUnRecursive-xUaU8Ot9.cjs.map
+//# sourceMappingURL=toStringArrayUnRecursive-C4zYCja7.cjs.map