@hzab/utils 1.0.5 → 1.0.7

package/changelog.md

@@ -1,3 +1,11 @@
+# @hzab/utils@1.0.7
+
+feat: formily schema clone fn
+
+# @hzab/utils@1.0.6
+
+feat: formily global components management
+
 # @hzab/utils@1.0.5
 
 fix: upload 文件名简化

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hzab/utils",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "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/formily/global-components.ts

@@ -0,0 +1,48 @@
+/**
+ * formily 全局组件
+ * 项目初始化时进行 formily 组件的挂载，解决 form render 组件日益庞大的问题。
+ */
+window.formilyGlobalComponents = {};
+
+/**
+ * 获取全局 formily 组件对象
+ * @returns {Object} formilyGlobalComponents
+ */
+export const getFormilyGlobalComponents = function () {
+  return window.formilyGlobalComponents || {};
+};
+
+/**
+ * 批量设置全局 formily 组件
+ * @param {Object} components
+ * @returns {Object} formilyGlobalComponents
+ */
+export const setFormilyGlobalComponents = function (components) {
+  Object.assign(window.formilyGlobalComponents, components);
+  return window.formilyGlobalComponents;
+};
+
+/**
+ * 单个设置全局 formily 组件
+ * @returns {Object} formilyGlobalComponents
+ */
+/**
+ * 单个设置全局 formily 组件
+ * @param {string} key
+ * @param {ReactComponent} component
+ * @returns {Object} formilyGlobalComponents
+ */
+export const setFormilyGlobalComponent = function (key, component) {
+  window.formilyGlobalComponents[key] = component;
+  return window.formilyGlobalComponents;
+};
+
+/**
+ * 单个删除全局 formily 组件
+ * @param {string} key
+ * @returns {Object} formilyGlobalComponents
+ */
+export const rmFormilyGlobalComponents = function (key) {
+  delete window.formilyGlobalComponents[key];
+  return window.formilyGlobalComponents;
+};