ts-packages 1.0.0 → 3.0.0

package/packages/js-extensions/dist/esm/types/global-augmentations.d.ts

@@ -0,0 +1,72 @@
+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/packages/js-extensions/dist/esm/types/global-augmentations.js

@@ -0,0 +1 @@
+export {};

package/packages/js-extensions/dist/esm/types/index.d.ts

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

package/packages/js-extensions/dist/esm/types/index.js

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

package/packages/js-extensions/dist/esm/utils/config.d.ts

@@ -0,0 +1,4 @@
+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/packages/js-extensions/dist/esm/utils/config.js

@@ -0,0 +1,20 @@
+export function validateConfig(config, defaultConfig) {
+    return { ...defaultConfig, ...config };
+}
+export function validatePerformanceSettings(settings) {
+    const validated = {
+        enableCaching: settings.enableCaching ?? false,
+        maxCacheSize: Math.max(1, settings.maxCacheSize ?? 100),
+        enableValidation: settings.enableValidation ?? true,
+    };
+    return validated;
+}
+export function mergeConfigs(base, override) {
+    const result = { ...base };
+    for (const key in override) {
+        if (override[key] !== undefined) {
+            result[key] = override[key];
+        }
+    }
+    return result;
+}

package/packages/js-extensions/dist/esm/utils/defineExtension.d.ts

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

package/packages/js-extensions/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/packages/js-extensions/dist/esm/utils/helpers.d.ts

@@ -0,0 +1,5 @@
+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/packages/js-extensions/dist/esm/utils/helpers.js

@@ -0,0 +1,30 @@
+// Shared helper functions for extensions
+export function isValidArrayIndex(index) {
+    return Number.isInteger(index) && index >= 0;
+}
+export function ensurePositiveInteger(value, name) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new TypeError(`${name} must be a positive integer`);
+    }
+}
+export function safeClone(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    if (obj instanceof Date)
+        return new Date(obj.getTime());
+    if (Array.isArray(obj))
+        return obj.map((item) => safeClone(item));
+    const cloned = {};
+    for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+            cloned[key] = safeClone(obj[key]);
+        }
+    }
+    return cloned;
+}
+export function getPathSegments(path) {
+    return path.split('.').filter((segment) => segment.length > 0);
+}
+export function hasOwnProperty(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}

package/packages/js-extensions/dist/esm/utils/index.d.ts

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

package/packages/js-extensions/dist/esm/utils/index.js

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

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

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

package/packages/js-extensions/dist/types/array/index.d.ts

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

package/packages/js-extensions/dist/types/core/index.d.ts

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

package/packages/js-extensions/dist/types/core/performance.d.ts

@@ -0,0 +1,17 @@
+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/packages/js-extensions/dist/types/core/validation.d.ts

@@ -0,0 +1,4 @@
+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/packages/js-extensions/dist/types/core/version.d.ts

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

package/packages/js-extensions/dist/types/extensions/index.d.ts

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

package/packages/js-extensions/dist/types/index.d.ts

@@ -0,0 +1,61 @@
+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/packages/js-extensions/dist/types/init/index.d.ts

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

package/packages/js-extensions/dist/types/init/initializer.d.ts

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

package/packages/js-extensions/dist/types/init/options.d.ts

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

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

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

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

package/packages/js-extensions/dist/types/object/index.d.ts

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

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

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

package/packages/js-extensions/dist/types/string/index.d.ts

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

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

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

package/packages/js-extensions/dist/types/types/extension-types.d.ts

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

package/packages/js-extensions/dist/types/types/global-augmentations.d.ts

@@ -0,0 +1,72 @@
+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/packages/js-extensions/dist/types/types/index.d.ts

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

package/packages/js-extensions/dist/types/utils/config.d.ts

@@ -0,0 +1,4 @@
+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/packages/js-extensions/dist/types/utils/defineExtension.d.ts

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

package/packages/js-extensions/dist/types/utils/helpers.d.ts

@@ -0,0 +1,5 @@
+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/packages/js-extensions/dist/types/utils/index.d.ts

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

package/packages/js-extensions/node_modules/.bin/rimraf

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/esm/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/dist/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules/rimraf/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/rimraf@5.0.10/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+else
+  exec node  "$basedir/../rimraf/dist/esm/bin.mjs" "$@"
+fi

package/packages/js-extensions/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/js-extensions/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/namandev2704/projects/ts-packages/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/js-extensions/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@naman_deep_singh/js-extensions",
+  "version": "1.4.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",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "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",
+    "prepublishOnly": "npm run clean && npm run build",
+    "clean:js": "find src -type f -name \"*.js\" -delete"
+  },
+  "keywords": [
+    "javascript",
+    "utilities",
+    "extensions",
+    "prototype",
+    "string",
+    "array",
+    "object",
+    "universal"
+  ],
+  "author": "Naman Deep Singh",
+  "license": "ISC",
+  "packageManager": "pnpm@10.20.0",
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@types/node": "^25.0.1"
+  }
+}