@zcrkey/js-utils 0.0.7 → 0.0.10

package/dist/esm/file.js

@@ -0,0 +1,267 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 文件类型
+ * - OTHER 其他
+ * - IMAGE 图片
+ * - VIDEO 视频
+ * - AUDIO 音频
+ * - DOCUMENT 文档
+ * - ARCHIVE 压缩包
+ */
+export var FileTypeEnum = /*#__PURE__*/function (FileTypeEnum) {
+  FileTypeEnum["OTHER"] = "other";
+  FileTypeEnum["IMAGE"] = "image";
+  FileTypeEnum["VIDEO"] = "video";
+  FileTypeEnum["AUDIO"] = "audio";
+  FileTypeEnum["DOCUMENT"] = "document";
+  FileTypeEnum["ARCHIVE"] = "archive";
+  return FileTypeEnum;
+}({});
+
+/**
+ * 文档类型
+ * - OTHER
+ * - PDF
+ * - DOC
+ * - DOCX
+ * - XLS
+ * - XLSX
+ * - PPT
+ * - PPTX
+ * - TXT
+ */
+export var DocumentTypeEnum = {
+  OTHER: "other",
+  PDF: "pdf",
+  DOC: "doc",
+  DOCX: "docx",
+  XLS: "xls",
+  XLSX: "xlsx",
+  PPT: "ppt",
+  PPTX: "pptx",
+  TXT: "txt"
+};
+
+/**
+ * 文件元信息
+ */
+
+var FILE_META_LIST = [/* ---------- image ---------- */
+{
+  ext: 'jpg',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'jpeg',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'png',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'gif',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'bmp',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'webp',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'svg',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'ico',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'heic',
+  type: FileTypeEnum.IMAGE
+}, {
+  ext: 'avif',
+  type: FileTypeEnum.IMAGE
+}, /* ---------- video ---------- */
+{
+  ext: 'mp4',
+  type: FileTypeEnum.VIDEO
+}, {
+  ext: 'mkv',
+  type: FileTypeEnum.VIDEO
+}, {
+  ext: 'mov',
+  type: FileTypeEnum.VIDEO
+}, {
+  ext: 'avi',
+  type: FileTypeEnum.VIDEO
+}, {
+  ext: 'webm',
+  type: FileTypeEnum.VIDEO
+}, {
+  ext: 'flv',
+  type: FileTypeEnum.VIDEO
+}, /* ---------- audio ---------- */
+{
+  ext: 'mp3',
+  type: FileTypeEnum.AUDIO
+}, {
+  ext: 'wav',
+  type: FileTypeEnum.AUDIO
+}, {
+  ext: 'aac',
+  type: FileTypeEnum.AUDIO
+}, {
+  ext: 'flac',
+  type: FileTypeEnum.AUDIO
+}, {
+  ext: 'ogg',
+  type: FileTypeEnum.AUDIO
+}, {
+  ext: 'm4a',
+  type: FileTypeEnum.AUDIO
+}, /* ---------- document ---------- */
+{
+  ext: 'pdf',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.PDF
+}, {
+  ext: 'doc',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.DOC
+}, {
+  ext: 'docx',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.DOCX
+}, {
+  ext: 'xls',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.XLS
+}, {
+  ext: 'xlsx',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.XLSX
+}, {
+  ext: 'ppt',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.PPT
+}, {
+  ext: 'pptx',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.PPTX
+}, {
+  ext: 'txt',
+  type: FileTypeEnum.DOCUMENT,
+  documentType: DocumentTypeEnum.TXT
+}, {
+  ext: 'md',
+  type: FileTypeEnum.DOCUMENT
+}, {
+  ext: 'csv',
+  type: FileTypeEnum.DOCUMENT
+}, {
+  ext: 'json',
+  type: FileTypeEnum.DOCUMENT
+}, /* ---------- archive ---------- */
+{
+  ext: 'zip',
+  type: FileTypeEnum.ARCHIVE
+}, {
+  ext: 'rar',
+  type: FileTypeEnum.ARCHIVE
+}, {
+  ext: '7z',
+  type: FileTypeEnum.ARCHIVE
+}, {
+  ext: 'tar',
+  type: FileTypeEnum.ARCHIVE
+}, {
+  ext: 'gz',
+  type: FileTypeEnum.ARCHIVE
+}];
+var FILE_META_MAP = new Map();
+FILE_META_LIST.forEach(function (item) {
+  FILE_META_MAP.set(item.ext, item);
+});
+var DEFAULT_META = {
+  ext: '',
+  type: FileTypeEnum.OTHER,
+  documentType: DocumentTypeEnum.OTHER
+};
+export var CrFileUtil = /*#__PURE__*/function () {
+  function CrFileUtil() {
+    _classCallCheck(this, CrFileUtil);
+  }
+  _createClass(CrFileUtil, null, [{
+    key: "getExt",
+    value:
+    /**
+     * 提取扩展名（不含 .）
+     */
+    function getExt(filename) {
+      var _filename$trim$split$;
+      if (!filename || typeof filename !== 'string') return '';
+      return ((_filename$trim$split$ = filename.trim().split('.').pop()) === null || _filename$trim$split$ === void 0 ? void 0 : _filename$trim$split$.toLowerCase()) || '';
+    }
+
+    /**
+     * 获取文件完整信息
+     */
+  }, {
+    key: "getMeta",
+    value: function getMeta(filename) {
+      var ext = this.getExt(filename);
+      if (!ext) return DEFAULT_META;
+      return FILE_META_MAP.get(ext) || _objectSpread(_objectSpread({}, DEFAULT_META), {}, {
+        ext: ext
+      });
+    }
+
+    /**
+     * 文件类型
+     */
+  }, {
+    key: "getType",
+    value: function getType(filename) {
+      return this.getMeta(filename).type;
+    }
+
+    /**
+     * 文档类型
+     */
+  }, {
+    key: "getDocumentType",
+    value: function getDocumentType(filename) {
+      return this.getMeta(filename).documentType || DocumentTypeEnum.OTHER;
+    }
+  }, {
+    key: "isImage",
+    value: function isImage(filename) {
+      return this.getType(filename) === FileTypeEnum.IMAGE;
+    }
+  }, {
+    key: "isVideo",
+    value: function isVideo(filename) {
+      return this.getType(filename) === FileTypeEnum.VIDEO;
+    }
+  }, {
+    key: "isAudio",
+    value: function isAudio(filename) {
+      return this.getType(filename) === FileTypeEnum.AUDIO;
+    }
+  }, {
+    key: "isDocument",
+    value: function isDocument(filename) {
+      return this.getType(filename) === FileTypeEnum.DOCUMENT;
+    }
+  }, {
+    key: "isArchive",
+    value: function isArchive(filename) {
+      return this.getType(filename) === FileTypeEnum.ARCHIVE;
+    }
+  }]);
+  return CrFileUtil;
+}();

package/dist/esm/index.d.ts

@@ -1,3 +1,6 @@
+export { default as CrColorUtil } from './color';
+export * from './file';
+export type * from './file';
 export type * from './eventCenter';
 export { default as CrEventCenter } from './eventCenter';
 export type * from './obj';
@@ -6,4 +9,3 @@ export { default as CrStorage } from './storage';
 export type * from './tree';
 export { default as CrTreeUtil } from './tree';
 export { default as CrUtil } from './util';
-export { default as CrColorUtil } from './color';

package/dist/esm/index.js

@@ -1,6 +1,7 @@
+export { default as CrColorUtil } from "./color";
+export * from "./file";
 export { default as CrEventCenter } from "./eventCenter";
 export { default as CrObjUtil } from "./obj";
 export { default as CrStorage } from "./storage";
 export { default as CrTreeUtil } from "./tree";
-export { default as CrUtil } from "./util";
-export { default as CrColorUtil } from "./color";
+export { default as CrUtil } from "./util";

package/dist/esm/obj.js

@@ -12,12 +12,12 @@ var CrObjUtil = /*#__PURE__*/function () {
   _createClass(CrObjUtil, null, [{
     key: "getValueByPath",
     value:
-    /**
-     * 根据字段路径获取对象值
-     * @param obj { 'a': [{ 'b': { 'c': 3 } }] }
-     * @param path 'a[0].b.c' | ['a', '0', 'b', 'c']
-     * @param defaultValue 找不到时返回的默认值
-     * @returns
+    /**
+     * 根据字段路径获取对象值
+     * @param obj { 'a': [{ 'b': { 'c': 3 } }] }
+     * @param path 'a[0].b.c' | ['a', '0', 'b', 'c']
+     * @param defaultValue 找不到时返回的默认值
+     * @returns
      */
     function getValueByPath(obj, propertyPath, defaultValue) {
       return get(obj, propertyPath, defaultValue);

package/dist/esm/tree.d.ts

@@ -21,13 +21,17 @@ export default class CrTreeUtil {
      * 树形数据转列表数据
      * @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<T extends Record<string, any>>(tree: T[], options?: {
+        idField?: string;
+        parentIdField?: string;
         childrenField?: string;
-        isCloneDeep?: boolean;
+        rootParentValue?: any;
     }): T[];
     /**
      * 获取扁平化父数据(包含自身)

package/dist/esm/tree.js

@@ -17,6 +17,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { cloneDeep as _cloneDeep, find as _find, get as _get, keyBy as _keyBy } from 'lodash';
+import CrUtil from "./util";
 var CrTreeUtil = /*#__PURE__*/function () {
   function CrTreeUtil() {
     _classCallCheck(this, CrTreeUtil);
@@ -116,31 +117,59 @@ var CrTreeUtil = /*#__PURE__*/function () {
      * 树形数据转列表数据
      * @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
      */
   }, {
     key: "treeToList",
     value: function treeToList(tree, options) {
       var _ref2 = options || {},
+        _ref2$idField = _ref2.idField,
+        idField = _ref2$idField === void 0 ? 'id' : _ref2$idField,
+        _ref2$parentIdField = _ref2.parentIdField,
+        parentIdField = _ref2$parentIdField === void 0 ? 'parentId' : _ref2$parentIdField,
         _ref2$childrenField = _ref2.childrenField,
         childrenField = _ref2$childrenField === void 0 ? 'children' : _ref2$childrenField,
-        _ref2$isCloneDeep = _ref2.isCloneDeep,
-        isCloneDeep = _ref2$isCloneDeep === void 0 ? true : _ref2$isCloneDeep;
+        _ref2$rootParentValue = _ref2.rootParentValue,
+        rootParentValue = _ref2$rootParentValue === void 0 ? null : _ref2$rootParentValue;
       var result = [];
-      var queue = _toConsumableArray(tree);
-      while (queue.length) {
-        var node = queue.shift();
+      var originQueue = _cloneDeep(_toConsumableArray(tree));
+      var queue = originQueue.map(function (node) {
+        return {
+          node: node,
+          parentId: rootParentValue
+        };
+      });
+      var _loop = function _loop() {
+        var _ref3 = queue.shift(),
+          node = _ref3.node,
+          parentId = _ref3.parentId;
+        if (!node || !CrUtil.isObject(node)) {
+          return 1; // continue
+        }
         var children = node[childrenField];
+        var nodeId = node[idField];
         var _ = node[childrenField],
           rest = _objectWithoutProperties(node, [childrenField].map(_toPropertyKey));
-        result.push(rest);
-        if (children && children.length) {
-          queue.push.apply(queue, _toConsumableArray(children));
+        var flatNode = _objectSpread(_objectSpread({}, rest), {}, _defineProperty({}, parentIdField, parentId));
+        result.push(flatNode);
+        if (children && CrUtil.isArray(children) && children.length > 0) {
+          var childQueue = children.map(function (childNode) {
+            return {
+              node: childNode,
+              parentId: nodeId
+            };
+          });
+          queue.push.apply(queue, _toConsumableArray(childQueue));
         }
+      };
+      while (queue.length) {
+        if (_loop()) continue;
       }
-      return isCloneDeep ? _cloneDeep(result) : result;
+      return result;
     }
 
     /**

package/dist/esm/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
@@ -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;
 }