@hzab/list-render 1.10.2 → 1.10.4

package/src/common/handleQuerySchema.ts

@@ -1,302 +1,576 @@
-import _ from "lodash";
-import { getFieldMap } from "./utils";
-import { isRunStr, handleSchemaStrVal, isScopeKey as formIsScopeKey, getScopeKeyVal } from '@hzab/form-render/src/common/schema-handler';
-
-export const handleQuerySchema = (opt) => {
-  const { schema, search, filters, onSearch, replaceComList, schemaScope } = opt || {};
-  const queryProperties = {};
-  let index = 0;
-  if (search) {
-    // @ts-ignore
-    queryProperties.search = handleSearch({ search, onSearch, index });
-    index += 1;
-  }
-
-  const fieldMap = getFieldMap(_.cloneDeep(schema));
-  filters?.forEach((key) => {
-    const item = fieldMap[key];
-    if (item) {
-      const xComponent = item["x-component"];
-      const replaceItem = replaceComList?.find((it) => it.name === key || (!it.name && it.component === xComponent));
-
-      const itemConf = {
-        ...item,
-        ...replaceItem,
-        required: false,
-        "x-index": index,
-        "x-display": "visible",
-      };
-
-      // 处理 props 不存在、从 scope 中获取的情况
-      const comProps = itemConf["x-component-props"];
-      if (!comProps) {
-        itemConf["x-component-props"] = {};
-      } else if (isScopeKey(comProps)) {
-        itemConf["x-component-props"] = getValByScope(comProps, schemaScope) || {};
-      }
-
-      if (typeof itemConf["x-component-props"].allowClear !== "boolean") {
-        itemConf["x-component-props"].allowClear = true;
-      }
-
-      handleInput(itemConf, opt);
-      handleSelect(itemConf, opt);
-      rmUnusedParams(itemConf, opt);
-
-      // 处理快捷提交
-      handleShortcutSubmit(itemConf, opt);
-
-      queryProperties[key] = itemConf;
-      index += 1;
-    } else if (key === "$timerange") {
-      queryProperties[key] = handleTimerange({ index, key });
-      index += 1;
-    }
-  });
-
-  return {
-    form: {
-      layout: "inline",
-    },
-    schema: {
-      type: "object",
-      properties: queryProperties,
-      "x-designable-id": "querySchema",
-    },
-  };
-};
-
-/**
- * 处理 search
- * @param param0
- * @returns
- */
-export const handleSearch = (opt) => {
-  const { search, onSearch, index } = opt || {};
-  const conf = {
-    type: "string",
-    title: "",
-    "x-decorator": "FormItem",
-    "x-component": "Input",
-    "x-validator": [],
-    "x-component-props": {
-      allowClear: true,
-      placeholder: search,
-      onPressEnter: onSearch,
-    },
-    "x-decorator-props": {},
-    "x-designable-id": "searchInput",
-    "x-index": index,
-    name: "search",
-    description: "",
-  };
-  // 清除事件
-  return handleInputClear(conf, opt);
-};
-
-/**
- * 把选择相关组件切换成下拉菜单
- */
-export const handleSelect = (conf, opt) => {
-  const { selectList = [], isSelectSearch = true } = opt || {};
-  const _selectList = ["Select", "Radio.Group", "Checkbox.Group", ...selectList];
-  const xComponent = conf["x-component"];
-  if (_selectList.includes(xComponent)) {
-    conf["x-component"] = "Select";
-    conf["x-component-props"].showSearch = isSelectSearch;
-  }
-  return conf;
-};
-
-/**
- * 把输入相关组件切换成 Input
- */
-export const handleInput = (conf, opt) => {
-  const { inputList = [] } = opt || {};
-  const _inputList = ["NumberPicker", ...inputList];
-  const xComponent = conf["x-component"];
-  if (_inputList.includes(xComponent)) {
-    conf["x-component"] = "Input";
-  }
-  return conf;
-};
-
-/**
- * 去除无关参数
- * @param conf
- * @param opt
- * @returns
- */
-export const rmUnusedParams = (conf, opt) => {
-  const { isRmDefault, isRmValidator } = opt || {};
-  // 去除默认值
-  if (isRmDefault) {
-    conf.default = undefined;
-    conf["x-component-props"].defaultValue = undefined;
-  }
-  // 去除校验
-  if (isRmValidator) {
-    conf["x-validator"] = [];
-  }
-  return conf;
-};
-
-export const handleTimerange = ({ key, index }) => {
-  return {
-    type: "string[]",
-    title: "时间范围",
-    "x-decorator": "FormItem",
-    "x-component": "DatePicker.RangePicker",
-    "x-validator": [],
-    "x-component-props": {
-      picker: "date",
-      showTime: true,
-      allowClear: true,
-    },
-    "x-decorator-props": {},
-    name: key,
-    "x-designable-id": key,
-    "x-index": index,
-  };
-};
-
-/**
- * 处理快捷提交逻辑
- * @param conf
- * @param opt
- */
-export const handleShortcutSubmit = (conf, opt) => {
-  const { isEnterSubmit = true, isChangeSubmit = true, onSearch, customSubmitList } = opt || {};
-  const xComponent = conf["x-component"];
-  const xComponentProps = conf["x-component-props"];
-  const onChangeList = [
-    "Select",
-    "Cascader",
-    "TreeSelect",
-    "DatePicker",
-    "DatePicker.RangePicker",
-    "TimePicker",
-    "TimePicker.RangePicker",
-  ];
-
-  // 输入框
-  if (isEnterSubmit && xComponent === "Input") {
-    const onPressEnter = getSchemaVal(xComponentProps?.onPressEnter, opt);
-    conf["x-component-props"].onPressEnter = function (e, ...args) {
-      e?.preventDefault && e?.preventDefault();
-      // 阻止默认事件，解决单个 input 提交问题
-      const res = onPressEnter && onPressEnter(e, ...args);
-      onSearch && onSearch();
-      return res;
-    };
-    // 清除事件
-    handleInputClear(conf, opt);
-  } else if (isChangeSubmit && onChangeList.includes(xComponent)) {
-    conf["x-component-props"].onChange = handleHoc(xComponentProps?.onChange, onSearch, opt);
-  }
-  // 处理自定义组件快捷提交逻辑
-  const item = customSubmitList?.find((it) => it.component === xComponent);
-  if (item) {
-    conf["x-component-props"][item.event] = handleHoc(xComponentProps[item.event], onSearch, opt);
-  }
-};
-
-/**
- * 事件拦截，处理调用额外函数
- * @param source
- * @param cb
- * @returns
- */
-export const handleHoc = (source, cb, opt) => {
-  return async function (...args) {
-    const { schemaScope } = opt;
-    let _source = getSchemaVal(source, schemaScope);
-
-    let res = null;
-    if (isRunStr(source)) {
-
-      _source = handleSchemaStrVal(source, schemaScope);
-    }
-    if (formIsScopeKey(source, schemaScope)) {
-      _source = getScopeKeyVal(source, schemaScope);
-    }
-    if (_source) {
-      res = await _source(...args);
-    }
-    cb && cb(...args);
-    return res;
-  };
-};
-
-/**
- * input 清除事件
- * @param conf
- * @param opt
- * @returns
- */
-export const handleInputClear = (conf, opt) => {
-  const { onSearch, schemaScope } = opt || {};
-  const onChange = getSchemaVal(conf["x-component-props"]?.onChange, schemaScope);
-  conf["x-component-props"].onChange = function (e, ...args) {
-    const res = onChange && onChange(e, ...args);
-    if (e.type === "click" && e.target?.value === "") {
-      onSearch();
-    }
-    return res;
-  };
-  return conf;
-};
-
-/**
- * 是否是 scope key
- * @param strKey
- * @returns
- */
-export const isScopeKey = (strKey) => {
-  if (typeof strKey !== "string") {
-    return false;
-  }
-  const key = strKey.trim();
-  return key.startsWith("{{") && key.endsWith("}}");
-};
-
-/**
- * 获取 scope key
- * @param strKey
- * @returns
- */
-export const getScopeKey = (strKey) => {
-  if (!isScopeKey(strKey)) {
-    return "";
-  }
-  const key = strKey.trim();
-  return key.replace(/^\{\{/, "").replace(/\}\}$/, "");
-};
-
-/**
- * 通过字符串获取 schemaScope 中的数据
- * @param strKey
- * @param schemaScope
- * @returns
- */
-export const getSchemaVal = (strKey, schemaScope = {}) => {
-  const val = getValByScope(strKey, schemaScope);
-  if (!_.isNil(val) && val !== "") {
-    return val;
-  }
-  return strKey;
-};
-
-/**
- * 通过字符串获取 schemaScope 中的数据
- * @param strKey
- * @param schemaScope
- * @returns
- */
-export const getValByScope = (strKey, schemaScope = {}) => {
-  if (isScopeKey(strKey)) {
-    return schemaScope && schemaScope[getScopeKey(strKey)];
-  }
-};
-
-export default handleQuerySchema;
+import _ from "lodash";
+import { getFieldMap } from "./utils";
+import {
+  isRunStr,
+  handleSchemaStrVal,
+  isScopeKey as formIsScopeKey,
+  getScopeKeyVal,
+} from "@hzab/form-render/src/common/schema-handler";
+import { URL_PARAM_NAME } from "./constant";
+
+// ===================== 类型定义 =====================
+
+type AntdDateComponent = "DatePicker" | "DatePicker.RangePicker";
+
+interface XComponentProps {
+  isSplitTimes?: boolean;
+  startKey?: string;
+  endKey?: string;
+  [k: string]: unknown;
+}
+
+interface FormilyField {
+  type?: string;
+  title?: string;
+  "x-decorator"?: string;
+  "x-component"?: string;
+  "x-validator"?: unknown[];
+  "x-component-props"?: XComponentProps;
+  "x-decorator-props"?: Record<string, unknown>;
+  "x-designable-id"?: string;
+  "x-index"?: number;
+  [k: string]: unknown;
+}
+
+interface FormilyV1SchemaNode {
+  type?: string;
+  properties?: Record<string, FormilyField>;
+  [k: string]: unknown;
+}
+
+interface FormilyV1Schema {
+  form?: Record<string, unknown>;
+  schema: FormilyV1SchemaNode;
+}
+
+type URLQueryObject = Record<string, any> | null | undefined;
+
+interface ExtractOptions {
+  /** 分拆开关字段名，位于 x-component-props；默认 'isSplitTimes' */
+  splitFlag?: string;
+  /** 分拆开关的期望值；默认 true */
+  splitFlagExpectedValue?: unknown;
+  /** 默认开始/结束键名（当 schema 未显式配置时），默认 'startTime' / 'endTime' */
+  defaultStartKey?: string;
+  defaultEndKey?: string;
+  /** 认为是 antd 日期组件的名单，默认 DatePicker / DatePicker.RangePicker */
+  antdDateComponents?: readonly AntdDateComponent[];
+  /**
+   * 命中并成功赋值后，是否从返回对象中删除对应的 startKey / endKey
+   * 默认 true（删除）
+   */
+  removeMatchedKeys?: boolean;
+}
+
+export const handleQuerySchema = (opt) => {
+  const { schema, search, filters, onSearch, replaceComList, schemaScope } = opt || {};
+  const queryProperties = {};
+  let index = 0;
+  if (search) {
+    // @ts-ignore
+    queryProperties.search = handleSearch({ search, onSearch, index });
+    index += 1;
+  }
+
+  const fieldMap = getFieldMap(_.cloneDeep(schema));
+  filters?.forEach((key) => {
+    const item = fieldMap[key];
+    if (item) {
+      const xComponent = item["x-component"];
+      const replaceItem = replaceComList?.find((it) => it.name === key || (!it.name && it.component === xComponent));
+
+      const itemConf = {
+        ...item,
+        ...replaceItem,
+        required: false,
+        "x-index": index,
+        "x-display": "visible",
+      };
+
+      // 处理 props 不存在、从 scope 中获取的情况
+      const comProps = itemConf["x-component-props"];
+      if (!comProps) {
+        itemConf["x-component-props"] = {};
+      } else if (isScopeKey(comProps)) {
+        itemConf["x-component-props"] = getValByScope(comProps, schemaScope) || {};
+      }
+
+      if (typeof itemConf["x-component-props"].allowClear !== "boolean") {
+        itemConf["x-component-props"].allowClear = true;
+      }
+
+      handleInput(itemConf, opt);
+      handleSelect(itemConf, opt);
+      rmUnusedParams(itemConf, opt);
+
+      // 处理快捷提交
+      handleShortcutSubmit(itemConf, opt);
+
+      queryProperties[key] = itemConf;
+      index += 1;
+    } else if (key === "$timerange") {
+      queryProperties[key] = handleTimerange({ index, key });
+      index += 1;
+    }
+  });
+
+  return {
+    form: {
+      layout: "inline",
+    },
+    schema: {
+      type: "object",
+      properties: queryProperties,
+      "x-designable-id": "querySchema",
+    },
+  };
+};
+
+/**
+ * 处理 search
+ * @param param0
+ * @returns
+ */
+export const handleSearch = (opt) => {
+  const { search, onSearch, index } = opt || {};
+  const conf = {
+    type: "string",
+    title: "",
+    "x-decorator": "FormItem",
+    "x-component": "Input",
+    "x-validator": [],
+    "x-component-props": {
+      allowClear: true,
+      placeholder: search,
+      onPressEnter: onSearch,
+    },
+    "x-decorator-props": {},
+    "x-designable-id": "searchInput",
+    "x-index": index,
+    name: "search",
+    description: "",
+  };
+  // 清除事件
+  return handleInputClear(conf, opt);
+};
+
+/**
+ * 把选择相关组件切换成下拉菜单
+ */
+export const handleSelect = (conf, opt) => {
+  const { selectList = [], isSelectSearch = true } = opt || {};
+  const _selectList = ["Select", "Radio.Group", "Checkbox.Group", ...selectList];
+  const xComponent = conf["x-component"];
+  if (_selectList.includes(xComponent)) {
+    conf["x-component"] = "Select";
+    conf["x-component-props"].showSearch = isSelectSearch;
+  }
+  return conf;
+};
+
+/**
+ * 把输入相关组件切换成 Input
+ */
+export const handleInput = (conf, opt) => {
+  const { inputList = [] } = opt || {};
+  const _inputList = ["NumberPicker", ...inputList];
+  const xComponent = conf["x-component"];
+  if (_inputList.includes(xComponent)) {
+    conf["x-component"] = "Input";
+  }
+  return conf;
+};
+
+/**
+ * 去除无关参数
+ * @param conf
+ * @param opt
+ * @returns
+ */
+export const rmUnusedParams = (conf, opt) => {
+  const { isRmDefault, isRmValidator } = opt || {};
+  // 去除默认值
+  if (isRmDefault) {
+    conf.default = undefined;
+    conf["x-component-props"].defaultValue = undefined;
+  }
+  // 去除校验
+  if (isRmValidator) {
+    conf["x-validator"] = [];
+  }
+  return conf;
+};
+
+export const handleTimerange = ({ key, index }) => {
+  return {
+    type: "string[]",
+    title: "时间范围",
+    "x-decorator": "FormItem",
+    "x-component": "DatePicker.RangePicker",
+    "x-validator": [],
+    "x-component-props": {
+      picker: "date",
+      showTime: true,
+      allowClear: true,
+    },
+    "x-decorator-props": {},
+    name: key,
+    "x-designable-id": key,
+    "x-index": index,
+  };
+};
+
+/**
+ * 处理快捷提交逻辑
+ * @param conf
+ * @param opt
+ */
+export const handleShortcutSubmit = (conf, opt) => {
+  const { isEnterSubmit = true, isChangeSubmit = true, onSearch, customSubmitList } = opt || {};
+  const xComponent = conf["x-component"];
+  const xComponentProps = conf["x-component-props"];
+  const onChangeList = [
+    "Select",
+    "Cascader",
+    "TreeSelect",
+    "DatePicker",
+    "DatePicker.RangePicker",
+    "TimePicker",
+    "TimePicker.RangePicker",
+  ];
+
+  // 输入框
+  if (isEnterSubmit && xComponent === "Input") {
+    const onPressEnter = getSchemaVal(xComponentProps?.onPressEnter, opt);
+    conf["x-component-props"].onPressEnter = function (e, ...args) {
+      e?.preventDefault && e?.preventDefault();
+      // 阻止默认事件，解决单个 input 提交问题
+      const res = onPressEnter && onPressEnter(e, ...args);
+      onSearch && onSearch();
+      return res;
+    };
+    // 清除事件
+    handleInputClear(conf, opt);
+  } else if (isChangeSubmit && onChangeList.includes(xComponent)) {
+    conf["x-component-props"].onChange = handleHoc(xComponentProps?.onChange, onSearch, opt);
+  }
+  // 处理自定义组件快捷提交逻辑
+  const item = customSubmitList?.find((it) => it.component === xComponent);
+  if (item) {
+    conf["x-component-props"][item.event] = handleHoc(xComponentProps[item.event], onSearch, opt);
+  }
+};
+
+/**
+ * 事件拦截，处理调用额外函数
+ * @param source
+ * @param cb
+ * @returns
+ */
+export const handleHoc = (source, cb, opt) => {
+  return async function (...args) {
+    const { schemaScope } = opt;
+    let _source = getSchemaVal(source, schemaScope);
+
+    let res = null;
+    if (isRunStr(source)) {
+      _source = handleSchemaStrVal(source, schemaScope);
+    }
+    if (formIsScopeKey(source, schemaScope)) {
+      _source = getScopeKeyVal(source, schemaScope);
+    }
+    if (_source) {
+      res = await _source(...args);
+    }
+    cb && cb(...args);
+    return res;
+  };
+};
+
+/**
+ * input 清除事件
+ * @param conf
+ * @param opt
+ * @returns
+ */
+export const handleInputClear = (conf, opt) => {
+  const { onSearch, schemaScope } = opt || {};
+  const onChange = getSchemaVal(conf["x-component-props"]?.onChange, schemaScope);
+  conf["x-component-props"].onChange = function (e, ...args) {
+    const res = onChange && onChange(e, ...args);
+    if (e.type === "click" && e.target?.value === "") {
+      onSearch();
+    }
+    return res;
+  };
+  return conf;
+};
+
+/**
+ * 是否是 scope key
+ * @param strKey
+ * @returns
+ */
+export const isScopeKey = (strKey) => {
+  if (typeof strKey !== "string") {
+    return false;
+  }
+  const key = strKey.trim();
+  return key.startsWith("{{") && key.endsWith("}}");
+};
+
+/**
+ * 获取 scope key
+ * @param strKey
+ * @returns
+ */
+export const getScopeKey = (strKey) => {
+  if (!isScopeKey(strKey)) {
+    return "";
+  }
+  const key = strKey.trim();
+  return key.replace(/^\{\{/, "").replace(/\}\}$/, "");
+};
+
+/**
+ * 通过字符串获取 schemaScope 中的数据
+ * @param strKey
+ * @param schemaScope
+ * @returns
+ */
+export const getSchemaVal = (strKey, schemaScope = {}) => {
+  const val = getValByScope(strKey, schemaScope);
+  if (!_.isNil(val) && val !== "") {
+    return val;
+  }
+  return strKey;
+};
+
+/**
+ * 通过字符串获取 schemaScope 中的数据
+ * @param strKey
+ * @param schemaScope
+ * @returns
+ */
+export const getValByScope = (strKey, schemaScope = {}) => {
+  if (isScopeKey(strKey)) {
+    return schemaScope && schemaScope[getScopeKey(strKey)];
+  }
+};
+
+function removeEmptyValues(obj) {
+  return _.pickBy(obj, (value) => {
+    // 排除 undefined 和 null
+    if (value == null) return false;
+
+    // 排除空字符串
+    if (_.isString(value) && value.trim() === "") return false;
+
+    // 排除空数组
+    if (_.isArray(value) && value.length === 0) return false;
+
+    // 保留其他值（包括 0、false、非空对象等）
+    return true;
+  });
+}
+
+/**
+ * 将对象序列化后写入 URL query 中
+ * @param obj 要存储的对象（保持原始类型）
+ * @param paramName query 参数名
+ */
+export function setURLObjectQueryParam<T extends object>(obj: T, paramName = URL_PARAM_NAME): void {
+  try {
+    if (typeof window === "undefined") return;
+
+    const href = window.location.href;
+    const [origin, hash = ""] = href.split("#");
+    const [path, queryString = ""] = hash.split("?");
+    const searchParams = new URLSearchParams(queryString);
+    // 指定的空值不设置
+    const copyObj = _.cloneDeep(removeEmptyValues(obj));
+
+    const encoded = encodeURIComponent(JSON.stringify(copyObj));
+
+    searchParams.set(paramName, encoded);
+
+    const newHash = `${path}?${searchParams.toString()}`;
+
+    window.history.replaceState({}, "", `${origin}#${newHash}`);
+  } catch (e) {
+    console.error(`[setURLObjectQueryParam] 设置失败:`, e);
+  }
+}
+
+/**
+ * 从哈希路由的查询参数中，删除某个“对象型参数”下的指定属性（不刷新页面）
+ * @param parentKey  父级对象参数名
+ * @param childKey   要删除的对象属性名
+ */
+export function removeURLObjectQueryParam(parentKey: string, childKey: string, reset?: boolean): void {
+  if (typeof window === "undefined") return;
+
+  try {
+    const href = window.location.href;
+    const [origin, hash = ""] = href.split("#");
+    const [hashPath, queryString = ""] = hash.split("?");
+    const searchParams = new URLSearchParams(queryString);
+
+    const raw = searchParams.get(parentKey);
+    if (raw == null) return;
+
+    // URLSearchParams.get 已自动做了百分号解码，但是可能会遇到编码两次的情况，因此这里再尝试解码一次
+    let obj: unknown;
+    try {
+      obj = JSON.parse(decodeURIComponent(raw));
+    } catch {
+      // 若不是合法 JSON，就不处理该参数
+      console.error(`[removeURLObjectQueryParam] 序列化URL参数错误`);
+      return;
+    }
+
+    // 如果是重置，直接清空整个parentKey
+    if (reset && parentKey) searchParams.delete(parentKey);
+    else {
+      if (obj && typeof obj === "object" && !Array.isArray(obj)) {
+        const record = obj as Record<string, unknown>;
+        // 删除空值key
+        if (childKey || record[childKey] === "" || record[childKey] === undefined || record[childKey] === null)
+          delete record[childKey];
+
+        // 如果对象被删空，则移除整个 parentKey；否则写回
+        if (Object.keys(record).length === 0) {
+          searchParams.delete(parentKey);
+        } else {
+          searchParams.set(parentKey, encodeURIComponent(JSON.stringify(record)));
+        }
+      } else {
+        // parentKey 的值不是对象，安全起见不处理
+        return;
+      }
+    }
+
+    // 重建哈希部分
+    let newHash = hashPath;
+    const qs = searchParams.toString();
+    if (qs) newHash += `?${qs}`;
+
+    const newUrl = `${origin}${newHash ? `#${newHash}` : ""}`;
+    window.history.replaceState({}, "", newUrl);
+  } catch (e) {
+    console.error(`[removeURLObjectQueryParam] 删除失败:`, e);
+  }
+}
+
+/**
+ * 从 URL 中解析序列化的对象
+ * @param paramName query 参数名
+ * @returns 还原的对象（如果不存在返回 null）
+ */
+export function getURLObjectQueryParam<T = any>(paramName = URL_PARAM_NAME): T | Record<string, any> {
+  // 返回空对象是为了防止在合并对象时报错导致页面空白
+  if (typeof window === "undefined") return {};
+
+  const href = window.location.href;
+  const [, hash = ""] = href.split("#");
+  const [, queryString = ""] = hash.split("?");
+  const searchParams = new URLSearchParams(queryString);
+  const encoded = searchParams.get(paramName);
+
+  if (!encoded) return null;
+
+  try {
+    return JSON.parse(decodeURIComponent(encoded)) as T;
+  } catch (e) {
+    console.error(`[getURLObjectQueryParam] 解析失败:`, e);
+    return {};
+  }
+}
+
+// ===================== 辅助函数 =====================
+
+const pickFormilyProperties = (schema: FormilyV1Schema): Record<string, FormilyField> =>
+  schema?.schema?.properties ?? {};
+
+const isAntdDateComponent = (comp: unknown, whitelist: readonly string[]) =>
+  typeof comp === "string" && whitelist.includes(comp);
+
+const filterKeys = (props: Record<string, FormilyField>, filters: readonly string[]) => {
+  const filterSet = new Set(filters);
+  return Object.entries(props).filter(([k]) => filterSet.has(k));
+};
+
+const matchSplitFlag = (field: FormilyField, splitFlag: string, expected: unknown) =>
+  field?.["x-component-props"]?.[splitFlag] === expected;
+
+/** 两个值都缺失则返回 undefined；否则返回二元组 */
+const getRangeTupleOrUndefined = (urlObj: URLQueryObject, startKey: string, endKey: string): [any, any] | undefined => {
+  const obj = (urlObj ?? {}) as Record<string, any>;
+  const hasStart = Object.prototype.hasOwnProperty.call(obj, startKey);
+  const hasEnd = Object.prototype.hasOwnProperty.call(obj, endKey);
+  if (!hasStart && !hasEnd) return undefined;
+  return [obj[startKey], obj[endKey]];
+};
+
+// ===================== 主函数 =====================
+/**
+ * 根据formilySchema配置逆解析表单key并将url query赋值
+ * 三层筛选：根据filters + splitFlag + antdDateComponents 提取formilySchema配置项然后通过配置的key赋值并返回
+ * */
+export function extractSplitDateRanges(
+  filters: string[],
+  formilySchema: FormilyV1Schema,
+  urlObj: URLQueryObject,
+  options: ExtractOptions = {},
+): Record<string, any> {
+  const {
+    splitFlag = "isSplitTimes",
+    splitFlagExpectedValue = true,
+    defaultStartKey = "startTime",
+    defaultEndKey = "endTime",
+    antdDateComponents = ["DatePicker", "DatePicker.RangePicker"],
+    removeMatchedKeys = true,
+  } = options;
+
+  const properties = pickFormilyProperties(formilySchema);
+  const candidates = filterKeys(properties, filters);
+
+  // 保持不变性
+  const base = _.cloneDeep(urlObj) as Record<string, any>;
+
+  // 统一延迟删除，避免顺序影响
+  const keysToDelete = new Set<string>();
+
+  for (const [fieldKey, field] of candidates) {
+    // 未命中则直接跳过本次循环
+    if (!isAntdDateComponent(field?.["x-component"], antdDateComponents)) continue;
+    if (!matchSplitFlag(field, splitFlag, splitFlagExpectedValue)) continue;
+
+    const props = field?.["x-component-props"] ?? {};
+    const startKey = (props?.startKey as string) || defaultStartKey;
+    const endKey = (props?.endKey as string) || defaultEndKey;
+
+    const tuple = getRangeTupleOrUndefined(base, startKey, endKey);
+    if (!tuple) continue; // 两个值都没有则不赋值、不删除
+
+    // 命中，给 fieldKey 赋值
+    base[fieldKey] = tuple;
+
+    // 按需记录要删除的键（只删除“命中的”）
+    if (removeMatchedKeys) {
+      if (Object.prototype.hasOwnProperty.call(base, startKey)) keysToDelete.add(startKey);
+      if (Object.prototype.hasOwnProperty.call(base, endKey)) keysToDelete.add(endKey);
+    }
+  }
+
+  // 统一执行删除，保证无顺序副作用
+  if (removeMatchedKeys) {
+    for (const k of keysToDelete) {
+      delete base[k];
+    }
+  }
+
+  return base;
+}
+
+export default handleQuerySchema;