@dazhicheng/ui 1.5.198 → 1.5.201

package/dist/components/tt-form/src/formApi.js

@@ -0,0 +1,790 @@
+var L = Object.defineProperty;
+var O = (u, t, e) => t in u ? L(u, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : u[t] = e;
+var h = (u, t, e) => O(u, typeof t != "symbol" ? t + "" : t, e);
+import R from "dayjs";
+import "dayjs/plugin/timezone";
+import { reactive as $, unref as y, isRef as b, toRaw as F } from "vue";
+import { set as A, get as w, has as T, cloneDeep as E } from "lodash-es";
+import { asFieldArrayContext as H } from "./types/forms.js";
+import { childArrayPath as P, normalizeArrayFieldPath as g, collectArrayFieldPathAliases as C } from "./utils/array-path.js";
+import { Store as j } from "@tanstack/vue-store";
+import { StateHandler as Y, bindMethods as z, isFunction as S, mergeWithArrayOverride as V, createMerge as B, isObject as v, isDayjsObject as N, isDate as M } from "@dazhicheng/utils";
+import { isFormSchema as I, shouldSeedAppendedFieldValue as k, resolveSchemaFieldInitialValue as U, resolveArrayFieldInitialValueWithRuntime as W, resolveParentItemPathFromArrayPath as q } from "./useFormContext.js";
+function x() {
+  return {
+    actionWrapperClass: "",
+    collapsed: !1,
+    collapsedRows: 1,
+    collapseTriggerResize: !1,
+    commonConfig: {},
+    handleReset: void 0,
+    handleSubmit: void 0,
+    handleValuesChange: void 0,
+    handleCollapsedChange: void 0,
+    layout: "horizontal",
+    resetButtonOptions: {},
+    schema: [],
+    scrollToFirstError: !1,
+    showCollapseButton: !1,
+    showDefaultActions: !0,
+    submitButtonOptions: {},
+    submitOnChange: !1,
+    submitOnEnter: !1,
+    wrapperClass: "grid-cols-1"
+  };
+}
+function D(u, t = "YYYY-MM-DD") {
+  try {
+    const e = R.isDayjs(u) ? u : R(u);
+    if (!e.isValid())
+      throw new Error("Invalid date");
+    return e.tz().format(t);
+  } catch {
+    return String(u ?? "");
+  }
+}
+class ie {
+  constructor(t = {}) {
+    // private api: Pick<TtFormProps, 'handleReset' | 'handleSubmit'>;
+    h(this, "form", {});
+    h(this, "isMounted", !1);
+    h(this, "state", null);
+    h(this, "stateHandler");
+    h(this, "store");
+    h(this, "_arrayFields", $(/* @__PURE__ */ new Map()));
+    /**
+     * 组件实例映射
+     */
+    h(this, "componentRefMap", /* @__PURE__ */ new Map());
+    /**
+     * @description 数组字段操作集合
+     */
+    h(this, "_arrayAction", {
+      /**
+       * @description 获取指定数组字段的操作上下文
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @returns 只读
+       */
+      get: (t) => {
+        const e = this._getArrayFieldActions(t);
+        if (!e) {
+          this._warnUnregisteredArrayField("get", t);
+          return;
+        }
+        return e;
+      },
+      /**
+       * @description 在数组末尾新增一项
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param value 要追加的数组项值
+       */
+      push: (t, e) => this._mutateArrayField(
+        "push",
+        t,
+        (r) => r.push(
+          this._resolveArrayItemValue(t, e, {
+            index: y(r.fields).length,
+            arrayLength: y(r.fields).length + 1
+          })
+        )
+      ),
+      /**
+       * @description 删除指定索引的项
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param idx 要删除的索引位置
+       */
+      remove: (t, e) => this._mutateArrayField("remove", t, (r) => r.remove(e)),
+      /**
+       * @description 整体替换数组值
+       * @template TValue 数组项类型
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param values 新的完整数组字段
+       */
+      replace: (t, e) => this._mutateArrayField("replace", t, (r) => r.replace(e)),
+      /**
+       * @description更新指定索引的项
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param idx 要更新的索引位置
+       * @param value 更新后的数组项值
+       */
+      update: (t, e, r) => this._mutateArrayField("update", t, (s) => s.update(e, r)),
+      /**
+       * @description 在指定索引插入一项
+       * @template TValue 数组项类型
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param idx 插入位置索引
+       * @param value 要插入的数组项值
+       */
+      insert: (t, e, r) => this._mutateArrayField(
+        "insert",
+        t,
+        (s) => s.insert(
+          e,
+          this._resolveArrayItemValue(t, r, {
+            index: e,
+            arrayLength: y(s.fields).length + 1
+          })
+        )
+      ),
+      /**
+       * @description 在数组头部新增一项
+       * @template TValue 数组项类型
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param value 要插入到头部的数组项值
+       */
+      prepend: (t, e) => this._mutateArrayField(
+        "prepend",
+        t,
+        (r) => r.prepend(
+          this._resolveArrayItemValue(t, e, {
+            index: 0,
+            arrayLength: y(r.fields).length + 1
+          })
+        )
+      ),
+      /**
+       * @description 将项从旧索引移动到新索引
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param oldIdx 原索引位置
+       * @param newIdx 新索引位置
+       */
+      move: (t, e, r) => this._mutateArrayField("move", t, (s) => s.move(e, r)),
+      /**
+       * @description 交换两个索引位置的项
+       * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
+       * @param indexA 第一个索引位置
+       * @param indexB 第二个索引位置
+       */
+      swap: (t, e, r) => this._mutateArrayField("swap", t, (s) => s.swap(e, r)),
+      /**
+       * @description 获取嵌套数组路径下的操作器
+       * @param parentPath 父数组路径（如 actions.data），或完整路径（仅传 path）
+       * @param index 父数组索引
+       * @param childField 子数组字段名（如 skills）
+       */
+      at: (t, e, r) => this._createNestedArrayHandle(P(t, e, r))
+    });
+    // 最后一次点击提交时的表单值
+    h(this, "latestSubmissionValues", null);
+    h(this, "prevState", null);
+    h(this, "handleMultiFields", (t) => {
+      var s;
+      const e = (s = this.state) == null ? void 0 : s.arrayToStringFields;
+      if (!e || !Array.isArray(e))
+        return;
+      const r = (i, n = ",") => {
+        this.processFields(i, n, t, (a, l) => {
+          if (Array.isArray(a))
+            return a.join(l);
+          if (typeof a == "string") {
+            if (a === "")
+              return [];
+            const c = l.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+            return a.split(new RegExp(c));
+          } else
+            return a;
+        });
+      };
+      if (e.every((i) => typeof i == "string")) {
+        const i = e[e.length - 1] || "", n = i.length === 1 ? e.slice(0, -1) : e, a = i.length === 1 ? i : ",";
+        r(n, a);
+        return;
+      }
+      e.forEach((i) => {
+        if (Array.isArray(i)) {
+          const [n, a = ","] = i;
+          if (!Array.isArray(n))
+            return;
+          r(n, a);
+        }
+      });
+    });
+    h(this, "handleRangeTimeValue", (t) => {
+      var s;
+      const e = { ...t }, r = (s = this.state) == null ? void 0 : s.fieldMappingTime;
+      return this.handleMultiFields(e), !r || !Array.isArray(r) || r.forEach(([i, [n, a], l = "YYYY-MM-DD"]) => {
+        if (n && a && e[i] === null && (Reflect.deleteProperty(e, n), Reflect.deleteProperty(e, a)), !e[i]) {
+          Reflect.deleteProperty(e, i);
+          return;
+        }
+        const [c, o] = e[i];
+        if (l === null)
+          e[n] = c, e[a] = o;
+        else if (S(l))
+          e[n] = l(c, n), e[a] = l(o, a);
+        else {
+          const [m, d] = Array.isArray(l) ? l : [l, l];
+          e[n] = c ? D(c, m) : void 0, e[a] = o ? D(o, d) : void 0;
+        }
+        Reflect.deleteProperty(e, i);
+      }), e;
+    });
+    h(this, "processFields", (t, e, r, s) => {
+      t.forEach((i) => {
+        const n = r[i];
+        n != null && (r[i] = s(n, e));
+      });
+    });
+    const { ...e } = t, r = x();
+    this.store = new j(
+      {
+        ...r,
+        ...e
+      },
+      {
+        onUpdate: () => {
+          this.prevState = this.state, this.state = this.store.state, this.updateState();
+        }
+      }
+    ), this.state = this.store.state, this.stateHandler = new Y(), z(this);
+  }
+  /**
+   * 获取字段组件实例
+   * @param fieldName 字段名
+   * @returns 组件实例
+   */
+  getFieldComponentRef(t) {
+    var r, s;
+    let e = this.componentRefMap.has(t) ? this.componentRefMap.get(t) : void 0;
+    return e && e.$.type.name === "AsyncComponentWrapper" && e.$.subTree.ref && (Array.isArray(e.$.subTree.ref) ? e.$.subTree.ref.length > 0 && b((r = e.$.subTree.ref[0]) == null ? void 0 : r.r) && (e = (s = e.$.subTree.ref[0]) == null ? void 0 : s.r.value) : b(e.$.subTree.ref.r) && (e = e.$.subTree.ref.r.value)), e;
+  }
+  /**
+   * 获取当前聚焦的字段，如果没有聚焦的字段则返回undefined
+   */
+  getFocusedField() {
+    for (const t of this.componentRefMap.keys()) {
+      const e = this.getFieldComponentRef(t);
+      if (e) {
+        let r = null;
+        if (e instanceof HTMLElement ? r = e : e.$el instanceof HTMLElement && (r = e.$el), !r)
+          continue;
+        if (r === document.activeElement || r.contains(document.activeElement))
+          return t;
+      }
+    }
+  }
+  getLatestSubmissionValues() {
+    return this.latestSubmissionValues || {};
+  }
+  getState() {
+    return this.state;
+  }
+  async getValues() {
+    const t = await this.getForm();
+    return t.values ? this.handleRangeTimeValue(t.values) : {};
+  }
+  async isFieldValid(t) {
+    return (await this.getForm()).isFieldValid(t);
+  }
+  merge(t) {
+    const e = [this, t], r = new Proxy(t, {
+      get(s, i) {
+        return i === "merge" ? (n) => (e.push(n), r) : i === "submitAllForm" ? async (n = !0) => {
+          try {
+            const a = await Promise.all(
+              e.map(async (l) => (await l.validate()).valid ? F(await l.getValues() || {}) : void 0)
+            );
+            return n ? Object.assign({}, ...a) : a;
+          } catch {
+          }
+        } : s[i];
+      }
+    });
+    return r;
+  }
+  mount(t, e) {
+    this.isMounted || (Object.assign(this.form, t), this.stateHandler.setConditionTrue(), this.setLatestSubmissionValues({
+      ...F(this.handleRangeTimeValue(this.form.values))
+    }), this.componentRefMap = e, this.isMounted = !0);
+  }
+  /**
+   * @description 为 appendFields 新增的字段写入初始值（与 useFormInitial 规则一致，不覆盖已有数据）
+   */
+  async seedDefaultsForAppendedFields(t) {
+    var s;
+    if (!this.isMounted || !((s = this.form) != null && s.values))
+      return;
+    const e = this.form.values, r = {};
+    for (const i of t) {
+      if (!I(i) || !k(e, i))
+        continue;
+      const n = U(i);
+      n !== void 0 && (r[i.fieldName] = n);
+    }
+    Object.keys(r).length > 0 && await this.setValues(r, !0, !1);
+  }
+  /**
+   * @description 增量追加字段到 schema 中，支持通过 position 指定插入位置
+   * @param {FormSchema[]} fields - 要插入的字段 schema 数组
+   * @param {object} [position] - 插入位置，省略则追加到末尾
+   * @param {string} [position.before] - 在指定 fieldName 之前插入
+   * @param {string} [position.after] - 在指定 fieldName 之后插入
+   * @example
+   * formApi.appendFields([{ fieldName: 'phone', component: 'ElInput', label: '手机号' }]);
+   * @example
+   * formApi.appendFields([newField], { after: 'email' });
+   * @example
+   * formApi.appendFields([newField], { before: 'name' });
+   */
+  appendFields(t, e) {
+    var i;
+    const r = [...((i = this.state) == null ? void 0 : i.schema) ?? []], s = (e == null ? void 0 : e.before) ?? (e == null ? void 0 : e.after);
+    if (s) {
+      const n = {};
+      r.forEach((l, c) => {
+        const o = l.fieldName;
+        A(n, o, c);
+      });
+      const a = w(n, s);
+      if (typeof a == "number") {
+        r.splice(e != null && e.before ? a : a + 1, 0, ...t), this.setState({ schema: r }), this.seedDefaultsForAppendedFields(t);
+        return;
+      }
+    }
+    r.push(...t), this.setState({ schema: r }), this.seedDefaultsForAppendedFields(t);
+  }
+  /**
+   * 根据字段名移除表单项
+   * @param fields
+   */
+  async removeSchemaByFields(t) {
+    var i;
+    const e = ((i = this.state) == null ? void 0 : i.schema) ?? [], r = {};
+    t.forEach((n) => {
+      A(r, n, !0);
+    });
+    const s = e.filter((n) => !w(r, n.fieldName));
+    this.setState({
+      schema: s
+    });
+  }
+  /**
+   * 重置表单
+   */
+  async resetForm(t, e) {
+    return (await this.getForm()).resetForm(t, e);
+  }
+  async resetValidate() {
+    const t = await this.getForm();
+    Object.keys(t.errors.value).forEach((r) => {
+      t.setFieldError(r, void 0);
+    });
+  }
+  /**
+   * 滚动到第一个错误字段
+   * @param errors 验证错误对象
+   */
+  scrollToFirstError(t) {
+    const e = typeof t == "string" ? t : Object.keys(t)[0];
+    if (!e)
+      return;
+    let r = document.querySelector(`[name="${e}"]`);
+    if (!r) {
+      const s = this.getFieldComponentRef(e);
+      s && s.$el instanceof HTMLElement && (r = s.$el);
+    }
+    r && r.scrollIntoView({
+      behavior: "smooth",
+      block: "center",
+      inline: "nearest"
+    });
+  }
+  async setFieldValue(t, e, r) {
+    (await this.getForm()).setFieldValue(t, e, r);
+  }
+  setLatestSubmissionValues(t) {
+    this.latestSubmissionValues = { ...F(t) };
+  }
+  setState(t) {
+    S(t) ? this.store.setState((e) => V(t(e), e)) : this.store.setState((e) => V(t, e));
+  }
+  /**
+   * 供子类覆盖：在 `setValues(fields, true)` 时用于白名单过滤的 fieldName 列表（默认取自 store 中的 `schema`）。
+   * @returns {string[]} 允许写入的字段名
+   */
+  getFieldNamesForSetValuesFilter() {
+    var t;
+    return (((t = this.state) == null ? void 0 : t.schema) ?? []).map((e) => e.fieldName).filter((e) => typeof e == "string" && e.length > 0);
+  }
+  /**
+   * 设置表单值
+   * @param fields record
+   * @param filterFields 为 true 时仅处理当前 schema 中已声明的 fieldName，并保留与现有值的深度合并规则；为 false 时原样交给 vee-validate。
+   *   配置了 `fieldMappingTime` 时，会先执行拆解→区间合并，再按本参数过滤：只要**区间主字段**在 schema（与 {@link FormApi.getFieldNamesForSetValuesFilter} 一致）中，合并后的主字段会留在 `mergedInput` 里，**默认 true 即可**。
+   *   仅当合并未发生（例如主字段不在 schema、`format` 为函数跳过）且入参里只剩**未在 schema 声明**的拆解键时，才需要传 `false` 才能把拆解字段写入 vee-validate。
+   * @param shouldValidate
+   */
+  async setValues(t, e = !0, r = !1) {
+    const s = await this.getForm(), i = this.mergeRangeTimeFieldsForSetValues(t);
+    if (!e) {
+      s.setValues(i, r);
+      return;
+    }
+    const n = this.getFieldNamesForSetValuesFilter(), a = new Set(n), l = { ...s.values };
+    for (const d of n)
+      T(l, d) || A(l, d, void 0);
+    const c = {};
+    for (const d of n)
+      a.has(d) && T(i, d) && A(c, d, w(i, d));
+    const o = B((d, f, p) => (f in d && (d[f] = !Array.isArray(d[f]) && v(d[f]) && !N(d[f]) && !M(d[f]) ? o(p, d[f]) : p), !0)), m = o(c, l);
+    s.setValues(m, r);
+  }
+  async submitForm(t) {
+    var s, i;
+    t == null || t.preventDefault(), t == null || t.stopPropagation(), await (await this.getForm()).submitForm();
+    const r = F(await this.getValues());
+    return await ((i = (s = this.state) == null ? void 0 : s.handleSubmit) == null ? void 0 : i.call(s, r)), r;
+  }
+  unmount() {
+    var t, e;
+    (e = (t = this.form) == null ? void 0 : t.resetForm) == null || e.call(t), this.latestSubmissionValues = null, this.isMounted = !1, this.stateHandler.reset();
+  }
+  updateSchema(t) {
+    var n;
+    const e = [...t];
+    if (!e.every((a) => Reflect.has(a, "fieldName") && a.fieldName))
+      return;
+    const s = [...((n = this.state) == null ? void 0 : n.schema) ?? []], i = {};
+    e.forEach((a) => {
+      a.fieldName && (i[a.fieldName] = a);
+    }), s.forEach((a, l) => {
+      const c = i[a.fieldName];
+      c && (s[l] = V(c, a));
+    }), this.setState({ schema: s });
+  }
+  async validate(t) {
+    var s;
+    const r = await (await this.getForm()).validate(t);
+    return Object.keys((r == null ? void 0 : r.errors) ?? {}).length > 0 && (s = this.state) != null && s.scrollToFirstError && this.scrollToFirstError(r.errors), r;
+  }
+  async validateAndSubmitForm() {
+    var s;
+    const t = await this.getForm(), { valid: e, errors: r } = await t.validate();
+    if (!e) {
+      (s = this.state) != null && s.scrollToFirstError && this.scrollToFirstError(r);
+      return;
+    }
+    return await this.submitForm();
+  }
+  async validateField(t, e) {
+    var i;
+    const s = await (await this.getForm()).validateField(t, e);
+    return Object.keys((s == null ? void 0 : s.errors) ?? {}).length > 0 && (i = this.state) != null && i.scrollToFirstError && this.scrollToFirstError(t), s;
+  }
+  async getForm() {
+    var t;
+    if (this.isMounted || await this.stateHandler.waitForCondition(), !((t = this.form) != null && t.meta))
+      throw new Error("<TtForm /> is not mounted");
+    return this.form;
+  }
+  /**
+   * 将拆解字段的空值归一为 undefined，其余原样返回。
+   * 回显时不做 dayjs / formatDate 转换：接口返回的值已经是组件可用的格式（字符串、Date、dayjs 等）。
+   * @param {unknown} raw 接口或拆解字段的值
+   * @returns {unknown} 空值归一为 undefined，其余原样返回
+   */
+  normalizeRangeValue(t) {
+    if (!(t == null || t === ""))
+      return t;
+  }
+  /**
+   * 判断主字段是否已为「合法」日期区间 [start, end]（两项均可解析为有效日期）。合法则不再用拆解字段覆盖。
+   * @param {unknown} value 主字段值
+   * @returns {boolean} 是否为合法区间
+   */
+  isValidRangeTimePair(t) {
+    if (!Array.isArray(t) || t.length !== 2)
+      return !1;
+    const [e, r] = t, s = (i) => {
+      var a;
+      if (i == null || i === "" || i === 0)
+        return !1;
+      if (N(i)) {
+        const l = i;
+        return ((a = l.isValid) == null ? void 0 : a.call(l)) !== !1;
+      }
+      return M(i) ? !Number.isNaN(i.getTime()) : R(i).isValid();
+    };
+    return s(e) && s(r);
+  }
+  /**
+   * 与 {@link FormApi.handleRangeTimeValue} 相反：在 `fieldMappingTime` 配置下，将拆解起止拼成区间字段。
+   * - 仅当**区间主字段**在当前 schema（{@link FormApi.getFieldNamesForSetValuesFilter}）中有定义时处理。
+   * - 若主字段**已是合法日期区间**，不合并，保持原有值与行为。
+   * - 否则（未赋值、0、空数组、或非合法区间等）在拆解字段有有效数据时合并，并移除拆解键。
+   * @param {Record<string, any>} fields 调用方传入的 setValues 数据
+   * @returns {Record<string, any>} 合并后的浅拷贝对象
+   */
+  mergeRangeTimeFieldsForSetValues(t) {
+    var i;
+    const e = (i = this.state) == null ? void 0 : i.fieldMappingTime;
+    if (!e || !Array.isArray(e) || e.length === 0)
+      return t;
+    const r = new Set(this.getFieldNamesForSetValuesFilter()), s = { ...t };
+    for (const n of e) {
+      if (!Array.isArray(n) || n.length < 2)
+        continue;
+      const a = n[0], l = n[1], c = n[2];
+      if (typeof a != "string" || !a || !Array.isArray(l) || l.length < 2)
+        continue;
+      const [o, m] = l;
+      if (typeof o != "string" || typeof m != "string" || !r.has(a) || this.isValidRangeTimePair(s[a]))
+        continue;
+      const d = Object.prototype.hasOwnProperty.call(s, o), f = Object.prototype.hasOwnProperty.call(s, m);
+      if (!d && !f)
+        continue;
+      const p = s[o], _ = s[m];
+      if (!(this.isSplitTimeEmptyValue(p) && this.isSplitTimeEmptyValue(_))) {
+        if (c === null)
+          s[a] = [p, _];
+        else {
+          if (S(c))
+            continue;
+          s[a] = [this.normalizeRangeValue(p), this.normalizeRangeValue(_)];
+        }
+        Reflect.deleteProperty(s, o), Reflect.deleteProperty(s, m);
+      }
+    }
+    return s;
+  }
+  /**
+   * 拆解字段是否为空（与「无有效起止」一致时不参与拼区间）。
+   * @param {unknown} value 拆解字段值
+   * @returns {boolean} 是否视为空
+   */
+  isSplitTimeEmptyValue(t) {
+    return t == null || t === "" || t === 0;
+  }
+  /**
+   * schema 变更后若存在从上一版 schema 中消失的 fieldName，会在 {@link FormApi.updateState} 中调用。
+   * 子类（如分组表单）可覆盖以同步清理虚拟校验缓存等。
+   * @param {string[]} removedFieldNames 已从 schema 中移除的字段名
+   */
+  onRemovedSchemaFields(t) {
+    var e, r, s, i, n, a, l, c;
+    for (const o of t)
+      (r = (e = this.form) == null ? void 0 : e.resetField) == null || r.call(e, o, {
+        value: void 0,
+        touched: !1,
+        errors: []
+      }), (i = (s = this.form) == null ? void 0 : s.setFieldValue) == null || i.call(s, o, void 0), (a = (n = this.form) == null ? void 0 : n.setFieldError) == null || a.call(n, o, void 0), (c = (l = this.form) == null ? void 0 : l.setFieldTouched) == null || c.call(l, o, !1);
+  }
+  /**
+   * store 更新后对比前后 `schema` 的 fieldName 集合，对已从 schema 中移除的字段清空 vee-validate 值与错误，
+   * 避免 `removeFields` / 删项后 `getValues` 仍带出旧字段。
+   */
+  updateState() {
+    var i, n;
+    const t = ((i = this.state) == null ? void 0 : i.schema) ?? [], e = ((n = this.prevState) == null ? void 0 : n.schema) ?? [], r = /* @__PURE__ */ new Set();
+    for (const a of t) {
+      if (!Reflect.has(a, "fieldName"))
+        continue;
+      const l = a.fieldName;
+      typeof l == "string" && l.length > 0 && r.add(l);
+    }
+    const s = [];
+    for (const a of e) {
+      if (!Reflect.has(a, "fieldName"))
+        continue;
+      const l = a.fieldName;
+      typeof l != "string" || !l.length || r.has(l) || s.push(l);
+    }
+    s.length && this.onRemovedSchemaFields(s);
+  }
+  /**
+   * @description 注册数组方法
+   * @param name 需要注册的数组字段
+   * @param actions 操作方法
+   */
+  registerArrayField(t, e, r) {
+    !t || !e || this._arrayFields.set(g(t), { actions: e, schema: r });
+  }
+  unregisterArrayField(t, e) {
+    var s;
+    if (!t) return;
+    const r = g(t);
+    e && ((s = this._arrayFields.get(r)) == null ? void 0 : s.actions) !== e || this._arrayFields.delete(r);
+  }
+  /** @description 数组字段操作集合 */
+  get arrayAction() {
+    return this._arrayAction;
+  }
+  /**
+   * @description 将业务传入路径规范化为数组注册表键
+   */
+  _resolveArrayFieldPath(t) {
+    return g(t);
+  }
+  _getRegisteredArrayFieldItem(t) {
+    if (!t)
+      return;
+    const e = this._resolveArrayFieldPath(t), r = this._arrayFields.get(e);
+    if (r)
+      return r;
+    for (const s of C(t)) {
+      const i = this._arrayFields.get(g(s));
+      if (i)
+        return i;
+    }
+  }
+  _getRegisteredArrayField(t) {
+    var e;
+    return (e = this._getRegisteredArrayFieldItem(t)) == null ? void 0 : e.actions;
+  }
+  _getArrayFieldActions(t) {
+    const e = this._getRegisteredArrayField(t);
+    return e ? H(e) : void 0;
+  }
+  /**
+   * @description 获取数组字段 schema
+   */
+  _getArrayFieldSchema(t) {
+    var i, n;
+    const e = (i = this._getRegisteredArrayFieldItem(t)) == null ? void 0 : i.schema;
+    if (e)
+      return e;
+    const r = this._resolveArrayFieldPath(t);
+    return (((n = this.state) == null ? void 0 : n.schema) ?? []).find(
+      (a) => I(a) && a.useArraySchema === !0 && !!a.fieldName && g(a.fieldName) === r
+    );
+  }
+  /**
+   * @description 解析数组新增项默认值
+   */
+  _resolveArrayDefaultItemValue(t) {
+    return this._resolveArrayDefaultItemValueByMutation(t);
+  }
+  /**
+   * @description 按新增操作场景解析数组新增项默认值
+   */
+  _resolveArrayDefaultItemValueByMutation(t, e, r) {
+    const s = this._getArrayFieldSchema(t);
+    if (!s)
+      return;
+    const i = this._resolveArrayFieldPath(t), n = this._getArrayFieldActions(t), a = (n == null ? void 0 : n.fields.length) ?? 0, l = (r == null ? void 0 : r.index) ?? a, c = (r == null ? void 0 : r.arrayLength) ?? a + 1, o = W(s, {
+      arrayPath: i,
+      parentItemPath: q(i),
+      form: this.form.values,
+      arrayAction: this.arrayAction,
+      row: v(e) ? e : void 0,
+      index: l,
+      arrayLength: c
+    });
+    return Array.isArray(o) ? E(o[0]) : E(o);
+  }
+  /**
+   * @description 合并数组新增项值，优先使用 schema 默认值补齐
+   */
+  _resolveArrayItemValue(t, e, r) {
+    const s = this._resolveArrayDefaultItemValueByMutation(t, e, r);
+    return s === void 0 ? e : e === void 0 || v(s) && v(e) ? s : e;
+  }
+  /**
+   * @description 开发环境：数组字段未注册时输出告警与相近路径提示
+   */
+  _warnUnregisteredArrayField(t, e) {
+    const r = this._resolveArrayFieldPath(e), s = [...this._arrayFields.keys()], i = r.split(/[[.]/)[0] ?? "";
+    s.filter((n) => i ? n.includes(i) : !0).slice(0, 8);
+  }
+  _mutateArrayField(t, e, r) {
+    const s = this._getRegisteredArrayField(e);
+    if (!s) {
+      this._warnUnregisteredArrayField(t, e);
+      return;
+    }
+    r(s);
+  }
+  /**
+   * @description 创建嵌套数组操作器（在原 inline 实现基础上支持链式 `.at`）
+   */
+  _createNestedArrayHandle(t) {
+    const e = this._resolveArrayFieldPath(t);
+    return {
+      path: e,
+      get: () => {
+        const r = this._getArrayFieldActions(e);
+        if (!r) {
+          this._warnUnregisteredArrayField("get", e);
+          return;
+        }
+        return r;
+      },
+      push: (r) => this._mutateArrayField(
+        "push",
+        e,
+        (s) => s.push(
+          this._resolveArrayItemValue(e, r, {
+            index: y(s.fields).length,
+            arrayLength: y(s.fields).length + 1
+          })
+        )
+      ),
+      remove: (r) => this._mutateArrayField("remove", e, (s) => s.remove(r)),
+      replace: (r) => this._mutateArrayField("replace", e, (s) => s.replace(r)),
+      update: (r, s) => this._mutateArrayField("update", e, (i) => i.update(r, s)),
+      insert: (r, s) => this._mutateArrayField(
+        "insert",
+        e,
+        (i) => i.insert(
+          r,
+          this._resolveArrayItemValue(e, s, {
+            index: r,
+            arrayLength: y(i.fields).length + 1
+          })
+        )
+      ),
+      prepend: (r) => this._mutateArrayField(
+        "prepend",
+        e,
+        (s) => s.prepend(
+          this._resolveArrayItemValue(e, r, {
+            index: 0,
+            arrayLength: y(s.fields).length + 1
+          })
+        )
+      ),
+      move: (r, s) => this._mutateArrayField("move", e, (i) => i.move(r, s)),
+      swap: (r, s) => this._mutateArrayField("swap", e, (i) => i.swap(r, s)),
+      at: (r, s) => this._createNestedArrayHandle(P(e, r, s))
+    };
+  }
+  /**
+   * @description 包装嵌套操作器，变更后执行回调（供 GroupFormApi 同步导航错误）
+   */
+  _wrapNestedArrayHandle(t, e) {
+    return {
+      path: t.path,
+      get: t.get,
+      at: (r, s) => this._wrapNestedArrayHandle(t.at(r, s), e),
+      push: (r) => {
+        t.push(r), e();
+      },
+      remove: (r) => {
+        t.remove(r), e();
+      },
+      replace: (r) => {
+        t.replace(r), e();
+      },
+      update: (r, s) => {
+        t.update(r, s), e();
+      },
+      insert: (r, s) => {
+        t.insert(r, s), e();
+      },
+      prepend: (r) => {
+        t.prepend(r), e();
+      },
+      move: (r, s) => {
+        t.move(r, s), e();
+      },
+      swap: (r, s) => {
+        t.swap(r, s), e();
+      }
+    };
+  }
+}
+export {
+  ie as FormApi,
+  C as collectArrayFieldPathAliases,
+  g as normalizeArrayFieldPath
+};