@cclr/react 0.1.9 → 0.1.11

package/lib/cjs/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var react = require('react');
+var front = require('@cclr/front');
 
 /**
  * 简化 createContext 的使用
@@ -22,4 +23,334 @@ function createCtx(defaultValue, name) {
   return [useCtx, ctx.Provider];
 }
 
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = !0,
+      o = !1;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) ; else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = !0, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * React hook to persist any value between renders,
+ * but keeps it up-to-date if it changes.
+ *
+ * @param value the value or function to persist
+ */
+function useCallbackRef(fn, deps) {
+  var ref = react.useRef(fn);
+  ref.current = fn;
+  return react.useCallback(function () {
+    var _ref$current;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    return (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.call.apply(_ref$current, [ref].concat(args));
+  }, _toConsumableArray(deps || []));
+}
+
+Function.prototype.call.bind(Object.prototype.hasOwnProperty);
+  Function.prototype.call.bind(Object.prototype.toString);
+
+function c(t, r) {
+  (null == r || r > t.length) && (r = t.length);
+  for (var n = 0, e = Array(r); n < r; n++) e[n] = t[n];
+  return e;
+}
+function y(t, r) {
+  return y = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, r) {
+    return t.__proto__ = r, t;
+  }, y(t, r);
+}
+function h(t) {
+  return function (t) {
+    if (Array.isArray(t)) return c(t);
+  }(t) || function (t) {
+    if ("undefined" != typeof Symbol && null != t[Symbol.iterator] || null != t["@@iterator"]) return Array.from(t);
+  }(t) || b(t) || function () {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+  }();
+}
+function b(t, r) {
+  if (t) {
+    if ("string" == typeof t) return c(t, r);
+    var n = {}.toString.call(t).slice(8, -1);
+    return "Object" === n && t.constructor && (n = t.constructor.name), "Map" === n || "Set" === n ? Array.from(t) : "Arguments" === n || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n) ? c(t, r) : void 0;
+  }
+}
+function m() {
+  m = function m(t, r) {
+    return new n(t, void 0, r);
+  };
+  var t = RegExp.prototype,
+    r = new WeakMap();
+  function n(t, e, o) {
+    var u = RegExp(t, e);
+    return r.set(u, o || r.get(t)), y(u, n.prototype);
+  }
+  function e(t, n) {
+    var e = r.get(n);
+    return Object.keys(e).reduce(function (r, n) {
+      var o = e[n];
+      if ("number" == typeof o) r[n] = t[o];else {
+        for (var u = 0; void 0 === t[o[u]] && u + 1 < o.length;) u++;
+        r[n] = t[o[u]];
+      }
+      return r;
+    }, Object.create(null));
+  }
+  return function (t, r) {
+    if ("function" != typeof r && null !== r) throw new TypeError("Super expression must either be null or a function");
+    t.prototype = Object.create(r && r.prototype, {
+      constructor: {
+        value: t,
+        writable: !0,
+        configurable: !0
+      }
+    }), Object.defineProperty(t, "prototype", {
+      writable: !1
+    }), r && y(t, r);
+  }(n, RegExp), n.prototype.exec = function (r) {
+    var n = t.exec.call(this, r);
+    if (n) {
+      n.groups = e(n, this);
+      var o = n.indices;
+      o && (o.groups = e(o, this));
+    }
+    return n;
+  }, n.prototype[Symbol.replace] = function (n, o) {
+    if ("string" == typeof o) {
+      var u = r.get(this);
+      return t[Symbol.replace].call(this, n, o.replace(/\$<([^>]+)>/g, function (t, r) {
+        var n = u[r];
+        return "$" + (Array.isArray(n) ? n.join("$") : n);
+      }));
+    }
+    if ("function" == typeof o) {
+      var i = this;
+      return t[Symbol.replace].call(this, n, function () {
+        var t = arguments;
+        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, i)), o.apply(this, t);
+      });
+    }
+    return t[Symbol.replace].call(this, n, o);
+  }, m.apply(this, arguments);
+}
+m(/\?([^#]*)/, {
+    query: 1
+  });
+  m(/#(.*)/, {
+    hash: 1
+  });
+  m(/^(?:[a-zA-Z][a-zA-Zd+-.]*:)?(?:\/\/(?:[^@/?#]*@)?[^/?#]*)?([^?#]*)/, {
+    pathname: 1
+  });
+  var w = function w(t, r) {
+    var n,
+      e,
+      o,
+      u,
+      i,
+      a = null == r ? void 0 : r.maxWait,
+      l = null !== (n = null == r ? void 0 : r.wait) && void 0 !== n ? n : 500,
+      c = null === (e = null == r ? void 0 : r.leading) || void 0 === e || e,
+      f = null === (o = null == r ? void 0 : r.trailing) || void 0 === o || o,
+      p = !1,
+      s = 0,
+      y = a && a > l,
+      v = function v() {
+        clearTimeout(u), u = null;
+      },
+      b = function b() {
+        p = !1, y && (s = Date.now()), t.apply(void 0, h(i));
+      },
+      _m = function m() {
+        clearTimeout(u), u = setTimeout(function () {
+          if (p && f) return b(), void _m();
+          v();
+        }, l);
+      },
+      d = function d() {
+        p = !0;
+        for (var t = arguments.length, r = new Array(t), n = 0; n < t; n++) r[n] = arguments[n];
+        i = r, u || (c ? b() : y && (s = Date.now())), y && Date.now() - s >= a && (b(), _m()), _m();
+      };
+    return d.cancel = v, d.flush = function () {
+      u && p && (b(), _m());
+    }, d;
+  },
+  P = function P(t, r) {
+    var n,
+      e,
+      o,
+      u,
+      i,
+      a = null !== (n = null == r ? void 0 : r.wait) && void 0 !== n ? n : 500,
+      l = null === (e = null == r ? void 0 : r.leading) || void 0 === e || e,
+      c = null === (o = null == r ? void 0 : r.trailing) || void 0 === o || o,
+      f = !1,
+      p = function p() {
+        clearTimeout(u), u = null, f = !1;
+      },
+      s = function s() {
+        f = !1, t.apply(void 0, h(i));
+      },
+      _y = function y() {
+        clearTimeout(u), u = setTimeout(function () {
+          if (f && c) return s(), void _y();
+          p();
+        }, a);
+      },
+      v = function v() {
+        f = !0;
+        for (var t = arguments.length, r = new Array(t), n = 0; n < t; n++) r[n] = arguments[n];
+        i = r, u || (l && s(), _y());
+      };
+    return v.cancel = p, v.flush = function () {
+      u && f && (s(), _y());
+    }, v;
+  };
+
+var useDebounceFn = function useDebounceFn(cb, options) {
+  var fun = useCallbackRef(cb);
+  return react.useMemo(function () {
+    var run = w(fun, options);
+    return {
+      run: run,
+      cancel: run.cancel,
+      flush: run.flush
+    };
+  }, []);
+};
+
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+var useEventListenerMultiple = function useEventListenerMultiple(ref, eventMap) {
+  var handleGetEventFun = useCallbackRef(function (key) {
+    return eventMap[key];
+  });
+  react.useEffect(function () {
+    if (!ref.current) return;
+    var newEventMap = Object.keys(eventMap).reduce(function (acc, key) {
+      acc[key] = function (event) {
+        var _handleGetEventFun;
+        (_handleGetEventFun = handleGetEventFun(key)) === null || _handleGetEventFun === void 0 || _handleGetEventFun(event);
+      };
+      return acc;
+    }, {});
+    return front.addEventListenerMultiple(ref.current, newEventMap);
+  }, []);
+};
+
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+var useEventListenerMultipleRef = function useEventListenerMultipleRef(eventMap) {
+  var ref = react.useRef(null);
+  var handleGetEventFun = useCallbackRef(function (key) {
+    return eventMap[key];
+  });
+  react.useEffect(function () {
+    if (!ref.current) return;
+    var newEventMap = Object.keys(eventMap).reduce(function (acc, key) {
+      acc[key] = function (event) {
+        var _handleGetEventFun2;
+        (_handleGetEventFun2 = handleGetEventFun(key)) === null || _handleGetEventFun2 === void 0 || _handleGetEventFun2(event);
+      };
+      return acc;
+    }, {});
+    return front.addEventListenerMultiple(ref.current, newEventMap);
+  }, []);
+  return {
+    ref: ref
+  };
+};
+
+/**
+ * 节流
+ * @param cb
+ * @returns
+ */
+var useThrottleFn = function useThrottleFn(cb, options) {
+  var fun = useCallbackRef(cb);
+  return react.useMemo(function () {
+    var run = P(fun, options);
+    return {
+      run: run,
+      cancel: run.cancel,
+      flush: run.flush
+    };
+  }, []);
+};
+
+var useUpdate = function useUpdate() {
+  var _useState = react.useState({}),
+    _useState2 = _slicedToArray(_useState, 2),
+    update = _useState2[1];
+  return function () {
+    return update({});
+  };
+};
+
 exports.createCtx = createCtx;
+exports.useCallbackRef = useCallbackRef;
+exports.useDebounceFn = useDebounceFn;
+exports.useEventListenerMultiple = useEventListenerMultiple;
+exports.useEventListenerMultipleRef = useEventListenerMultipleRef;
+exports.useThrottleFn = useThrottleFn;
+exports.useUpdate = useUpdate;

package/lib/esm/index.js

@@ -1,4 +1,5 @@
-import { createContext, useContext } from 'react';
+import { createContext, useContext, useRef, useCallback, useMemo, useEffect, useState } from 'react';
+import { addEventListenerMultiple } from '@cclr/front';
 
 /**
  * 简化 createContext 的使用
@@ -20,4 +21,328 @@ function createCtx(defaultValue, name) {
   return [useCtx, ctx.Provider];
 }
 
-export { createCtx };
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = !0,
+      o = !1;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) ; else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = !0, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * React hook to persist any value between renders,
+ * but keeps it up-to-date if it changes.
+ *
+ * @param value the value or function to persist
+ */
+function useCallbackRef(fn, deps) {
+  var ref = useRef(fn);
+  ref.current = fn;
+  return useCallback(function () {
+    var _ref$current;
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    return (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.call.apply(_ref$current, [ref].concat(args));
+  }, _toConsumableArray(deps || []));
+}
+
+Function.prototype.call.bind(Object.prototype.hasOwnProperty);
+  Function.prototype.call.bind(Object.prototype.toString);
+
+function c(t, r) {
+  (null == r || r > t.length) && (r = t.length);
+  for (var n = 0, e = Array(r); n < r; n++) e[n] = t[n];
+  return e;
+}
+function y(t, r) {
+  return y = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, r) {
+    return t.__proto__ = r, t;
+  }, y(t, r);
+}
+function h(t) {
+  return function (t) {
+    if (Array.isArray(t)) return c(t);
+  }(t) || function (t) {
+    if ("undefined" != typeof Symbol && null != t[Symbol.iterator] || null != t["@@iterator"]) return Array.from(t);
+  }(t) || b(t) || function () {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+  }();
+}
+function b(t, r) {
+  if (t) {
+    if ("string" == typeof t) return c(t, r);
+    var n = {}.toString.call(t).slice(8, -1);
+    return "Object" === n && t.constructor && (n = t.constructor.name), "Map" === n || "Set" === n ? Array.from(t) : "Arguments" === n || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n) ? c(t, r) : void 0;
+  }
+}
+function m() {
+  m = function m(t, r) {
+    return new n(t, void 0, r);
+  };
+  var t = RegExp.prototype,
+    r = new WeakMap();
+  function n(t, e, o) {
+    var u = RegExp(t, e);
+    return r.set(u, o || r.get(t)), y(u, n.prototype);
+  }
+  function e(t, n) {
+    var e = r.get(n);
+    return Object.keys(e).reduce(function (r, n) {
+      var o = e[n];
+      if ("number" == typeof o) r[n] = t[o];else {
+        for (var u = 0; void 0 === t[o[u]] && u + 1 < o.length;) u++;
+        r[n] = t[o[u]];
+      }
+      return r;
+    }, Object.create(null));
+  }
+  return function (t, r) {
+    if ("function" != typeof r && null !== r) throw new TypeError("Super expression must either be null or a function");
+    t.prototype = Object.create(r && r.prototype, {
+      constructor: {
+        value: t,
+        writable: !0,
+        configurable: !0
+      }
+    }), Object.defineProperty(t, "prototype", {
+      writable: !1
+    }), r && y(t, r);
+  }(n, RegExp), n.prototype.exec = function (r) {
+    var n = t.exec.call(this, r);
+    if (n) {
+      n.groups = e(n, this);
+      var o = n.indices;
+      o && (o.groups = e(o, this));
+    }
+    return n;
+  }, n.prototype[Symbol.replace] = function (n, o) {
+    if ("string" == typeof o) {
+      var u = r.get(this);
+      return t[Symbol.replace].call(this, n, o.replace(/\$<([^>]+)>/g, function (t, r) {
+        var n = u[r];
+        return "$" + (Array.isArray(n) ? n.join("$") : n);
+      }));
+    }
+    if ("function" == typeof o) {
+      var i = this;
+      return t[Symbol.replace].call(this, n, function () {
+        var t = arguments;
+        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, i)), o.apply(this, t);
+      });
+    }
+    return t[Symbol.replace].call(this, n, o);
+  }, m.apply(this, arguments);
+}
+m(/\?([^#]*)/, {
+    query: 1
+  });
+  m(/#(.*)/, {
+    hash: 1
+  });
+  m(/^(?:[a-zA-Z][a-zA-Zd+-.]*:)?(?:\/\/(?:[^@/?#]*@)?[^/?#]*)?([^?#]*)/, {
+    pathname: 1
+  });
+  var w = function w(t, r) {
+    var n,
+      e,
+      o,
+      u,
+      i,
+      a = null == r ? void 0 : r.maxWait,
+      l = null !== (n = null == r ? void 0 : r.wait) && void 0 !== n ? n : 500,
+      c = null === (e = null == r ? void 0 : r.leading) || void 0 === e || e,
+      f = null === (o = null == r ? void 0 : r.trailing) || void 0 === o || o,
+      p = !1,
+      s = 0,
+      y = a && a > l,
+      v = function v() {
+        clearTimeout(u), u = null;
+      },
+      b = function b() {
+        p = !1, y && (s = Date.now()), t.apply(void 0, h(i));
+      },
+      _m = function m() {
+        clearTimeout(u), u = setTimeout(function () {
+          if (p && f) return b(), void _m();
+          v();
+        }, l);
+      },
+      d = function d() {
+        p = !0;
+        for (var t = arguments.length, r = new Array(t), n = 0; n < t; n++) r[n] = arguments[n];
+        i = r, u || (c ? b() : y && (s = Date.now())), y && Date.now() - s >= a && (b(), _m()), _m();
+      };
+    return d.cancel = v, d.flush = function () {
+      u && p && (b(), _m());
+    }, d;
+  },
+  P = function P(t, r) {
+    var n,
+      e,
+      o,
+      u,
+      i,
+      a = null !== (n = null == r ? void 0 : r.wait) && void 0 !== n ? n : 500,
+      l = null === (e = null == r ? void 0 : r.leading) || void 0 === e || e,
+      c = null === (o = null == r ? void 0 : r.trailing) || void 0 === o || o,
+      f = !1,
+      p = function p() {
+        clearTimeout(u), u = null, f = !1;
+      },
+      s = function s() {
+        f = !1, t.apply(void 0, h(i));
+      },
+      _y = function y() {
+        clearTimeout(u), u = setTimeout(function () {
+          if (f && c) return s(), void _y();
+          p();
+        }, a);
+      },
+      v = function v() {
+        f = !0;
+        for (var t = arguments.length, r = new Array(t), n = 0; n < t; n++) r[n] = arguments[n];
+        i = r, u || (l && s(), _y());
+      };
+    return v.cancel = p, v.flush = function () {
+      u && f && (s(), _y());
+    }, v;
+  };
+
+var useDebounceFn = function useDebounceFn(cb, options) {
+  var fun = useCallbackRef(cb);
+  return useMemo(function () {
+    var run = w(fun, options);
+    return {
+      run: run,
+      cancel: run.cancel,
+      flush: run.flush
+    };
+  }, []);
+};
+
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+var useEventListenerMultiple = function useEventListenerMultiple(ref, eventMap) {
+  var handleGetEventFun = useCallbackRef(function (key) {
+    return eventMap[key];
+  });
+  useEffect(function () {
+    if (!ref.current) return;
+    var newEventMap = Object.keys(eventMap).reduce(function (acc, key) {
+      acc[key] = function (event) {
+        var _handleGetEventFun;
+        (_handleGetEventFun = handleGetEventFun(key)) === null || _handleGetEventFun === void 0 || _handleGetEventFun(event);
+      };
+      return acc;
+    }, {});
+    return addEventListenerMultiple(ref.current, newEventMap);
+  }, []);
+};
+
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+var useEventListenerMultipleRef = function useEventListenerMultipleRef(eventMap) {
+  var ref = useRef(null);
+  var handleGetEventFun = useCallbackRef(function (key) {
+    return eventMap[key];
+  });
+  useEffect(function () {
+    if (!ref.current) return;
+    var newEventMap = Object.keys(eventMap).reduce(function (acc, key) {
+      acc[key] = function (event) {
+        var _handleGetEventFun2;
+        (_handleGetEventFun2 = handleGetEventFun(key)) === null || _handleGetEventFun2 === void 0 || _handleGetEventFun2(event);
+      };
+      return acc;
+    }, {});
+    return addEventListenerMultiple(ref.current, newEventMap);
+  }, []);
+  return {
+    ref: ref
+  };
+};
+
+/**
+ * 节流
+ * @param cb
+ * @returns
+ */
+var useThrottleFn = function useThrottleFn(cb, options) {
+  var fun = useCallbackRef(cb);
+  return useMemo(function () {
+    var run = P(fun, options);
+    return {
+      run: run,
+      cancel: run.cancel,
+      flush: run.flush
+    };
+  }, []);
+};
+
+var useUpdate = function useUpdate() {
+  var _useState = useState({}),
+    _useState2 = _slicedToArray(_useState, 2),
+    update = _useState2[1];
+  return function () {
+    return update({});
+  };
+};
+
+export { createCtx, useCallbackRef, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useThrottleFn, useUpdate };

package/lib/type/index.d.ts

@@ -1,5 +1,6 @@
 import * as react from 'react';
-import { TPlainObject } from '@cclr/lang';
+import { TPlainObject, TPlainFunction } from '@cclr/lang';
+import { TEventMap } from '@cclr/front';
 
 /**
  * 简化 createContext 的使用
@@ -10,4 +11,74 @@ import { TPlainObject } from '@cclr/lang';
  */
 declare function createCtx<A extends TPlainObject | null>(defaultValue?: A, name?: string): readonly [() => A, react.Provider<A | undefined>];
 
-export { createCtx };
+/**
+ * React hook to persist any value between renders,
+ * but keeps it up-to-date if it changes.
+ *
+ * @param value the value or function to persist
+ */
+declare function useCallbackRef<T extends (...args: any[]) => unknown>(fn: T | undefined, deps?: React.DependencyList): T;
+
+declare const useDebounceFn: <T extends TPlainFunction>(cb: T, options?: {
+    /** 等待时间，单位为毫秒 default: 500 */
+    wait?: number;
+    /** 是否在延迟开始前调用函数 default: false */
+    leading?: boolean;
+    /** 是否在延迟开始后调用函数 default: true */
+    trailing?: boolean;
+    /** 最大等待时间，单位为毫秒 */
+    maxWait?: number;
+}) => {
+    run: T & {
+        cancel: () => void;
+        flush: () => void;
+    };
+    cancel: () => void;
+    flush: () => void;
+};
+
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+declare const useEventListenerMultiple: <T extends HTMLElement = HTMLElement>(ref: React.RefObject<T>, eventMap: TEventMap) => void;
+/**
+ * 使用多个事件监听器
+ * @param ref 要绑定事件的 DOM 元素的引用
+ * @param eventMap 事件监听器映射
+ */
+declare const useEventListenerMultipleRef: <T extends HTMLElement = HTMLElement>(eventMap: TEventMap) => {
+    ref: react.RefObject<T>;
+};
+
+/**
+ * 节流
+ * @param cb
+ * @returns
+ */
+declare const useThrottleFn: <T extends TPlainFunction>(cb: T, options?: {
+    /** 等待时间，单位为毫秒 default: 500 */
+    wait?: number;
+    /** 是否在延迟开始前调用函数 default: true */
+    leading?: boolean;
+    /** 是否在延迟开始后调用函数 default: true */
+    trailing?: boolean;
+}) => {
+    run: T & {
+        cancel: () => void;
+        flush: () => void;
+    };
+    cancel: () => void;
+    flush: () => void;
+};
+
+declare const useUpdate: () => () => void;
+
+interface ICommonUiProps {
+    className?: string;
+    style?: React.CSSProperties;
+    children?: React.ReactNode;
+}
+
+export { type ICommonUiProps, createCtx, useCallbackRef, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useThrottleFn, useUpdate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cclr/react",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "react 相关功能",
   "author": "cclr <18843152354@163.com>",
   "homepage": "",
@@ -27,11 +27,12 @@
     "g:test": "vitest run",
     "g:build": "ccm lib"
   },
-  "gitHead": "ebe5ad930f1ae38c11e885ee8d781235558928e9",
+  "gitHead": "e03c9c40bc86083ba49fe9f372375a50223191cc",
   "dependencies": {
-    "@cclr/lang": "^0.1.9",
-    "@cclr/model": "^0.1.9",
-    "@cclr/utils": "^0.1.9",
+    "@cclr/front": "0.1.11",
+    "@cclr/lang": "0.1.11",
+    "@cclr/model": "0.1.11",
+    "@cclr/utils": "0.1.11",
     "@testing-library/react-hooks": "^8.0.1",
     "@types/react": "^18.3.12",
     "react": "^18.3.1",