@naman_deep_singh/utils 2.1.1 → 2.3.0

package/package.json

@@ -1,16 +1,62 @@
 {
   "name": "@naman_deep_singh/utils",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "description": "Universal JavaScript prototype extensions for common development utilities",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "browser": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/types/index.d.ts",
       "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
+      "require": "./dist/cjs/index.js"
+    },
+    "./array": {
+      "types": "./dist/types/array/index.d.ts",
+      "import": "./dist/esm/array/index.js",
+      "require": "./dist/cjs/array/index.js"
+    },
+    "./number": {
+      "types": "./dist/types/number/index.d.ts",
+      "import": "./dist/esm/number/index.js",
+      "require": "./dist/cjs/number/index.js"
+    },
+    "./string": {
+      "types": "./dist/types/string/index.d.ts",
+      "import": "./dist/esm/string/index.js",
+      "require": "./dist/cjs/string/index.js"
+    },
+    "./object": {
+      "types": "./dist/types/object/index.d.ts",
+      "import": "./dist/esm/object/index.js",
+      "require": "./dist/cjs/object/index.js"
+    },
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/esm/core/index.js",
+      "require": "./dist/cjs/core/index.js"
+    },
+    "./utils": {
+      "types": "./dist/types/utils/index.d.ts",
+      "import": "./dist/esm/utils/index.js",
+      "require": "./dist/cjs/utils/index.js"
+    },
+    "./init": {
+      "types": "./dist/types/init/index.d.ts",
+      "import": "./dist/esm/init/index.js",
+      "require": "./dist/cjs/init/index.js"
+    },
+    "./extensions": {
+      "types": "./dist/types/extensions/index.d.ts",
+      "import": "./dist/esm/extensions/index.js",
+      "require": "./dist/cjs/extensions/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/types/index.d.ts",
+      "import": "./dist/esm/types/index.js",
+      "require": "./dist/cjs/types/index.js"
     }
   },
   "sideEffects": false,
@@ -42,7 +88,7 @@
   },
   "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",
+    "build:types": "tsc -p tsconfig.types.json",
     "clean": "rimraf dist",
     "clean:js": "find src -type f -name \"*.js\" -delete"
   }

package/dist/cjs/array/index.d.ts

@@ -1 +0,0 @@
-export { extendArray } from './array-extensions';

package/dist/cjs/core/index.d.ts

@@ -1,2 +0,0 @@
-export * from './validation';
-export * from './performance';

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

@@ -1,17 +0,0 @@
-export interface PerformanceConfig {
-    enableCaching?: boolean;
-    maxCacheSize?: number;
-    enableValidation?: boolean;
-}
-export declare function setPerformanceConfig(newConfig: Partial<PerformanceConfig>): void;
-export declare function getPerformanceConfig(): PerformanceConfig;
-export declare class LRUCache<K, V> {
-    private cache;
-    private maxSize;
-    constructor(maxSize?: number);
-    get(key: K): V | undefined;
-    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/cjs/core/validation.d.ts

@@ -1,4 +0,0 @@
-export declare function validateExtensionInput(value: any, type: string, methodName: string): void;
-export declare function validateArrayInput<T>(arr: T[], methodName: string): void;
-export declare function validateNumberRange(num: number, min: number, max: number, methodName: string): void;
-export declare function validatePositiveInteger(num: number, methodName: string): void;

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

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

package/dist/cjs/extensions/index.d.ts

@@ -1,4 +0,0 @@
-export * from '../string';
-export * from '../array';
-export * from '../object';
-export * from '../number';

package/dist/cjs/index.d.ts

@@ -1,61 +0,0 @@
-import '../types/global-augmentations';
-import { extendArray } from './array';
-import { extendNumber } from './number';
-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 };
-import { extendAll } from './init/initializer';
-/**
- * Initialize JavaScript prototype extensions
- * @param options - Configure which extensions to enable (default: all enabled)
- */
-export declare function initializeExtensions(options?: ExtensionOptions): void;
-/**
- * Initialize all extensions (convenience function)
- */
-export { extendAll };
-/**
- * Selective prototype extension helpers
- * Initialize only specific extensions
- */
-export declare const extend: {
-    string: typeof extendString;
-    array: typeof extendArray;
-    object: typeof extendObject;
-    number: typeof extendNumber;
-};
-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;
-    extend: {
-        string: typeof extendString;
-        array: typeof extendArray;
-        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/init/index.d.ts

@@ -1,2 +0,0 @@
-export * from './initializer';
-export * from './options';

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

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

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

@@ -1,3 +0,0 @@
-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/number/index.d.ts

@@ -1 +0,0 @@
-export { extendNumber } from './number-extensions';

package/dist/cjs/object/index.d.ts

@@ -1 +0,0 @@
-export { extendObject } from './object-extensions';

package/dist/cjs/string/index.d.ts

@@ -1 +0,0 @@
-export { extendString } from './string-extensions';

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

@@ -1,2 +0,0 @@
-export * from './extension-types';
-export * from './global-augmentations';

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

@@ -1,4 +0,0 @@
-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/defineExtension.d.ts

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

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

@@ -1,5 +0,0 @@
-export declare function isValidArrayIndex(index: number): boolean;
-export declare function ensurePositiveInteger(value: number, name: string): void;
-export declare function safeClone<T>(obj: T): T;
-export declare function getPathSegments(path: string): string[];
-export declare function hasOwnProperty(obj: any, key: string): boolean;

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

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

package/dist/esm/array/array-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendArray(): void;

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

@@ -1 +0,0 @@
-export { extendArray } from './array-extensions';

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

@@ -1,2 +0,0 @@
-export * from './validation';
-export * from './performance';

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

@@ -1,17 +0,0 @@
-export interface PerformanceConfig {
-    enableCaching?: boolean;
-    maxCacheSize?: number;
-    enableValidation?: boolean;
-}
-export declare function setPerformanceConfig(newConfig: Partial<PerformanceConfig>): void;
-export declare function getPerformanceConfig(): PerformanceConfig;
-export declare class LRUCache<K, V> {
-    private cache;
-    private maxSize;
-    constructor(maxSize?: number);
-    get(key: K): V | undefined;
-    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/esm/core/validation.d.ts

@@ -1,4 +0,0 @@
-export declare function validateExtensionInput(value: any, type: string, methodName: string): void;
-export declare function validateArrayInput<T>(arr: T[], methodName: string): void;
-export declare function validateNumberRange(num: number, min: number, max: number, methodName: string): void;
-export declare function validatePositiveInteger(num: number, methodName: string): void;

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

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

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

@@ -1,4 +0,0 @@
-export * from '../string';
-export * from '../array';
-export * from '../object';
-export * from '../number';

package/dist/esm/index.d.ts

@@ -1,61 +0,0 @@
-import '../types/global-augmentations';
-import { extendArray } from './array';
-import { extendNumber } from './number';
-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 };
-import { extendAll } from './init/initializer';
-/**
- * Initialize JavaScript prototype extensions
- * @param options - Configure which extensions to enable (default: all enabled)
- */
-export declare function initializeExtensions(options?: ExtensionOptions): void;
-/**
- * Initialize all extensions (convenience function)
- */
-export { extendAll };
-/**
- * Selective prototype extension helpers
- * Initialize only specific extensions
- */
-export declare const extend: {
-    string: typeof extendString;
-    array: typeof extendArray;
-    object: typeof extendObject;
-    number: typeof extendNumber;
-};
-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;
-    extend: {
-        string: typeof extendString;
-        array: typeof extendArray;
-        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/init/index.d.ts

@@ -1,2 +0,0 @@
-export * from './initializer';
-export * from './options';

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

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

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

@@ -1,3 +0,0 @@
-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/number/index.d.ts

@@ -1 +0,0 @@
-export { extendNumber } from './number-extensions';

package/dist/esm/number/number-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendNumber(): void;

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

@@ -1 +0,0 @@
-export { extendObject } from './object-extensions';

package/dist/esm/object/object-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendObject(): void;

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

@@ -1 +0,0 @@
-export { extendString } from './string-extensions';

package/dist/esm/string/string-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendString(): void;

package/dist/esm/types/extension-types.d.ts

@@ -1,9 +0,0 @@
-import { PerformanceConfig } from '../core/performance';
-export interface ExtensionOptions {
-    string?: boolean;
-    array?: boolean;
-    object?: boolean;
-    number?: boolean;
-    performance?: PerformanceConfig;
-}
-export { PerformanceConfig };

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

@@ -1,72 +0,0 @@
-declare global {
-    interface String {
-        toCapitalize(): string;
-        toCamelCase(): string;
-        toKebabCase(): string;
-        toSnakeCase(): string;
-        truncate(length: number, suffix?: string): string;
-        isEmail(): boolean;
-        isUrl(): boolean;
-        removeWhitespace(): string;
-        reverse(): string;
-        isPalindrome(): boolean;
-        toTitleCase(): string;
-        stripHtml(): string;
-        padStart(targetLength: number, padString?: string): string;
-        padEnd(targetLength: number, padString?: string): string;
-        count(substring: string): number;
-        words(): string[];
-        lines(): string[];
-    }
-    interface Array<T> {
-        unique(): T[];
-        shuffle(): T[];
-        chunk(size: number): T[][];
-        groupBy<K extends string | number>(keyFn: (item: T) => K): Record<K, T[]>;
-        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[]];
-        flatten(depth?: number): any[];
-        deepFlatten(): any[];
-        difference(other: T[]): T[];
-        intersection(other: T[]): T[];
-        union(other: T[]): T[];
-        sample(): T | undefined;
-        take(count: number): T[];
-        drop(count: number): T[];
-    }
-    interface Object {
-        isEmpty(): boolean;
-        pick<T extends Record<string, any>, K extends keyof T>(keys: K[]): Pick<T, K>;
-        omit<T extends Record<string, any>, K extends keyof T>(keys: K[]): Omit<T, K>;
-        deepClone<T>(): T;
-        merge(other: Record<string, any>): Record<string, any>;
-        deepFreeze<T>(): T;
-        hasPath(path: string): boolean;
-        getPath(path: string, defaultValue?: any): any;
-        setPath(path: string, value: any): any;
-    }
-    interface Number {
-        toPercent(decimals?: number): string;
-        toCurrency(currency?: string, locale?: string): string;
-        clamp(min: number, max: number): number;
-        isEven(): boolean;
-        isOdd(): boolean;
-        isPrime(): boolean;
-        factorial(): number;
-        toOrdinal(): string;
-        toRoman(): string;
-        inRange(min: number, max: number): boolean;
-        round(decimals?: number): number;
-        ceil(decimals?: number): number;
-        floor(decimals?: number): number;
-        abs(): number;
-        sign(): number;
-        times(callback: (index: number) => void): void;
-    }
-}
-export {};

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

@@ -1,2 +0,0 @@
-export * from './extension-types';
-export * from './global-augmentations';

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

@@ -1,4 +0,0 @@
-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/defineExtension.d.ts

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

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

@@ -1,5 +0,0 @@
-export declare function isValidArrayIndex(index: number): boolean;
-export declare function ensurePositiveInteger(value: number, name: string): void;
-export declare function safeClone<T>(obj: T): T;
-export declare function getPathSegments(path: string): string[];
-export declare function hasOwnProperty(obj: any, key: string): boolean;

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

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

package/dist/types/array/array-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendArray(): void;

package/dist/types/number/number-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendNumber(): void;

package/dist/types/object/object-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendObject(): void;

package/dist/types/string/string-extensions.d.ts

@@ -1 +0,0 @@
-export declare function extendString(): void;

package/dist/types/types/extension-types.d.ts

@@ -1,9 +0,0 @@
-import { PerformanceConfig } from '../core/performance';
-export interface ExtensionOptions {
-    string?: boolean;
-    array?: boolean;
-    object?: boolean;
-    number?: boolean;
-    performance?: PerformanceConfig;
-}
-export { PerformanceConfig };

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

@@ -1,72 +0,0 @@
-declare global {
-    interface String {
-        toCapitalize(): string;
-        toCamelCase(): string;
-        toKebabCase(): string;
-        toSnakeCase(): string;
-        truncate(length: number, suffix?: string): string;
-        isEmail(): boolean;
-        isUrl(): boolean;
-        removeWhitespace(): string;
-        reverse(): string;
-        isPalindrome(): boolean;
-        toTitleCase(): string;
-        stripHtml(): string;
-        padStart(targetLength: number, padString?: string): string;
-        padEnd(targetLength: number, padString?: string): string;
-        count(substring: string): number;
-        words(): string[];
-        lines(): string[];
-    }
-    interface Array<T> {
-        unique(): T[];
-        shuffle(): T[];
-        chunk(size: number): T[][];
-        groupBy<K extends string | number>(keyFn: (item: T) => K): Record<K, T[]>;
-        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[]];
-        flatten(depth?: number): any[];
-        deepFlatten(): any[];
-        difference(other: T[]): T[];
-        intersection(other: T[]): T[];
-        union(other: T[]): T[];
-        sample(): T | undefined;
-        take(count: number): T[];
-        drop(count: number): T[];
-    }
-    interface Object {
-        isEmpty(): boolean;
-        pick<T extends Record<string, any>, K extends keyof T>(keys: K[]): Pick<T, K>;
-        omit<T extends Record<string, any>, K extends keyof T>(keys: K[]): Omit<T, K>;
-        deepClone<T>(): T;
-        merge(other: Record<string, any>): Record<string, any>;
-        deepFreeze<T>(): T;
-        hasPath(path: string): boolean;
-        getPath(path: string, defaultValue?: any): any;
-        setPath(path: string, value: any): any;
-    }
-    interface Number {
-        toPercent(decimals?: number): string;
-        toCurrency(currency?: string, locale?: string): string;
-        clamp(min: number, max: number): number;
-        isEven(): boolean;
-        isOdd(): boolean;
-        isPrime(): boolean;
-        factorial(): number;
-        toOrdinal(): string;
-        toRoman(): string;
-        inRange(min: number, max: number): boolean;
-        round(decimals?: number): number;
-        ceil(decimals?: number): number;
-        floor(decimals?: number): number;
-        abs(): number;
-        sign(): number;
-        times(callback: (index: number) => void): void;
-    }
-}
-export {};