@unicom-cloud/utils 0.1.12 → 0.1.13

package/tree/search/index.js

@@ -0,0 +1,90 @@
+import "../../is/index.js";
+import A from "lodash/isArray";
+import z from "lodash/isObjectLike";
+import w from "lodash/isString";
+import T from "lodash/isFunction";
+function v(r, l, a, f) {
+  return l && r ? { shouldExit: !0, newMatch: !0 } : a && !r ? { shouldExit: !0, newMatch: !1 } : { shouldExit: !1, newMatch: f || r };
+}
+function q(r, l, a = {}) {
+  if (!A(r)) throw new TypeError("参数treeData必须是一个数组");
+  if (!z(l)) throw new TypeError("参数searchCondition必须是一个对象");
+  const f = {
+    strategy: "BFS",
+    childrenKey: "children",
+    strict: !1,
+    fuzzyMatch: !1,
+    returnAllMatches: !1,
+    caseSensitive: !1,
+    allowEmptyString: !1,
+    matchMode: "AND",
+    ...a
+    // 用户配置覆盖默认值
+  }, {
+    strategy: p,
+    childrenKey: S,
+    strict: x,
+    fuzzyMatch: O,
+    returnAllMatches: y,
+    caseSensitive: m,
+    allowEmptyString: B,
+    matchMode: E
+  } = f, M = E === "OR", g = E === "AND", h = p === "BFS";
+  if (!(h || p === "DFS")) throw new Error('配置 strategy 必须是 "BFS" 或 "DFS"');
+  if (!(M || g)) throw new Error('配置 matchMode 必须是 "AND" 或 "OR"');
+  if (!w(S)) throw new TypeError("配置 childrenKey 必须是字符串");
+  const c = [...r], F = [], D = Object.entries(l);
+  if (D.length) {
+    const N = (s) => {
+      let t = !1;
+      for (const [n, e] of D) {
+        const i = s[n];
+        if (e === "" && !B)
+          continue;
+        let o = !1;
+        try {
+          if (e instanceof RegExp)
+            o = w(i) ? e.test(i) : !1;
+          else if (T(e))
+            o = !!e(i);
+          else if (O && w(e)) {
+            const d = String(i), R = m ? e : e.toLowerCase();
+            o = (m ? d : d.toLowerCase()).includes(R);
+          } else
+            o = x ? i === e : i == e;
+        } catch {
+          o = !1;
+        }
+        const u = v(o, M, g, t);
+        if (u.shouldExit)
+          return u.newMatch;
+        t = u.newMatch;
+      }
+      return t;
+    };
+    for (; c.length > 0; ) {
+      const s = h ? c.shift() : c.pop();
+      if (!s) continue;
+      try {
+        if (N(s))
+          if (y)
+            F.push(s);
+          else
+            return s;
+      } catch {
+        continue;
+      }
+      const t = s[S];
+      if (A(t))
+        if (h)
+          c.push(...t);
+        else
+          for (let n = t.length - 1; n >= 0; n--)
+            c.push(t[n]);
+    }
+  }
+  return y ? F : null;
+}
+export {
+  q as default
+};

package/tree.js

@@ -1,4 +1,4 @@
-import { default as a } from "./tree/searchTree.js";
+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";
 export {
   y as default,

package/types/filesize/src/constants.d.ts

@@ -1,24 +1,24 @@
-export const ARRAY: "array";
+export const INVALID_NUMBER: "Invalid number";
+export const INVALID_ROUND: "Invalid rounding method";
+export const IEC: "iec";
+export const JEDEC: "jedec";
+export const SI: "si";
 export const BIT: "bit";
 export const BITS: "bits";
 export const BYTE: "byte";
 export const BYTES: "bytes";
-export const EMPTY: "";
-export const EXPONENT: "exponent";
+export const SI_KBIT: "kbit";
+export const SI_KBYTE: "kB";
+export const ARRAY: "array";
 export const FUNCTION: "function";
-export const IEC: "iec";
-export const INVALID_NUMBER: "Invalid number";
-export const INVALID_ROUND: "Invalid rounding method";
-export const JEDEC: "jedec";
 export const OBJECT: "object";
-export const PERIOD: ".";
+export const STRING: "string";
+export const EXPONENT: "exponent";
 export const ROUND: "round";
+export const EMPTY: "";
+export const PERIOD: ".";
 export const S: "s";
-export const SI: "si";
-export const SI_KBIT: "kbit";
-export const SI_KBYTE: "kB";
 export const SPACE: " ";
-export const STRING: "string";
 export const ZERO: "0";
 export namespace STRINGS {
     namespace symbol {

package/types/filesize/src/filesize.d.ts

@@ -1,47 +1,88 @@
-export function filesize(arg: any, { bits, pad, base, round, locale, localeOptions, separator, spacer, symbols, standard, output, fullform, fullforms, exponent, roundingMethod, precision, }?: {
+/**
+ * Converts a file size in bytes to a human-readable string with appropriate units
+ * @param {number|string|bigint} arg - The file size in bytes to convert
+ * @param {Object} [options={}] - Configuration options for formatting
+ * @param {boolean} [options.bits=false] - If true, calculates bits instead of bytes
+ * @param {boolean} [options.pad=false] - If true, pads decimal places to match round parameter
+ * @param {number} [options.base=-1] - Number base (2 for binary, 10 for decimal, -1 for auto)
+ * @param {number} [options.round=2] - Number of decimal places to round to
+ * @param {string|boolean} [options.locale=""] - Locale for number formatting, true for system locale
+ * @param {Object} [options.localeOptions={}] - Additional options for locale formatting
+ * @param {string} [options.separator=""] - Custom decimal separator
+ * @param {string} [options.spacer=" "] - String to separate value and unit
+ * @param {Object} [options.symbols={}] - Custom unit symbols
+ * @param {string} [options.standard=""] - Unit standard to use (SI, IEC, JEDEC)
+ * @param {string} [options.output="string"] - Output format: "string", "array", "object", or "exponent"
+ * @param {boolean} [options.fullform=false] - If true, uses full unit names instead of abbreviations
+ * @param {Array} [options.fullforms=[]] - Custom full unit names
+ * @param {number} [options.exponent=-1] - Force specific exponent (-1 for auto)
+ * @param {string} [options.roundingMethod="round"] - Math rounding method to use
+ * @param {number} [options.precision=0] - Number of significant digits (0 for auto)
+ * @returns {string|Array|Object|number} Formatted file size based on output option
+ * @throws {TypeError} When arg is not a valid number or roundingMethod is invalid
+ * @example
+ * filesize(1024) // "1 KB"
+ * filesize(1024, {bits: true}) // "8 Kb"
+ * filesize(1024, {output: "object"}) // {value: 1, symbol: "KB", exponent: 1, unit: "KB"}
+ */
+export function filesize(arg: number | string | bigint, { bits, pad, base, round, locale, localeOptions, separator, spacer, symbols, standard, output, fullform, fullforms, exponent, roundingMethod, precision, }?: {
     bits?: boolean | undefined;
     pad?: boolean | undefined;
     base?: number | undefined;
     round?: number | undefined;
-    locale?: string | undefined;
-    localeOptions?: {} | undefined;
+    locale?: string | boolean | undefined;
+    localeOptions?: Object | undefined;
     separator?: string | undefined;
     spacer?: string | undefined;
-    symbols?: {} | undefined;
+    symbols?: Object | undefined;
     standard?: string | undefined;
     output?: string | undefined;
     fullform?: boolean | undefined;
-    fullforms?: never[] | undefined;
+    fullforms?: any[] | undefined;
     exponent?: number | undefined;
     roundingMethod?: string | undefined;
     precision?: number | undefined;
-}): string | number | any[] | {
-    value: any;
-    symbol: any;
-    exponent: number;
-    unit: string;
-};
+}): string | any[] | Object | number;
+/**
+ * Creates a partially applied version of filesize with preset options
+ * @param {Object} [options={}] - Default options to apply to the returned function
+ * @param {boolean} [options.bits=false] - If true, calculates bits instead of bytes
+ * @param {boolean} [options.pad=false] - If true, pads decimal places to match round parameter
+ * @param {number} [options.base=-1] - Number base (2 for binary, 10 for decimal, -1 for auto)
+ * @param {number} [options.round=2] - Number of decimal places to round to
+ * @param {string|boolean} [options.locale=""] - Locale for number formatting, true for system locale
+ * @param {Object} [options.localeOptions={}] - Additional options for locale formatting
+ * @param {string} [options.separator=""] - Custom decimal separator
+ * @param {string} [options.spacer=" "] - String to separate value and unit
+ * @param {Object} [options.symbols={}] - Custom unit symbols
+ * @param {string} [options.standard=""] - Unit standard to use (SI, IEC, JEDEC)
+ * @param {string} [options.output="string"] - Output format: "string", "array", "object", or "exponent"
+ * @param {boolean} [options.fullform=false] - If true, uses full unit names instead of abbreviations
+ * @param {Array} [options.fullforms=[]] - Custom full unit names
+ * @param {number} [options.exponent=-1] - Force specific exponent (-1 for auto)
+ * @param {string} [options.roundingMethod="round"] - Math rounding method to use
+ * @param {number} [options.precision=0] - Number of significant digits (0 for auto)
+ * @returns {Function} A function that takes a file size and returns formatted output
+ * @example
+ * const formatBytes = partial({round: 1, standard: "IEC"});
+ * formatBytes(1024) // "1.0 KiB"
+ * formatBytes(2048) // "2.0 KiB"
+ */
 export function partial({ bits, pad, base, round, locale, localeOptions, separator, spacer, symbols, standard, output, fullform, fullforms, exponent, roundingMethod, precision, }?: {
     bits?: boolean | undefined;
     pad?: boolean | undefined;
     base?: number | undefined;
     round?: number | undefined;
-    locale?: string | undefined;
-    localeOptions?: {} | undefined;
+    locale?: string | boolean | undefined;
+    localeOptions?: Object | undefined;
     separator?: string | undefined;
     spacer?: string | undefined;
-    symbols?: {} | undefined;
+    symbols?: Object | undefined;
     standard?: string | undefined;
     output?: string | undefined;
     fullform?: boolean | undefined;
-    fullforms?: never[] | undefined;
+    fullforms?: any[] | undefined;
     exponent?: number | undefined;
     roundingMethod?: string | undefined;
     precision?: number | undefined;
-}): (arg: any) => string | number | any[] | {
-    value: any;
-    symbol: any;
-    exponent: number;
-    unit: string;
-};
-export default filesize;
+}): Function;

package/types/snapdom/src/core/cache.d.ts

@@ -1,11 +1,17 @@
-/**
- * Caches for images, backgrounds, resources, and computed styles used during DOM capture.
- * @module cache
- */
-export const imageCache: Map<any, any>;
-export const bgCache: Map<any, any>;
-export const resourceCache: Map<any, any>;
-export const defaultStylesCache: Map<any, any>;
-export const baseCSSCache: Map<any, any>;
-export const computedStyleCache: WeakMap<WeakKey, any>;
-export const processedFontURLs: Set<any>;
+export namespace cache {
+    export let image: Map<any, any>;
+    export let background: Map<any, any>;
+    export let resource: Map<any, any>;
+    export let defaultStyle: Map<any, any>;
+    export let baseStyle: Map<any, any>;
+    export let computedStyle: WeakMap<WeakKey, any>;
+    export let font: Set<any>;
+    export let snapshot: WeakMap<WeakKey, any>;
+    export let snapshotKey: Map<any, any>;
+    export let preStyleMap: Map<any, any>;
+    export let preStyle: WeakMap<WeakKey, any>;
+    export let preNodeMap: Map<any, any>;
+    export { resetCache as reset };
+}
+declare function resetCache(): void;
+export {};

package/types/snapdom/src/core/capture.d.ts

@@ -7,6 +7,8 @@
  * @param {boolean} [options.embedFonts=false] - Whether to embed custom fonts
  * @param {boolean} [options.fast=true] - Whether to skip idle delay for faster results
  * @param {number} [options.scale=1] - Output scale multiplier
+ * @param {string[]} [options.exclude] - CSS selectors for elements to exclude
+ * @param {Function} [options.filter] - Custom filter function
  * @returns {Promise<string>} Promise that resolves to an SVG data URL
  */
 export function captureDOM(element: Element, options?: {
@@ -14,4 +16,6 @@ export function captureDOM(element: Element, options?: {
     embedFonts?: boolean | undefined;
     fast?: boolean | undefined;
     scale?: number | undefined;
+    exclude?: string[] | undefined;
+    filter?: Function | undefined;
 }): Promise<string>;

package/types/snapdom/src/core/clone.d.ts

@@ -2,10 +2,9 @@
  * Creates a deep clone of a DOM node, including styles, shadow DOM, and special handling for excluded/placeholder/canvas nodes.
  *
  * @param {Node} node - Node to clone
- * @param {Map} styleMap - Map to store element-to-style-key mappings
- * @param {WeakMap} styleCache - Cache of computed styles
- * @param {WeakMap} nodeMap - Map to track original-to-clone node relationships
  * @param {boolean} compress - Whether to compress style keys
- * @returns {Node|null} Cloned node with styles and shadow DOM content, or null for empty text nodes
+ * @param {Object} [options={}] - Capture options including exclude and filter
+ * @param {Node} [originalRoot] - Original root element being captured
+ * @returns {Node|null} Cloned node with styles and shadow DOM content, or null for empty text nodes or filtered elements
  */
-export function deepClone(node: Node, styleMap: Map<any, any>, styleCache: WeakMap<any, any>, nodeMap: WeakMap<any, any>, compress: boolean): Node | null;
+export function deepClone(node: Node, compress: boolean, options?: Object, originalRoot?: Node): Node | null;

package/types/snapdom/src/core/prepare.d.ts

@@ -3,6 +3,13 @@
  *
  * @param {Element} element - Element to clone
  * @param {boolean} [compress=false] - Whether to compress style keys
+ * @param {boolean} [embedFonts=false] - Whether to embed custom fonts
+ * @param {Object} [options={}] - Capture options
+ * @param {string[]} [options.exclude] - CSS selectors for elements to exclude
+ * @param {Function} [options.filter] - Custom filter function
  * @returns {Promise<Object>} Object containing the clone, generated CSS, and style cache
  */
-export function prepareClone(element: Element, compress?: boolean, embedFonts?: boolean, useProxy?: string): Promise<Object>;
+export function prepareClone(element: Element, compress?: boolean, embedFonts?: boolean, options?: {
+    exclude?: string[] | undefined;
+    filter?: Function | undefined;
+}): Promise<Object>;

package/types/snapdom/src/modules/background.d.ts

@@ -3,8 +3,7 @@
  *
  * @param {Element} source - Original element
  * @param {Element} clone - Cloned element
- * @param {WeakMap} styleCache - Cache of computed styles
  * @param {Object} [options={}] - Options for image processing
  * @returns {Promise<void>} Promise that resolves when all background images are processed
  */
-export function inlineBackgroundImages(source: Element, clone: Element, styleCache: WeakMap<any, any>, options?: Object): Promise<void>;
+export function inlineBackgroundImages(source: Element, clone: Element, options?: Object): Promise<void>;

package/types/snapdom/src/modules/pseudo.d.ts

@@ -3,10 +3,8 @@
  *
  * @param {Element} source - Original element
  * @param {Element} clone - Cloned element
- * @param {Map} styleMap - Map to store element-to-style-key mappings
- * @param {WeakMap} styleCache - Cache of computed styles
  * @param {boolean} compress - Whether to compress style keys
  * @param {boolean} embedFonts - Whether to embed icon fonts as images
  * @returns {Promise} Promise that resolves when all pseudo-elements are processed
  */
-export function inlinePseudoElements(source: Element, clone: Element, styleMap: Map<any, any>, styleCache: WeakMap<any, any>, compress: boolean, embedFonts: boolean | undefined, useProxy: any): Promise<any>;
+export function inlinePseudoElements(source: Element, clone: Element, compress: boolean, embedFonts: boolean | undefined, useProxy: any): Promise<any>;

package/types/snapdom/src/modules/styles.d.ts

@@ -1 +1 @@
-export function inlineAllStyles(source: any, clone: any, styleMap: any, cache: any, compress: any): void;
+export function inlineAllStyles(source: any, clone: any, compress: any): void;

package/types/snapdom/src/utils/cssTools.d.ts

@@ -32,7 +32,6 @@ export function generateDedupedBaseCSS(usedTagNames: string[]): string;
 /**
  * Generates CSS classes from a style map.
  *
- * @param {Map} styleMap - Map of elements to style keys
  * @returns {Map} Map of style keys to class names
  */
-export function generateCSSClasses(styleMap: Map<any, any>): Map<any, any>;
+export function generateCSSClasses(): Map<any, any>;

package/types/tree/index.d.ts

@@ -6,4 +6,4 @@ export function getLabelFromDictionaryByValue(a: any, value: any, 保底?: boole
 export function getChildWithParentBy(root: any, key: any, value: any, childrenKey?: string): null | undefined;
 export function getItemBy2(root: any, key: any, value: any, childrenKey?: string): any;
 export default getItemBy;
-export { default as searchTree } from "./searchTree";
+export { default as searchTree } from "./search";

package/types/tree/search/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 基础原始类型定义（string/number/boolean/symbol/null/undefined）
+ */
+type Primitive = string | number | boolean | symbol | null | undefined;
+/**
+ * 条件值类型，可以是：
+ * 1. 原始值（Primitive）
+ * 2. 判断函数（接收节点值返回boolean）
+ * 3. 正则表达式
+ * @template T 节点值的泛型类型
+ */
+type ConditionValue<T = unknown> = Primitive | ((value: T) => boolean) | RegExp;
+/**
+ * 树搜索配置选项接口
+ */
+interface SearchOptions {
+    /**
+     * 遍历策略：广度优先(BFS)或深度优先(DFS)
+     * @default 'BFS'
+     */
+    strategy?: 'BFS' | 'DFS';
+    /**
+     * 子节点字段名
+     * @default 'children'
+     */
+    childrenKey?: string;
+    /**
+     * 是否启用严格模式比较（===）
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * 是否启用字符串模糊匹配
+     * @default false
+     */
+    fuzzyMatch?: boolean;
+    /**
+     * 是否返回所有匹配结果（否则返回第一个匹配）
+     * @default false
+     */
+    returnAllMatches?: boolean;
+    /**
+     * 字符串匹配是否区分大小写
+     * @default false
+     */
+    caseSensitive?: boolean;
+    /**
+     * 多条件匹配模式：AND（所有条件需满足）或OR（任一条件满足）
+     * @default 'AND'
+     */
+    matchMode?: 'AND' | 'OR';
+    /**
+     * 字符串匹配是否允许空字符
+     * @default false
+     */
+    allowEmptyString?: boolean;
+}
+/**
+ * 树节点接口定义
+ */
+interface TreeNode {
+    /**
+     * 动态属性（任意键值对）
+     */
+    [key: string]: unknown;
+    /**
+     * 子节点数组（可选）
+     */
+    children?: TreeNode[];
+}
+/**
+ * 高级树搜索函数
+ * @param treeData 要搜索的树数据（必须是数组）
+ * @param searchCondition 搜索条件对象（键值对）
+ * @param options 搜索配置选项
+ * @returns 返回匹配的节点或节点数组（根据returnAllMatches决定）
+ * @throws 当参数不符合要求时抛出TypeError或Error
+ */
+declare function searchTree(treeData: TreeNode[], searchCondition: Record<string, ConditionValue>, options?: SearchOptions): TreeNode | TreeNode[] | null;
+export default searchTree;

package/types/ui-color/index.d.ts

@@ -1,3 +1,27 @@
+export namespace PRIMARY_COLOR_KEY_MAPPING {
+    namespace primary {
+        let label: string;
+        let key: string;
+    }
+    namespace success {
+        let label_1: string;
+        export { label_1 as label };
+        let key_1: string;
+        export { key_1 as key };
+    }
+    namespace warning {
+        let label_2: string;
+        export { label_2 as label };
+        let key_2: string;
+        export { key_2 as key };
+    }
+    namespace danger {
+        let label_3: string;
+        export { label_3 as label };
+        let key_3: string;
+        export { key_3 as key };
+    }
+}
 export { default as compareColorByRange } from "./compareColorByRange";
 export namespace blue {
     namespace name {
@@ -59,11 +83,12 @@ export namespace gray {
     export { value_3 as value };
 }
 export namespace grayPresets {
-    export let key: string;
+    let key_4: string;
+    export { key_4 as key };
     import name_4 = gray.name;
     export { name_4 as name };
-    import primary = gray.value;
-    export { primary };
+    import primary_1 = gray.value;
+    export { primary_1 as primary };
     export let light: TinyColor[];
     export let dark: TinyColor[];
 }