@multiplatform.one/backoffice 7.28.0 → 7.29.0

package/dist/esm/form/DocFormScreen.native.js

@@ -1,8 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from "react";
-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";
@@ -14,14 +13,11 @@ import { getListNavNeighbors } from "../shared/listNavContext.native.js";
 import { invalidateDocinfo, useDocinfo } from "../shared/useDocinfo.native.js";
 import { useRecentVisit } from "../shared/useRecentVisit.native.js";
 import { useDoctypeMeta } from "../shared/useDoctypeMeta.native.js";
-import { useUserRoles } from "../shared/useUserRoles.native.js";
+import { groupConnectionLinks } from "./connections-data.native.js";
 import { setCreatePrefill } from "./createPrefill.native.js";
-import { normalizeDocPermissions } from "./docinfo.native.js";
-import { buildPermLevelMatrix } from "./fieldPermissions.native.js";
 import { createHttpClient, renameDoc, sendEmail } from "./formActions.native.js";
 import { EmailDialog, JumpToFieldDialog, RenameDialog } from "./FormDialogs.native.js";
 import { FormErrorBoundary, wrapFieldWithErrorBoundary } from "./FormErrorBoundary.native.js";
-import { buildCopyValues, buildFormTabs, isPromptNamed } from "./formLayout.native.js";
 import { FormConnections } from "./FormConnections.native.js";
 import { FormHeaderCluster } from "./FormHeaderCluster.native.js";
 import { FormSidebarPanel } from "./FormSidebarPanel.native.js";
@@ -29,7 +25,6 @@ import { FormTimeline } from "./FormTimeline.native.js";
 import { FormToolbar, resolveIndicator } from "./FormToolbar.native.js";
 import { htmlToText } from "./timeline-utils.native.js";
 import { canOpenNewTab, openInNewTab, useBeforeUnloadGuard, useDocPagerShortcuts, useJumpToFieldShortcut, useNavigationDirtyGuard, useSaveShortcut } from "./platformHooks.native.js";
-import { useFormEngine } from "./useFormEngine.native.js";
 var CONNECTIONS_TAB = "__connections";
 function DocFormScreen(param) {
   var {
@@ -43,8 +38,8 @@ function DocFormScreen(param) {
     onDeleted,
     actionOverrides
   } = param;
-  var _ref, _ref1;
-  var _engine_baseline, _engine_baseline1, _meta_links, _bodyTabs_, _bodyTabs_1;
+  var _form_user;
+  var _form_baseline;
   var {
     t
   } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
@@ -80,31 +75,20 @@ function DocFormScreen(param) {
       name
     });
   }, [isCreate, doctype, name, emitEvent]);
-  var connection = useMemo(function () {
-    return (config === null || config === void 0 ? void 0 : 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]);
   var {
     meta,
     loading: isMetaLoading,
     error: metaError,
     reload: refetchMeta
   } = useDoctypeMeta(doctype);
-  var engine = useFormEngine(connection, doctype, docName, meta, t);
-  useEffect(function () {
-    if (metaError && !meta) emitEvent({
-      type: "error",
-      error: metaError,
-      context: "form-meta"
-    });
-  }, [metaError, meta, emitEvent]);
+  var metaSource = useMemo(function () {
+    return {
+      meta,
+      isLoading: isMetaLoading,
+      error: metaError
+    };
+  }, [meta, isMetaLoading, metaError]);
+  var metaRefused = !meta && metaError !== void 0 && isPermissionError(metaError);
   var {
     docinfo,
     reload: reloadDocinfo
@@ -113,7 +97,35 @@ function DocFormScreen(param) {
     if (docName) invalidateDocinfo(doctype, docName);
     reloadDocinfo();
   }, [doctype, docName, reloadDocinfo]);
-  var modifiedStamp = typeof ((_engine_baseline = engine.baseline) === null || _engine_baseline === void 0 ? void 0 : _engine_baseline.modified) === "string" ? engine.baseline.modified : void 0;
+  var fixtureMode = Boolean(config === null || config === void 0 ? void 0 : config.fixtures);
+  var rights = useMemo(function () {
+    var _docinfoRights;
+    return (_docinfoRights = docinfoRights(docinfo === null || docinfo === void 0 ? void 0 : docinfo.permissions)) !== null && _docinfoRights !== void 0 ? _docinfoRights : fixtureMode ? fixtureDocRights(meta) : void 0;
+  }, [docinfo === null || docinfo === void 0 ? void 0 : docinfo.permissions, fixtureMode, meta]);
+  var form = useFrappeForm({
+    doctype,
+    name: docName,
+    meta: metaSource,
+    rights,
+    shares: docinfo === null || docinfo === void 0 ? void 0 : docinfo.shared,
+    readShares: false,
+    disabled: readOnly,
+    hideFields: hiddenFields,
+    hideSections: hiddenSections
+  });
+  var connection = form.connection;
+  var currentUser = (_form_user = form.user) !== null && _form_user !== void 0 ? _form_user : "";
+  var perms = form.rights;
+  useEffect(function () {
+    if (metaError && !meta && !metaRefused) {
+      emitEvent({
+        type: "error",
+        error: metaError,
+        context: "form-meta"
+      });
+    }
+  }, [metaError, meta, metaRefused, emitEvent]);
+  var modifiedStamp = typeof ((_form_baseline = form.baseline) === null || _form_baseline === void 0 ? void 0 : _form_baseline.modified) === "string" ? form.baseline.modified : void 0;
   var stampRef = useRef(void 0);
   useEffect(function () {
     stampRef.current = void 0;
@@ -128,118 +140,20 @@ function DocFormScreen(param) {
       reloadDocinfo();
     }
   }, [modifiedStamp, docName, doctype, reloadDocinfo]);
-  var {
-    roles,
-    user: sessionUser
-  } = useUserRoles();
-  var fixtureMode = Boolean(config === null || config === void 0 ? void 0 : config.fixtures);
-  var recordOwner = !isCreate && typeof ((_engine_baseline1 = engine.baseline) === null || _engine_baseline1 === void 0 ? void 0 : _engine_baseline1.owner) === "string" ? engine.baseline.owner : void 0;
-  var perms = useMemo(function () {
-    var _ref2;
-    var docPerms = normalizeDocPermissions(docinfo === null || docinfo === void 0 ? void 0 : 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) {
-      var rights = sessionDocRights({
-        fixtures: false,
-        meta,
-        roles,
-        user: sessionUser,
-        owner: recordOwner,
-        shares: docinfo === null || docinfo === void 0 ? void 0 : 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
-      };
-    }
-    var rules = (_ref2 = meta === null || meta === void 0 ? void 0 : meta.permissions) !== null && _ref2 !== void 0 ? _ref2 : [];
-    var anyRole = function anyRole2(key) {
-      return rules.some(function (rule) {
-        return !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 === null || docinfo === void 0 ? void 0 : docinfo.permissions, docinfo === null || docinfo === void 0 ? void 0 : docinfo.shared, meta, fixtureMode, roles, sessionUser, recordOwner]);
-  var isSubmittable = !!(meta === null || meta === void 0 ? void 0 : meta.is_submittable);
-  var formReadOnly = !!readOnly || !!(meta === null || meta === void 0 ? void 0 : meta.read_only) || engine.wasDeleted || !isCreate && !perms.write || isCreate && !perms.create;
-  var permLevels = useMemo(function () {
-    return buildPermLevelMatrix(meta === null || meta === void 0 ? void 0 : meta.permissions, roles);
-  }, [meta === null || meta === void 0 ? void 0 : meta.permissions, roles]);
-  var formTabs = useMemo(function () {
-    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]);
-  var jumpTargets = useMemo(function () {
-    return formTabs.flatMap(function (tab) {
-      return tab.schema.fields.map(function (field) {
-        return {
-          name: field.name,
-          label: field.label || field.name,
-          tabKey: tab.key,
-          tabLabel: tab.label
-        };
-      });
-    });
-  }, [formTabs]);
-  var [activeTab, setActiveTab] = useState(void 0);
-  var showConnections = !isCreate && !!connection && ((_ref = meta === null || meta === void 0 ? void 0 : (_meta_links = meta.links) === null || _meta_links === void 0 ? void 0 : _meta_links.some(function (link) {
-    return !link.hidden;
-  })) !== null && _ref !== void 0 ? _ref : false);
+  var isSubmittable = form.isSubmittable;
+  var formReadOnly = form.readOnly;
+  var jumpTargets = form.fieldTargets;
+  var showConnections = !isCreate && !!connection && groupConnectionLinks(meta).length > 0;
   var [pendingNav, setPendingNav] = useState(void 0);
   var navigate = useCallback(function (href) {
-    if (engine.isDirty) {
+    if (form.isDirty) {
       setPendingNav(href);
       return;
     }
     navigator.navigate(href);
-  }, [engine.isDirty, navigator]);
-  useBeforeUnloadGuard(engine.isDirty);
-  var backGuard = useNavigationDirtyGuard(engine.isDirty);
+  }, [form.isDirty, navigator]);
+  useBeforeUnloadGuard(form.isDirty);
+  var backGuard = useNavigationDirtyGuard(form.isDirty);
   var [confirmAction, setConfirmAction] = useState(void 0);
   var [renameOpen, setRenameOpen] = useState(false);
   var [emailOpen, setEmailOpen] = useState(false);
@@ -247,15 +161,12 @@ function DocFormScreen(param) {
   var [pendingJump, setPendingJump] = useState(void 0);
   var [validationSummary, setValidationSummary] = useState(void 0);
   var handleSave = useCallback(async function () {
-    var validationErrors = engine.validate();
+    var validationErrors = form.validate();
     var errorFields = Object.keys(validationErrors);
     if (errorFields.length > 0) {
-      var owner = formTabs.find(function (tab) {
-        return tab.schema.fields.some(function (field) {
-          return errorFields.includes(field.name);
-        });
+      errorFields.some(function (field) {
+        return form.revealField(field);
       });
-      if (owner) setActiveTab(owner.key);
       setValidationSummary(t("validationSummary", {
         count: errorFields.length,
         defaultValue_one: "Cannot save \u2014 {{count}} required field is missing.",
@@ -264,7 +175,7 @@ function DocFormScreen(param) {
     } else {
       setValidationSummary(void 0);
     }
-    var savedName = await engine.save();
+    var savedName = await form.save();
     if (!savedName) return;
     setValidationSummary(void 0);
     notify({
@@ -280,7 +191,7 @@ function DocFormScreen(param) {
       isNew: isCreate
     });
     onSaved === null || onSaved === void 0 ? void 0 : onSaved({
-      ...engine.doc,
+      ...form.doc,
       name: savedName
     });
     if (isCreate) {
@@ -288,26 +199,19 @@ function DocFormScreen(param) {
     } else {
       reloadDocinfo();
     }
-  }, [engine, formTabs, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
+  }, [form, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
   useSaveShortcut(!formReadOnly, function () {
-    if (engine.isDirty || isCreate) void handleSave();
+    if (form.isDirty || isCreate) void handleSave();
   });
   useJumpToFieldShortcut(jumpTargets.length > 0 && !jumpOpen, function () {
     return setJumpOpen(true);
   });
   var handleAmend = useCallback(function () {
-    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]);
   var handleDuplicate = useCallback(function () {
-    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]);
   var handleRename = useCallback(async function (newName) {
     if (!connection || !docName) return;
     try {
@@ -330,11 +234,11 @@ function DocFormScreen(param) {
   }, function () {
     return openNeighborDoc(docPager.next);
   });
-  var titleFieldValue = (meta === null || meta === void 0 ? void 0 : meta.title_field) && typeof engine.doc[meta.title_field] === "string" ?
+  var titleFieldValue = (meta === null || meta === void 0 ? void 0 : 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;
   var title = isCreate ? t("newDocTitle", "New {{doctype}}", {
     doctype
   }) : titleFieldValue || name;
@@ -345,18 +249,21 @@ function DocFormScreen(param) {
       label: t("menuReload", "Reload"),
       icon: "reload",
       onSelect: function 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 === null || meta === void 0 ? void 0 : meta.allow_rename) && perms.write) {
       items.push({
         key: "rename",
@@ -394,7 +301,7 @@ function DocFormScreen(param) {
         label: t("menuLinks", "Links"),
         icon: "links",
         onSelect: function onSelect() {
-          return setActiveTab(CONNECTIONS_TAB);
+          return form.setActiveTab(CONNECTIONS_TAB);
         }
       });
     }
@@ -452,12 +359,12 @@ function DocFormScreen(param) {
       });
     }
     return items;
-  }, [isCreate, t, engine, refetchMeta, reloadDocinfo, handleDuplicate, meta === null || meta === void 0 ? void 0 : meta.allow_rename, perms, connection, doctype, name, showConnections, jumpTargets, navigate, paths, capabilities]);
+  }, [isCreate, t, form, refetchMeta, reloadDocinfo, handleDuplicate, metaRefused, meta === null || meta === void 0 ? void 0 : meta.allow_rename, perms, connection, doctype, name, showConnections, jumpTargets, navigate, paths, capabilities]);
   var effectiveMenuItems = useMemo(function () {
-    var _ref2;
-    var hidden = new Set((_ref2 = actionOverrides === null || actionOverrides === void 0 ? void 0 : actionOverrides.hide) !== null && _ref2 !== void 0 ? _ref2 : []);
+    var _ref;
+    var hiddenKeys = new Set((_ref = actionOverrides === null || actionOverrides === void 0 ? void 0 : actionOverrides.hide) !== null && _ref !== void 0 ? _ref : []);
     var items = menuItems.filter(function (item) {
-      return !hidden.has(item.key);
+      return !hiddenKeys.has(item.key);
     });
     var injected = [...actionsForDoctype(actions.form, doctype), ...actionsForDoctype(actionOverrides === null || actionOverrides === void 0 ? void 0 : actionOverrides.extra, doctype)];
     var _iteratorNormalCompletion = true,
@@ -498,9 +405,9 @@ function DocFormScreen(param) {
   }, [menuItems, actions.form, actionOverrides, doctype, docName]);
   var handleJumpToField = useCallback(function (field) {
     setJumpOpen(false);
-    setActiveTab(field.tabKey);
+    form.setActiveTab(field.tabKey);
     setPendingJump(field.name);
-  }, []);
+  }, [form]);
   useEffect(function () {
     if (!pendingJump) return;
     if (typeof document === "undefined") {
@@ -547,18 +454,63 @@ function DocFormScreen(param) {
       })
     });
   }
-  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 && 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: function onPress() {
+            return navigator.navigate(paths.list(doctype));
+          },
+          children: t("backToList", "Back to {{doctype}} list", {
+            doctype
+          })
+        })
       })
     });
   }
-  if (!isCreate && engine.notFound) {
+  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: function onPress() {
+            return 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, {
@@ -579,7 +531,7 @@ function DocFormScreen(param) {
       })
     });
   }
-  if (!isCreate && engine.isLoading) {
+  if (!isCreate && form.status === "loading") {
     return /* @__PURE__ */_jsx(YStack, {
       flex: 1,
       ...knobProps.panelPadding,
@@ -591,16 +543,16 @@ function DocFormScreen(param) {
   }
   var 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 === null || meta === void 0 ? void 0 : meta.states
   });
-  var canSave = !formReadOnly && (isCreate ? perms.create : perms.write && engine.docstatus === 0);
-  var canSubmit = !isCreate && isSubmittable && engine.docstatus === 0 && !engine.isDirty && perms.submit && !engine.wasDeleted;
-  var canCancel = !isCreate && isSubmittable && engine.docstatus === 1 && perms.cancel && !engine.wasDeleted;
-  var canAmend = !isCreate && isSubmittable && engine.docstatus === 2 && perms.amend && !engine.wasDeleted;
+  var canSave = !formReadOnly && (isCreate ? perms.create : perms.write && form.docstatus === 0);
+  var canSubmit = !isCreate && isSubmittable && form.docstatus === 0 && !form.isDirty && perms.submit && !form.wasDeleted;
+  var canCancel = !isCreate && isSubmittable && form.docstatus === 1 && perms.cancel && !form.wasDeleted;
+  var canAmend = !isCreate && isSubmittable && form.docstatus === 2 && perms.amend && !form.wasDeleted;
   var breadcrumbs = [{
     label: t("home", "Home"),
     href: paths.home()
@@ -610,37 +562,8 @@ function DocFormScreen(param) {
   }, {
     label: isCreate ? t("newCrumb", "New") : title
   }];
-  var promptNamed = isCreate && isPromptNamed(meta === null || meta === void 0 ? void 0 : meta.autoname, meta === null || meta === void 0 ? void 0 : meta.naming_rule);
   var sidebarStacked = sizeClass === "compact";
-  var bodyTabs = [...formTabs.map(function (tab) {
-    return {
-      value: tab.key,
-      label: tab.label,
-      content: /* @__PURE__ */_jsx(YStack, {
-        ...knobProps.gapLg,
-        paddingTop: "$3",
-        children: (
-        /* Containment at two granularities: each field renders behind its
-        own boundary (a broken field degrades to an inline error slot;
-        siblings stay editable), and the whole tab body behind another
-        (a SchemaForm-level crash costs one tab, not the route). */
-        /* @__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 ? [{
+  var connectionsTab = showConnections ? [{
     value: CONNECTIONS_TAB,
     label: t("connectionsTab", "Connections"),
     content: /* @__PURE__ */_jsx(YStack, {
@@ -651,42 +574,42 @@ function DocFormScreen(param) {
         meta
       })
     })
-  }] : [])];
-  var effectiveTab = activeTab && bodyTabs.some(function (tab) {
-    return tab.value === activeTab;
-  }) ? activeTab : (_bodyTabs_ = bodyTabs[0]) === null || _bodyTabs_ === void 0 ? void 0 : _bodyTabs_.value;
+  }] : [];
+  var renderTab = function renderTab2(tab, content) {
+    return /* @__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
+      })
+    });
+  };
   var 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: function onChangeText(value) {
-          return 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
-    }) : (_ref1 = (_bodyTabs_1 = bodyTabs[0]) === null || _bodyTabs_1 === void 0 ? void 0 : _bodyTabs_1.content) !== null && _ref1 !== void 0 ? _ref1 : 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
+    })
   });
-  var timeline = capabilities.timeline.enabled && !isCreate && docName ?
+  var 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
@@ -698,16 +621,16 @@ function DocFormScreen(param) {
     name: docName,
     docInfo: docinfo,
     refreshDocInfo: refreshDocinfo,
-    currentUser: engine.currentUser,
+    currentUser,
     connection
   }) : null;
   var 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;
@@ -717,12 +640,12 @@ function DocFormScreen(param) {
     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,
@@ -762,9 +685,9 @@ function DocFormScreen(param) {
         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,
@@ -774,7 +697,7 @@ function DocFormScreen(param) {
           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,
@@ -785,7 +708,7 @@ function DocFormScreen(param) {
           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",
@@ -802,7 +725,7 @@ function DocFormScreen(param) {
           size: "$2",
           outlined: true,
           "aria-label": t("reloadDoc", "Reload"),
-          onPress: engine.reload,
+          onPress: form.reset,
           children: t("reloadDoc", "Reload")
         })]
       })]
@@ -845,7 +768,7 @@ function DocFormScreen(param) {
       warning: true,
       onConfirm: function onConfirm() {
         setConfirmAction(void 0);
-        void engine.submit().then(function (ok) {
+        void form.submitDocument().then(function (ok) {
           if (ok) {
             notify({
               severity: "success",
@@ -869,7 +792,7 @@ function DocFormScreen(param) {
       destructive: true,
       onConfirm: function onConfirm() {
         setConfirmAction(void 0);
-        void engine.cancel().then(function (ok) {
+        void form.cancelDocument().then(function (ok) {
           if (ok) {
             notify({
               severity: "success",
@@ -894,7 +817,7 @@ function DocFormScreen(param) {
       destructive: true,
       onConfirm: function onConfirm() {
         setConfirmAction(void 0);
-        void engine.remove().then(function (ok) {
+        void form.remove().then(function (ok) {
           if (ok) {
             invalidateDocinfo(doctype, name);
             emitEvent({