mrxy-yk 0.0.1-beta.11

package/dist/utils/prototype/lib/ObjectUtil.es.js

@@ -0,0 +1,277 @@
+class ObjectUtil {
+  /**
+   * 限制值在范围之间
+   * @param value
+   * @param min
+   * @param max
+   * @param cycle 值溢出时是否从对向开始计数，如小于最小值时返回最大值
+   */
+  static toBetween(value, min, max, cycle = false) {
+    if (value < min) return cycle ? max : min;
+    else if (value > max) return cycle ? min : max;
+    return value;
+  }
+  /**
+   * 立即执行函数表达式（Immediately Invoked Function Expression，简称 IIFE）。
+   * 立即执行函数
+   * ``` ts
+   * // 解决表达式容易和前一行的代码合并的问题，例如以下代码就会报错
+   * const arr = []
+   * (function() {
+   *   // 代码逻辑
+   * })();
+   * ```
+   * @param fn
+   */
+  static iiFn(fn) {
+    return fn();
+  }
+  /**
+   * 立即执行函数
+   * 同`iiFn`，无返回值函数
+   * @param fn
+   */
+  static iiFnVoid(fn) {
+    fn();
+  }
+  /**
+   * 复制文本到粘贴板
+   * @param text
+   */
+  static async copyToClipboard(text) {
+    if (navigator.clipboard) {
+      await navigator.clipboard.writeText(text);
+    } else {
+      const textArea = document.createElement("textarea");
+      textArea.value = text;
+      document.body.append(textArea);
+      textArea.select();
+      document.execCommand("copy");
+      textArea.remove();
+    }
+  }
+  /**
+   * 深层循环，可用于代替一部分递归的使用
+   * 常见数据处理：
+   * 双数组合并成一个children字段
+   * ``` ts
+   * deepForEach([{ groupList: [], deviceList: [] }], (item, resolve, parent) => {
+   *   if (parent) parent.children.unshift(item)
+   *   item.children = [...item.deviceList]
+   *   if (item.groupList.length) resolve(item.groupList.reverse())
+   * })
+   * ```
+   */
+  static deepForEach(arraySource, callback) {
+    const cyclePool = arraySource.map((item) => ({ value: item, parent: null, level: 0 }));
+    function createResolveFn(forItem) {
+      return (children, parent) => {
+        cyclePool.push(...children.map((item) => ({
+          value: item,
+          parent: parent || forItem.value,
+          level: forItem.level + 1
+        })));
+      };
+    }
+    for (const item of cyclePool) {
+      callback(item.value, createResolveFn(item), item.parent, item.level);
+    }
+    return arraySource;
+  }
+  /**
+   * 前缘防抖 - 立即触发，多次调用触发第一次
+   * @param fn
+   * @param delay
+   */
+  static leadingDebounce(fn, delay = 300) {
+    let timer;
+    return ((...args) => {
+      if (timer) {
+        clearTimeout(timer);
+      } else {
+        fn(...args);
+      }
+      timer = setTimeout(() => {
+        timer = null;
+      }, delay);
+    });
+  }
+  /**
+   * 延迟
+   * @param delay
+   */
+  static sleep(delay) {
+    return new Promise((resolve) => {
+      setTimeout(() => {
+        resolve();
+      }, delay);
+    });
+  }
+  /**
+   * 防抖 - 延迟触发,多次调用触发最后一次
+   * @param fn
+   * @param delay
+   */
+  static debounce(fn, delay = 300) {
+    let timer;
+    return ((...arg) => {
+      if (timer) {
+        clearTimeout(timer);
+      }
+      timer = setTimeout(() => {
+        fn(...arg);
+      }, delay);
+    });
+  }
+  /**
+   * 节流 - 触发后一段时间内不会再次触发
+   * @param fn
+   * @param delay
+   */
+  static throttle(fn, delay = 300) {
+    let timer;
+    return ((...arg) => {
+      if (!timer) {
+        fn(...arg);
+        timer = setTimeout(() => {
+          clearTimeout(timer);
+          timer = null;
+        }, delay);
+      }
+    });
+  }
+  /**
+   * 根据地址获取源数据中的值
+   * @param source
+   * @param address
+   * @param char
+   */
+  static getAttr(source, address, char = "/") {
+    const tier = address.split(char);
+    try {
+      for (const key of tier) {
+        source = source[key];
+      }
+      return source;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * 判断参数是否为null|undefined|''
+   * @param value
+   */
+  static isNotEmpty(value) {
+    return value === 0 || Boolean(value);
+  }
+  /**
+   * 判断参数是否为null|undefined|''
+   * @param value
+   */
+  static isEmpty(value) {
+    return !this.isNotEmpty(value);
+  }
+  /**
+   * 如果value不为空返回value否则返回arg
+   * @param value
+   * @param arg
+   */
+  static isEmptyToVal(value, arg) {
+    return this.isNotEmpty(value) ? value : arg;
+  }
+  /**
+   * 根据source更新target中的属性值
+   * @param target
+   * @param source
+   * @param template
+   */
+  static updateVal(target, source, template) {
+    if (!template) template = target;
+    for (const key in template) {
+      target[key] = source[key];
+    }
+  }
+  /**
+   * 初始化对象数据
+   * @param target
+   * @param source
+   */
+  static initClassVal(target, source) {
+    if (!source) return;
+    const prototype = target.constructor.prototype;
+    for (const key in source) {
+      if (target.hasOwnProperty(key) || prototype.hasOwnProperty(key)) {
+        target[key] = source[key];
+      }
+    }
+  }
+  /**
+   * 深度克隆 - 不会拷贝函数，不能拷贝自引用的对象，无法正确拷贝非JSON的对象如Date
+   * 深度：√
+   * 自引用：√
+   * 非JSON对象：√
+   * 函数：Error
+   * @param arg
+   */
+  static copy(arg) {
+    return structuredClone(arg);
+  }
+  /**
+   * 将对象转成JSON对象
+   * @param arg
+   */
+  static toJSON(arg) {
+    return JSON.parse(JSON.stringify(arg));
+  }
+  /**
+   * 合并两个对象
+   * @param target
+   * @param source
+   * @param option
+   */
+  static assignDeep(target, source, option = {}) {
+    const _option_ = { deep: true, object: true, array: true, ...option };
+    this._assignDeep_(target, source, _option_);
+    return target;
+  }
+  /**
+   * assignDeep 的递归函数
+   * @param target
+   * @param source
+   * @param option
+   * @private
+   */
+  static _assignDeep_(target, source, option) {
+    for (const key in source) {
+      const val = source[key];
+      if (this.isObject(val) && this.isObject(target[key]) && option.object || Array.isArray(val) && Array.isArray(target[key]) && option.array) {
+        this._assignDeep_(target[key], val, option);
+      } else {
+        if (option.deep || target.hasOwnProperty(key)) {
+          target[key] = val;
+        }
+      }
+    }
+  }
+  static isBoolean(arg) {
+    return Object.prototype.toString.call(arg) === "[object Boolean]";
+  }
+  static isString(arg) {
+    return Object.prototype.toString.call(arg) === "[object String]";
+  }
+  static isNumber(arg) {
+    return Object.prototype.toString.call(arg) === "[object Number]";
+  }
+  static isObject(arg) {
+    return Object.prototype.toString.call(arg) === "[object Object]";
+  }
+  static isDate(arg) {
+    return Object.prototype.toString.call(arg) === "[object Date]";
+  }
+  static isUndefined(arg) {
+    return arg === void 0;
+  }
+}
+export {
+  ObjectUtil
+};

package/dist/utils/prototype/lib/PromiseUtil.es.js

@@ -0,0 +1,18 @@
+class PromiseUtil {
+  /**
+   * 安全的使用 Promise await，捕获catch的错误，避免使用await的时候报错影响业务
+   * @param promise
+   */
+  static async safe(promise) {
+    const result = [];
+    try {
+      result[0] = await promise;
+    } catch (error) {
+      result[1] = error;
+    }
+    return result;
+  }
+}
+export {
+  PromiseUtil
+};

package/dist/utils/transition-fade/index.es.js

@@ -0,0 +1,79 @@
+class TransitionFade {
+  // 需要监控的DOM列表
+  elList = [];
+  // 记录DOM和DOM的getBoundingClientRect数据
+  elRectMap = /* @__PURE__ */ new Map();
+  // 动画过度时间
+  duration = 200;
+  constructor(option) {
+    if (!option) return;
+    if (option.updateElListHook) {
+      this.autoUpDateElList = true;
+      this.updateElListHook = option.updateElListHook;
+    }
+    if (option.duration) this.duration = option.duration;
+  }
+  // region 自动更新ElList
+  // 是否需要自动更新ElList
+  autoUpDateElList = false;
+  // 更新ElList的方式
+  updateElListHook = null;
+  /**
+   * 更新ElList
+   * @private
+   */
+  updateElList() {
+    if (!this.autoUpDateElList) return;
+    this.setElList(this.updateElListHook());
+  }
+  // endregion
+  /**
+   * DOM状态修改之前需要先执行ready记录当前状态
+   */
+  async ready() {
+    this.elRectMap.clear();
+    this.updateElList();
+    const length = this.elList.length;
+    for (let index = 0; index < length; index++) {
+      const element = this.elList[index];
+      this.elRectMap.set(element, element.getBoundingClientRect());
+    }
+  }
+  /**
+   * DOM状态修改后执行动画，如果ElList没有新增或者减少可以连续使用go函数，不需要每次执行ready函数
+   * @param duration
+   */
+  go(duration) {
+    const length = this.elList.length;
+    const goElementRectMap = /* @__PURE__ */ new Map();
+    for (let index = 0; index < length; index++) {
+      const element = this.elList[index];
+      goElementRectMap.set(element, element.getBoundingClientRect());
+    }
+    for (let index = 0; index < length; index++) {
+      const element = this.elList[index];
+      const r1 = this.elRectMap.get(element);
+      const r2 = goElementRectMap.get(element);
+      if (r1 && r2) {
+        element.animate([
+          { transform: `translateY(${r1.y - r2.y}px) translateX(${r1.x - r2.x}px)` },
+          { transform: "translateY(0) translateX(0)" }
+        ], {
+          duration: duration || this.duration
+        });
+      }
+    }
+    this.elRectMap = goElementRectMap;
+  }
+  /**
+   * 手动设置ElList
+   * @param elementList
+   */
+  setElList(elementList) {
+    this.elList = elementList;
+    this.elRectMap.clear();
+  }
+}
+export {
+  TransitionFade
+};

package/global.d.ts

@@ -0,0 +1,55 @@
+export {}
+
+declare module 'vue' {
+  export interface GlobalComponents {
+    YkPositionAnchor: typeof import('mrxy-yk/components')['PositionAnchor']
+    MrPositionAnchor: typeof import('mrxy-yk/components')['PositionAnchor']
+    YkProgressRing: typeof import('mrxy-yk/components')['ProgressRing']
+    MrProgressRing: typeof import('mrxy-yk/components')['ProgressRing']
+    YkAdaptiveBox: typeof import('mrxy-yk/components')['AdaptiveBox']
+    MrAdaptiveBox: typeof import('mrxy-yk/components')['AdaptiveBox']
+    YkCoordinatePickup: typeof import('mrxy-yk/components')['CoordinatePickup']
+    MrCoordinatePickup: typeof import('mrxy-yk/components')['CoordinatePickup']
+    YkInBody: typeof import('mrxy-yk/components')['InBody']
+    MrInBody: typeof import('mrxy-yk/components')['InBody']
+    YkDragDropBox: typeof import('mrxy-yk/components')['DragDropBox']
+    MrDragDropBox: typeof import('mrxy-yk/components')['DragDropBox']
+    YkDragDropContainer: typeof import('mrxy-yk/components')['DragDropContainer']
+    MrDragDropContainer: typeof import('mrxy-yk/components')['DragDropContainer']
+    YkProgressBar: typeof import('mrxy-yk/components')['ProgressBar']
+    MrProgressBar: typeof import('mrxy-yk/components')['ProgressBar']
+    YkYsVideo: typeof import('mrxy-yk/components')['YsVideo']
+    MrYsVideo: typeof import('mrxy-yk/components')['YsVideo']
+    YkShowLog: typeof import('mrxy-yk/components')['ShowLog']
+    MrShowLog: typeof import('mrxy-yk/components')['ShowLog']
+    YkEChartsCanvas: typeof import('mrxy-yk/components')['EChartsCanvas']
+    MrEChartsCanvas: typeof import('mrxy-yk/components')['EChartsCanvas']
+    YkScrollContainer: typeof import('mrxy-yk/components')['ScrollContainer']
+    MrScrollContainer: typeof import('mrxy-yk/components')['ScrollContainer']
+    YkElDatePicker: typeof import('mrxy-yk/components')['ElDatePicker']
+    MrElDatePicker: typeof import('mrxy-yk/components')['ElDatePicker']
+
+    YkElFormDialog: typeof import('mrxy-yk/element-plus/components')['ElFormDialog']
+    MrElFormDialog: typeof import('mrxy-yk/element-plus/components')['ElFormDialog']
+    YkElPagination: typeof import('mrxy-yk/element-plus/components')['ElPagination']
+    MrElPagination: typeof import('mrxy-yk/element-plus/components')['ElPagination']
+    YkElUploadImages: typeof import('mrxy-yk/element-plus/components')['ElUploadImages']
+    MrElUploadImages: typeof import('mrxy-yk/element-plus/components')['ElUploadImages']
+    YkElUploadFiles: typeof import('mrxy-yk/element-plus/components')['ElUploadFiles']
+    MrElUploadFiles: typeof import('mrxy-yk/element-plus/components')['ElUploadFiles']
+    YkElSelectFile: typeof import('mrxy-yk/element-plus/components')['ElSelectFile']
+    MrElSelectFile: typeof import('mrxy-yk/element-plus/components')['ElSelectFile']
+    YkElEmpty: typeof import('mrxy-yk/element-plus/components')['ElEmpty']
+    MrElEmpty: typeof import('mrxy-yk/element-plus/components')['ElEmpty']
+    YkElImages: typeof import('mrxy-yk/element-plus/components')['ElImages']
+    MrElImages: typeof import('mrxy-yk/element-plus/components')['ElImages']
+    YkElTableColumn: typeof import('mrxy-yk/element-plus/components')['ElTableColumn']
+      & typeof import('element-plus/es')['ElTableColumn']
+    MrElTableColumn: typeof import('mrxy-yk/element-plus/components')['ElTableColumn']
+      & typeof import('element-plus/es')['ElTableColumn']
+  }
+
+  export interface GlobalDirectives {
+    vRefHeight: typeof import('mrxy-yk')['RefHeight']
+  }
+}

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "mrxy-yk",
+  "version": "0.0.1-beta.11",
+  "private": false,
+  "type": "module",
+  "description": "A collection of Vue 3 components and utilities",
+  "keywords": [
+    "mrxy",
+    "mrxy-yk",
+    "vue3",
+    "components",
+    "utilities",
+    "plugin"
+  ],
+  "author": "Mrxy",
+  "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "main": "./dist/index.es.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/@type/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/@type/index.d.ts",
+      "import": "./dist/index.es.js"
+    },
+    "./global": {
+      "import": "./global.d.ts"
+    },
+    "./styles/*": {
+      "import": "./dist/styles/*"
+    },
+    "./config": {
+      "types": "./dist/@type/config/index.d.ts",
+      "import": "./dist/config/index.es.js"
+    },
+    "./resolver": {
+      "types": "./dist/@type/resolver/index.d.ts",
+      "import": "./dist/resolver/index.es.js"
+    },
+    "./components": {
+      "types": "./dist/@type/components/index.d.ts",
+      "import": "./dist/components/index.es.js"
+    },
+    "./element-plus/*": {
+      "types": "./dist/@type/element-plus/*",
+      "import": "./dist/element-plus/*"
+    },
+    "./components/*": {
+      "types": "./dist/@type/components/*",
+      "import": "./dist/components/*"
+    },
+    "./utils/*": {
+      "types": "./dist/@type/utils/*",
+      "import": "./dist/utils/*"
+    },
+    "./dist/*": {
+      "types": "./dist/@type/*",
+      "import": "./dist/*"
+    },
+    "./*": "./*"
+  },
+  "sideEffects": [
+    "dist/*",
+    "src/**/*.css",
+    "src/**/*.scss",
+    "src/**/*.vue"
+  ],
+  "files": [
+    "dist",
+    "web-types-mr.json",
+    "web-types-yk.json",
+    "global.d.ts"
+  ],
+  "style": "dist/styles/index.css",
+  "web-types": [
+    "web-types-mr.json",
+    "web-types-yk.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/cscake/mrxy-yk.git"
+  },
+  "homepage": "https://gitee.com/cscake/mrxy-yk.git",
+  "scripts": {
+    "dev": "vite",
+    "pack": "npm pack",
+    "build": "run-p type-check \"build-only {@}\" --",
+    "build-only": "vite build",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --build",
+    "lint": "eslint . --fix"
+  },
+  "peerDependencies": {
+    "element-plus": "^2.5.0",
+    "vue": "^3.5.0"
+  },
+  "dependencies": {
+    "@amap/amap-jsapi-loader": "1.0.1",
+    "@element-plus/icons-vue": "2.3.2",
+    "dayjs": "1.11.19",
+    "echarts": "6.0.0",
+    "ezuikit-js": "8.2.2",
+    "jszip": "3.10.1",
+    "mitt": "3.0.1"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "22.0.5",
+    "@types/node": "25.0.3",
+    "@vitejs/plugin-vue": "6.0.3",
+    "@vue/eslint-config-typescript": "14.6.0",
+    "@vue/tsconfig": "0.8.1",
+    "eslint": "9.39.2",
+    "eslint-plugin-unicorn": "62.0.0",
+    "eslint-plugin-vue": "10.6.2",
+    "jiti": "2.6.1",
+    "npm-run-all2": "8.0.4",
+    "sass-embedded": "1.93.3",
+    "typescript": "5.9.3",
+    "unplugin-auto-import": "20.3.0",
+    "unplugin-vue-components": "30.0.0",
+    "vite": "7.3.0",
+    "vite-plugin-dts": "4.5.4",
+    "vite-plugin-static-copy": "^3.1.4",
+    "vite-plugin-vue-devtools": "8.0.5",
+    "vue-tsc": "3.1.8"
+  },
+  "browserslist": [
+    "> 1%",
+    "not ie 11",
+    "not op_mini all"
+  ]
+}