@zcrkey/js-utils 0.0.6 → 0.0.9

package/dist/cjs/{treeUtil.js → tree.js}

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -14,15 +16,24 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/treeUtil.ts
-var treeUtil_exports = {};
-__export(treeUtil_exports, {
+// src/tree.ts
+var tree_exports = {};
+__export(tree_exports, {
   default: () => CrTreeUtil
 });
-module.exports = __toCommonJS(treeUtil_exports);
+module.exports = __toCommonJS(tree_exports);
 var import_lodash = require("lodash");
+var import_util = __toESM(require("./util"));
 var CrTreeUtil = class {
   /**
    * 列表数据转树形数据
@@ -83,24 +94,47 @@ var CrTreeUtil = class {
    * 树形数据转列表数据
    * @param tree
    * @param options
+   * @param options.idField 默认值 id
+   * @param options.parentIdField 默认值 parentId
    * @param options.childrenField 默认值 children
-   * @param options.isCloneDeep 是否需要深拷贝, 默认值为 true
+   * @param options.rootParentValue 根节点的父值，默认值 null
    * @returns
    */
   static treeToList(tree, options) {
-    const { childrenField = "children", isCloneDeep = true } = options || {};
+    const {
+      idField = "id",
+      parentIdField = "parentId",
+      childrenField = "children",
+      rootParentValue = null
+    } = options || {};
     const result = [];
-    const queue = [...tree];
+    const originQueue = (0, import_lodash.cloneDeep)([...tree]);
+    const queue = originQueue.map((node) => ({
+      node,
+      parentId: rootParentValue
+    }));
     while (queue.length) {
-      const node = queue.shift();
+      const { node, parentId } = queue.shift();
+      if (!node || !import_util.default.isObject(node)) {
+        continue;
+      }
       const children = node[childrenField];
+      const nodeId = node[idField];
       const { [childrenField]: _, ...rest } = node;
-      result.push(rest);
-      if (children && children.length) {
-        queue.push(...children);
+      const flatNode = {
+        ...rest,
+        [parentIdField]: parentId
+      };
+      result.push(flatNode);
+      if (children && import_util.default.isArray(children) && children.length > 0) {
+        const childQueue = children.map((childNode) => ({
+          node: childNode,
+          parentId: nodeId
+        }));
+        queue.push(...childQueue);
       }
     }
-    return isCloneDeep ? (0, import_lodash.cloneDeep)(result) : result;
+    return result;
   }
   /**
    * 获取扁平化父数据(包含自身)

package/dist/cjs/util.d.ts

@@ -10,7 +10,7 @@ export default class CrUtil {
      * @param value
      * @returns boolean
      */
-    static isObject<T = any>(value: T): value is T extends object ? (T extends any[] ? never : T) : never;
+    static isObject(value: unknown): value is Record<string | number, unknown>;
     /**
      * 判断是否为空对象
      * @param value
@@ -91,7 +91,7 @@ export default class CrUtil {
      * @param settings.idField 默认值 id
      * @param settings.pidField 默认值 parentId
      * @param settings.childrenField 默认值 children
-     * @deprecated 即将移除，使用 {@link CrObjUtil.listToTree} 替代
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.listToTree} 替代
      * @returns
      */
     static listToTreeData(listData: any[], settings?: {
@@ -108,7 +108,7 @@ export default class CrUtil {
      * @param settings.idField 默认值 id
      * @param settings.pidField 默认值 parentId
      * @param settings.childrenField 默认值 children
-     * @deprecated 即将移除，使用 {@link CrObjUtil.treeToList} 替代
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.treeToList} 替代
      * @returns
      */
     static treeDataToListData(treeData: any[], pid?: string | number, settings?: {
@@ -125,7 +125,7 @@ export default class CrUtil {
      * @param settings.valueField 默认值 value
      * @param settings.idField 默认值 id
      * @param settings.pidField 默认值 parentId
-     * @deprecated 即将移除，使用 {@link CrObjUtil.getFlatParentDatas} 替代
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.getFlatParentDatas} 替代
      * @returns
      */
     static getParentNodes<T, R extends Record<string, any>>(listData: R[], value: number | string, settings?: {
@@ -201,9 +201,21 @@ export default class CrUtil {
      */
     static compareDataDiff(data1: any, data2: any): Record<string, "added" | "removed" | "modified">;
     /**
-     * 格式化为千分位
+     * 格式化为千分位，主要用于展示格式化
      * @param value
      * @returns 12345.6789 => 12,345.6789
      */
     static fmtThousands(value: number | string | undefined): string;
+    /**
+     * 格式化为千分位格式
+     * @param value
+     * @returns
+     */
+    static formatThousands(value?: string | number): string;
+    /**
+     * 解析千分位格式
+     * @param value
+     * @returns
+     */
+    static parseThousands(value?: string | number): string;
 }

package/dist/cjs/util.js

@@ -187,7 +187,7 @@ var CrUtil = class {
    * @param settings.idField 默认值 id
    * @param settings.pidField 默认值 parentId
    * @param settings.childrenField 默认值 children
-   * @deprecated 即将移除，使用 {@link CrObjUtil.listToTree} 替代
+   * @deprecated 即将移除，使用 {@link CrTreeUtil.listToTree} 替代
    * @returns
    */
   static listToTreeData(listData, settings) {
@@ -250,7 +250,7 @@ var CrUtil = class {
    * @param settings.idField 默认值 id
    * @param settings.pidField 默认值 parentId
    * @param settings.childrenField 默认值 children
-   * @deprecated 即将移除，使用 {@link CrObjUtil.treeToList} 替代
+   * @deprecated 即将移除，使用 {@link CrTreeUtil.treeToList} 替代
    * @returns
    */
   static treeDataToListData(treeData, pid = 0, settings) {
@@ -292,7 +292,7 @@ var CrUtil = class {
    * @param settings.valueField 默认值 value
    * @param settings.idField 默认值 id
    * @param settings.pidField 默认值 parentId
-   * @deprecated 即将移除，使用 {@link CrObjUtil.getFlatParentDatas} 替代
+   * @deprecated 即将移除，使用 {@link CrTreeUtil.getFlatParentDatas} 替代
    * @returns
    */
   static getParentNodes(listData, value, settings) {
@@ -557,7 +557,7 @@ var CrUtil = class {
     return diffFieldSet;
   }
   /**
-   * 格式化为千分位
+   * 格式化为千分位，主要用于展示格式化
    * @param value
    * @returns 12345.6789 => 12,345.6789
    */
@@ -569,4 +569,39 @@ var CrUtil = class {
     const formattedInt = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
     return decimalPart ? `${formattedInt}.${decimalPart}` : formattedInt;
   }
+  /**
+   * 格式化为千分位格式
+   * @param value 
+   * @returns 
+   */
+  static formatThousands(value) {
+    if (value == null)
+      return "";
+    const raw = String(value).trim();
+    if (!raw)
+      return "";
+    const hasTrailingDot = raw.endsWith(".");
+    let str = raw.replace(/[^\d.-]/g, "");
+    const sign = str.startsWith("-") ? "-" : "";
+    str = str.replace(/-/g, "");
+    const [intRaw, decRaw = ""] = str.split(".", 2);
+    const intPart = intRaw.replace(/,/g, "").replace(/^0+(?=\d)/, "");
+    const formattedInt = intPart ? intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : "";
+    let result = sign + formattedInt;
+    if (decRaw || hasTrailingDot)
+      result += ".";
+    if (decRaw)
+      result += decRaw;
+    return result;
+  }
+  /**
+   * 解析千分位格式
+   * @param value 
+   * @returns 
+   */
+  static parseThousands(value) {
+    if (value == null)
+      return "";
+    return String(value).trim().replace(/,/g, "").replace(/[^\d.-]/g, "").replace(/(?!^)-/g, "").replace(/(\..*)\./g, "$1");
+  }
 };

package/dist/esm/color.d.ts

@@ -0,0 +1,195 @@
+export default class CrColorUtil {
+    /**
+     * hex 转 rgb 数组 [r,g,b]  r/g/b范围 0-255
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     */
+    static hexToRgb(hex: string): number[];
+    /**
+     * rgb 转 hex 标准格式
+     * @param r 0-255
+     * @param g 0-255
+     * @param b 0-255
+     */
+    static rgbToHex(r: number, g: number, b: number): string;
+    /**
+     * 将 rgb 格式转为 hsv 格式
+     * input: r,g,b in [0,1], out: h in [0,360) and s,v in [0,1]
+     * @param r 0-1
+     * @param g 0-1
+     * @param b 0-1
+     */
+    static rgb2hsv(r: number, g: number, b: number): number[];
+    /**
+     * 将 hsv 格式转为 rgb 格式
+     * input: h in [0,360] and s,v in [0,1] - output: r,g,b in [0,1]
+     * @param h 0-360
+     * @param s 0-1
+     * @param v 0-1
+     */
+    static hsv2rgb(h: number, s: number, v: number): number[];
+    /**
+     * hex 转 rgba 格式字符串 可直接用于css
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param alpha 透明度 0-1  默认1(完全不透明)
+     * @returns 例: rgba(255,255,255,0.5)
+     */
+    static hexToRgba(hex: string, alpha?: number): string;
+    /**
+     * 给hex颜色添加透明度，返回 8位带透明通道的hex格式 #RRGGBBAA (CSS常用)
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param alpha 透明度 0-1  默认1(完全不透明)
+     * @returns 例: #ffffff80  #ff000033
+     */
+    static hexAddAlpha(hex: string, alpha?: number): string;
+    /**
+     * rgba 转 hex 格式
+     * @param r 0-255
+     * @param g 0-255
+     * @param b 0-255
+     */
+    static rgbaToHex(r: number, g: number, b: number): string;
+    /**
+     * hsv 转 hex 十六进制颜色
+     * @param h 色相 0-360
+     * @param s 饱和度 0-1
+     * @param v 明度 0-1
+     */
+    static hsvToHex(h: number, s: number, v: number): string;
+    /**
+     * hex 转 hsv 格式
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @returns [h:0-360, s:0-1, v:0-1]
+     */
+    static hexToHsv(hex: string): number[];
+    /**
+     * 颜色加深处理 - 基于hex颜色
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param level 加深程度 0-1  0不变 1最深(接近黑色)
+     */
+    static darkenColor(hex: string, level: number): string;
+    /**
+     * 颜色减淡/提亮处理 - 基于hex颜色
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param level 减淡程度 0-1  0不变 1最亮(接近白色)
+     */
+    static lightenColor(hex: string, level: number): string;
+    /**
+     * 解析8位带透明的hex #RRGGBBAA 为 普通hex + 透明度
+     * @param hex8 8位带透明的十六进制颜色 例：#ffffff80
+     * @returns { hex: '#ffffff', alpha: 0.5 }
+     */
+    static parseHex8(hex8: string): {
+        hex: string;
+        alpha: number;
+    };
+    /**
+     * rgb 数组 转 rgb/rgba 字符串
+     * @param rgb [r,g,b] 0-255
+     * @param alpha 透明度0-1 传则返回rgba，不传返回rgb
+     */
+    static rgbToStr(rgb: number[], alpha?: number): string;
+    /**
+     * Hex颜色字符串 转 十进制数值（6位纯颜色值，无透明通道，专用于颜色运算）
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @returns 十进制数值 例：#ff0000 → 16711680，非法入参返回 0
+     */
+    static hexToNumber(hex: string): number;
+    /**
+     * 十进制数值 转回 Hex颜色字符串（无透明通道 标准6位）
+     * @param num 十进制数值 例：16711680 → #ff0000
+     * @returns 标准6位十六进制颜色 #RRGGBB 格式
+     */
+    static numberToHex(num: number): string;
+    /**
+     * ARGB颜色字符串 转 十进制数值（8位带透明通道，专用于带透明的颜色运算）
+     * @param argb 支持 #AARRGGBB / AARRGGBB 格式 例：#80FFFFFF、80FFFFFF
+     * @returns 十进制数值 例：#80FFFFFF → 2147483647，非法入参/格式错误返回 0
+     */
+    static argbToNumber(argb: string): number;
+    /**
+     * 十进制数值 转回 ARGB颜色字符串（8位带透明通道，标准#AARRGGBB格式）
+     * @param num 十进制数值 例：2147483647 → #80ffffff
+     * @returns 标准ARGB颜色字符串 #AARRGGBB 小写格式
+     */
+    static numberToArgb(num: number): string;
+    /**
+     * 生成随机Hex颜色
+     * @param withSharp 是否带#号 默认为true
+     * @returns 随机hex颜色
+     */
+    static randomHexColor(withSharp?: boolean): string;
+    /**
+     * 反色处理 - 取颜色的补色（比如黑色→白色，白色→黑色）
+     * @param hex 目标颜色
+     * @returns 反色hex
+     */
+    static reverseColor(hex: string): string;
+    /**
+     * 校验是否为合法的hex颜色
+     * @param hex 待校验的颜色字符串
+     * @returns true=合法 false=不合法
+     */
+    static isHexColor(hex: string): boolean;
+    /**
+     * 标准6位Hex颜色 转 ARGB 8位颜色格式 ( 核心：ARGB格式是 #AARRGGBB )
+     * @param hex 6位标准hex 支持 #ffffff / ffffff / #fff / fff
+     * @param alpha 透明度 0~1  默认 1 (完全不透明)
+     * @returns 8位ARGB格式颜色 例：#80FFFFFF  半透明白色
+     */
+    static hexToArgb(hex: string, alpha?: number): string;
+    /**
+     * ARGB 8位颜色格式 转回 标准6位Hex颜色 + 独立的透明度值 ( 反向解析 )
+     * @param argb 8位ARGB格式颜色 必须是 #AARRGGBB 格式 例：#80FFFFFF
+     * @returns { hex: '#ffffff', alpha: 0.5 } 标准hex + 0~1的透明度
+     */
+    static argbToHex(argb: string): {
+        hex: string;
+        alpha: number;
+    };
+    /**
+     * ARGB格式(#AARRGGBB) 转 RRGGBBAA格式(#RRGGBBAA)
+     * @param argb #AARRGGBB
+     * @returns #RRGGBBAA
+     */
+    static argbToRgbaHex(argb: string): string;
+    /**
+     * RRGGBBAA格式(#RRGGBBAA) 转 ARGB格式(#AARRGGBB)
+     * @param rgbaHex #RRGGBBAA
+     * @returns #AARRGGBB
+     */
+    static rgbaHexToArgb(rgbaHex: string): string;
+    /**
+     * 调整颜色饱和度
+     * @param hex 目标颜色
+     * @param level 调整程度 0-2  1=不变  <1=降低饱和度  >1=提高饱和度
+     * @returns 调整后的hex颜色
+     */
+    static adjustSaturation(hex: string, level: number): string;
+    /**
+     * 调整颜色明度
+     * @param hex 目标颜色
+     * @param level 调整程度 0-2  1=不变  <1=降低明度  >1=提高明度
+     * @returns 调整后的hex颜色
+     */
+    static adjustBrightness(hex: string, level: number): string;
+    /**
+     * 普通6位Hex+透明度 → 直接返回ARGB对应的十进制数值
+     * @param hex 支持 #fff / #ffffff 格式
+     * @param alpha 透明度 0-1
+     * @returns ARGB十进制数值
+     */
+    static hexAlphaToArgbNumber(hex: string, alpha?: number): number;
+    /**
+     * ARGB十进制数值 → 解析出 普通Hex + 0-1透明度
+     * @param num ARGB十进制数值
+     * @returns { hex: '#ffffff', alpha: 0.5 }
+     */
+    static argbNumberToHexAlpha(num: number): {
+        hex: string;
+        alpha: number;
+    };
+    /**
+     * 补零成两位字符
+     */
+    private static twoDigits;
+}