bunshin-clone 1.2.13 → 1.2.15

package/README.md

@@ -13,11 +13,11 @@ npm i bunshin-clone
 import { bunshinClone } from 'bunshin-clone';
 
 // CDNs
-import { bunshinClone } from 'https://esm.sh/bunshin-clone@1.2.13';
+import { bunshinClone } from 'https://esm.sh/bunshin-clone@1.2.15';
 // or
-import { bunshinClone } from 'https://cdn.jsdelivr.net/npm/bunshin-clone@1.2.13/+esm';
+import { bunshinClone } from 'https://cdn.jsdelivr.net/npm/bunshin-clone@1.2.15/+esm';
 // or
-import { bunshinClone } from 'https://esm.unpkg.com/bunshin-clone@1.2.13';
+import { bunshinClone } from 'https://esm.unpkg.com/bunshin-clone@1.2.15';
 ```
 
 ## 📦 APIs
@@ -79,7 +79,7 @@ bunshin-clone correctly handles:
 - ArrayBuffer
 - DataView
 - TypedArray (Uint8Array, etc.)
-- Error / DOMException
+- DOMException / Error
 - Blob
 - ImageData
 - URL

package/dist/index.cjs

@@ -14,14 +14,15 @@ function clone(node, options, refs) {
   if (ref !== void 0) {
     return ref;
   }
-  if (options.preserveDescriptors && isPlainObject(node)) {
-    return cloneWithDescriptors(node, options, refs);
+  const settings = resolveOptions(options);
+  if (settings.preserveDescriptors && isPlainObject(node)) {
+    return cloneWithDescriptors(node, settings, refs);
   }
   if (Array.isArray(node)) {
     const result = [];
     refs.set(node, result);
     for (let i = 0, l = node.length; i < l; i++) {
-      result[i] = clone(node[i], options, refs);
+      result[i] = clone(node[i], settings, refs);
     }
     return result;
   }
@@ -32,7 +33,7 @@ function clone(node, options, refs) {
       if (!HAS_OWN.call(node, key) || isUnsafeKey(key)) {
         continue;
       }
-      result[key] = clone(node[key], options, refs);
+      result[key] = clone(node[key], settings, refs);
     }
     return result;
   }
@@ -40,7 +41,7 @@ function clone(node, options, refs) {
     const result = /* @__PURE__ */ new Map();
     refs.set(node, result);
     for (const [key, value] of node) {
-      result.set(clone(key, options, refs), clone(value, options, refs));
+      result.set(clone(key, settings, refs), clone(value, settings, refs));
     }
     return result;
   }
@@ -48,7 +49,7 @@ function clone(node, options, refs) {
     const result = /* @__PURE__ */ new Set();
     refs.set(node, result);
     for (const item of node) {
-      result.add(clone(item, options, refs));
+      result.add(clone(item, settings, refs));
     }
     return result;
   }
@@ -81,7 +82,7 @@ function clone(node, options, refs) {
     return result;
   }
   if (node instanceof DOMException || node instanceof Error) {
-    return cloneError(node, options, refs);
+    return cloneError(node, settings, refs);
   }
   if (node instanceof Blob) {
     const result = node.slice(0, node.size, node.type);
@@ -112,7 +113,7 @@ function clone(node, options, refs) {
   refs.set(node, node);
   return node;
 }
-function cloneError(value, options, refs) {
+function cloneError(value, settings, refs) {
   const { name, message, cause, stack } = value;
   if (value instanceof DOMException) {
     const result2 = new DOMException(message, name);
@@ -151,14 +152,14 @@ function cloneError(value, options, refs) {
     }
   }
   if ("cause" in value && cause !== void 0) {
-    result.cause = clone(cause, options, refs);
+    result.cause = clone(cause, settings, refs);
   }
   for (const key of Object.keys(value)) {
-    Reflect.set(result, key, clone(Reflect.get(value, key), options, refs));
+    Reflect.set(result, key, clone(Reflect.get(value, key), settings, refs));
   }
   return result;
 }
-function cloneWithDescriptors(node, options, refs) {
+function cloneWithDescriptors(node, settings, refs) {
   const result = Object.create(Object.getPrototypeOf(node));
   refs.set(node, result);
   const descs = Object.getOwnPropertyDescriptors(node);
@@ -168,12 +169,12 @@ function cloneWithDescriptors(node, options, refs) {
     }
     const desc = { ...descs[key] };
     if ("value" in desc) {
-      desc.value = clone(desc.value, options, refs);
+      desc.value = clone(desc.value, settings, refs);
     }
     try {
       Object.defineProperty(result, key, desc);
     } catch (error) {
-      if (options.strictDescriptors) {
+      if (settings.strictDescriptors) {
         throw error;
       }
     }
@@ -201,12 +202,24 @@ function isPlainObject(value) {
 function isUnsafeKey(key) {
   return typeof key === "string" && (key === "__proto__" || key === "prototype" || key === "constructor");
 }
+function resolveOptions(options) {
+  let { preserveDescriptors = false, strictDescriptors = false } = options;
+  if (typeof preserveDescriptors !== "boolean") {
+    console.warn("Invalid preserveDescriptors option. Fallback: false.");
+    preserveDescriptors = false;
+  }
+  if (typeof strictDescriptors !== "boolean") {
+    console.warn("Invalid strictDescriptors option. Fallback: false.");
+    strictDescriptors = false;
+  }
+  return { preserveDescriptors, strictDescriptors };
+}
 /**
  * Bunshin Clone
  * High-performance deep clone utility with descriptor support.
  * Handles circular ref and complex built-in types.
  *
- * @version 1.2.13
+ * @version 1.2.15
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.cts

@@ -3,7 +3,7 @@
  * High-performance deep clone utility with descriptor support.
  * Handles circular ref and complex built-in types.
  *
- * @version 1.2.13
+ * @version 1.2.15
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * High-performance deep clone utility with descriptor support.
  * Handles circular ref and complex built-in types.
  *
- * @version 1.2.13
+ * @version 1.2.15
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/dist/index.js

@@ -12,14 +12,15 @@ function clone(node, options, refs) {
   if (ref !== void 0) {
     return ref;
   }
-  if (options.preserveDescriptors && isPlainObject(node)) {
-    return cloneWithDescriptors(node, options, refs);
+  const settings = resolveOptions(options);
+  if (settings.preserveDescriptors && isPlainObject(node)) {
+    return cloneWithDescriptors(node, settings, refs);
   }
   if (Array.isArray(node)) {
     const result = [];
     refs.set(node, result);
     for (let i = 0, l = node.length; i < l; i++) {
-      result[i] = clone(node[i], options, refs);
+      result[i] = clone(node[i], settings, refs);
     }
     return result;
   }
@@ -30,7 +31,7 @@ function clone(node, options, refs) {
       if (!HAS_OWN.call(node, key) || isUnsafeKey(key)) {
         continue;
       }
-      result[key] = clone(node[key], options, refs);
+      result[key] = clone(node[key], settings, refs);
     }
     return result;
   }
@@ -38,7 +39,7 @@ function clone(node, options, refs) {
     const result = /* @__PURE__ */ new Map();
     refs.set(node, result);
     for (const [key, value] of node) {
-      result.set(clone(key, options, refs), clone(value, options, refs));
+      result.set(clone(key, settings, refs), clone(value, settings, refs));
     }
     return result;
   }
@@ -46,7 +47,7 @@ function clone(node, options, refs) {
     const result = /* @__PURE__ */ new Set();
     refs.set(node, result);
     for (const item of node) {
-      result.add(clone(item, options, refs));
+      result.add(clone(item, settings, refs));
     }
     return result;
   }
@@ -79,7 +80,7 @@ function clone(node, options, refs) {
     return result;
   }
   if (node instanceof DOMException || node instanceof Error) {
-    return cloneError(node, options, refs);
+    return cloneError(node, settings, refs);
   }
   if (node instanceof Blob) {
     const result = node.slice(0, node.size, node.type);
@@ -110,7 +111,7 @@ function clone(node, options, refs) {
   refs.set(node, node);
   return node;
 }
-function cloneError(value, options, refs) {
+function cloneError(value, settings, refs) {
   const { name, message, cause, stack } = value;
   if (value instanceof DOMException) {
     const result2 = new DOMException(message, name);
@@ -149,14 +150,14 @@ function cloneError(value, options, refs) {
     }
   }
   if ("cause" in value && cause !== void 0) {
-    result.cause = clone(cause, options, refs);
+    result.cause = clone(cause, settings, refs);
   }
   for (const key of Object.keys(value)) {
-    Reflect.set(result, key, clone(Reflect.get(value, key), options, refs));
+    Reflect.set(result, key, clone(Reflect.get(value, key), settings, refs));
   }
   return result;
 }
-function cloneWithDescriptors(node, options, refs) {
+function cloneWithDescriptors(node, settings, refs) {
   const result = Object.create(Object.getPrototypeOf(node));
   refs.set(node, result);
   const descs = Object.getOwnPropertyDescriptors(node);
@@ -166,12 +167,12 @@ function cloneWithDescriptors(node, options, refs) {
     }
     const desc = { ...descs[key] };
     if ("value" in desc) {
-      desc.value = clone(desc.value, options, refs);
+      desc.value = clone(desc.value, settings, refs);
     }
     try {
       Object.defineProperty(result, key, desc);
     } catch (error) {
-      if (options.strictDescriptors) {
+      if (settings.strictDescriptors) {
         throw error;
       }
     }
@@ -199,12 +200,24 @@ function isPlainObject(value) {
 function isUnsafeKey(key) {
   return typeof key === "string" && (key === "__proto__" || key === "prototype" || key === "constructor");
 }
+function resolveOptions(options) {
+  let { preserveDescriptors = false, strictDescriptors = false } = options;
+  if (typeof preserveDescriptors !== "boolean") {
+    console.warn("Invalid preserveDescriptors option. Fallback: false.");
+    preserveDescriptors = false;
+  }
+  if (typeof strictDescriptors !== "boolean") {
+    console.warn("Invalid strictDescriptors option. Fallback: false.");
+    strictDescriptors = false;
+  }
+  return { preserveDescriptors, strictDescriptors };
+}
 /**
  * Bunshin Clone
  * High-performance deep clone utility with descriptor support.
  * Handles circular ref and complex built-in types.
  *
- * @version 1.2.13
+ * @version 1.2.15
  * @author Yusuke Kamiyamane
  * @license MIT
  * @copyright Copyright (c) Yusuke Kamiyamane

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunshin-clone",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "description": "High-performance deep clone utility with descriptor support",
   "keywords": [
     "array",