utilitish 0.0.10 → 0.0.11

package/README.md

@@ -16,16 +16,19 @@ Vous pouvez définir une configuration globale qui s'appliquera à tous les appe
 import { setSlugifyConfig } from 'utilitish';
 
 // Configuration pour remplacer les symboles de genre
-setSlugifyConfig({
-    customReplacements: {
-        '♀': 'feminin',
-        '♂': 'masculin',
-    },
-    separator: '_',
-});
+setSlugifyConfig(
+    SlugifyConfig.builder()
+        .withSeparator('_')
+        .withCustomReplacements({
+            '♀': 'feminin',
+            '♂': 'masculin',
+            '@': 'at',
+        })
+        .build(),
+);
 
 'Test ♀'.slugify(); // "test_feminin"
-'User♂@domain.com'.slugify(); // "user_masculin_at_domain_com"
+'User♂@domain.com'.slugify(); // "usermasculinatdomain_com"
 ```
 
 ### Configuration par appel
@@ -37,7 +40,7 @@ Vous pouvez aussi passer une configuration spécifique à chaque appel :
 'Hello World'.slugify(); // "hello-world"
 
 // Override la config pour cet appel
-'Hello World'.slugify({ separator: '_' }); // "hello_world"
+'Hello World'.slugify(SlugifyConfig.builder().withSeparator('_').build()); // "hello_world"
 ```
 
 ### Options de configuration

package/dist/object/object-prototype.spec.js

@@ -24,13 +24,11 @@ describe('Object.prototype', () => {
             const source = { b: { d: 3 }, e: 4 };
             const merged = obj.deepMerge(source);
             expect(merged).toEqual({ a: 1, b: { c: 2, d: 3 }, e: 4 });
-            console.log(merged);
         });
         it('should overwrite primitive values', () => {
             const obj = { a: 1, b: 2 };
             const merged = obj.deepMerge({ b: 3 });
             expect(merged).toEqual({ a: 1, b: 3 });
-            console.log(merged);
         });
         describe('error handling', () => {
             it('should throw if source is not an object', () => {

package/dist/string/string-prototype.d.ts

@@ -194,6 +194,26 @@ declare global {
          */
         slugify(): string;
         slugify(config: SlugifyConfig): string;
+        /**
+         * Compares two strings by slugifying both and checking if they are equal.
+         * Useful for case-insensitive and accent-insensitive string comparison.
+         *
+         * @this {string} The first string to compare
+         * @param {string} other - The second string to compare
+         * @returns {boolean} True if both slugified strings are equal, false otherwise
+         * @throws {TypeError} If the parameter is not a string
+         *
+         * @example
+         * 'Hello World'.compareSlugify('hello-world'); // true
+         * 'Héllo Wørld'.compareSlugify('hello-world'); // true
+         * 'Hello World'.compareSlugify('goodbye-world'); // false
+         *
+         * @remarks
+         * - Both strings are slugified using the default or global configuration
+         * - Useful for comparing user-provided strings with stored slugs
+         * - Guard ensures the parameter is a valid string type
+         */
+        compareSlugify(other: string): boolean;
         /**
          * Replaces a substring between `start` and `end` indices with a given string.
          * Provides precise control over which portion of the string to replace.

package/dist/string/string-prototype.js

@@ -73,6 +73,15 @@ const slugify_utils_1 = require("../utils/slugify.utils");
         return '';
     return this.charAt(0).toUpperCase() + this.slice(1);
 });
+/**
+ * @see String.prototype.compareSlugify
+ */
+(0, core_utils_1.defineIfNotExists)(String.prototype, 'compareSlugify', function (other) {
+    if (typeof other !== 'string') {
+        throw new TypeError('Parameter must be a string');
+    }
+    return this.slugify() === other.slugify();
+});
 /**
  * @see String.prototype.replaceRange
  */

package/dist/string/string-prototype.spec.js

@@ -161,6 +161,42 @@ describe('String.prototype', () => {
             });
         });
     });
+    describe('compareSlugify()', () => {
+        beforeEach(() => {
+            (0, slugify_config_1.resetSlugifyConfig)(); // Reset to defaults before each test
+        });
+        it('should return true when slugified strings are equal', () => {
+            expect('Hello World'.compareSlugify('hello-world')).toBe(true);
+            expect('hello world'.compareSlugify('hello-world')).toBe(true);
+            expect('HELLO WORLD'.compareSlugify('hello-world')).toBe(true);
+        });
+        it('should handle accents and special characters', () => {
+            expect('Café'.compareSlugify('cafe')).toBe(true);
+            expect('Éléphant'.compareSlugify('elephant')).toBe(true);
+            expect('naïve café'.compareSlugify('naive-cafe')).toBe(true);
+            expect('résumé'.compareSlugify('resume')).toBe(true);
+        });
+        it('should return false when slugified strings are different', () => {
+            expect('Hello World'.compareSlugify('goodbye-world')).toBe(false);
+            expect('test string'.compareSlugify('different-string')).toBe(false);
+        });
+        it('should handle extra spaces and special characters', () => {
+            expect('  Hello  ---  World  '.compareSlugify('hello-world')).toBe(true);
+            expect('Hello!!!World???'.compareSlugify('hello-world')).toBe(true);
+        });
+        it('should throw TypeError if parameter is not a string', () => {
+            expect(() => 'hello'.compareSlugify(123)).toThrowError(TypeError);
+            expect(() => 'hello'.compareSlugify(null)).toThrowError(TypeError);
+            expect(() => 'hello'.compareSlugify(undefined)).toThrowError(TypeError);
+            expect(() => 'hello'.compareSlugify({})).toThrowError(TypeError);
+            expect(() => 'hello'.compareSlugify([])).toThrowError(TypeError);
+        });
+        it('should work with empty strings', () => {
+            expect(''.compareSlugify('')).toBe(true);
+            expect('   '.compareSlugify('')).toBe(true);
+            expect('hello'.compareSlugify('')).toBe(false);
+        });
+    });
     describe('replaceRange()', () => {
         it('should replace a single character at the given index', () => {
             expect('hello'.replaceRange(1, 2, 'a')).toBe('hallo');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utilitish",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/FDonovan12/utilitish.git"