foreslash 0.2.0 → 0.2.1

package/lib/index.cmn.cjs

@@ -12,6 +12,12 @@ See the Mulan PSL v2 for more details.
 'use strict';
 
 function range(start, end, stepOrOptions) {
+    if (!isFinite(start))
+        throw new Error('start must be finite');
+    if (end == null)
+        return range(0, start);
+    if (!isFinite(end))
+        throw new Error('end must be finite');
     let step = 1;
     let getter = null;
     if (typeof stepOrOptions === 'number') {
@@ -30,8 +36,6 @@ function range(start, end, stepOrOptions) {
         throw new Error('step must be finite');
     if (step === 0)
         throw new Error('step must not be 0');
-    if (!isFinite(start) || !isFinite(end))
-        throw new Error('start and end must be finite');
     if ((start > end && step > 0) || (start < end && step < 0))
         step = -step;
     const res = [];
@@ -1356,7 +1360,7 @@ function _deepClone(obj, map, options) {
         map.set(obj, res);
     }
     else if (obj instanceof DataView) {
-        res = new DataView(_cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
+        res = new DataView(map.has(obj.buffer) ? map.get(obj.buffer) : _cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
         map.set(obj, res);
     }
     else if (isWrapperObject(obj)) {
@@ -1452,8 +1456,63 @@ function isEmpty(value) {
             return isNaN(value.getTime());
         if (isSet(value) || isMap(value))
             return !value.size;
-        return !Object.getOwnPropertyNames(value).length;
+        for (const key in value) {
+            if (Object.prototype.hasOwnProperty.call(value, key))
+                return false;
+        }
+        return true;
+    }
+}
+
+function _getKey(args) {
+    function toString(item) {
+        if (isBigInt(item))
+            return String(item) + 'n';
+        if (isRegExp(item))
+            return 'RegExp' + String(item);
+        if (isDate(item))
+            return 'Date' + item.toISOString();
+        try {
+            return JSON.stringify(item);
+        }
+        catch (e) {
+            return String(item);
+        }
+    }
+    let res = 'ForeSlashMemoKey:[';
+    for (let i = 0; i < args.length; i++) {
+        res += toString(args[i]) + ',';
     }
+    return res + ']';
+}
+function memo(fn, options) {
+    const map = new Map();
+    const getKey = (options === null || options === void 0 ? void 0 : options.getKey) ? options.getKey : _getKey;
+    const setTtl = (options === null || options === void 0 ? void 0 : options.ttl) ? options.ttl : 0;
+    const setCount = (options === null || options === void 0 ? void 0 : options.count) ? options.count : 0;
+    return function (...args) {
+        const key = getKey(args);
+        if (map.has(key)) {
+            const item = map.get(key);
+            const { res, ttl, count } = item;
+            const isValidCache = ttl >= Date.now() && count > 0;
+            item.count -= 1;
+            if (item.count <= 0)
+                map.delete(key);
+            if (ttl < Date.now())
+                map.delete(key);
+            if (isValidCache)
+                return res;
+        }
+        const res = fn.apply(this, args);
+        const memoItem = { res, ttl: Infinity, count: Infinity };
+        if (setCount > 0)
+            memoItem.count = setCount;
+        if (setTtl > 0)
+            memoItem.ttl = Date.now() + setTtl;
+        map.set(key, memoItem);
+        return res;
+    };
 }
 
 function not(value) {
@@ -1554,6 +1613,7 @@ exports.isWrapperObject = isWrapperObject;
 exports.isWrapperString = isWrapperString;
 exports.isWrapperSymbol = isWrapperSymbol;
 exports.kebabCase = kebabCase;
+exports.memo = memo;
 exports.noop = noop;
 exports.not = not;
 exports.pascalCase = pascalCase;

package/lib/index.d.ts

@@ -17,6 +17,17 @@ type RangeOptions<T> = {
  * @version 0.2.0
  */
 declare function range(start: number, end: number): number[];
+/**
+ * 根据目标值生成一个数组, 步长默认为 1
+ * @param target 目标值
+ * @example
+ * ```js
+ * range(10) // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+ * range(-10) // [0, -1, -2, -3, -4, -5, -6, -7, -8, -9, -10]
+ * ```
+ * @version 0.2.1
+ */
+declare function range(target: number): number[];
 /**
  * 根据起止值生成一个数组, 步长默认为 1
  * @param start 开始值
@@ -1358,6 +1369,22 @@ declare function fastClone<T>(obj: T, map?: Map<any, any>): T;
  */
 declare function isEmpty(value: unknown): boolean;
 
+/**
+ * 将一个函数记忆化, 多次调用如果参数相同, 则直接返回缓存的结果, 而不会反复执行函数
+ * - 每次运行时会将当前参数处理为 `key`, 相同 `key` 的函数调用将返回相同的结果
+ * @param fn 要缓存的函数
+ * @param options 缓存选项
+ * - `getKey` 自定义 key 的生成规则, 默认使用内部方法生成 key
+ * - `ttl` 缓存的过期时间, 单位毫秒, 为 0 表示不过期, 默认不过期
+ * - `count` 缓存最大使用次数, 为 0 表示不限次数, 默认不限次数
+ * @returns
+ */
+declare function memo<TArgs extends any[], TRes>(fn: (...args: TArgs) => TRes, options?: {
+    getKey?: (...args: TArgs) => string | number;
+    ttl?: number;
+    count?: number;
+}): (this: any, ...args: TArgs) => TRes;
+
 /**
  * 不做任何操作，返回 `void` ，一般用于函数式编程
  * @example
@@ -1525,4 +1552,4 @@ declare function pipe<PipeArgs extends any[], PipeResult, Mid1, Mid2, Mid3, Mid4
 declare function pipe<PipeArgs extends any[], PipeResult, Mid1, Mid2, Mid3, Mid4, Mid5, Mid6, Mid7>(...pipeFunc: PipeFuncList8<PipeArgs, PipeResult, Mid1, Mid2, Mid3, Mid4, Mid5, Mid6, Mid7>): (...args: PipeArgs) => PipeResult;
 declare function pipe<PipeArgs extends any[], PipeResult, Mid1, Mid2, Mid3, Mid4, Mid5, Mid6, Mid7>(...pipeFunc: PipeFuncListMore<PipeArgs, PipeResult, Mid1, Mid2, Mid3, Mid4, Mid5, Mid6, Mid7>): (...args: PipeArgs) => PipeResult;
 
-export { type CloneOptions, type CustomCloner, type RangeOptions, type TypedArray, _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, compose, _curryMore as curry, deepClone, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, shuffle, sleep, snakeCase, splitWords, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };
+export { type CloneOptions, type CustomCloner, type RangeOptions, type TypedArray, _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, compose, _curryMore as curry, deepClone, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, shuffle, sleep, snakeCase, splitWords, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };

package/lib/index.mjs

@@ -10,6 +10,12 @@ MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 See the Mulan PSL v2 for more details.
 */
 function range(start, end, stepOrOptions) {
+    if (!isFinite(start))
+        throw new Error('start must be finite');
+    if (end == null)
+        return range(0, start);
+    if (!isFinite(end))
+        throw new Error('end must be finite');
     let step = 1;
     let getter = null;
     if (typeof stepOrOptions === 'number') {
@@ -28,8 +34,6 @@ function range(start, end, stepOrOptions) {
         throw new Error('step must be finite');
     if (step === 0)
         throw new Error('step must not be 0');
-    if (!isFinite(start) || !isFinite(end))
-        throw new Error('start and end must be finite');
     if ((start > end && step > 0) || (start < end && step < 0))
         step = -step;
     const res = [];
@@ -1354,7 +1358,7 @@ function _deepClone(obj, map, options) {
         map.set(obj, res);
     }
     else if (obj instanceof DataView) {
-        res = new DataView(_cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
+        res = new DataView(map.has(obj.buffer) ? map.get(obj.buffer) : _cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
         map.set(obj, res);
     }
     else if (isWrapperObject(obj)) {
@@ -1450,8 +1454,63 @@ function isEmpty(value) {
             return isNaN(value.getTime());
         if (isSet(value) || isMap(value))
             return !value.size;
-        return !Object.getOwnPropertyNames(value).length;
+        for (const key in value) {
+            if (Object.prototype.hasOwnProperty.call(value, key))
+                return false;
+        }
+        return true;
+    }
+}
+
+function _getKey(args) {
+    function toString(item) {
+        if (isBigInt(item))
+            return String(item) + 'n';
+        if (isRegExp(item))
+            return 'RegExp' + String(item);
+        if (isDate(item))
+            return 'Date' + item.toISOString();
+        try {
+            return JSON.stringify(item);
+        }
+        catch (e) {
+            return String(item);
+        }
+    }
+    let res = 'ForeSlashMemoKey:[';
+    for (let i = 0; i < args.length; i++) {
+        res += toString(args[i]) + ',';
     }
+    return res + ']';
+}
+function memo(fn, options) {
+    const map = new Map();
+    const getKey = (options === null || options === void 0 ? void 0 : options.getKey) ? options.getKey : _getKey;
+    const setTtl = (options === null || options === void 0 ? void 0 : options.ttl) ? options.ttl : 0;
+    const setCount = (options === null || options === void 0 ? void 0 : options.count) ? options.count : 0;
+    return function (...args) {
+        const key = getKey(args);
+        if (map.has(key)) {
+            const item = map.get(key);
+            const { res, ttl, count } = item;
+            const isValidCache = ttl >= Date.now() && count > 0;
+            item.count -= 1;
+            if (item.count <= 0)
+                map.delete(key);
+            if (ttl < Date.now())
+                map.delete(key);
+            if (isValidCache)
+                return res;
+        }
+        const res = fn.apply(this, args);
+        const memoItem = { res, ttl: Infinity, count: Infinity };
+        if (setCount > 0)
+            memoItem.count = setCount;
+        if (setTtl > 0)
+            memoItem.ttl = Date.now() + setTtl;
+        map.set(key, memoItem);
+        return res;
+    };
 }
 
 function not(value) {
@@ -1486,4 +1545,4 @@ function pipe(...pipeFunc) {
     };
 }
 
-export { _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, compose, _curryMore as curry, deepClone, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, shuffle, sleep, snakeCase, splitWords, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };
+export { _, acceptableFileName, acceptableFileType, camelCase, caseCamel, caseConvert, caseKebab, casePascal, caseSnake, compose, _curryMore as curry, deepClone, fastClone, getAcceptableExtByMIME, getAcceptableMIMEByExt, getGlobalThis, getTag, isArray, isArrayBuffer, isArrayLike, isBigInt, isBigInt64Array, isBigUint64Array, isBoolean, isBuffer, isDataView, isDate, isEmpty, isFile, isFloat32Array, isFloat64Array, isFormData, isFunction, isInt16Array, isInt32Array, isInt8Array, isInteger, isIterable, isMap, isNil, isNull, isNumber, isObject, isPlaceholder, isPrimitive, isPromise, isPromiseLike, isRegExp, isSet, isString, isSymbol, isTypedArray, isUint16Array, isUint32Array, isUint8Array, isUint8ClampedArray, isUndefined, isWeakMap, isWeakSet, isWrapperBigInt, isWrapperBoolean, isWrapperNumber, isWrapperObject, isWrapperString, isWrapperSymbol, kebabCase, memo, noop, not, pascalCase, pass, passWith, pipe, randomBase32String, randomChoice, randomHexString, randomInt, randomIntFloor, randomString, range, shuffle, sleep, snakeCase, splitWords, titleCase, tryit, ulid, uuidNil, uuidV4, withResolvers };

package/lib/index.umd.js

@@ -16,6 +16,12 @@ See the Mulan PSL v2 for more details.
 })(this, (function (exports) { 'use strict';
 
     function range(start, end, stepOrOptions) {
+        if (!isFinite(start))
+            throw new Error('start must be finite');
+        if (end == null)
+            return range(0, start);
+        if (!isFinite(end))
+            throw new Error('end must be finite');
         let step = 1;
         let getter = null;
         if (typeof stepOrOptions === 'number') {
@@ -34,8 +40,6 @@ See the Mulan PSL v2 for more details.
             throw new Error('step must be finite');
         if (step === 0)
             throw new Error('step must not be 0');
-        if (!isFinite(start) || !isFinite(end))
-            throw new Error('start and end must be finite');
         if ((start > end && step > 0) || (start < end && step < 0))
             step = -step;
         const res = [];
@@ -1360,7 +1364,7 @@ See the Mulan PSL v2 for more details.
             map.set(obj, res);
         }
         else if (obj instanceof DataView) {
-            res = new DataView(_cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
+            res = new DataView(map.has(obj.buffer) ? map.get(obj.buffer) : _cloneArrayBuffer(obj.buffer, map), obj.byteOffset, obj.byteLength);
             map.set(obj, res);
         }
         else if (isWrapperObject(obj)) {
@@ -1456,8 +1460,63 @@ See the Mulan PSL v2 for more details.
                 return isNaN(value.getTime());
             if (isSet(value) || isMap(value))
                 return !value.size;
-            return !Object.getOwnPropertyNames(value).length;
+            for (const key in value) {
+                if (Object.prototype.hasOwnProperty.call(value, key))
+                    return false;
+            }
+            return true;
+        }
+    }
+
+    function _getKey(args) {
+        function toString(item) {
+            if (isBigInt(item))
+                return String(item) + 'n';
+            if (isRegExp(item))
+                return 'RegExp' + String(item);
+            if (isDate(item))
+                return 'Date' + item.toISOString();
+            try {
+                return JSON.stringify(item);
+            }
+            catch (e) {
+                return String(item);
+            }
+        }
+        let res = 'ForeSlashMemoKey:[';
+        for (let i = 0; i < args.length; i++) {
+            res += toString(args[i]) + ',';
         }
+        return res + ']';
+    }
+    function memo(fn, options) {
+        const map = new Map();
+        const getKey = (options === null || options === void 0 ? void 0 : options.getKey) ? options.getKey : _getKey;
+        const setTtl = (options === null || options === void 0 ? void 0 : options.ttl) ? options.ttl : 0;
+        const setCount = (options === null || options === void 0 ? void 0 : options.count) ? options.count : 0;
+        return function (...args) {
+            const key = getKey(args);
+            if (map.has(key)) {
+                const item = map.get(key);
+                const { res, ttl, count } = item;
+                const isValidCache = ttl >= Date.now() && count > 0;
+                item.count -= 1;
+                if (item.count <= 0)
+                    map.delete(key);
+                if (ttl < Date.now())
+                    map.delete(key);
+                if (isValidCache)
+                    return res;
+            }
+            const res = fn.apply(this, args);
+            const memoItem = { res, ttl: Infinity, count: Infinity };
+            if (setCount > 0)
+                memoItem.count = setCount;
+            if (setTtl > 0)
+                memoItem.ttl = Date.now() + setTtl;
+            map.set(key, memoItem);
+            return res;
+        };
     }
 
     function not(value) {
@@ -1558,6 +1617,7 @@ See the Mulan PSL v2 for more details.
     exports.isWrapperString = isWrapperString;
     exports.isWrapperSymbol = isWrapperSymbol;
     exports.kebabCase = kebabCase;
+    exports.memo = memo;
     exports.noop = noop;
     exports.not = not;
     exports.pascalCase = pascalCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foreslash",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Foreslash is a Javascript utilities lib which contains plenty of practical functions.",
   "author": "moushu",
   "license": "Mulan PSL v2",
@@ -21,7 +21,7 @@
     ".": {
       "import": "./lib/index.mjs",
       "require": "./lib/index.cmn.cjs",
-      "types": "./types/index.d.ts"
+      "types": "./lib/index.d.ts"
     },
     "./umd": "./lib/index.umd.js"
   },