@hzab/utils 1.0.6 → 1.0.8-beta

package/README.md

@@ -1,137 +1,137 @@
-# @hzab/utils
-
-组件模板
-
-- node@16.16.0
-
-- 注意：首次克隆先执行 npm run prepare 命令
-
-# 组件
-
-## ossUpload 示例
-
-```jsx
-import OssUpload from "@hzab/utils/src/ossUpload";
-
-/**
- * 批量文件上传
- * @param {Array} files
- * @param {Object} opt
- * @returns
- */
-export async function handleOssUpload(files, opt) {
-  const _files = files;
-  const { ossUrl, signatureParams, ossParams, axiosConf, useHashName } = opt || {};
-  const ossUpload = new OssUpload({
-    axios: opt.axios,
-    axiosConf: axiosConf,
-    serverUrl: ossUrl || "/api/v1/user/oss/getWebOssConfig",
-  });
-
-  const promise = [];
-  _files?.forEach((file) => {
-    if (!file) {
-      return;
-    }
-    // 数据已经是 url 的情况
-    if (typeof file === "string" || file.ossUrl || file.url) {
-      promise.push(Promise.resolve(file));
-    } else {
-      promise.push(
-        ossUpload
-          .upload(file, {
-            signatureParams: {
-              isPublic: 1,
-              ...(signatureParams || {}),
-            },
-            ossParams,
-            axiosConf,
-            useHashName,
-          })
-          .then((res) => {
-            return Promise.resolve(res?.data?.data?.fileUrl);
-          }),
-      );
-    }
-  });
-
-  return Promise.all(promise).then((filePromises) => {
-    filePromises?.forEach((fileUrl, idx) => {
-      if (typeof fileUrl === "string") {
-        _files[idx].ossUrl = fileUrl;
-        _files[idx].url = fileUrl;
-      } else if (_files[idx].url) {
-        _files[idx].ossUrl = _files[idx].url;
-      }
-    });
-    return Promise.resolve(_files);
-  });
-}
-```
-
-## API
-
-### InfoPanel Attributes
-
-| 参数   | 类型   | 必填 | 默认值 | 说明              |
-| ------ | ------ | ---- | ------ | ----------------- |
-| schema | Object | 是   | -      | 数据信息的 schema |
-
-# 组件开发流程
-
-- 在 config/webpack.config.js 中按需修改 library 配置的文件名
-- 在 config/webpack.config.js 中按需修改 alias 配置的包名，便于本地调试
-- 在 tsconfig.json 中按需修改 paths 配置的包名，解决 ts 报错问题
-- npm run dev
-
-## 文件目录
-
-- example 本地开发测试代码
-- src 组件源码
-
-## 命令
-
-- Mac 执行该命令，设置 pre-commit 为可执行文件
-
-  - npm run mac-chmod
-  - chmod +x .husky && chmod +x .husky/pre-commit
-
-- 生成文档：npm run docs
-- 本地运行：npm run dev
-
-## 发布
-
-- npm 源和云效源都需要发布
-
-- 命令：npm publish --access public
-- 发布目录：
-  - src
-
-### 迭代发布命令-版本自增
-
-- beta: 需要手动修改 package.json 中的 version，添加 -betaX 版本号。使用 npm publish --beta 发布
-- 0.0.x: npm run publish-patch
-- 0.x.0: npm run publish-minor
-- x.0.0: npm run publish-major
-
-### nrm
-
-- 安装
-  npm install -g nrm
-- 增加源
-  nrm add aliyun https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
-- 切换源
-  nrm use aliyun
-  nrm use npm
-- 登录（账号密码在 https://packages.aliyun.com/npm/npm-registry/guide 查看）
-  npm login --registry=https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
-
-## 配置
-
-### 配置文件
-
-- 本地配置文件：config/config.js
-
-### webpack 配置文件
-
-- config/webpack.config.js
+# @hzab/utils
+
+组件模板
+
+- node@16.16.0
+
+- 注意：首次克隆先执行 npm run prepare 命令
+
+# 组件
+
+## ossUpload 示例
+
+```jsx
+import OssUpload from "@hzab/utils/src/ossUpload";
+
+/**
+ * 批量文件上传
+ * @param {Array} files
+ * @param {Object} opt
+ * @returns
+ */
+export async function handleOssUpload(files, opt) {
+  const _files = files;
+  const { ossUrl, signatureParams, ossParams, axiosConf, useHashName } = opt || {};
+  const ossUpload = new OssUpload({
+    axios: opt.axios,
+    axiosConf: axiosConf,
+    serverUrl: ossUrl || "/api/v1/common/oss/getWebOssConfig",
+  });
+
+  const promise = [];
+  _files?.forEach((file) => {
+    if (!file) {
+      return;
+    }
+    // 数据已经是 url 的情况
+    if (typeof file === "string" || file.ossUrl || file.url) {
+      promise.push(Promise.resolve(file));
+    } else {
+      promise.push(
+        ossUpload
+          .upload(file, {
+            signatureParams: {
+              isPublic: 1,
+              ...(signatureParams || {}),
+            },
+            ossParams,
+            axiosConf,
+            useHashName,
+          })
+          .then((res) => {
+            return Promise.resolve(res?.data?.data?.fileUrl);
+          }),
+      );
+    }
+  });
+
+  return Promise.all(promise).then((filePromises) => {
+    filePromises?.forEach((fileUrl, idx) => {
+      if (typeof fileUrl === "string") {
+        _files[idx].ossUrl = fileUrl;
+        _files[idx].url = fileUrl;
+      } else if (_files[idx].url) {
+        _files[idx].ossUrl = _files[idx].url;
+      }
+    });
+    return Promise.resolve(_files);
+  });
+}
+```
+
+## API
+
+### InfoPanel Attributes
+
+| 参数   | 类型   | 必填 | 默认值 | 说明              |
+| ------ | ------ | ---- | ------ | ----------------- |
+| schema | Object | 是   | -      | 数据信息的 schema |
+
+# 组件开发流程
+
+- 在 config/webpack.config.js 中按需修改 library 配置的文件名
+- 在 config/webpack.config.js 中按需修改 alias 配置的包名，便于本地调试
+- 在 tsconfig.json 中按需修改 paths 配置的包名，解决 ts 报错问题
+- npm run dev
+
+## 文件目录
+
+- example 本地开发测试代码
+- src 组件源码
+
+## 命令
+
+- Mac 执行该命令，设置 pre-commit 为可执行文件
+
+  - npm run mac-chmod
+  - chmod +x .husky && chmod +x .husky/pre-commit
+
+- 生成文档：npm run docs
+- 本地运行：npm run dev
+
+## 发布
+
+- npm 源和云效源都需要发布
+
+- 命令：npm publish --access public
+- 发布目录：
+  - src
+
+### 迭代发布命令-版本自增
+
+- beta: 需要手动修改 package.json 中的 version，添加 -betaX 版本号。使用 npm publish --beta 发布
+- 0.0.x: npm run publish-patch
+- 0.x.0: npm run publish-minor
+- x.0.0: npm run publish-major
+
+### nrm
+
+- 安装
+  npm install -g nrm
+- 增加源
+  nrm add aliyun https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
+- 切换源
+  nrm use aliyun
+  nrm use npm
+- 登录（账号密码在 https://packages.aliyun.com/npm/npm-registry/guide 查看）
+  npm login --registry=https://packages.aliyun.com/62046985b3ead41b374a17f7/npm/npm-registry/
+
+## 配置
+
+### 配置文件
+
+- 本地配置文件：config/config.js
+
+### webpack 配置文件
+
+- config/webpack.config.js

package/changelog.md

@@ -1,6 +1,15 @@
+# @hzab/utils@1.0.8
+
+feat: 添加缩略图地址
+
+# @hzab/utils@1.0.7
+
+feat: 添加缩略图地址
+feat: formily schema clone fn
+
 # @hzab/utils@1.0.6
 
-feat: formily global components
+feat: formily global components management
 
 # @hzab/utils@1.0.5
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hzab/utils",
-  "version": "1.0.6",
+  "version": "1.0.8-beta",
   "description": "utils",
   "main": "src",
   "scripts": {

package/src/formily/cloneSchema.ts

@@ -0,0 +1,63 @@
+import React from "react";
+
+/**
+ * 检测是否为原生 HTML DOM 节点
+ * @param {any} node 待检测对象
+ * @returns {boolean} 是否为原生 DOM 节点
+ */
+function isHtmlDomNode(node) {
+  // 先判断浏览器环境，避免 SSR 报错；兼容 Node/HTMLElement 类型
+  return !!(typeof window !== "undefined" && node && (node instanceof HTMLElement || node instanceof Node));
+}
+
+/**
+ * 增强版 Formily Schema 克隆函数
+ * 解决 lodash cloneDeep 丢失 React DOM/原生 DOM 的问题，兼容多种特殊类型
+ * @param {object} schema 待克隆的 Formily Schema
+ * @returns {object} 克隆后的 Schema
+ */
+export function cloneSchema(schema) {
+  // 1. 基础类型（null/undefined/字符串/数字/布尔）直接返回
+  if (schema === null || typeof schema !== "object") {
+    return schema;
+  }
+
+  // 2. React 虚拟DOM：直接保留原引用，不拷贝
+  if (React.isValidElement(schema)) {
+    return schema;
+  }
+
+  // 3. 原生 HTML DOM 节点：直接保留原引用
+  if (isHtmlDomNode(schema)) {
+    return schema;
+  }
+
+  // 4. 函数：Formily Schema 中的校验/格式化函数等，保留原引用
+  if (typeof schema === "function") {
+    return schema;
+  }
+
+  // 5. 日期对象：创建新的 Date 实例，保证值相同但引用不同
+  if (schema instanceof Date) {
+    return new Date(schema.getTime());
+  }
+
+  // 6. 正则对象：创建新的 RegExp 实例，保留源和标志
+  if (schema instanceof RegExp) {
+    return new RegExp(schema.source, schema.flags);
+  }
+
+  // 7. 数组：递归克隆每一项
+  if (Array.isArray(schema)) {
+    return schema.map((item) => cloneSchema(item));
+  }
+
+  // 8. 普通对象：递归克隆自有属性
+  const clonedObj = {};
+  for (const key in schema) {
+    if (Object.prototype.hasOwnProperty.call(schema, key)) {
+      clonedObj[key] = cloneSchema(schema[key]);
+    }
+  }
+  return clonedObj;
+}

package/src/upload/OssUploadUtil.ts

@@ -1,204 +1,203 @@
-import dayjs from "dayjs";
-
-import { axios } from "@hzab/data-model";
-import { formatDirStr } from "./uploadUtils";
-
-/**
- * getSignature 配置
- */
-export interface IGetSignatureOpt {
-  /** 获取配置的接口地址 */
-  serverUrl?: string;
-  /** axios 实例 */
-  axios?: typeof axios;
-  /** axios 配置参数 */
-  axiosConf?: Object;
-  /** 获取配置的接口自定义入参 */
-  params?: {
-    /** 文件路径 */
-    dir?: string;
-    /** 是否是公开库 */
-    isPublic?: number;
-  };
-}
-
-/**
- * OssUpload props 参数
- */
-export interface IOssUploadProps {
-  /** axios 实例 */
-  axios?: typeof axios;
-  /** axios 配置参数 */
-  axiosConf?: Object;
-  /** 获取配置的接口地址 */
-  serverUrl?: string;
-  /** 获取配置的接口自定义入参 */
-  signatureParams?: {
-    /** 文件路径 */
-    dir?: string;
-    /** 是否是公开库 */
-    isPublic?: number;
-  };
-}
-
-export interface IUploadOpt {
-  fileName?: string;
-  /** axios 实例 */
-  axios?: typeof axios;
-  /** axios 配置参数 */
-  axiosConf?: Object;
-  /** 获取配置的接口地址 */
-  serverUrl?: string;
-  /** 获取配置的接口自定义入参 */
-  params?: {
-    /** 文件路径 */
-    dir?: string;
-    /** 是否是公开库 */
-    isPublic?: number;
-  };
-  /**
-   * 获取配置接口请求入参
-   */
-  signatureParams?: {
-    /** 公开还是私有 */
-    isPublic?: number;
-  };
-  /** 文件上传的接口自定义入参 */
-  ossParams?: {};
-  /** 是否使用 hash 文件名 */
-  useHashName?: boolean;
-  /**缩略图参数 */
-  thumbnailParams?: string;
-}
-
-export function getSignature(opt: IGetSignatureOpt = {}) {
-  const { serverUrl = "/api/v1/user/oss/getWebOssConfig" } = opt;
-  // 减 10 秒，避免发起请求时 刚好过期的情况
-  if (
-    window._$ossSignatureRes &&
-    serverUrl === window._$ossSignatureRes.serverUrl &&
-    dayjs().valueOf() - window._$ossSignatureRes.__saveTime < window._$ossSignatureRes.expireTimeMilles - 10000
-  ) {
-    return Promise.resolve(window._$ossSignatureRes);
-  }
-  const { axios: _ax = axios, params = {}, axiosConf } = opt;
-  // 处理 dir 格式，必须为非 / 开头， /  结尾。如： test/
-  params.dir = formatDirStr(params.dir);
-
-  return _ax
-    .get(serverUrl, {
-      ...axiosConf,
-      params: {
-        isPublic: 1,
-        ...params,
-      },
-    })
-    .then((res) => {
-      window._$ossSignatureRes = res?.data?.data ?? res?.data ?? res;
-      if (window._$ossSignatureRes) {
-        window._$ossSignatureRes.__saveTime = dayjs().valueOf();
-        window._$ossSignatureRes.serverUrl = serverUrl;
-      }
-      return window._$ossSignatureRes;
-    });
-}
-
-/**
- * oss 上传工具类
- */
-class OssUploadUtil {
-  /** axios 实例 */
-  axios: typeof axios;
-  /** axios 配置参数 */
-  axiosConf: Object;
-  /** 获取配置的接口地址 */
-  serverUrl: string;
-  /** 获取配置的接口自定义入参 */
-  signatureParams?: {
-    /** 文件路径 */
-    dir?: string;
-    /** 是否是公开库 */
-    isPublic?: number;
-  };
-
-  constructor(props: IOssUploadProps = {}) {
-    this.axios = props.axios || axios;
-    this.axiosConf = props.axiosConf || {};
-    this.serverUrl = props.serverUrl || "/api/v1/user/oss/getWebOssConfig";
-    this.signatureParams = props.signatureParams || {};
-  }
-
-  getSignature(serverUrl = this.serverUrl, opt) {
-    return this._getSignature(serverUrl, opt);
-  }
-
-  upload(file, opt: IUploadOpt = {}): Promise<{ fileUrl: string }> {
-    return this._upload(file, { ...opt });
-  }
-
-  _getSignature(serverUrl = this.serverUrl, opt) {
-    return getSignature({
-      ...opt,
-      serverUrl,
-      axios: opt?.axios || this.axios,
-      axiosConf: { ...this.axiosConf, ...opt?.axiosConf },
-    });
-  }
-
-  _upload(file, opt: IUploadOpt = {}): Promise<{ fileUrl: string }> {
-    return new Promise(async (resolve, reject) => {
-      const ossParams = await this._getSignature(opt.serverUrl || this.serverUrl, {
-        ...opt,
-        params: { ...this.signatureParams, ...opt.params },
-      });
-
-      const { ossParams: propOssParams, fileName } = opt || {};
-      const formData = new FormData();
-      // key 表示上传到 Bucket 内的 Object 的完整路径，例如 exampledir/exampleobject.txtObject，完整路径中不能包含 Bucket 名称。
-      // filename 表示待上传的本地文件名称。
-      const filename = fileName || file.name;
-      const key = `${ossParams?.dir}${filename}`;
-      formData.set("key", key);
-      formData.set("OSSAccessKeyId", ossParams.accessid);
-      formData.set("policy", ossParams.policy);
-      formData.set("Signature", ossParams.signature);
-      if (ossParams.callback) {
-        formData.set("callback", ossParams.callback);
-      }
-      // @ts-ignore
-      formData.set("success_action_status", 200);
-      formData.set("file", file);
-
-      if (propOssParams) {
-        for (const key in propOssParams) {
-          if (Object.hasOwnProperty.call(propOssParams, key)) {
-            formData.set(key, propOssParams[key]);
-          }
-        }
-      }
-
-      const _axios = opt?.axios || this.axios;
-
-      return _axios
-        .post(ossParams.host, formData, { ...this.axiosConf, ...opt?.axiosConf })
-        .then((res) => {
-          if (opt?.signatureParams?.isPublic === 1) {
-            res.data.data.thumbnailUrl = `${res?.data?.data?.fileUrl}${
-              opt?.thumbnailParams ? "?" + opt?.thumbnailParams : ""
-            }`;
-          }
-          resolve(res);
-          return res;
-        })
-        .catch((err) => {
-          console.error("oss upload err", err);
-          reject(err);
-          return Promise.reject(err);
-        });
-    });
-  }
-}
-
-export { axios };
-
-export default OssUploadUtil;
+import dayjs from "dayjs";
+
+import { axios } from "@hzab/data-model";
+import { formatDirStr } from "./uploadUtils";
+const isPublicMap = {
+  0: "&",
+  1: "?"
+}
+/**
+ * getSignature 配置
+ */
+export interface IGetSignatureOpt {
+  /** 获取配置的接口地址 */
+  serverUrl?: string;
+  /** axios 实例 */
+  axios?: typeof axios;
+  /** axios 配置参数 */
+  axiosConf?: Object;
+  /** 获取配置的接口自定义入参 */
+  params?: {
+    /** 文件路径 */
+    dir?: string;
+    /** 是否是公开库 */
+    isPublic?: number;
+  };
+}
+
+/**
+ * OssUpload props 参数
+ */
+export interface IOssUploadProps {
+  /** axios 实例 */
+  axios?: typeof axios;
+  /** axios 配置参数 */
+  axiosConf?: Object;
+  /** 获取配置的接口地址 */
+  serverUrl?: string;
+  /** 获取配置的接口自定义入参 */
+  signatureParams?: {
+    /** 文件路径 */
+    dir?: string;
+    /** 是否是公开库 */
+    isPublic?: number;
+  };
+}
+
+export interface IUploadOpt {
+  fileName?: string;
+  /** axios 实例 */
+  axios?: typeof axios;
+  /** axios 配置参数 */
+  axiosConf?: Object;
+  /** 获取配置的接口地址 */
+  serverUrl?: string;
+  /** 获取配置的接口自定义入参 */
+  params?: {
+    /** 文件路径 */
+    dir?: string;
+    /** 是否是公开库 */
+    isPublic?: number;
+  };
+  /**
+   * 获取配置接口请求入参
+   */
+  signatureParams?: {
+    /** 公开还是私有 */
+    isPublic?: number;
+  };
+  /** 文件上传的接口自定义入参 */
+  ossParams?: {};
+  /** 是否使用 hash 文件名 */
+  useHashName?: boolean;
+  /**缩略图参数 */
+  thumbnailParams?: string;
+}
+
+export function getSignature(opt: IGetSignatureOpt = {}) {
+  const { serverUrl = "/api/v1/common/oss/getWebOssConfig" } = opt;
+  // 减 10 秒，避免发起请求时 刚好过期的情况
+  if (
+    window._$ossSignatureRes &&
+    serverUrl === window._$ossSignatureRes.serverUrl &&
+    dayjs().valueOf() - window._$ossSignatureRes.__saveTime < window._$ossSignatureRes.expireTimeMilles - 10000
+  ) {
+    return Promise.resolve(window._$ossSignatureRes);
+  }
+  const { axios: _ax = axios, params = {}, axiosConf } = opt;
+  // 处理 dir 格式，必须为非 / 开头， /  结尾。如： test/
+  params.dir = formatDirStr(params.dir);
+
+  return _ax
+    .get(serverUrl, {
+      ...axiosConf,
+      params: {
+        isPublic: 1,
+        ...params,
+      },
+    })
+    .then((res) => {
+      window._$ossSignatureRes = res?.data?.data ?? res?.data ?? res;
+      if (window._$ossSignatureRes) {
+        window._$ossSignatureRes.__saveTime = dayjs().valueOf();
+        window._$ossSignatureRes.serverUrl = serverUrl;
+      }
+      return window._$ossSignatureRes;
+    });
+}
+
+/**
+ * oss 上传工具类
+ */
+class OssUploadUtil {
+  /** axios 实例 */
+  axios: typeof axios;
+  /** axios 配置参数 */
+  axiosConf: Object;
+  /** 获取配置的接口地址 */
+  serverUrl: string;
+  /** 获取配置的接口自定义入参 */
+  signatureParams?: {
+    /** 文件路径 */
+    dir?: string;
+    /** 是否是公开库 */
+    isPublic?: number;
+  };
+
+  constructor(props: IOssUploadProps = {}) {
+    this.axios = props.axios || axios;
+    this.axiosConf = props.axiosConf || {};
+    this.serverUrl = props.serverUrl || "/api/v1/common/oss/getWebOssConfig";
+    this.signatureParams = props.signatureParams || {};
+  }
+
+  getSignature(serverUrl = this.serverUrl, opt) {
+    return this._getSignature(serverUrl, opt);
+  }
+
+  upload(file, opt: IUploadOpt = {}): Promise<{ fileUrl: string }> {
+    return this._upload(file, { ...opt });
+  }
+
+  _getSignature(serverUrl = this.serverUrl, opt) {
+    return getSignature({
+      ...opt,
+      serverUrl,
+      axios: opt?.axios || this.axios,
+      axiosConf: { ...this.axiosConf, ...opt?.axiosConf },
+    });
+  }
+
+  _upload(file, opt: IUploadOpt = {}): Promise<{ fileUrl: string }> {
+    return new Promise(async (resolve, reject) => {
+      const ossParams = await this._getSignature(opt.serverUrl || this.serverUrl, {
+        ...opt,
+        params: { ...this.signatureParams, ...opt.params },
+      });
+
+      const { ossParams: propOssParams, fileName } = opt || {};
+      const formData = new FormData();
+      // key 表示上传到 Bucket 内的 Object 的完整路径，例如 exampledir/exampleobject.txtObject，完整路径中不能包含 Bucket 名称。
+      // filename 表示待上传的本地文件名称。
+      const filename = fileName || file.name;
+      const key = `${ossParams?.dir}${filename}`;
+      formData.set("key", key);
+      formData.set("OSSAccessKeyId", ossParams.accessid);
+      formData.set("policy", ossParams.policy);
+      formData.set("Signature", ossParams.signature);
+      if (ossParams.callback) {
+        formData.set("callback", ossParams.callback);
+      }
+      // @ts-ignore
+      formData.set("success_action_status", 200);
+      formData.set("file", file);
+
+      if (propOssParams) {
+        for (const key in propOssParams) {
+          if (Object.hasOwnProperty.call(propOssParams, key)) {
+            formData.set(key, propOssParams[key]);
+          }
+        }
+      }
+
+      const _axios = opt?.axios || this.axios;
+
+      return _axios
+        .post(ossParams.host, formData, { ...this.axiosConf, ...opt?.axiosConf })
+        .then((res) => {
+          res.data.data.thumbnailUrl = `${res?.data?.data?.fileUrl}${opt?.thumbnailParams ? isPublicMap[opt?.signatureParams?.isPublic] + opt?.thumbnailParams : ""}`;
+          resolve(res);
+          return res;
+        })
+        .catch((err) => {
+          console.error("oss upload err", err);
+          reject(err);
+          return Promise.reject(err);
+        });
+    });
+  }
+}
+
+export { axios };
+
+export default OssUploadUtil;