vlite3 0.8.3 → 0.8.4

package/components/Form/Form.vue2.js

@@ -1,29 +1,28 @@
-import { defineComponent as pe, inject as Ce, getCurrentInstance as Se, computed as o, onMounted as ee, onUnmounted as G, ref as z, watch as te, openBlock as n, createElementBlock as d, withKeys as ae, withModifiers as D, normalizeClass as v, createElementVNode as g, createBlock as x, mergeProps as A, toDisplayString as R, unref as a, renderSlot as ie, createVNode as P, createCommentVNode as c, Fragment as Fe, renderList as we } from "vue";
-import { useRouter as Ae } from "vue-router";
-import { useForm as Re } from "./composables/useForm.js";
+import { defineComponent as ye, inject as xe, computed as n, onMounted as _, onUnmounted as E, ref as z, watch as ee, openBlock as o, createElementBlock as d, withKeys as te, withModifiers as G, normalizeClass as f, createElementVNode as v, createVNode as k, mergeProps as B, toDisplayString as A, unref as a, renderSlot as ae, createCommentVNode as c, Fragment as ke, renderList as pe, createBlock as R } from "vue";
+import { useForm as Se } from "./composables/useForm.js";
 import O from "./FormFields.vue.js";
-import k from "../Button.vue.js";
-import Pe from "../BackButton.vue.js";
-import Be from "../Timeline/Timeline.vue.js";
+import p from "../Button.vue.js";
+import Ce from "../BackButton.vue.js";
+import Fe from "../Timeline/Timeline.vue.js";
 import "@iconify/vue";
-import { $t as Ne } from "../../utils/i18n.js";
-import { useVLiteConfig as Te } from "../../core/config.js";
-const Ue = ["onKeydown"], Ve = { class: "flex items-center gap-3" }, ze = { class: "flex items-center gap-2 flex-shrink-0" }, De = {
+import { $t as we } from "../../utils/i18n.js";
+import { useVLiteConfig as Ae } from "../../core/config.js";
+const Re = ["onKeydown"], Pe = { class: "flex items-center gap-3" }, Ne = { class: "flex items-center gap-2 flex-shrink-0" }, Te = {
   key: 0,
   class: "form-fields-single"
-}, Le = {
+}, Ue = {
   key: 1,
   class: "form-groups space-y-6"
-}, qe = { class: "text-base font-semibold text-foreground" }, He = {
+}, Ve = { class: "text-base font-semibold text-foreground" }, ze = {
   key: 0,
   class: "text-sm text-muted-foreground mt-1"
-}, Ie = { class: "form-group-body p-4.5" }, Ke = {
+}, Be = { class: "form-group-body p-4.5" }, De = {
   key: 2,
   class: "form-step"
-}, Me = { class: "text-lg font-semibold text-foreground" }, $e = {
+}, Le = { class: "text-lg font-semibold text-foreground" }, qe = {
   key: 0,
   class: "text-sm text-muted-foreground mt-1"
-}, Ee = { class: "flex items-center gap-3" }, et = /* @__PURE__ */ pe({
+}, He = { class: "flex items-center gap-3" }, Qe = /* @__PURE__ */ ye({
   __name: "Form",
   props: {
     schema: {},
@@ -56,276 +55,270 @@ const Ue = ["onKeydown"], Ve = { class: "flex items-center gap-3" }, ze = { clas
     pageTitleI18n: {},
     pageTitleClass: { default: "text-2xl font-bold" },
     pageHeaderClass: { default: "" },
-    backButtonProps: { default: () => ({ size: "sm", variant: "ghost", icon: "heroicons-solid:arrow-left" }) }
+    backButtonProps: { default: () => ({ size: "sm", variant: "ghost", icon: "heroicons-solid:arrow-left" }) },
+    backButtonPath: {}
   },
   emits: ["onSubmit", "onCancel", "onStepChange", "onAddonAction", "onBack"],
-  setup(e, { emit: se }) {
-    const i = e, f = se, m = Ce("modal-context", null);
-    Ae();
-    const le = Se(), J = o(() => !!le?.vnode.props?.onOnBack), ne = Te(), B = o(() => ne?.components?.form || {}), L = o(() => i.variant ?? B.value.variant ?? "outline"), q = o(() => i.size ?? B.value.size ?? "md"), H = o(() => i.rounded ?? B.value.rounded ?? "md"), I = o(
-      () => i.showRequiredAsterisk ?? B.value.showRequiredAsterisk ?? !0
-    ), oe = o(() => i.showCancel || !!m), p = o(() => !!m), C = o(() => i.stickyFooter || p.value);
-    ee(() => {
-      i.footer && p.value && m?.registerFormFooter?.(!0);
-    }), G(() => {
-      p.value && m?.registerFormFooter?.(!1);
+  setup(e, { emit: ie }) {
+    const i = e, g = ie, m = xe("modal-context", null), se = Ae(), P = n(() => se?.components?.form || {}), D = n(() => i.variant ?? P.value.variant ?? "outline"), L = n(() => i.size ?? P.value.size ?? "md"), q = n(() => i.rounded ?? P.value.rounded ?? "md"), H = n(
+      () => i.showRequiredAsterisk ?? P.value.showRequiredAsterisk ?? !0
+    ), le = n(() => i.showCancel || !!m), x = n(() => !!m), S = n(() => i.stickyFooter || x.value);
+    _(() => {
+      i.footer && x.value && m?.registerFormFooter?.(!0);
+    }), E(() => {
+      x.value && m?.registerFormFooter?.(!1);
     });
-    const re = z(null), K = z(null), Q = z(!1);
-    let M = null;
-    ee(() => {
-      K.value && (M = new IntersectionObserver(
+    const oe = z(null), I = z(null), J = z(!1);
+    let K = null;
+    _(() => {
+      I.value && (K = new IntersectionObserver(
         ([t]) => {
-          Q.value = !t.isIntersecting;
+          J.value = !t.isIntersecting;
         },
         { threshold: 0 }
-      ), M.observe(K.value));
-    }), G(() => {
-      M?.disconnect();
+      ), K.observe(I.value));
+    }), E(() => {
+      K?.disconnect();
     });
-    const N = o(() => !i.schema || i.schema.length === 0 ? !1 : Array.isArray(i.schema[0])), r = o(() => i.tabs && i.tabs.length > 0 && N.value), l = z(0), W = o(() => i.tabs ? i.tabs.map((t, s) => ({
+    const N = n(() => !i.schema || i.schema.length === 0 ? !1 : Array.isArray(i.schema[0])), r = n(() => i.tabs && i.tabs.length > 0 && N.value), l = z(0), Q = n(() => i.tabs ? i.tabs.map((t, s) => ({
       id: t.id?.toString() || s.toString(),
       title: t.title,
       icon: t.icon,
       description: t.description,
       status: s < l.value ? "completed" : s === l.value ? "current" : "upcoming"
-    })) : []), S = o(() => N.value ? i.schema : [i.schema]), X = o(() => r.value ? S.value[l.value] || [] : []), {
+    })) : []), C = n(() => N.value ? i.schema : [i.schema]), W = n(() => r.value ? C.value[l.value] || [] : []), {
       formValues: F,
       errors: w,
-      isSubmitting: b,
-      fieldLoading: $,
-      handleFieldChange: ue,
-      validateField: de,
-      validateAll: ce,
+      isSubmitting: h,
+      fieldLoading: M,
+      handleFieldChange: ne,
+      validateField: re,
+      validateAll: ue,
       isFieldVisible: T,
       isFieldDisabled: U,
-      isFieldReadonly: E,
-      handleSubmit: me
-    } = Re({
+      isFieldReadonly: $,
+      handleSubmit: de
+    } = Se({
       schema: i.schema,
       values: i.values,
       isUpdate: i.isUpdate,
       folderId: i.folderId,
       emitFields: i.emitFields,
       onSubmit: (t) => {
-        f("onSubmit", t, m?.close || (() => {
+        g("onSubmit", t, m?.close || (() => {
         }));
       }
     });
-    te(
-      () => i.loading || b.value,
+    ee(
+      () => i.loading || h.value,
       (t) => {
         m?.setSubmitting && m.setSubmitting(t);
       },
       { immediate: !0 }
-    ), G(() => {
+    ), E(() => {
       m?.setSubmitting && m.setSubmitting(!1);
-    }), te(
+    }), ee(
       () => i.values,
       (t) => {
       },
       { deep: !0 }
     );
     const j = (t, s) => {
-      ue(t, s.value, s.data);
-    }, fe = () => {
+      ne(t, s.value, s.data);
+    }, ce = () => {
       if (!r.value) return !0;
-      const t = X.value;
+      const t = W.value;
       let s = !0;
       for (const u of t) {
         if (!T(u) || U(u)) continue;
-        de(u) && (s = !1);
+        re(u) && (s = !1);
       }
       return s;
-    }, ve = o(() => r.value ? l.value < S.value.length - 1 : !1), Y = o(() => r.value ? l.value > 0 : !1), V = o(() => r.value ? l.value === S.value.length - 1 : !0), Z = () => {
-      ve.value && fe() && (l.value++, f("onStepChange", l.value));
-    }, ge = () => {
-      Y.value && (l.value--, f("onStepChange", l.value));
-    }, he = (t, s) => {
-      s <= l.value && (l.value = s, f("onStepChange", l.value));
+    }, me = n(() => r.value ? l.value < C.value.length - 1 : !1), X = n(() => r.value ? l.value > 0 : !1), V = n(() => r.value ? l.value === C.value.length - 1 : !0), Y = () => {
+      me.value && ce() && (l.value++, g("onStepChange", l.value));
+    }, fe = () => {
+      X.value && (l.value--, g("onStepChange", l.value));
+    }, ve = (t, s) => {
+      s <= l.value && (l.value = s, g("onStepChange", l.value));
     }, y = async () => {
       if (r.value) {
         if (!V.value && !i.isUpdate) {
-          Z();
+          Y();
           return;
         }
-        if (!ce()) {
-          const s = S.value.findIndex(
-            (u) => u.some((h) => !!w.value[h.name])
+        if (!ue()) {
+          const s = C.value.findIndex(
+            (u) => u.some((b) => !!w.value[b.name])
           );
-          s !== -1 && s !== l.value && (l.value = s, f("onStepChange", l.value));
+          s !== -1 && s !== l.value && (l.value = s, g("onStepChange", l.value));
           return;
         }
       }
       try {
-        await me();
+        await de();
       } catch {
       }
-    }, be = (t) => {
+    }, ge = (t) => {
       if (t.key !== "Enter") return;
       const u = t.target.tagName.toLowerCase();
       u !== "textarea" && u !== "button" && (t.preventDefault(), y());
-    }, _ = (t) => {
+    }, Z = (t) => {
       (t.metaKey || t.ctrlKey) && t.key === "s" && (t.preventDefault(), y());
-    }, ye = () => {
-      f("onCancel"), m && m?.close?.();
-    }, xe = () => {
-      J.value && f("onBack");
+    }, be = () => {
+      g("onCancel"), m && m?.close?.();
     };
-    return (t, s) => (n(), d("form", {
-      class: v(["form-container ", i.class]),
-      onSubmit: D(y, ["prevent"]),
+    return (t, s) => (o(), d("form", {
+      class: f(["form-container ", i.class]),
+      onSubmit: G(y, ["prevent"]),
       onKeydown: [
-        be,
-        ae(D(_, ["meta", "prevent"]), ["s"]),
-        ae(D(_, ["ctrl", "prevent"]), ["s"])
+        ge,
+        te(G(Z, ["meta", "prevent"]), ["s"]),
+        te(G(Z, ["ctrl", "prevent"]), ["s"])
       ]
     }, [
-      e.isPage ? (n(), d("div", {
+      e.isPage ? (o(), d("div", {
         key: 0,
-        class: v([
-          "form-page-header sticky top-0 z-30 bg-background flex items-center justify-between border-b border-border pb-4 pt-4 -mt-4 mb-6",
+        class: f([
+          "form-page-header sticky top-0 z-30 bg-background flex items-center justify-between  pb-2 pt-4 -mt-4 mb-6.5",
           e.pageHeaderClass
         ])
       }, [
-        g("div", Ve, [
-          J.value ? (n(), x(Pe, A({ key: 1 }, e.backButtonProps, { class: "max-sm:w-8 max-sm:h-8 max-sm:min-w-8 max-sm:min-h-8 max-sm:px-0 flex-shrink-0" }), null, 16)) : (n(), x(k, A({
-            key: 0,
-            type: "button"
-          }, e.backButtonProps, {
-            onClick: D(xe, ["prevent"]),
+        v("div", Pe, [
+          k(Ce, B(e.backButtonProps, {
+            fallback: e.backButtonPath,
             class: "max-sm:w-8 max-sm:h-8 max-sm:min-w-8 max-sm:min-h-8 max-sm:px-0 flex-shrink-0"
-          }), null, 16)),
-          g("h1", {
-            class: v(["text-foreground max-sm:text-lg text-fs-5 truncate", e.pageTitleClass])
-          }, R(e.pageTitleI18n ? a(Ne)(e.pageTitleI18n) : e.pageTitle), 3)
+          }), null, 16, ["fallback"]),
+          v("h1", {
+            class: f(["text-foreground max-sm:text-lg text-fs-5 truncate", e.pageTitleClass])
+          }, A(e.pageTitleI18n ? a(we)(e.pageTitleI18n) : e.pageTitle), 3)
         ]),
-        g("div", ze, [
-          ie(t.$slots, "header-actions", {
+        v("div", Ne, [
+          ae(t.$slots, "header-actions", {
             values: a(F),
-            isSubmitting: a(b),
+            isSubmitting: a(h),
             handleSubmit: y
           }, void 0, !0),
-          P(k, A({
+          k(p, B({
             type: "button",
             variant: e.isUpdate ? "outline" : "primary",
             text: e.submitText
           }, e.submitProps, {
-            loading: e.loading || a(b),
+            loading: e.loading || a(h),
             onClick: y,
             class: "max-sm:hidden"
           }), null, 16, ["variant", "text", "loading"])
         ])
       ], 2)) : c("", !0),
-      r.value && W.value.length > 0 ? (n(), d("div", {
+      r.value && Q.value.length > 0 ? (o(), d("div", {
         key: 1,
-        class: v(["form-timeline", e.timelineTextPosition == "right" ? "mb-6.5" : "mb-13"])
+        class: f(["form-timeline", e.timelineTextPosition == "right" ? "mb-6.5" : "mb-13"])
       }, [
-        P(a(Be), {
-          steps: W.value,
+        k(a(Fe), {
+          steps: Q.value,
           activeStep: l.value,
           direction: "horizontal",
           textPosition: e.timelineTextPosition,
           clickable: !0,
-          onStepClick: he
+          onStepClick: ve
         }, null, 8, ["steps", "activeStep", "textPosition"])
       ], 2)) : c("", !0),
-      g("div", {
-        class: v(e.footer && C.value ? "pb-2" : "")
+      v("div", {
+        class: f(e.footer && S.value ? "pb-2" : "")
       }, [
-        N.value ? N.value && !r.value ? (n(), d("div", Le, [
-          (n(!0), d(Fe, null, we(S.value, (u, h) => (n(), d("div", {
-            key: h,
-            class: v(["form-group border rounded overflow-hidden bg-body", e.groupClass])
+        N.value ? N.value && !r.value ? (o(), d("div", Ue, [
+          (o(!0), d(ke, null, pe(C.value, (u, b) => (o(), d("div", {
+            key: b,
+            class: f(["form-group border rounded overflow-hidden bg-body", e.groupClass])
           }, [
-            e.groupsHeadings?.[h] ? (n(), d("div", {
+            e.groupsHeadings?.[b] ? (o(), d("div", {
               key: 0,
-              class: v(["form-group-header bg-muted/50 px-4 py-2.5 border-b", e.headerClass])
+              class: f(["form-group-header bg-muted/50 px-4 py-2.5 border-b", e.headerClass])
             }, [
-              g("h3", qe, R(e.groupsHeadings[h]), 1),
-              e.groupHeadingsDescription?.[h] ? (n(), d("p", He, R(e.groupHeadingsDescription[h]), 1)) : c("", !0)
+              v("h3", Ve, A(e.groupsHeadings[b]), 1),
+              e.groupHeadingsDescription?.[b] ? (o(), d("p", ze, A(e.groupHeadingsDescription[b]), 1)) : c("", !0)
             ], 2)) : c("", !0),
-            g("div", Ie, [
-              P(O, {
+            v("div", Be, [
+              k(O, {
                 schema: u,
                 values: a(F),
                 errors: a(w),
-                fieldLoading: a($),
-                variant: L.value,
-                size: q.value,
-                rounded: H.value,
+                fieldLoading: a(M),
+                variant: D.value,
+                size: L.value,
+                rounded: q.value,
                 className: e.className,
                 isUpdate: e.isUpdate,
-                showRequiredAsterisk: I.value,
+                showRequiredAsterisk: H.value,
                 isFieldVisible: a(T),
                 isFieldDisabled: a(U),
-                isFieldReadonly: a(E),
+                isFieldReadonly: a($),
                 onChange: j,
-                onAddonAction: s[1] || (s[1] = (ke) => f("onAddonAction", ke))
+                onAddonAction: s[1] || (s[1] = (he) => g("onAddonAction", he))
               }, null, 8, ["schema", "values", "errors", "fieldLoading", "variant", "size", "rounded", "className", "isUpdate", "showRequiredAsterisk", "isFieldVisible", "isFieldDisabled", "isFieldReadonly"])
             ])
           ], 2))), 128))
-        ])) : r.value ? (n(), d("div", Ke, [
-          e.tabs?.[l.value] ? (n(), d("div", {
+        ])) : r.value ? (o(), d("div", De, [
+          e.tabs?.[l.value] ? (o(), d("div", {
             key: 0,
-            class: v(["form-step-header mb-6", e.headerClass])
+            class: f(["form-step-header mb-6", e.headerClass])
           }, [
-            g("h2", Me, R(e.tabs[l.value].title), 1),
-            e.tabs[l.value].description ? (n(), d("p", $e, R(e.tabs[l.value].description), 1)) : c("", !0)
+            v("h2", Le, A(e.tabs[l.value].title), 1),
+            e.tabs[l.value].description ? (o(), d("p", qe, A(e.tabs[l.value].description), 1)) : c("", !0)
           ], 2)) : c("", !0),
-          P(O, {
-            schema: X.value,
+          k(O, {
+            schema: W.value,
             values: a(F),
             errors: a(w),
-            fieldLoading: a($),
-            variant: L.value,
-            size: q.value,
-            rounded: H.value,
+            fieldLoading: a(M),
+            variant: D.value,
+            size: L.value,
+            rounded: q.value,
             className: e.className,
             isUpdate: e.isUpdate,
-            showRequiredAsterisk: I.value,
+            showRequiredAsterisk: H.value,
             isFieldVisible: a(T),
             isFieldDisabled: a(U),
-            isFieldReadonly: a(E),
+            isFieldReadonly: a($),
             onChange: j,
-            onAddonAction: s[2] || (s[2] = (u) => f("onAddonAction", u))
+            onAddonAction: s[2] || (s[2] = (u) => g("onAddonAction", u))
           }, null, 8, ["schema", "values", "errors", "fieldLoading", "variant", "size", "rounded", "className", "isUpdate", "showRequiredAsterisk", "isFieldVisible", "isFieldDisabled", "isFieldReadonly"])
-        ])) : c("", !0) : (n(), d("div", De, [
-          P(O, {
+        ])) : c("", !0) : (o(), d("div", Te, [
+          k(O, {
             schema: e.schema,
             values: a(F),
             errors: a(w),
-            fieldLoading: a($),
-            variant: L.value,
-            size: q.value,
-            rounded: H.value,
+            fieldLoading: a(M),
+            variant: D.value,
+            size: L.value,
+            rounded: q.value,
             className: e.className,
             isUpdate: e.isUpdate,
-            showRequiredAsterisk: I.value,
+            showRequiredAsterisk: H.value,
             isFieldVisible: a(T),
             isFieldDisabled: a(U),
-            isFieldReadonly: a(E),
+            isFieldReadonly: a($),
             onChange: j,
-            onAddonAction: s[0] || (s[0] = (u) => f("onAddonAction", u))
+            onAddonAction: s[0] || (s[0] = (u) => g("onAddonAction", u))
           }, null, 8, ["schema", "values", "errors", "fieldLoading", "variant", "size", "rounded", "className", "isUpdate", "showRequiredAsterisk", "isFieldVisible", "isFieldDisabled", "isFieldReadonly"])
         ])),
-        ie(t.$slots, "default", {
+        ae(t.$slots, "default", {
           values: a(F),
           errors: a(w),
-          isSubmitting: a(b),
+          isSubmitting: a(h),
           handleSubmit: y
         }, void 0, !0),
-        g("div", {
+        v("div", {
           ref_key: "sentinelRef",
-          ref: K,
+          ref: I,
           class: "form-scroll-sentinel h-px w-full",
           "aria-hidden": "true"
         }, null, 512)
       ], 2),
-      e.footer ? (n(), d("div", {
+      e.footer ? (o(), d("div", {
         key: 2,
         ref_key: "footerRef",
-        ref: re,
-        class: v([
+        ref: oe,
+        class: f([
           "form-footer items-center gap-3 z-20",
           e.isPage ? "flex sm:hidden" : "flex",
           e.footerClass,
@@ -334,67 +327,67 @@ const Ue = ["onKeydown"], Ve = { class: "flex items-center gap-3" }, ze = { clas
           // `sticky bottom-0` anchors the footer to the bottom of the nearest scrollable ancestor
           // (the modal's overflow-y-auto body), keeping it visible at all times without leaving
           // the normal document flow (unlike `fixed` which would escape the modal bounds).
-          C.value ? "sticky bottom-0 bg-body pt-3 pb-3 -mx-0.5 px-0.5 border-t border-border/75" : "mt-6",
+          S.value ? "sticky bottom-0 bg-body pt-3 pb-3 -mx-0.5 px-0.5 border-t border-border/75" : "mt-6",
           // Show a subtle top shadow while content is scrolling beneath the sticky footer
-          (C.value && Q.value, ""),
+          (S.value && J.value, ""),
           // Inside modal: extend footer flush to modal edge padding
-          p.value ? "-mx-4 px-4 pb-3!" : "",
+          x.value ? "-mx-4 px-4 pb-3!" : "",
           // Non-sticky inside modal keeps the original border styling
-          !C.value && p.value ? "border-t border-border/75 mt-5" : "",
-          !C.value && !p.value ? "mt-6" : ""
+          !S.value && x.value ? "border-t border-border/75 mt-5" : "",
+          !S.value && !x.value ? "mt-6" : ""
         ])
       }, [
-        g("div", Ee, [
-          oe.value ? (n(), x(k, {
+        v("div", He, [
+          le.value ? (o(), R(p, {
             key: 0,
             type: "button",
             variant: "outline",
             text: e.cancelText,
-            disabled: e.loading || a(b),
-            onClick: ye
+            disabled: e.loading || a(h),
+            onClick: be
           }, null, 8, ["text", "disabled"])) : c("", !0),
-          r.value && e.isUpdate && !V.value ? (n(), x(k, A({
+          r.value && e.isUpdate && !V.value ? (o(), R(p, B({
             key: 1,
             type: "button",
             variant: "primary",
             text: e.submitText
           }, e.submitProps, {
-            loading: e.loading || a(b),
+            loading: e.loading || a(h),
             onClick: y
           }), null, 16, ["text", "loading"])) : c("", !0)
         ]),
-        g("div", {
-          class: v(["flex items-center gap-3", r.value && "ml-auto"])
+        v("div", {
+          class: f(["flex items-center gap-3", r.value && "ml-auto"])
         }, [
-          r.value && Y.value ? (n(), x(k, {
+          r.value && X.value ? (o(), R(p, {
             key: 0,
             type: "button",
             variant: "outline",
             icon: "lucide:arrow-left",
             text: "Previous",
-            onClick: ge
+            onClick: fe
           })) : c("", !0),
-          r.value && !V.value ? (n(), x(k, {
+          r.value && !V.value ? (o(), R(p, {
             key: 1,
             type: "button",
             variant: e.isUpdate ? "outline" : "primary",
             text: "Next",
             iconRight: "lucide:arrow-right",
-            onClick: Z
+            onClick: Y
           }, null, 8, ["variant"])) : c("", !0),
-          !r.value || V.value ? (n(), x(k, A({
+          !r.value || V.value ? (o(), R(p, B({
             key: 2,
             type: "submit",
             variant: "primary",
             text: e.submitText
           }, e.submitProps, {
-            loading: e.loading || a(b)
+            loading: e.loading || a(h)
           }), null, 16, ["text", "loading"])) : c("", !0)
         ], 2)
       ], 2)) : c("", !0)
-    ], 42, Ue));
+    ], 42, Re));
   }
 });
 export {
-  et as default
+  Qe as default
 };

package/components/Form/utils/form.utils.d.ts

@@ -51,5 +51,16 @@ export declare function isComponent(value: any): boolean;
  * Cleans the submit payload by extracting only schema fields,
  * injecting specified emitFields, and removing ignoreFields recursively.
  * Also processes mapped output and transformation functions.
+ *
+ * KEY BEHAVIOUR (fix for Prisma / Postgres sync on updates):
+ * A field is included in the payload only when:
+ *   1. It has a non-empty value — always included (create & update).
+ *   2. It is empty AND the field key already existed in the original `values`
+ *      object — meaning the user explicitly cleared a pre-existing value during
+ *      an update. In this case the canonical empty value (`[]` for multiSelect,
+ *      `null` for everything else) is sent so the backend overwrites the old data.
+ *
+ * Fields that were never filled in (key absent from `values`) are silently
+ * omitted to keep create payloads lean.
  */
 export declare function cleanSubmitValues(values: Record<string, any>, schema: IForm[] | IForm[][], emitFields?: string[], ignoreFields?: string[]): Record<string, any>;