@monstermann/fn/dist/object/assign.js

A utility library for TypeScript.

import { merge } from "./merge.js";
import { dfdlT } from "@monstermann/dfdl";

//#region src/object/assign.ts
/**
* `assign(target, source)`
*
* Merges properties from `source` object into `target` object, creating a new object.
*
* Looser version of `merge` - `assign` allows you to redefine keys and add new properties.
*
* ```ts
* assign({ a: 1, b: 2 }, { b: 3, c: 4 }); // { a: 1, b: 3, c: 4 }
* ```
*
* ```ts
* pipe({ a: 1, b: 2 }, assign({ b: 3, c: 4 })); // { a: 1, b: 3, c: 4 }
* ```
*/
const assign = dfdlT((target, source) => {
	return merge(target, source);
}, 2);

//#endregion
export { assign };