@monstermann/fn/dist/array/prepend.js

A utility library for TypeScript.

import { dfdlT } from "@monstermann/dfdl";
import { cloneArray } from "@monstermann/remmi";

//#region src/array/prepend.ts
/**
* `prepend(array, value)`
*
* Adds `value` to the beginning of `array`.
*
* ```ts
* prepend([2, 3, 4], 1); // [1, 2, 3, 4]
* ```
*
* ```ts
* pipe([2, 3, 4], prepend(1)); // [1, 2, 3, 4]
* ```
*/
const prepend = dfdlT((target, value) => {
	const clone = cloneArray(target);
	clone.unshift(value);
	return clone;
}, 2);

//#endregion
export { prepend };