@zcrkey/js-utils 0.0.7 → 0.0.10

package/dist/esm/color.js

@@ -17,12 +17,12 @@ var CrColorUtil = /*#__PURE__*/function () {
   _createClass(CrColorUtil, null, [{
     key: "hexToRgb",
     value:
-    /**
-     * hex 转 rgb 数组 [r,g,b]  r/g/b范围 0-255
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+    /**
+     * hex 转 rgb 数组 [r,g,b]  r/g/b范围 0-255
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
      */
     function hexToRgb(hex) {
-      var hexVal = hex.replace("#", "");
+      var hexVal = hex.replace('#', '');
       if (hexVal.length === 3) {
         hexVal = hexVal.split('').map(function (c) {
           return c + c;
@@ -35,11 +35,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return [r, g, b];
     }
 
-    /**
-     * rgb 转 hex 标准格式
-     * @param r 0-255
-     * @param g 0-255
-     * @param b 0-255
+    /**
+     * rgb 转 hex 标准格式
+     * @param r 0-255
+     * @param g 0-255
+     * @param b 0-255
      */
   }, {
     key: "rgbToHex",
@@ -50,15 +50,15 @@ var CrColorUtil = /*#__PURE__*/function () {
       var red = clamp(r);
       var green = clamp(g);
       var blue = clamp(b);
-      return "#" + this.twoDigits(red.toString(16)) + this.twoDigits(green.toString(16)) + this.twoDigits(blue.toString(16));
+      return '#' + this.twoDigits(red.toString(16)) + this.twoDigits(green.toString(16)) + this.twoDigits(blue.toString(16));
     }
 
-    /**
-     * 将 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
+    /**
+     * 将 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
      */
   }, {
     key: "rgb2hsv",
@@ -69,12 +69,12 @@ var CrColorUtil = /*#__PURE__*/function () {
       return [60 * (h < 0 ? h + 6 : h), v && n / v, v];
     }
 
-    /**
-     * 将 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
+    /**
+     * 将 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
      */
   }, {
     key: "hsv2rgb",
@@ -86,11 +86,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return [f(5), f(3), f(1)];
     }
 
-    /**
-     * hex 转 rgba 格式字符串 可直接用于css
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @param alpha 透明度 0-1  默认1(完全不透明)
-     * @returns 例: rgba(255,255,255,0.5)
+    /**
+     * hex 转 rgba 格式字符串 可直接用于css
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param alpha 透明度 0-1  默认1(完全不透明)
+     * @returns 例: rgba(255,255,255,0.5)
      */
   }, {
     key: "hexToRgba",
@@ -105,11 +105,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "rgba(".concat(r, ", ").concat(g, ", ").concat(b, ", ").concat(validAlpha, ")");
     }
 
-    /**
-     * 给hex颜色添加透明度，返回 8位带透明通道的hex格式 #RRGGBBAA (CSS常用)
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @param alpha 透明度 0-1  默认1(完全不透明)
-     * @returns 例: #ffffff80  #ff000033
+    /**
+     * 给hex颜色添加透明度，返回 8位带透明通道的hex格式 #RRGGBBAA (CSS常用)
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param alpha 透明度 0-1  默认1(完全不透明)
+     * @returns 例: #ffffff80  #ff000033
      */
   }, {
     key: "hexAddAlpha",
@@ -124,11 +124,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(pureHex).concat(alphaHex);
     }
 
-    /**
-     * rgba 转 hex 格式
-     * @param r 0-255
-     * @param g 0-255
-     * @param b 0-255
+    /**
+     * rgba 转 hex 格式
+     * @param r 0-255
+     * @param g 0-255
+     * @param b 0-255
      */
   }, {
     key: "rgbaToHex",
@@ -136,11 +136,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgbToHex(r, g, b);
     }
 
-    /**
-     * hsv 转 hex 十六进制颜色
-     * @param h 色相 0-360
-     * @param s 饱和度 0-1
-     * @param v 明度 0-1
+    /**
+     * hsv 转 hex 十六进制颜色
+     * @param h 色相 0-360
+     * @param s 饱和度 0-1
+     * @param v 明度 0-1
      */
   }, {
     key: "hsvToHex",
@@ -153,10 +153,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgbToHex(Math.round(r * 255), Math.round(g * 255), Math.round(b * 255));
     }
 
-    /**
-     * hex 转 hsv 格式
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @returns [h:0-360, s:0-1, v:0-1]
+    /**
+     * hex 转 hsv 格式
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @returns [h:0-360, s:0-1, v:0-1]
      */
   }, {
     key: "hexToHsv",
@@ -169,10 +169,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgb2hsv(r / 255, g / 255, b / 255);
     }
 
-    /**
-     * 颜色加深处理 - 基于hex颜色
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @param level 加深程度 0-1  0不变 1最深(接近黑色)
+    /**
+     * 颜色加深处理 - 基于hex颜色
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param level 加深程度 0-1  0不变 1最深(接近黑色)
      */
   }, {
     key: "darkenColor",
@@ -191,10 +191,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgbToHex(darkR, darkG, darkB);
     }
 
-    /**
-     * 颜色减淡/提亮处理 - 基于hex颜色
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @param level 减淡程度 0-1  0不变 1最亮(接近白色)
+    /**
+     * 颜色减淡/提亮处理 - 基于hex颜色
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @param level 减淡程度 0-1  0不变 1最亮(接近白色)
      */
   }, {
     key: "lightenColor",
@@ -213,10 +213,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgbToHex(lightR, lightG, lightB);
     }
 
-    /**
-     * 解析8位带透明的hex #RRGGBBAA 为 普通hex + 透明度
-     * @param hex8 8位带透明的十六进制颜色 例：#ffffff80
-     * @returns { hex: '#ffffff', alpha: 0.5 }
+    /**
+     * 解析8位带透明的hex #RRGGBBAA 为 普通hex + 透明度
+     * @param hex8 8位带透明的十六进制颜色 例：#ffffff80
+     * @returns { hex: '#ffffff', alpha: 0.5 }
      */
   }, {
     key: "parseHex8",
@@ -235,10 +235,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       };
     }
 
-    /**
-     * rgb 数组 转 rgb/rgba 字符串
-     * @param rgb [r,g,b] 0-255
-     * @param alpha 透明度0-1 传则返回rgba，不传返回rgb
+    /**
+     * rgb 数组 转 rgb/rgba 字符串
+     * @param rgb [r,g,b] 0-255
+     * @param alpha 透明度0-1 传则返回rgba，不传返回rgb
      */
   }, {
     key: "rgbToStr",
@@ -250,10 +250,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return alpha !== undefined ? "rgba(".concat(r, ", ").concat(g, ", ").concat(b, ", ").concat(Math.max(0, Math.min(1, alpha)), ")") : "rgb(".concat(r, ", ").concat(g, ", ").concat(b, ")");
     }
 
-    /**
-     * Hex颜色字符串 转 十进制数值（6位纯颜色值，无透明通道，专用于颜色运算）
-     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
-     * @returns 十进制数值 例：#ff0000 → 16711680，非法入参返回 0
+    /**
+     * Hex颜色字符串 转 十进制数值（6位纯颜色值，无透明通道，专用于颜色运算）
+     * @param hex 支持 #fff / #ffffff / fff / ffffff 格式
+     * @returns 十进制数值 例：#ff0000 → 16711680，非法入参返回 0
      */
   }, {
     key: "hexToNumber",
@@ -266,10 +266,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return parseInt(pureHex, 16);
     }
 
-    /**
-     * 十进制数值 转回 Hex颜色字符串（无透明通道 标准6位）
-     * @param num 十进制数值 例：16711680 → #ff0000
-     * @returns 标准6位十六进制颜色 #RRGGBB 格式
+    /**
+     * 十进制数值 转回 Hex颜色字符串（无透明通道 标准6位）
+     * @param num 十进制数值 例：16711680 → #ff0000
+     * @returns 标准6位十六进制颜色 #RRGGBB 格式
      */
   }, {
     key: "numberToHex",
@@ -281,11 +281,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(r).concat(g).concat(b);
     }
 
-    /**
-    * ARGB颜色字符串 转 十进制数值（8位带透明通道，专用于带透明的颜色运算）
-    * @param argb 支持 #AARRGGBB / AARRGGBB 格式 例：#80FFFFFF、80FFFFFF
-    * @returns 十进制数值 例：#80FFFFFF → 2147483647，非法入参/格式错误返回 0
-    */
+    /**
+     * ARGB颜色字符串 转 十进制数值（8位带透明通道，专用于带透明的颜色运算）
+     * @param argb 支持 #AARRGGBB / AARRGGBB 格式 例：#80FFFFFF、80FFFFFF
+     * @returns 十进制数值 例：#80FFFFFF → 2147483647，非法入参/格式错误返回 0
+     */
   }, {
     key: "argbToNumber",
     value: function argbToNumber(argb) {
@@ -296,10 +296,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return parseInt(pureArgb, 16);
     }
 
-    /**
-     * 十进制数值 转回 ARGB颜色字符串（8位带透明通道，标准#AARRGGBB格式）
-     * @param num 十进制数值 例：2147483647 → #80ffffff
-     * @returns 标准ARGB颜色字符串 #AARRGGBB 小写格式
+    /**
+     * 十进制数值 转回 ARGB颜色字符串（8位带透明通道，标准#AARRGGBB格式）
+     * @param num 十进制数值 例：2147483647 → #80ffffff
+     * @returns 标准ARGB颜色字符串 #AARRGGBB 小写格式
      */
   }, {
     key: "numberToArgb",
@@ -311,10 +311,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(a).concat(r).concat(g).concat(b);
     }
 
-    /**
-     * 生成随机Hex颜色
-     * @param withSharp 是否带#号 默认为true
-     * @returns 随机hex颜色
+    /**
+     * 生成随机Hex颜色
+     * @param withSharp 是否带#号 默认为true
+     * @returns 随机hex颜色
      */
   }, {
     key: "randomHexColor",
@@ -324,10 +324,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return withSharp ? "#".concat(hex) : hex;
     }
 
-    /**
-     * 反色处理 - 取颜色的补色（比如黑色→白色，白色→黑色）
-     * @param hex 目标颜色
-     * @returns 反色hex
+    /**
+     * 反色处理 - 取颜色的补色（比如黑色→白色，白色→黑色）
+     * @param hex 目标颜色
+     * @returns 反色hex
      */
   }, {
     key: "reverseColor",
@@ -340,10 +340,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.rgbToHex(255 - r, 255 - g, 255 - b);
     }
 
-    /**
-     * 校验是否为合法的hex颜色
-     * @param hex 待校验的颜色字符串
-     * @returns true=合法 false=不合法
+    /**
+     * 校验是否为合法的hex颜色
+     * @param hex 待校验的颜色字符串
+     * @returns true=合法 false=不合法
      */
   }, {
     key: "isHexColor",
@@ -351,11 +351,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(hex);
     }
 
-    /**
-     * 标准6位Hex颜色 转 ARGB 8位颜色格式 ( 核心：ARGB格式是 #AARRGGBB )
-     * @param hex 6位标准hex 支持 #ffffff / ffffff / #fff / fff
-     * @param alpha 透明度 0~1  默认 1 (完全不透明)
-     * @returns 8位ARGB格式颜色 例：#80FFFFFF  半透明白色
+    /**
+     * 标准6位Hex颜色 转 ARGB 8位颜色格式 ( 核心：ARGB格式是 #AARRGGBB )
+     * @param hex 6位标准hex 支持 #ffffff / ffffff / #fff / fff
+     * @param alpha 透明度 0~1  默认 1 (完全不透明)
+     * @returns 8位ARGB格式颜色 例：#80FFFFFF  半透明白色
      */
   }, {
     key: "hexToArgb",
@@ -372,10 +372,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(alphaHex).concat(pureHex);
     }
 
-    /**
-     * ARGB 8位颜色格式 转回 标准6位Hex颜色 + 独立的透明度值 ( 反向解析 )
-     * @param argb 8位ARGB格式颜色 必须是 #AARRGGBB 格式 例：#80FFFFFF
-     * @returns { hex: '#ffffff', alpha: 0.5 } 标准hex + 0~1的透明度
+    /**
+     * ARGB 8位颜色格式 转回 标准6位Hex颜色 + 独立的透明度值 ( 反向解析 )
+     * @param argb 8位ARGB格式颜色 必须是 #AARRGGBB 格式 例：#80FFFFFF
+     * @returns { hex: '#ffffff', alpha: 0.5 } 标准hex + 0~1的透明度
      */
   }, {
     key: "argbToHex",
@@ -397,10 +397,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       };
     }
 
-    /**
-     * ARGB格式(#AARRGGBB) 转 RRGGBBAA格式(#RRGGBBAA)
-     * @param argb #AARRGGBB
-     * @returns #RRGGBBAA
+    /**
+     * ARGB格式(#AARRGGBB) 转 RRGGBBAA格式(#RRGGBBAA)
+     * @param argb #AARRGGBB
+     * @returns #RRGGBBAA
      */
   }, {
     key: "argbToRgbaHex",
@@ -410,10 +410,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(pureArgb.slice(2)).concat(pureArgb.slice(0, 2));
     }
 
-    /**
-     * RRGGBBAA格式(#RRGGBBAA) 转 ARGB格式(#AARRGGBB)
-     * @param rgbaHex #RRGGBBAA
-     * @returns #AARRGGBB
+    /**
+     * RRGGBBAA格式(#RRGGBBAA) 转 ARGB格式(#AARRGGBB)
+     * @param rgbaHex #RRGGBBAA
+     * @returns #AARRGGBB
      */
   }, {
     key: "rgbaHexToArgb",
@@ -423,11 +423,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return "#".concat(pureRgba.slice(6)).concat(pureRgba.slice(0, 6));
     }
 
-    /**
-     * 调整颜色饱和度
-     * @param hex 目标颜色
-     * @param level 调整程度 0-2  1=不变  <1=降低饱和度  >1=提高饱和度
-     * @returns 调整后的hex颜色
+    /**
+     * 调整颜色饱和度
+     * @param hex 目标颜色
+     * @param level 调整程度 0-2  1=不变  <1=降低饱和度  >1=提高饱和度
+     * @returns 调整后的hex颜色
      */
   }, {
     key: "adjustSaturation",
@@ -441,11 +441,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.hsvToHex(h, newS, v);
     }
 
-    /**
-     * 调整颜色明度
-     * @param hex 目标颜色
-     * @param level 调整程度 0-2  1=不变  <1=降低明度  >1=提高明度
-     * @returns 调整后的hex颜色
+    /**
+     * 调整颜色明度
+     * @param hex 目标颜色
+     * @param level 调整程度 0-2  1=不变  <1=降低明度  >1=提高明度
+     * @returns 调整后的hex颜色
      */
   }, {
     key: "adjustBrightness",
@@ -459,11 +459,11 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.hsvToHex(h, s, newV);
     }
 
-    /**
-     * 普通6位Hex+透明度 → 直接返回ARGB对应的十进制数值
-     * @param hex 支持 #fff / #ffffff 格式
-     * @param alpha 透明度 0-1
-     * @returns ARGB十进制数值
+    /**
+     * 普通6位Hex+透明度 → 直接返回ARGB对应的十进制数值
+     * @param hex 支持 #fff / #ffffff 格式
+     * @param alpha 透明度 0-1
+     * @returns ARGB十进制数值
      */
   }, {
     key: "hexAlphaToArgbNumber",
@@ -473,10 +473,10 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.argbToNumber(argbStr);
     }
 
-    /**
-     * ARGB十进制数值 → 解析出 普通Hex + 0-1透明度
-     * @param num ARGB十进制数值
-     * @returns { hex: '#ffffff', alpha: 0.5 }
+    /**
+     * ARGB十进制数值 → 解析出 普通Hex + 0-1透明度
+     * @param num ARGB十进制数值
+     * @returns { hex: '#ffffff', alpha: 0.5 }
      */
   }, {
     key: "argbNumberToHexAlpha",
@@ -485,8 +485,8 @@ var CrColorUtil = /*#__PURE__*/function () {
       return this.argbToHex(argbStr);
     }
 
-    /**
-     * 补零成两位字符
+    /**
+     * 补零成两位字符
      */
   }, {
     key: "twoDigits",

package/dist/esm/file.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 文件类型
+ * - OTHER 其他
+ * - IMAGE 图片
+ * - VIDEO 视频
+ * - AUDIO 音频
+ * - DOCUMENT 文档
+ * - ARCHIVE 压缩包
+ */
+export declare enum FileTypeEnum {
+    OTHER = "other",
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    DOCUMENT = "document",
+    ARCHIVE = "archive"
+}
+/**
+ * 文档类型
+ * - OTHER
+ * - PDF
+ * - DOC
+ * - DOCX
+ * - XLS
+ * - XLSX
+ * - PPT
+ * - PPTX
+ * - TXT
+ */
+export declare const enum DocumentTypeEnum {
+    OTHER = "other",
+    PDF = "pdf",
+    DOC = "doc",
+    DOCX = "docx",
+    XLS = "xls",
+    XLSX = "xlsx",
+    PPT = "ppt",
+    PPTX = "pptx",
+    TXT = "txt"
+}
+/**
+ * 文件元信息
+ */
+export interface CrFileMeta {
+    ext: string;
+    type: FileTypeEnum;
+    documentType?: DocumentTypeEnum;
+}
+export declare class CrFileUtil {
+    /**
+     * 提取扩展名（不含 .）
+     */
+    static getExt(filename?: string): string;
+    /**
+     * 获取文件完整信息
+     */
+    static getMeta(filename: string): CrFileMeta;
+    /**
+     * 文件类型
+     */
+    static getType(filename: string): FileTypeEnum;
+    /**
+     * 文档类型
+     */
+    static getDocumentType(filename: string): DocumentTypeEnum;
+    static isImage(filename: string): boolean;
+    static isVideo(filename: string): boolean;
+    static isAudio(filename: string): boolean;
+    static isDocument(filename: string): boolean;
+    static isArchive(filename: string): boolean;
+}