@unicom-cloud/utils 0.1.23 → 0.1.25

package/tree/index.js

@@ -1,88 +1,92 @@
-import { default as I } from "./search/index.js";
-function a(e, r, f, l = "children") {
-  if (Array.isArray(e) && (e = {
-    [l]: e
-  }), !(e && typeof e == "object")) return null;
-  if (r in e && e[r] === f)
-    return e;
-  const t = e[l] ?? e.items ?? e.list;
-  if (Array.isArray(t))
-    for (let i of t) {
-      const n = a(i, r, f, l);
-      if (n)
-        return n;
+/* 2025-11-03 10:27:31 */
+import a from "lodash/castArray";
+import c from "lodash/isArray";
+import d from "lodash/isUndefined";
+import { default as A } from "./search/index.js";
+function g(t, n, r, l = "children") {
+  if (c(t) && (t = {
+    [l]: t
+  }), !(t && typeof t == "object")) return null;
+  if (n in t && t[n] === r)
+    return t;
+  const f = t[l] ?? t.items ?? t.list;
+  if (c(f))
+    for (let i of f) {
+      const e = g(i, n, r, l);
+      if (e)
+        return e;
     }
   return null;
 }
-function y(e, r, f, l = "children") {
-  if (!e) return;
-  let t = Array.isArray(e) ? [...e] : [e];
-  e: for (; t.length; ) {
-    let i = t.shift();
-    if (!i) continue e;
-    if (!Array.isArray(i)) {
-      if (i[r] === f)
-        return i;
-      let n = i[l] ?? i.items ?? i.list;
-      if (n === void 0)
+function h(t, n, r, l = "children", f = !0) {
+  if (!t) return;
+  let i = [...a(t)];
+  e: for (; i.length; ) {
+    let e = i.shift();
+    if (!e) continue e;
+    const u = e[n];
+    if (!c(e)) {
+      if (f ? u === r : u == r)
+        return e;
+      let s = e[l] ?? e.items ?? e.list;
+      if (d(s))
         continue e;
-      i = n;
+      e = s;
     }
-    t = t.concat(i);
+    i = i.concat(e);
   }
 }
-const d = a;
-function h(e, r, f, l = "children") {
-  if (!e) return;
-  const t = Array.isArray(e) ? [...e] : [e];
-  e: for (; t.length; ) {
-    let i = t.pop();
+function o(t, n, r, l = "children") {
+  if (!t) return;
+  const f = [...a(t)];
+  e: for (; f.length; ) {
+    let i = f.pop();
     if (!i) continue e;
-    if (!Array.isArray(i)) {
-      if (i[r] === f)
+    if (!c(i)) {
+      if (i[n] === r)
         return i;
-      let n = i[l] ?? i.items ?? i.list;
-      if (n === void 0)
+      let e = i[l] ?? i.items ?? i.list;
+      if (d(e))
         continue e;
-      i = n;
+      i = e;
     }
-    if (Array.isArray(i))
-      for (let n = 0, u = i.length; n < u; n++)
-        t.push(i[u - 1 - n]);
+    if (c(i))
+      for (let e = 0, u = i.length; e < u; e++)
+        f.push(i[u - 1 - e]);
   }
 }
-function A(e, r) {
-  return y(e, "id", r);
+function I(t, n) {
+  return h(t, "id", n);
 }
-function m(e, r, f = !0) {
-  let l = y(e, "value", r)?.label;
-  return !l && f && (l = r), l;
+function b(t, n, r = !0) {
+  let l = h(t, "value", n)?.label;
+  return !l && r && (l = n), l;
 }
-function g(e, r, f, l = "children") {
-  if (!e) return;
-  let t = null;
-  function i(n) {
-    if (!n) return;
-    let u = Array.isArray(n) ? n : n[l] ?? n.items ?? n.list ?? [];
+function x(t, n, r, l = "children") {
+  if (!t) return;
+  let f = null;
+  function i(e) {
+    if (!e) return;
+    let u = c(e) ? e : e[l] ?? e.items ?? e.list ?? [];
     for (let s = 0; s < u.length; s++) {
-      const c = u[s];
-      if (c?.[r] === f) {
-        t = { item: c, parent: n, index: s };
+      const m = u[s];
+      if (m?.[n] === r) {
+        f = { item: m, parent: e, index: s };
         return;
       }
-      i(c);
+      i(m);
     }
   }
-  return i(e), t;
+  return i(t), f;
 }
 export {
-  y as default,
-  a as findNodeBy,
-  g as getChildWithParentBy,
-  y as getItemBy,
-  d as getItemBy2,
-  h as getItemBy3,
-  A as getItemByID,
-  m as getLabelFromDictionaryByValue,
-  I as searchTree
+  h as default,
+  g as findNodeBy,
+  x as getChildWithParentBy,
+  h as getItemBy,
+  o as getItemBy2,
+  g as getItemBy3,
+  I as getItemByID,
+  b as getLabelFromDictionaryByValue,
+  A as searchTree
 };

package/tree/search/index.js

@@ -1,16 +1,17 @@
-import "../../is/index.js";
-import S from "lodash/isArray";
-import B from "lodash/isObjectLike";
-import p from "lodash/isString";
-import C from "lodash/isNumber";
-import K from "lodash/isFunction";
-import L from "lodash/isRegExp";
-function j(i, a, m, w) {
-  return a && i ? { shouldExit: !0, newMatch: !0 } : m && !i ? { shouldExit: !0, newMatch: !1 } : { shouldExit: !1, newMatch: w || i };
+/* 2025-11-03 10:27:31 */
+import E from "lodash/isArray";
+import B from "lodash/isFunction";
+import C from "lodash/isNil";
+import K from "lodash/isNumber";
+import L from "lodash/isObjectLike";
+import j from "lodash/isRegExp";
+import f from "lodash/isString";
+function k(n, u, m, w) {
+  return u && n ? { shouldExit: !0, newMatch: !0 } : m && !n ? { shouldExit: !0, newMatch: !1 } : { shouldExit: !1, newMatch: w || n };
 }
-function P(i, a, m = {}) {
-  if (!S(i)) throw new TypeError("参数 treeData 必须是一个数组");
-  if (!B(a)) throw new TypeError("参数 searchCondition 必须是一个对象");
+function P(n, u, m = {}) {
+  if (C(n) || !E(n)) return null;
+  if (!L(u)) throw new TypeError("参数 searchCondition 必须是一个对象");
   const w = {
     strategy: "BFS",
     childrenKey: "children",
@@ -26,68 +27,60 @@ function P(i, a, m = {}) {
     ...m
     // 用户配置覆盖默认值
   }, {
-    strategy: E,
-    childrenKey: u,
-    strict: R,
-    fuzzyMatch: b,
+    strategy: S,
+    childrenKey: a,
+    strict: v,
+    fuzzyMatch: R,
     returnAllMatches: M,
-    caseSensitive: v,
+    caseSensitive: b,
     allowEmptyString: z,
     matchMode: T,
     returnTree: g,
     returnTreeMaxDepth: d
-  } = w, D = T === "OR", x = T === "AND", y = E === "BFS";
-  if (!(y || E === "DFS")) throw new Error('配置 strategy 必须是 "BFS" 或 "DFS"');
-  if (!(D || x)) throw new Error('配置 matchMode 必须是 "AND" 或 "OR"');
-  if (!p(u)) throw new TypeError("配置 childrenKey 必须是字符串");
+  } = w, x = T === "OR", A = T === "AND", y = S === "BFS";
+  if (!(y || S === "DFS")) throw new Error('配置 strategy 必须是 "BFS" 或 "DFS"');
+  if (!(x || A)) throw new Error('配置 matchMode 必须是 "AND" 或 "OR"');
+  if (!f(a)) throw new TypeError("配置 childrenKey 必须是字符串");
   if (g) {
     if (!M) throw new Error(
       "当 returnTree 为 true 时，returnAllMatches 也必须为 true"
     );
-    if (!(C(d) && d > -1)) throw new TypeError("配置 returnTreeMaxDepth 必须是一个非负整数");
+    if (!(K(d) && d > -1)) throw new TypeError("配置 returnTreeMaxDepth 必须是一个非负整数");
   }
-  const h = [...i], A = [], F = Object.entries(a);
-  if (F.length) {
+  const h = [...n], F = [], D = Object.entries(u);
+  if (D.length) {
     const N = (r) => {
       let s = !1;
-      for (const [n, e] of F) {
-        const t = r[n];
-        if (e === "" && !z)
+      for (const [i, c] of D) {
+        let e = c, t = r[i];
+        if (b || (f(e) && (e = e.toLowerCase()), f(t) && (t = t.toLowerCase())), e === "" && !z)
           continue;
         let o = !1;
-        if (K(e))
-          o = !!e(t, r);
-        else if (L(e) && p(t))
-          o = t ? e.test(t) : !1;
-        else if (b && p(e) && p(t)) {
-          let l = e, c = t;
-          v || (l = e.toLowerCase(), c = t.toLowerCase()), o = c.includes(l);
-        } else
-          o = R ? t === e : t == e;
-        const f = j(o, D, x, s);
-        if (f.shouldExit)
-          return f.newMatch;
-        s = f.newMatch;
+        B(e) ? o = !!e(t, r) : j(e) && f(t) ? o = t ? e.test(t) : !1 : R && f(e) && f(t) ? o = t.includes(e) : o = v ? t === e : t == e;
+        const l = k(o, x, A, s);
+        if (l.shouldExit)
+          return l.newMatch;
+        s = l.newMatch;
       }
       return s;
     };
     if (g) {
-      const r = (n, e = 1) => {
-        const t = d > 0 && e > d, o = !t && N(n), f = t ? void 0 : n[u], l = [];
-        if (S(f))
-          for (const c of f) {
-            const O = r(c, e + 1);
+      const r = (i, c = 1) => {
+        const e = d > 0 && c > d, t = !e && N(i), o = e ? void 0 : i[a], l = [];
+        if (E(o))
+          for (const p of o) {
+            const O = r(p, c + 1);
             O && l.push(O);
           }
-        if (o || l.length > 0) {
-          const c = { ...n };
-          return l.length > 0 && (c[u] = l), c;
+        if (t || l.length > 0) {
+          const p = { ...i };
+          return l.length > 0 && (p[a] = l), p;
         }
         return null;
       }, s = [];
-      for (const n of i) {
-        const e = r(n, 1);
-        e && s.push(e);
+      for (const i of n) {
+        const c = r(i, 1);
+        c && s.push(c);
       }
       return s;
     } else
@@ -96,19 +89,19 @@ function P(i, a, m = {}) {
         if (!r) continue;
         if (N(r))
           if (M)
-            A.push(r);
+            F.push(r);
           else
             return r;
-        const s = r[u];
-        if (S(s))
+        const s = r[a];
+        if (E(s))
           if (y)
             h.push(...s);
           else
-            for (let n = s.length - 1; n >= 0; n--)
-              h.push(s[n]);
+            for (let i = s.length - 1; i >= 0; i--)
+              h.push(s[i]);
       }
   }
-  return M ? A : null;
+  return M ? F : null;
 }
 export {
   P as default

package/tree.js

@@ -1,13 +1,17 @@
+/* 2025-11-03 10:27:31 */
+import "lodash/castArray";
+import "lodash/isArray";
+import "lodash/isUndefined";
 import { default as a } from "./tree/search/index.js";
-import { getItemBy as y, findNodeBy as m, getChildWithParentBy as B, getItemBy as g, getItemBy2 as o, getItemBy3 as I, getItemByID as d, getLabelFromDictionaryByValue as f } from "./tree/index.js";
+import { getItemBy as i, findNodeBy as B, getChildWithParentBy as d, getItemBy as g, getItemBy2 as f, findNodeBy as I, getItemByID as l, getLabelFromDictionaryByValue as p } from "./tree/index.js";
 export {
-  y as default,
-  m as findNodeBy,
-  B as getChildWithParentBy,
+  i as default,
+  B as findNodeBy,
+  d as getChildWithParentBy,
   g as getItemBy,
-  o as getItemBy2,
+  f as getItemBy2,
   I as getItemBy3,
-  d as getItemByID,
-  f as getLabelFromDictionaryByValue,
+  l as getItemByID,
+  p as getLabelFromDictionaryByValue,
   a as searchTree
 };

package/tween/index.js

@@ -0,0 +1,8 @@
+/* 2025-11-03 10:27:31 */
+import * as e from "./src/easing.js";
+import { default as r, default as t } from "./src/tween.js";
+export {
+  r as Tween,
+  t as default,
+  e as easing
+};

package/tween/src/easing.js

@@ -0,0 +1,62 @@
+/* 2025-11-03 10:27:31 */
+function u(n) {
+  return function(t) {
+    return Math.pow(t, n);
+  };
+}
+function r(n) {
+  return function(t) {
+    return 1 - Math.abs(Math.pow(t - 1, n));
+  };
+}
+function c(n) {
+  return function(t) {
+    return t < 0.5 ? u(n)(t * 2) / 2 : r(n)(t * 2 - 1) / 2 + 0.5;
+  };
+}
+function s(n) {
+  return n;
+}
+const a = u(2), I = r(2), f = c(2), O = u(3), h = r(3), M = c(3), p = u(4), q = r(4), b = c(4), P = u(5), d = r(5), l = c(5);
+function y(n) {
+  return 1 + Math.sin(Math.PI / 2 * n - Math.PI / 2);
+}
+function B(n) {
+  return Math.sin(Math.PI / 2 * n);
+}
+function w(n) {
+  return (1 + Math.sin(Math.PI * n - Math.PI / 2)) / 2;
+}
+function e(n) {
+  return n < 1 / 2.75 ? 7.5625 * n * n : n < 2 / 2.75 ? (n -= 1.5 / 2.75, 7.5625 * n * n + 0.75) : n < 2.5 / 2.75 ? (n -= 2.25 / 2.75, 7.5625 * n * n + 0.9375) : (n -= 2.625 / 2.75, 7.5625 * n * n + 0.984375);
+}
+function o(n) {
+  return 1 - e(1 - n);
+}
+function x(n) {
+  return n < 0.5 ? o(n * 2) * 0.5 : e(n * 2 - 1) * 0.5 + 0.5;
+}
+export {
+  o as bounceIn,
+  x as bounceInOut,
+  e as bounceOut,
+  O as cubicIn,
+  M as cubicInOut,
+  h as cubicOut,
+  u as easeInBy,
+  c as easeInOutBy,
+  r as easeOutBy,
+  s as linear,
+  a as quadIn,
+  f as quadInOut,
+  I as quadOut,
+  p as quartIn,
+  b as quartInOut,
+  q as quartOut,
+  P as quintIn,
+  l as quintInOut,
+  d as quintOut,
+  y as sineIn,
+  w as sineInOut,
+  B as sineOut
+};

package/tween/src/tween.js

@@ -0,0 +1,46 @@
+/* 2025-11-03 10:27:31 */
+import n from "lodash/isFunction.js";
+import d from "lodash/isString.js";
+import * as l from "./easing.js";
+import { linear as u } from "./easing.js";
+class F {
+  constructor(i) {
+    const {
+      from: s,
+      to: e,
+      duration: a = 500,
+      delay: r = 0,
+      easing: h,
+      onStart: o,
+      onUpdate: f = function() {
+      },
+      onFinish: m
+    } = i;
+    for (const t in s)
+      e[t] === void 0 && (e[t] = s[t]);
+    for (const t in e)
+      s[t] === void 0 && (s[t] = e[t]);
+    this.from = s, this.to = e, this.duration = a, this.delay = r, n(h) ? this.easing = h : d(h) && (this.easing = l[h]), this.easing ||= u, this.onStart = o, this.onUpdate = f, this.onFinish = m, this.startTime = Date.now() + this.delay, this.started = !1, this.finished = !1, this.timer = null, this.keys = {};
+  }
+  update() {
+    if (this.time = Date.now(), !(this.time < this.startTime) && !this.finished) {
+      this.elapsed = this.time - this.startTime, this.elapsed = Math.min(this.elapsed, this.duration);
+      for (const i in this.to)
+        this.keys[i] = this.from[i] + (this.to[i] - this.from[i]) * this.easing(this.elapsed / this.duration);
+      this.started || (n(this.onStart) && this.onStart(this.keys), this.started = !0), n(this.onUpdate) && this.onUpdate(this.keys), this.elapsed === this.duration && !this.finished && (this.finished = !0, n(this.onFinish) && this.onFinish(this.keys));
+    }
+  }
+  start() {
+    this.startTime = Date.now() + this.delay, this.started = !1, this.finished = !1;
+    const i = () => {
+      this.update(), this.finished ? this.timer && (cancelAnimationFrame(this.timer), this.timer = null) : this.timer = requestAnimationFrame(i);
+    };
+    this.timer = requestAnimationFrame(i);
+  }
+  stop() {
+    this.timer && (cancelAnimationFrame(this.timer), this.timer = null), this.finished = !0;
+  }
+}
+export {
+  F as default
+};

package/tween.js

@@ -0,0 +1,8 @@
+/* 2025-11-03 10:27:31 */
+import * as e from "./tween/src/easing.js";
+import { default as r, default as t } from "./tween/src/tween.js";
+export {
+  r as Tween,
+  t as default,
+  e as easing
+};

package/types/date/convertToDuration.d.ts

@@ -0,0 +1,2 @@
+export default convertToDurationBasedOnTimeUnits;
+declare function convertToDurationBasedOnTimeUnits(duration: any, unit: any): string;

package/types/date/index.d.ts

@@ -1,4 +1,4 @@
-export function convertToDurationBasedOnTimeUnits(duration: any, unit: any): string;
 export function dateFormat(date: any, template: any): any;
 export { default as convertTime } from "./convertTime";
-export { dateFormat as dayjsFormat };
+import convertToDurationBasedOnTimeUnits from './convertToDuration';
+export { convertToDurationBasedOnTimeUnits, dateFormat as dayjsFormat };

package/types/dom-helpers/activeElement.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the actively focused element safely.
+ *
+ * @param doc the document to check
+ */
+export default function activeElement(doc?: Document): Element | null;

package/types/dom-helpers/addClass.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Adds a CSS class to a given element.
+ *
+ * @param element the element
+ * @param className the CSS class name
+ */
+export default function addClass(element: Element | SVGElement, className: string): void;

package/types/dom-helpers/addEventListener.d.ts

@@ -0,0 +1,16 @@
+export declare let optionsSupported: boolean;
+export declare let onceSupported: boolean;
+export type EventHandler<K extends keyof HTMLElementEventMap> = (this: HTMLElement, event: HTMLElementEventMap[K]) => any;
+export type TaggedEventHandler<K extends keyof HTMLElementEventMap> = EventHandler<K> & {
+    __once?: EventHandler<K>;
+};
+/**
+ * An `addEventListener` ponyfill, supports the `once` option
+ *
+ * @param node the element
+ * @param eventName the event name
+ * @param handle the handler
+ * @param options event options
+ */
+declare function addEventListener<K extends keyof HTMLElementEventMap>(node: HTMLElement, eventName: K, handler: TaggedEventHandler<K>, options?: boolean | AddEventListenerOptions): void;
+export default addEventListener;

package/types/dom-helpers/animate.d.ts

@@ -0,0 +1,19 @@
+import { EventHandler } from './addEventListener';
+import { TransformValue } from './isTransform';
+import { Property } from './types';
+type AnimateProperties = Record<Property | TransformValue, string>;
+interface Options {
+    node: HTMLElement;
+    properties: AnimateProperties;
+    duration?: number;
+    easing?: string;
+    callback?: EventHandler<'transitionend'>;
+}
+interface Cancel {
+    cancel(): void;
+}
+declare function animate(options: Options): Cancel;
+declare function animate(node: HTMLElement, properties: AnimateProperties, duration: number): Cancel;
+declare function animate(node: HTMLElement, properties: AnimateProperties, duration: number, callback: EventHandler<'transitionend'>): Cancel;
+declare function animate(node: HTMLElement, properties: AnimateProperties, duration: number, easing: string, callback: EventHandler<'transitionend'>): Cancel;
+export default animate;

package/types/dom-helpers/animationFrame.d.ts

@@ -0,0 +1,2 @@
+export declare const cancel: (id: number) => void;
+export declare const request: typeof requestAnimationFrame;

package/types/dom-helpers/attribute.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Gets or sets an attribute of a given element.
+ *
+ * @param node the element
+ * @param attr the attribute to get or set
+ * @param val the attribute value
+ */
+export default function attribute(node: Element | null, attr: string, val?: string | boolean | null): string | null | undefined;

package/types/dom-helpers/camelize.d.ts

@@ -0,0 +1 @@
+export default function camelize(string: string): string;

package/types/dom-helpers/camelizeStyle.d.ts

@@ -0,0 +1,2 @@
+import { CamelProperty, Property } from './types';
+export default function camelizeStyleName<T extends string = Property>(string: T): CamelProperty;

package/types/dom-helpers/canUseDOM.d.ts

@@ -0,0 +1,2 @@
+declare const _default: boolean;
+export default _default;

package/types/dom-helpers/childElements.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collects all child elements of an element.
+ *
+ * @param node the element
+ */
+export default function childElements(node: Element | null): Element[];

package/types/dom-helpers/childNodes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collects all child nodes of an element.
+ *
+ * @param node the node
+ */
+export default function childNodes(node: Element | null): Node[];

package/types/dom-helpers/clear.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Removes all child nodes from a given node.
+ *
+ * @param node the node to clear
+ */
+export default function clear(node: Node | null): Node | null;

package/types/dom-helpers/closest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns the closest parent element that matches a given selector.
+ *
+ * @param node the reference element
+ * @param selector the selector to match
+ * @param stopAt stop traversing when this element is found
+ */
+export default function closest(node: Element, selector: string, stopAt?: Element): Element | null;

package/types/dom-helpers/collectElements.d.ts

@@ -0,0 +1,3 @@
+type TraverseDirection = 'parentElement' | 'previousElementSibling' | 'nextElementSibling';
+export default function collectElements(node: Element | null, direction: TraverseDirection): Element[];
+export {};

package/types/dom-helpers/collectSiblings.d.ts

@@ -0,0 +1 @@
+export default function collectSiblings(node: Element | null, refNode?: Element | null, selector?: string | null): Element[];

package/types/dom-helpers/contains.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if an element contains another given element.
+ *
+ * @param context the context element
+ * @param node the element to check
+ */
+export default function contains(context: Element, node: Element): boolean | undefined;

package/types/dom-helpers/css.d.ts

@@ -0,0 +1,3 @@
+import { Property } from './types';
+declare function style<T extends Property>(node: HTMLElement, property: T | Record<Property, string | number>): string | undefined;
+export default style;

package/types/dom-helpers/filterEventHandler.d.ts

@@ -0,0 +1,2 @@
+import { EventHandler } from './addEventListener';
+export default function filterEvents<K extends keyof HTMLElementEventMap>(selector: string, handler: EventHandler<K>): EventHandler<K>;

package/types/dom-helpers/getComputedStyle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns one or all computed style properties of an element.
+ *
+ * @param node the element
+ * @param psuedoElement the style property
+ */
+export default function getComputedStyle(node: HTMLElement, psuedoElement?: string): CSSStyleDeclaration;

package/types/dom-helpers/getScrollAccessor.d.ts

@@ -0,0 +1 @@
+export default function getscrollAccessor(offset: 'pageXOffset' | 'pageYOffset'): (node: Element, val?: number) => number | undefined;

package/types/dom-helpers/hasClass.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if a given element has a CSS class.
+ *
+ * @param element the element
+ * @param className the CSS class name
+ */
+export default function hasClass(element: Element | SVGElement, className: string): boolean;