stringzy 3.0.0 → 4.0.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export * from "./analyzing";
-export * from "./formatting";
-export * from "./transformations";
-export * from "./validations";
+export * from './analyzing';
+export * from './formatting';
+export * from './transformations';
+export * from './validations';
 declare const _default: {
     analyzing: {
         characterCount: typeof import("./analyzing").characterCount;
@@ -10,6 +10,8 @@ declare const _default: {
         readingDuration: typeof import("./analyzing").readingDuration;
         wordCount: typeof import("./analyzing").wordCount;
         stringSimilarity: typeof import("./analyzing").stringSimilarity;
+        patternCount: typeof import("./analyzing").patternCount;
+        vowelConsonantCount: typeof import("./analyzing").vowelConsonantCount;
     };
     formatting: {
         capitalize: typeof import("./formatting").capitalize;
@@ -33,8 +35,10 @@ declare const _default: {
         escapeHtml: typeof import("./transformations").escapeHtml;
         maskSegment: typeof import("./transformations").maskSegment;
         deburr: typeof import("./transformations/deburr").deburr;
+        numberToText: typeof import("./transformations").numberToText;
     };
     validations: {
+        isCoordinates: typeof import("./validations").isCoordinates;
         isDate: typeof import("./validations").isDate;
         isEmail: typeof import("./validations").isEmail;
         isEmpty: typeof import("./validations").isEmpty;
@@ -42,6 +46,7 @@ declare const _default: {
         isURL: typeof import("./validations").isURL;
         isIPv4: typeof import("./validations").isIPv4;
         isHexColor: typeof import("./validations").isHexColor;
+        isPalindrome: typeof import("./validations").isPalindrome;
     };
 };
 export default _default;

package/dist/tests/analyzing/patternCount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/analyzing/patternCount.test.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const patternCount_1 = require("../../analyzing/patternCount");
+(0, node_test_1.describe)('patternCount', () => {
+    (0, node_test_1.it)('returns 0 for empty string', () => {
+        node_assert_1.default.deepStrictEqual((0, patternCount_1.patternCount)('', 'aa'), 0);
+    });
+    (0, node_test_1.it)('returns 0 for empty pattern', () => {
+        node_assert_1.default.deepStrictEqual((0, patternCount_1.patternCount)('abc', ''), 0);
+    });
+    (0, node_test_1.it)('returns 0 for empty string and empty pattern', () => {
+        node_assert_1.default.deepStrictEqual((0, patternCount_1.patternCount)('', ''), 0);
+    });
+    (0, node_test_1.it)('returns correct count for single character pattern', () => {
+        node_assert_1.default.strictEqual((0, patternCount_1.patternCount)('abcabcabc', 'a'), 3);
+    });
+    (0, node_test_1.it)('returns correct count for multi-character pattern', () => {
+        node_assert_1.default.strictEqual((0, patternCount_1.patternCount)('abcabcabc', 'ab'), 3);
+    });
+    (0, node_test_1.it)('returns correct count for overlapping patterns', () => {
+        node_assert_1.default.strictEqual((0, patternCount_1.patternCount)('ababababa', 'aba'), 4);
+    });
+    (0, node_test_1.it)('returns correct count for non-overlapping patterns', () => {
+        node_assert_1.default.strictEqual((0, patternCount_1.patternCount)('abababab', 'ab'), 4);
+    });
+    (0, node_test_1.it)('returns 0 for pattern not found', () => {
+        node_assert_1.default.strictEqual((0, patternCount_1.patternCount)('abcdefg', 'xyz'), 0);
+    });
+});

package/dist/tests/analyzing/readingDuration.test.js

@@ -6,39 +6,39 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_test_1 = require("node:test");
 const node_assert_1 = __importDefault(require("node:assert"));
 const readingDuration_1 = require("../../analyzing/readingDuration");
-(0, node_test_1.describe)("readingDuration", () => {
+(0, node_test_1.describe)('readingDuration', () => {
     const testCases = [
-        { text: "", expectedDuration: 0 }, // Empty string
-        { text: "This is a short text", expectedDuration: 0 }, // 5 words
+        { text: '', expectedDuration: 0 }, // Empty string
+        { text: 'This is a short text', expectedDuration: 0 }, // 5 words
         {
-            text: "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
+            text: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
             expectedDuration: 0, // 19 words
         },
-        { text: "   This   text   has   extra   spaces   ", expectedDuration: 0 }, // 6 words
-        { text: "Word", expectedDuration: 0 }, // 1 word
+        { text: '   This   text   has   extra   spaces   ', expectedDuration: 0 }, // 6 words
+        { text: 'Word', expectedDuration: 0 }, // 1 word
         {
-            text: "A longer text with exactly twenty-three words to test the calculation properly.",
+            text: 'A longer text with exactly twenty-three words to test the calculation properly.',
             expectedDuration: 0, // 23 words
         },
         {
-            text: "This text contains fifty words. It is designed to test the reading duration function with a larger input. The function should calculate the duration accurately based on the average reading speed.",
+            text: 'This text contains fifty words. It is designed to test the reading duration function with a larger input. The function should calculate the duration accurately based on the average reading speed.',
             expectedDuration: 0, // 50 words
         },
         {
-            text: Array(9999).fill("Word").join(" "), // Generates a text with 9999 words
+            text: Array(9999).fill('Word').join(' '), // Generates a text with 9999 words
             expectedDuration: 43, // 9999 words / 230 words per minute ≈ 43 minutes
         },
         {
-            text: Array(230).fill("Word").join(" "), // Generates a text with 230 words
+            text: Array(230).fill('Word').join(' '), // Generates a text with 230 words
             expectedDuration: 1, // 230 words / 230 words per minute = 1 minute
         },
         {
-            text: Array(460).fill("Word").join(" "), // Generates a text with 460 words
+            text: Array(460).fill('Word').join(' '), // Generates a text with 460 words
             expectedDuration: 2, // 460 words / 230 words per minute = 2 minutes
         },
     ];
     testCases.forEach(({ text, expectedDuration }) => {
-        (0, node_test_1.it)(`returns ${expectedDuration} for text with ${text.split(" ").length} words`, () => {
+        (0, node_test_1.it)(`returns ${expectedDuration} for text with ${text.split(' ').length} words`, () => {
             node_assert_1.default.strictEqual((0, readingDuration_1.readingDuration)(text), expectedDuration);
         });
     });

package/dist/tests/analyzing/vowelConsonantCount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/analyzing/vowelConsonantCount.test.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const vowelConsonantCount_1 = require("../../analyzing/vowelConsonantCount");
+(0, node_test_1.describe)('vowelConsonantCount', () => {
+    (0, node_test_1.it)('returns 0s for empty string', () => {
+        node_assert_1.default.deepStrictEqual((0, vowelConsonantCount_1.vowelConsonantCount)(''), { vowels: 0, consonants: 0 });
+    });
+    (0, node_test_1.it)('counts lowercase vowels and consonants', () => {
+        node_assert_1.default.deepStrictEqual((0, vowelConsonantCount_1.vowelConsonantCount)('hello'), { vowels: 2, consonants: 3 });
+    });
+    (0, node_test_1.it)('counts uppercase vowels and consonants', () => {
+        node_assert_1.default.deepStrictEqual((0, vowelConsonantCount_1.vowelConsonantCount)('HELLO'), { vowels: 2, consonants: 3 });
+    });
+    (0, node_test_1.it)('counts vowels and consonants ignoring special characters and whitespaces', () => {
+        node_assert_1.default.deepStrictEqual((0, vowelConsonantCount_1.vowelConsonantCount)('Hello, World!'), { vowels: 3, consonants: 7 });
+    });
+    (0, node_test_1.it)('throws if input is not a string', () => {
+        node_assert_1.default.throws(() => (0, vowelConsonantCount_1.vowelConsonantCount)(123), /Input must be a string/);
+    });
+});

package/dist/tests/transformations/numberToText.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/transformations/numberToText.test.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const transformations_1 = require("../../transformations");
+(0, node_test_1.describe)("numberToText", () => {
+    (0, node_test_1.describe)("Param error handling", () => {
+        node_assert_1.default.throws(() => (0, transformations_1.numberToText)("aaaa"), /Num param should be number/i);
+        node_assert_1.default.throws(() => (0, transformations_1.numberToText)(1000000000001), RangeError);
+        node_assert_1.default.throws(() => (0, transformations_1.numberToText)(-1000000000001), RangeError);
+        const validLanguages = ['en', 'pl'];
+        const errorMessage = `Language must be one of: ${validLanguages.join(', ')}`;
+        node_assert_1.default.throws(() => (0, transformations_1.numberToText)(123, "invalid"), new RegExp(errorMessage, "i"));
+    });
+    (0, node_test_1.describe)("Conversion cases - en", () => {
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(0), "zero");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1), "one");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(5), "five");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(10), "ten");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(15), "fifteen");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(21), "twenty-one");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(99), "ninety-nine");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(100), "one hundred");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(101), "one hundred one");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(215), "two hundred fifteen");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000), "one thousand");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(2023), "two thousand twenty-three");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000), "one million");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1200000), "one million two hundred thousand");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000000), "one billion");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000000000), "one trillion");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-1), "minus one");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-215), "minus two hundred fifteen");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-1000000), "minus one million");
+    });
+    (0, node_test_1.describe)("Conversion cases - pl", () => {
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(0, 'pl'), "zero");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1, 'pl'), "jeden");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(5, 'pl'), "pięć");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(10, 'pl'), "dziesięć");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(15, 'pl'), "piętnaście");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(21, 'pl'), "dwadzieścia jeden");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(99, 'pl'), "dziewięćdziesiąt dziewięć");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(100, 'pl'), "sto");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(101, 'pl'), "sto jeden");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(215, 'pl'), "dwieście piętnaście");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000, 'pl'), "tysiąc");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(2023, 'pl'), "dwa tysiące dwadzieścia trzy");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000, 'pl'), "milion");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1200000, 'pl'), "milion dwieście tysięcy");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000000, 'pl'), "miliard");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(1000000000000, 'pl'), "bilion");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-1, 'pl'), "minus jeden");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-215, 'pl'), "minus dwieście piętnaście");
+        node_assert_1.default.strictEqual((0, transformations_1.numberToText)(-1000000, 'pl'), "minus milion");
+    });
+});

package/dist/tests/transformations/splitChunks.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/transformations/splitChunks.test.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const splitChunks_1 = require("../../transformations/splitChunks");
+(0, node_test_1.describe)('splitChunks', () => {
+    (0, node_test_1.it)('creates chunks of size 3', () => {
+        node_assert_1.default.deepStrictEqual((0, splitChunks_1.splitChunks)('hello world', 3), ['hel', 'lo ', 'wor', 'ld']);
+    });
+    (0, node_test_1.it)('creates chunks of size 2', () => {
+        node_assert_1.default.deepStrictEqual((0, splitChunks_1.splitChunks)('hello world', 2), ['he', 'll', 'o ', 'wo', 'rl', 'd']);
+    });
+    (0, node_test_1.it)('creates chunks of size 1', () => {
+        node_assert_1.default.deepStrictEqual((0, splitChunks_1.splitChunks)('hello world'), [
+            'h',
+            'e',
+            'l',
+            'l',
+            'o',
+            ' ',
+            'w',
+            'o',
+            'r',
+            'l',
+            'd',
+        ]);
+    });
+});

package/dist/tests/validations/isCoordinates.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/validations/isCoordinates.test.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const isCoordinates_1 = require("../../validations/isCoordinates");
+(0, node_test_1.describe)('isCoordinates', () => {
+    (0, node_test_1.it)('returns true for valid coordinates', () => {
+        node_assert_1.default.strictEqual((0, isCoordinates_1.isCoordinates)(48.8582, 2.2945), true);
+        node_assert_1.default.strictEqual((0, isCoordinates_1.isCoordinates)(40.748817, -73.985428), true);
+    });
+    (0, node_test_1.it)('returns false for invalid coordinates', () => {
+        node_assert_1.default.strictEqual((0, isCoordinates_1.isCoordinates)(200, 200), false);
+        node_assert_1.default.strictEqual((0, isCoordinates_1.isCoordinates)(-200, -200), false);
+    });
+});

package/dist/tests/validations/isEmail.smtpUTF8.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/validations/isEmail.smtpUTF8.test.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const isEmail_1 = require("../../validations/isEmail");
+(0, node_test_1.describe)('isEmail (SMTPUTF8)', () => {
+    (0, node_test_1.it)('accepts emoji in local-part by default', () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('I❤️CHOCOLATE@example.com'), true);
+    });
+    (0, node_test_1.it)('rejects emoji in local-part when smtpUTF8 is explicitly disabled', () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('I❤️CHOCOLATE@example.com', { smtpUTF8: false }), false);
+    });
+});

package/dist/tests/validations/isEmail.test.js

@@ -6,12 +6,62 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_test_1 = require("node:test");
 const node_assert_1 = __importDefault(require("node:assert"));
 const isEmail_1 = require("../../validations/isEmail");
-(0, node_test_1.describe)('isEmail', () => {
-    (0, node_test_1.it)('returns true for valid emails', () => {
-        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('foo@bar.com'), true);
+(0, node_test_1.describe)("isEmail", () => {
+    //
+    // ✅ Basic valid emails
+    //
+    (0, node_test_1.it)("returns true for basic valid emails", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("foo@bar.com"), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test@example.org"), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("very.common@example.com"), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("long.email-address-with-hyphens@and.subdomains.example.com"), true);
     });
-    (0, node_test_1.it)('returns false for invalid emails', () => {
-        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('foo@bar'), false);
-        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)(''), false);
+    //
+    // ✅ Special characters in local-part
+    //
+    (0, node_test_1.it)("returns true for special characters", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test+tag@example.com"), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("user.name+tag+sorting@example.com"), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test/test@example.com"), true);
+    });
+    //
+    // ✅ IPv4 address literal
+    //
+    (0, node_test_1.it)("returns true for IPv4 address literal", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("user@[192.168.1.1]"), true);
+    });
+    //
+    // ✅ Quoted local-parts (RFC 5322)
+    //
+    (0, node_test_1.it)("returns true for quoted local-parts", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('"much.more unusual"@example.com'), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('"very.unusual.@.unusual.com"@example.com'), true);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('"very.(),:;<>[]".VERY."very@\\ "very".unusual"@strange.example.com'), true);
+    });
+    //
+    // ✅ IPv6 domain literal
+    //
+    (0, node_test_1.it)("returns true for IPv6 domain literals", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("user@[IPv6:2001:db8::1]"), true);
+    });
+    //
+    // ❌ Invalid emails
+    //
+    (0, node_test_1.it)("returns false for invalid emails", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)(""), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("@example.com"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test@"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test@.com"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test..test@example.com"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)(".test@example.com"), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)("test.@example.com"), false);
+    });
+    //
+    // ❌ Invalid quoted emails
+    //
+    (0, node_test_1.it)("returns false for invalid quoted local-parts", () => {
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('"unclosed-quote@example.com'), false);
+        node_assert_1.default.strictEqual((0, isEmail_1.isEmail)('"missing"quotes@@example.com'), false);
     });
 });

package/dist/tests/validations/isHexColor.test.js

@@ -6,27 +6,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_test_1 = require("node:test");
 const node_assert_1 = __importDefault(require("node:assert"));
 const isHexColor_1 = require("../../validations/isHexColor");
-(0, node_test_1.describe)("isHexColor", () => {
-    (0, node_test_1.it)("returns true for valid hex colors", () => {
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#abc"), true);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("abc"), true);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#a1b2c3"), true);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("a1b2c3"), true);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#A1B2C3"), true);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("   #fff   "), true);
+(0, node_test_1.describe)('isHexColor', () => {
+    (0, node_test_1.it)('returns true for valid hex colors', () => {
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#abc'), true);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('abc'), true);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#a1b2c3'), true);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('a1b2c3'), true);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#A1B2C3'), true);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('   #fff   '), true);
     });
-    (0, node_test_1.it)("returns false for invalid hex colors", () => {
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#12G"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("xyz"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#ab"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#12345"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("12345"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#1234567"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("1234567"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("#1234g6"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("1234g6"), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)(""), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("   "), false);
-        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)("blue"), false);
+    (0, node_test_1.it)('returns false for invalid hex colors', () => {
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#12G'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('xyz'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#ab'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#12345'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('12345'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#1234567'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('1234567'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('#1234g6'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('1234g6'), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)(''), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('   '), false);
+        node_assert_1.default.strictEqual((0, isHexColor_1.isHexColor)('blue'), false);
     });
 });

package/dist/tests/validations/isPalindrome.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/validations/isPalindrome.test.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const isPalindrome_1 = require("../../validations/isPalindrome");
+(0, node_test_1.describe)('isPalindrome', () => {
+    (0, node_test_1.it)('returns true for simple palindromes', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('racecar'), true);
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('madam'), true);
+    });
+    (0, node_test_1.it)('returns false for non-palindromes', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('hello'), false);
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('world'), false);
+    });
+    (0, node_test_1.it)('is case-insensitive', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('RaceCar'), true);
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('MadAm'), true);
+    });
+    (0, node_test_1.it)('ignores punctuation and spaces', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('A man, a plan, a canal: Panama'), true);
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('No lemon, no melon!'), true);
+    });
+    (0, node_test_1.it)('returns true for empty string and single characters', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)(''), true);
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('x'), true);
+    });
+    (0, node_test_1.it)('handles strings with only special characters', () => {
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('?!'), true); // cleans to ''
+        node_assert_1.default.strictEqual((0, isPalindrome_1.isPalindrome)('!@#$$#@!'), true); // also cleans to ''
+    });
+    (0, node_test_1.it)('throws an error if input is not a string', () => {
+        node_assert_1.default.throws(() => (0, isPalindrome_1.isPalindrome)(123), /Input must be a string/);
+        node_assert_1.default.throws(() => (0, isPalindrome_1.isPalindrome)(null), /Input must be a string/);
+        node_assert_1.default.throws(() => (0, isPalindrome_1.isPalindrome)(undefined), /Input must be a string/);
+    });
+});

package/dist/tests/validations/isTypeOf.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/validations/isTypeOf.test.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const isTypeOf_1 = require("../../validations/isTypeOf");
+(0, node_test_1.describe)('isType', () => {
+    (0, node_test_1.it)('returns true for valid file', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('photo.PNG', 'image'), true);
+    });
+    (0, node_test_1.it)('returns false for unknown extension', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('unknown.xyz', 'document'), false);
+    });
+    (0, node_test_1.it)('returns false for unknown type category', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('photo.png', 'media'), false);
+    });
+    (0, node_test_1.it)('returns false for mismatched type', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('video.mp4', 'document'), false);
+    });
+    (0, node_test_1.it)('returns false for missing extension', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('filewithoutextension', 'image'), false);
+    });
+    (0, node_test_1.it)('handles URL with query and hash fragments', () => {
+        node_assert_1.default.strictEqual((0, isTypeOf_1.isTypeOf)('https://example.com/pic.jpeg?version=2#section', 'image'), true);
+    });
+});

package/dist/transformations/camelCase.d.ts

@@ -1 +1,25 @@
+/**
+ * Converts a given string into camelCase format.
+ *
+ * This function normalizes the input by:
+ * - Converting it to lowercase
+ * - Removing special characters (except alphanumeric and underscores)
+ * - Replacing underscores and multiple spaces with single spaces
+ * - Capitalizing each word except the first
+ * - Removing all spaces to form a camelCased result
+ *
+ * If the input is `null` or `undefined`, an empty string is returned.
+ *
+ * @param {string} text - The input string to convert.
+ * @returns {string} The camelCased version of the input string.
+ *
+ * @example
+ * camelCase("Hello world"); // "helloWorld"
+ *
+ * @example
+ * camelCase("  convert_to-camel case!! "); // "convertToCamelCase"
+ *
+ * @example
+ * camelCase(""); // ""
+ */
 export declare function camelCase(text: string): string;

package/dist/transformations/camelCase.js

@@ -1,6 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.camelCase = camelCase;
+/**
+ * Converts a given string into camelCase format.
+ *
+ * This function normalizes the input by:
+ * - Converting it to lowercase
+ * - Removing special characters (except alphanumeric and underscores)
+ * - Replacing underscores and multiple spaces with single spaces
+ * - Capitalizing each word except the first
+ * - Removing all spaces to form a camelCased result
+ *
+ * If the input is `null` or `undefined`, an empty string is returned.
+ *
+ * @param {string} text - The input string to convert.
+ * @returns {string} The camelCased version of the input string.
+ *
+ * @example
+ * camelCase("Hello world"); // "helloWorld"
+ *
+ * @example
+ * camelCase("  convert_to-camel case!! "); // "convertToCamelCase"
+ *
+ * @example
+ * camelCase(""); // ""
+ */
 function camelCase(text) {
     if (text == null)
         return '';

package/dist/transformations/capitalizeWords.d.ts

@@ -1 +1,22 @@
+/**
+ * Capitalizes the first letter of every word in a given string.
+ *
+ * A word is identified by word boundaries (`\b`), and only the first character
+ * of each word is converted to uppercase. The rest of the characters remain unchanged.
+ *
+ * Throws an error if the input is not a string.
+ *
+ * @param {string} text - The input string whose words will be capitalized.
+ * @returns {string} A new string with each word's first character in uppercase.
+ * @throws {Error} If the input is not a string.
+ *
+ * @example
+ * capitalizeWords("hello world"); // "Hello World"
+ *
+ * @example
+ * capitalizeWords("javaScript is fun!"); // "JavaScript Is Fun!"
+ *
+ * @example
+ * capitalizeWords(""); // ""
+ */
 export declare function capitalizeWords(text: string): string;

package/dist/transformations/capitalizeWords.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.capitalizeWords = capitalizeWords;
+/**
+ * Capitalizes the first letter of every word in a given string.
+ *
+ * A word is identified by word boundaries (`\b`), and only the first character
+ * of each word is converted to uppercase. The rest of the characters remain unchanged.
+ *
+ * Throws an error if the input is not a string.
+ *
+ * @param {string} text - The input string whose words will be capitalized.
+ * @returns {string} A new string with each word's first character in uppercase.
+ * @throws {Error} If the input is not a string.
+ *
+ * @example
+ * capitalizeWords("hello world"); // "Hello World"
+ *
+ * @example
+ * capitalizeWords("javaScript is fun!"); // "JavaScript Is Fun!"
+ *
+ * @example
+ * capitalizeWords(""); // ""
+ */
 function capitalizeWords(text) {
-    if (typeof text !== "string") {
-        throw new Error("Invalid argument. Expected a string.");
+    if (typeof text !== 'string') {
+        throw new Error('Invalid argument. Expected a string.');
     }
     return text.replace(/\b\w/g, (char) => char.toUpperCase());
 }