bunshin-clone 1.7.2 → 1.8.0

package/README.md

@@ -36,6 +36,7 @@ bunshinClone<T>(value, options);
 interface BunshinCloneOptions {
   preserveBufferSharing: boolean; // default: false
   preserveDescriptors: boolean;   // default: false
+  preserveSymbolKeys: boolean;    // default: false
   strictDescriptors: boolean;     // default: false
 }
 ```
@@ -48,9 +49,13 @@ If `true`, preserves shared backing buffers between TypedArray and DataView inst
 
 If `true`, preserves property descriptors (getters/setters, etc.).
 
+### `preserveSymbolKeys`
+
+If `true`, preserves symbol keys (slower).
+
 ### `strictDescriptors`
 
-If `true`, throws if descriptor cannot be merged (e.g. non-configurable or non-writable)
+If `true`, throws if descriptor cannot be merged (e.g. non-configurable or non-writable).
 
 ## 📖 Details
 

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 // src/index.ts
 var EMPTY_OPTIONS = {};
-var { propertyIsEnumerable: IS_ENUMERABLE } = Object.prototype;
+var { hasOwnProperty: HAS_OWN, propertyIsEnumerable: IS_ENUMERABLE } = Object.prototype;
 function bunshinClone(value, options = EMPTY_OPTIONS, refs = /* @__PURE__ */ new WeakMap()) {
   return clone(value, resolveOptions(options), refs);
 }
@@ -34,11 +34,20 @@ function clone(value, settings, refs) {
   if (isPlainObject(value)) {
     const result = Object.create(Object.getPrototypeOf(value));
     refs.set(value, result);
-    for (const key of Reflect.ownKeys(value)) {
-      if (isUnsafeKey(key) || !IS_ENUMERABLE.call(value, key)) {
-        continue;
+    if (!settings.preserveSymbolKeys) {
+      for (const key in value) {
+        if (isUnsafeKey(key) || !HAS_OWN.call(value, key)) {
+          continue;
+        }
+        result[key] = clone(value[key], settings, refs);
+      }
+    } else {
+      for (const key of Reflect.ownKeys(value)) {
+        if (isUnsafeKey(key) || !IS_ENUMERABLE.call(value, key)) {
+          continue;
+        }
+        result[key] = clone(value[key], settings, refs);
       }
-      result[key] = clone(value[key], settings, refs);
     }
     return result;
   }
@@ -242,8 +251,13 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = false,
-    strictDescriptors = false
+    strictDescriptors = false,
+    preserveSymbolKeys = false
   } = options;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
+  }
   if (typeof preserveBufferSharing !== "boolean") {
     console.warn("Invalid preserveBufferSharing option. Fallback: false.");
     preserveBufferSharing = false;
@@ -256,7 +270,12 @@ function resolveOptions(options) {
     console.warn("Invalid strictDescriptors option. Fallback: false.");
     strictDescriptors = false;
   }
-  return { preserveBufferSharing, preserveDescriptors, strictDescriptors };
+  return {
+    preserveBufferSharing,
+    preserveDescriptors,
+    preserveSymbolKeys,
+    strictDescriptors
+  };
 }
 
 exports.bunshinClone = bunshinClone;

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 interface BunshinCloneOptions {
     preserveBufferSharing: boolean;
     preserveDescriptors: boolean;
+    preserveSymbolKeys: boolean;
     strictDescriptors: boolean;
 }
 type PlainObject = Record<PropertyKey, unknown>;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 interface BunshinCloneOptions {
     preserveBufferSharing: boolean;
     preserveDescriptors: boolean;
+    preserveSymbolKeys: boolean;
     strictDescriptors: boolean;
 }
 type PlainObject = Record<PropertyKey, unknown>;

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 var EMPTY_OPTIONS = {};
-var { propertyIsEnumerable: IS_ENUMERABLE } = Object.prototype;
+var { hasOwnProperty: HAS_OWN, propertyIsEnumerable: IS_ENUMERABLE } = Object.prototype;
 function bunshinClone(value, options = EMPTY_OPTIONS, refs = /* @__PURE__ */ new WeakMap()) {
   return clone(value, resolveOptions(options), refs);
 }
@@ -32,11 +32,20 @@ function clone(value, settings, refs) {
   if (isPlainObject(value)) {
     const result = Object.create(Object.getPrototypeOf(value));
     refs.set(value, result);
-    for (const key of Reflect.ownKeys(value)) {
-      if (isUnsafeKey(key) || !IS_ENUMERABLE.call(value, key)) {
-        continue;
+    if (!settings.preserveSymbolKeys) {
+      for (const key in value) {
+        if (isUnsafeKey(key) || !HAS_OWN.call(value, key)) {
+          continue;
+        }
+        result[key] = clone(value[key], settings, refs);
+      }
+    } else {
+      for (const key of Reflect.ownKeys(value)) {
+        if (isUnsafeKey(key) || !IS_ENUMERABLE.call(value, key)) {
+          continue;
+        }
+        result[key] = clone(value[key], settings, refs);
       }
-      result[key] = clone(value[key], settings, refs);
     }
     return result;
   }
@@ -240,8 +249,13 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = false,
-    strictDescriptors = false
+    strictDescriptors = false,
+    preserveSymbolKeys = false
   } = options;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
+  }
   if (typeof preserveBufferSharing !== "boolean") {
     console.warn("Invalid preserveBufferSharing option. Fallback: false.");
     preserveBufferSharing = false;
@@ -254,7 +268,12 @@ function resolveOptions(options) {
     console.warn("Invalid strictDescriptors option. Fallback: false.");
     strictDescriptors = false;
   }
-  return { preserveBufferSharing, preserveDescriptors, strictDescriptors };
+  return {
+    preserveBufferSharing,
+    preserveDescriptors,
+    preserveSymbolKeys,
+    strictDescriptors
+  };
 }
 
 export { bunshinClone, forEachOwnKey, isObject, isPlainObject, isShallowArray, isUnsafeKey };

package/package.json

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