sm-utility 2.3.6 → 2.3.7

package/general/index.d.ts

@@ -3,3 +3,37 @@ export declare function randomSixDigitNumber(): number;
 export declare function timeout(ms: number): Promise<any>;
 export declare function mergeDeep(target: Record<string, any>, source: Record<string, any>): Record<string, any>;
 export declare function shortUniqueId(): string;
+/**
+ * Creates a deep copy of any JavaScript value, handling nested objects and various built-in types.
+ *
+ * @template T - The type of the value being cloned
+ * @param {T} obj - The value to clone
+ * @returns {T} A deep copy of the input value
+ *
+ * @description
+ * Supports deep cloning of:
+ * - Primitive values (numbers, strings, booleans)
+ * - Plain objects
+ * - Arrays
+ * - Dates
+ * - Sets
+ * - Maps
+ *
+ * @example
+ * // Clone a simple object
+ * const original = { a: 1, b: { c: 2 } };
+ * const clone = copy(original);
+ *
+ * // Clone an array with nested objects
+ * const arr = [{ x: 1 }, { y: 2 }];
+ * const clonedArr = copy(arr);
+ *
+ * // Clone complex structures
+ * const complex = {
+ *   date: new Date(),
+ *   set: new Set([1, 2, 3]),
+ *   map: new Map([['key', 'value']])
+ * };
+ * const clonedComplex = copy(complex);
+ */
+export declare function copy<T>(obj: T): T;

package/general/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shortUniqueId = exports.mergeDeep = exports.timeout = exports.randomSixDigitNumber = exports.pipe = void 0;
+exports.copy = exports.shortUniqueId = exports.mergeDeep = exports.timeout = exports.randomSixDigitNumber = exports.pipe = void 0;
 const nanoid_1 = require("nanoid");
 function pipe(...fns) {
     return (x) => fns.reduce((v, f) => f(v), x);
@@ -43,3 +43,62 @@ function shortUniqueId() {
     return nanoid();
 }
 exports.shortUniqueId = shortUniqueId;
+/**
+ * Creates a deep copy of any JavaScript value, handling nested objects and various built-in types.
+ *
+ * @template T - The type of the value being cloned
+ * @param {T} obj - The value to clone
+ * @returns {T} A deep copy of the input value
+ *
+ * @description
+ * Supports deep cloning of:
+ * - Primitive values (numbers, strings, booleans)
+ * - Plain objects
+ * - Arrays
+ * - Dates
+ * - Sets
+ * - Maps
+ *
+ * @example
+ * // Clone a simple object
+ * const original = { a: 1, b: { c: 2 } };
+ * const clone = copy(original);
+ *
+ * // Clone an array with nested objects
+ * const arr = [{ x: 1 }, { y: 2 }];
+ * const clonedArr = copy(arr);
+ *
+ * // Clone complex structures
+ * const complex = {
+ *   date: new Date(),
+ *   set: new Set([1, 2, 3]),
+ *   map: new Map([['key', 'value']])
+ * };
+ * const clonedComplex = copy(complex);
+ */
+function copy(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => copy(item));
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof Set) {
+        return new Set(Array.from(obj).map((item) => copy(item)));
+    }
+    if (obj instanceof Map) {
+        return new Map(Array.from(obj.entries()).map(([key, value]) => [
+            copy(key),
+            copy(value),
+        ]));
+    }
+    const clone = {};
+    Object.keys(obj).forEach((key) => {
+        clone[key] = copy(obj[key]);
+    });
+    return clone;
+}
+exports.copy = copy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sm-utility",
-  "version": "2.3.6",
+  "version": "2.3.7",
   "description": "reusable utility codes for sm projects",
   "main": "index.js",
   "types": "./index.d.ts",