@d-matrix/utils 1.19.0 → 1.20.0

package/dist/array.d.ts

@@ -0,0 +1,2 @@
+export declare function arrayMoveMutable<T>(array: T[], fromIndex: number, toIndex: number): void;
+export declare function arrayMoveImmutable<T>(array: T[], fromIndex: number, toIndex: number): T[];

package/dist/array.js

@@ -0,0 +1,13 @@
+export function arrayMoveMutable(array, fromIndex, toIndex) {
+    const startIndex = fromIndex < 0 ? array.length + fromIndex : fromIndex;
+    if (startIndex >= 0 && startIndex < array.length) {
+        const endIndex = toIndex < 0 ? array.length + toIndex : toIndex;
+        const [item] = array.splice(fromIndex, 1);
+        array.splice(endIndex, 0, item);
+    }
+}
+export function arrayMoveImmutable(array, fromIndex, toIndex) {
+    const newArray = [...array];
+    arrayMoveMutable(newArray, fromIndex, toIndex);
+    return newArray;
+}

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * as operator from './operator';
 export * as decimal from './decimal';
 export * as object from './object';
 export * as echarts from './echarts';
+export * as array from './array';

package/dist/index.js

@@ -11,3 +11,4 @@ export * as operator from './operator';
 export * as decimal from './decimal';
 export * as object from './object';
 export * as echarts from './echarts';
+export * as array from './array';

package/package.json

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

package/readme.md

@@ -19,6 +19,7 @@ A dozen of utils for Front-End Development
 - [operator](#operator)
 - [decimal](#decimal)
 - [object](#object)
+- [array](#array)
 - [echarts](#echarts)
 
 ### clipboard
@@ -484,6 +485,30 @@ removeZeroValueKeys({ a: '', b: 'abc', c: undefined, d: null, e: NaN, f: -1, g:
 // { b: 'abc', f: -1 }
 ```
 
+## array
+
+- `arrayMoveImmutable<T>(array: T[], fromIndex: number, toIndex: number): T[]`
+
+```js
+import { arrayMoveImmutable } from '@d-matrix/utils';
+
+const input = ['a', 'b', 'c'];
+
+const array1 = arrayMoveImmutable(input, 1, 2);
+console.log(array1);
+//=> ['a', 'c', 'b']
+
+const array2 = arrayMoveImmutable(input, -1, 0);
+console.log(array2);
+//=> ['c', 'a', 'b']
+
+const array3 = arrayMoveImmutable(input, -2, -3);
+console.log(array3);
+//=> ['b', 'a', 'c']
+```
+
+- `arrayMoveMutable<T>(array: T[], fromIndex: number, toIndex: number): void`
+
 ## echarts
 
 - `mergeOption(defaults: EChartsOption, overrides: EChartsOption, option?: deepmerge.Options): EChartsOption`