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

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.13.0-beta.2`
 *  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-DyVWeYP3.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.13.0-beta.2`
 *  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-_dJhBl1h.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,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  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-Bv6gL-xe.js";
+import { t as isEmptyString } from "../isEmptyString-DFDtBbNr.js";
+import { t as normalizeSpaces } from "../normalizeSpaces-C1eLwykD.js";
+import { n as normalizeString, t as removeSpaces } from "../removeSpaces-B96axxP6.js";
 const capitalizeFirst = (string, options = {
 	lowerCaseNextRest: true,
 	trim: false
@@ -20,7 +19,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 +47,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,18 +2,22 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  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-C1YtxJ-K.cjs');
 exports.cnV3 = require_tailwind.cnV3;
 exports.cnV4 = require_tailwind.cnV4;
+exports.cnVer3 = require_tailwind.cnVer3;
+exports.cnVer4 = require_tailwind.cnVer4;
 exports.customCnV3 = require_tailwind.customCnV3;
 exports.customCnV4 = require_tailwind.customCnV4;
+exports.customCnVer3 = require_tailwind.customCnVer3;
+exports.customCnVer4 = require_tailwind.customCnVer4;
 exports.cx = require_tailwind.cx;
 exports.shouldForwardProp = require_tailwind.shouldForwardProp;
 exports.twMergeDefaultV3 = require_tailwind.twMergeDefaultV3;

package/dist/tailwind/index.d.cts

@@ -2,11 +2,11 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  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";
-export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };
+import { a as customCnV4, c as cnV3, d as cnVer4, f as ClassObject, h as cx, i as customCnV3, l as cnV4, m as ClassValues, n as twMergeDefaultV3, o as customCnVer3, p as ClassValue, r as shouldForwardProp, s as customCnVer4, t as twMergeDefaultV4, u as cnVer3 } from "../index-z_uCh5KW.cjs";
+export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, cnVer3, cnVer4, customCnV3, customCnV4, customCnVer3, customCnVer4, 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.13.0-beta.2`
 *  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";
-export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };
+import { a as customCnV4, c as cnV3, d as cnVer4, f as ClassObject, h as cx, i as customCnV3, l as cnV4, m as ClassValues, n as twMergeDefaultV3, o as customCnVer3, p as ClassValue, r as shouldForwardProp, s as customCnVer4, t as twMergeDefaultV4, u as cnVer3 } from "../index-DHHrLc0B.js";
+export { ClassObject, ClassValue, ClassValues, cnV3, cnV4, cnVer3, cnVer4, customCnV3, customCnV4, customCnVer3, customCnVer4, 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.13.0-beta.2`
 *  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";
-export { cnV3, cnV4, customCnV3, customCnV4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };
+import { a as cnVer4, c as customCnVer3, d as twMergeDefaultV3, f as cx, i as cnVer3, l as customCnVer4, n as cnV3, o as customCnV3, r as cnV4, s as customCnV4, t as shouldForwardProp, u as twMergeDefaultV4 } from "../tailwind-BZ2_MeNX.js";
+export { cnV3, cnV4, cnVer3, cnVer4, customCnV3, customCnV4, customCnVer3, customCnVer4, cx, shouldForwardProp, twMergeDefaultV3, twMergeDefaultV4 };

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

@@ -2,16 +2,16 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  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 { extendTailwindMerge, getDefaultConfig } from "tailwind-merge-v3";
-import { extendTailwindMerge as extendTailwindMerge$1, getDefaultConfig as getDefaultConfig$1 } from "tailwind-merge-v4";
+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-Bv6gL-xe.js";
+import { t as assertIsArray } from "./assertIsArray-6BcSdNa-.js";
+import { t as isEmptyString } from "./isEmptyString-DFDtBbNr.js";
+import { extendTailwindMerge, getDefaultConfig, twMerge } from "tailwind-merge-v3";
+import { extendTailwindMerge as extendTailwindMerge$1, getDefaultConfig as getDefaultConfig$1, twMerge as twMerge$1 } from "tailwind-merge-v4";
 function toStringValue(value) {
 	let str = "";
 	if (isNonEmptyString(value) || isNumber(value)) str += value;
@@ -157,6 +157,14 @@ const twMergeDefaultV4 = (options = {}) => {
 		}
 	});
 };
+const customCnVer3 = (customTwMergeV3 = twMerge, ...classes) => {
+	if (!isFunction(customTwMergeV3)) throw new TypeError(`first Parameter (\`customTwMergeV3\`) must be of type \`function\`, but received: \`${getPreciseType(customTwMergeV3)}\`.`);
+	return customTwMergeV3(cx(...classes));
+};
+const customCnVer4 = (customTwMergeV4 = twMerge$1, ...classes) => {
+	if (!isFunction(customTwMergeV4)) throw new TypeError(`first Parameter (\`customTwMergeV4\`) must be of type \`function\`, but received: \`${getPreciseType(customTwMergeV4)}\`.`);
+	return customTwMergeV4(cx(...classes));
+};
 const customCnV3 = (customTwMergeV3, ...classes) => {
 	if (!isFunction(customTwMergeV3)) throw new TypeError(`first Parameter (\`customTwMergeV3\`) must be of type \`function\`, but received: \`${getPreciseType(customTwMergeV3)}\`.`);
 	return customTwMergeV3(cx(...classes));
@@ -165,6 +173,8 @@ const customCnV4 = (customTwMergeV4, ...classes) => {
 	if (!isFunction(customTwMergeV4)) throw new TypeError(`first Parameter (\`customTwMergeV4\`) must be of type \`function\`, but received: \`${getPreciseType(customTwMergeV4)}\`.`);
 	return customTwMergeV4(cx(...classes));
 };
+const cnVer3 = (...values) => twMerge(cx(...values));
+const cnVer4 = (...values) => twMerge$1(cx(...values));
 const defaultTwMergeV3 = twMergeDefaultV3();
 const defaultTwMergeV4 = twMergeDefaultV4();
 const cnV3 = (...classes) => {
@@ -195,5 +205,5 @@ const shouldForwardProp = (props) => {
 		return !props.map(String).includes(String(propName));
 	};
 };
-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
+export { cnVer4 as a, customCnVer3 as c, twMergeDefaultV3 as d, cx as f, cnVer3 as i, customCnVer4 as l, cnV3 as n, customCnV3 as o, cnV4 as r, customCnV4 as s, shouldForwardProp as t, twMergeDefaultV4 as u };
+//# sourceMappingURL=tailwind-BZ2_MeNX.js.map

package/dist/tailwind-BZ2_MeNX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-BZ2_MeNX.js","names":["defaultConfig","getDefaultConfig","extendTailwindMerge","twMergeV3","twMergeV4","twMergeV3","twMergeV4"],"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// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { customCnVer3 } from \"../../class-names/customCn\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 3 with extended rules.***\n * -------------------------------------------------------------\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 *\n * @deprecated ***Still supported for advanced Tailwind merge customization, but significantly slower than native `twMerge` during SSR and hydration because merge rules are extended at runtime, prefer `twMerge` + {@link customCnVer3 | `customCnVer3`} for better performance, this utility may be removed in a future release.***\n *\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 *\n * @returns {TwMergeDefaultFnV3}\n * Customized Tailwind class merge function version 3 (same signature as `twMerge`).\n *\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// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { customCnVer4 } from \"../../class-names/customCn\";\n\n// Get default Tailwind merge configuration\nconst defaultConfig = getDefaultConfig();\n\n/** -------------------------------------------------------------\n * * ***Customized Tailwind class merger Version 4 with extended rules.***\n * -------------------------------------------------------------\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 *\n * @deprecated ***Still supported for advanced Tailwind merge customization, but significantly slower than native `twMerge` during SSR and hydration because merge rules are extended at runtime, prefer `twMerge` + {@link customCnVer4 | `customCnVer4`} for better performance, this utility may be removed in a future release.***\n *\n * @deprecated ***Slower than the default `twMerge`, but still safe to use when custom merge behavior is needed.***\n *\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 *\n * @returns {TwMergeDefaultFnV4}\n * Customized Tailwind class merge function version 4 (same signature as `twMerge`).\n *\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\nimport { twMerge as twMergeV3 } from \"tailwind-merge-v3\";\nimport { twMerge as twMergeV4 } from \"tailwind-merge-v4\";\n\n/** -------------------------------------------------------------\n * * ***High-performance `cn` factory utility (Tailwind `v3`).***\n * -------------------------------------------------------------\n * **Combines class-name values and applies the provided Tailwind merge\n * function using the native {@link twMergeV3 | `twMergeV3`} implementation\n * from `tailwind-merge` version 2 for `tailwind version 3`.**\n *\n * This utility is the recommended replacement for deprecated extended\n * runtime merge helpers because it provides significantly better hydration\n * and runtime performance.\n *\n * - ✅ **Recommended when:**\n *      - Your project uses **Tailwind v3**.\n *      - You want the fastest possible `cn` utility.\n *      - You need reusable project-wide `cn*` helpers.\n *      - You want predictable Tailwind conflict resolution with minimal overhead.\n *\n * - ⚡ **Performance note**\n *      - Uses the native `twMergeV3` implementation directly.\n *      - Faster than deprecated extended merge utilities.\n *      - Better suited for SSR and hydration-heavy applications.\n *\n * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeV3 | `twMergeV3`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n *\n * @example\n * ```ts\n * import { twMerge as twMergeV3 } from \"tailwind-merge\"; // tw-merge (v2) for tailwind version 3\n * import { customCnVer3, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create app-level helper\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnVer3(twMergeV3, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"text-sm text-lg\");        // ➔ \"text-lg\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * ```\n */\nexport const customCnVer3 = (\n  customTwMergeV3: TwMergeDefaultFnV3 = twMergeV3,\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 * * ***High-performance `cn` factory utility (Tailwind `v4`).***\n * -------------------------------------------------------------\n * **Combines class-name values and applies the provided Tailwind merge\n * function using the native {@link twMergeV4 | `twMergeV4`} implementation\n * from `tailwind-merge` version 3 for `tailwind version 4`.**\n *\n * This utility is the recommended replacement for deprecated extended\n * runtime merge helpers because it provides significantly better hydration\n * and runtime performance.\n *\n * - ✅ **Recommended when:**\n *      - Your project uses **Tailwind v4**.\n *      - You want the fastest possible `cn` utility.\n *      - You need reusable project-wide `cn*` helpers.\n *      - You want predictable Tailwind conflict resolution with minimal overhead.\n *\n * - ⚡ **Performance note**\n *      - Uses the native `twMergeV4` implementation directly.\n *      - Faster than deprecated extended merge utilities.\n *      - Better suited for SSR and hydration-heavy applications.\n *\n * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeV4 | `twMergeV4`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n *\n * @example\n * ```ts\n * import { twMerge as twMergeV4 } from \"tailwind-merge\"; // tw-merge (v3) for tailwind version 4\n * import { customCnVer4, type ClassValues } from \"@rzl-zone/utils-js/tailwind\";\n *\n * // 1. Create app-level helper\n * export const cnApp = (...classes: ClassValues) => {\n *   return customCnVer4(twMergeV4, ...classes);\n * };\n *\n * // ✅ Usage\n * cnApp(\"p-2\", \"p-4\");             // ➔ \"p-4\"\n * cnApp(\"text-sm text-lg\");        // ➔ \"text-lg\"\n * cnApp(\"shadow-sm shadow-md\");    // ➔ \"shadow-md\"\n * ```\n */\nexport const customCnVer4 = (\n  customTwMergeV4: TwMergeDefaultFnV4 = twMergeV4,\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\n/** -------------------------------------------------------------\n * * ***Factory utility for building a custom `cn` helper (Tailwind `v3`).***\n * -------------------------------------------------------------\n *\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV3 | `twMergeDefaultV3`}).**\n *\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 *\n * @deprecated ***Still supported, but slower during SSR and hydration because it relies on extended runtime merge logic,\n * prefer {@link customCnVer3 | `customCnVer3`}for better performance, this utility may be removed in a future release.***\n *\n * @param {TwMergeDefaultFnV3} customTwMergeV3 - Merge function created via {@link twMergeDefaultV3 | `twMergeDefaultV3`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n *\n * @returns {string} Merged Tailwind class string.\n *\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 *\n * **Wraps internally function to combines class-name values and applies the provided\n * Tailwind merge function (from {@link twMergeDefaultV4 | `twMergeDefaultV4`}).**\n *\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 *\n * @deprecated ***Still supported, but slower during SSR and hydration because it relies on extended runtime merge logic,\n * prefer {@link customCnVer4 | `customCnVer4`}for better performance, this utility may be removed in a future release.***\n *\n * @param {TwMergeDefaultFnV4} customTwMergeV4 - Merge function created via {@link twMergeDefaultV4 | `twMergeDefaultV4`}.\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n *\n * @returns {string} Merged Tailwind class string.\n *\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 { twMerge as twMergeV3 } from \"tailwind-merge-v3\";\nimport { twMerge as twMergeV4 } from \"tailwind-merge-v4\";\n\nimport { cx, type ClassValues } 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\n/** -------------------------------------------------------------------\n * * ***Combines and merges class utility values into a single normalized\n * string with `Tailwind CSS v3` conflict resolution.***\n * --------------------------------------------------------------------\n *\n * This utility composes {@link cx | `cx`} and {@link twMergeV3 | `twMerge`} version **2** for ***`tailwind version 3`***:\n *\n * - `cx` handles flexible class inputs (like `clsx`)\n * - `twMerge` resolves Tailwind CSS utility conflicts\n *\n * This provides a complete solution for conditional class composition\n * with deterministic Tailwind merging.\n *\n * - **Behavior:**\n *    - Accepts strings, numbers, arrays, and objects\n *    - Supports deeply nested class structures\n *    - Ignores falsy values (`false`, `null`, `undefined`, `\"\"`, `0`)\n *    - Includes object keys with truthy values (including inherited keys)\n *    - Unwraps boxed primitives (`new String()`, etc.)\n *    - Resolves Tailwind utility conflicts deterministically\n *    - Keeps the last conflicting class based on input order\n *    - Produces a clean, space-normalized class string\n *\n * This utility is a drop-in replacement for `clsx` or `classnames`\n * with built-in Tailwind conflict resolution.\n *\n * @param values - A list of mixed class values including strings,\n * numbers, arrays, objects, and conditional expressions.\n *\n * @returns A merged and normalized CSS class string.\n *\n * @example\n * ```ts\n * cn(\n *   \"p-2\",\n *   isActive && \"bg-blue-500\",\n *   [\"text-sm\", { \"font-bold\": isBold }],\n *   null,\n *   0\n * );\n * // => \"p-2 bg-blue-500 text-sm font-bold\"\n * ```\n *\n * @example\n * ```ts\n * cn(\"p-2 p-4\", { \"text-sm\": true, \"text-lg\": true });\n * // => \"p-4 text-lg\"\n * ```\n */\nexport const cnVer3 = (...values: ClassValues): string =>\n  twMergeV3(cx(...values));\n\n/** -------------------------------------------------------------------\n * * ***Combines and merges class utility values into a single normalized\n * string with `Tailwind CSS v4` conflict resolution.***\n * --------------------------------------------------------------------\n *\n * This utility composes {@link cx | `cx`} and {@link twMergeV4 | `twMerge`} version **3** for ***`tailwind version 4`***:\n *\n * - `cx` handles flexible class inputs (like `clsx`)\n * - `twMerge` resolves Tailwind CSS utility conflicts\n *\n * This provides a complete solution for conditional class composition\n * with deterministic Tailwind merging.\n *\n * - **Behavior:**\n *    - Accepts strings, numbers, arrays, and objects\n *    - Supports deeply nested class structures\n *    - Ignores falsy values (`false`, `null`, `undefined`, `\"\"`, `0`)\n *    - Includes object keys with truthy values (including inherited keys)\n *    - Unwraps boxed primitives (`new String()`, etc.)\n *    - Resolves Tailwind utility conflicts deterministically\n *    - Keeps the last conflicting class based on input order\n *    - Produces a clean, space-normalized class string\n *\n * This utility is a drop-in replacement for `clsx` or `classnames`\n * with built-in Tailwind conflict resolution.\n *\n * @param values - A list of mixed class values including strings,\n * numbers, arrays, objects, and conditional expressions.\n *\n * @returns A merged and normalized CSS class string.\n *\n * @example\n * ```ts\n * cn(\n *   \"p-2\",\n *   isActive && \"bg-blue-500\",\n *   [\"text-sm\", { \"font-bold\": isBold }],\n *   null,\n *   0\n * );\n * // => \"p-2 bg-blue-500 text-sm font-bold\"\n * ```\n *\n * @example\n * ```ts\n * cn(\"p-2 p-4\", { \"text-sm\": true, \"text-lg\": true });\n * // => \"p-4 text-lg\"\n * ```\n */\nexport const cnVer4 = (...values: ClassValues): string =>\n  twMergeV4(cx(...values));\n\nconst defaultTwMergeV3 = twMergeDefaultV3();\nconst defaultTwMergeV4 = twMergeDefaultV4();\n\n/** -------------------------------------------------------------\n * * ***Default `cnV3` utility (Tailwind v3).***\n * -------------------------------------------------------------\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 *\n * @deprecated ***Still supported, but significantly slower during hydration because it uses extended runtime merge logic, prefer {@link cnVer3 | `cnVer3`} for\n * better performance, this utility may be removed in a future release.***\n *\n * @param {ClassValues} classes - Class values (`string`, `array`, `object`, `etc`).\n * @returns {string} Merged Tailwind class string.\n *\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 *\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 *\n * @deprecated ***Still supported, but significantly slower during hydration because it uses extended runtime merge logic, prefer {@link cnVer4 | `cnVer4`} for\n * better performance, this utility may be removed in a future release.***\n *\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,IAAI,iBAAiB,MAAM,IAAI,SAAS,MAAM,EAC5C,OAAO;MACF,IAAI,gBAAgB,MAAM,EAC/B,IACE,eAAe,MAAM,IACrB,eAAe,MAAM,IACrB,gBAAgB,MAAM,EACtB;EACA,MAAM,MAAM,MAAM,SAAS;EAC3B,IAAI,KAAK,OAAO;QACX,IAAI,QAAQ,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,CAAC,cAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,IAAI,EACF,QACA,QACA,QACA,UACA,WACA,+BACE;CAEJ,IAAI,CAAC,cAAc,OAAO,EAAE,SAAS,EAAE;CACvC,IAAI,CAAC,cAAc,OAAO,EAAE,SAAS,EAAE;CACvC,IAAI,CAAC,cAAc,SAAS,EAAE,WAAW,EAAE;CAC3C,IAAI,CAAC,SAAS,UAAU,EAAE,YAAY;CACtC,IAAI,CAAC,iBAAiB,OAAO,EAAE,SAAS;CACxC,IAAI,CAAC,WAAW,2BAA2B,EACzC,6BAA6B;CAE/B,MAAM,QAAQ,WAAW,QAAQ,QAAQ,GAAG,OAAO,QAAQ,EAAE;CAC7D,MAAM,cAAc,WAAW,QAAQ,cAAc,GACjD,OAAO,cACP,EAAE;CACN,MAAM,iCAAiC,WACrC,QACA,iCACD,GACG,OAAO,iCACP,EAAE;CAEN,MAAM,yBAAyB,WAAW,QAAQ,yBAAyB,GACvE,OAAO,yBACP,EAAE;CACN,MAAM,0BACJ,WAAW,QAAQ,0BAA0B,IAC7C,gBAAgB,OAAO,wBAAwB,GAC3C,OAAO,0BACP,EAAE;CAER,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;;;;;ACxFH,MAAMA,kBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8FxC,MAAa,oBACX,UAA+B,EAAE,KACV;CACvB,IAAI,CAAC,cAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,MAAM,EACJ,WACA,aACA,QACA,gCACA,wBACA,UACA,QACA,OACA,+BACE,sBAAsB,QAAQ;CAElC,OAAO,oBAAoC;EACzC,QAAQ,UAAU,OAAO;EACzB,WAAW,aAAaA,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;;;;;ACjJJ,MAAM,gBAAgBC,oBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgGxC,MAAa,oBACX,UAA+B,EAAE,KACV;CACvB,IAAI,CAAC,cAAc,QAAQ,EAAE,UAAU,EAAE;CACzC,MAAM,EACJ,WACA,aACA,QACA,gCACA,wBACA,yBACA,UACA,QACA,OACA,+BACE,sBAAsB,QAAQ;CAElC,OAAOC,sBAAoC;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACxGJ,MAAa,gBACX,kBAAsCC,SACtC,GAAG,YACQ;CACX,IAAI,CAAC,WAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuF,eACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CxC,MAAa,gBACX,kBAAsCC,WACtC,GAAG,YACQ;CACX,IAAI,CAAC,WAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuF,eACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDxC,MAAa,cACX,iBACA,GAAG,YACQ;CACX,IAAI,CAAC,WAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuF,eACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDxC,MAAa,cACX,iBACA,GAAG,YACQ;CACX,IAAI,CAAC,WAAW,gBAAgB,EAC9B,MAAM,IAAI,UACR,uFAAuF,eACrF,gBACD,CAAC,KACH;CAGH,OAAO,gBAAgB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC/LxC,MAAa,UAAU,GAAG,WACxBC,QAAU,GAAG,GAAG,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmD1B,MAAa,UAAU,GAAG,WACxBC,UAAU,GAAG,GAAG,OAAO,CAAC;AAE1B,MAAM,mBAAmB,kBAAkB;AAC3C,MAAM,mBAAmB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+D3C,MAAa,QAAQ,GAAG,YAAiC;CACvD,OAAO,iBAAiB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DzC,MAAa,QAAQ,GAAG,YAAiC;CACvD,OAAO,iBAAiB,GAAG,GAAG,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrLzC,MAAa,qBACX,UAE+D;CAC/D,cAAc,OAAO,EACnB,UAAU,EAAE,aAAa,gBACvB,iDAAiD,UAAU,sBAAsB,YAAY,MAChG,CAAC;CAEF,MAAM,eAAoD,EAAE;CAE5D,MAAM,SAAS,GAAG,QAAQ;EACxB,IAAI,CAAC,SAAS,EAAE,EACd,aAAa,KAAK;GAChB,OAAO;GACP,QAAQ,6CAA6C,eAAe,GAAG,EACrE,YAAY,qBACb,CAAC,CAAC;GACJ,CAAC;OACG,IAAI,cAAc,EAAE,EACzB,aAAa,KAAK;GAChB,OAAO;GACP,QAAQ;GACT,CAAC;GAEJ;CAEF,IAAI,gBAAgB,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/{tailwind-DJ4cmLUw.cjs → tailwind-C1YtxJ-K.cjs}

@@ -2,15 +2,15 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.13.0-beta.2`
 *  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-amRiJHnh.cjs');
+const require_assertIsArray = require('./assertIsArray-BqjMoan3.cjs');
+const require_isEmptyString = require('./isEmptyString-DI64RQCy.cjs');
 let tailwind_merge_v3 = require("tailwind-merge-v3");
 let tailwind_merge_v4 = require("tailwind-merge-v4");
 function toStringValue(value) {
@@ -158,6 +158,14 @@ const twMergeDefaultV4 = (options = {}) => {
 		}
 	});
 };
+const customCnVer3 = (customTwMergeV3 = tailwind_merge_v3.twMerge, ...classes) => {
+	if (!require_assertIsBoolean.isFunction(customTwMergeV3)) throw new TypeError(`first Parameter (\`customTwMergeV3\`) must be of type \`function\`, but received: \`${require_assertIsBoolean.getPreciseType(customTwMergeV3)}\`.`);
+	return customTwMergeV3(cx(...classes));
+};
+const customCnVer4 = (customTwMergeV4 = tailwind_merge_v4.twMerge, ...classes) => {
+	if (!require_assertIsBoolean.isFunction(customTwMergeV4)) throw new TypeError(`first Parameter (\`customTwMergeV4\`) must be of type \`function\`, but received: \`${require_assertIsBoolean.getPreciseType(customTwMergeV4)}\`.`);
+	return customTwMergeV4(cx(...classes));
+};
 const customCnV3 = (customTwMergeV3, ...classes) => {
 	if (!require_assertIsBoolean.isFunction(customTwMergeV3)) throw new TypeError(`first Parameter (\`customTwMergeV3\`) must be of type \`function\`, but received: \`${require_assertIsBoolean.getPreciseType(customTwMergeV3)}\`.`);
 	return customTwMergeV3(cx(...classes));
@@ -166,6 +174,8 @@ const customCnV4 = (customTwMergeV4, ...classes) => {
 	if (!require_assertIsBoolean.isFunction(customTwMergeV4)) throw new TypeError(`first Parameter (\`customTwMergeV4\`) must be of type \`function\`, but received: \`${require_assertIsBoolean.getPreciseType(customTwMergeV4)}\`.`);
 	return customTwMergeV4(cx(...classes));
 };
+const cnVer3 = (...values) => (0, tailwind_merge_v3.twMerge)(cx(...values));
+const cnVer4 = (...values) => (0, tailwind_merge_v4.twMerge)(cx(...values));
 const defaultTwMergeV3 = twMergeDefaultV3();
 const defaultTwMergeV4 = twMergeDefaultV4();
 const cnV3 = (...classes) => {
@@ -208,6 +218,18 @@ Object.defineProperty(exports, 'cnV4', {
     return cnV4;
   }
 });
+Object.defineProperty(exports, 'cnVer3', {
+  enumerable: true,
+  get: function () {
+    return cnVer3;
+  }
+});
+Object.defineProperty(exports, 'cnVer4', {
+  enumerable: true,
+  get: function () {
+    return cnVer4;
+  }
+});
 Object.defineProperty(exports, 'customCnV3', {
   enumerable: true,
   get: function () {
@@ -220,6 +242,18 @@ Object.defineProperty(exports, 'customCnV4', {
     return customCnV4;
   }
 });
+Object.defineProperty(exports, 'customCnVer3', {
+  enumerable: true,
+  get: function () {
+    return customCnVer3;
+  }
+});
+Object.defineProperty(exports, 'customCnVer4', {
+  enumerable: true,
+  get: function () {
+    return customCnVer4;
+  }
+});
 Object.defineProperty(exports, 'cx', {
   enumerable: true,
   get: function () {
@@ -244,4 +278,4 @@ Object.defineProperty(exports, 'twMergeDefaultV4', {
     return twMergeDefaultV4;
   }
 });
-//# sourceMappingURL=tailwind-DJ4cmLUw.cjs.map
+//# sourceMappingURL=tailwind-C1YtxJ-K.cjs.map