bunshin-clone 2.0.1 → 2.0.2

package/README.md

@@ -37,7 +37,6 @@ interface BunshinCloneOptions {
   preserveBufferSharing: boolean; // default: false
   preserveDescriptors: boolean;   // default: false
   preserveSymbolKeys: boolean;    // default: false
-  strictDescriptors: boolean;     // default: false
 }
 ```
 
@@ -52,155 +51,3 @@ If `true`, preserves property descriptors, including non-enumerable properties.
 ### `preserveSymbolKeys`
 
 If `true`, preserves symbol keys (slower).
-
-### `strictDescriptors`
-
-If `true`, throws if property descriptor cannot be copied (e.g. non-configurable or non-writable).
-
-## 📖 Details
-
-<details>
-<summary>Read more</summary>
-
-### Example
-
-```ts
-const source = { foo: 1, nested: { x: 1 } };
-
-const result = bunshinClone(source);
-
-console.log(result);
-// { foo: 1, nested: { x: 1 } }
-
-console.log(result === source); // false
-console.log(result.nested === source.nested); // false
-```
-
-### Supported Types
-
-bunshin-clone correctly handles:
-
-- Object (plain + prototype preserved)
-- Array
-- Map
-- Set
-- Date
-- RegExp
-- ArrayBuffer
-- DataView
-- TypedArray (Uint8Array, etc.)
-- DOMException / Error
-- Blob
-- ImageData
-- URL
-- URLSearchParams
-
-### Circular ref
-
-```ts
-const a: any = { x: 1 };
-a.self = a;
-
-const result = bunshinClone(a);
-
-result.self === result; // true
-```
-
-### Descriptor Behavior
-
-#### Default (fast path)
-
-```ts
-const source = {
-  get x() {
-    return 42;
-  },
-};
-
-const result = bunshinClone(source);
-
-result.x; // 42
-// getter is NOT preserved
-```
-
-#### preserveDescriptors: true
-
-```ts
-const source = {};
-Object.defineProperty(source, 'x', {
-  get: () => 42,
-  enumerable: true,
-});
-
-const result = bunshinClone(source, {
-  preserveDescriptors: true,
-});
-
-Object.getOwnPropertyDescriptor(result, 'x')?.get;
-// => preserved
-```
-
-#### Unsupported / Pass-through Types
-
-Some values are returned as-is:
-
-- Function
-- WeakMap / WeakSet
-- Proxy (not cloned)
-- Other non-cloneable host objects
-
-```ts
-const fn = () => {};
-
-bunshinClone(fn) === fn; // true
-```
-
-### Design Notes
-
-#### Deep clone (no structural sharing)
-
-Unlike merge utilities, bunshin-clone always produces a new structure:
-
-```ts
-const source = { a: { b: 1 } };
-
-const result = bunshinClone(source);
-
-result !== source; // true
-result.a !== source.a; // true
-```
-
-#### Getter / Setter behavior
-
-- Default: evaluated and converted to value
-- preserveDescriptors: preserved as-is
-
-#### Descriptor safety
-
-When `preserveDescriptors` is enabled:
-
-- descriptors are cloned safely
-- original object is never mutated
-- errors are controlled via `strictDescriptors`
-
-### Performance
-
-- No proxy / no diffing
-- Minimal branching
-- Fast path for plain objects and arrays
-- Competitive with structuredClone in many cases
-
-### Comparison
-
-| Feature             | Bunshin Clone | structuredClone | lodash.clonedeep |
-| ------------------- | ------------- | --------------- | ---------------- |
-| Circular refs       | ✅            | ✅              | ✅               |
-| Map / Set           | ✅            | ✅              | ⚠️ (partial)     |
-| TypedArray          | ✅            | ✅              | ⚠️ (shallow)     |
-| Descriptor support  | ✅            | ❌              | ❌               |
-| Functions           | pass-through  | ❌ (throws)     | pass-through     |
-| Prototype preserved | ✅            | ❌              | ⚠️               |
-| Custom control      | ✅            | ❌              | ❌               |
-| Performance         | ⚡ fast       | ⚡ fast         | 🐢 slower        |
-
-</details>

package/dist/index.bundle.cjs

@@ -253,13 +253,7 @@ function cloneWithDescriptors(object, settings, refs) {
     if ("value" in desc) {
       desc.value = clone(desc.value, settings, refs);
     }
-    try {
-      Object.defineProperty(result, key, desc);
-    } catch (error) {
-      if (settings.strictDescriptors) {
-        throw error;
-      }
-    }
+    Object.defineProperty(result, key, desc);
   }
   for (const key of OWN_STRING_KEYS(object)) {
     copy(key);
@@ -337,13 +331,8 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = 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;
@@ -352,15 +341,14 @@ function resolveOptions(options) {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
   }
-  if (typeof strictDescriptors !== "boolean") {
-    console.warn("Invalid strictDescriptors option. Fallback: false.");
-    strictDescriptors = false;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
   }
   return {
     preserveBufferSharing,
     preserveDescriptors,
-    preserveSymbolKeys,
-    strictDescriptors
+    preserveSymbolKeys
   };
 }
 

package/dist/index.bundle.js

@@ -251,13 +251,7 @@ function cloneWithDescriptors(object, settings, refs) {
     if ("value" in desc) {
       desc.value = clone(desc.value, settings, refs);
     }
-    try {
-      Object.defineProperty(result, key, desc);
-    } catch (error) {
-      if (settings.strictDescriptors) {
-        throw error;
-      }
-    }
+    Object.defineProperty(result, key, desc);
   }
   for (const key of OWN_STRING_KEYS(object)) {
     copy(key);
@@ -335,13 +329,8 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = 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;
@@ -350,15 +339,14 @@ function resolveOptions(options) {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
   }
-  if (typeof strictDescriptors !== "boolean") {
-    console.warn("Invalid strictDescriptors option. Fallback: false.");
-    strictDescriptors = false;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
   }
   return {
     preserveBufferSharing,
     preserveDescriptors,
-    preserveSymbolKeys,
-    strictDescriptors
+    preserveSymbolKeys
   };
 }
 

package/dist/index.cjs

@@ -219,13 +219,7 @@ function cloneWithDescriptors(object, settings, refs) {
     if ("value" in desc) {
       desc.value = clone(desc.value, settings, refs);
     }
-    try {
-      Object.defineProperty(result, key, desc);
-    } catch (error) {
-      if (settings.strictDescriptors) {
-        throw error;
-      }
-    }
+    Object.defineProperty(result, key, desc);
   }
   for (const key of own.OWN_STRING_KEYS(object)) {
     copy(key);
@@ -303,13 +297,8 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = 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;
@@ -318,15 +307,14 @@ function resolveOptions(options) {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
   }
-  if (typeof strictDescriptors !== "boolean") {
-    console.warn("Invalid strictDescriptors option. Fallback: false.");
-    strictDescriptors = false;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
   }
   return {
     preserveBufferSharing,
     preserveDescriptors,
-    preserveSymbolKeys,
-    strictDescriptors
+    preserveSymbolKeys
   };
 }
 

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -217,13 +217,7 @@ function cloneWithDescriptors(object, settings, refs) {
     if ("value" in desc) {
       desc.value = clone(desc.value, settings, refs);
     }
-    try {
-      Object.defineProperty(result, key, desc);
-    } catch (error) {
-      if (settings.strictDescriptors) {
-        throw error;
-      }
-    }
+    Object.defineProperty(result, key, desc);
   }
   for (const key of OWN_STRING_KEYS(object)) {
     copy(key);
@@ -301,13 +295,8 @@ function resolveOptions(options) {
   let {
     preserveBufferSharing = false,
     preserveDescriptors = 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;
@@ -316,15 +305,14 @@ function resolveOptions(options) {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
   }
-  if (typeof strictDescriptors !== "boolean") {
-    console.warn("Invalid strictDescriptors option. Fallback: false.");
-    strictDescriptors = false;
+  if (typeof preserveSymbolKeys !== "boolean") {
+    console.warn("Invalid preserveSymbolKeys option. Fallback: false.");
+    preserveSymbolKeys = false;
   }
   return {
     preserveBufferSharing,
     preserveDescriptors,
-    preserveSymbolKeys,
-    strictDescriptors
+    preserveSymbolKeys
   };
 }
 

package/package.json

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