bunshin-clone 1.4.3 → 1.5.0

package/README.md

@@ -34,11 +34,16 @@ bunshinClone(source, options);
 
 ```ts
 interface BunshinCloneOptions {
-  preserveDescriptors: boolean; // default: false
-  strictDescriptors: boolean;   // default: false
+  preserveBufferSharing: boolean; // default: false
+  preserveDescriptors: boolean;   // default: false
+  strictDescriptors: boolean;     // default: false
 }
 ```
 
+### `preserveBufferSharing`
+
+If `true`, preserves shared backing buffers between TypedArray and DataView instances.
+
 ### `preserveDescriptors`
 
 If `true`, preserves property descriptors (getters/setters, etc.).

package/dist/index.cjs

@@ -4,9 +4,9 @@
 var EMPTY_OPTIONS = {};
 var { hasOwnProperty: HAS_OWN } = Object.prototype;
 function bunshinClone(source, options = EMPTY_OPTIONS, refs = /* @__PURE__ */ new WeakMap()) {
-  return clone(source, options, refs);
+  return clone(source, resolveOptions(options), refs);
 }
-function clone(source, options, refs) {
+function clone(source, settings, refs) {
   if (!isObject(source)) {
     return source;
   }
@@ -14,7 +14,6 @@ function clone(source, options, refs) {
   if (ref !== void 0) {
     return ref;
   }
-  const settings = resolveOptions(options);
   if (settings.preserveDescriptors && isPlainObject(source)) {
     return cloneWithDescriptors(source, settings, refs);
   }
@@ -69,14 +68,26 @@ function clone(source, options, refs) {
     return result;
   }
   if (ArrayBuffer.isView(source)) {
-    const { buffer, byteOffset, byteLength } = source;
     if (source instanceof DataView) {
-      const result2 = new DataView(buffer.slice(0), byteOffset, byteLength);
+      const { buffer: buffer2, byteOffset: byteOffset2, byteLength } = source;
+      const result2 = new DataView(
+        cloneBuffer(buffer2, refs),
+        byteOffset2,
+        byteLength
+      );
       refs.set(source, result2);
       return result2;
     }
-    const Ctor = source.constructor;
-    const result = new Ctor(buffer.slice(byteOffset, byteOffset + byteLength));
+    const view = source;
+    if (!settings.preserveBufferSharing) {
+      const Ctor2 = view.constructor;
+      const result2 = new Ctor2(view);
+      refs.set(source, result2);
+      return result2;
+    }
+    const Ctor = view.constructor;
+    const { buffer, byteOffset, length } = view;
+    const result = new Ctor(cloneBuffer(buffer, refs), byteOffset, length);
     refs.set(source, result);
     return result;
   }
@@ -112,6 +123,15 @@ function clone(source, options, refs) {
   refs.set(source, source);
   return source;
 }
+function cloneBuffer(buffer, refs) {
+  const ref = refs.get(buffer);
+  if (ref !== void 0) {
+    return ref;
+  }
+  const result = buffer.slice(0);
+  refs.set(buffer, result);
+  return result;
+}
 function cloneError(source, settings, refs) {
   const result = createErrorInstance(source, settings, refs);
   refs.set(source, result);
@@ -204,7 +224,15 @@ function isUnsafeKey(key) {
   return typeof key === "string" && (key === "__proto__" || key === "prototype" || key === "constructor");
 }
 function resolveOptions(options) {
-  let { preserveDescriptors = false, strictDescriptors = false } = options;
+  let {
+    preserveBufferSharing = false,
+    preserveDescriptors = false,
+    strictDescriptors = false
+  } = options;
+  if (typeof preserveBufferSharing !== "boolean") {
+    console.warn("Invalid preserveBufferSharing option. Fallback: false.");
+    preserveBufferSharing = false;
+  }
   if (typeof preserveDescriptors !== "boolean") {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
@@ -213,7 +241,7 @@ function resolveOptions(options) {
     console.warn("Invalid strictDescriptors option. Fallback: false.");
     strictDescriptors = false;
   }
-  return { preserveDescriptors, strictDescriptors };
+  return { preserveBufferSharing, preserveDescriptors, strictDescriptors };
 }
 
 exports.bunshinClone = bunshinClone;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 interface BunshinCloneOptions {
+    preserveBufferSharing: boolean;
     preserveDescriptors: boolean;
     strictDescriptors: boolean;
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 interface BunshinCloneOptions {
+    preserveBufferSharing: boolean;
     preserveDescriptors: boolean;
     strictDescriptors: boolean;
 }

package/dist/index.js

@@ -2,9 +2,9 @@
 var EMPTY_OPTIONS = {};
 var { hasOwnProperty: HAS_OWN } = Object.prototype;
 function bunshinClone(source, options = EMPTY_OPTIONS, refs = /* @__PURE__ */ new WeakMap()) {
-  return clone(source, options, refs);
+  return clone(source, resolveOptions(options), refs);
 }
-function clone(source, options, refs) {
+function clone(source, settings, refs) {
   if (!isObject(source)) {
     return source;
   }
@@ -12,7 +12,6 @@ function clone(source, options, refs) {
   if (ref !== void 0) {
     return ref;
   }
-  const settings = resolveOptions(options);
   if (settings.preserveDescriptors && isPlainObject(source)) {
     return cloneWithDescriptors(source, settings, refs);
   }
@@ -67,14 +66,26 @@ function clone(source, options, refs) {
     return result;
   }
   if (ArrayBuffer.isView(source)) {
-    const { buffer, byteOffset, byteLength } = source;
     if (source instanceof DataView) {
-      const result2 = new DataView(buffer.slice(0), byteOffset, byteLength);
+      const { buffer: buffer2, byteOffset: byteOffset2, byteLength } = source;
+      const result2 = new DataView(
+        cloneBuffer(buffer2, refs),
+        byteOffset2,
+        byteLength
+      );
       refs.set(source, result2);
       return result2;
     }
-    const Ctor = source.constructor;
-    const result = new Ctor(buffer.slice(byteOffset, byteOffset + byteLength));
+    const view = source;
+    if (!settings.preserveBufferSharing) {
+      const Ctor2 = view.constructor;
+      const result2 = new Ctor2(view);
+      refs.set(source, result2);
+      return result2;
+    }
+    const Ctor = view.constructor;
+    const { buffer, byteOffset, length } = view;
+    const result = new Ctor(cloneBuffer(buffer, refs), byteOffset, length);
     refs.set(source, result);
     return result;
   }
@@ -110,6 +121,15 @@ function clone(source, options, refs) {
   refs.set(source, source);
   return source;
 }
+function cloneBuffer(buffer, refs) {
+  const ref = refs.get(buffer);
+  if (ref !== void 0) {
+    return ref;
+  }
+  const result = buffer.slice(0);
+  refs.set(buffer, result);
+  return result;
+}
 function cloneError(source, settings, refs) {
   const result = createErrorInstance(source, settings, refs);
   refs.set(source, result);
@@ -202,7 +222,15 @@ function isUnsafeKey(key) {
   return typeof key === "string" && (key === "__proto__" || key === "prototype" || key === "constructor");
 }
 function resolveOptions(options) {
-  let { preserveDescriptors = false, strictDescriptors = false } = options;
+  let {
+    preserveBufferSharing = false,
+    preserveDescriptors = false,
+    strictDescriptors = false
+  } = options;
+  if (typeof preserveBufferSharing !== "boolean") {
+    console.warn("Invalid preserveBufferSharing option. Fallback: false.");
+    preserveBufferSharing = false;
+  }
   if (typeof preserveDescriptors !== "boolean") {
     console.warn("Invalid preserveDescriptors option. Fallback: false.");
     preserveDescriptors = false;
@@ -211,7 +239,7 @@ function resolveOptions(options) {
     console.warn("Invalid strictDescriptors option. Fallback: false.");
     strictDescriptors = false;
   }
-  return { preserveDescriptors, strictDescriptors };
+  return { preserveBufferSharing, preserveDescriptors, strictDescriptors };
 }
 
 export { bunshinClone, forEachOwnKey, isObject, isPlainObject, isUnsafeKey };

package/package.json

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