@naman_deep_singh/js-extensions 1.3.3 → 1.4.0

package/dist/esm/string/string-extensions.js

@@ -1,34 +1,36 @@
-// String prototype extensions
+import { defineExtension } from "src/utils";
+let stringExtended = false;
 export function extendString() {
-    String.prototype.toCapitalize = function () {
+    if (stringExtended)
+        return;
+    stringExtended = true;
+    defineExtension(String.prototype, 'toCapitalize', function () {
         return this.charAt(0).toUpperCase() + this.slice(1).toLowerCase();
-    };
-    String.prototype.toCamelCase = function () {
-        return this.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : '');
-    };
-    String.prototype.toKebabCase = function () {
+    });
+    defineExtension(String.prototype, 'toCamelCase', function () {
+        return this.replace(/[-_\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''));
+    });
+    defineExtension(String.prototype, 'toKebabCase', function () {
         return this.replace(/([a-z])([A-Z])/g, '$1-$2')
             .replace(/[\s_]+/g, '-')
             .toLowerCase();
-    };
-    String.prototype.toSnakeCase = function () {
+    });
+    defineExtension(String.prototype, 'toSnakeCase', function () {
         return this.replace(/([a-z])([A-Z])/g, '$1_$2')
             .replace(/[\s-]+/g, '_')
             .toLowerCase();
-    };
-    String.prototype.truncate = function (length, suffix = '...') {
+    });
+    defineExtension(String.prototype, 'truncate', function (length, suffix = '...') {
         if (!Number.isInteger(length) || length < 0) {
             throw new TypeError(`truncate: length must be a non-negative integer, got ${length}`);
         }
-        return this.length > length
-            ? this.substring(0, length) + suffix
-            : this.toString();
-    };
-    String.prototype.isEmail = function () {
+        return this.length > length ? this.substring(0, length) + suffix : this.toString();
+    });
+    defineExtension(String.prototype, 'isEmail', function () {
         const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
         return emailRegex.test(this.toString());
-    };
-    String.prototype.isUrl = function () {
+    });
+    defineExtension(String.prototype, 'isUrl', function () {
         try {
             new URL(this.toString());
             return true;
@@ -36,24 +38,24 @@ export function extendString() {
         catch {
             return false;
         }
-    };
-    String.prototype.removeWhitespace = function () {
+    });
+    defineExtension(String.prototype, 'removeWhitespace', function () {
         return this.replace(/\s+/g, '');
-    };
-    String.prototype.reverse = function () {
+    });
+    defineExtension(String.prototype, 'reverse', function () {
         return this.split('').reverse().join('');
-    };
-    String.prototype.isPalindrome = function () {
+    });
+    defineExtension(String.prototype, 'isPalindrome', function () {
         const cleaned = this.toLowerCase().replace(/[^a-z0-9]/g, '');
         return cleaned === cleaned.split('').reverse().join('');
-    };
-    String.prototype.toTitleCase = function () {
+    });
+    defineExtension(String.prototype, 'toTitleCase', function () {
         return this.replace(/\w\S*/g, (txt) => txt.charAt(0).toUpperCase() + txt.substr(1).toLowerCase());
-    };
-    String.prototype.stripHtml = function () {
+    });
+    defineExtension(String.prototype, 'stripHtml', function () {
         return this.replace(/<[^>]*>/g, '');
-    };
-    String.prototype.padStart = function (targetLength, padString = ' ') {
+    });
+    defineExtension(String.prototype, 'padStart', function (targetLength, padString = ' ') {
         if (!Number.isInteger(targetLength) || targetLength < 0) {
             throw new TypeError(`padStart: targetLength must be a non-negative integer, got ${targetLength}`);
         }
@@ -64,8 +66,8 @@ export function extendString() {
             throw new TypeError('padStart: padString cannot be empty');
         }
         return this.toString().padStart(targetLength, padString);
-    };
-    String.prototype.padEnd = function (targetLength, padString = ' ') {
+    });
+    defineExtension(String.prototype, 'padEnd', function (targetLength, padString = ' ') {
         if (!Number.isInteger(targetLength) || targetLength < 0) {
             throw new TypeError(`padEnd: targetLength must be a non-negative integer, got ${targetLength}`);
         }
@@ -76,22 +78,43 @@ export function extendString() {
             throw new TypeError('padEnd: padString cannot be empty');
         }
         return this.toString().padEnd(targetLength, padString);
-    };
-    String.prototype.count = function (substring) {
+    });
+    defineExtension(String.prototype, 'count', function (substring) {
         if (typeof substring !== 'string') {
             throw new TypeError(`count: substring must be a string, got ${typeof substring}`);
         }
         if (substring === '') {
             throw new TypeError('count: substring cannot be empty');
         }
-        return (this.match(new RegExp(substring, 'g')) || []).length;
-    };
-    String.prototype.words = function () {
-        return this.trim()
-            .split(/\s+/)
-            .filter((word) => word.length > 0);
-    };
-    String.prototype.lines = function () {
+        const escaped = substring.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return (this.match(new RegExp(escaped, 'g')) || []).length;
+    });
+    defineExtension(String.prototype, 'words', function () {
+        return this.trim().split(/\s+/).filter((word) => word.length > 0);
+    });
+    defineExtension(String.prototype, 'lines', function () {
         return this.split(/\r?\n/);
-    };
+    });
+    defineExtension(String.prototype, 'capitalizeWords', function () {
+        return this.toString().replace(/\b\w/g, (char) => char.toUpperCase());
+    });
+    defineExtension(String.prototype, 'reverseWords', function () {
+        return this.toString().split(/\s+/).reverse().join(' ');
+    });
+    defineExtension(String.prototype, 'truncateWords', function (count, suffix = '...') {
+        if (!Number.isInteger(count) || count < 0) {
+            throw new TypeError(`truncateWords: count must be a non-negative integer, got ${count}`);
+        }
+        const words = this.toString().split(/\s+/);
+        if (words.length <= count)
+            return this.toString();
+        return words.slice(0, count).join(' ') + suffix;
+    });
+    defineExtension(String.prototype, 'slugify', function () {
+        return this.toString()
+            .toLowerCase()
+            .replace(/[^\w\s-]/g, '')
+            .trim()
+            .replace(/[\s_-]+/g, '-');
+    });
 }

package/dist/esm/types/global-augmentations.d.ts

@@ -26,6 +26,7 @@ declare global {
         sum(): number;
         average(): number;
         compact(): T[];
+        compactTruthy(): T[];
         pluck<K extends keyof T>(key: K): T[K][];
         findLast(predicate: (item: T) => boolean): T | undefined;
         partition(predicate: (item: T) => boolean): [T[], T[]];

package/dist/esm/utils/defineExtension.d.ts

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

package/dist/esm/utils/defineExtension.js

@@ -0,0 +1,10 @@
+export function defineExtension(prototype, name, fn) {
+    if (!Object.prototype.hasOwnProperty.call(prototype, name)) {
+        Object.defineProperty(prototype, name, {
+            value: fn,
+            writable: false,
+            configurable: false,
+            enumerable: false,
+        });
+    }
+}

package/dist/esm/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './config';
 export * from './helpers';
+export * from './defineExtension';

package/dist/esm/utils/index.js

@@ -1,3 +1,4 @@
 // Re-export all utilities
 export * from './config';
 export * from './helpers';
+export * from './defineExtension';

package/dist/types/core/performance.d.ts

@@ -13,4 +13,5 @@ export declare class LRUCache<K, V> {
     set(key: K, value: V): void;
     clear(): void;
 }
+export declare function makeInternalCacheKey(domain: string, key: string | number): string;
 export declare function withCache<T>(key: string, fn: () => T): T;

package/dist/types/core/version.d.ts

@@ -0,0 +1 @@
+export declare const getPackageVersion: () => string;

package/dist/types/index.d.ts

@@ -21,6 +21,7 @@ export declare function initializeExtensions(options?: ExtensionOptions): void;
  */
 export { extendAll };
 /**
+ * Selective prototype extension helpers
  * Initialize only specific extensions
  */
 export declare const extend: {

package/dist/types/types/global-augmentations.d.ts

@@ -26,6 +26,7 @@ declare global {
         sum(): number;
         average(): number;
         compact(): T[];
+        compactTruthy(): T[];
         pluck<K extends keyof T>(key: K): T[K][];
         findLast(predicate: (item: T) => boolean): T | undefined;
         partition(predicate: (item: T) => boolean): [T[], T[]];

package/dist/types/utils/defineExtension.d.ts

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

package/dist/types/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './config';
 export * from './helpers';
+export * from './defineExtension';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/js-extensions",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "Universal JavaScript prototype extensions for common development utilities",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -31,12 +31,16 @@
   "author": "Naman Deep Singh",
   "license": "ISC",
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "rimraf": "^5.0.5"
+    "rimraf": "^5.0.5",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@types/node": "^25.0.1"
   },
   "scripts": {
     "build": "pnpm run build:types && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",
     "build:types": "tsc -p tsconfig.base.json --emitDeclarationOnly --outDir dist/types",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "clean:js": "find src -type f -name \"*.js\" -delete"
   }
 }