rattail 1.2.1 → 1.3.0

package/lib/index.cjs

@@ -64,6 +64,7 @@ __export(src_exports, {
   cloneDeep: () => cloneDeep,
   cloneDeepWith: () => cloneDeepWith,
   copyText: () => copyText,
+  createCacheManager: () => createCacheManager,
   createNamespaceFn: () => createNamespaceFn,
   createStorage: () => createStorage,
   debounce: () => debounce,
@@ -855,6 +856,7 @@ __export(util_exports, {
   cancelAnimationFrame: () => cancelAnimationFrame,
   classes: () => classes,
   copyText: () => copyText,
+  createCacheManager: () => createCacheManager,
   createNamespaceFn: () => createNamespaceFn,
   createStorage: () => createStorage,
   doubleRaf: () => doubleRaf,
@@ -1298,6 +1300,46 @@ function duration() {
   return ctx;
 }
 
+// src/util/createCacheManager.ts
+function createCacheManager(options = {}) {
+  const cacheManager = /* @__PURE__ */ new Map();
+  const { ttl: defaultTtl = Infinity } = options;
+  function purgeStale() {
+    cacheManager.forEach((value, key3) => {
+      if (performance.now() > value.expiredAt) {
+        remove(key3);
+      }
+    });
+  }
+  function has(key3) {
+    purgeStale();
+    return cacheManager.has(key3);
+  }
+  function get(key3) {
+    var _a;
+    purgeStale();
+    return (_a = cacheManager.get(key3)) == null ? void 0 : _a.value;
+  }
+  function set2(key3, value, options2) {
+    var _a;
+    const ttl = (_a = options2 == null ? void 0 : options2.ttl) != null ? _a : defaultTtl;
+    cacheManager.set(key3, { expiredAt: performance.now() + ttl, value });
+  }
+  function remove(key3) {
+    return cacheManager.delete(key3);
+  }
+  function clear() {
+    cacheManager.clear();
+  }
+  return {
+    has,
+    get,
+    set: set2,
+    remove,
+    clear
+  };
+}
+
 // src/util/index.ts
 __reExport(util_exports, require("mitt"));
 var import_mitt = __toESM(require("mitt"), 1);
@@ -1653,6 +1695,7 @@ function ceil(val, precision = 0) {
   cloneDeep,
   cloneDeepWith,
   copyText,
+  createCacheManager,
   createNamespaceFn,
   createStorage,
   debounce,

package/lib/index.d.cts

@@ -155,6 +155,19 @@ interface DurationContext {
 }
 declare function duration(): DurationContext;
 
+interface CreateCacheManagerOptions {
+    ttl?: number;
+}
+declare function createCacheManager<T = any>(options?: CreateCacheManagerOptions): {
+    has: (key: any) => boolean;
+    get: (key: any) => T | undefined;
+    set: (key: any, value: T, options?: {
+        ttl: number;
+    }) => void;
+    remove: (key: any) => boolean;
+    clear: () => void;
+};
+
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare function once<F extends (...args: any[]) => any>(fn: F): (this: unknown, ...args: Parameters<F>) => ReturnType<F>;
@@ -326,4 +339,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.d.ts

@@ -155,6 +155,19 @@ interface DurationContext {
 }
 declare function duration(): DurationContext;
 
+interface CreateCacheManagerOptions {
+    ttl?: number;
+}
+declare function createCacheManager<T = any>(options?: CreateCacheManagerOptions): {
+    has: (key: any) => boolean;
+    get: (key: any) => T | undefined;
+    set: (key: any, value: T, options?: {
+        ttl: number;
+    }) => void;
+    remove: (key: any) => boolean;
+    clear: () => void;
+};
+
 declare function call<P extends any[], R>(fn?: ((...arg: P) => R) | ((...arg: P) => R)[] | null, ...args: P): R | R[] | undefined;
 
 declare function once<F extends (...args: any[]) => any>(fn: F): (this: unknown, ...args: Parameters<F>) => ReturnType<F>;
@@ -326,4 +339,4 @@ declare function floor(val: number, precision?: number): number;
 
 declare function ceil(val: number, precision?: number): number;
 
-export { type BEM, type ClassName, type Classes, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };
+export { type BEM, type ClassName, type Classes, type CreateCacheManagerOptions, type DurationContext, type Motion, type MotionOptions, type MotionState, NOOP, type PromiseWithResolvers, type Storage, assert, at, baseRound, call, callOrReturn, camelize, cancelAnimationFrame, ceil, chunk, clamp, clampArrayRange, classes, cloneDeep, cloneDeepWith, copyText, createCacheManager, createNamespaceFn, createStorage, debounce, delay, difference, differenceWith, doubleRaf, download, duration, ensurePrefix, ensureSuffix, find, floor, genNumberKey, genStringKey, getAllParentScroller, getGlobalThis, getParentScroller, getRect, getScrollLeft, getScrollTop, getStyle, groupBy, hasDuplicates, hasDuplicatesBy, hasOwn, inBrowser, inMobile, inViewport, intersection, intersectionWith, isArray, isArrayBuffer, isBlob, isBoolean, isDOMException, isDataView, isDate, isEmpty, isEmptyPlainObject, isEqual, isEqualWith, isError, isFile, isFunction, isMap, isNonEmptyArray, isNullish, isNumber, isNumeric, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isSet, isString, isSymbol, isTruthy, isTypedArray, isWeakMap, isWeakSet, isWindow, kebabCase, localStorage, lowerFirst, mapObject, maxBy, mean, meanBy, merge, mergeWith, minBy, motion, normalizeToArray, objectEntries, objectKeys, objectToString, omit, omitBy, once, pascalCase, pick, pickBy, prettyJSONObject, preventDefault, promiseWithResolvers, raf, randomColor, randomNumber, randomString, removeArrayBlank, removeArrayEmpty, removeItem, removeItemBy, removeItemsBy, requestAnimationFrame, round, sample, sessionStorage, set, shuffle, slash, sum, sumBy, sumHash, supportTouch, throttle, times, toArrayBuffer, toDataURL, toNumber, toRawType, toText, toTypeString, toggleItem, tryParseJSON, uniq, uniqBy, upperFirst, xor, xorWith };

package/lib/index.global.js

@@ -54,6 +54,7 @@ var Rattail = (() => {
     cloneDeep: () => cloneDeep,
     cloneDeepWith: () => cloneDeepWith,
     copyText: () => copyText,
+    createCacheManager: () => createCacheManager,
     createNamespaceFn: () => createNamespaceFn,
     createStorage: () => createStorage,
     debounce: () => debounce,
@@ -1258,6 +1259,46 @@ var Rattail = (() => {
     return ctx;
   }
 
+  // src/util/createCacheManager.ts
+  function createCacheManager(options = {}) {
+    const cacheManager = /* @__PURE__ */ new Map();
+    const { ttl: defaultTtl = Infinity } = options;
+    function purgeStale() {
+      cacheManager.forEach((value, key3) => {
+        if (performance.now() > value.expiredAt) {
+          remove(key3);
+        }
+      });
+    }
+    function has(key3) {
+      purgeStale();
+      return cacheManager.has(key3);
+    }
+    function get(key3) {
+      var _a;
+      purgeStale();
+      return (_a = cacheManager.get(key3)) == null ? void 0 : _a.value;
+    }
+    function set2(key3, value, options2) {
+      var _a;
+      const ttl = (_a = options2 == null ? void 0 : options2.ttl) != null ? _a : defaultTtl;
+      cacheManager.set(key3, { expiredAt: performance.now() + ttl, value });
+    }
+    function remove(key3) {
+      return cacheManager.delete(key3);
+    }
+    function clear() {
+      cacheManager.clear();
+    }
+    return {
+      has,
+      get,
+      set: set2,
+      remove,
+      clear
+    };
+  }
+
   // node_modules/.pnpm/mitt@3.0.1/node_modules/mitt/dist/mitt.mjs
   function mitt_default(n) {
     return { all: n = n || /* @__PURE__ */ new Map(), on: function(t, e) {

package/lib/index.js

@@ -52,6 +52,7 @@ __export(src_exports, {
   cloneDeep: () => cloneDeep,
   cloneDeepWith: () => cloneDeepWith,
   copyText: () => copyText,
+  createCacheManager: () => createCacheManager,
   createNamespaceFn: () => createNamespaceFn,
   createStorage: () => createStorage,
   debounce: () => debounce,
@@ -842,6 +843,7 @@ __export(util_exports, {
   cancelAnimationFrame: () => cancelAnimationFrame,
   classes: () => classes,
   copyText: () => copyText,
+  createCacheManager: () => createCacheManager,
   createNamespaceFn: () => createNamespaceFn,
   createStorage: () => createStorage,
   doubleRaf: () => doubleRaf,
@@ -1285,6 +1287,46 @@ function duration() {
   return ctx;
 }
 
+// src/util/createCacheManager.ts
+function createCacheManager(options = {}) {
+  const cacheManager = /* @__PURE__ */ new Map();
+  const { ttl: defaultTtl = Infinity } = options;
+  function purgeStale() {
+    cacheManager.forEach((value, key3) => {
+      if (performance.now() > value.expiredAt) {
+        remove(key3);
+      }
+    });
+  }
+  function has(key3) {
+    purgeStale();
+    return cacheManager.has(key3);
+  }
+  function get(key3) {
+    var _a;
+    purgeStale();
+    return (_a = cacheManager.get(key3)) == null ? void 0 : _a.value;
+  }
+  function set2(key3, value, options2) {
+    var _a;
+    const ttl = (_a = options2 == null ? void 0 : options2.ttl) != null ? _a : defaultTtl;
+    cacheManager.set(key3, { expiredAt: performance.now() + ttl, value });
+  }
+  function remove(key3) {
+    return cacheManager.delete(key3);
+  }
+  function clear() {
+    cacheManager.clear();
+  }
+  return {
+    has,
+    get,
+    set: set2,
+    remove,
+    clear
+  };
+}
+
 // src/util/index.ts
 __reExport(util_exports, mitt_star);
 import * as mitt_star from "mitt";
@@ -1640,6 +1682,7 @@ export {
   cloneDeep,
   cloneDeepWith,
   copyText,
+  createCacheManager,
   createNamespaceFn,
   createStorage,
   debounce,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rattail",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "A utilities library for front-end developers, lightweight and ts-friendly",
   "keywords": [
     "utilities library",
@@ -51,7 +51,7 @@
     "@configurajs/eslint": "^0.0.14",
     "@configurajs/prettier": "^0.1.1",
     "@types/node": "^22.8.1",
-    "@varlet/release": "^0.3.1",
+    "@varlet/release": "^0.4.4",
     "@vitest/coverage-istanbul": "^2.1.3",
     "eslint": "9.17.0",
     "jsdom": "^25.0.1",