@cclr/react 0.1.17 → 0.1.18

package/lib/cjs/index.js

@@ -45,12 +45,12 @@ function _iterableToArrayLimit(r, l) {
       i,
       u,
       a = [],
-      f = !0,
-      o = !1;
+      f = true,
+      o = false;
     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;
+      o = true, n = r;
     } finally {
       try {
         if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
@@ -99,9 +99,12 @@ function useCallbackRef(fn, deps) {
   }, _toConsumableArray(deps || []));
 }
 
-Function.prototype.call.bind(Object.prototype.hasOwnProperty);
-  var t = Function.prototype.call.bind(Object.prototype.toString),
-  r = {
+var n = function n(_n, t, r) {
+    if (r) for (var e = _n.length - 1; e >= 0; e--) t(_n[e], e, _n);else for (var o = 0; o < _n.length; o++) t(_n[o], o, _n);
+  },
+  r = Function.prototype.call.bind(Object.prototype.hasOwnProperty),
+  e = Function.prototype.call.bind(Object.prototype.toString),
+  o = {
     boolean: "boolean",
     undefined: "undefined",
     number: "number",
@@ -118,98 +121,230 @@ Function.prototype.call.bind(Object.prototype.hasOwnProperty);
     "[object File]": "file",
     "[object ArrayBuffer]": "arrayBuffer"
   };
-function e(n) {
-  return r[typeof n] || r[t(n)] || (n ? "object" : "null");
+function u(n) {
+  return o[typeof n] || o[e(n)] || (n ? "object" : "null");
 }
-function y$1(n) {
-  return "function" === e(n);
+function v$1(n) {
+  return "function" === u(n);
 }
 
-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];
+/**
+ * 仅执行一次
+ * @param fun 函数
+ * @returns
+ */
+var useOnceFun = function useOnceFun(fun) {
+  var ref = react.useRef(false);
+  if (ref.current) return;
+  ref.current = true;
+  fun();
+};
+
+/**
+ * 可以传函数的 useRef，
+ * 为了解决 useRef 初始化，调用运算复杂函数的问题
+ * @param initFun 初始化函数
+ * @returns
+ */
+var useRefPro = function useRefPro(initFun) {
+  var ref = react.useRef();
+  useOnceFun(function () {
+    ref.current = v$1(initFun) ? initFun() : initFun;
+  });
+  return ref;
+};
+
+/**
+ * 受控组件的值管理
+ */
+var useControl = function useControl(params, comptDefaultValue) {
+  var defaultValue = params.defaultValue,
+    onChange = params.onChange;
+  var ref = useRefPro(function () {
+    return {
+      isControl: r(params, 'value')
+    };
+  });
+  var _useState = react.useState(ref.current.isControl ? params.value : defaultValue || comptDefaultValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    value = _useState2[0],
+    setValue = _useState2[1];
+  return [ref.current.isControl ? params.value : value, function (value) {
+    if (!ref.current.isControl) {
+      setValue(value);
+    }
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+    return onChange === null || onChange === void 0 ? void 0 : onChange.apply(void 0, [value].concat(args));
+  }];
+};
+
+function l(t, n) {
+  (null == n || n > t.length) && (n = t.length);
+  for (var r = 0, e = Array(n); r < n; r++) e[r] = t[r];
   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 c(t, n, r) {
+  return n && function (t, n) {
+    for (var r = 0; r < n.length; r++) {
+      var e = n[r];
+      e.enumerable = e.enumerable || false, e.configurable = true, "value" in e && (e.writable = true), Object.defineProperty(t, d(e.key), e);
+    }
+  }(t.prototype, n), Object.defineProperty(t, "prototype", {
+    writable: false
+  }), t;
+}
+function f(t, n, r) {
+  return (n = d(n)) in t ? Object.defineProperty(t, n, {
+    value: r,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : t[n] = r, t;
 }
-function h(t) {
+function h(t, n) {
+  return h = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, n) {
+    return t.__proto__ = n, t;
+  }, h(t, n);
+}
+function v(t) {
   return function (t) {
-    if (Array.isArray(t)) return c(t);
+    if (Array.isArray(t)) return l(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) {
+function d(t) {
+  var n = function (t, n) {
+    if ("object" != typeof t || !t) return t;
+    var r = t[Symbol.toPrimitive];
+    if (void 0 !== r) {
+      var e = r.call(t, n);
+      if ("object" != typeof e) return e;
+      throw new TypeError("@@toPrimitive must return a primitive value.");
+    }
+    return (String )(t);
+  }(t, "string");
+  return "symbol" == typeof n ? n : n + "";
+}
+function b(t, n) {
   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;
+    if ("string" == typeof t) return l(t, n);
+    var r = {}.toString.call(t).slice(8, -1);
+    return "Object" === r && t.constructor && (r = t.constructor.name), "Map" === r || "Set" === r ? Array.from(t) : "Arguments" === r || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r) ? l(t, n) : void 0;
   }
 }
 function m() {
-  m = function m(t, r) {
-    return new n(t, void 0, r);
+  m = function m(t, n) {
+    return new r(t, void 0, n);
   };
   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);
+    n = new WeakMap();
+  function r(t, e, o) {
+    var i = RegExp(t, e);
+    return n.set(i, o || n.get(t)), h(i, r.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]];
+  function e(t, r) {
+    var e = n.get(r);
+    return Object.keys(e).reduce(function (n, r) {
+      var o = e[r];
+      if ("number" == typeof o) n[r] = t[o];else {
+        for (var i = 0; void 0 === t[o[i]] && i + 1 < o.length;) i++;
+        n[r] = t[o[i]];
       }
-      return r;
+      return n;
     }, 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, {
+  return function (t, n) {
+    if ("function" != typeof n && null !== n) throw new TypeError("Super expression must either be null or a function");
+    t.prototype = Object.create(n && n.prototype, {
       constructor: {
         value: t,
-        writable: !0,
-        configurable: !0
+        writable: true,
+        configurable: true
       }
     }), 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;
+      writable: false
+    }), n && h(t, n);
+  }(r, RegExp), r.prototype.exec = function (n) {
+    var r = t.exec.call(this, n);
+    if (r) {
+      r.groups = e(r, this);
+      var o = r.indices;
       o && (o.groups = e(o, this));
     }
-    return n;
-  }, n.prototype[Symbol.replace] = function (n, o) {
+    return r;
+  }, r.prototype[Symbol.replace] = function (r, 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);
+      var i = n.get(this);
+      return t[Symbol.replace].call(this, r, o.replace(/\$<([^>]+)>/g, function (t, n) {
+        var r = i[n];
+        return "$" + (Array.isArray(r) ? r.join("$") : r);
       }));
     }
     if ("function" == typeof o) {
-      var i = this;
-      return t[Symbol.replace].call(this, n, function () {
+      var u = this;
+      return t[Symbol.replace].call(this, r, function () {
         var t = arguments;
-        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, i)), o.apply(this, t);
+        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, u)), o.apply(this, t);
       });
     }
-    return t[Symbol.replace].call(this, n, o);
+    return t[Symbol.replace].call(this, r, o);
   }, m.apply(this, arguments);
 }
-m(/\?([^#]*)/, {
+var j = function j() {
+    for (var t = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : 36, n = ["a", "b", "c", "d", "e", "f", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"], r = [], e = 0; e < t; e++) r[e] = 8 === e || 13 === e || 18 === e || 23 === e ? "-" : n[Math.ceil(Math.random() * n.length - 1)];
+    return r.join("");
+  };
+  (function () {
+    return c(function t() {
+      !function (t, n) {
+        if (!(t instanceof n)) throw new TypeError("Cannot call a class as a function");
+      }(this, t), f(this, "handler", []);
+    }, [{
+      key: "use",
+      value: function value(t, n) {
+        return this.handler.push({
+          fulfilled: t,
+          rejected: n
+        }), this.handler.length - 1;
+      }
+    }, {
+      key: "eject",
+      value: function value(t) {
+        this.handler[t] && (this.handler[t] = null);
+      }
+    }, {
+      key: "clear",
+      value: function value() {
+        this.handler = [];
+      }
+    }, {
+      key: "forEach",
+      value: function value(t) {
+        var r = arguments.length > 1 && void 0 !== arguments[1] && arguments[1];
+        n(this.handler, function (n) {
+          n && t(n);
+        }, r);
+      }
+    }, {
+      key: "run",
+      value: function value(t) {
+        var n = arguments;
+        return new Promise(function (r, e) {
+          var o = n.length > 1 && void 0 !== n[1] && n[1],
+            i = Promise.resolve(t());
+          return this.forEach(function (t) {
+            i = i.then(t.fulfilled, t.rejected);
+          }, o), r(i);
+        }.bind(this));
+      }
+    }]);
+  })();
+  m(/\?([^#]*)/, {
     query: 1
   });
   m(/#(.*)/, {
@@ -218,80 +353,81 @@ m(/\?([^#]*)/, {
   m(/^(?:[a-zA-Z][a-zA-Zd+-.]*:)?(?:\/\/(?:[^@/?#]*@)?[^/?#]*)?([^?#]*)/, {
     pathname: 1
   });
-  var w = function w(t, r) {
-    var n,
+  var x = function x(t, n) {
+    var r,
       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;
+      u,
+      a = null == n ? void 0 : n.maxWait,
+      l = null !== (r = null == n ? void 0 : n.wait) && void 0 !== r ? r : 500,
+      c = null === (e = null == n ? void 0 : n.leading) || void 0 === e || e,
+      f = null === (o = null == n ? void 0 : n.trailing) || void 0 === o || o,
+      s = false,
+      p = 0,
+      h = a && a > l,
+      y = function y() {
+        clearTimeout(i), i = null;
       },
-      b = function b() {
-        p = !1, y && (s = Date.now()), t.apply(void 0, h(i));
+      d = function d() {
+        s = false, h && (p = Date.now()), t.apply(void 0, v(u));
       },
-      _m = function m() {
-        clearTimeout(u), u = setTimeout(function () {
-          if (p && f) return b(), void _m();
-          v();
+      _b = function b() {
+        clearTimeout(i), i = setTimeout(function () {
+          if (s && f) return d(), void _b();
+          y();
         }, 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();
+      m = function m() {
+        s = true;
+        for (var t = arguments.length, n = new Array(t), r = 0; r < t; r++) n[r] = arguments[r];
+        u = n, i || (c ? d() : h && (p = Date.now())), h && Date.now() - p >= a && (d(), _b()), _b();
       };
-    return d.cancel = v, d.flush = function () {
-      u && p && (b(), _m());
-    }, d;
+    return m.cancel = y, m.flush = function () {
+      i && s && (d(), _b());
+    }, m.fun = t, m;
   },
-  P = function P(t, r) {
-    var n,
+  k = function k(t, n) {
+    var r,
       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;
-      },
+      u,
+      a = null !== (r = null == n ? void 0 : n.wait) && void 0 !== r ? r : 500,
+      l = null === (e = null == n ? void 0 : n.leading) || void 0 === e || e,
+      c = null === (o = null == n ? void 0 : n.trailing) || void 0 === o || o,
+      f = false,
       s = function s() {
-        f = !1, t.apply(void 0, h(i));
+        clearTimeout(i), i = null, f = false;
+      },
+      p = function p() {
+        f = false, t.apply(void 0, v(u));
       },
-      _y = function y() {
-        clearTimeout(u), u = setTimeout(function () {
-          if (f && c) return s(), void _y();
-          p();
+      _h = function h() {
+        clearTimeout(i), i = setTimeout(function () {
+          if (f && c) return p(), void _h();
+          s();
         }, 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());
+      y = function y() {
+        f = true;
+        for (var t = arguments.length, n = new Array(t), r = 0; r < t; r++) n[r] = arguments[r];
+        u = n, i || (l && p(), _h());
       };
-    return v.cancel = p, v.flush = function () {
-      u && f && (s(), _y());
-    }, v;
+    return y.cancel = s, y.flush = function () {
+      i && f && (p(), _h());
+    }, y.fun = t, y;
   };
 
 var useDebounceFn = function useDebounceFn(cb, options) {
   var fun = useCallbackRef(cb);
   return react.useMemo(function () {
-    var run = w(fun, options);
+    var run = x(fun, options);
     return {
       run: run,
       cancel: run.cancel,
-      flush: run.flush
+      flush: run.flush,
+      fun: run.fun
     };
   }, []);
 };
@@ -344,32 +480,6 @@ var useEventListenerMultipleRef = function useEventListenerMultipleRef(eventMap)
   };
 };
 
-/**
- * 仅执行一次
- * @param fun 函数
- * @returns
- */
-var useOnceFun = function useOnceFun(fun) {
-  var ref = react.useRef(false);
-  if (ref.current) return;
-  ref.current = true;
-  fun();
-};
-
-/**
- * 可以传函数的 useRef，
- * 为了解决 useRef 初始化，调用运算复杂函数的问题
- * @param initFun 初始化函数
- * @returns
- */
-var useRefPro = function useRefPro(initFun) {
-  var ref = react.useRef();
-  useOnceFun(function () {
-    ref.current = y$1(initFun) ? initFun() : initFun;
-  });
-  return ref;
-};
-
 /**
  * 节流
  * @param cb
@@ -378,11 +488,12 @@ var useRefPro = function useRefPro(initFun) {
 var useThrottleFn = function useThrottleFn(cb, options) {
   var fun = useCallbackRef(cb);
   return react.useMemo(function () {
-    var run = P(fun, options);
+    var run = k(fun, options);
     return {
       run: run,
       cancel: run.cancel,
-      flush: run.flush
+      flush: run.flush,
+      fun: run.fun
     };
   }, []);
 };
@@ -396,8 +507,18 @@ var useUpdate = function useUpdate() {
   };
 };
 
+/**
+ * 生成一个 uuid
+ * @returns string
+ */
+var useUuid = function useUuid() {
+  var ref = useRefPro(j);
+  return ref.current;
+};
+
 exports.createCtx = createCtx;
 exports.useCallbackRef = useCallbackRef;
+exports.useControl = useControl;
 exports.useDebounceFn = useDebounceFn;
 exports.useEventListenerMultiple = useEventListenerMultiple;
 exports.useEventListenerMultipleRef = useEventListenerMultipleRef;
@@ -405,3 +526,4 @@ exports.useOnceFun = useOnceFun;
 exports.useRefPro = useRefPro;
 exports.useThrottleFn = useThrottleFn;
 exports.useUpdate = useUpdate;
+exports.useUuid = useUuid;

package/lib/esm/index.js

@@ -1,4 +1,4 @@
-import { createContext, useContext, useRef, useCallback, useMemo, useEffect, useState } from 'react';
+import { createContext, useContext, useRef, useCallback, useState, useMemo, useEffect } from 'react';
 import { addEventListenerMultiple } from '@cclr/front';
 
 /**
@@ -43,12 +43,12 @@ function _iterableToArrayLimit(r, l) {
       i,
       u,
       a = [],
-      f = !0,
-      o = !1;
+      f = true,
+      o = false;
     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;
+      o = true, n = r;
     } finally {
       try {
         if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
@@ -97,9 +97,12 @@ function useCallbackRef(fn, deps) {
   }, _toConsumableArray(deps || []));
 }
 
-Function.prototype.call.bind(Object.prototype.hasOwnProperty);
-  var t = Function.prototype.call.bind(Object.prototype.toString),
-  r = {
+var n = function n(_n, t, r) {
+    if (r) for (var e = _n.length - 1; e >= 0; e--) t(_n[e], e, _n);else for (var o = 0; o < _n.length; o++) t(_n[o], o, _n);
+  },
+  r = Function.prototype.call.bind(Object.prototype.hasOwnProperty),
+  e = Function.prototype.call.bind(Object.prototype.toString),
+  o = {
     boolean: "boolean",
     undefined: "undefined",
     number: "number",
@@ -116,98 +119,230 @@ Function.prototype.call.bind(Object.prototype.hasOwnProperty);
     "[object File]": "file",
     "[object ArrayBuffer]": "arrayBuffer"
   };
-function e(n) {
-  return r[typeof n] || r[t(n)] || (n ? "object" : "null");
+function u(n) {
+  return o[typeof n] || o[e(n)] || (n ? "object" : "null");
 }
-function y$1(n) {
-  return "function" === e(n);
+function v$1(n) {
+  return "function" === u(n);
 }
 
-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];
+/**
+ * 仅执行一次
+ * @param fun 函数
+ * @returns
+ */
+var useOnceFun = function useOnceFun(fun) {
+  var ref = useRef(false);
+  if (ref.current) return;
+  ref.current = true;
+  fun();
+};
+
+/**
+ * 可以传函数的 useRef，
+ * 为了解决 useRef 初始化，调用运算复杂函数的问题
+ * @param initFun 初始化函数
+ * @returns
+ */
+var useRefPro = function useRefPro(initFun) {
+  var ref = useRef();
+  useOnceFun(function () {
+    ref.current = v$1(initFun) ? initFun() : initFun;
+  });
+  return ref;
+};
+
+/**
+ * 受控组件的值管理
+ */
+var useControl = function useControl(params, comptDefaultValue) {
+  var defaultValue = params.defaultValue,
+    onChange = params.onChange;
+  var ref = useRefPro(function () {
+    return {
+      isControl: r(params, 'value')
+    };
+  });
+  var _useState = useState(ref.current.isControl ? params.value : defaultValue || comptDefaultValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    value = _useState2[0],
+    setValue = _useState2[1];
+  return [ref.current.isControl ? params.value : value, function (value) {
+    if (!ref.current.isControl) {
+      setValue(value);
+    }
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+    return onChange === null || onChange === void 0 ? void 0 : onChange.apply(void 0, [value].concat(args));
+  }];
+};
+
+function l(t, n) {
+  (null == n || n > t.length) && (n = t.length);
+  for (var r = 0, e = Array(n); r < n; r++) e[r] = t[r];
   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 c(t, n, r) {
+  return n && function (t, n) {
+    for (var r = 0; r < n.length; r++) {
+      var e = n[r];
+      e.enumerable = e.enumerable || false, e.configurable = true, "value" in e && (e.writable = true), Object.defineProperty(t, d(e.key), e);
+    }
+  }(t.prototype, n), Object.defineProperty(t, "prototype", {
+    writable: false
+  }), t;
+}
+function f(t, n, r) {
+  return (n = d(n)) in t ? Object.defineProperty(t, n, {
+    value: r,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : t[n] = r, t;
 }
-function h(t) {
+function h(t, n) {
+  return h = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, n) {
+    return t.__proto__ = n, t;
+  }, h(t, n);
+}
+function v(t) {
   return function (t) {
-    if (Array.isArray(t)) return c(t);
+    if (Array.isArray(t)) return l(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) {
+function d(t) {
+  var n = function (t, n) {
+    if ("object" != typeof t || !t) return t;
+    var r = t[Symbol.toPrimitive];
+    if (void 0 !== r) {
+      var e = r.call(t, n);
+      if ("object" != typeof e) return e;
+      throw new TypeError("@@toPrimitive must return a primitive value.");
+    }
+    return (String )(t);
+  }(t, "string");
+  return "symbol" == typeof n ? n : n + "";
+}
+function b(t, n) {
   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;
+    if ("string" == typeof t) return l(t, n);
+    var r = {}.toString.call(t).slice(8, -1);
+    return "Object" === r && t.constructor && (r = t.constructor.name), "Map" === r || "Set" === r ? Array.from(t) : "Arguments" === r || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r) ? l(t, n) : void 0;
   }
 }
 function m() {
-  m = function m(t, r) {
-    return new n(t, void 0, r);
+  m = function m(t, n) {
+    return new r(t, void 0, n);
   };
   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);
+    n = new WeakMap();
+  function r(t, e, o) {
+    var i = RegExp(t, e);
+    return n.set(i, o || n.get(t)), h(i, r.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]];
+  function e(t, r) {
+    var e = n.get(r);
+    return Object.keys(e).reduce(function (n, r) {
+      var o = e[r];
+      if ("number" == typeof o) n[r] = t[o];else {
+        for (var i = 0; void 0 === t[o[i]] && i + 1 < o.length;) i++;
+        n[r] = t[o[i]];
       }
-      return r;
+      return n;
     }, 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, {
+  return function (t, n) {
+    if ("function" != typeof n && null !== n) throw new TypeError("Super expression must either be null or a function");
+    t.prototype = Object.create(n && n.prototype, {
       constructor: {
         value: t,
-        writable: !0,
-        configurable: !0
+        writable: true,
+        configurable: true
       }
     }), 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;
+      writable: false
+    }), n && h(t, n);
+  }(r, RegExp), r.prototype.exec = function (n) {
+    var r = t.exec.call(this, n);
+    if (r) {
+      r.groups = e(r, this);
+      var o = r.indices;
       o && (o.groups = e(o, this));
     }
-    return n;
-  }, n.prototype[Symbol.replace] = function (n, o) {
+    return r;
+  }, r.prototype[Symbol.replace] = function (r, 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);
+      var i = n.get(this);
+      return t[Symbol.replace].call(this, r, o.replace(/\$<([^>]+)>/g, function (t, n) {
+        var r = i[n];
+        return "$" + (Array.isArray(r) ? r.join("$") : r);
       }));
     }
     if ("function" == typeof o) {
-      var i = this;
-      return t[Symbol.replace].call(this, n, function () {
+      var u = this;
+      return t[Symbol.replace].call(this, r, function () {
         var t = arguments;
-        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, i)), o.apply(this, t);
+        return "object" != typeof t[t.length - 1] && (t = [].slice.call(t)).push(e(t, u)), o.apply(this, t);
       });
     }
-    return t[Symbol.replace].call(this, n, o);
+    return t[Symbol.replace].call(this, r, o);
   }, m.apply(this, arguments);
 }
-m(/\?([^#]*)/, {
+var j = function j() {
+    for (var t = arguments.length > 0 && void 0 !== arguments[0] ? arguments[0] : 36, n = ["a", "b", "c", "d", "e", "f", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"], r = [], e = 0; e < t; e++) r[e] = 8 === e || 13 === e || 18 === e || 23 === e ? "-" : n[Math.ceil(Math.random() * n.length - 1)];
+    return r.join("");
+  };
+  (function () {
+    return c(function t() {
+      !function (t, n) {
+        if (!(t instanceof n)) throw new TypeError("Cannot call a class as a function");
+      }(this, t), f(this, "handler", []);
+    }, [{
+      key: "use",
+      value: function value(t, n) {
+        return this.handler.push({
+          fulfilled: t,
+          rejected: n
+        }), this.handler.length - 1;
+      }
+    }, {
+      key: "eject",
+      value: function value(t) {
+        this.handler[t] && (this.handler[t] = null);
+      }
+    }, {
+      key: "clear",
+      value: function value() {
+        this.handler = [];
+      }
+    }, {
+      key: "forEach",
+      value: function value(t) {
+        var r = arguments.length > 1 && void 0 !== arguments[1] && arguments[1];
+        n(this.handler, function (n) {
+          n && t(n);
+        }, r);
+      }
+    }, {
+      key: "run",
+      value: function value(t) {
+        var n = arguments;
+        return new Promise(function (r, e) {
+          var o = n.length > 1 && void 0 !== n[1] && n[1],
+            i = Promise.resolve(t());
+          return this.forEach(function (t) {
+            i = i.then(t.fulfilled, t.rejected);
+          }, o), r(i);
+        }.bind(this));
+      }
+    }]);
+  })();
+  m(/\?([^#]*)/, {
     query: 1
   });
   m(/#(.*)/, {
@@ -216,80 +351,81 @@ m(/\?([^#]*)/, {
   m(/^(?:[a-zA-Z][a-zA-Zd+-.]*:)?(?:\/\/(?:[^@/?#]*@)?[^/?#]*)?([^?#]*)/, {
     pathname: 1
   });
-  var w = function w(t, r) {
-    var n,
+  var x = function x(t, n) {
+    var r,
       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;
+      u,
+      a = null == n ? void 0 : n.maxWait,
+      l = null !== (r = null == n ? void 0 : n.wait) && void 0 !== r ? r : 500,
+      c = null === (e = null == n ? void 0 : n.leading) || void 0 === e || e,
+      f = null === (o = null == n ? void 0 : n.trailing) || void 0 === o || o,
+      s = false,
+      p = 0,
+      h = a && a > l,
+      y = function y() {
+        clearTimeout(i), i = null;
       },
-      b = function b() {
-        p = !1, y && (s = Date.now()), t.apply(void 0, h(i));
+      d = function d() {
+        s = false, h && (p = Date.now()), t.apply(void 0, v(u));
       },
-      _m = function m() {
-        clearTimeout(u), u = setTimeout(function () {
-          if (p && f) return b(), void _m();
-          v();
+      _b = function b() {
+        clearTimeout(i), i = setTimeout(function () {
+          if (s && f) return d(), void _b();
+          y();
         }, 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();
+      m = function m() {
+        s = true;
+        for (var t = arguments.length, n = new Array(t), r = 0; r < t; r++) n[r] = arguments[r];
+        u = n, i || (c ? d() : h && (p = Date.now())), h && Date.now() - p >= a && (d(), _b()), _b();
       };
-    return d.cancel = v, d.flush = function () {
-      u && p && (b(), _m());
-    }, d;
+    return m.cancel = y, m.flush = function () {
+      i && s && (d(), _b());
+    }, m.fun = t, m;
   },
-  P = function P(t, r) {
-    var n,
+  k = function k(t, n) {
+    var r,
       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;
-      },
+      u,
+      a = null !== (r = null == n ? void 0 : n.wait) && void 0 !== r ? r : 500,
+      l = null === (e = null == n ? void 0 : n.leading) || void 0 === e || e,
+      c = null === (o = null == n ? void 0 : n.trailing) || void 0 === o || o,
+      f = false,
       s = function s() {
-        f = !1, t.apply(void 0, h(i));
+        clearTimeout(i), i = null, f = false;
+      },
+      p = function p() {
+        f = false, t.apply(void 0, v(u));
       },
-      _y = function y() {
-        clearTimeout(u), u = setTimeout(function () {
-          if (f && c) return s(), void _y();
-          p();
+      _h = function h() {
+        clearTimeout(i), i = setTimeout(function () {
+          if (f && c) return p(), void _h();
+          s();
         }, 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());
+      y = function y() {
+        f = true;
+        for (var t = arguments.length, n = new Array(t), r = 0; r < t; r++) n[r] = arguments[r];
+        u = n, i || (l && p(), _h());
       };
-    return v.cancel = p, v.flush = function () {
-      u && f && (s(), _y());
-    }, v;
+    return y.cancel = s, y.flush = function () {
+      i && f && (p(), _h());
+    }, y.fun = t, y;
   };
 
 var useDebounceFn = function useDebounceFn(cb, options) {
   var fun = useCallbackRef(cb);
   return useMemo(function () {
-    var run = w(fun, options);
+    var run = x(fun, options);
     return {
       run: run,
       cancel: run.cancel,
-      flush: run.flush
+      flush: run.flush,
+      fun: run.fun
     };
   }, []);
 };
@@ -342,32 +478,6 @@ var useEventListenerMultipleRef = function useEventListenerMultipleRef(eventMap)
   };
 };
 
-/**
- * 仅执行一次
- * @param fun 函数
- * @returns
- */
-var useOnceFun = function useOnceFun(fun) {
-  var ref = useRef(false);
-  if (ref.current) return;
-  ref.current = true;
-  fun();
-};
-
-/**
- * 可以传函数的 useRef，
- * 为了解决 useRef 初始化，调用运算复杂函数的问题
- * @param initFun 初始化函数
- * @returns
- */
-var useRefPro = function useRefPro(initFun) {
-  var ref = useRef();
-  useOnceFun(function () {
-    ref.current = y$1(initFun) ? initFun() : initFun;
-  });
-  return ref;
-};
-
 /**
  * 节流
  * @param cb
@@ -376,11 +486,12 @@ var useRefPro = function useRefPro(initFun) {
 var useThrottleFn = function useThrottleFn(cb, options) {
   var fun = useCallbackRef(cb);
   return useMemo(function () {
-    var run = P(fun, options);
+    var run = k(fun, options);
     return {
       run: run,
       cancel: run.cancel,
-      flush: run.flush
+      flush: run.flush,
+      fun: run.fun
     };
   }, []);
 };
@@ -394,4 +505,13 @@ var useUpdate = function useUpdate() {
   };
 };
 
-export { createCtx, useCallbackRef, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useOnceFun, useRefPro, useThrottleFn, useUpdate };
+/**
+ * 生成一个 uuid
+ * @returns string
+ */
+var useUuid = function useUuid() {
+  var ref = useRefPro(j);
+  return ref.current;
+};
+
+export { createCtx, useCallbackRef, useControl, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useOnceFun, useRefPro, useThrottleFn, useUpdate, useUuid };

package/lib/type/index.d.ts

@@ -1,5 +1,5 @@
+import { TPlainObject, TAny, TPlainFunction, TNoop } from '@cclr/lang';
 import * as react from 'react';
-import { TPlainObject, TPlainFunction, TNoop } from '@cclr/lang';
 import { TEventMap } from '@cclr/front';
 
 /**
@@ -9,7 +9,7 @@ import { TEventMap } from '@cclr/front';
  * 在 React DevTools 中查看组件树时，每个使用 context 的组件都会显示与该 context 相关的名称
  * @returns [ useCtx, Provider ]
  */
-declare function createCtx<A extends TPlainObject | null>(defaultValue?: A, name?: string): readonly [() => A, react.Provider<A | undefined>];
+declare function createCtx<A extends TPlainObject | null>(defaultValue?: A, name?: string): [() => A, React.Provider<A>];
 
 /**
  * React hook to persist any value between renders,
@@ -19,6 +19,24 @@ declare function createCtx<A extends TPlainObject | null>(defaultValue?: A, name
  */
 declare function useCallbackRef<T extends (...args: any[]) => unknown>(fn: T | undefined, deps?: React.DependencyList): T;
 
+interface IControlProps<T> {
+    /** 受控组件时，传入的list */
+    value?: T;
+    /** 受控组件时，传入的list */
+    onChange?: (value: T, ...val: TAny) => unknown;
+    /** 初始化使用 */
+    defaultValue?: T;
+}
+
+/**
+ * 受控组件的值管理
+ */
+declare const useControl: <P extends IControlProps<TAny>>(
+/** 组件的props */
+params: P, 
+/** 组件的默认值 */
+comptDefaultValue?: P["defaultValue"]) => [P["value"], P["onChange"]];
+
 declare const useDebounceFn: <T extends TPlainFunction>(cb: T, options?: {
     /** 等待时间，单位为毫秒 default: 500 */
     wait?: number;
@@ -32,9 +50,11 @@ declare const useDebounceFn: <T extends TPlainFunction>(cb: T, options?: {
     run: T & {
         cancel: () => void;
         flush: () => void;
+        fun: T;
     };
     cancel: () => void;
     flush: () => void;
+    fun: T;
 };
 
 /**
@@ -83,17 +103,25 @@ declare const useThrottleFn: <T extends TPlainFunction>(cb: T, options?: {
     run: T & {
         cancel: () => void;
         flush: () => void;
+        fun: T;
     };
     cancel: () => void;
     flush: () => void;
+    fun: T;
 };
 
 declare const useUpdate: () => () => void;
 
+/**
+ * 生成一个 uuid
+ * @returns string
+ */
+declare const useUuid: () => string;
+
 interface ICommonUiProps {
     className?: string;
     style?: React.CSSProperties;
     children?: React.ReactNode;
 }
 
-export { type ICommonUiProps, createCtx, useCallbackRef, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useOnceFun, useRefPro, useThrottleFn, useUpdate };
+export { type ICommonUiProps, type IControlProps, createCtx, useCallbackRef, useControl, useDebounceFn, useEventListenerMultiple, useEventListenerMultipleRef, useOnceFun, useRefPro, useThrottleFn, useUpdate, useUuid };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cclr/react",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "react 相关功能",
   "author": "cclr <18843152354@163.com>",
   "homepage": "",
@@ -27,12 +27,12 @@
     "g:test": "vitest run",
     "g:build": "ccm lib"
   },
-  "gitHead": "5463a4bf24b98f18f5e349347c9b048f2670c990",
+  "gitHead": "f0b2dc8e54b6ddfcca0ff36488c17df73a658e49",
   "dependencies": {
-    "@cclr/front": "0.1.17",
-    "@cclr/lang": "0.1.17",
-    "@cclr/model": "0.1.17",
-    "@cclr/utils": "0.1.17"
+    "@cclr/front": "0.1.18",
+    "@cclr/lang": "0.1.18",
+    "@cclr/model": "0.1.18",
+    "@cclr/utils": "0.1.18"
   },
   "devDependencies": {
     "@types/react": "^18.3.18",