toolbox-x 1.2.0 → 2.0.0

package/dist/guards-DeO4ukiK.mjs

@@ -1,221 +0,0 @@
-/**
- * Copyright 2026 - present Nazmul Hassan
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { d as isString, m as isUndefined } from "./primitives-Djsevc69.mjs";
-import { a as normalizeNumber } from "./utilities-B9axOvOX.mjs";
-import { n as trimString } from "./basics-1_M7UvCn.mjs";
-
-//#region src/number/guards.ts
-/**
-* * Check if a number is even or not.
-*
-* @param input The number or numeric string to check.
-* @returns Boolean: `true` if even and `false` if not even.
-*/
-const isEven = (input) => {
-	const parsed = normalizeNumber(input);
-	if (isUndefined(parsed)) return false;
-	return parsed % 2 === 0;
-};
-/**
-* * Checks if a number is odd or not.
-*
-* @param input The number or numeric string to check.
-* @returns Boolean: `true` if odd and `false` if not odd.
-*/
-const isOdd = (input) => {
-	const parsed = normalizeNumber(input);
-	if (isUndefined(parsed)) return false;
-	return parsed % 2 !== 0;
-};
-/**
-* * Checks if a number is a multiple of another number.
-*
-* @param input - The number to check.
-* @param multipleOf - The number to check against.
-* @returns `true` if `input` is a multiple of `multipleOf`, otherwise `false`.
-*/
-const isMultiple = (input, multipleOf) => {
-	return input % multipleOf === 0;
-};
-/**
-* * Checks if a number is a perfect square.
-*
-* @param num The number to check.
-* @returns `true` if the number is a perfect square, otherwise `false`.
-*/
-function isPerfectSquare(num) {
-	return Number.isInteger(Math.sqrt(num));
-}
-/**
-* * Checks if a number is part of the Fibonacci sequence.
-*
-* @param num The number to check.
-* @returns `true` if the number is a Fibonacci number, otherwise `false`.
-*/
-function isFibonacci(num) {
-	return isPerfectSquare(5 * num * num + 4) || isPerfectSquare(5 * num * num - 4);
-}
-/**
-* * Checks whether any input is not a finite number.
-*
-* @param numbers - The list of numbers to validate.
-* @returns `true` if any input is not finite.
-*/
-function areInvalidNumbers(...numbers) {
-	return numbers?.some((n) => !Number.isFinite(n));
-}
-
-//#endregion
-//#region src/string/convert.ts
-/**
-* * Replaces all occurrences of a string or pattern in the given input string.
-*
-* - If `find` is a string, it is converted into a global regular expression (`/find/g`).
-* - If `find` is a `RegExp`, the global (`g`) flag is ensured.
-* - Trims the input before performing replacements.
-*
-* @param input - The string in which replacements should be performed.
-* @param find - The substring or regex pattern to search for.
-* @param replace - The string to replace matches with.
-* @returns The modified/refined string with replacements applied.
-*/
-const replaceAllInString = (input, find, replace) => {
-	const trimmedString = trimString(input);
-	const regex = isString(find) ? new RegExp(find, "g") : new RegExp(find, find?.flags.includes("g") ? find?.flags : find?.flags + "g");
-	return trimmedString?.replace(regex, replace);
-};
-/**
-* * Converts a string into a URL-friendly slug.
-* @param input - The string to be converted.
-* @returns The slugified string.
-*/
-const slugifyString = (input) => {
-	return trimString(normalizeString(input))?.toLowerCase()?.replace(/[^a-z0-9]+/g, "-")?.replace(/^-+|-+$/g, "");
-};
-/**
-* * Masks part of a string for privacy.
-* @param input - The string to mask.
-* @param options - Options for masking a string.
-* @returns The masked string.
-*/
-const maskString = (input, options) => {
-	const { start = 1, end = 1, maskCharacter: maskChar = "*" } = options || {};
-	const trimmedString = trimString(input);
-	if (trimmedString?.length <= start + end) return maskChar?.repeat(trimmedString?.length);
-	return trimmedString.slice(0, start) + maskChar?.repeat(trimmedString?.length - start - end) + (end > 0 ? trimmedString.slice(-end) : "");
-};
-/**
-* * Reverses a given string.
-* @param input - The string to reverse.
-* @returns The reversed string.
-*/
-const reverseString = (input) => {
-	return trimString(input)?.split("")?.reverse()?.join("");
-};
-/**
-* * Normalizes a string by removing diacritics (accents).
-* @param str The input string.
-* @returns The normalized string.
-*/
-function normalizeString(str) {
-	return str?.normalize("NFD")?.replace(/[\u0300-\u036f]/g, "");
-}
-/**
-* * Extracts all email addresses from a string.
-* @param str The input string.
-* @returns An array of extracted email addresses.
-*/
-function extractEmails(str) {
-	return str?.match(/[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g) || [];
-}
-/**
-* * Extracts all URLs from a string.
-* @param str The input string.
-* @returns An array of extracted URLs.
-*/
-function extractURLs(str) {
-	return str?.match(/https?:\/\/[^\s/$.?#].[^\s]*/g) || [];
-}
-/**
-* * Returns a grammatically correct unit string, optionally prefixed with the number.
-*
-* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
-*
-* @param count The numeric value to determine singular or plural.
-* @param unit The unit name (e.g., "day", "hour").
-* @param withNumber Whether to prefix the count before the unit. Defaults to `true`.
-* @returns Formatted unit string like `"1 day"`, `"2 months"`, or `"hour"`.
-*/
-function formatUnitWithPlural(count, unit, withNumber = true) {
-	const pluralized = Math.abs(count) === 1 ? unit : `${unit}s`;
-	return withNumber ? `${count} ${pluralized}` : pluralized;
-}
-
-//#endregion
-//#region src/string/guards.ts
-/**
-* * Checks if a string is a palindrome.
-* @param input - The string to check.
-* @returns True if the string is a palindrome, otherwise false.
-*/
-const isPalindrome = (input) => {
-	const normalized = input.toLowerCase().replace(/[^a-z0-9]/g, "");
-	return normalized === reverseString(normalized);
-};
-/**
-* * Checks if a string is in camelCase format.
-* @param str The string to check.
-* @returns `true` if the string is in camelCase, otherwise `false`.
-*/
-function isCamelCase(str) {
-	return /^[a-z]+([A-Z][a-z]*)*$/.test(str);
-}
-/**
-* * Checks if a string is in PascalCase format.
-* @param str The string to check.
-* @returns `true` if the string is in PascalCase, otherwise `false`.
-*/
-function isPascalCase(str) {
-	return /^[A-Z][a-zA-Z]*$/.test(str);
-}
-/**
-* * Checks if a string is in snake_case format.
-* @param str The string to check.
-* @returns `true` if the string is in snake_case, otherwise `false`.
-*/
-function isSnakeCase(str) {
-	return /^[a-z]+(_[a-z]+)*$/.test(str);
-}
-/**
-* * Checks if a string is in kebab-case format.
-* @param str The string to check.
-* @returns `true` if the string is in kebab-case, otherwise `false`.
-*/
-function isKebabCase(str) {
-	return /^[a-z]+(-[a-z]+)*$/.test(str);
-}
-/**
-* * Checks if a string contains only emojis.
-* @param str The string to check.
-* @returns `true` if the string contains only emojis, otherwise `false`.
-*/
-function isEmojiOnly(str) {
-	return /^[\p{Emoji}]+$/u.test(str);
-}
-
-//#endregion
-export { isFibonacci as _, isPascalCase as a, isPerfectSquare as b, extractURLs as c, normalizeString as d, replaceAllInString as f, isEven as g, areInvalidNumbers as h, isPalindrome as i, formatUnitWithPlural as l, slugifyString as m, isEmojiOnly as n, isSnakeCase as o, reverseString as p, isKebabCase as r, extractEmails as s, isCamelCase as t, maskString as u, isMultiple as v, isOdd as y };