to-assigned 1.0.1 → 1.1.1

package/README.md

@@ -1,19 +1,19 @@
 # to-assigned
 
-Create a new object, array, or function by copying enumerable properties from one or more source objects, with prototype and type inheritance from the first source. More flexible than `Object.assign`, supporting arrays, functions, and special objects as the first source.
+Create a new object, array, function, or special object by copying enumerable properties from one or more source objects. The prototype and type of the result are determined by the first non-primitive source (see below). More flexible than `Object.assign`, supporting arrays, functions, and special objects as the first source.
 
 ## Features
 
-- The returned value's prototype will be the same as the first source (if it's an object), or `null` if the first source is a primitive.
-- If the first source is:
-  - **Array**: result is an array, sharing the same prototype.
-  - **Function**: result is a function with the same `name`, `length`, and prototype. (But `caller`, `callee`, and `arguments` are not copied.)
-  - **Map/Set/WeakMap/WeakSet/Date**: result is a new instance of the same type, initialized from the first source. (But only own enumerable properties are merged, not collection contents.)
-  - **Other objects**: result is a plain object with the same prototype.
-  - **Non-object**: result is a plain object with `null` prototype.
-- Only enumerable properties are copied (including symbol keys).
 - Does not modify the sources.
 - Ignores all non-object arguments.
+- The result's prototype and type are determined by the first non-primitive source:
+  - If all sources are primitive, returns a plain object with `Object.prototype` as its prototype.
+  - If the first non-primitive source is:
+    - **Array**: result is an array, prototype same as source.
+    - **Function**: result is a function with same `name`, `length`, and prototype. (`caller`, `callee`, `arguments` not copied)
+    - **Map/Set/WeakMap/WeakSet/Date**: result is a new instance of the same type, initialized from the first source (only own enumerable properties are merged, not collection contents).
+    - **Other object**: result is an object with the same prototype as the source.
+- Only enumerable properties (including symbol keys) are copied from all sources. Later sources overwrite earlier ones with the same key.
 
 ## Installation
 
@@ -35,12 +35,14 @@ const proto = { foo: 1 };
 const obj = Object.create(proto);
 obj.bar = 2;
 const result1 = toAssigned(obj, { baz: 3 });
-// result1: { bar: 2, baz: 3 }, result1.__proto__ === proto
+// result1: { bar: 2, baz: 3 }
+// Object.getPrototypeOf(result1) === proto
 
 // Array as first source
 const arr = [1, 2];
 const result2 = toAssigned(arr, { 2: 3, length: 3 });
 // result2: [1, 2, 3]
+// Object.getPrototypeOf(result2) === Object.getPrototypeOf(arr)
 
 // Function as first source
 function fn(a, b) {
@@ -48,16 +50,22 @@ function fn(a, b) {
 }
 fn.extra = 42;
 const result3 = toAssigned(fn, { extra: 99 });
-// typeof result3 === 'function', result3(1,2) === 3, result3.extra === 99
+// typeof result3 === 'function'
+// result3(1,2) === 3
+// result3.extra === 99
+// Object.getPrototypeOf(result3) === Object.getPrototypeOf(fn)
 
 // Map/Set/WeakMap/WeakSet/Date as first source
 const map = new Map([[1, 'a']]);
 const result4 = toAssigned(map, { foo: 'bar' });
-// result4 instanceof Map, result4.get(1) === 'a', result4.foo === 'bar'
+// result4 instanceof Map
+// result4.get(1) === 'a'
+// result4.foo === 'bar'
 
 // Non-object as first source
 const result5 = toAssigned(123, { a: 1 });
-// result5: { a: 1 }, Object.getPrototypeOf(result5) === null
+// result5: { a: 1 }
+// Object.getPrototypeOf(result5) === Object.prototype
 ```
 
 ## API
@@ -65,7 +73,7 @@ const result5 = toAssigned(123, { a: 1 });
 ### `toAssigned(...sources: any[]): any`
 
 - **sources**: Any number of source objects. Non-object arguments are ignored.
-- **Returns**: A new object, array, function, or special object (Map/Set/...) with all enumerable properties from the sources, and prototype/type inherited from the first source.
+- **Returns**: A new object, array, function, or special object (Map/Set/...) with all enumerable properties from the sources, and prototype/type inherited from the first non-primitive source (see above for rules).
 
 ## License
 

package/dist/index.d.ts

@@ -1,17 +1,19 @@
 /**
- * Creates a new object with properties from the provided sources
- * - Basically the same as Object.assign({}, ...sources.filter(isObjectOrFunction))
- * - returned prototype will be **the same as the first source**
- * - if the first source is:
- *   - *non-object*: `result.prototype` will be `null`
- *   - *array*: result will be an array and shares the same prototype
- *   - *function*: result will be a function with the same `name`, `length` and shares the same prototype. But `caller`, `callee`, and `arguments` will not be copied
- *   - *Map/Set/WeakMap/WeakSet/Date*: create a new one with the old
- *   - *other objects*: starts from an empty object
- * - only enumerable properties are copied
- * - will not modify the sources
- * - ignores all non-object arguments
- * @returns a new object with properties from the sources
+ * Creates a new object, array, function, or special object with properties from the provided sources.
+ * Prototype and type are determined by the first non-primitive source (see below):
+ *
+ * - The sources are never modified.
+ * - Non-object arguments are ignored.
+ * - If all sources are primitive, returns `{}`.
+ * - If the first non-primitive source is:
+ *   - **Array**: result is an array, prototype same as source.
+ *   - **Function**: result is a function with same `name`, `length`, and prototype. (`caller`, `callee`, `arguments` not copied)
+ *   - **Map/Set/WeakMap/WeakSet/Date**: result is a new instance of the same type, initialized from the first source (only own enumerable properties are merged, not collection contents).
+ *   - **Other object**: result is a plain object with the same prototype as the source.
+ *
+ * - Only enumerable properties (including symbol keys) are copied from all sources.
+ *
+ * @returns A new object, array, function, or special object with merged properties and inherited prototype/type.
  */
 declare function toAssigned(...sources: any[]): any;
 

package/dist/index.mjs

@@ -1 +1 @@
-const e=Reflect.ownKeys,t=Reflect.setPrototypeOf,n=Reflect.getPrototypeOf,o=Object.prototype.propertyIsEnumerable,c=Array.isArray,f=Reflect.defineProperty;function r(e){const o=null===(r=e)||"object"!=typeof r&&"function"!=typeof r?null:n(e);var r;let a;if(c(e))a=[];else if("function"==typeof e){let t;(e=>{try{return new new Proxy(e,{construct:()=>({})}),!1}catch{return!0}})(e)?t=(...t)=>e(...t):(t=function(...t){return e(...t)},t.bind=function(...t){return e.bind(...t)}),f(t,"name",{value:e.name,configurable:!0}),f(t,"length",{value:e.length,configurable:!0}),a=t}else a=e instanceof Map?new Map(e.entries()):e instanceof Set?new Set(e.values()):e instanceof WeakMap?new WeakMap:e instanceof WeakSet?new WeakSet:e instanceof Date?new Date(e.getTime()):{};return t(a,o),a}function a(...t){if(0===t.length)return{};const n=r(t[0]);for(let c=0;c<t.length;c++){const f=t[c];if(f&&"object"==typeof f)for(const t of e(f))o.call(f,t)&&(n[t]=f[t])}return n}Reflect.set(a,Symbol("version"),"1.0.1");export{a as toAssigned};
+const e=Reflect.ownKeys,t=Reflect.setPrototypeOf,n=Reflect.getPrototypeOf,o=Object.prototype.propertyIsEnumerable,c=Array.isArray,f=Reflect.defineProperty,r=e=>null!==e&&("object"==typeof e||"function"==typeof e);function a(e){const o=e.find(r);if(!o)return{};const a=n(o);let i;if(c(o))i=[];else if("function"==typeof o){let e;(e=>{try{return new new Proxy(e,{construct:()=>({})}),!1}catch{return!0}})(o)?e=(...e)=>o(...e):(e=function(...e){return o(...e)},e.bind=(e,...t)=>o.bind(e,...t)),f(e,"name",{value:o.name,configurable:!0}),f(e,"length",{value:o.length,configurable:!0}),i=e}else i=o instanceof Map?new Map(o.entries()):o instanceof Set?new Set(o.values()):o instanceof WeakMap?new WeakMap:o instanceof WeakSet?new WeakSet:o instanceof Date?new Date(o.getTime()):{};return t(i,a),i}function i(...t){if(0===t.length)return{};const n=a(t);for(let c=0;c<t.length;c++){const f=t[c];if(f&&"object"==typeof f)for(const t of e(f))o.call(f,t)&&(n[t]=f[t])}return n}Reflect.set(i,Symbol("version"),"1.1.1");export{i as toAssigned};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "to-assigned",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "author": {
     "name": "KasukabeTsumugi",
     "email": "futami16237@gmail.com"