main.ts

import {packageTracer} from '@alwatr/package-tracer';

packageTracer.add(__package_name__, __package_version__);

/**
 * Clone deeply nested objects and arrays.
 *
 * @param obj The object to clone.
 * @returns A clone of the object.
 * @example
 * ```typescript
 * const obj2 = deepClone(obj1);
 * ```
 */
export function deepClone<T>(obj: T): T;

/**
 * Clone deeply nested objects and arrays.
 *
 * if the object is null or undefined, it returns null.
 *
 * @param obj The object to clone.
 * @returns A clone of the object.
 * @example
 * ```typescript
 * const obj2 = deepClone(obj1);
 * ```
 */
export function deepClone<T>(obj: T | null | undefined): T | null;

export function deepClone<T>(obj: T | null | undefined): T | null {
  if (obj == null) return null;
  // I don`t know why structuredClone is slower than stringify! but I think its changes in the future.
  // if (typeof structuredClone === 'function') {
  //   return structuredClone(obj);
  // }
  // else
  return JSON.parse(JSON.stringify(obj));
}