utilitish 0.0.11 → 0.0.14

package/LICENSE.txt

@@ -1,25 +1,25 @@
-GNU GENERAL PUBLIC LICENSE
-Version 3, 29 June 2007
-
-Copyright (C) 2025 Donovan Ferreira
-
-Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
-
-                            Preamble
-
-The GNU General Public License is a free, copyleft license for
-software and other kinds of works.
-
-The licenses for most software and other practical works are designed
-to take away your freedom to share and change the works. By contrast,
-the GNU General Public License is intended to guarantee your freedom to
-share and change all versions of a program--to make sure it remains free
-software for all its users. We, the Free Software Foundation, use the
-GNU General Public License for most of our software; it applies also to
-any other work released this way by its authors. You can apply it to
-your programs, too.
-
-[... contenu tronqué pour l’aperçu ...]
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <https://www.gnu.org/licenses/>.
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2025 Donovan Ferreira
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+                            Preamble
+
+The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+[... contenu tronqué pour l’aperçu ...]
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.

package/README.md

@@ -1,68 +1,68 @@
-## Licence
-
-Ce projet est distribué sous licence [GPL v3](https://www.gnu.org/licenses/gpl-3.0.html) © 2025 Donovan Ferreira.
-
-Ceci est une petite librairie qui ajoute plusieurs méthodes au prototype JavaScript.
-
-## Configuration Slugify
-
-La méthode `slugify()` peut être personnalisée pour répondre à vos besoins spécifiques. Consultez la JSDoc dans votre IDE pour voir tous les exemples disponibles.
-
-### Configuration globale
-
-Vous pouvez définir une configuration globale qui s'appliquera à tous les appels `slugify()` :
-
-```typescript
-import { setSlugifyConfig } from 'utilitish';
-
-// Configuration pour remplacer les symboles de genre
-setSlugifyConfig(
-    SlugifyConfig.builder()
-        .withSeparator('_')
-        .withCustomReplacements({
-            '♀': 'feminin',
-            '♂': 'masculin',
-            '@': 'at',
-        })
-        .build(),
-);
-
-'Test ♀'.slugify(); // "test_feminin"
-'User♂@domain.com'.slugify(); // "usermasculinatdomain_com"
-```
-
-### Configuration par appel
-
-Vous pouvez aussi passer une configuration spécifique à chaque appel :
-
-```typescript
-// Utilise la config globale
-'Hello World'.slugify(); // "hello-world"
-
-// Override la config pour cet appel
-'Hello World'.slugify(SlugifyConfig.builder().withSeparator('_').build()); // "hello_world"
-```
-
-### Options de configuration
-
-- **`customReplacements`**: Remplacer des caractères spécifiques (ex: "♀" → "feminin")
-- **`separator`**: Caractère de séparation (défaut: "-")
-- **`lowercase`**: Convertir en minuscules (défaut: true)
-- **`removeAccents`**: Supprimer les accents (défaut: true)
-- **`allowedChars`**: Regex des caractères autorisés (défaut: /[a-zA-Z0-9]/)
-- **`maxLength`**: Longueur maximale du slug
-- **`transformers`**: Fonctions de transformation personnalisées
-
-### Gestion de la configuration
-
-```typescript
-import { getSlugifyConfig, resetSlugifyConfig } from 'utilitish';
-
-// Obtenir la config actuelle
-const currentConfig = getSlugifyConfig();
-
-// Réinitialiser aux valeurs par défaut
-resetSlugifyConfig();
-```
-
-Pour plus d'exemples et cas d'usage avancés, consultez les JSDoc intégrées dans votre IDE.
+## Licence
+
+Ce projet est distribué sous licence [GPL v3](https://www.gnu.org/licenses/gpl-3.0.html) © 2025 Donovan Ferreira.
+
+Ceci est une petite librairie qui ajoute plusieurs méthodes au prototype JavaScript.
+
+## Configuration Slugify
+
+La méthode `slugify()` peut être personnalisée pour répondre à vos besoins spécifiques. Consultez la JSDoc dans votre IDE pour voir tous les exemples disponibles.
+
+### Configuration globale
+
+Vous pouvez définir une configuration globale qui s'appliquera à tous les appels `slugify()` :
+
+```typescript
+import { setSlugifyConfig } from 'utilitish';
+
+// Configuration pour remplacer les symboles de genre
+setSlugifyConfig(
+    SlugifyConfig.builder()
+        .withSeparator('_')
+        .withCustomReplacements({
+            '♀': 'feminin',
+            '♂': 'masculin',
+            '@': 'at',
+        })
+        .build(),
+);
+
+'Test ♀'.slugify(); // "test_feminin"
+'User♂@domain.com'.slugify(); // "usermasculinatdomain_com"
+```
+
+### Configuration par appel
+
+Vous pouvez aussi passer une configuration spécifique à chaque appel :
+
+```typescript
+// Utilise la config globale
+'Hello World'.slugify(); // "hello-world"
+
+// Override la config pour cet appel
+'Hello World'.slugify(SlugifyConfig.builder().withSeparator('_').build()); // "hello_world"
+```
+
+### Options de configuration
+
+- **`customReplacements`**: Remplacer des caractères spécifiques (ex: "♀" → "feminin")
+- **`separator`**: Caractère de séparation (défaut: "-")
+- **`lowercase`**: Convertir en minuscules (défaut: true)
+- **`removeAccents`**: Supprimer les accents (défaut: true)
+- **`allowedChars`**: Regex des caractères autorisés (défaut: /[a-zA-Z0-9]/)
+- **`maxLength`**: Longueur maximale du slug
+- **`transformers`**: Fonctions de transformation personnalisées
+
+### Gestion de la configuration
+
+```typescript
+import { getSlugifyConfig, resetSlugifyConfig } from 'utilitish';
+
+// Obtenir la config actuelle
+const currentConfig = getSlugifyConfig();
+
+// Réinitialiser aux valeurs par défaut
+resetSlugifyConfig();
+```
+
+Pour plus d'exemples et cas d'usage avancés, consultez les JSDoc intégrées dans votre IDE.

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

@@ -24,11 +24,13 @@ 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,26 +194,6 @@ 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,15 +73,6 @@ 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,42 +161,6 @@ 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/dist/test.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <meta
+            name="viewport"
+            content="width=device-width, initial-scale=1.0"
+        />
+        <script src="index.js"></script>
+        <title>Document</title>
+    </head>
+    <body></body>
+</html>

package/dist/utils/slugify.config.d.ts

@@ -10,6 +10,7 @@ export declare class SlugifyConfig {
     private readonly _allowedChars?;
     private readonly _maxLength?;
     private readonly _transformers;
+    private readonly _isValidated;
     private constructor();
     static builder(): SlugifyConfigBuilder;
     static default(): SlugifyConfig;
@@ -83,7 +84,7 @@ export declare function getDefaultSlugifyConfig(): SlugifyConfig;
  * );
  */
 export declare function assertCharClass(regex: RegExp): void;
-export declare function assertSlugifyConfig(builderOrConfig: SlugifyConfigBuilder | SlugifyConfig): void;
+export declare function validateSlugifyConfig(builderOrConfig: SlugifyConfigBuilder | SlugifyConfig): void;
 export declare function setSlugifyConfig(config: SlugifyConfig): void;
 /**
  * Gets the current global slugify configuration.

package/dist/utils/slugify.config.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SlugifyConfigBuilder = exports.SlugifyConfig = void 0;
 exports.getDefaultSlugifyConfig = getDefaultSlugifyConfig;
 exports.assertCharClass = assertCharClass;
-exports.assertSlugifyConfig = assertSlugifyConfig;
+exports.validateSlugifyConfig = validateSlugifyConfig;
 exports.setSlugifyConfig = setSlugifyConfig;
 exports.getSlugifyConfig = getSlugifyConfig;
 exports.resetSlugifyConfig = resetSlugifyConfig;
@@ -12,7 +12,7 @@ exports.resetSlugifyConfig = resetSlugifyConfig;
  * Provides comprehensive customization options for URL slug generation.
  */
 class SlugifyConfig {
-    constructor(builder) {
+    constructor(builder, isValidated = false) {
         this._customReplacements = builder.customReplacements;
         this._separator = builder.separator;
         this._case = builder.case;
@@ -20,6 +20,7 @@ class SlugifyConfig {
         this._allowedChars = builder.allowedChars;
         this._maxLength = builder.maxLength;
         this._transformers = builder.transformers;
+        this._isValidated = isValidated;
     }
     static builder() {
         return new SlugifyConfigBuilder();
@@ -28,8 +29,8 @@ class SlugifyConfig {
         return SlugifyConfig.builder().build();
     }
     static create(builder) {
-        assertSlugifyConfig(builder);
-        const config = new SlugifyConfig(builder);
+        validateSlugifyConfig(builder);
+        const config = new SlugifyConfig(builder, true);
         return Object.freeze(config);
     }
     get customReplacements() {
@@ -216,7 +217,7 @@ function assertCharClass(regex) {
         throw new Error(`Invalid allowedChars: must be a character class like /[a-z]/, received ${regex}`);
     }
 }
-function assertSlugifyConfig(builderOrConfig) {
+function validateSlugifyConfig(builderOrConfig) {
     const allowedChars = builderOrConfig.allowedChars;
     const separator = builderOrConfig.separator;
     const caseValue = builderOrConfig.case;

package/dist/utils.d.ts

@@ -0,0 +1 @@
+export declare const defineIfNotExists: <T extends object>(prototype: T, name: string, fn: Function) => void;

package/dist/utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineIfNotExists = void 0;
+const defineIfNotExists = (prototype, name, fn) => {
+    const descriptor = Object.getOwnPropertyDescriptor(prototype, name);
+    if (!descriptor || descriptor.writable || descriptor.configurable) {
+        Object.defineProperty(prototype, name, {
+            value: fn,
+            enumerable: false,
+            configurable: false,
+            writable: false,
+        });
+    }
+};
+exports.defineIfNotExists = defineIfNotExists;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utilitish",
-  "version": "0.0.11",
+  "version": "0.0.14",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/FDonovan12/utilitish.git"
@@ -18,7 +18,8 @@
   "scripts": {
     "build": "tsc",
     "test": "jest",
-    "docs": "typedoc"
+    "docs": "typedoc",
+    "release": "npm version patch && git push --follow-tags && npm publish"
   },
   "keywords": [
     "typescript",
@@ -31,6 +32,7 @@
     "@types/jest": "^29.5.14",
     "jest": "^29.7.0",
     "ts-jest": "^29.3.4",
+    "ts-node": "^10.9.2",
     "typedoc": "^0.28.10",
     "typescript": "^5.8.3"
   }