utilitish 0.0.10 → 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,65 +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({
-    customReplacements: {
-        '♀': 'feminin',
-        '♂': 'masculin',
-    },
-    separator: '_',
-});
-
-'Test ♀'.slugify(); // "test_feminin"
-'User♂@domain.com'.slugify(); // "user_masculin_at_domain_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({ separator: '_' }); // "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/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.10",
+  "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"
   }