@naman_deep_singh/js-extensions 1.3.1 → 1.3.3

package/README.md

@@ -1,9 +1,8 @@
-
 # @naman_deep_singh/js-extensions
 
-**Version:** 1.3.1
+**Version:** 1.3.3
 
-Universal JavaScript prototype extensions for common development utilities. Works in both Node.js and browser environments with 50+ utility methods.
+Universal JavaScript prototype extensions for common development utilities. Works in both Node.js and browser environments with 67+ utility methods.
 
 ## Installation
 
@@ -16,7 +15,6 @@ pnpm add @naman_deep_singh/js-extensions
 ## Quick Start
 
 ```typescript
-
 import { initializeExtensions } from '@naman_deep_singh/js-extensions';
 
 // Initialize all extensions
@@ -69,11 +67,10 @@ import { setPerformanceConfig } from '@naman_deep_singh/js-extensions';
 // Validation is enabled by default for reliability
 setPerformanceConfig({
   enableCaching: true,    // Cache expensive operations
-  enableValidation: true  // Input validation enabled (default)
+  enableValidation: true  // Input validation enabled (built-in, cannot be disabled)
 });
 
-// Note: Currently validation cannot be disabled as it's built into the methods
-// Future versions may add an option to disable validation for maximum performance
+// Note: Validation is built into all methods and cannot be disabled for maximum performance
 ```
 
 ## Configuration
@@ -81,7 +78,6 @@ setPerformanceConfig({
 ### Selective Extensions
 
 ```typescript
-
 import { initializeExtensions, extend } from '@naman_deep_singh/js-extensions';
 
 // Only specific types
@@ -100,15 +96,13 @@ extend.array();  // Only array methods
 ### Performance Configuration
 
 ```typescript
-
 import { initializeExtensions, setPerformanceConfig } from '@naman_deep_singh/js-extensions';
 
 // Configure performance options
 initializeExtensions({
   performance: {
     enableCaching: true,    // Cache expensive operations
-    maxCacheSize: 200,      // LRU cache size
-    enableValidation: false // Skip input validation for speed
+    maxCacheSize: 200       // LRU cache size
   }
 });
 
@@ -307,13 +301,12 @@ import { setPerformanceConfig, getPerformanceConfig } from '@naman_deep_singh/js
 // Enable caching for expensive operations
 setPerformanceConfig({
   enableCaching: true,
-  maxCacheSize: 200,
-  enableValidation: true
+  maxCacheSize: 200
 });
 
 // Check current config
 const config = getPerformanceConfig();
-console.log(config); // {enableCaching: true, maxCacheSize: 200, enableValidation: true}
+console.log(config); // {enableCaching: true, maxCacheSize: 200}
 ```
 
 ### Methods with Built-in Caching
@@ -321,7 +314,6 @@ The following methods automatically use LRU cache when enabled:
 - **`isPrime()`** - Prime number calculations cached for repeated calls
 - **`factorial()`** - Factorial results cached to avoid recalculation  
 - **`toRoman()`** - Roman numeral conversions cached for reuse
-- **`deepClone()`** - Deep clone operations cached for identical objects
 
 ### External Caching
 ```typescript
@@ -368,15 +360,14 @@ const picked: Pick<{a: number, b: string}, 'a'> = {a: 1, b: "test"}.pick(['a']);
 // Performance configuration is also typed
 const config: PerformanceConfig = {
   enableCaching: true,
-  maxCacheSize: 100,
-  enableValidation: false
+  maxCacheSize: 100
 };
 ```
 
 
 ## Package Stats
 
-- **60 utility methods** across 4 JavaScript types
+- **67 utility methods** across 4 JavaScript types
 - **Zero dependencies** - lightweight and fast
 - **Universal compatibility** - Node.js and browser
 - **TypeScript native** - complete type definitions
@@ -388,7 +379,6 @@ const config: PerformanceConfig = {
 
 ### Core Functions
 ```typescript
-
 initializeExtensions(options?: ExtensionOptions): void
 extendAll(): void
 setPerformanceConfig(config: Partial<PerformanceConfig>): void
@@ -401,7 +391,7 @@ extend.object(): void
 extend.number(): void
 ```
 
-### String Methods (17 methods)
+### String Methods (19 methods)
 ```typescript
 toCapitalize(): string
 toCamelCase(): string
@@ -422,7 +412,7 @@ words(): string[]
 lines(): string[]
 ```
 
-### Array Methods (18 methods)
+### Array Methods (21 methods)
 ```typescript
 unique<T>(): T[]
 shuffle<T>(): T[]
@@ -457,7 +447,7 @@ getPath(path: string, defaultValue?: any): any
 setPath(path: string, value: any): any
 ```
 
-### Number Methods (16 methods)
+### Number Methods (18 methods)
 ```typescript
 toPercent(decimals?: number): string
 toCurrency(currency?: string, locale?: string): string
@@ -475,4 +465,5 @@ floor(decimals?: number): number
 abs(): number
 sign(): number
 times(callback: (index: number) => void): void
-```
+```
+

package/dist/cjs/array/array-extensions.js

@@ -37,27 +37,29 @@ function extendArray() {
         }, {});
     };
     Array.prototype.sum = function () {
-        const numbers = this.filter(item => typeof item === 'number');
+        const numbers = this.filter((item) => typeof item === 'number');
         if (numbers.length === 0) {
             throw new TypeError('sum: array must contain at least one number');
         }
         return numbers.reduce((sum, num) => sum + num, 0);
     };
     Array.prototype.average = function () {
-        const numbers = this.filter(item => typeof item === 'number');
+        const numbers = this.filter((item) => typeof item === 'number');
         if (numbers.length === 0) {
             throw new TypeError('average: array must contain at least one number');
         }
         return numbers.reduce((sum, num) => sum + num, 0) / numbers.length;
     };
     Array.prototype.compact = function () {
-        return this.filter(item => item != null && item !== '' && item !== false);
+        return this.filter((item) => item != null && item !== '' && item !== false);
     };
     Array.prototype.pluck = function (key) {
-        if (typeof key !== 'string' && typeof key !== 'number' && typeof key !== 'symbol') {
+        if (typeof key !== 'string' &&
+            typeof key !== 'number' &&
+            typeof key !== 'symbol') {
             throw new TypeError(`pluck: key must be a string, number, or symbol, got ${typeof key}`);
         }
-        return this.map(item => item && typeof item === 'object' ? item[key] : undefined).filter(val => val !== undefined);
+        return this.map((item) => item && typeof item === 'object' ? item[key] : undefined).filter((val) => val !== undefined);
     };
     Array.prototype.findLast = function (predicate) {
         if (typeof predicate !== 'function') {
@@ -75,11 +77,13 @@ function extendArray() {
         }
         const truthy = [];
         const falsy = [];
-        this.forEach(item => predicate(item) ? truthy.push(item) : falsy.push(item));
+        this.forEach((item) => predicate(item) ? truthy.push(item) : falsy.push(item));
         return [truthy, falsy];
     };
     Array.prototype.flatten = function (depth = 1) {
-        return depth > 0 ? this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.flatten(depth - 1) : val), []) : this.slice();
+        return depth > 0
+            ? this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.flatten(depth - 1) : val), [])
+            : this.slice();
     };
     Array.prototype.deepFlatten = function () {
         return this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.deepFlatten() : val), []);
@@ -88,13 +92,13 @@ function extendArray() {
         if (!Array.isArray(other)) {
             throw new TypeError(`difference: other must be an array, got ${typeof other}`);
         }
-        return this.filter(item => !other.includes(item));
+        return this.filter((item) => !other.includes(item));
     };
     Array.prototype.intersection = function (other) {
         if (!Array.isArray(other)) {
             throw new TypeError(`intersection: other must be an array, got ${typeof other}`);
         }
-        return this.filter(item => other.includes(item));
+        return this.filter((item) => other.includes(item));
     };
     Array.prototype.union = function (other) {
         if (!Array.isArray(other)) {
@@ -103,7 +107,9 @@ function extendArray() {
         return [...new Set([...this, ...other])];
     };
     Array.prototype.sample = function () {
-        return this.length > 0 ? this[Math.floor(Math.random() * this.length)] : undefined;
+        return this.length > 0
+            ? this[Math.floor(Math.random() * this.length)]
+            : undefined;
     };
     Array.prototype.take = function (count) {
         return this.slice(0, Math.max(0, count));

package/dist/cjs/core/performance.js

@@ -7,7 +7,7 @@ exports.withCache = withCache;
 const defaultConfig = {
     enableCaching: false,
     maxCacheSize: 100,
-    enableValidation: true
+    enableValidation: true,
 };
 let config = { ...defaultConfig };
 function setPerformanceConfig(newConfig) {

package/dist/cjs/index.d.ts

@@ -1,9 +1,12 @@
 import '../types/global-augmentations';
-import { extendString } from './string';
 import { extendArray } from './array';
-import { extendObject } from './object';
 import { extendNumber } from './number';
-import { withCache, setPerformanceConfig, getPerformanceConfig } from './core/performance';
+import { extendObject } from './object';
+import { extendString } from './string';
+import { LRUCache, getPerformanceConfig, setPerformanceConfig, withCache } from './core/performance';
+import { validateArrayInput, validateExtensionInput, validateNumberRange, validatePositiveInteger } from './core/validation';
+import { mergeConfigs, validateConfig, validatePerformanceSettings } from './utils/config';
+import { ensurePositiveInteger, getPathSegments, hasOwnProperty, isValidArrayIndex, safeClone } from './utils/helpers';
 import { ExtensionOptions, PerformanceConfig } from './types/extension-types';
 export { ExtensionOptions, PerformanceConfig };
 export { withCache };
@@ -26,7 +29,9 @@ export declare const extend: {
     object: typeof extendObject;
     number: typeof extendNumber;
 };
-export { setPerformanceConfig, getPerformanceConfig };
+export { validateExtensionInput, validateArrayInput, validateNumberRange, validatePositiveInteger, };
+export { validateConfig, validatePerformanceSettings, mergeConfigs, isValidArrayIndex, ensurePositiveInteger, safeClone, getPathSegments, hasOwnProperty, };
+export { LRUCache, setPerformanceConfig, getPerformanceConfig };
 declare const _default: {
     initializeExtensions: typeof initializeExtensions;
     extendAll: typeof extendAll;
@@ -36,7 +41,20 @@ declare const _default: {
         object: typeof extendObject;
         number: typeof extendNumber;
     };
+    LRUCache: typeof LRUCache;
     setPerformanceConfig: typeof setPerformanceConfig;
     getPerformanceConfig: typeof getPerformanceConfig;
+    validateExtensionInput: typeof validateExtensionInput;
+    validateArrayInput: typeof validateArrayInput;
+    validateNumberRange: typeof validateNumberRange;
+    validatePositiveInteger: typeof validatePositiveInteger;
+    validateConfig: typeof validateConfig;
+    validatePerformanceSettings: typeof validatePerformanceSettings;
+    mergeConfigs: typeof mergeConfigs;
+    isValidArrayIndex: typeof isValidArrayIndex;
+    ensurePositiveInteger: typeof ensurePositiveInteger;
+    safeClone: typeof safeClone;
+    getPathSegments: typeof getPathSegments;
+    hasOwnProperty: typeof hasOwnProperty;
 };
 export default _default;

package/dist/cjs/index.js

@@ -1,19 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPerformanceConfig = exports.setPerformanceConfig = exports.extend = exports.extendAll = exports.withCache = void 0;
+exports.getPerformanceConfig = exports.setPerformanceConfig = exports.LRUCache = exports.hasOwnProperty = exports.getPathSegments = exports.safeClone = exports.ensurePositiveInteger = exports.isValidArrayIndex = exports.mergeConfigs = exports.validatePerformanceSettings = exports.validateConfig = exports.validatePositiveInteger = exports.validateNumberRange = exports.validateArrayInput = exports.validateExtensionInput = exports.extend = exports.extendAll = exports.withCache = void 0;
 exports.initializeExtensions = initializeExtensions;
 // Import types first
 require("../types/global-augmentations");
-// Import extension modules
-const string_1 = require("./string");
 const array_1 = require("./array");
-const object_1 = require("./object");
 const number_1 = require("./number");
+const object_1 = require("./object");
+// Import extension modules
+const string_1 = require("./string");
 // Import core utilities
 const performance_1 = require("./core/performance");
-Object.defineProperty(exports, "withCache", { enumerable: true, get: function () { return performance_1.withCache; } });
-Object.defineProperty(exports, "setPerformanceConfig", { enumerable: true, get: function () { return performance_1.setPerformanceConfig; } });
+Object.defineProperty(exports, "LRUCache", { enumerable: true, get: function () { return performance_1.LRUCache; } });
 Object.defineProperty(exports, "getPerformanceConfig", { enumerable: true, get: function () { return performance_1.getPerformanceConfig; } });
+Object.defineProperty(exports, "setPerformanceConfig", { enumerable: true, get: function () { return performance_1.setPerformanceConfig; } });
+Object.defineProperty(exports, "withCache", { enumerable: true, get: function () { return performance_1.withCache; } });
+// Import validation utilities
+const validation_1 = require("./core/validation");
+Object.defineProperty(exports, "validateArrayInput", { enumerable: true, get: function () { return validation_1.validateArrayInput; } });
+Object.defineProperty(exports, "validateExtensionInput", { enumerable: true, get: function () { return validation_1.validateExtensionInput; } });
+Object.defineProperty(exports, "validateNumberRange", { enumerable: true, get: function () { return validation_1.validateNumberRange; } });
+Object.defineProperty(exports, "validatePositiveInteger", { enumerable: true, get: function () { return validation_1.validatePositiveInteger; } });
+// Import utility functions
+const config_1 = require("./utils/config");
+Object.defineProperty(exports, "mergeConfigs", { enumerable: true, get: function () { return config_1.mergeConfigs; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_1.validateConfig; } });
+Object.defineProperty(exports, "validatePerformanceSettings", { enumerable: true, get: function () { return config_1.validatePerformanceSettings; } });
+const helpers_1 = require("./utils/helpers");
+Object.defineProperty(exports, "ensurePositiveInteger", { enumerable: true, get: function () { return helpers_1.ensurePositiveInteger; } });
+Object.defineProperty(exports, "getPathSegments", { enumerable: true, get: function () { return helpers_1.getPathSegments; } });
+Object.defineProperty(exports, "hasOwnProperty", { enumerable: true, get: function () { return helpers_1.hasOwnProperty; } });
+Object.defineProperty(exports, "isValidArrayIndex", { enumerable: true, get: function () { return helpers_1.isValidArrayIndex; } });
+Object.defineProperty(exports, "safeClone", { enumerable: true, get: function () { return helpers_1.safeClone; } });
 // Import initialization functions
 const initializer_1 = require("./init/initializer");
 Object.defineProperty(exports, "extendAll", { enumerable: true, get: function () { return initializer_1.extendAll; } });
@@ -31,13 +49,28 @@ exports.extend = {
     string: string_1.extendString,
     array: array_1.extendArray,
     object: object_1.extendObject,
-    number: number_1.extendNumber
+    number: number_1.extendNumber,
 };
 // Default export
 exports.default = {
     initializeExtensions,
     extendAll: initializer_1.extendAll,
     extend: exports.extend,
+    LRUCache: performance_1.LRUCache,
     setPerformanceConfig: performance_1.setPerformanceConfig,
-    getPerformanceConfig: performance_1.getPerformanceConfig
+    getPerformanceConfig: performance_1.getPerformanceConfig,
+    // Validation utilities
+    validateExtensionInput: validation_1.validateExtensionInput,
+    validateArrayInput: validation_1.validateArrayInput,
+    validateNumberRange: validation_1.validateNumberRange,
+    validatePositiveInteger: validation_1.validatePositiveInteger,
+    // Utility functions
+    validateConfig: config_1.validateConfig,
+    validatePerformanceSettings: config_1.validatePerformanceSettings,
+    mergeConfigs: config_1.mergeConfigs,
+    isValidArrayIndex: helpers_1.isValidArrayIndex,
+    ensurePositiveInteger: helpers_1.ensurePositiveInteger,
+    safeClone: helpers_1.safeClone,
+    getPathSegments: helpers_1.getPathSegments,
+    hasOwnProperty: helpers_1.hasOwnProperty,
 };

package/dist/cjs/init/initializer.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function initExtensions(options?: ExtensionOptions): void;
 export declare function extendAll(): void;

package/dist/cjs/init/initializer.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initExtensions = initExtensions;
 exports.extendAll = extendAll;
-const string_1 = require("../string");
+// Extension initialization logic
 const array_1 = require("../array");
-const object_1 = require("../object");
-const number_1 = require("../number");
 const performance_1 = require("../core/performance");
+const number_1 = require("../number");
+const object_1 = require("../object");
+const string_1 = require("../string");
 function initExtensions(options = {}) {
-    const { string = true, array = true, object = true, number = true, performance } = options;
+    const { string = true, array = true, object = true, number = true, performance, } = options;
     if (performance) {
         // Set performance config if provided
         (0, performance_1.setPerformanceConfig)(performance);

package/dist/cjs/init/options.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function validateExtensionOptions(options: Partial<ExtensionOptions>): ExtensionOptions;
 export declare function createExtensionOptions(enableString?: boolean, enableArray?: boolean, enableObject?: boolean, enableNumber?: boolean, performanceConfig?: any): ExtensionOptions;

package/dist/cjs/init/options.js

@@ -8,7 +8,7 @@ function validateExtensionOptions(options) {
         array: options.array !== false,
         object: options.object !== false,
         number: options.number !== false,
-        performance: options.performance
+        performance: options.performance,
     };
     return validated;
 }
@@ -18,6 +18,6 @@ function createExtensionOptions(enableString = true, enableArray = true, enableO
         array: enableArray,
         object: enableObject,
         number: enableNumber,
-        performance: performanceConfig
+        performance: performanceConfig,
     };
 }

package/dist/cjs/number/number-extensions.js

@@ -5,12 +5,12 @@ exports.extendNumber = extendNumber;
 const performance_1 = require("../core/performance");
 function extendNumber() {
     Number.prototype.toPercent = function (decimals = 2) {
-        return (this.valueOf() * 100).toFixed(decimals) + '%';
+        return `${(this.valueOf() * 100).toFixed(decimals)}%`;
     };
     Number.prototype.toCurrency = function (currency = 'USD', locale = 'en-US') {
         return new Intl.NumberFormat(locale, {
             style: 'currency',
-            currency: currency
+            currency,
         }).format(this.valueOf());
     };
     Number.prototype.clamp = function (min, max) {
@@ -41,7 +41,7 @@ function extendNumber() {
         const num = Math.floor(this.valueOf());
         return (0, performance_1.withCache)(`factorial_${num}`, () => {
             if (num < 0)
-                return NaN;
+                return Number.NaN;
             if (num === 0 || num === 1)
                 return 1;
             let result = 1;
@@ -68,7 +68,21 @@ function extendNumber() {
         }
         return (0, performance_1.withCache)(`roman_${num}`, () => {
             const values = [1000, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1];
-            const symbols = ['M', 'CM', 'D', 'CD', 'C', 'XC', 'L', 'XL', 'X', 'IX', 'V', 'IV', 'I'];
+            const symbols = [
+                'M',
+                'CM',
+                'D',
+                'CD',
+                'C',
+                'XC',
+                'L',
+                'XL',
+                'X',
+                'IX',
+                'V',
+                'IV',
+                'I',
+            ];
             let result = '';
             let n = num;
             for (let i = 0; i < values.length; i++) {

package/dist/cjs/object/object-extensions.js

@@ -1,4 +1,5 @@
 "use strict";
+// Object prototype extensions
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extendObject = extendObject;
 function extendObject() {
@@ -17,7 +18,7 @@ function extendObject() {
         }
         const result = {};
         const obj = this;
-        keys.forEach(key => {
+        keys.forEach((key) => {
             if (key in obj) {
                 result[key] = obj[key];
             }
@@ -35,24 +36,24 @@ function extendObject() {
             throw new TypeError('omit: keys array cannot be empty');
         }
         const result = { ...this };
-        keys.forEach(key => {
+        keys.forEach((key) => {
             delete result[key];
         });
         return result;
     };
     Object.prototype.deepClone = function () {
-        // Create a more robust cache key using WeakMap for cycle detection
-        const cloneId = Symbol('clone');
         // Simple cycle detection without caching key generation
         if (this === null || typeof this !== 'object')
             return this;
         // Handle Date objects
         if (this instanceof Date)
             return new Date(this.getTime());
-        // Handle Array objects  
+        // Handle Array objects
         if (Array.isArray(this)) {
-            return this.map(item => {
-                if (item && typeof item === 'object' && typeof item.deepClone === 'function') {
+            return this.map((item) => {
+                if (item &&
+                    typeof item === 'object' &&
+                    typeof item.deepClone === 'function') {
                     return item.deepClone();
                 }
                 return item;
@@ -70,9 +71,9 @@ function extendObject() {
             if (obj instanceof Date)
                 return new Date(obj.getTime());
             if (Array.isArray(obj))
-                return obj.map(item => deepCloneSafe(item));
+                return obj.map((item) => deepCloneSafe(item));
             const cloned = {};
-            Object.keys(obj).forEach(key => {
+            Object.keys(obj).forEach((key) => {
                 cloned[key] = deepCloneSafe(obj[key]);
             });
             return cloned;

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

@@ -23,7 +23,9 @@ function extendString() {
         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();
+        return this.length > length
+            ? this.substring(0, length) + suffix
+            : this.toString();
     };
     String.prototype.isEmail = function () {
         const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
@@ -88,7 +90,9 @@ function extendString() {
         return (this.match(new RegExp(substring, 'g')) || []).length;
     };
     String.prototype.words = function () {
-        return this.trim().split(/\s+/).filter(word => word.length > 0);
+        return this.trim()
+            .split(/\s+/)
+            .filter((word) => word.length > 0);
     };
     String.prototype.lines = function () {
         return this.split(/\r?\n/);

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

@@ -1,4 +1,4 @@
-import { PerformanceConfig } from '../core/performance';
+import type { PerformanceConfig } from '../core/performance';
 export declare function validateConfig(config: Partial<PerformanceConfig>, defaultConfig: PerformanceConfig): PerformanceConfig;
 export declare function validatePerformanceSettings(settings: Partial<PerformanceConfig>): PerformanceConfig;
 export declare function mergeConfigs<T extends Record<string, any>>(base: T, override: Partial<T>): T;

package/dist/cjs/utils/config.js

@@ -10,7 +10,7 @@ function validatePerformanceSettings(settings) {
     const validated = {
         enableCaching: settings.enableCaching ?? false,
         maxCacheSize: Math.max(1, settings.maxCacheSize ?? 100),
-        enableValidation: settings.enableValidation ?? true
+        enableValidation: settings.enableValidation ?? true,
     };
     return validated;
 }

package/dist/cjs/utils/helpers.js

@@ -20,7 +20,7 @@ function safeClone(obj) {
     if (obj instanceof Date)
         return new Date(obj.getTime());
     if (Array.isArray(obj))
-        return obj.map(item => safeClone(item));
+        return obj.map((item) => safeClone(item));
     const cloned = {};
     for (const key in obj) {
         if (obj.hasOwnProperty(key)) {
@@ -30,7 +30,7 @@ function safeClone(obj) {
     return cloned;
 }
 function getPathSegments(path) {
-    return path.split('.').filter(segment => segment.length > 0);
+    return path.split('.').filter((segment) => segment.length > 0);
 }
 function hasOwnProperty(obj, key) {
     return Object.prototype.hasOwnProperty.call(obj, key);

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

@@ -34,27 +34,29 @@ export function extendArray() {
         }, {});
     };
     Array.prototype.sum = function () {
-        const numbers = this.filter(item => typeof item === 'number');
+        const numbers = this.filter((item) => typeof item === 'number');
         if (numbers.length === 0) {
             throw new TypeError('sum: array must contain at least one number');
         }
         return numbers.reduce((sum, num) => sum + num, 0);
     };
     Array.prototype.average = function () {
-        const numbers = this.filter(item => typeof item === 'number');
+        const numbers = this.filter((item) => typeof item === 'number');
         if (numbers.length === 0) {
             throw new TypeError('average: array must contain at least one number');
         }
         return numbers.reduce((sum, num) => sum + num, 0) / numbers.length;
     };
     Array.prototype.compact = function () {
-        return this.filter(item => item != null && item !== '' && item !== false);
+        return this.filter((item) => item != null && item !== '' && item !== false);
     };
     Array.prototype.pluck = function (key) {
-        if (typeof key !== 'string' && typeof key !== 'number' && typeof key !== 'symbol') {
+        if (typeof key !== 'string' &&
+            typeof key !== 'number' &&
+            typeof key !== 'symbol') {
             throw new TypeError(`pluck: key must be a string, number, or symbol, got ${typeof key}`);
         }
-        return this.map(item => item && typeof item === 'object' ? item[key] : undefined).filter(val => val !== undefined);
+        return this.map((item) => item && typeof item === 'object' ? item[key] : undefined).filter((val) => val !== undefined);
     };
     Array.prototype.findLast = function (predicate) {
         if (typeof predicate !== 'function') {
@@ -72,11 +74,13 @@ export function extendArray() {
         }
         const truthy = [];
         const falsy = [];
-        this.forEach(item => predicate(item) ? truthy.push(item) : falsy.push(item));
+        this.forEach((item) => predicate(item) ? truthy.push(item) : falsy.push(item));
         return [truthy, falsy];
     };
     Array.prototype.flatten = function (depth = 1) {
-        return depth > 0 ? this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.flatten(depth - 1) : val), []) : this.slice();
+        return depth > 0
+            ? this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.flatten(depth - 1) : val), [])
+            : this.slice();
     };
     Array.prototype.deepFlatten = function () {
         return this.reduce((acc, val) => acc.concat(Array.isArray(val) ? val.deepFlatten() : val), []);
@@ -85,13 +89,13 @@ export function extendArray() {
         if (!Array.isArray(other)) {
             throw new TypeError(`difference: other must be an array, got ${typeof other}`);
         }
-        return this.filter(item => !other.includes(item));
+        return this.filter((item) => !other.includes(item));
     };
     Array.prototype.intersection = function (other) {
         if (!Array.isArray(other)) {
             throw new TypeError(`intersection: other must be an array, got ${typeof other}`);
         }
-        return this.filter(item => other.includes(item));
+        return this.filter((item) => other.includes(item));
     };
     Array.prototype.union = function (other) {
         if (!Array.isArray(other)) {
@@ -100,7 +104,9 @@ export function extendArray() {
         return [...new Set([...this, ...other])];
     };
     Array.prototype.sample = function () {
-        return this.length > 0 ? this[Math.floor(Math.random() * this.length)] : undefined;
+        return this.length > 0
+            ? this[Math.floor(Math.random() * this.length)]
+            : undefined;
     };
     Array.prototype.take = function (count) {
         return this.slice(0, Math.max(0, count));

package/dist/esm/core/performance.js

@@ -1,7 +1,7 @@
 const defaultConfig = {
     enableCaching: false,
     maxCacheSize: 100,
-    enableValidation: true
+    enableValidation: true,
 };
 let config = { ...defaultConfig };
 export function setPerformanceConfig(newConfig) {

package/dist/esm/index.d.ts

@@ -1,9 +1,12 @@
 import '../types/global-augmentations';
-import { extendString } from './string';
 import { extendArray } from './array';
-import { extendObject } from './object';
 import { extendNumber } from './number';
-import { withCache, setPerformanceConfig, getPerformanceConfig } from './core/performance';
+import { extendObject } from './object';
+import { extendString } from './string';
+import { LRUCache, getPerformanceConfig, setPerformanceConfig, withCache } from './core/performance';
+import { validateArrayInput, validateExtensionInput, validateNumberRange, validatePositiveInteger } from './core/validation';
+import { mergeConfigs, validateConfig, validatePerformanceSettings } from './utils/config';
+import { ensurePositiveInteger, getPathSegments, hasOwnProperty, isValidArrayIndex, safeClone } from './utils/helpers';
 import { ExtensionOptions, PerformanceConfig } from './types/extension-types';
 export { ExtensionOptions, PerformanceConfig };
 export { withCache };
@@ -26,7 +29,9 @@ export declare const extend: {
     object: typeof extendObject;
     number: typeof extendNumber;
 };
-export { setPerformanceConfig, getPerformanceConfig };
+export { validateExtensionInput, validateArrayInput, validateNumberRange, validatePositiveInteger, };
+export { validateConfig, validatePerformanceSettings, mergeConfigs, isValidArrayIndex, ensurePositiveInteger, safeClone, getPathSegments, hasOwnProperty, };
+export { LRUCache, setPerformanceConfig, getPerformanceConfig };
 declare const _default: {
     initializeExtensions: typeof initializeExtensions;
     extendAll: typeof extendAll;
@@ -36,7 +41,20 @@ declare const _default: {
         object: typeof extendObject;
         number: typeof extendNumber;
     };
+    LRUCache: typeof LRUCache;
     setPerformanceConfig: typeof setPerformanceConfig;
     getPerformanceConfig: typeof getPerformanceConfig;
+    validateExtensionInput: typeof validateExtensionInput;
+    validateArrayInput: typeof validateArrayInput;
+    validateNumberRange: typeof validateNumberRange;
+    validatePositiveInteger: typeof validatePositiveInteger;
+    validateConfig: typeof validateConfig;
+    validatePerformanceSettings: typeof validatePerformanceSettings;
+    mergeConfigs: typeof mergeConfigs;
+    isValidArrayIndex: typeof isValidArrayIndex;
+    ensurePositiveInteger: typeof ensurePositiveInteger;
+    safeClone: typeof safeClone;
+    getPathSegments: typeof getPathSegments;
+    hasOwnProperty: typeof hasOwnProperty;
 };
 export default _default;

package/dist/esm/index.js

@@ -1,16 +1,21 @@
 // Import types first
 import '../types/global-augmentations';
-// Import extension modules
-import { extendString } from './string';
 import { extendArray } from './array';
-import { extendObject } from './object';
 import { extendNumber } from './number';
+import { extendObject } from './object';
+// Import extension modules
+import { extendString } from './string';
 // Import core utilities
-import { withCache, setPerformanceConfig, getPerformanceConfig } from './core/performance';
+import { LRUCache, getPerformanceConfig, setPerformanceConfig, withCache, } from './core/performance';
+// Import validation utilities
+import { validateArrayInput, validateExtensionInput, validateNumberRange, validatePositiveInteger, } from './core/validation';
+// Import utility functions
+import { mergeConfigs, validateConfig, validatePerformanceSettings, } from './utils/config';
+import { ensurePositiveInteger, getPathSegments, hasOwnProperty, isValidArrayIndex, safeClone, } from './utils/helpers';
 // Export withCache for use in extensions
 export { withCache };
 // Import initialization functions
-import { initExtensions, extendAll } from './init/initializer';
+import { extendAll, initExtensions } from './init/initializer';
 /**
  * Initialize JavaScript prototype extensions
  * @param options - Configure which extensions to enable (default: all enabled)
@@ -29,15 +34,34 @@ export const extend = {
     string: extendString,
     array: extendArray,
     object: extendObject,
-    number: extendNumber
+    number: extendNumber,
 };
+// Export validation utilities
+export { validateExtensionInput, validateArrayInput, validateNumberRange, validatePositiveInteger, };
+// Export utility functions
+export { validateConfig, validatePerformanceSettings, mergeConfigs, isValidArrayIndex, ensurePositiveInteger, safeClone, getPathSegments, hasOwnProperty, };
 // Export performance utilities
-export { setPerformanceConfig, getPerformanceConfig };
+export { LRUCache, setPerformanceConfig, getPerformanceConfig };
 // Default export
 export default {
     initializeExtensions,
     extendAll,
     extend,
+    LRUCache,
     setPerformanceConfig,
-    getPerformanceConfig
+    getPerformanceConfig,
+    // Validation utilities
+    validateExtensionInput,
+    validateArrayInput,
+    validateNumberRange,
+    validatePositiveInteger,
+    // Utility functions
+    validateConfig,
+    validatePerformanceSettings,
+    mergeConfigs,
+    isValidArrayIndex,
+    ensurePositiveInteger,
+    safeClone,
+    getPathSegments,
+    hasOwnProperty,
 };

package/dist/esm/init/initializer.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function initExtensions(options?: ExtensionOptions): void;
 export declare function extendAll(): void;

package/dist/esm/init/initializer.js

@@ -1,10 +1,11 @@
-import { extendString } from '../string';
+// Extension initialization logic
 import { extendArray } from '../array';
-import { extendObject } from '../object';
-import { extendNumber } from '../number';
 import { setPerformanceConfig } from '../core/performance';
+import { extendNumber } from '../number';
+import { extendObject } from '../object';
+import { extendString } from '../string';
 export function initExtensions(options = {}) {
-    const { string = true, array = true, object = true, number = true, performance } = options;
+    const { string = true, array = true, object = true, number = true, performance, } = options;
     if (performance) {
         // Set performance config if provided
         setPerformanceConfig(performance);

package/dist/esm/init/options.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function validateExtensionOptions(options: Partial<ExtensionOptions>): ExtensionOptions;
 export declare function createExtensionOptions(enableString?: boolean, enableArray?: boolean, enableObject?: boolean, enableNumber?: boolean, performanceConfig?: any): ExtensionOptions;

package/dist/esm/init/options.js

@@ -4,7 +4,7 @@ export function validateExtensionOptions(options) {
         array: options.array !== false,
         object: options.object !== false,
         number: options.number !== false,
-        performance: options.performance
+        performance: options.performance,
     };
     return validated;
 }
@@ -14,6 +14,6 @@ export function createExtensionOptions(enableString = true, enableArray = true,
         array: enableArray,
         object: enableObject,
         number: enableNumber,
-        performance: performanceConfig
+        performance: performanceConfig,
     };
 }

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

@@ -2,12 +2,12 @@
 import { withCache } from '../core/performance';
 export function extendNumber() {
     Number.prototype.toPercent = function (decimals = 2) {
-        return (this.valueOf() * 100).toFixed(decimals) + '%';
+        return `${(this.valueOf() * 100).toFixed(decimals)}%`;
     };
     Number.prototype.toCurrency = function (currency = 'USD', locale = 'en-US') {
         return new Intl.NumberFormat(locale, {
             style: 'currency',
-            currency: currency
+            currency,
         }).format(this.valueOf());
     };
     Number.prototype.clamp = function (min, max) {
@@ -38,7 +38,7 @@ export function extendNumber() {
         const num = Math.floor(this.valueOf());
         return withCache(`factorial_${num}`, () => {
             if (num < 0)
-                return NaN;
+                return Number.NaN;
             if (num === 0 || num === 1)
                 return 1;
             let result = 1;
@@ -65,7 +65,21 @@ export function extendNumber() {
         }
         return withCache(`roman_${num}`, () => {
             const values = [1000, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1];
-            const symbols = ['M', 'CM', 'D', 'CD', 'C', 'XC', 'L', 'XL', 'X', 'IX', 'V', 'IV', 'I'];
+            const symbols = [
+                'M',
+                'CM',
+                'D',
+                'CD',
+                'C',
+                'XC',
+                'L',
+                'XL',
+                'X',
+                'IX',
+                'V',
+                'IV',
+                'I',
+            ];
             let result = '';
             let n = num;
             for (let i = 0; i < values.length; i++) {

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

@@ -1,3 +1,4 @@
+// Object prototype extensions
 export function extendObject() {
     Object.prototype.isEmpty = function () {
         return Object.keys(this).length === 0;
@@ -14,7 +15,7 @@ export function extendObject() {
         }
         const result = {};
         const obj = this;
-        keys.forEach(key => {
+        keys.forEach((key) => {
             if (key in obj) {
                 result[key] = obj[key];
             }
@@ -32,24 +33,24 @@ export function extendObject() {
             throw new TypeError('omit: keys array cannot be empty');
         }
         const result = { ...this };
-        keys.forEach(key => {
+        keys.forEach((key) => {
             delete result[key];
         });
         return result;
     };
     Object.prototype.deepClone = function () {
-        // Create a more robust cache key using WeakMap for cycle detection
-        const cloneId = Symbol('clone');
         // Simple cycle detection without caching key generation
         if (this === null || typeof this !== 'object')
             return this;
         // Handle Date objects
         if (this instanceof Date)
             return new Date(this.getTime());
-        // Handle Array objects  
+        // Handle Array objects
         if (Array.isArray(this)) {
-            return this.map(item => {
-                if (item && typeof item === 'object' && typeof item.deepClone === 'function') {
+            return this.map((item) => {
+                if (item &&
+                    typeof item === 'object' &&
+                    typeof item.deepClone === 'function') {
                     return item.deepClone();
                 }
                 return item;
@@ -67,9 +68,9 @@ export function extendObject() {
             if (obj instanceof Date)
                 return new Date(obj.getTime());
             if (Array.isArray(obj))
-                return obj.map(item => deepCloneSafe(item));
+                return obj.map((item) => deepCloneSafe(item));
             const cloned = {};
-            Object.keys(obj).forEach(key => {
+            Object.keys(obj).forEach((key) => {
                 cloned[key] = deepCloneSafe(obj[key]);
             });
             return cloned;

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

@@ -20,7 +20,9 @@ export function extendString() {
         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();
+        return this.length > length
+            ? this.substring(0, length) + suffix
+            : this.toString();
     };
     String.prototype.isEmail = function () {
         const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
@@ -85,7 +87,9 @@ export function extendString() {
         return (this.match(new RegExp(substring, 'g')) || []).length;
     };
     String.prototype.words = function () {
-        return this.trim().split(/\s+/).filter(word => word.length > 0);
+        return this.trim()
+            .split(/\s+/)
+            .filter((word) => word.length > 0);
     };
     String.prototype.lines = function () {
         return this.split(/\r?\n/);

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

@@ -1,4 +1,4 @@
-import { PerformanceConfig } from '../core/performance';
+import type { PerformanceConfig } from '../core/performance';
 export declare function validateConfig(config: Partial<PerformanceConfig>, defaultConfig: PerformanceConfig): PerformanceConfig;
 export declare function validatePerformanceSettings(settings: Partial<PerformanceConfig>): PerformanceConfig;
 export declare function mergeConfigs<T extends Record<string, any>>(base: T, override: Partial<T>): T;

package/dist/esm/utils/config.js

@@ -5,7 +5,7 @@ export function validatePerformanceSettings(settings) {
     const validated = {
         enableCaching: settings.enableCaching ?? false,
         maxCacheSize: Math.max(1, settings.maxCacheSize ?? 100),
-        enableValidation: settings.enableValidation ?? true
+        enableValidation: settings.enableValidation ?? true,
     };
     return validated;
 }

package/dist/esm/utils/helpers.js

@@ -13,7 +13,7 @@ export function safeClone(obj) {
     if (obj instanceof Date)
         return new Date(obj.getTime());
     if (Array.isArray(obj))
-        return obj.map(item => safeClone(item));
+        return obj.map((item) => safeClone(item));
     const cloned = {};
     for (const key in obj) {
         if (obj.hasOwnProperty(key)) {
@@ -23,7 +23,7 @@ export function safeClone(obj) {
     return cloned;
 }
 export function getPathSegments(path) {
-    return path.split('.').filter(segment => segment.length > 0);
+    return path.split('.').filter((segment) => segment.length > 0);
 }
 export function hasOwnProperty(obj, key) {
     return Object.prototype.hasOwnProperty.call(obj, key);

package/dist/types/index.d.ts

@@ -1,9 +1,12 @@
 import '../types/global-augmentations';
-import { extendString } from './string';
 import { extendArray } from './array';
-import { extendObject } from './object';
 import { extendNumber } from './number';
-import { withCache, setPerformanceConfig, getPerformanceConfig } from './core/performance';
+import { extendObject } from './object';
+import { extendString } from './string';
+import { LRUCache, getPerformanceConfig, setPerformanceConfig, withCache } from './core/performance';
+import { validateArrayInput, validateExtensionInput, validateNumberRange, validatePositiveInteger } from './core/validation';
+import { mergeConfigs, validateConfig, validatePerformanceSettings } from './utils/config';
+import { ensurePositiveInteger, getPathSegments, hasOwnProperty, isValidArrayIndex, safeClone } from './utils/helpers';
 import { ExtensionOptions, PerformanceConfig } from './types/extension-types';
 export { ExtensionOptions, PerformanceConfig };
 export { withCache };
@@ -26,7 +29,9 @@ export declare const extend: {
     object: typeof extendObject;
     number: typeof extendNumber;
 };
-export { setPerformanceConfig, getPerformanceConfig };
+export { validateExtensionInput, validateArrayInput, validateNumberRange, validatePositiveInteger, };
+export { validateConfig, validatePerformanceSettings, mergeConfigs, isValidArrayIndex, ensurePositiveInteger, safeClone, getPathSegments, hasOwnProperty, };
+export { LRUCache, setPerformanceConfig, getPerformanceConfig };
 declare const _default: {
     initializeExtensions: typeof initializeExtensions;
     extendAll: typeof extendAll;
@@ -36,7 +41,20 @@ declare const _default: {
         object: typeof extendObject;
         number: typeof extendNumber;
     };
+    LRUCache: typeof LRUCache;
     setPerformanceConfig: typeof setPerformanceConfig;
     getPerformanceConfig: typeof getPerformanceConfig;
+    validateExtensionInput: typeof validateExtensionInput;
+    validateArrayInput: typeof validateArrayInput;
+    validateNumberRange: typeof validateNumberRange;
+    validatePositiveInteger: typeof validatePositiveInteger;
+    validateConfig: typeof validateConfig;
+    validatePerformanceSettings: typeof validatePerformanceSettings;
+    mergeConfigs: typeof mergeConfigs;
+    isValidArrayIndex: typeof isValidArrayIndex;
+    ensurePositiveInteger: typeof ensurePositiveInteger;
+    safeClone: typeof safeClone;
+    getPathSegments: typeof getPathSegments;
+    hasOwnProperty: typeof hasOwnProperty;
 };
 export default _default;

package/dist/types/init/initializer.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function initExtensions(options?: ExtensionOptions): void;
 export declare function extendAll(): void;

package/dist/types/init/options.d.ts

@@ -1,3 +1,3 @@
-import { ExtensionOptions } from '../types/extension-types';
+import type { ExtensionOptions } from '../types/extension-types';
 export declare function validateExtensionOptions(options: Partial<ExtensionOptions>): ExtensionOptions;
 export declare function createExtensionOptions(enableString?: boolean, enableArray?: boolean, enableObject?: boolean, enableNumber?: boolean, performanceConfig?: any): ExtensionOptions;

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

@@ -1,4 +1,4 @@
-import { PerformanceConfig } from '../core/performance';
+import type { PerformanceConfig } from '../core/performance';
 export declare function validateConfig(config: Partial<PerformanceConfig>, defaultConfig: PerformanceConfig): PerformanceConfig;
 export declare function validatePerformanceSettings(settings: Partial<PerformanceConfig>): PerformanceConfig;
 export declare function mergeConfigs<T extends Record<string, any>>(base: T, override: Partial<T>): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naman_deep_singh/js-extensions",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Universal JavaScript prototype extensions for common development utilities",
   "type": "module",
   "main": "./dist/cjs/index.js",