my-utils-kit/src/stringUtils.ts

A lightweight and type-safe utility library for working with strings, objects, array Performance methods in TypeScript. Includes helpful methods for deep cloning, object transformations, safe access, query string handling, and more — designed for modern J

export function camelCase(str: string) {
  let res: string[] = [];
  let capitalizeNext: boolean = false;
  for (let char of str.trim()) {
    if (/\s+/g.test(char)) capitalizeNext = true;
    else {
      res.push(capitalizeNext ? char.toUpperCase() : char.toLowerCase());
      capitalizeNext = false;
    }
  }
  return res.join("");
}

export function toSeperatedLowerCase(str: string, seperator: "_" | "-") {
  let res: string[] = [];
  let wasSpace = false;
  for (let char of str.trim()) {
    if (/\s+/g.test(char)) {
      if (!wasSpace) {
        res.push(seperator);
        wasSpace = true;
      }
    } else {
      res.push(char.toLowerCase());
      wasSpace = false;
    }
  }
  return res.join("");
}

export function kebabCase(str: string) {
  return toSeperatedLowerCase(str, "-");
}

export function snakeCase(str: string) {
  return toSeperatedLowerCase(str, "_");
}

export function pascalCase(str: string) {
  let res: string[] = [];
  let Capitalize = true;

  for (let char of str.trim()) {
    if (/\s+/g.test(char)) Capitalize = true;
    else {
      res.push(Capitalize ? char.toUpperCase() : char.toLowerCase());
      Capitalize = false;
    }
  }
  return res.join("");
}

export function titleCase(str: string) {
  let res: string[] = [];
  let wasSpace = true;

  for (let char of str.trim()) {
    if (/\s+/g.test(char)) {
      res.push(char);
      wasSpace = true;
    } else {
      res.push(wasSpace ? char.toUpperCase() : char.toLowerCase());
      wasSpace = false;
    }
  }
  return res.join("");
}

export function truncate(str: string, length: number, suffix: string = "...") {
  if (str.length <= length) return str;

  let res: string = str.slice(0, length);
  return res.endsWith(" ") ? res.trimEnd() + suffix : res + suffix;
}

export function reverseStr(str: string) {
  return str.split("").reverse().join("");
}

export function reverseWords(str: string) {
  return str
    .split(" ")
    .map((word) => word.split("").reverse().join(""))
    .join(" ");
}

export function capitalize(str: string) {
  if (!str) return "";
  return str[0].toUpperCase() + str.slice(1).toLowerCase();
}

export function unCapitalize(str: string) {
  if (!str) return "";
  return str[0].toLowerCase() + str.slice(1).toLowerCase();
}

export function padStart(str: string, length: number, char: string) {
  if (!str) throw new Error("string cannot be empty");
  if (str.length >= length) return str;
  let complement = length - str.length;
  return char.repeat(complement) + str;
}

export function padEnd(str: string, length: number, char: string) {
  if (!str) throw new Error("string cannot be empty");
  if (str.length >= length) return str;
  let complement = length - str.length;
  return str + char.repeat(complement);
}

export function isPalidrome(str: string): boolean {
  str = str.replace(/[^a-z0-9]/gi, "").toLowerCase();
  let left = 0;
  let right = str.length - 1;
  while (left <= right) {
    if (str[left] !== str[right]) return false;
    left++;
    right--;
  }
  return true;
}

export function countOccurences(str: string, char: string) {
  if (!str) throw new Error("String cannot be empty");
  let left = 0;
  let right = str.length - 1;
  let count = 0;

  while (left <= right) {
    if (str[left++] === char) count++;
    if (str[right--] === char) count++;
  }

  if (left === right && str[left] === char) count++;

  return count;
}

export function removeSpaces(str: string): string {
  return str.replace(/\s+/g, "");
}

export function removeSpecialChar(str: string) {
  return str.replace(/[^a-zA-Z0-9]/g, "");
}

export function escapeHTML(str: string): string {
  if (typeof str !== "string") return str;
  return str
    .replace(/&/g, "&amp;")
    .replace(/</g, "&lt;")
    .replace(/>/g, "&gt;")
    .replace(/"/g, "&quot;")
    .replace(/'/g, "&#039;");
}

export function unescapeHTML(str: string): string {
  return str
    .replace(/&amp;/g, "&")
    .replace(/&lt;/g, "<")
    .replace(/&gt;/g, ">")
    .replace(/&quot;/g, '"')
    .replace(/&#039;/g, "'");
}

export function slugify(str: string) {
  return str
    .toLowerCase()
    .replace(/[^a-z0-9\s-]/g, "")
    .replace(/\s+/g, "-")
    .replace(/-+/g, "-");
}

export function maskString(
  str: string,
  visibleCount: number = 4,
  maskChar: string = "*"
): string {
  if (visibleCount >= str.length) return str;

  let maskedLen = str.length - visibleCount;
  let maskedChar = maskChar.repeat(maskedLen);
  return maskedChar + str.slice(-visibleCount);
}

export function stripHTML(str: string) {
  return str.replace(/<[^>]*>/g, "");
}

export function removeDuplicate(str: string): string {
  return [...new Set(str)].join("");
}

export function toTitleCase(str: string): string {
  const smallWords = [
    "a",
    "an",
    "and",
    "but",
    "for",
    "nor",
    "of",
    "on",
    "or",
    "so",
    "the",
    "to",
    "up",
    "yet",
  ];

  return str
    .toLowerCase()
    .split(" ")
    .map((word, index) => {
      if (
        smallWords.includes(word) &&
        index !== 0 &&
        index !== str.split(" ").length - 1
      ) {
        return word;
      }
      return word.charAt(0).toUpperCase() + word.slice(1);
    })
    .join(" ");
}

export function isAnagrams(str1: string, str2: string): boolean {
  const cleanStr1 = str1.replace(/\s+/g, "").toLowerCase();
  const cleanStr2 = str2.replace(/\s+/g, "").toLowerCase();

  return (
    cleanStr1.split("").sort().join("") === cleanStr2.split("").sort().join("")
  );
}

export function findLongestWord(str: string) {
  return str
    .split(" ")
    .reduce(
      (longest, current) =>
        current.length > longest.length ? current : longest,
      ""
    );
}

export function countWords(str: string): number {
  return str.trim().split(/\s+/).length;
}

export function swapCase(str: string): string {
  return str
    .split("")
    .map((char) =>
      char === char.toUpperCase() ? char.toLowerCase() : char.toUpperCase()
    )
    .join("");
}

export function randomString(len: number): string {
  const res: string[] = [];

  while (res.length < len) {
    const charCode = Math.floor(Math.random() * (122 - 65 + 1)) + 65;
    const char = String.fromCharCode(charCode);
    if (/[a-zA-Z]/.test(char)) {
      res.push(char);
    }
  }

  return res.join("");
}

export function toAscii(char: string) {
  return char.charCodeAt(0);
}

export function fromAscii(code: number) {
  return String.fromCharCode(code);
}

export function toHex(char: string) {
  return char.charCodeAt(0).toString(16);
}

export function toBase64Unicode(str: string) {
  return btoa(unescape(encodeURIComponent(str)));
}

export function fromBase64Unicode(base64: string) {
  return decodeURIComponent(escape(atob(base64)));
}