@opentiny/utils 3.29.0 → 3.30.0

package/dist/debounce/index.d.ts

@@ -18,9 +18,13 @@ export interface DebounceFunction extends Function {
 /**
  * 防抖函数 - 将多次触发的函数执行延迟到最后一次触发后的指定时间才执行
  *
+ * 仅允许设置在开始，或者在结尾执行一次的防抖行为，若需要首尾均执行一次，请使用 `debounceBoth` 函数
+ *
  * @param {number} delay - 延迟时间（毫秒）
  * @param {boolean | Function} atBegin - 如果为布尔值，指定是否在延迟开始前执行；如果为函数，则作为回调函数
  * @param {Function} [callback] - 需要防抖的回调函数
  * @returns {DebounceFunction} 返回一个经过防抖处理的函数
  */
 export declare function debounce(delay: number, atBegin: boolean | Function, callback?: Function): DebounceFunction;
+/** 防抖函数 - 允许在延迟时间段的首尾均执行一次 */
+export declare function debounceBoth(delay: number, callback: Function): DebounceFunction;

package/dist/index.d.ts

@@ -24,7 +24,7 @@ export { fastdom, fastdomAsync, fastdomSandbox } from './fastdom';
 export { FullscreenApi, sf } from './fullscreen';
 export { NODE_KEY, getNodeKey, markNodeData, getChildState, Node, TreeStore } from './tree-model';
 export { afterLeave } from './after-leave';
-export { debounce } from './debounce';
+export { debounce, debounceBoth } from './debounce';
 export { throttle } from './throttle';
 export { on, off, once, hasClass, addClass, removeClass, getStyle, setStyle, isScroll, getScrollContainer, isInContainer, getDomNode, getScrollTop, stopPropagation, preventDefault, getScrollParent, useScrollParent, isDisplayNone } from './dom';
 export { init as initEspace, espaceCtrl } from './espace-ctrl';

package/dist/index.es.js

@@ -4331,6 +4331,18 @@ function Ks(e, t, s, n) {
 function Zc(e, t, s) {
   return s === void 0 ? Ks(e, t, !1) : Ks(e, s, t !== !1);
 }
+function Vc(e, t) {
+  let s = null;
+  const n = function(...i) {
+    const r = this, o = function() {
+      s = null, t.apply(r, i);
+    }, a = !s;
+    clearTimeout(s), s = setTimeout(o, e), a && t.apply(r, i);
+  };
+  return n._cancel = function() {
+    s && (clearTimeout(s), s = null);
+  }, n;
+}
 let ve = null;
 const ja = "ws://localhost", Ys = [27197, 27198, 27199];
 let Ft = 0, Se, Vn = 1e3, Jn = 3e4, Ba = 0, us = {}, Qn;
@@ -4526,15 +4538,15 @@ if (S || !window.WebSocket) {
     Object.prototype.hasOwnProperty.call(k, t) && typeof k[t] == "function" && (k[t] = e);
 }
 let Gs = !1;
-function Vc() {
+function Jc() {
   return !Gs && !S && (localStorage.setItem("eSpaceCtrl_initialized", 0), k.init({ timeout: 3e3, pollingInterval: 1e3 }), k.ready(() => {
     localStorage.setItem("eSpaceCtrl_initialized", 1);
   }), k.error(() => {
     localStorage.setItem("eSpaceCtrl_initialized", 0);
   }), Gs = !0), k;
 }
-const Jc = k;
-class Qc {
+const Qc = k;
+class ef {
   constructor(t, s = {}) {
     if (t && typeof t == "object" ? s = t : t = [], typeof s.key != "string" || !s.key)
       throw new Error("Memorize Initialization error.");
@@ -4821,7 +4833,7 @@ const Va = ["left", "right", "top", "bottom"], ar = ["shift", "offset", "prevent
     t.target.popperVm && t.contentRect.height > 50 && t.target.popperVm.update();
   });
 }) : null;
-class ef {
+class tf {
   constructor(t, s, n) {
     N(this, "_reference");
     N(this, "_popper");
@@ -5036,13 +5048,13 @@ const he = "__resizeListeners__", rl = (e) => {
       n();
     });
   });
-}, tf = (e, t) => {
-  S || (e[he] || (e[he] = [], e.__ro__ = new ai(rl), e.__ro__.observe(e)), e[he].push(t));
 }, sf = (e, t) => {
+  S || (e[he] || (e[he] = [], e.__ro__ = new ai(rl), e.__ro__.observe(e)), e[he].push(t));
+}, nf = (e, t) => {
   !e || !e[he] || (e[he].splice(e[he].indexOf(t), 1), e[he].length || (e.__ro__.disconnect(), delete e.__ro__));
 };
 let ot;
-function nf() {
+function rf() {
   if (S)
     return 0;
   if (ot !== void 0)
@@ -5058,7 +5070,7 @@ function nf() {
   const i = n.offsetWidth;
   return t.parentNode.removeChild(t), ot = s - i, ot;
 }
-const rf = (e, t) => {
+const of = (e, t) => {
   if (S)
     return;
   if (!t) {
@@ -5071,9 +5083,9 @@ const rf = (e, t) => {
     s.push(n), n = n.offsetParent;
   const o = i + s.reduce((u, c) => u + c.offsetTop, 0), a = o + r, l = e.scrollTop, f = l + e.clientHeight;
   o < l ? e.scrollTop = o : a > f && (e.scrollTop = a - e.clientHeight);
-}, en = 10, il = (e, t) => e > t && e > en ? "horizontal" : t > e && t > en ? "vertical" : "", of = (e) => (t) => {
+}, en = 10, il = (e, t) => e > t && e > en ? "horizontal" : t > e && t > en ? "vertical" : "", af = (e) => (t) => {
   ol(e), e.startX = t.touches[0].clientX, e.startY = t.touches[0].clientY;
-}, af = (e) => (t) => {
+}, lf = (e) => (t) => {
   const s = t.touches[0];
   e.deltaX = s.clientX - e.startX, e.deltaY = s.clientY - e.startY, e.offsetX = Math.abs(e.deltaX), e.offsetY = Math.abs(e.deltaY), e.direction = e.direction || il(e.offsetX, e.offsetY);
 }, ol = (e) => {
@@ -5106,7 +5118,7 @@ const dr = () => {
   t.type === "mousedown" && (It = !0), t.type === "mouseup" && (It = !1), !(t.type === "mousemove" && !It) && ((t.type === "mousedown" || !at) && (at = t.target), Me = ll(at, "[data-tiny-touch-simulate-container]"), Me && Me.dispatchEvent && fl(e, t), t.type === "mouseup" && (Me = null, at = null));
 }, ul = () => {
   window.addEventListener("mousedown", Lt("touchstart"), !0), window.addEventListener("mousemove", Lt("touchmove"), !0), window.addEventListener("mouseup", Lt("touchend"), !0);
-}, lf = () => {
+}, cf = () => {
   if (!S) {
     const e = "ontouchstart" in window;
     !tn && !e && (tn = !0, ul());
@@ -5125,7 +5137,7 @@ const dr = () => {
   s.response ? n = s.response.error || s.response : s.responseText ? n = s.responseText : n = `fail to post ${e} ${s.status}`;
   const i = new Error(n);
   return i.status = s.status, i.method = "post", i.url = e, i;
-}, cf = (e) => {
+}, ff = (e) => {
   if (typeof XMLHttpRequest > "u")
     return;
   const t = new XMLHttpRequest(), s = Mr.filterUrl(e.action);
@@ -5148,7 +5160,7 @@ const dr = () => {
   for (let r in i)
     A.call(i, r) && i[r] !== null && t.setRequestHeader(r, i[r]);
   return t.send(n), t;
-}, ff = { logger: zt };
+}, uf = { logger: zt };
 export {
   ac as BROWSER_NAME,
   Ye as BigIntDecimal,
@@ -5162,12 +5174,12 @@ export {
   ic as IPTHRESHOLD,
   mo as KEY_CODE,
   lc as MOUSEDELTA,
-  Qc as Memorize,
+  ef as Memorize,
   Oe as NODE_KEY,
   Ue as Node,
   we as NumberDecimal,
   nc as POSITION,
-  ef as PopperJS,
+  tf as PopperJS,
   $ as PopupManager,
   rc as REFRESH_INTERVAL,
   ai as ResizeObserver,
@@ -5176,10 +5188,10 @@ export {
   cc as VALIDATE_STATE,
   Hc as Validator,
   et as addClass,
-  tf as addResizeListener,
+  sf as addResizeListener,
   Gc as afterLeave,
   bl as browserInfo,
-  nf as calcScrollWidth,
+  rf as calcScrollWidth,
   Kc as callInterceptor,
   kl as camelize,
   Rl as capitalize,
@@ -5190,14 +5202,15 @@ export {
   Ht as copyField,
   Wc as correctTarget,
   Zc as debounce,
+  Vc as debounceBoth,
   _s as each,
   jc as emitEvent,
-  lf as emulate,
+  cf as emulate,
   Cl as equalsDecimal,
   zl as escape,
   Yt as escapeChars,
   gt as escapeHtml,
-  Jc as espaceCtrl,
+  Qc as espaceCtrl,
   ke as extend,
   Oc as extractDateFormat,
   Cc as extractTimeFormat,
@@ -5252,7 +5265,7 @@ export {
   A as hasOwn,
   Il as hyphenate,
   wt as indexOf,
-  Vc as initEspace,
+  Jc as initEspace,
   Le as isDate,
   jn as isDate1,
   uc as isDateObject,
@@ -5279,7 +5292,7 @@ export {
   po as lastMonth,
   Dl as lessEquals,
   ko as limitTimeRange,
-  ff as log,
+  uf as log,
   zt as logger,
   js as markNodeData,
   Ms as merge,
@@ -5310,10 +5323,10 @@ export {
   Fl as recoverNumber,
   kc as remove,
   tt as removeClass,
-  sf as removeResizeListener,
+  nf as removeResizeListener,
   ol as resetTouchStatus,
   Tn as roundFixed,
-  rf as scrollIntoView,
+  of as scrollIntoView,
   Ai as setDecimalClass,
   As as setObj,
   Pr as setStyle,
@@ -5340,8 +5353,8 @@ export {
   Pc as toObject,
   Kl as toRate,
   dn as toString,
-  af as touchMove,
-  of as touchStart,
+  lf as touchMove,
+  af as touchStart,
   tc as transformArray,
   Lo as transformPidToChildren,
   Po as transformTreeData,
@@ -5354,7 +5367,7 @@ export {
   Hl as tryToNumber,
   B as typeOf,
   Lc as unique,
-  cf as uploadAjax,
+  ff as uploadAjax,
   Al as useScrollParent,
   An as validateNumber,
   Fc as validateRangeInOneMonth,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opentiny/utils",
   "type": "module",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "description": "nanoid console xss",
   "author": "",
   "license": "ISC",