@rzl-zone/utils-js 3.4.0 → 3.5.1

package/dist/chunk-D3ENH7H6.cjs

@@ -1 +1,101 @@
-"use strict";var e=require("./chunk-E55EQK2U.cjs"),r=require("./chunk-PZQ6I4JJ.cjs");exports.capitalizeFirst=(e,t={lowerCaseNextRest:!0,trim:!1})=>{if(!r.isNonEmptyString(e))return"";r.isPlainObject(t)||(t={});const i=!1!==t.lowerCaseNextRest;return!0===t.trim&&(e=e.trim()),e[0].toUpperCase()+(i?e.slice(1).toLowerCase():e.slice(1))},exports.capitalizeWords=(e,t={collapseSpaces:!1,trim:!1})=>{if(!r.isNonEmptyString(e))return"";let i=e;r.isPlainObject(t)||(t={});const s=!0===t.collapseSpaces;if(!0===t.trim&&(i=i.trim()),s){const e=i.match(/^\s*/)?.[0]??"",r=i.match(/\s*$/)?.[0]??"";i=i.trim().replace(/\s+/g," "),i=`${e}${i}${r}`}return i.toLowerCase().split(" ").map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(" ")},exports.getInitialsName=e=>{if(!r.isNonEmptyString(e))return"";const t=(e=e.replace(/\s+/g," ").trim()).split(" ");return t.length>1?t[0][0]+t[1][0].toUpperCase():e.length>1?e.substring(0,2).toUpperCase():e[0].toUpperCase()},exports.replaceAt=(e,t,i)=>{if(!r.isNumber(e)||!r.isString(i)||!r.isString(t))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': \`${r.getPreciseType(e)}\`, 'originalString': \`${r.getPreciseType(t)}\`, 'replaceTo': \`${r.getPreciseType(i)}\`]".`);if(e<0||e>=t.length)throw new RangeError("First parameter (`index`) is out of range from second parameter (`originalString`).");return t.slice(0,e)+i+t.slice(e+1)},exports.stripHtmlTags=function(t){if(!r.isString(t))return;return e.isEmptyString(t)?"":t.replace(/<\/?[a-zA-Z][^<>]*\/?>/g," ").trim().replace(/\s+/g," ").trim()};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkE55EQK2U_cjs = require('./chunk-E55EQK2U.cjs');
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var capitalizeFirst = (string, options = {
+  lowerCaseNextRest: true,
+  trim: false
+}) => {
+  if (!chunkPZQ6I4JJ_cjs.isNonEmptyString(string)) return "";
+  if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) {
+    options = {};
+  }
+  const lowerCaseNextRest = options.lowerCaseNextRest !== false;
+  const trim = options.trim === true;
+  if (trim) string = string.trim();
+  return string[0].toUpperCase() + (lowerCaseNextRest ? string.slice(1).toLowerCase() : string.slice(1));
+};
+
+var capitalizeWords = (value, options = {
+  collapseSpaces: false,
+  trim: false
+}) => {
+  if (!chunkPZQ6I4JJ_cjs.isNonEmptyString(value)) return "";
+  let result = value;
+  if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) {
+    options = {};
+  }
+  const collapseSpaces = options.collapseSpaces === true;
+  const trim = options.trim === true;
+  if (trim) {
+    result = result.trim();
+  }
+  if (collapseSpaces) {
+    const leadingSpaces = result.match(/^\s*/)?.[0] ?? "";
+    const trailingSpaces = result.match(/\s*$/)?.[0] ?? "";
+    result = result.trim().replace(/\s+/g, " ");
+    result = `${leadingSpaces}${result}${trailingSpaces}`;
+  }
+  return result.toLowerCase().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+};
+
+function stripHtmlTags(input) {
+  if (!chunkPZQ6I4JJ_cjs.isString(input)) {
+    return void 0;
+  }
+  if (chunkE55EQK2U_cjs.isEmptyString(input)) {
+    return "";
+  }
+  const stripped = input.replace(/<\/?[a-zA-Z][^<>]*\/?>/g, " ").trim();
+  const cleaned = stripped.replace(/\s+/g, " ").trim();
+  return cleaned;
+}
+
+var getInitialsName = (name) => {
+  if (!chunkPZQ6I4JJ_cjs.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() : (
+    // First two letters for single-word names
+    name[0].toUpperCase()
+  );
+};
+
+var replaceAt = (index, originalString, replaceTo) => {
+  if (!chunkPZQ6I4JJ_cjs.isNumber(index) || !chunkPZQ6I4JJ_cjs.isString(replaceTo) || !chunkPZQ6I4JJ_cjs.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': \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        index
+      )}\`, 'originalString': \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        originalString
+      )}\`, 'replaceTo': \`${chunkPZQ6I4JJ_cjs.getPreciseType(replaceTo)}\`]".`
+    );
+  }
+  if (index < 0 || index >= originalString.length) {
+    throw new RangeError(
+      `First parameter (\`index\`) is out of range from second parameter (\`originalString\`).`
+    );
+  }
+  return originalString.slice(0, index) + // Extract before the index
+  replaceTo + // Insert replacement
+  originalString.slice(index + 1);
+};
+
+exports.capitalizeFirst = capitalizeFirst;
+exports.capitalizeWords = capitalizeWords;
+exports.getInitialsName = getInitialsName;
+exports.replaceAt = replaceAt;
+exports.stripHtmlTags = stripHtmlTags;

package/dist/chunk-DEZZUYE2.js

@@ -1 +1,152 @@
-import{isInteger as e}from"./chunk-WVSPXFTY.js";import{safeStableStringify as r}from"./chunk-PET42Z7W.js";import{isNonEmptyArray as t,getPreciseType as n,isNumber as a,isPlainObject as m,assertIsBoolean as i,isNaN as h}from"./chunk-CMW2TBOQ.js";function o(e){if(!t(e))return;return e[Math.floor(Math.random()*(e.length||0))]}var u=(t,a)=>{if(!e(t)||!e(a))throw new TypeError(`First parameter (\`min\`) and second parameter (\`max\`) must be of type \`integer-number\`${c(t,a)}value, but received: ['min': \`${n(t)}\` - (with value: \`${r(t)})\`, 'max': \`${n(a)}\` - (with value: \`${r(a)}\`)].`);if(t>a)throw new RangeError(`First parameter (\`min\`) must be less than or equal to second parameter (\`max\`), but received: ['min': ${s(t)}, 'max': ${s(a)}].`);return t=Math.max(1,t),a=Math.min(Number.MAX_SAFE_INTEGER,a),Math.floor(Math.random()*(a-t+1))+t},s=e=>a(e,{includeNaN:!0})?e===Number.MIN_VALUE?"`Number.MIN_VALUE`":`${e}`:`\`${n(e)}\``,c=(...e)=>e.some(e=>a(e,{includeNaN:!0})&&e===Number.MIN_VALUE)?" and can't be `Number.MIN_VALUE` ":" ",g=t=>{m(t)||(t={});const{minLength:a=1,maxLength:h=16,avoidZero:o=!1}=t;if(i(o,{message:({currentType:e,validType:r})=>`Parameters \`avoidZero\` must be of type \`${r}\`, but received: \`${e}\`.`}),!e(a)||!e(h))throw new TypeError(`Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${n(a)}\` - (with value: ${r(a)}), 'maxLength': \`${n(h)}\` - (with value: ${r(h)})].`);if(a<1||h>16||a>h)throw new RangeError(`Invalid range at parameters \`minLength\` must be ≥ 1, \`maxLength\` must be ≤ 16, and \`minLength\` ≤ \`maxLength\`, but received: ['minLength': \`${a}\`, 'maxLength': \`${h}\`].`);const s=a===h?a:u(a,h),c=10**(s-1);let g=u(c,10**s-1);return o&&0===g&&(g=c),g},p=t=>{m(t)||(t={});const{minLength:a=40,maxLength:o=40,type:s="string",avoidWhiteSpace:c=!0}=t;if(i(c,{message:({currentType:e,validType:r})=>`Parameters \`avoidWhiteSpace\` property of the \`options\` (first-parameter) must be of type \`${r}\`, but received: \`${e}\`.`}),!e(a)||!e(o))throw new TypeError(`Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${n(a)}\` - (with value: ${r(a)}), 'maxLength': \`${n(o)}\` - (with value: ${r(o)})].`);if(a<1||o>5e3||a>o)throw new RangeError(`Invalid range at parameters \`minLength\` must be ≥ 1, \`maxLength\` must be ≤ 5000, and \`minLength\` ≤ \`maxLength\`, but received: ['minLength': \`${a}\`, 'maxLength': \`${o}\`].`);if("string"!==s&&"number"!==s)throw new TypeError(`Parameter \`type\` must be of type \`string\` with value one of "string" | "number", but received: \`${n(s)}\`, with value: ${r(s)}.`);const g=u(a,o),p="number"===s?(h(Number(t.replaceGenInt))?void 0:t.replaceGenInt)??"0123456789":(t.replaceGenStr?t.replaceGenStr:void 0)??"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",d=(l=p,(c?l.replace(/\s|\n|\t/g,""):l)+(t.addChar||""));var l;if(!d.length){throw new Error(`Character set is empty. ${(()=>"number"===s?c?"If `avoidWhiteSpace` is true, and `replaceGenInt` cant be empty-string value, ensure `replaceGenInt` has valid characters and non-nan string number.":"Ensure `replaceGenInt` has valid characters and not a NaN number string while convert to number.":"Ensure `replaceGenStr` has valid characters and non empty string.")()}`)}let b="";for(let e=0;e<g;e++)b+=d.charAt(Math.floor(Math.random()*d.length));return b};export{o as getRandomItem,u as randomInt,g as randomIntByLength,p as randomStr};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+import { isInteger } from './chunk-WVSPXFTY.js';
+import { safeStableStringify } from './chunk-PET42Z7W.js';
+import { isNonEmptyArray, getPreciseType, isNumber, isPlainObject, assertIsBoolean, isNaN } from './chunk-CMW2TBOQ.js';
+
+function getRandomItem(array) {
+  if (!isNonEmptyArray(array)) return void 0;
+  const randomIndex = Math.floor(Math.random() * (array.length || 0));
+  return array[randomIndex];
+}
+
+var randomInt = (min, max) => {
+  if (!isInteger(min) || !isInteger(max)) {
+    throw new TypeError(
+      `First parameter (\`min\`) and second parameter (\`max\`) must be of type \`integer-number\`${minValueNote(
+        min,
+        max
+      )}value, but received: ['min': \`${getPreciseType(
+        min
+      )}\` - (with value: \`${safeStableStringify(min)})\`, 'max': \`${getPreciseType(
+        max
+      )}\` - (with value: \`${safeStableStringify(max)}\`)].`
+    );
+  }
+  if (min > max) {
+    throw new RangeError(
+      `First parameter (\`min\`) must be less than or equal to second parameter (\`max\`), but received: ['min': ${formatValue(
+        min
+      )}, 'max': ${formatValue(max)}].`
+    );
+  }
+  min = Math.max(1, min);
+  max = Math.min(Number.MAX_SAFE_INTEGER, max);
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+};
+var formatValue = (value) => {
+  return isNumber(value, { includeNaN: true }) ? value === Number.MIN_VALUE ? "`Number.MIN_VALUE`" : `${value}` : `\`${getPreciseType(value)}\``;
+};
+var minValueNote = (...values) => {
+  return values.some((v) => isNumber(v, { includeNaN: true }) && v === Number.MIN_VALUE) ? " and can't be `Number.MIN_VALUE` " : " ";
+};
+
+var randomIntByLength = (options) => {
+  if (!isPlainObject(options)) {
+    options = {};
+  }
+  const { minLength = 1, maxLength = 16, avoidZero = false } = options;
+  assertIsBoolean(avoidZero, {
+    message({ currentType, validType }) {
+      return `Parameters \`avoidZero\` must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  if (!isInteger(minLength) || !isInteger(maxLength)) {
+    throw new TypeError(
+      `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${getPreciseType(
+        minLength
+      )}\` - (with value: ${safeStableStringify(
+        minLength
+      )}), 'maxLength': \`${getPreciseType(
+        maxLength
+      )}\` - (with value: ${safeStableStringify(maxLength)})].`
+    );
+  }
+  if (minLength < 1 || maxLength > 16 || minLength > maxLength) {
+    throw new RangeError(
+      `Invalid range at parameters \`minLength\` must be \u2265 1, \`maxLength\` must be \u2264 16, and \`minLength\` \u2264 \`maxLength\`, but received: ['minLength': \`${minLength}\`, 'maxLength': \`${maxLength}\`].`
+    );
+  }
+  const randomLength = minLength === maxLength ? minLength : randomInt(minLength, maxLength);
+  const minValue = 10 ** (randomLength - 1);
+  const maxValue = 10 ** randomLength - 1;
+  let result = randomInt(minValue, maxValue);
+  if (avoidZero && result === 0) {
+    result = minValue;
+  }
+  return result;
+};
+
+var randomStr = (options) => {
+  if (!isPlainObject(options)) {
+    options = {};
+  }
+  const {
+    minLength = 40,
+    maxLength = 40,
+    type = "string",
+    avoidWhiteSpace = true
+  } = options;
+  assertIsBoolean(avoidWhiteSpace, {
+    message({ currentType, validType }) {
+      return `Parameters \`avoidWhiteSpace\` property of the \`options\` (first-parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  if (!isInteger(minLength) || !isInteger(maxLength)) {
+    throw new TypeError(
+      `Parameters \`minLength\` and \`maxLength\` must be of type \`integer-number\`, but received: ['minLength': \`${getPreciseType(
+        minLength
+      )}\` - (with value: ${safeStableStringify(
+        minLength
+      )}), 'maxLength': \`${getPreciseType(
+        maxLength
+      )}\` - (with value: ${safeStableStringify(maxLength)})].`
+    );
+  }
+  if (minLength < 1 || maxLength > 5e3 || minLength > maxLength) {
+    throw new RangeError(
+      `Invalid range at parameters \`minLength\` must be \u2265 1, \`maxLength\` must be \u2264 5000, and \`minLength\` \u2264 \`maxLength\`, but received: ['minLength': \`${minLength}\`, 'maxLength': \`${maxLength}\`].`
+    );
+  }
+  if (type !== "string" && type !== "number") {
+    throw new TypeError(
+      `Parameter \`type\` must be of type \`string\` with value one of "string" | "number", but received: \`${getPreciseType(
+        type
+      )}\`, with value: ${safeStableStringify(type)}.`
+    );
+  }
+  const length = randomInt(minLength, maxLength);
+  const cleanCharacters = (charSet) => {
+    return avoidWhiteSpace ? charSet.replace(/\s|\n|\t/g, "") : charSet;
+  };
+  const defaultNumberSet = "0123456789";
+  const defaultStringSet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  const baseCharSet = type === "number" ? (!isNaN(Number(options.replaceGenInt)) ? options.replaceGenInt : void 0) ?? defaultNumberSet : (options.replaceGenStr ? options.replaceGenStr : void 0) ?? defaultStringSet;
+  const characterSet = cleanCharacters(baseCharSet) + (options.addChar || "");
+  if (!characterSet.length) {
+    const errCharSet = () => {
+      if (type === "number") {
+        if (avoidWhiteSpace) {
+          return `If \`avoidWhiteSpace\` is true, and \`replaceGenInt\` cant be empty-string value, ensure \`replaceGenInt\` has valid characters and non-nan string number.`;
+        }
+        return `Ensure \`replaceGenInt\` has valid characters and not a NaN number string while convert to number.`;
+      }
+      return `Ensure \`replaceGenStr\` has valid characters and non empty string.`;
+    };
+    throw new Error(`Character set is empty. ${errCharSet()}`);
+  }
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += characterSet.charAt(Math.floor(Math.random() * characterSet.length));
+  }
+  return result;
+};
+
+export { getRandomItem, randomInt, randomIntByLength, randomStr };

package/dist/chunk-DVMHRLKP.cjs

@@ -1 +1,16 @@
-"use strict";exports.isInteger=function(e){return"number"==typeof e&&Number.isInteger(e)};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+function isInteger(value) {
+  return typeof value === "number" && Number.isInteger(value);
+}
+
+exports.isInteger = isInteger;

package/dist/chunk-DWF2R5GD.cjs

@@ -1 +1,225 @@
-"use strict";var e=require("./chunk-KHO2SBNA.cjs"),r=require("./chunk-E74U6CYP.cjs"),t=require("./chunk-NRF6LWBC.cjs"),n=require("./chunk-HQWOFR56.cjs"),i=require("./chunk-DVMHRLKP.cjs"),a=require("./chunk-H66AC7GK.cjs"),s=require("./chunk-E55EQK2U.cjs"),o=require("./chunk-6JFZL7YE.cjs"),u=require("./chunk-T7PU2V7X.cjs"),c=require("./chunk-PZQ6I4JJ.cjs");exports.constructURL=(i,a,m)=>{if(c.isString(i)){if(s.isEmptyString(i))throw new TypeError("First parameter (`baseUrl`) cannot be an empty-string.");i=r.normalizeString(i)}else if(!e.isURL(i))throw new TypeError(`First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${c.getPreciseType(i)}\`, with current value: \`${u.safeStableStringify(i)}\`.`);if(!c.isUndefined(m)&&(o.assertIsArray(m,{message:({currentType:e,validType:r})=>`Third parameter (\`removeParams\`) must be of type \`${r} of strings\`, but received: \`${e}\`.`}),!m.every(e=>c.isNonEmptyString(e))))throw new TypeError("Third parameter (`removeParams`) must be of type `array` and contains `string` only and non empty-string.");try{if(!c.isUndefined(a)&&!c.isFunction(a[Symbol.iterator]))throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${c.getPreciseType(a)}\`, with value: \`${u.safeStableStringify(a)}\`.`);const e=new URL(i);if(!c.isUndefined(a)){const r=Object.fromEntries(a);if(!n.isEmptyValue(r)){const n=new URLSearchParams(e.search);for(const[e,t]of Object.entries(r)){if(!c.isNonEmptyString(t)&&!c.isNumber(t,{includeNaN:!0}))throw new TypeError(`Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${c.getPreciseType(a)}\`, with value: \`${u.safeStableStringify(a)}\`.`);n.set(e,String(t))}m?.length&&t.toStringArrayUnRecursive(m).map(e=>{n.delete(e)}),e.search=n.toString()}}return m?.forEach(r=>e.searchParams.delete(r)),e}catch(e){if(c.isError(e))throw e;throw new Error("Failed to construct a valid URL in `constructURL()`, Error:"+e)}},exports.extractURLs=e=>{if(!c.isNonEmptyString(e))return null;let r;try{r=decodeURIComponent(e)}catch{return null}const t=r.match(/https?:\/\/.*?(?=https?:\/\/|\s|$)/g);if(!t)return null;const n=t.map(e=>e.replace(/[.,;:!?)]*$/,"")).filter(e=>{try{const r=new URL(e);return"http:"===r.protocol||"https:"===r.protocol}catch{return!1}});return n.length?n:null},exports.getFirstPrefixPathname=(e,r="/")=>{if(!c.isNonEmptyString(r))throw new TypeError(`Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${c.getPreciseType(r)}\`, with value: \`${u.safeStableStringify(r)}\`.`);if(c.isArray(e)){if(!e.every(e=>c.isString(e)))throw new TypeError(`First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${c.getPreciseType(e)}\`, with value: \`${u.safeStableStringify(e)}\`.`);for(const r of e){const e=a.normalizePathname(r);if("/"!==e)return e}return a.normalizePathname(r)}if(c.isString(e)){const t=a.normalizePathname(e);return"/"!==t?t:a.normalizePathname(r)}if(!c.isNil(e))throw new TypeError(`First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${c.getPreciseType(e)}\`.`);return a.normalizePathname(r)},exports.getPrefixPathname=(e,r=null,t={})=>{const n=[];c.isString(e)||c.isArray(e)||n.push(`First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${c.getPreciseType(e)}\`.`),c.isString(r)||c.isArray(r)||c.isNull(r)||n.push(`Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${c.getPreciseType(r)}\`.`),c.isPlainObject(t)||n.push(`Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${c.getPreciseType(t)}\`.`);const{levels:s=1,removeDuplicates:o=!0}=t;if((!i.isInteger(s)||i.isInteger(s)&&s<0)&&n.push(`Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${c.getPreciseType(s)}\`, with value: \`${u.safeStableStringify(s)}\`.`),c.isBoolean(o)||n.push(`Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${c.getPreciseType(o)}\`.`),c.isNonEmptyArray(n))throw new TypeError(`Invalid parameter(s) in \`getPrefixPathname\` function:\n- ${n.join("\n- ")}`);function m(e){return`/${a.normalizePathname(e).split("/").filter(Boolean).slice(0,s).join("/")}`}function p(e){if(r){if(e=a.normalizePathname(e),c.isArray(r)){for(const t of r)if(e.startsWith(a.normalizePathname(t)))return m(e)}else if(c.isNonEmptyString(r)&&e.startsWith(a.normalizePathname(r)))return m(e);return null}return m(e)}if(c.isArray(e)){const r=e.map(p).filter(e=>!c.isNull(e)),t=o?[...new Set(r)]:r;return 1===t.length?t[0]:t}return p(e)};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkKHO2SBNA_cjs = require('./chunk-KHO2SBNA.cjs');
+var chunkE74U6CYP_cjs = require('./chunk-E74U6CYP.cjs');
+var chunkNRF6LWBC_cjs = require('./chunk-NRF6LWBC.cjs');
+var chunkHQWOFR56_cjs = require('./chunk-HQWOFR56.cjs');
+var chunkDVMHRLKP_cjs = require('./chunk-DVMHRLKP.cjs');
+var chunkH66AC7GK_cjs = require('./chunk-H66AC7GK.cjs');
+var chunkE55EQK2U_cjs = require('./chunk-E55EQK2U.cjs');
+var chunk6JFZL7YE_cjs = require('./chunk-6JFZL7YE.cjs');
+var chunkT7PU2V7X_cjs = require('./chunk-T7PU2V7X.cjs');
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var constructURL = (baseUrl, queryParams, removeParams) => {
+  if (chunkPZQ6I4JJ_cjs.isString(baseUrl)) {
+    if (chunkE55EQK2U_cjs.isEmptyString(baseUrl)) {
+      throw new TypeError(`First parameter (\`baseUrl\`) cannot be an empty-string.`);
+    }
+    baseUrl = chunkE74U6CYP_cjs.normalizeString(baseUrl);
+  } else if (!chunkKHO2SBNA_cjs.isURL(baseUrl)) {
+    throw new TypeError(
+      `First parameter (\`baseUrl\`) must be of type an URL instance or a \`string\` and a non empty-string, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        baseUrl
+      )}\`, with current value: \`${chunkT7PU2V7X_cjs.safeStableStringify(baseUrl)}\`.`
+    );
+  }
+  if (!chunkPZQ6I4JJ_cjs.isUndefined(removeParams)) {
+    chunk6JFZL7YE_cjs.assertIsArray(removeParams, {
+      message: ({ currentType, validType }) => `Third parameter (\`removeParams\`) must be of type \`${validType} of strings\`, but received: \`${currentType}\`.`
+    });
+    if (!removeParams.every((param) => chunkPZQ6I4JJ_cjs.isNonEmptyString(param))) {
+      throw new TypeError(
+        `Third parameter (\`removeParams\`) must be of type \`array\` and contains \`string\` only and non empty-string.`
+      );
+    }
+  }
+  try {
+    if (!chunkPZQ6I4JJ_cjs.isUndefined(queryParams) && !chunkPZQ6I4JJ_cjs.isFunction(queryParams[Symbol.iterator])) {
+      throw new TypeError(
+        `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+          queryParams
+        )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(queryParams)}\`.`
+      );
+    }
+    const urlInstance = new URL(baseUrl);
+    if (!chunkPZQ6I4JJ_cjs.isUndefined(queryParams)) {
+      const paramObject = Object.fromEntries(queryParams);
+      if (!chunkHQWOFR56_cjs.isEmptyValue(paramObject)) {
+        const mergedParams = new URLSearchParams(urlInstance.search);
+        for (const [key, value] of Object.entries(paramObject)) {
+          if (!chunkPZQ6I4JJ_cjs.isNonEmptyString(value) && !chunkPZQ6I4JJ_cjs.isNumber(value, { includeNaN: true })) {
+            throw new TypeError(
+              `Second parameter (\`queryParams\`) must be iterable (like URLSearchParams.entries() or an array of [[string, string | number]...]), but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+                queryParams
+              )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(queryParams)}\`.`
+            );
+          }
+          mergedParams.set(key, String(value));
+        }
+        if (removeParams?.length) {
+          chunkNRF6LWBC_cjs.toStringArrayUnRecursive(removeParams).map((paramKey) => {
+            mergedParams.delete(paramKey);
+          });
+        }
+        urlInstance.search = mergedParams.toString();
+      }
+    }
+    removeParams?.forEach((param) => urlInstance.searchParams.delete(param));
+    return urlInstance;
+  } catch (error) {
+    if (chunkPZQ6I4JJ_cjs.isError(error)) throw error;
+    throw new Error(
+      "Failed to construct a valid URL in `constructURL()`, Error:" + error
+    );
+  }
+};
+
+var extractURLs = (url) => {
+  if (!chunkPZQ6I4JJ_cjs.isNonEmptyString(url)) return null;
+  let decoded;
+  try {
+    decoded = decodeURIComponent(url);
+  } catch {
+    return null;
+  }
+  const urlPattern = /https?:\/\/.*?(?=https?:\/\/|\s|$)/g;
+  const matches = decoded.match(urlPattern);
+  if (!matches) return null;
+  const cleaned = matches.map((url2) => url2.replace(/[.,;:!?)]*$/, "")).filter((url2) => {
+    try {
+      const u = new URL(url2);
+      return u.protocol === "http:" || u.protocol === "https:";
+    } catch {
+      return false;
+    }
+  });
+  return cleaned.length ? cleaned : null;
+};
+
+var getFirstPrefixPathname = (result, defaultValue = "/") => {
+  if (!chunkPZQ6I4JJ_cjs.isNonEmptyString(defaultValue)) {
+    throw new TypeError(
+      `Second parameter (\`defaultValue\`) must be of type \`string\` and not an \`empty-string\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        defaultValue
+      )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(defaultValue)}\`.`
+    );
+  }
+  if (chunkPZQ6I4JJ_cjs.isArray(result)) {
+    if (!result.every((item) => chunkPZQ6I4JJ_cjs.isString(item))) {
+      throw new TypeError(
+        `First parameter (\`result\`) must be of type \`string\` or \`array of string\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+          result
+        )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(result)}\`.`
+      );
+    }
+    for (const item of result) {
+      const normalized = chunkH66AC7GK_cjs.normalizePathname(item);
+      if (normalized !== "/") {
+        return normalized;
+      }
+    }
+    return chunkH66AC7GK_cjs.normalizePathname(defaultValue);
+  }
+  if (chunkPZQ6I4JJ_cjs.isString(result)) {
+    const normalized = chunkH66AC7GK_cjs.normalizePathname(result);
+    return normalized !== "/" ? normalized : chunkH66AC7GK_cjs.normalizePathname(defaultValue);
+  }
+  if (!chunkPZQ6I4JJ_cjs.isNil(result)) {
+    throw new TypeError(
+      `First parameter (\`result\`) must be of type \`string\`, \`array-string\`, \`null\` or \`undefined\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        result
+      )}\`.`
+    );
+  }
+  return chunkH66AC7GK_cjs.normalizePathname(defaultValue);
+};
+
+var getPrefixPathname = (url, base = null, options = {}) => {
+  const errors = [];
+  if (!chunkPZQ6I4JJ_cjs.isString(url) && !chunkPZQ6I4JJ_cjs.isArray(url)) {
+    errors.push(
+      `First parameter (\`url\`) must be of type \`string\` or \`array-string\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        url
+      )}\`.`
+    );
+  }
+  if (!chunkPZQ6I4JJ_cjs.isString(base) && !chunkPZQ6I4JJ_cjs.isArray(base) && !chunkPZQ6I4JJ_cjs.isNull(base)) {
+    errors.push(
+      `Second parameter (\`base\`) must be of type \`string\`, \`array-string\` or \`null\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        base
+      )}\`.`
+    );
+  }
+  if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) {
+    errors.push(
+      `Second parameter (\`options\`) must be of type \`plain-object\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        options
+      )}\`.`
+    );
+  }
+  const { levels = 1, removeDuplicates = true } = options;
+  if (!chunkDVMHRLKP_cjs.isInteger(levels) || chunkDVMHRLKP_cjs.isInteger(levels) && levels < 0) {
+    errors.push(
+      `Parameter \`levels\` property of the \`options\` (second parameter) must be of type \`integer-number\` and minimum is \`0\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        levels
+      )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(levels)}\`.`
+    );
+  }
+  if (!chunkPZQ6I4JJ_cjs.isBoolean(removeDuplicates)) {
+    errors.push(
+      `Parameter \`removeDuplicates\` property of the \`options\` (second parameter) must be of type \`boolean\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        removeDuplicates
+      )}\`.`
+    );
+  }
+  if (chunkPZQ6I4JJ_cjs.isNonEmptyArray(errors)) {
+    throw new TypeError(
+      `Invalid parameter(s) in \`getPrefixPathname\` function:
+- ${errors.join("\n- ")}`
+    );
+  }
+  function getLevel(singleUrl) {
+    const parts = chunkH66AC7GK_cjs.normalizePathname(singleUrl).split("/").filter(Boolean);
+    return `/${parts.slice(0, levels).join("/")}`;
+  }
+  function processUrl(singleUrl) {
+    if (base) {
+      singleUrl = chunkH66AC7GK_cjs.normalizePathname(singleUrl);
+      if (chunkPZQ6I4JJ_cjs.isArray(base)) {
+        for (const b of base) {
+          if (singleUrl.startsWith(chunkH66AC7GK_cjs.normalizePathname(b))) {
+            return getLevel(singleUrl);
+          }
+        }
+      } else if (chunkPZQ6I4JJ_cjs.isNonEmptyString(base) && singleUrl.startsWith(chunkH66AC7GK_cjs.normalizePathname(base))) {
+        return getLevel(singleUrl);
+      }
+      return null;
+    }
+    return getLevel(singleUrl);
+  }
+  if (chunkPZQ6I4JJ_cjs.isArray(url)) {
+    const result = url.map(processUrl).filter((r) => !chunkPZQ6I4JJ_cjs.isNull(r));
+    const uniqueResult = removeDuplicates ? [...new Set(result)] : result;
+    if (uniqueResult.length === 1) {
+      return uniqueResult[0];
+    }
+    return uniqueResult;
+  }
+  return processUrl(url);
+};
+
+exports.constructURL = constructURL;
+exports.extractURLs = extractURLs;
+exports.getFirstPrefixPathname = getFirstPrefixPathname;
+exports.getPrefixPathname = getPrefixPathname;

package/dist/chunk-E55EQK2U.cjs

@@ -1 +1,18 @@
-"use strict";var r=require("./chunk-PZQ6I4JJ.cjs");exports.isEmptyString=(t,i={})=>!r.isNonEmptyString(t,i);
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var isEmptyString = (value, options = {}) => {
+  return !chunkPZQ6I4JJ_cjs.isNonEmptyString(value, options);
+};
+
+exports.isEmptyString = isEmptyString;

package/dist/chunk-E74U6CYP.cjs

@@ -1 +1,18 @@
-"use strict";var r=require("./chunk-PZQ6I4JJ.cjs");exports.normalizeString=i=>r.isNonEmptyString(i)?i.trim():"";
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var normalizeString = (input) => {
+  return chunkPZQ6I4JJ_cjs.isNonEmptyString(input) ? input.trim() : "";
+};
+
+exports.normalizeString = normalizeString;

package/dist/chunk-EL6A35UR.cjs

@@ -1 +1,64 @@
-"use strict";var e=require("./chunk-VJDDGRIK.cjs"),t=require("./chunk-HYRQMTRH.cjs"),s=require("./chunk-PZQ6I4JJ.cjs");exports.disableUserInteraction=(s="on_processing")=>{if(e.isServer())return;t.assertIsString(s,{message:({validType:e,currentType:t})=>`First parameter \`className\` must be of type \`${e}\`, but received: \`${t}\`.`});const{documentElement:r}=document;r&&!r.classList.contains(s)&&r.classList.add(s)},exports.enableUserInteraction=(s="on_processing")=>{if(e.isServer())return;t.assertIsString(s,{message:({validType:e,currentType:t})=>`First parameter \`className\` must be of type \`${e}\`, but received: \`${t}\`.`});const{documentElement:r}=document;r&&r.classList.contains(s)&&r.classList.remove(s)},exports.removeElementFocus=()=>{if(e.isServer())return;const t=document.activeElement;t instanceof HTMLElement&&t.blur()},exports.scrollToTop=t=>{if(e.isServer())return;s.isPlainObject(t)||(t={});const r=s.hasOwnProp(t,"behavior")&&s.isNonEmptyString(t.behavior)&&["auto","instant","smooth"].includes(t.behavior)?t.behavior:"smooth";let o=s.hasOwnProp(t,"timeout")&&s.isNumber(t.timeout)&&t.timeout>=1?t.timeout:1;o=o>2147483647?2147483647:o,setTimeout(()=>window.scrollTo({top:0,left:0,behavior:r}),o)};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkVJDDGRIK_cjs = require('./chunk-VJDDGRIK.cjs');
+var chunkHYRQMTRH_cjs = require('./chunk-HYRQMTRH.cjs');
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var disableUserInteraction = (className = "on_processing") => {
+  if (chunkVJDDGRIK_cjs.isServer()) return;
+  chunkHYRQMTRH_cjs.assertIsString(className, {
+    message({ validType, currentType }) {
+      return `First parameter \`className\` must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  const { documentElement } = document;
+  if (documentElement && !documentElement.classList.contains(className)) {
+    documentElement.classList.add(className);
+  }
+};
+
+var enableUserInteraction = (className = "on_processing") => {
+  if (chunkVJDDGRIK_cjs.isServer()) return;
+  chunkHYRQMTRH_cjs.assertIsString(className, {
+    message({ validType, currentType }) {
+      return `First parameter \`className\` must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  const { documentElement } = document;
+  if (documentElement && documentElement.classList.contains(className)) {
+    documentElement.classList.remove(className);
+  }
+};
+
+var removeElementFocus = () => {
+  if (chunkVJDDGRIK_cjs.isServer()) return;
+  const activeElement = document.activeElement;
+  if (activeElement instanceof HTMLElement) {
+    activeElement.blur();
+  }
+};
+
+var scrollToTop = (options) => {
+  if (chunkVJDDGRIK_cjs.isServer()) return;
+  if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) {
+    options = {};
+  }
+  const behavior = chunkPZQ6I4JJ_cjs.hasOwnProp(options, "behavior") && chunkPZQ6I4JJ_cjs.isNonEmptyString(options.behavior) && ["auto", "instant", "smooth"].includes(options.behavior) ? options.behavior : "smooth";
+  let timeout = chunkPZQ6I4JJ_cjs.hasOwnProp(options, "timeout") && chunkPZQ6I4JJ_cjs.isNumber(options.timeout) && options.timeout >= 1 ? options.timeout : 1;
+  timeout = timeout > 2147483647 ? 2147483647 : timeout;
+  setTimeout(() => window.scrollTo({ top: 0, left: 0, behavior }), timeout);
+};
+
+exports.disableUserInteraction = disableUserInteraction;
+exports.enableUserInteraction = enableUserInteraction;
+exports.removeElementFocus = removeElementFocus;
+exports.scrollToTop = scrollToTop;