@d-matrix/utils 1.20.1 → 1.21.0

package/dist/array.d.ts

@@ -1,2 +1,3 @@
 export declare function moveMutable<T>(array: T[], fromIndex: number, toIndex: number): void;
 export declare function moveImmutable<T>(array: T[], fromIndex: number, toIndex: number): T[];
+export declare function moveToStart<T>(array: T[], predicate: (item: T) => boolean): T[];

package/dist/array.js

@@ -11,3 +11,9 @@ export function moveImmutable(array, fromIndex, toIndex) {
     moveMutable(newArray, fromIndex, toIndex);
     return newArray;
 }
+export function moveToStart(array, predicate) {
+    const newArray = [...array];
+    const index = array.findIndex(predicate);
+    moveMutable(newArray, index, 0);
+    return newArray;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d-matrix/utils",
   "sideEffects": false,
-  "version": "1.20.1",
+  "version": "1.21.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {

package/readme.md

@@ -509,6 +509,19 @@ console.log(array3);
 
 - `moveMutable<T>(array: T[], fromIndex: number, toIndex: number): void`
 
+- `moveToStart<T>(array: T[], predicate: (item: T) => boolean): T[]`
+
+移动元素到数组首位，不会修改原数组
+
+```js
+import { array } from '@d-matrix/utils';
+
+const list = [{ id: 1 }, { id: 2 }, { id: 3 }, { id: 4 }, { id: 5 }];
+const newList = array.moveToStart(list, (item) => item.id === 4);
+
+// [{ id: 4 }, { id: 1 }, { id: 2 }, { id: 3 }, { id: 5 }]
+```
+
 ## echarts
 
 - `mergeOption(defaults: EChartsOption, overrides: EChartsOption, option?: deepmerge.Options): EChartsOption`