@multiplatform.one/backoffice 7.28.1 → 7.29.1

package/dist/jsx/form/DocFormScreen.mjs

@@ -1,6 +1,5 @@
-import { AsyncSkeleton, Button, ConfirmDialog, EmptyState, ScrollView, Tabs, Text, XStack, YStack, notify } from "@multiplatform.one/components";
-import { Input } from "@multiplatform.one/forms";
-import { SchemaForm, sessionDocRights, useFrappeConfig } from "@multiplatform.one/frappe-ui";
+import { AsyncBoundary, AsyncSkeleton, Button, ConfirmDialog, EmptyState, ScrollView, Text, XStack, YStack, notify } from "@multiplatform.one/components";
+import { FrappeForm, docinfoRights, fixtureDocRights, isPermissionError, refusalReason, useFrappeConfig, useFrappeForm } from "@multiplatform.one/frappe-ui";
 import { useLayoutSizeClass, useResolvedKnobs } from "@multiplatform.one/theme";
 import { ListBulletsIcon } from "@phosphor-icons/react";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
@@ -12,14 +11,11 @@ import { getListNavNeighbors } from "../shared/listNavContext.mjs";
 import { invalidateDocinfo, useDocinfo } from "../shared/useDocinfo.mjs";
 import { useRecentVisit } from "../shared/useRecentVisit.mjs";
 import { useDoctypeMeta } from "../shared/useDoctypeMeta.mjs";
-import { useUserRoles } from "../shared/useUserRoles.mjs";
+import { groupConnectionLinks } from "./connections-data.mjs";
 import { setCreatePrefill } from "./createPrefill.mjs";
-import { normalizeDocPermissions } from "./docinfo.mjs";
-import { buildPermLevelMatrix } from "./fieldPermissions.mjs";
 import { createHttpClient, renameDoc, sendEmail } from "./formActions.mjs";
 import { EmailDialog, JumpToFieldDialog, RenameDialog } from "./FormDialogs.mjs";
 import { FormErrorBoundary, wrapFieldWithErrorBoundary } from "./FormErrorBoundary.mjs";
-import { buildCopyValues, buildFormTabs, isPromptNamed } from "./formLayout.mjs";
 import { FormConnections } from "./FormConnections.mjs";
 import { FormHeaderCluster } from "./FormHeaderCluster.mjs";
 import { FormSidebarPanel } from "./FormSidebarPanel.mjs";
@@ -27,7 +23,6 @@ import { FormTimeline } from "./FormTimeline.mjs";
 import { FormToolbar, resolveIndicator } from "./FormToolbar.mjs";
 import { htmlToText } from "./timeline-utils.mjs";
 import { canOpenNewTab, openInNewTab, useBeforeUnloadGuard, useDocPagerShortcuts, useJumpToFieldShortcut, useNavigationDirtyGuard, useSaveShortcut } from "./platformHooks.mjs";
-import { useFormEngine } from "./useFormEngine.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 const CONNECTIONS_TAB = "__connections";
 function DocFormScreen({
@@ -76,29 +71,18 @@ function DocFormScreen({
       name
     });
   }, [isCreate, doctype, name, emitEvent]);
-  const connection = useMemo(() => config?.baseURL ? {
-    baseURL: config.baseURL,
-    socketPort: config.socketPort,
-    siteName: config.siteName,
-    socketBaseURL: config.socketBaseURL,
-    auth: config.auth,
-    syncOptions: config.syncOptions,
-    fixtures: config.fixtures
-  } : void 0, [config]);
   const {
     meta,
     loading: isMetaLoading,
     error: metaError,
     reload: refetchMeta
   } = useDoctypeMeta(doctype);
-  const engine = useFormEngine(connection, doctype, docName, meta, t);
-  useEffect(() => {
-    if (metaError && !meta) emitEvent({
-      type: "error",
-      error: metaError,
-      context: "form-meta"
-    });
-  }, [metaError, meta, emitEvent]);
+  const metaSource = useMemo(() => ({
+    meta,
+    isLoading: isMetaLoading,
+    error: metaError
+  }), [meta, isMetaLoading, metaError]);
+  const metaRefused = !meta && metaError !== void 0 && isPermissionError(metaError);
   const {
     docinfo,
     reload: reloadDocinfo
@@ -107,7 +91,32 @@ function DocFormScreen({
     if (docName) invalidateDocinfo(doctype, docName);
     reloadDocinfo();
   }, [doctype, docName, reloadDocinfo]);
-  const modifiedStamp = typeof engine.baseline?.modified === "string" ? engine.baseline.modified : void 0;
+  const fixtureMode = Boolean(config?.fixtures);
+  const rights = useMemo(() => docinfoRights(docinfo?.permissions) ?? (fixtureMode ? fixtureDocRights(meta) : void 0), [docinfo?.permissions, fixtureMode, meta]);
+  const form = useFrappeForm({
+    doctype,
+    name: docName,
+    meta: metaSource,
+    rights,
+    shares: docinfo?.shared,
+    readShares: false,
+    disabled: readOnly,
+    hideFields: hiddenFields,
+    hideSections: hiddenSections
+  });
+  const connection = form.connection;
+  const currentUser = form.user ?? "";
+  const perms = form.rights;
+  useEffect(() => {
+    if (metaError && !meta && !metaRefused) {
+      emitEvent({
+        type: "error",
+        error: metaError,
+        context: "form-meta"
+      });
+    }
+  }, [metaError, meta, metaRefused, emitEvent]);
+  const modifiedStamp = typeof form.baseline?.modified === "string" ? form.baseline.modified : void 0;
   const stampRef = useRef(void 0);
   useEffect(() => {
     stampRef.current = void 0;
@@ -122,103 +131,20 @@ function DocFormScreen({
       reloadDocinfo();
     }
   }, [modifiedStamp, docName, doctype, reloadDocinfo]);
-  const {
-    roles,
-    user: sessionUser
-  } = useUserRoles();
-  const fixtureMode = Boolean(config?.fixtures);
-  const recordOwner = !isCreate && typeof engine.baseline?.owner === "string" ? engine.baseline.owner : void 0;
-  const perms = useMemo(() => {
-    const docPerms = normalizeDocPermissions(docinfo?.permissions);
-    if (docPerms) {
-      return {
-        write: !!docPerms.write,
-        create: !!docPerms.create,
-        delete: !!docPerms.delete,
-        submit: !!docPerms.submit,
-        cancel: !!docPerms.cancel,
-        amend: !!docPerms.amend,
-        email: !!docPerms.email,
-        print: !!docPerms.print
-      };
-    }
-    if (!fixtureMode) {
-      const rights = sessionDocRights({
-        fixtures: false,
-        meta,
-        roles,
-        user: sessionUser,
-        owner: recordOwner,
-        shares: docinfo?.shared
-      });
-      return {
-        write: rights.write,
-        create: rights.create,
-        delete: rights.delete,
-        submit: rights.submit,
-        cancel: rights.cancel,
-        amend: rights.amend,
-        email: rights.email,
-        print: rights.print
-      };
-    }
-    const rules = meta?.permissions ?? [];
-    const anyRole = key => rules.some(rule => !rule.permlevel && !!rule[key]);
-    return {
-      write: rules.length === 0 || anyRole("write"),
-      create: rules.length === 0 || anyRole("create"),
-      delete: anyRole("delete"),
-      submit: anyRole("submit"),
-      cancel: anyRole("cancel"),
-      amend: anyRole("amend"),
-      email: rules.length === 0 || anyRole("email"),
-      print: rules.length === 0 || anyRole("print")
-    };
-  }, [docinfo?.permissions, docinfo?.shared, meta, fixtureMode, roles, sessionUser, recordOwner]);
-  const isSubmittable = !!meta?.is_submittable;
-  const formReadOnly = !!readOnly || !!meta?.read_only || engine.wasDeleted || !isCreate && !perms.write || isCreate && !perms.create;
-  const permLevels = useMemo(() => buildPermLevelMatrix(meta?.permissions, roles), [meta?.permissions, roles]);
-  const formTabs = useMemo(() => {
-    if (!meta) return [];
-    return buildFormTabs({
-      fields: meta.fields,
-      // depends_on evaluates against the doc plus desk's ambient context:
-      // __islocal (unsaved doc flag) and the session user behind
-      // `frappe.session.user` references.
-      doc: {
-        ...engine.doc,
-        __islocal: isCreate ? 1 : 0,
-        ...(engine.currentUser ? {
-          __session_user: engine.currentUser
-        } : {})
-      },
-      docstatus: engine.docstatus,
-      formReadOnly,
-      isCreate,
-      detailsLabel: t("detailsTab", "Details"),
-      permLevels,
-      hiddenFields,
-      hiddenSections
-    });
-  }, [meta, engine.doc, engine.currentUser, engine.docstatus, formReadOnly, isCreate, permLevels, hiddenFields, hiddenSections, t]);
-  const jumpTargets = useMemo(() => formTabs.flatMap(tab => tab.schema.fields.map(field => ({
-    name: field.name,
-    label: field.label || field.name,
-    tabKey: tab.key,
-    tabLabel: tab.label
-  }))), [formTabs]);
-  const [activeTab, setActiveTab] = useState(void 0);
-  const showConnections = !isCreate && !!connection && (meta?.links?.some(link => !link.hidden) ?? false);
+  const isSubmittable = form.isSubmittable;
+  const formReadOnly = form.readOnly;
+  const jumpTargets = form.fieldTargets;
+  const showConnections = !isCreate && !!connection && groupConnectionLinks(meta).length > 0;
   const [pendingNav, setPendingNav] = useState(void 0);
   const navigate = useCallback(href => {
-    if (engine.isDirty) {
+    if (form.isDirty) {
       setPendingNav(href);
       return;
     }
     navigator.navigate(href);
-  }, [engine.isDirty, navigator]);
-  useBeforeUnloadGuard(engine.isDirty);
-  const backGuard = useNavigationDirtyGuard(engine.isDirty);
+  }, [form.isDirty, navigator]);
+  useBeforeUnloadGuard(form.isDirty);
+  const backGuard = useNavigationDirtyGuard(form.isDirty);
   const [confirmAction, setConfirmAction] = useState(void 0);
   const [renameOpen, setRenameOpen] = useState(false);
   const [emailOpen, setEmailOpen] = useState(false);
@@ -226,11 +152,10 @@ function DocFormScreen({
   const [pendingJump, setPendingJump] = useState(void 0);
   const [validationSummary, setValidationSummary] = useState(void 0);
   const handleSave = useCallback(async () => {
-    const validationErrors = engine.validate();
+    const validationErrors = form.validate();
     const errorFields = Object.keys(validationErrors);
     if (errorFields.length > 0) {
-      const owner = formTabs.find(tab => tab.schema.fields.some(field => errorFields.includes(field.name)));
-      if (owner) setActiveTab(owner.key);
+      errorFields.some(field => form.revealField(field));
       setValidationSummary(t("validationSummary", {
         count: errorFields.length,
         defaultValue_one: "Cannot save \u2014 {{count}} required field is missing.",
@@ -239,7 +164,7 @@ function DocFormScreen({
     } else {
       setValidationSummary(void 0);
     }
-    const savedName = await engine.save();
+    const savedName = await form.save();
     if (!savedName) return;
     setValidationSummary(void 0);
     notify({
@@ -255,7 +180,7 @@ function DocFormScreen({
       isNew: isCreate
     });
     onSaved?.({
-      ...engine.doc,
+      ...form.doc,
       name: savedName
     });
     if (isCreate) {
@@ -263,24 +188,17 @@ function DocFormScreen({
     } else {
       reloadDocinfo();
     }
-  }, [engine, formTabs, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
+  }, [form, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
   useSaveShortcut(!formReadOnly, () => {
-    if (engine.isDirty || isCreate) void handleSave();
+    if (form.isDirty || isCreate) void handleSave();
   });
   useJumpToFieldShortcut(jumpTargets.length > 0 && !jumpOpen, () => setJumpOpen(true));
   const handleAmend = useCallback(() => {
-    if (!meta || !docName) return;
-    setCreatePrefill(doctype, {
-      ...buildCopyValues(meta.fields, engine.doc),
-      amended_from: docName
-    });
-    navigator.navigate(paths.newDoc(doctype));
-  }, [meta, docName, doctype, engine.doc, navigator, paths]);
+    if (form.amend()) navigator.navigate(paths.newDoc(doctype));
+  }, [form, doctype, navigator, paths]);
   const handleDuplicate = useCallback(() => {
-    if (!meta) return;
-    setCreatePrefill(doctype, buildCopyValues(meta.fields, engine.doc));
-    navigator.navigate(paths.newDoc(doctype));
-  }, [meta, doctype, engine.doc, navigator, paths]);
+    if (form.duplicate()) navigator.navigate(paths.newDoc(doctype));
+  }, [form, doctype, navigator, paths]);
   const handleRename = useCallback(async newName => {
     if (!connection || !docName) return;
     try {
@@ -295,11 +213,11 @@ function DocFormScreen({
     if (target) navigate(paths.form(doctype, target));
   }, [navigate, paths, doctype]);
   useDocPagerShortcuts(docPager.inList, () => openNeighborDoc(docPager.prev), () => openNeighborDoc(docPager.next));
-  const titleFieldValue = meta?.title_field && typeof engine.doc[meta.title_field] === "string" ?
+  const titleFieldValue = meta?.title_field && typeof form.doc[meta.title_field] === "string" ?
   // Title fields can hold rich text (e.g. ToDo.description = "<p>…</p>");
   // strip to plain text so the breadcrumb + toolbar heading don't show
   // literal HTML tags.
-  htmlToText(engine.doc[meta.title_field]) : void 0;
+  htmlToText(form.doc[meta.title_field]) : void 0;
   const title = isCreate ? t("newDocTitle", "New {{doctype}}", {
     doctype
   }) : titleFieldValue || name;
@@ -310,18 +228,21 @@ function DocFormScreen({
       label: t("menuReload", "Reload"),
       icon: "reload",
       onSelect: () => {
-        engine.reload();
+        form.reset();
         setValidationSummary(void 0);
         refetchMeta();
         invalidateDocinfo(doctype, name);
         reloadDocinfo();
       }
-    }, {
-      key: "duplicate",
-      label: t("menuDuplicate", "Duplicate"),
-      icon: "duplicate",
-      onSelect: handleDuplicate
     }];
+    if (!metaRefused) {
+      items.push({
+        key: "duplicate",
+        label: t("menuDuplicate", "Duplicate"),
+        icon: "duplicate",
+        onSelect: handleDuplicate
+      });
+    }
     if (meta?.allow_rename && perms.write) {
       items.push({
         key: "rename",
@@ -354,7 +275,7 @@ function DocFormScreen({
         key: "links",
         label: t("menuLinks", "Links"),
         icon: "links",
-        onSelect: () => setActiveTab(CONNECTIONS_TAB)
+        onSelect: () => form.setActiveTab(CONNECTIONS_TAB)
       });
     }
     if (jumpTargets.length > 0) {
@@ -401,10 +322,10 @@ function DocFormScreen({
       });
     }
     return items;
-  }, [isCreate, t, engine, refetchMeta, reloadDocinfo, handleDuplicate, meta?.allow_rename, perms, connection, doctype, name, showConnections, jumpTargets, navigate, paths, capabilities]);
+  }, [isCreate, t, form, refetchMeta, reloadDocinfo, handleDuplicate, metaRefused, meta?.allow_rename, perms, connection, doctype, name, showConnections, jumpTargets, navigate, paths, capabilities]);
   const effectiveMenuItems = useMemo(() => {
-    const hidden = new Set(actionOverrides?.hide ?? []);
-    const items = menuItems.filter(item => !hidden.has(item.key));
+    const hiddenKeys = new Set(actionOverrides?.hide ?? []);
+    const items = menuItems.filter(item => !hiddenKeys.has(item.key));
     const injected = [...actionsForDoctype(actions.form, doctype), ...actionsForDoctype(actionOverrides?.extra, doctype)];
     for (const action of injected) {
       items.push({
@@ -422,9 +343,9 @@ function DocFormScreen({
   }, [menuItems, actions.form, actionOverrides, doctype, docName]);
   const handleJumpToField = useCallback(field => {
     setJumpOpen(false);
-    setActiveTab(field.tabKey);
+    form.setActiveTab(field.tabKey);
     setPendingJump(field.name);
-  }, []);
+  }, [form]);
   useEffect(() => {
     if (!pendingJump) return;
     if (typeof document === "undefined") {
@@ -471,18 +392,59 @@ function DocFormScreen({
       })
     });
   }
-  if (metaError && !meta) {
+  if (metaError && !meta && !metaRefused) {
     return /* @__PURE__ */jsx(YStack, {
       flex: 1,
-      children: /* @__PURE__ */jsx(EmptyState, {
-        title: t("metaError", "Could not load {{doctype}}", {
+      children: /* @__PURE__ */jsx(AsyncBoundary, {
+        error: metaError,
+        errorTitle: t("metaError", "Could not load {{doctype}}", {
           doctype
         }),
-        description: metaError.message
+        onRetry: refetchMeta
       })
     });
   }
-  if (!isCreate && engine.notFound) {
+  if (!isCreate && form.status === "error" && form.docError && isPermissionError(form.docError)) {
+    return /* @__PURE__ */jsx(YStack, {
+      flex: 1,
+      children: /* @__PURE__ */jsx(EmptyState, {
+        testID: "frappe-form-not-permitted",
+        title: t("docNotPermitted", "You can't open {{doctype}} {{name}}", {
+          doctype,
+          name
+        }),
+        description: refusalReason(form.docError),
+        action: /* @__PURE__ */jsx(Button, {
+          icon: ListBulletsIcon,
+          onPress: () => navigator.navigate(paths.list(doctype)),
+          children: t("backToList", "Back to {{doctype}} list", {
+            doctype
+          })
+        })
+      })
+    });
+  }
+  if (!isCreate && form.status === "error" && form.docError) {
+    return /* @__PURE__ */jsx(YStack, {
+      flex: 1,
+      children: /* @__PURE__ */jsx(EmptyState, {
+        intent: "error",
+        title: t("docLoadError", "Could not load {{doctype}} {{name}}", {
+          doctype,
+          name
+        }),
+        description: form.docError.message,
+        action: /* @__PURE__ */jsx(Button, {
+          icon: ListBulletsIcon,
+          onPress: () => navigator.navigate(paths.list(doctype)),
+          children: t("backToList", "Back to {{doctype}} list", {
+            doctype
+          })
+        })
+      })
+    });
+  }
+  if (!isCreate && form.status === "notFound") {
     return /* @__PURE__ */jsx(YStack, {
       flex: 1,
       children: /* @__PURE__ */jsx(EmptyState, {
@@ -501,7 +463,7 @@ function DocFormScreen({
       })
     });
   }
-  if (!isCreate && engine.isLoading) {
+  if (!isCreate && form.status === "loading") {
     return /* @__PURE__ */jsx(YStack, {
       flex: 1,
       ...knobProps.panelPadding,
@@ -513,16 +475,16 @@ function DocFormScreen({
   }
   const indicator = resolveIndicator({
     isCreate,
-    isDirty: engine.isDirty,
-    docstatus: engine.docstatus,
+    isDirty: form.isDirty,
+    docstatus: form.docstatus,
     isSubmittable,
-    statusValue: typeof engine.doc.status === "string" ? engine.doc.status : void 0,
+    statusValue: typeof form.doc.status === "string" ? form.doc.status : void 0,
     states: meta?.states
   });
-  const canSave = !formReadOnly && (isCreate ? perms.create : perms.write && engine.docstatus === 0);
-  const canSubmit = !isCreate && isSubmittable && engine.docstatus === 0 && !engine.isDirty && perms.submit && !engine.wasDeleted;
-  const canCancel = !isCreate && isSubmittable && engine.docstatus === 1 && perms.cancel && !engine.wasDeleted;
-  const canAmend = !isCreate && isSubmittable && engine.docstatus === 2 && perms.amend && !engine.wasDeleted;
+  const canSave = !formReadOnly && (isCreate ? perms.create : perms.write && form.docstatus === 0);
+  const canSubmit = !isCreate && isSubmittable && form.docstatus === 0 && !form.isDirty && perms.submit && !form.wasDeleted;
+  const canCancel = !isCreate && isSubmittable && form.docstatus === 1 && perms.cancel && !form.wasDeleted;
+  const canAmend = !isCreate && isSubmittable && form.docstatus === 2 && perms.amend && !form.wasDeleted;
   const breadcrumbs = [{
     label: t("home", "Home"),
     href: paths.home()
@@ -532,29 +494,8 @@ function DocFormScreen({
   }, {
     label: isCreate ? t("newCrumb", "New") : title
   }];
-  const promptNamed = isCreate && isPromptNamed(meta?.autoname, meta?.naming_rule);
   const sidebarStacked = sizeClass === "compact";
-  const bodyTabs = [...formTabs.map(tab => ({
-    value: tab.key,
-    label: tab.label,
-    content: /* @__PURE__ */jsx(YStack, {
-      ...knobProps.gapLg,
-      paddingTop: "$3",
-      children: /* @__PURE__ */jsx(FormErrorBoundary, {
-        errorTitle: t("formTabRenderError", "This form tab failed to render"),
-        testID: `form-tab-error-${tab.key}`,
-        children: /* @__PURE__ */jsx(SchemaForm, {
-          schema: tab.schema,
-          doc: engine.doc,
-          setValue: engine.setValue,
-          errors: engine.errors,
-          disabled: formReadOnly || engine.isSaving,
-          sectionHeadingLevel: 2,
-          renderFieldWrapper: wrapFieldWithErrorBoundary
-        })
-      })
-    })
-  })), ...(showConnections ? [{
+  const connectionsTab = showConnections ? [{
     value: CONNECTIONS_TAB,
     label: t("connectionsTab", "Connections"),
     content: /* @__PURE__ */jsx(YStack, {
@@ -565,38 +506,40 @@ function DocFormScreen({
         meta
       })
     })
-  }] : [])];
-  const effectiveTab = activeTab && bodyTabs.some(tab => tab.value === activeTab) ? activeTab : bodyTabs[0]?.value;
+  }] : [];
+  const renderTab = (tab, content) => /* @__PURE__ */jsx(YStack, {
+    ...knobProps.gapLg,
+    paddingTop: "$3",
+    children: /* @__PURE__ */jsx(FormErrorBoundary, {
+      errorTitle: t("formTabRenderError", "This form tab failed to render"),
+      testID: `form-tab-error-${tab.key}`,
+      children: content
+    })
+  });
   const formBody =
-  // No flex here: formBody now lives inside COLUMN containers (both
-  // branches below), where `flex={1}` means flex-basis:0 — the body would
-  // stop contributing height and the timeline/sidebar would paint over it.
+  // No flex here: formBody lives inside COLUMN containers (both branches
+  // below), where `flex={1}` means flex-basis:0 — the body would stop
+  // contributing height and the timeline/sidebar would paint over it.
   /* @__PURE__ */
-  jsxs(YStack, {
+  jsx(YStack, {
     minWidth: 0,
-    ...knobProps.gapLg,
-    children: [promptNamed && /* @__PURE__ */jsx(YStack, {
-      ...knobProps.gap,
-      children: /* @__PURE__ */jsx(Input, {
-        label: t("namePrompt", "Name"),
-        value: typeof engine.doc.name === "string" ? engine.doc.name : "",
-        onChangeText: value => engine.setValue("name", value),
-        placeholder: t("namePromptPlaceholder", "New document name"),
-        error: engine.errors.name
-      })
-    }), bodyTabs.length > 1 ? /* @__PURE__ */jsx(Tabs, {
-      items: bodyTabs,
-      value: effectiveTab,
-      onChange: setActiveTab,
-      lazyMount: true
-    }) : bodyTabs[0]?.content ?? null, engine.errors.general && /* @__PURE__ */jsx(Text, {
-      color: "$red10",
-      fontSize: "$3",
-      role: "alert",
-      children: engine.errors.general
-    })]
+    children: /* @__PURE__ */jsx(FrappeForm, {
+      form,
+      doctype,
+      name: docName,
+      disabled: readOnly,
+      showToolbar: false,
+      showSidebar: false,
+      showTimeline: false,
+      showConnections: false,
+      showBanners: false,
+      sectionHeadingLevel: 2,
+      renderFieldWrapper: wrapFieldWithErrorBoundary,
+      renderTab,
+      extraTabs: connectionsTab
+    })
   });
-  const timeline = capabilities.timeline.enabled && !isCreate && docName ?
+  const timeline = capabilities.timeline.enabled && !isCreate && docName && !metaRefused ?
   // Composed mode: the screen's shared docinfo (and its refresh) feed
   // the timeline. Self-fetch mode subscribed the timeline to its OWN
   // cache entry, which the save path's invalidate+reload orphaned — the
@@ -608,16 +551,16 @@ function DocFormScreen({
     name: docName,
     docInfo: docinfo,
     refreshDocInfo: refreshDocinfo,
-    currentUser: engine.currentUser,
+    currentUser,
     connection
   }) : null;
   const sidebar = !isCreate && docName && meta ? /* @__PURE__ */jsx(FormSidebarPanel, {
     doctype,
     name: docName,
     meta,
-    doc: engine.doc,
+    doc: form.doc,
     docinfo,
-    currentUser: engine.currentUser,
+    currentUser,
     onRefresh: refreshDocinfo,
     stacked: sidebarStacked
   }) : null;
@@ -627,12 +570,12 @@ function DocFormScreen({
     title,
     indicator,
     showIndicator: !!meta,
-    isSaving: engine.isSaving,
-    cluster: !isCreate && docName ? /* @__PURE__ */jsx(FormHeaderCluster, {
+    isSaving: form.isSubmitting,
+    cluster: !isCreate && docName && !metaRefused ? /* @__PURE__ */jsx(FormHeaderCluster, {
       doctype,
       name: docName,
       docinfo,
-      currentUser: engine.currentUser,
+      currentUser,
       onRefresh: refreshDocinfo
     }) : void 0,
     canSave,
@@ -660,9 +603,9 @@ function DocFormScreen({
         name: docName
       } : {}),
       defaultContent: toolbar
-    }) : toolbar, (engine.wasDeleted || validationSummary || engine.conflict) && /* @__PURE__ */jsxs(YStack, {
+    }) : toolbar, (form.wasDeleted || validationSummary || form.conflict) && /* @__PURE__ */jsxs(YStack, {
       paddingHorizontal: "$3",
-      children: [engine.wasDeleted && /* @__PURE__ */jsx(XStack, {
+      children: [form.wasDeleted && /* @__PURE__ */jsx(XStack, {
         role: "alert",
         ...knobProps.containerRadius,
         ...knobProps.panelPadding,
@@ -672,7 +615,7 @@ function DocFormScreen({
           fontSize: "$3",
           children: t("deletedBanner", "This document was deleted on the server. Fields are read-only.")
         })
-      }), validationSummary && !engine.wasDeleted && /* @__PURE__ */jsx(XStack, {
+      }), validationSummary && !form.wasDeleted && /* @__PURE__ */jsx(XStack, {
         role: "alert",
         ...knobProps.containerRadius,
         ...knobProps.panelPadding,
@@ -683,7 +626,7 @@ function DocFormScreen({
           fontSize: "$3",
           children: validationSummary
         })
-      }), engine.conflict && !engine.wasDeleted && /* @__PURE__ */jsxs(XStack, {
+      }), form.conflict && !form.wasDeleted && /* @__PURE__ */jsxs(XStack, {
         role: "status",
         alignItems: "center",
         justifyContent: "space-between",
@@ -700,7 +643,7 @@ function DocFormScreen({
           size: "$2",
           outlined: true,
           "aria-label": t("reloadDoc", "Reload"),
-          onPress: engine.reload,
+          onPress: form.reset,
           children: t("reloadDoc", "Reload")
         })]
       })]
@@ -740,7 +683,7 @@ function DocFormScreen({
       warning: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.submit().then(ok => {
+        void form.submitDocument().then(ok => {
           if (ok) {
             notify({
               severity: "success",
@@ -762,7 +705,7 @@ function DocFormScreen({
       destructive: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.cancel().then(ok => {
+        void form.cancelDocument().then(ok => {
           if (ok) {
             notify({
               severity: "success",
@@ -785,7 +728,7 @@ function DocFormScreen({
       destructive: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.remove().then(ok => {
+        void form.remove().then(ok => {
           if (ok) {
             invalidateDocinfo(doctype, name);
             emitEvent({