utils-lib-js 2.0.19 → 2.0.20

package/README.en.md

@@ -401,6 +401,33 @@ console.log(demotedArray);
 // Output: reduced array [1, 2, 3, 4, 5]
 ```
 
+##### 4. arrayLoop(list: any[], current? : number): { item: any; current: number }
+
+Walks through the elements in the group and returns the current element and its index.
+
+- 'list' : The array to traverse.
+- 'current' : indicates the index of the current element. The default is 0.
+
+```javascript
+// Each time the arrayLoop function is called, current is incremented by 1 and takes the module length to loop to the beginning of the array.
+const list = [
+  " Element 1",
+  "element 2",
+  " element 3",
+  "element 4",
+  " element 5",
+];
+// Simulation loop multiple times
+let c = 0;
+Array(10)
+  .fill("")
+  .forEach(() => {
+    const { item, current } = arrayLoop(list, c);
+    c = current;
+    console.log(item, c); // 1,2,3,4,0,1,2,3,4,0
+  });
+```
+
 #### function module
 
 ##### 1. `throttle(fn: Function, time: number): Function`

package/README.md

@@ -401,6 +401,27 @@ console.log(demotedArray);
 // 输出: 降维后的数组 [1, 2, 3, 4, 5]
 ```
 
+##### 4. arrayLoop(list: any[], current?: number): { item: any; current: number }
+
+遍历数组中的元素，并返回当前元素及其索引。
+
+- `list`: 要遍历的数组。
+- `current`: 当前元素的索引，默认为 0。
+
+```javascript
+// 每次调用arrayLoop函数时，current将加 1，并取模数组长度，以循环到数组的开始。
+const list = ["元素1", "元素2", "元素3", "元素4", "元素5"];
+// 模拟循环多次
+let c = 0;
+Array(10)
+  .fill("")
+  .forEach(() => {
+    const { item, current } = arrayLoop(list, c);
+    c = current;
+    console.log(item, c); // 1,2,3,4,0,1,2,3,4,0
+  });
+```
+
 #### function 模块
 
 ##### 1. `throttle(fn: Function, time: number): Function`

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "utils-lib-js",
-  "version": "2.0.19",
-  "description": "JavaScript工具函数，封装的一些常用的js函数",
-  "main": "./dist/cjs/index.js",
-  "types": "./dist/cjs/index.d.ts",
-  "module": "./dist/esm/index.js",
-  "type": "module",
-  "exports": {
-    "import": "./dist/esm/index.js",
-    "require": "./dist/cjs/index.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/DieHunter/utils-lib-js.git"
-  },
-  "keywords": [
-    "utils",
-    "tools",
-    "lib"
-  ],
-  "author": "",
-  "license": "ISC",
-  "devDependencies": {
-    "@rollup/plugin-alias": "^4.0.3",
-    "@rollup/plugin-node-resolve": "^15.0.1",
-    "@rollup/plugin-typescript": "^11.0.0",
-    "@types/node": "^18.7.15",
-    "rollup": "^3.20.2",
-    "rollup-plugin-terser": "^7.0.2",
-    "tslib": "^2.5.0",
-    "typescript": "^4.9.0"
-  },
-  "dependencies": {
-    "event-message-center": "^1.4.0",
-    "js-log-lib": "^1.1.2",
-    "js-request-lib": "^1.0.7",
-    "task-queue-lib": "^1.4.2",
-    "timer-manager-lib": "^1.0.0"
-  },
-  "umdModuleName": "UtilsLib",
-  "scripts": {
-    "debug": "start cmd /k pnpm run build:hot & pnpm run node:hot",
-    "node:hot": "nodemon example.js --watch example.js",
-    "build:hot": "pnpm rollup -c --watch",
-    "build": "pnpm run rollup:build && pnpm run commonjs",
-    "rollup:build": "rm -fr dist && pnpm rollup -c",
-    "build:publish": "pnpm run build && pnpm publish",
-    "commonjs": "cp ./commonjs.json dist/cjs/package.json"
-  }
-}
+{
+  "name": "utils-lib-js",
+  "version": "2.0.20",
+  "description": "JavaScript工具函数，封装的一些常用的js函数",
+  "main": "./dist/cjs/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "type": "module",
+  "exports": {
+    "import": "./dist/esm/index.js",
+    "require": "./dist/cjs/index.js"
+  },
+  "scripts": {
+    "debug": "start cmd /k pnpm run build:hot & pnpm run node:hot",
+    "node:hot": "nodemon example.js --watch example.js",
+    "build:hot": "pnpm rollup -c --watch",
+    "build": "pnpm run rollup:build && pnpm run commonjs",
+    "rollup:build": "rm -fr dist && pnpm rollup -c",
+    "build:publish": "pnpm run build && pnpm publish",
+    "commonjs": "cp ./commonjs.json dist/cjs/package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/DieHunter/utils-lib-js.git"
+  },
+  "keywords": [
+    "utils",
+    "tools",
+    "lib"
+  ],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@rollup/plugin-alias": "^4.0.3",
+    "@rollup/plugin-node-resolve": "^15.0.1",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/node": "^18.7.15",
+    "rollup": "^3.20.2",
+    "rollup-plugin-terser": "^7.0.2",
+    "tslib": "^2.5.0",
+    "typescript": "^4.9.0"
+  },
+  "dependencies": {
+    "event-message-center": "^1.4.0",
+    "js-log-lib": "^1.1.2",
+    "js-request-lib": "^1.0.7",
+    "task-queue-lib": "^1.4.2",
+    "timer-manager-lib": "^1.0.0"
+  },
+  "umdModuleName": "UtilsLib"
+}

package/dist/bundle/animate.d.ts

@@ -1,25 +0,0 @@
-import { IAnimateFrame } from "./types";
-export declare class AnimateFrame implements IAnimateFrame {
-    fn: any;
-    id: any;
-    duration: number;
-    isActive: boolean;
-    constructor(fn: any);
-    start(duration: any): any;
-    stop(id?: any): void;
-    animate(timer?: number): any;
-}
-export declare function quadraticBezier(_x: number, _y: number, t: number): number[];
-export declare function cubicBezier(_x1: number, _y1: number, _x2: number, _y2: number, t: number): number[];
-export declare function factorial(n: number): any;
-export declare function combination(n: number, k: number): number;
-export declare function NBezier(points: number[][], t: number): number[];
-declare const _default: {
-    AnimateFrame: typeof AnimateFrame;
-    quadraticBezier: typeof quadraticBezier;
-    cubicBezier: typeof cubicBezier;
-    factorial: typeof factorial;
-    combination: typeof combination;
-    NBezier: typeof NBezier;
-};
-export default _default;

package/dist/bundle/array.d.ts

@@ -1,10 +0,0 @@
-import { IArrayRandom, IArrayUniq, IArrayDemote, IDemoteArray } from "./types";
-export declare const arrayRandom: IArrayRandom<any[]>;
-export declare const arrayUniq: IArrayUniq<any[]>;
-export declare const arrayDemote: IArrayDemote<IDemoteArray<any>>;
-declare const _default: {
-    arrayRandom: IArrayRandom<any[]>;
-    arrayUniq: IArrayUniq<any[]>;
-    arrayDemote: IArrayDemote<IDemoteArray<any>>;
-};
-export default _default;

package/dist/bundle/base.d.ts

@@ -1,17 +0,0 @@
-import { IRandomNum, IUrlSplit, IUrlJoin, IGetType, IGetTypeByList } from "./types";
-import { types } from "./static";
-export declare const randomNum: IRandomNum;
-export declare const urlSplit: IUrlSplit;
-export declare const urlJoin: IUrlJoin;
-export declare const getType: IGetType<types>;
-export declare const getTypeByList: IGetTypeByList;
-export declare const toKebabCase: (camelCase: string, separator?: string) => string;
-declare const _default: {
-    randomNum: IRandomNum;
-    urlSplit: IUrlSplit;
-    urlJoin: IUrlJoin;
-    getType: IGetType<types>;
-    getTypeByList: IGetTypeByList;
-    toKebabCase: (camelCase: string, separator?: string) => string;
-};
-export default _default;

package/dist/bundle/element.d.ts

@@ -1,6 +0,0 @@
-import { ICreateElement } from "./types";
-export declare const createElement: ICreateElement;
-declare const _default: {
-    createElement: ICreateElement<HTMLElement>;
-};
-export default _default;

package/dist/bundle/event.d.ts

@@ -1,14 +0,0 @@
-import { IAddHandler, IStopBubble, IStopDefault, IRemoveHandler, IDispatchEvent } from "./types";
-export declare const addHandler: IAddHandler;
-export declare const stopBubble: IStopBubble;
-export declare const stopDefault: IStopDefault;
-export declare const removeHandler: IRemoveHandler;
-export declare const dispatchEvent: IDispatchEvent;
-declare const _default: {
-    addHandler: IAddHandler;
-    stopBubble: IStopBubble;
-    stopDefault: IStopDefault;
-    removeHandler: IRemoveHandler;
-    dispatchEvent: IDispatchEvent;
-};
-export default _default;

package/dist/bundle/function.d.ts

@@ -1,13 +0,0 @@
-import { ICatchAwait, IThrottle, IDebounce, IDefer, IRequestFrame } from "./types";
-export declare const throttle: IThrottle;
-export declare const debounce: IDebounce;
-export declare const defer: IDefer;
-export declare const catchAwait: ICatchAwait<Promise<any>>;
-export declare const requestFrame: IRequestFrame;
-declare const _default: {
-    throttle: IThrottle;
-    debounce: IDebounce;
-    defer: IDefer;
-    catchAwait: ICatchAwait<Promise<any>>;
-};
-export default _default;

package/dist/bundle/index.d.ts

@@ -1,76 +0,0 @@
-export * from "./object";
-export * from "./base";
-export * from "./array";
-export * from "./function";
-export * from "./element";
-export * from "./static";
-export * from "./types";
-export * from "./event";
-export * from "./storage";
-export * from "./log";
-export * from "./animate";
-export * from "event-message-center";
-export * from "task-queue-lib";
-export * from "js-request-lib";
-export * from "timer-manager-lib";
-export * from "js-log-lib";
-import eventMessageCenter from "event-message-center";
-import taskQueueLib from "task-queue-lib";
-import JSRequest from "js-request-lib";
-import TimerManager from "timer-manager-lib";
-import JSLogLib from "js-log-lib";
-declare const _default: {
-    eventMessageCenter: typeof eventMessageCenter;
-    taskQueueLib: typeof taskQueueLib;
-    JSRequest: typeof JSRequest;
-    TimerManager: typeof TimerManager;
-    JSLogLib: typeof JSLogLib;
-    AnimateFrame: typeof import("./animate").AnimateFrame;
-    quadraticBezier: typeof import("./animate").quadraticBezier;
-    cubicBezier: typeof import("./animate").cubicBezier;
-    factorial: typeof import("./animate").factorial;
-    combination: typeof import("./animate").combination;
-    NBezier: typeof import("./animate").NBezier;
-    logOneLine: import("./types").ILogOneLine;
-    logLoop: import("./types").ILogLoop;
-    setStorage: (key: string, val: any) => void;
-    getStorage: (key: string) => any;
-    clearStorage: (key: string) => void;
-    addHandler: import("./types").IAddHandler;
-    stopBubble: import("./types").IStopBubble;
-    stopDefault: import("./types").IStopDefault;
-    removeHandler: import("./types").IRemoveHandler;
-    dispatchEvent: import("./types").IDispatchEvent;
-    types: typeof import("./static").types;
-    createElement: import("./types").ICreateElement<HTMLElement>;
-    throttle: import("./types").IThrottle;
-    debounce: import("./types").IDebounce;
-    defer: import("./types").IDefer;
-    catchAwait: import("./types").ICatchAwait<Promise<any>>;
-    arrayRandom: import("./types").IArrayRandom<any[]>;
-    arrayUniq: import("./types").IArrayUniq<any[]>;
-    arrayDemote: import("./types").IArrayDemote<import("./types").IDemoteArray<any>>;
-    randomNum: import("./types").IRandomNum;
-    urlSplit: import("./types").IUrlSplit;
-    urlJoin: import("./types").IUrlJoin;
-    getType: import("./types").IGetType<import("./static").types>;
-    getTypeByList: import("./types").IGetTypeByList;
-    toKebabCase: (camelCase: string, separator?: string) => string;
-    getValue: import("./types").IGetValue;
-    setValue: import("./types").ISetValue;
-    mixIn: import("./types").IMixIn;
-    enumInversion: import("./types").IEnumInversion;
-    isNotObject: (source: any, type: any) => boolean;
-    cloneDeep: import("./types").ICloneDeep;
-    createObjectVariable: import("./types").ICreateObjectVariable;
-    createObject: import("./types").ICreateObject;
-    inherit: import("./types").IInherit;
-    getInstance: import("./types").IGetInstance;
-    classDecorator: import("./types").IClassDecorator;
-    stringToJson: import("./types").IStringToJson;
-    jsonToString: import("./types").IJsonToString;
-    isWindow: (win: any) => boolean;
-    emptyObject: (init?: import("./types").IObject<unknown>) => any;
-    isEmptyObject: (object?: import("./types").IObject<unknown>) => boolean;
-};
-export default _default;