toolbox-x 1.0.0

package/dist/convert-BOCgUv2D.cjs

@@ -0,0 +1,252 @@
+/**
+ * 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.
+ */
+
+const require_primitives = require('./primitives-B26uZolQ.cjs');
+const require_utilities = require('./utilities-CLUmdQeV.cjs');
+const require_basics = require('./basics-D_eSv0cu.cjs');
+
+//#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 = require_utilities.normalizeNumber(input);
+	if (require_primitives.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 = require_utilities.normalizeNumber(input);
+	if (require_primitives.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 = require_basics.trimString(input);
+	const regex = require_primitives.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 require_basics.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 = require_basics.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 require_basics.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.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox.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
+Object.defineProperty(exports, 'areInvalidNumbers', {
+  enumerable: true,
+  get: function () {
+    return areInvalidNumbers;
+  }
+});
+Object.defineProperty(exports, 'extractEmails', {
+  enumerable: true,
+  get: function () {
+    return extractEmails;
+  }
+});
+Object.defineProperty(exports, 'extractURLs', {
+  enumerable: true,
+  get: function () {
+    return extractURLs;
+  }
+});
+Object.defineProperty(exports, 'formatUnitWithPlural', {
+  enumerable: true,
+  get: function () {
+    return formatUnitWithPlural;
+  }
+});
+Object.defineProperty(exports, 'isEven', {
+  enumerable: true,
+  get: function () {
+    return isEven;
+  }
+});
+Object.defineProperty(exports, 'isFibonacci', {
+  enumerable: true,
+  get: function () {
+    return isFibonacci;
+  }
+});
+Object.defineProperty(exports, 'isMultiple', {
+  enumerable: true,
+  get: function () {
+    return isMultiple;
+  }
+});
+Object.defineProperty(exports, 'isOdd', {
+  enumerable: true,
+  get: function () {
+    return isOdd;
+  }
+});
+Object.defineProperty(exports, 'isPerfectSquare', {
+  enumerable: true,
+  get: function () {
+    return isPerfectSquare;
+  }
+});
+Object.defineProperty(exports, 'maskString', {
+  enumerable: true,
+  get: function () {
+    return maskString;
+  }
+});
+Object.defineProperty(exports, 'normalizeString', {
+  enumerable: true,
+  get: function () {
+    return normalizeString;
+  }
+});
+Object.defineProperty(exports, 'replaceAllInString', {
+  enumerable: true,
+  get: function () {
+    return replaceAllInString;
+  }
+});
+Object.defineProperty(exports, 'reverseString', {
+  enumerable: true,
+  get: function () {
+    return reverseString;
+  }
+});
+Object.defineProperty(exports, 'slugifyString', {
+  enumerable: true,
+  get: function () {
+    return slugifyString;
+  }
+});

package/dist/convert-Bn4jFomQ.mjs

@@ -0,0 +1,169 @@
+/**
+ * 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-KsFUp3kQ.mjs";
+import { a as normalizeNumber } from "./utilities-m5yFKqLd.mjs";
+import { n as trimString } from "./basics-Dp_aEK81.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.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox.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
+export { normalizeString as a, slugifyString as c, isFibonacci as d, isMultiple as f, maskString as i, areInvalidNumbers as l, isPerfectSquare as m, extractURLs as n, replaceAllInString as o, isOdd as p, formatUnitWithPlural as r, reverseString as s, extractEmails as t, isEven as u };