@unicom-cloud/ui 0.8.115 → 0.8.117

package/dist/ui-common/hooks/use-key-press/index.js

@@ -0,0 +1,169 @@
+/* 2025-11-03 10:27:46 */
+import "../../utils/is.js";
+import m from "../use-latest/index.js";
+import b from "../utils/domTarget.js";
+import { isAppleDevice as v } from "@unicom-cloud/utils/constant/platform";
+import C from "../utils/useDeepCompareWithTarget.js";
+import { isFunction as K, isArray as q, isString as x, isNumber as k } from "@unicom-cloud/utils/is";
+const y = {
+  0: 48,
+  1: 49,
+  2: 50,
+  3: 51,
+  4: 52,
+  5: 53,
+  6: 54,
+  7: 55,
+  8: 56,
+  9: 57,
+  backspace: 8,
+  tab: 9,
+  enter: 13,
+  shift: 16,
+  ctrl: 17,
+  alt: 18,
+  pausebreak: 19,
+  capslock: 20,
+  esc: 27,
+  space: 32,
+  pageup: 33,
+  pagedown: 34,
+  end: 35,
+  home: 36,
+  leftarrow: 37,
+  uparrow: 38,
+  rightarrow: 39,
+  downarrow: 40,
+  insert: 45,
+  delete: 46,
+  a: 65,
+  b: 66,
+  c: 67,
+  d: 68,
+  e: 69,
+  f: 70,
+  g: 71,
+  h: 72,
+  i: 73,
+  j: 74,
+  k: 75,
+  l: 76,
+  m: 77,
+  n: 78,
+  o: 79,
+  p: 80,
+  q: 81,
+  r: 82,
+  s: 83,
+  t: 84,
+  u: 85,
+  v: 86,
+  w: 87,
+  x: 88,
+  y: 89,
+  z: 90,
+  leftwindowkey: 91,
+  rightwindowkey: 92,
+  meta: v ? [91, 93] : [91, 92],
+  selectkey: 93,
+  numpad0: 96,
+  numpad1: 97,
+  numpad2: 98,
+  numpad3: 99,
+  numpad4: 100,
+  numpad5: 101,
+  numpad6: 102,
+  numpad7: 103,
+  numpad8: 104,
+  numpad9: 105,
+  multiply: 106,
+  add: 107,
+  subtract: 109,
+  decimalpoint: 110,
+  divide: 111,
+  f1: 112,
+  f2: 113,
+  f3: 114,
+  f4: 115,
+  f5: 116,
+  f6: 117,
+  f7: 118,
+  f8: 119,
+  f9: 120,
+  f10: 121,
+  f11: 122,
+  f12: 123,
+  numlock: 144,
+  scrolllock: 145,
+  semicolon: 186,
+  equalsign: 187,
+  comma: 188,
+  dash: 189,
+  period: 190,
+  forwardslash: 191,
+  graveaccent: 192,
+  openbracket: 219,
+  backslash: 220,
+  closebracket: 221,
+  singlequote: 222
+}, l = {
+  ctrl: (e) => e.ctrlKey,
+  shift: (e) => e.shiftKey,
+  alt: (e) => e.altKey,
+  meta: (e) => e.type === "keyup" ? y.meta.includes(e.keyCode) : e.metaKey
+};
+function w(e) {
+  return x(e) || k(e);
+}
+function A(e) {
+  const t = Object.keys(l).reduce((n, r) => l[r](e) ? n + 1 : n, 0);
+  return [16, 17, 18, 91, 92].includes(e.keyCode) ? t : t + 1;
+}
+function p(e, t, n) {
+  if (!e.key)
+    return !1;
+  if (k(t))
+    return e.keyCode === t ? t : !1;
+  const r = t.split(".");
+  let a = 0;
+  for (const c of r) {
+    const s = l[c], f = y[c.toLowerCase()];
+    (s && s(e) || f && f === e.keyCode) && a++;
+  }
+  return n ? a === r.length && A(e) === r.length ? t : !1 : a === r.length ? t : !1;
+}
+function L(e, t) {
+  return K(e) ? e : w(e) ? (n) => p(n, e, t) : q(e) ? (n) => e.find((r) => p(n, r, t)) : () => !!e;
+}
+const j = ["keydown"];
+function M(e, t, n) {
+  const {
+    events: r = j,
+    target: a,
+    exactMatch: c = !1,
+    useCapture: s = !1
+  } = n || {}, f = m(t), h = m(e);
+  C(
+    () => {
+      const i = b(a, window);
+      if (!i)
+        return;
+      const d = (o) => {
+        const u = L(h.current, c)(o), g = w(u) ? u : o.key;
+        if (u)
+          return f.current?.(o, g);
+      };
+      for (const o of r)
+        i?.addEventListener?.(o, d, s);
+      return () => {
+        for (const o of r)
+          i?.removeEventListener?.(o, d, s);
+      };
+    },
+    [r],
+    a
+  );
+}
+export {
+  M as default
+};

package/dist/ui-common/hooks/use-keyboard-event/index.js

@@ -0,0 +1,17 @@
+/* 2025-11-03 10:27:46 */
+import { Enter as t, ArrowDown as w, ArrowLeft as y, ArrowRight as A, ArrowUp as k } from "@unicom-cloud/utils/constant/keyboardCode";
+import { useCallback as f } from "react";
+function s(e) {
+  return f(
+    (n) => ({
+      onKeyDown(o) {
+        const r = o.key;
+        r === t.key && n.onPressEnter?.(o, r), r === w.key && n.onArrowDown?.(o, r), r === y.key && n.onArrowLeft?.(o, r), r === A.key && n.onArrowRight?.(o, r), r === k.key && n.onArrowUp?.(o, r), e?.onKeyDown?.(o);
+      }
+    }),
+    []
+  );
+}
+export {
+  s as default
+};

package/dist/ui-common/hooks/use-latest/index.js

@@ -0,0 +1,9 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as n } from "react";
+function o(e) {
+  const r = n(e);
+  return r.current = e, r;
+}
+export {
+  o as default
+};

package/dist/ui-common/hooks/use-listen-window-resize/index.js

@@ -0,0 +1,10 @@
+/* 2025-11-03 10:27:46 */
+import { useEffect as t } from "react";
+function o(e, n = []) {
+  t(() => (window.addEventListener("resize", e), window.addEventListener("orientationchange", e), () => {
+    window.removeEventListener("resize", e), window.removeEventListener("orientationchange", e);
+  }), [...n]);
+}
+export {
+  o as default
+};

package/dist/ui-common/hooks/use-local-storage-state/index.js

@@ -0,0 +1,9 @@
+/* 2025-11-03 10:27:46 */
+import o from "../create-use-storage-state/index.js";
+import { isBrowser as r } from "@unicom-cloud/utils/constant/platform";
+const e = o(
+  () => r ? localStorage : void 0
+);
+export {
+  e as default
+};

package/dist/ui-common/hooks/use-lock-fn/index.js

@@ -0,0 +1,23 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as n, useCallback as u } from "react";
+function f(t) {
+  const r = n(!1);
+  return u(
+    async (...e) => {
+      if (!r.current) {
+        r.current = !0;
+        try {
+          return await t(...e);
+        } catch (a) {
+          throw a;
+        } finally {
+          r.current = !1;
+        }
+      }
+    },
+    [t]
+  );
+}
+export {
+  f as default
+};

package/dist/ui-common/hooks/use-long-press/index.js

@@ -0,0 +1,59 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as i } from "react";
+import E from "../use-latest/index.js";
+import R from "../utils/domTarget.js";
+import j from "../utils/useEffectWithTarget.js";
+function F(b, h, { delay: w = 300, moveThreshold: n, onClick: C, onLongPressEnd: M } = {}) {
+  const g = E(b), s = E(C), m = E(M), r = i(void 0), c = i(!1), u = i({ x: 0, y: 0 }), o = i(!1), a = i(!1), l = !!(n?.x && n.x > 0 || n?.y && n.y > 0);
+  j(
+    () => {
+      const t = R(h);
+      if (!t?.addEventListener)
+        return;
+      const k = (e) => {
+        const { clientX: d, clientY: f } = L(e), z = Math.abs(d - u.current.x), P = Math.abs(f - u.current.y);
+        return !!(n?.x && z > n.x || n?.y && P > n.y);
+      };
+      function L(e) {
+        return "TouchEvent" in window && e instanceof TouchEvent ? {
+          clientX: e.touches[0].clientX,
+          clientY: e.touches[0].clientY
+        } : e instanceof MouseEvent ? {
+          clientX: e.clientX,
+          clientY: e.clientY
+        } : { clientX: 0, clientY: 0 };
+      }
+      const T = (e) => {
+        r.current = setTimeout(() => {
+          g.current(e), c.current = !0;
+        }, w);
+      }, p = (e) => {
+        if (!a.current) {
+          if (a.current = !0, l) {
+            const { clientX: d, clientY: f } = L(e);
+            u.current.x = d, u.current.y = f;
+          }
+          T(e);
+        }
+      }, x = (e) => {
+        e?.sourceCapabilities?.firesTouchEvents || (o.current = !0, l && (u.current.x = e.clientX, u.current.y = e.clientY), T(e));
+      }, v = (e) => {
+        r.current && k(e) && (clearTimeout(r.current), r.current = void 0);
+      }, y = (e) => {
+        a.current && (a.current = !1, r.current && (clearTimeout(r.current), r.current = void 0), c.current ? m.current?.(e) : s.current && s.current(e), c.current = !1);
+      }, X = (e) => {
+        e?.sourceCapabilities?.firesTouchEvents || o.current && (o.current = !1, r.current && (clearTimeout(r.current), r.current = void 0), c.current ? m.current?.(e) : s.current && s.current(e), c.current = !1);
+      }, Y = (e) => {
+        o.current && (o.current = !1, r.current && (clearTimeout(r.current), r.current = void 0), c.current && (m.current?.(e), c.current = !1));
+      };
+      return t.addEventListener("mousedown", x), t.addEventListener("mouseup", X), t.addEventListener("mouseleave", Y), t.addEventListener("touchstart", p), t.addEventListener("touchend", y), l && (t.addEventListener("mousemove", v), t.addEventListener("touchmove", v)), () => {
+        r.current && (clearTimeout(r.current), c.current = !1), t.removeEventListener("mousedown", x), t.removeEventListener("mouseup", X), t.removeEventListener("mouseleave", Y), t.removeEventListener("touchstart", p), t.removeEventListener("touchend", y), l && (t.removeEventListener("mousemove", v), t.removeEventListener("touchmove", v));
+      };
+    },
+    [],
+    h
+  );
+}
+export {
+  F as default
+};

package/dist/ui-common/hooks/use-media/index.js

@@ -0,0 +1,16 @@
+/* 2025-11-03 10:27:46 */
+import { useState as r, useEffect as o } from "react";
+const d = (e, t) => t !== void 0 ? t : window.matchMedia(e).matches, m = (e, t) => {
+  const [s, n] = r(d(e, t));
+  return o(() => {
+    const a = window.matchMedia(e), c = () => {
+      n(!!a.matches);
+    };
+    return a.addEventListener("change", c), n(a.matches), () => {
+      a.removeEventListener("change", c);
+    };
+  }, [e]), s;
+};
+export {
+  m as default
+};

package/dist/ui-common/hooks/use-memoized-fn/index.js

@@ -0,0 +1,19 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as e, useMemo as u } from "react";
+import "../../utils/is.js";
+import c from "../utils/isDev.js";
+import { isFunction as i } from "@unicom-cloud/utils/is";
+const a = (r) => {
+  c && (i(r) || console.error(
+    `useMemoizedFn expected parameter is a function, got ${typeof r}`
+  ));
+  const o = e(r);
+  o.current = u(() => r, [r]);
+  const t = e(void 0);
+  return t.current || (t.current = function(...n) {
+    return o.current.apply(this, n);
+  }), t.current;
+};
+export {
+  a as default
+};

package/dist/ui-common/hooks/use-merge-props/index.js

@@ -0,0 +1,18 @@
+/* 2025-11-03 10:27:46 */
+import { useMemo as c } from "react";
+import i from "../../utils/omit.js";
+function l(o, s, e = {}) {
+  const { _ignorePropsFromGlobal: m } = o, r = c(() => ({
+    ...s,
+    ...m ? {} : e
+  }), [s, e, m]);
+  return c(() => {
+    const t = i(o, ["_ignorePropsFromGlobal"]);
+    for (const n in r)
+      t[n] === void 0 && (t[n] = r[n]);
+    return t;
+  }, [o, r]);
+}
+export {
+  l as default
+};

package/dist/ui-common/hooks/use-merge-value/index.js

@@ -0,0 +1,20 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as a, useState as m, useEffect as c } from "react";
+import "../../utils/is.js";
+import d from "../use-previous/index.js";
+import { isUndefined as r } from "@unicom-cloud/utils/is";
+function x(i, s) {
+  const { defaultValue: t, value: e } = s || {}, u = a(!0), f = d(e), [o, n] = m(
+    r(e) ? r(t) ? i : t : e
+  );
+  return c(() => {
+    if (u.current) {
+      u.current = !1;
+      return;
+    }
+    e === void 0 && (f === e || n(e));
+  }, [f, e]), [r(e) ? o : e, n, o];
+}
+export {
+  x as default
+};

package/dist/ui-common/hooks/use-mount/index.js

@@ -0,0 +1,13 @@
+/* 2025-11-03 10:27:46 */
+import { useEffect as o } from "react";
+import "../../utils/is.js";
+import e from "../utils/isDev.js";
+import { isFunction as r } from "@unicom-cloud/utils/is";
+const i = (t) => {
+  e && (r(t) || console.error(
+    `useMount: parameter \`fn\` expected to be a function, but got "${typeof t}".`
+  )), o(() => t?.(), []);
+};
+export {
+  i as default
+};

package/dist/ui-common/hooks/use-mouse/index.js

@@ -0,0 +1,50 @@
+/* 2025-11-03 10:27:46 */
+import f from "../use-event-listener/index.js";
+import P from "../use-raf-state/index.js";
+import d from "../utils/domTarget.js";
+const u = {
+  screenX: NaN,
+  screenY: NaN,
+  clientX: NaN,
+  clientY: NaN,
+  pageX: NaN,
+  pageY: NaN,
+  elementX: NaN,
+  elementY: NaN,
+  elementH: NaN,
+  elementW: NaN,
+  elementPosX: NaN,
+  elementPosY: NaN
+}, W = (l) => {
+  const [m, a] = P(u);
+  return f(
+    "mousemove",
+    (o) => {
+      const { screenX: s, screenY: c, clientX: X, clientY: Y, pageX: t, pageY: n } = o, e = {
+        screenX: s,
+        screenY: c,
+        clientX: X,
+        clientY: Y,
+        pageX: t,
+        pageY: n,
+        elementX: NaN,
+        elementY: NaN,
+        elementH: NaN,
+        elementW: NaN,
+        elementPosX: NaN,
+        elementPosY: NaN
+      }, N = d(l);
+      if (N) {
+        const { left: i, top: r, width: p, height: g } = N.getBoundingClientRect();
+        e.elementPosX = i + window.pageXOffset, e.elementPosY = r + window.pageYOffset, e.elementX = t - e.elementPosX, e.elementY = n - e.elementPosY, e.elementW = p, e.elementH = g;
+      }
+      a(e);
+    },
+    {
+      target: () => document
+    }
+  ), m;
+};
+export {
+  W as default
+};

package/dist/ui-common/hooks/use-mutation-observer/index.js

@@ -0,0 +1,23 @@
+/* 2025-11-03 10:27:46 */
+import m from "../use-latest/index.js";
+import c from "../utils/domTarget.js";
+import i from "../utils/useDeepCompareWithTarget.js";
+const a = (e, r, o = {}) => {
+  const s = m(e);
+  i(
+    () => {
+      const t = c(r);
+      if (!t)
+        return;
+      const n = new MutationObserver(s.current);
+      return n.observe(t, o), () => {
+        n?.disconnect();
+      };
+    },
+    [o],
+    r
+  );
+};
+export {
+  a as default
+};

package/dist/ui-common/hooks/use-network/index.js

@@ -0,0 +1,57 @@
+/* 2025-11-03 10:27:46 */
+import { useState as f, useEffect as d } from "react";
+import "../../utils/is.js";
+import { isObject as v } from "@unicom-cloud/utils/is";
+function s() {
+  const n = navigator;
+  return v(n) ? n.connection || n.mozConnection || n.webkitConnection : null;
+}
+function c() {
+  const n = s();
+  return n ? {
+    rtt: n.rtt,
+    type: n.type,
+    saveData: n.saveData,
+    downlink: n.downlink,
+    downlinkMax: n.downlinkMax,
+    effectiveType: n.effectiveType
+  } : {};
+}
+function m() {
+  const [n, t] = f(() => ({
+    since: void 0,
+    online: navigator?.onLine,
+    ...c()
+  }));
+  return d(() => {
+    const o = () => {
+      t((e) => ({
+        ...e,
+        online: !0,
+        since: /* @__PURE__ */ new Date()
+      }));
+    }, i = () => {
+      t((e) => ({
+        ...e,
+        online: !1,
+        since: /* @__PURE__ */ new Date()
+      }));
+    }, r = () => {
+      t((e) => ({
+        ...e,
+        ...c()
+      }));
+    };
+    window.addEventListener("online", o), window.addEventListener("offline", i);
+    const a = s();
+    return a?.addEventListener("change", r), () => {
+      window.removeEventListener("online", o), window.removeEventListener("offline", i), a?.removeEventListener(
+        "change",
+        r
+      );
+    };
+  }, []), n;
+}
+export {
+  m as default
+};

package/dist/ui-common/hooks/use-online-status/index.js

@@ -0,0 +1,21 @@
+/* 2025-11-03 10:27:46 */
+import { useSyncExternalStore as e, useDebugValue as t } from "react";
+function i(n) {
+  return window.addEventListener("online", n), window.addEventListener("offline", n), () => {
+    window.removeEventListener("online", n), window.removeEventListener("offline", n);
+  };
+}
+function r() {
+  const n = e(
+    i,
+    // 只要传递的是同一个函数，React 不会重新订阅
+    () => navigator.onLine,
+    // 如何在客户端获取值
+    () => !0
+    // 如何在服务端获取值
+  );
+  return t(n ? "Online" : "Offline"), n;
+}
+export {
+  r as default
+};

package/dist/ui-common/hooks/use-overflow-hidden/index.js

@@ -0,0 +1,27 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as s, useEffect as f } from "react";
+function w(r, { hidden: i }) {
+  const o = s(!1), c = s({}), u = (e) => e === document.body || e.tagName?.toLowerCase?.() === "body" ? window.innerWidth - (document.body.clientWidth || document.documentElement.clientWidth) : e.offsetWidth - e.clientWidth, l = () => {
+    const e = r();
+    if (e && e.style.overflow !== "hidden") {
+      const t = e.style;
+      o.current = !0;
+      const n = u(e);
+      n && (c.current.width = t.width, e.style.width = `calc(${e.style.width || "100%"} - ${n}px)`), c.current.overflow = t.overflow, e.style.overflow = "hidden";
+    }
+  }, d = () => {
+    if (o.current && r()) {
+      const e = r(), t = c.current;
+      Object.keys(t).forEach(
+        (n) => e.style[n] = t[n]
+      );
+    }
+    o.current = !1, c.current = {};
+  };
+  return f(() => (i ? l() : d(), () => {
+    d();
+  }), [r, i]), [d, l];
+}
+export {
+  w as default
+};

package/dist/ui-common/hooks/use-override-ref/index.js

@@ -0,0 +1,15 @@
+/* 2025-11-03 10:27:46 */
+import l, { useCallback as o, cloneElement as a, isValidElement as n } from "react";
+import { supportRef as f } from "../../utils/is.js";
+import { callbackOriginRef as c } from "../../utils/reactDOM.js";
+function u() {
+  const e = l.useRef(null);
+  return [o((r) => n(r) && f(r) ? a(r, {
+    ref: (t) => {
+      e.current = t, c(r, t);
+    }
+  }) : r, []), e];
+}
+export {
+  u as default
+};

package/dist/ui-common/hooks/use-pagination/index.js

@@ -0,0 +1,49 @@
+/* 2025-11-03 10:27:46 */
+import { useMemo as P } from "react";
+import i from "../use-memoized-fn/index.js";
+import x from "../use-request/src/useRequest.js";
+import "lodash/castArray";
+const b = (g, f = {}) => {
+  const { defaultPageSize: c = 10, defaultCurrent: h = 1, ...z } = f, a = x(g, {
+    defaultParams: [{ current: h, pageSize: c }],
+    refreshDepsAction: () => {
+      m(1);
+    },
+    ...z
+  }), { current: u = 1, pageSize: t = c } = a.params[0] || {}, r = a.data?.total || 0, S = P(
+    () => Math.ceil(r / t),
+    [t, r]
+  ), n = (e, p) => {
+    let o = e <= 0 ? 1 : e;
+    const l = p <= 0 ? 1 : p, s = Math.ceil(r / l);
+    o > s && (o = Math.max(1, s));
+    const [C = {}, ...M] = a.params || [];
+    a.run(
+      {
+        ...C,
+        current: o,
+        pageSize: l
+      },
+      ...M
+    );
+  }, m = (e) => {
+    n(e, t);
+  }, d = (e) => {
+    n(u, e);
+  };
+  return {
+    ...a,
+    pagination: {
+      current: u,
+      pageSize: t,
+      total: r,
+      totalPage: S,
+      onChange: i(n),
+      changeCurrent: i(m),
+      changePageSize: i(d)
+    }
+  };
+};
+export {
+  b as default
+};

package/dist/ui-common/hooks/use-persist-callback/index.js

@@ -0,0 +1,9 @@
+/* 2025-11-03 10:27:46 */
+import { useRef as u, useCallback as c } from "react";
+function o(e) {
+  const r = u(e);
+  return r.current = e, c((...t) => r.current?.(...t), []);
+}
+export {
+  o as default
+};

package/dist/ui-common/hooks/use-prefers-color-scheme-dark/index.js

@@ -0,0 +1,25 @@
+/* 2025-11-03 10:27:46 */
+import { MATCH_MEDIA_PREFERS_COLOR_SCHEME_DARK as e } from "@unicom-cloud/utils/constant";
+import { useState as o, useEffect as c } from "react";
+function E() {
+  const [n, r] = o(
+    e.matches
+  );
+  return c(() => {
+    function t(a) {
+      r(!!a.matches);
+    }
+    return e.addEventListener(
+      "change",
+      t
+    ), () => {
+      e.removeEventListener(
+        "change",
+        t
+      );
+    };
+  }, []), n;
+}
+export {
+  E as default
+};