@multiplatform.one/backoffice 7.28.0 → 7.29.0

package/dist/cjs/form/DocFormScreen.cjs

@@ -26,7 +26,6 @@ __export(DocFormScreen_exports, {
 });
 module.exports = __toCommonJS(DocFormScreen_exports);
 var import_components = require("@multiplatform.one/components");
-var import_forms = require("@multiplatform.one/forms");
 var import_frappe_ui = require("@multiplatform.one/frappe-ui");
 var import_theme = require("@multiplatform.one/theme");
 var import_react = require("@phosphor-icons/react");
@@ -39,14 +38,11 @@ var import_listNavContext = require("../shared/listNavContext.cjs");
 var import_useDocinfo = require("../shared/useDocinfo.cjs");
 var import_useRecentVisit = require("../shared/useRecentVisit.cjs");
 var import_useDoctypeMeta = require("../shared/useDoctypeMeta.cjs");
-var import_useUserRoles = require("../shared/useUserRoles.cjs");
+var import_connections_data = require("./connections-data.cjs");
 var import_createPrefill = require("./createPrefill.cjs");
-var import_docinfo = require("./docinfo.cjs");
-var import_fieldPermissions = require("./fieldPermissions.cjs");
 var import_formActions = require("./formActions.cjs");
 var import_FormDialogs = require("./FormDialogs.cjs");
 var import_FormErrorBoundary = require("./FormErrorBoundary.cjs");
-var import_formLayout = require("./formLayout.cjs");
 var import_FormConnections = require("./FormConnections.cjs");
 var import_FormHeaderCluster = require("./FormHeaderCluster.cjs");
 var import_FormSidebarPanel = require("./FormSidebarPanel.cjs");
@@ -54,7 +50,6 @@ var import_FormTimeline = require("./FormTimeline.cjs");
 var import_FormToolbar = require("./FormToolbar.cjs");
 var import_timeline_utils = require("./timeline-utils.cjs");
 var import_platformHooks = require("./platformHooks.cjs");
-var import_useFormEngine = require("./useFormEngine.cjs");
 var import_jsx_runtime = require("react/jsx-runtime");
 const CONNECTIONS_TAB = "__connections";
 function DocFormScreen({
@@ -103,29 +98,18 @@ function DocFormScreen({
       name
     });
   }, [isCreate, doctype, name, emitEvent]);
-  const connection = (0, import_react2.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
   } = (0, import_useDoctypeMeta.useDoctypeMeta)(doctype);
-  const engine = (0, import_useFormEngine.useFormEngine)(connection, doctype, docName, meta, t);
-  (0, import_react2.useEffect)(() => {
-    if (metaError && !meta) emitEvent({
-      type: "error",
-      error: metaError,
-      context: "form-meta"
-    });
-  }, [metaError, meta, emitEvent]);
+  const metaSource = (0, import_react2.useMemo)(() => ({
+    meta,
+    isLoading: isMetaLoading,
+    error: metaError
+  }), [meta, isMetaLoading, metaError]);
+  const metaRefused = !meta && metaError !== void 0 && (0, import_frappe_ui.isPermissionError)(metaError);
   const {
     docinfo,
     reload: reloadDocinfo
@@ -134,7 +118,32 @@ function DocFormScreen({
     if (docName) (0, import_useDocinfo.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 = (0, import_react2.useMemo)(() => (0, import_frappe_ui.docinfoRights)(docinfo?.permissions) ?? (fixtureMode ? (0, import_frappe_ui.fixtureDocRights)(meta) : void 0), [docinfo?.permissions, fixtureMode, meta]);
+  const form = (0, import_frappe_ui.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;
+  (0, import_react2.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 = (0, import_react2.useRef)(void 0);
   (0, import_react2.useEffect)(() => {
     stampRef.current = void 0;
@@ -149,103 +158,20 @@ function DocFormScreen({
       reloadDocinfo();
     }
   }, [modifiedStamp, docName, doctype, reloadDocinfo]);
-  const {
-    roles,
-    user: sessionUser
-  } = (0, import_useUserRoles.useUserRoles)();
-  const fixtureMode = Boolean(config?.fixtures);
-  const recordOwner = !isCreate && typeof engine.baseline?.owner === "string" ? engine.baseline.owner : void 0;
-  const perms = (0, import_react2.useMemo)(() => {
-    const docPerms = (0, import_docinfo.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 = (0, import_frappe_ui.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 = (0, import_react2.useMemo)(() => (0, import_fieldPermissions.buildPermLevelMatrix)(meta?.permissions, roles), [meta?.permissions, roles]);
-  const formTabs = (0, import_react2.useMemo)(() => {
-    if (!meta) return [];
-    return (0, import_formLayout.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 = (0, import_react2.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] = (0, import_react2.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 && (0, import_connections_data.groupConnectionLinks)(meta).length > 0;
   const [pendingNav, setPendingNav] = (0, import_react2.useState)(void 0);
   const navigate = (0, import_react2.useCallback)(href => {
-    if (engine.isDirty) {
+    if (form.isDirty) {
       setPendingNav(href);
       return;
     }
     navigator.navigate(href);
-  }, [engine.isDirty, navigator]);
-  (0, import_platformHooks.useBeforeUnloadGuard)(engine.isDirty);
-  const backGuard = (0, import_platformHooks.useNavigationDirtyGuard)(engine.isDirty);
+  }, [form.isDirty, navigator]);
+  (0, import_platformHooks.useBeforeUnloadGuard)(form.isDirty);
+  const backGuard = (0, import_platformHooks.useNavigationDirtyGuard)(form.isDirty);
   const [confirmAction, setConfirmAction] = (0, import_react2.useState)(void 0);
   const [renameOpen, setRenameOpen] = (0, import_react2.useState)(false);
   const [emailOpen, setEmailOpen] = (0, import_react2.useState)(false);
@@ -253,11 +179,10 @@ function DocFormScreen({
   const [pendingJump, setPendingJump] = (0, import_react2.useState)(void 0);
   const [validationSummary, setValidationSummary] = (0, import_react2.useState)(void 0);
   const handleSave = (0, import_react2.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.",
@@ -266,7 +191,7 @@ function DocFormScreen({
     } else {
       setValidationSummary(void 0);
     }
-    const savedName = await engine.save();
+    const savedName = await form.save();
     if (!savedName) return;
     setValidationSummary(void 0);
     (0, import_components.notify)({
@@ -282,7 +207,7 @@ function DocFormScreen({
       isNew: isCreate
     });
     onSaved?.({
-      ...engine.doc,
+      ...form.doc,
       name: savedName
     });
     if (isCreate) {
@@ -290,24 +215,17 @@ function DocFormScreen({
     } else {
       reloadDocinfo();
     }
-  }, [engine, formTabs, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
+  }, [form, isCreate, navigator, paths, doctype, reloadDocinfo, t, emitEvent, onSaved]);
   (0, import_platformHooks.useSaveShortcut)(!formReadOnly, () => {
-    if (engine.isDirty || isCreate) void handleSave();
+    if (form.isDirty || isCreate) void handleSave();
   });
   (0, import_platformHooks.useJumpToFieldShortcut)(jumpTargets.length > 0 && !jumpOpen, () => setJumpOpen(true));
   const handleAmend = (0, import_react2.useCallback)(() => {
-    if (!meta || !docName) return;
-    (0, import_createPrefill.setCreatePrefill)(doctype, {
-      ...(0, import_formLayout.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 = (0, import_react2.useCallback)(() => {
-    if (!meta) return;
-    (0, import_createPrefill.setCreatePrefill)(doctype, (0, import_formLayout.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 = (0, import_react2.useCallback)(async newName => {
     if (!connection || !docName) return;
     try {
@@ -322,11 +240,11 @@ function DocFormScreen({
     if (target) navigate(paths.form(doctype, target));
   }, [navigate, paths, doctype]);
   (0, import_platformHooks.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.
-  (0, import_timeline_utils.htmlToText)(engine.doc[meta.title_field]) : void 0;
+  (0, import_timeline_utils.htmlToText)(form.doc[meta.title_field]) : void 0;
   const title = isCreate ? t("newDocTitle", "New {{doctype}}", {
     doctype
   }) : titleFieldValue || name;
@@ -337,18 +255,21 @@ function DocFormScreen({
       label: t("menuReload", "Reload"),
       icon: "reload",
       onSelect: () => {
-        engine.reload();
+        form.reset();
         setValidationSummary(void 0);
         refetchMeta();
         (0, import_useDocinfo.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",
@@ -381,7 +302,7 @@ function DocFormScreen({
         key: "links",
         label: t("menuLinks", "Links"),
         icon: "links",
-        onSelect: () => setActiveTab(CONNECTIONS_TAB)
+        onSelect: () => form.setActiveTab(CONNECTIONS_TAB)
       });
     }
     if (jumpTargets.length > 0) {
@@ -428,10 +349,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 = (0, import_react2.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 = [...(0, import_BackofficeProvider.actionsForDoctype)(actions.form, doctype), ...(0, import_BackofficeProvider.actionsForDoctype)(actionOverrides?.extra, doctype)];
     for (const action of injected) {
       items.push({
@@ -449,9 +370,9 @@ function DocFormScreen({
   }, [menuItems, actions.form, actionOverrides, doctype, docName]);
   const handleJumpToField = (0, import_react2.useCallback)(field => {
     setJumpOpen(false);
-    setActiveTab(field.tabKey);
+    form.setActiveTab(field.tabKey);
     setPendingJump(field.name);
-  }, []);
+  }, [form]);
   (0, import_react2.useEffect)(() => {
     if (!pendingJump) return;
     if (typeof document === "undefined") {
@@ -498,18 +419,59 @@ function DocFormScreen({
       })
     });
   }
-  if (metaError && !meta) {
+  if (metaError && !meta && !metaRefused) {
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
       flex: 1,
-      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.EmptyState, {
-        title: t("metaError", "Could not load {{doctype}}", {
+      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.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 && (0, import_frappe_ui.isPermissionError)(form.docError)) {
+    return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
+      flex: 1,
+      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.EmptyState, {
+        testID: "frappe-form-not-permitted",
+        title: t("docNotPermitted", "You can't open {{doctype}} {{name}}", {
+          doctype,
+          name
+        }),
+        description: (0, import_frappe_ui.refusalReason)(form.docError),
+        action: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.Button, {
+          icon: import_react.ListBulletsIcon,
+          onPress: () => navigator.navigate(paths.list(doctype)),
+          children: t("backToList", "Back to {{doctype}} list", {
+            doctype
+          })
+        })
+      })
+    });
+  }
+  if (!isCreate && form.status === "error" && form.docError) {
+    return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
+      flex: 1,
+      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.EmptyState, {
+        intent: "error",
+        title: t("docLoadError", "Could not load {{doctype}} {{name}}", {
+          doctype,
+          name
+        }),
+        description: form.docError.message,
+        action: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.Button, {
+          icon: import_react.ListBulletsIcon,
+          onPress: () => navigator.navigate(paths.list(doctype)),
+          children: t("backToList", "Back to {{doctype}} list", {
+            doctype
+          })
+        })
+      })
+    });
+  }
+  if (!isCreate && form.status === "notFound") {
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
       flex: 1,
       children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.EmptyState, {
@@ -528,7 +490,7 @@ function DocFormScreen({
       })
     });
   }
-  if (!isCreate && engine.isLoading) {
+  if (!isCreate && form.status === "loading") {
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
       flex: 1,
       ...knobProps.panelPadding,
@@ -540,16 +502,16 @@ function DocFormScreen({
   }
   const indicator = (0, import_FormToolbar.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()
@@ -559,29 +521,8 @@ function DocFormScreen({
   }, {
     label: isCreate ? t("newCrumb", "New") : title
   }];
-  const promptNamed = isCreate && (0, import_formLayout.isPromptNamed)(meta?.autoname, meta?.naming_rule);
   const sidebarStacked = sizeClass === "compact";
-  const bodyTabs = [...formTabs.map(tab => ({
-    value: tab.key,
-    label: tab.label,
-    content: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
-      ...knobProps.gapLg,
-      paddingTop: "$3",
-      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FormErrorBoundary.FormErrorBoundary, {
-        errorTitle: t("formTabRenderError", "This form tab failed to render"),
-        testID: `form-tab-error-${tab.key}`,
-        children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_frappe_ui.SchemaForm, {
-          schema: tab.schema,
-          doc: engine.doc,
-          setValue: engine.setValue,
-          errors: engine.errors,
-          disabled: formReadOnly || engine.isSaving,
-          sectionHeadingLevel: 2,
-          renderFieldWrapper: import_FormErrorBoundary.wrapFieldWithErrorBoundary
-        })
-      })
-    })
-  })), ...(showConnections ? [{
+  const connectionsTab = showConnections ? [{
     value: CONNECTIONS_TAB,
     label: t("connectionsTab", "Connections"),
     content: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
@@ -592,38 +533,40 @@ function DocFormScreen({
         meta
       })
     })
-  }] : [])];
-  const effectiveTab = activeTab && bodyTabs.some(tab => tab.value === activeTab) ? activeTab : bodyTabs[0]?.value;
+  }] : [];
+  const renderTab = (tab, content) => /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
+    ...knobProps.gapLg,
+    paddingTop: "$3",
+    children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FormErrorBoundary.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__ */
-  (0, import_jsx_runtime.jsxs)(import_components.YStack, {
+  (0, import_jsx_runtime.jsx)(import_components.YStack, {
     minWidth: 0,
-    ...knobProps.gapLg,
-    children: [promptNamed && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.YStack, {
-      ...knobProps.gap,
-      children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_forms.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__ */(0, import_jsx_runtime.jsx)(import_components.Tabs, {
-      items: bodyTabs,
-      value: effectiveTab,
-      onChange: setActiveTab,
-      lazyMount: true
-    }) : bodyTabs[0]?.content ?? null, engine.errors.general && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.Text, {
-      color: "$red10",
-      fontSize: "$3",
-      role: "alert",
-      children: engine.errors.general
-    })]
+    children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_frappe_ui.FrappeForm, {
+      form,
+      doctype,
+      name: docName,
+      disabled: readOnly,
+      showToolbar: false,
+      showSidebar: false,
+      showTimeline: false,
+      showConnections: false,
+      showBanners: false,
+      sectionHeadingLevel: 2,
+      renderFieldWrapper: import_FormErrorBoundary.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
@@ -635,16 +578,16 @@ function DocFormScreen({
     name: docName,
     docInfo: docinfo,
     refreshDocInfo: refreshDocinfo,
-    currentUser: engine.currentUser,
+    currentUser,
     connection
   }) : null;
   const sidebar = !isCreate && docName && meta ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FormSidebarPanel.FormSidebarPanel, {
     doctype,
     name: docName,
     meta,
-    doc: engine.doc,
+    doc: form.doc,
     docinfo,
-    currentUser: engine.currentUser,
+    currentUser,
     onRefresh: refreshDocinfo,
     stacked: sidebarStacked
   }) : null;
@@ -654,12 +597,12 @@ function DocFormScreen({
     title,
     indicator,
     showIndicator: !!meta,
-    isSaving: engine.isSaving,
-    cluster: !isCreate && docName ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FormHeaderCluster.FormHeaderCluster, {
+    isSaving: form.isSubmitting,
+    cluster: !isCreate && docName && !metaRefused ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FormHeaderCluster.FormHeaderCluster, {
       doctype,
       name: docName,
       docinfo,
-      currentUser: engine.currentUser,
+      currentUser,
       onRefresh: refreshDocinfo
     }) : void 0,
     canSave,
@@ -687,9 +630,9 @@ function DocFormScreen({
         name: docName
       } : {}),
       defaultContent: toolbar
-    }) : toolbar, (engine.wasDeleted || validationSummary || engine.conflict) && /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_components.YStack, {
+    }) : toolbar, (form.wasDeleted || validationSummary || form.conflict) && /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_components.YStack, {
       paddingHorizontal: "$3",
-      children: [engine.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.XStack, {
+      children: [form.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.XStack, {
         role: "alert",
         ...knobProps.containerRadius,
         ...knobProps.panelPadding,
@@ -699,7 +642,7 @@ function DocFormScreen({
           fontSize: "$3",
           children: t("deletedBanner", "This document was deleted on the server. Fields are read-only.")
         })
-      }), validationSummary && !engine.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.XStack, {
+      }), validationSummary && !form.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.XStack, {
         role: "alert",
         ...knobProps.containerRadius,
         ...knobProps.panelPadding,
@@ -710,7 +653,7 @@ function DocFormScreen({
           fontSize: "$3",
           children: validationSummary
         })
-      }), engine.conflict && !engine.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_components.XStack, {
+      }), form.conflict && !form.wasDeleted && /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_components.XStack, {
         role: "status",
         alignItems: "center",
         justifyContent: "space-between",
@@ -727,7 +670,7 @@ function DocFormScreen({
           size: "$2",
           outlined: true,
           "aria-label": t("reloadDoc", "Reload"),
-          onPress: engine.reload,
+          onPress: form.reset,
           children: t("reloadDoc", "Reload")
         })]
       })]
@@ -767,7 +710,7 @@ function DocFormScreen({
       warning: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.submit().then(ok => {
+        void form.submitDocument().then(ok => {
           if (ok) {
             (0, import_components.notify)({
               severity: "success",
@@ -789,7 +732,7 @@ function DocFormScreen({
       destructive: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.cancel().then(ok => {
+        void form.cancelDocument().then(ok => {
           if (ok) {
             (0, import_components.notify)({
               severity: "success",
@@ -812,7 +755,7 @@ function DocFormScreen({
       destructive: true,
       onConfirm: () => {
         setConfirmAction(void 0);
-        void engine.remove().then(ok => {
+        void form.remove().then(ok => {
           if (ok) {
             (0, import_useDocinfo.invalidateDocinfo)(doctype, name);
             emitEvent({