@hzab/utils 1.1.5 → 1.1.7

package/src/formily/field.ts

@@ -0,0 +1,142 @@
+import _ from "lodash";
+import dayjs from "dayjs";
+import advancedFormat from "dayjs/plugin/advancedFormat";
+import weekOfYear from "dayjs/plugin/weekOfYear";
+
+dayjs.extend(advancedFormat);
+dayjs.extend(weekOfYear);
+
+const dateFormatEnum: Record<string, string> = {
+  time: "YYYY-MM-DD HH:mm:ss",
+  date: "YYYY-MM-DD",
+  week: "YYYY年 w周",
+  quarter: "YYYY年 Q季度",
+  month: "YYYY-MM",
+  year: "YYYY",
+};
+
+/**
+ * 获取 field 对应的值
+ * @param {Object} field schema 项
+ * @param {Object} data 数据
+ * @param {Object} opt 配置项
+ * @returns
+ */
+export function getVal(field: any = {}, data: any = {}, opt: any = {}) {
+  let val = _.get(data, field.name);
+  const xComponent = field["x-component"];
+  const xComponentProps = field["x-component-props"] || {};
+
+  if (val && (xComponent === "DatePicker" || xComponent === "DatePicker.RangePicker")) {
+    const { picker, showTime } = xComponentProps || {};
+    const mode = showTime === true ? "time" : picker || "date";
+    const _formatEnum = opt.dateFormatEnum || dateFormatEnum;
+    const format = xComponentProps?.format || _formatEnum[mode];
+
+    if (Array.isArray(val)) {
+      return val.map((it) => getDateVal(it, format)).join(" ~ ");
+    }
+    return getDateVal(val, format);
+  }
+
+  if (val && (xComponent === "TimePicker" || xComponent === "TimePicker.RangePicker")) {
+    const format = xComponentProps?.format || "HH:mm:ss";
+    if (Array.isArray(val)) {
+      return val.map((it) => dayjs(it).format(format)).join(" ~ ");
+    }
+    return dayjs(val).format(format);
+  }
+
+  if (xComponent === "Switch") {
+    if (val === undefined || val === false || val === field.inactiveValue) {
+      return field.inactiveText || "否";
+    }
+    if (val === true || val === field.activeValue) {
+      return field.activeText || "是";
+    }
+    return val;
+  }
+  if (typeof field.relation === "object") {
+    const { key, name, label } = field.relation;
+    return data[key]?.[name];
+  }
+
+  const dataSource = field?.dataSource || field.enum;
+  if (
+    (xComponent === "Select" || xComponent === "Radio.Group" || xComponent === "Checkbox.Group") &&
+    Array.isArray(dataSource)
+  ) {
+    if (!Array.isArray(val)) {
+      return getFieldOptItByVal(val, field, opt)?.label || val;
+    } else if (Array.isArray(val)) {
+      const _val: any[] = [];
+      val.forEach((valIt) => {
+        _val.push(getFieldOptItByVal(val, field, opt)?.label || valIt);
+      });
+      val = _val;
+    }
+  }
+
+  if (Array.isArray(val)) {
+    return val.join("、");
+  }
+
+  return val;
+}
+
+export function getDateVal(val: any, format: any) {
+  return dayjs(val).format(format);
+}
+
+/**
+ * 根据 val 获取对应的 options 项数据
+ * @param {string|number|boolean} val
+ * @param {Object} field
+ */
+export const getFieldOptItByVal = function (val: any, field: any, opt: any) {
+  if (!field) {
+    return {};
+  }
+  const options = Array.isArray(field.enum)
+    ? field.enum
+    : Array.isArray(field.options)
+    ? field.options
+    : field.dataSource || [];
+  return getOptItByVal(val, options, {
+    fieldNames: field.fieldNames || field["x-component-props"]?.fieldNames,
+    ...opt,
+  });
+};
+
+/**
+ * 根据 val 获取对应的 options 项数据，并进行数据归一化处理
+ * value, label, children
+ * @param {string|number|boolean} val
+ * @param {Object} field
+ */
+export const getOptItByVal = function (val: any, options: any, opt: any) {
+  const { fieldNames } = opt || {};
+  const { value = "value", label = "label", children = "children" } = fieldNames || {};
+  for (let i = 0; i < options.length; i++) {
+    const it = options[i];
+    if (it?.[value] === val) {
+      return {
+        ...it,
+        value: it?.[value],
+        label: it?.[label],
+        children: it?.[children],
+      };
+    }
+    // 递归处理
+    const _children = it?.[children];
+    if (Array.isArray(_children) && _children.length > 0) {
+      const child = getOptItByVal(val, _children, opt);
+      return {
+        ...child,
+        value: child?.[value],
+        label: child?.[label],
+        children: child?.[children],
+      };
+    }
+  }
+};

package/src/global.d.ts

@@ -0,0 +1,9 @@
+export {};
+declare global {
+  interface Window {
+    utilsGlobalServeConfig?: Record<string, any>;
+    _$offlineSignatureRes?: any;
+    _$ossSignatureRes?: any;
+    formilyGlobalComponents?: Record<string, any>;
+  }
+}

package/src/idCardVerify.ts

@@ -149,7 +149,7 @@ export function convert15to18(id15) {
   }
 
   // 年份前加完整的四位年份
-  let id17 = id15.substring(0, 6) + fullYear + id15.substring(8);
+  const id17 = id15.substring(0, 6) + fullYear + id15.substring(8);
   // 计算校验码
   const checkCode = calculateCheckCode(id17);
   return id17 + checkCode;

package/src/img-utils.ts

@@ -108,7 +108,7 @@ export function setDomWH(dom: HTMLElement, w: number, h: number) {
  * @returns {Promise<Blob>}
  */
 export function getCanvasPic(canvas: HTMLCanvasElement): Blob {
-  var gl = canvas.getContext("2d", { preserveDrawingBuffer: true });
+  const gl = canvas.getContext("2d", { preserveDrawingBuffer: true });
 
   return dataURItoBlob(canvas.toDataURL(IMAGE_TYPES.PNG, 1));
 }
@@ -119,11 +119,11 @@ export function getCanvasPic(canvas: HTMLCanvasElement): Blob {
  * @returns
  */
 export function dataURItoBlob(base64: string): Blob {
-  let arr = base64.split(",");
-  let mime = arr[0]?.match(/:(.*?);/)?.[1];
-  let bstr = atob(arr[1]);
+  const arr = base64.split(",");
+  const mime = arr[0]?.match(/:(.*?);/)?.[1];
+  const bstr = atob(arr[1]);
   let n = bstr.length;
-  let u8arr = new Uint8Array(n);
+  const u8arr = new Uint8Array(n);
   while (n--) {
     u8arr[n] = bstr.charCodeAt(n);
   }
@@ -153,7 +153,7 @@ export function getImgEle(imgSrc: string): Promise<HTMLImageElement> {
 export function getImgBase64(imgSrc: string): Promise<string> {
   return getImgEle(imgSrc).then((img) => {
     const canvas = document.createElement("canvas");
-    let { width, height } = getDomWH(img);
+    const { width, height } = getDomWH(img);
     setDomWH(canvas, width, height);
     const ctx = canvas.getContext("2d");
     ctx && ctx.drawImage(img, 0, 0, width, height, 0, 0, width, height);
@@ -169,7 +169,7 @@ export function getImgBase64(imgSrc: string): Promise<string> {
 export function getCanvas(imgSrc: string): Promise<HTMLCanvasElement> {
   return getImgEle(imgSrc).then((img) => {
     const canvas = document.createElement("canvas");
-    let { width, height } = getDomWH(img);
+    const { width, height } = getDomWH(img);
     setDomWH(canvas, width, height);
     const ctx = canvas.getContext("2d");
     ctx && ctx.drawImage(img, 0, 0, width, height, 0, 0, width, height);
@@ -184,7 +184,7 @@ export function getCanvas(imgSrc: string): Promise<HTMLCanvasElement> {
  */
 export function getCanvasByImg(img: HTMLImageElement): HTMLCanvasElement {
   const canvas = document.createElement("canvas");
-  let { width, height } = getDomWH(img);
+  const { width, height } = getDomWH(img);
   setDomWH(canvas, width, height);
   const ctx = canvas.getContext("2d");
   ctx && ctx.drawImage(img, 0, 0, width, height, 0, 0, width, height);
@@ -294,7 +294,7 @@ export async function imgToBase64(img: string | HTMLImageElement | HTMLCanvasEle
   } else if (img instanceof HTMLVideoElement) {
     // 从视频中获取图片
     const canvas = document.createElement("canvas");
-    let { width, height } = getDomWH(img);
+    const { width, height } = getDomWH(img);
     setDomWH(canvas, width, height);
     const ctx = canvas.getContext("2d");
     ctx && ctx.drawImage(img, 0, 0, width, height, 0, 0, width, height);

package/src/index.ts

@@ -0,0 +1,43 @@
+// @hzab/utils 根入口（新增公共入口，兼容 `@hzab/utils` 裸导入）。
+// 注意：此处只聚合"无命名冲突"的叶子工具模块；formily/upload 等含重复导出名
+// （如 getSignature/getPreviewUrl）的模块仍走深路径 `@hzab/utils/src/<sub>`。
+export * from "./array";
+export * from "./base64Str";
+export * from "./blob";
+export * from "./color";
+export * from "./empty-val";
+export * from "./globalConfig";
+export * from "./idCardVerify";
+export * from "./img-utils";
+export * from "./locationUtils";
+export * from "./nanoid";
+export * from "./options";
+export * from "./scan-qr";
+export * from "./sizeAdapter";
+export * from "./string";
+export * from "./url";
+
+// file 族：含 `IFile` 等与 `upload/*` 重名的导出，故不用 `export *` 聚合，
+// 改为显式具名再导出，既避免命名冲突又让 2.0 线包可从根入口取用。
+export {
+  getFileExt,
+  getFileName,
+  getFullFileName,
+  getUFileName,
+  getFileNameExt,
+  mergeFileName,
+} from "./file/fileName";
+export {
+  getFileType,
+  getFileTypeExt,
+  getFileTypeStr,
+  checkUrlSuffix,
+  checkImageUrl,
+  checkVideoUrl,
+  checkAudioUrl,
+  isValidMediaType,
+  TYPE_VIDEO,
+  TYPE_IMG,
+  TYPE_AUDIO,
+} from "./file/fileType";
+export { getFileURL, type IFile } from "./file/file";

package/src/nanoid.ts

@@ -1,19 +1,19 @@
-import { customAlphabet } from "nanoid";
-
-/**
- * 指定 nanoid 字符集合
- * 数字和大小写字母
- */
-export const numALetters = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-
-/** nanoid 数字和大小写字母 */
-export const nanoidNumALetters = customAlphabet(numALetters, 8);
-
-/**
- * 指定 nanoid 字符集合
- * 数字和大小写字母
- */
-export const numALettersAUrl = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_~";
-
-/** nanoid url 参数规范 */
-export const nanoidUrl = customAlphabet(numALettersAUrl, 20);
+import { customAlphabet } from "nanoid";
+
+/**
+ * 指定 nanoid 字符集合
+ * 数字和大小写字母
+ */
+export const numALetters = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+
+/** nanoid 数字和大小写字母 */
+export const nanoidNumALetters = customAlphabet(numALetters, 8);
+
+/**
+ * 指定 nanoid 字符集合
+ * 数字和大小写字母
+ */
+export const numALettersAUrl = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_~";
+
+/** nanoid url 参数规范 */
+export const nanoidUrl = customAlphabet(numALettersAUrl, 20);