@multiplatform.one/frappe-ui 7.28.1 → 7.29.0

package/dist/esm/FrappeForm.native.js

@@ -1,12 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { createElement as _createElement } from "react";
-import { getFrappeSyncModule, useFrappeCollection, useFrappeDoctypeEvents, useLiveQuery, useDocTypeMeta } from "@multiplatform.one/frappe";
+import { useFrappeCollection, useLiveQuery } from "@multiplatform.one/frappe";
 import { AsyncBoundary, AsyncSkeleton, DetailPageLayout, EmptyState, PageHeader, Tabs } from "@multiplatform.one/components";
 import { SchemaForm } from "./schemaForm/index.native.js";
 import { FormSidebar } from "./FormSidebar.native.js";
-import { eq } from "@tanstack/db";
 import { ArrowLeftIcon } from "@phosphor-icons/react";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { Button, Input, formCommonColors } from "@multiplatform.one/forms";
 import { Text, XStack, YStack } from "tamagui";
@@ -15,70 +14,22 @@ import { useFrappeConfig } from "./FrappeProvider.native.js";
 import { FrappeReconnectIndicator } from "./FrappeReconnectIndicator.native.js";
 import { Timeline } from "./components/timeline.native.js";
 import { dialog } from "@multiplatform.one/desktop";
-import { applyFetchedValues, buildFetchMap } from "./formEngine/fetchFrom.native.js";
-import { buildPermLevelMatrix } from "./formEngine/fieldPermissions.native.js";
-import { createHttpClient, validateLink } from "./formEngine/formActions.native.js";
-import { buildFormTabs, isPromptNamed } from "./formEngine/formLayout.native.js";
-import { setCreatePrefill, takeCreatePrefill } from "./formEngine/createPrefill.native.js";
-import { buildAmendValues, canDeleteDoc, canEditDoc, isAmendable, resolveDocAction, resolveDocIndicator } from "./formEngine/docLifecycle.native.js";
-import { useAmendedAs } from "./formEngine/useAmendedAs.native.js";
-import { useDocRights } from "./formEngine/useDocRights.native.js";
-import { extractServerError } from "./formEngine/useFormEngine.native.js";
+import { canDeleteDoc, canEditDoc, isAmendable, resolveDocAction, resolveDocIndicator } from "./formEngine/docLifecycle.native.js";
 import { FrappeFormActions } from "./FrappeFormActions.native.js";
 import { connectionFields, connectionsFromMeta } from "./frappeConnections.native.js";
 import { FrappeFormConnections } from "./FrappeFormConnections.native.js";
 import { FrappeNotConfigured } from "./FrappeNotConfigured.native.js";
 import { FrappeRowsReader } from "./FrappeRowsReader.native.js";
+import { isPermissionError } from "./liveErrors.native.js";
+import { fieldsFromRecord } from "./recordShape.native.js";
 import { frappeRouteHref, frappeRouteTarget, useFrappeRouter } from "./frappeNavigation.native.js";
-function _instanceof(left, right) {
-  "@swc/helpers - instanceof";
-
-  if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
-    return !!right[Symbol.hasInstance](left);
-  } else {
-    return left instanceof right;
-  }
-}
-function isEmptyFieldValue(value) {
-  if (value === void 0 || value === null) return true;
-  if (typeof value === "string" && value.trim() === "") return true;
-  if (Array.isArray(value) && value.length === 0) return true;
-  return false;
-}
-function sectionsToLayoutFields(sections) {
-  var fields = [];
-  sections.forEach(function (section, sectionIndex) {
-    fields.push({
-      fieldname: `__section_${sectionIndex}`,
-      fieldtype: section.tab ? "Tab Break" : "Section Break",
-      label: section.label,
-      collapsible: section.collapsible ? 1 : 0
-    });
-    section.columns.forEach(function (column, columnIndex) {
-      if (columnIndex > 0) {
-        fields.push({
-          fieldname: `__column_${sectionIndex}_${columnIndex}`,
-          fieldtype: "Column Break"
-        });
-      }
-      fields.push(...column.fields);
-    });
-  });
-  return fields;
-}
-var documentBookkeeping = /* @__PURE__ */new Set(["name", "owner", "creation", "modified", "modified_by", "docstatus", "idx", "doctype", "_user_tags", "_comments", "_assign", "_liked_by", "_seen"]);
-function fieldsFromDocument(doc) {
-  return Object.entries(doc).filter(function (param) {
-    var [key, value] = param;
-    return !key.startsWith("$") && !documentBookkeeping.has(key) && (value === null || typeof value === "string" || typeof value === "number");
-  }).map(function (param) {
-    var [key, value] = param;
+import { useFrappeForm } from "./useFrappeForm.native.js";
+function schemaFieldsFromRecord(doc) {
+  return fieldsFromRecord(doc).map(function (field) {
     return {
-      name: key,
-      label: key.replace(/_/g, " ").replace(/(^|\s)\S/g, function (c) {
-        return c.toUpperCase();
-      }),
-      type: typeof value === "number" ? Number.isInteger(value) ? "Int" : "Float" : "Data",
+      name: field.fieldname,
+      label: field.label,
+      type: field.fieldtype,
       readOnly: true
     };
   });
@@ -248,21 +199,50 @@ function FrappeFormRoute(param) {
     }
   });
 }
-function FrappeFormBody(param) {
+function FrappeFormBody(props) {
+  if (props.form) return /* @__PURE__ */_jsx(FrappeFormView, {
+    ...props,
+    form: props.form
+  });
+  return /* @__PURE__ */_jsx(FrappeFormOwned, {
+    ...props
+  });
+}
+function FrappeFormOwned(props) {
+  var _props_baseURL, _props_showSidebar;
+  var config = useFrappeConfig();
+  if (!((_props_baseURL = props.baseURL) !== null && _props_baseURL !== void 0 ? _props_baseURL : config === null || config === void 0 ? void 0 : config.baseURL)) {
+    throw new Error("FrappeForm requires baseURL prop or FrappeProvider with baseURL");
+  }
+  var form = useFrappeForm({
+    doctype: props.doctype,
+    name: props.name,
+    baseURL: props.baseURL,
+    auth: props.auth,
+    syncOptions: props.syncOptions,
+    fields: props.fields,
+    sections: props.sections,
+    hideFields: props.hideFields,
+    hideSections: props.hideSections,
+    roles: props.roles,
+    readShares: (_props_showSidebar = props.showSidebar) !== null && _props_showSidebar !== void 0 ? _props_showSidebar : true,
+    disabled: props.disabled,
+    initialDoc: props.initialDoc
+  });
+  return /* @__PURE__ */_jsx(FrappeFormView, {
+    ...props,
+    form
+  });
+}
+function FrappeFormView(param) {
   var {
-    baseURL,
-    auth,
-    syncOptions,
+    form,
     doctype,
     name,
-    fields,
     children,
     overrides,
-    hideFields,
     readOnlyFields,
-    sections,
     order,
-    roles,
     onSave,
     onCancel,
     onDelete,
@@ -271,81 +251,57 @@ function FrappeFormBody(param) {
     showToolbar = true,
     showSidebar = true,
     showTimeline = true,
+    showBanners = true,
     disabled = false,
     sectionHeadingLevel,
     connections,
     showConnections = true,
-    initialDoc,
+    extraTabs,
+    renderFieldWrapper,
+    renderTab,
     loadingFallback,
     notFoundFallback,
     errorFallback,
     routePage
   } = param;
-  var _ref, _ref1;
+  var _ref;
   var _tabItems_, _tabItems_1;
-  var config = useFrappeConfig();
   var {
     knobProps
   } = useResolvedKnobs();
   var {
     t
   } = useTranslation();
-  var seedDoc = name && initialDoc && initialDoc.name === name ? initialDoc : void 0;
-  var seedRef = useRef(seedDoc);
-  seedRef.current = seedDoc;
-  var [localDoc, setLocalDoc] = useState(function () {
-    return seedDoc !== null && seedDoc !== void 0 ? seedDoc : {};
-  });
-  var [baselineDoc, setBaselineDoc] = useState(function () {
-    return seedDoc;
-  });
-  var [docError, setDocError] = useState(null);
-  var [conflictFields, setConflictFields] = useState([]);
-  var [wasDeleted, setWasDeleted] = useState(false);
-  var [isSubmitting, setIsSubmitting] = useState(false);
-  var [errors, setErrors] = useState({});
-  var [activeTab, setActiveTab] = useState(void 0);
-  var everLoadedRef = useRef(false);
-  var localDocRef = useRef(localDoc);
-  localDocRef.current = localDoc;
-  var baselineRef = useRef(baselineDoc);
-  baselineRef.current = baselineDoc;
-  var createDraftRef = useRef(void 0);
-  var finalBaseURL = baseURL !== null && baseURL !== void 0 ? baseURL : config === null || config === void 0 ? void 0 : config.baseURL;
-  var finalAuth = auth !== null && auth !== void 0 ? auth : config === null || config === void 0 ? void 0 : config.auth;
-  var finalSyncOptions = syncOptions !== null && syncOptions !== void 0 ? syncOptions : config === null || config === void 0 ? void 0 : config.syncOptions;
-  if (!finalBaseURL) {
-    throw new Error("FrappeForm requires baseURL prop or FrappeProvider with baseURL");
-  }
-  var frappeConfig = useMemo(function () {
-    return {
-      baseURL: finalBaseURL,
-      socketPort: config === null || config === void 0 ? void 0 : config.socketPort,
-      siteName: config === null || config === void 0 ? void 0 : config.siteName,
-      socketBaseURL: config === null || config === void 0 ? void 0 : config.socketBaseURL,
-      auth: finalAuth,
-      syncOptions: finalSyncOptions,
-      realtime: config === null || config === void 0 ? void 0 : config.realtime,
-      fixtures: config === null || config === void 0 ? void 0 : config.fixtures
-    };
-  }, [finalBaseURL, config === null || config === void 0 ? void 0 : config.socketPort, config === null || config === void 0 ? void 0 : config.siteName, config === null || config === void 0 ? void 0 : config.socketBaseURL, config === null || config === void 0 ? void 0 : config.realtime, finalAuth, finalSyncOptions, config === null || config === void 0 ? void 0 : config.fixtures]);
   var {
     meta,
-    isLoading: isMetaLoading,
-    error: metaError
-  } = useDocTypeMeta(frappeConfig, doctype);
-  var isSubmittable = !!(meta === null || meta === void 0 ? void 0 : meta.is_submittable);
+    metaLoading: isMetaLoading,
+    metaError,
+    doc: localDoc,
+    baseline: baselineDoc,
+    setValue,
+    errors,
+    isSubmitting,
+    docstatus,
+    isSubmittable,
+    rights,
+    rightsPending,
+    canWrite: canWriteRecord,
+    wasDeleted,
+    conflictFields,
+    docError,
+    tabs: formTabs,
+    promptNamed,
+    activeTab,
+    setActiveTab,
+    amendedAs
+  } = form;
+  var frappeConfig = form.connection;
   var isCreate = !name;
-  var docstatus = Number((_ref = baselineDoc === null || baselineDoc === void 0 ? void 0 : baselineDoc.docstatus) !== null && _ref !== void 0 ? _ref : 0);
-  var layoutFields = useMemo(function () {
-    if (!meta) return void 0;
-    return sections ? sectionsToLayoutFields(sections) : meta.fields;
-  }, [meta, sections]);
-  var amendedAs = useAmendedAs(isSubmittable && docstatus === 2 ? frappeConfig : void 0, doctype, name);
+  var hasUnsavedChanges = form.isDirty;
   var readsWithoutMeta = !children && !meta && Boolean(metaError) && Boolean(name);
   var recordTabs = useMemo(function () {
     if (!readsWithoutMeta || !baselineDoc) return void 0;
-    var recordFields = fieldsFromDocument(baselineDoc);
+    var recordFields = schemaFieldsFromRecord(baselineDoc);
     return [{
       key: "__details",
       label: t("Details"),
@@ -359,97 +315,7 @@ function FrappeFormBody(param) {
       }
     }];
   }, [readsWithoutMeta, baselineDoc, t]);
-  var promptNamed = isCreate && !!meta && isPromptNamed(meta.autoname, meta.naming_rule);
-  var fetchMap = useMemo(function () {
-    return meta ? buildFetchMap(meta.fields) : void 0;
-  }, [meta]);
-  var handleDocSyncError = useCallback(function (err) {
-    setDocError(_instanceof(err, Error) ? err : new Error(String(err)));
-  }, []);
-  var docCollection = useFrappeCollection(name ? frappeConfig : void 0, doctype, {
-    fields,
-    filters: name ? {
-      name
-    } : void 0,
-    onSyncError: handleDocSyncError
-  });
-  var {
-    data: rawDocData,
-    isLoading: isDocLoading
-  } = useLiveQuery(function (q) {
-    if (!docCollection || !name) return null;
-    return q.from({
-      _doc: docCollection
-    }).where(function (param2) {
-      var {
-        _doc
-      } = param2;
-      if (!_doc) return eq(name, name);
-      return eq(_doc.name, name);
-    });
-  }, [docCollection, name]);
-  var liveDoc = useMemo(function () {
-    var _arr_;
-    var arr = Array.isArray(rawDocData) ? rawDocData : rawDocData ? [rawDocData] : [];
-    var doc = (_arr_ = arr[0]) !== null && _arr_ !== void 0 ? _arr_ : null;
-    return doc ? {
-      data: doc,
-      isLoading: isDocLoading
-    } : name ? {
-      data: null,
-      isLoading: isDocLoading
-    } : null;
-  }, [rawDocData, isDocLoading, name]);
-  var collection = useFrappeCollection(name ? void 0 : frappeConfig, doctype, {
-    fields
-  });
-  var shareCollection = useFrappeCollection(showSidebar && name ? frappeConfig : void 0, "DocShare", {
-    fields: ["name", "user", "everyone", "read", "write", "share"],
-    filters: {
-      share_doctype: doctype,
-      share_name: name
-    }
-  });
-  var {
-    data: rawShareRows
-  } = useLiveQuery(function (q) {
-    return shareCollection ? q.from({
-      _share: shareCollection
-    }) : null;
-  }, [shareCollection]);
-  var shareRows = useMemo(function () {
-    return shareCollection ? rawShareRows !== null && rawShareRows !== void 0 ? rawShareRows : [] : void 0;
-  }, [shareCollection, rawShareRows]);
-  var owner = baselineDoc === null || baselineDoc === void 0 ? void 0 : baselineDoc.owner;
-  var {
-    rights,
-    pending: rightsPending,
-    roles: effectiveRoles
-  } = useDocRights(frappeConfig, meta, {
-    roles,
-    owner: typeof owner === "string" ? owner : void 0,
-    shares: shareRows
-  });
-  var permLevels = useMemo(function () {
-    return buildPermLevelMatrix(meta === null || meta === void 0 ? void 0 : meta.permissions, effectiveRoles);
-  }, [meta === null || meta === void 0 ? void 0 : meta.permissions, effectiveRoles]);
-  var formTabs = useMemo(function () {
-    if (!layoutFields) return void 0;
-    return buildFormTabs({
-      fields: layoutFields,
-      doc: {
-        ...localDoc,
-        __islocal: isCreate ? 1 : 0
-      },
-      docstatus,
-      formReadOnly: !!(meta === null || meta === void 0 ? void 0 : meta.read_only),
-      isCreate,
-      detailsLabel: t("Details"),
-      permLevels,
-      hiddenFields: hideFields
-    });
-  }, [layoutFields, localDoc, docstatus, meta === null || meta === void 0 ? void 0 : meta.read_only, isCreate, permLevels, hideFields, t]);
-  var assignmentCollection = useFrappeCollection(showSidebar && name && !frappeConfig.fixtures ? frappeConfig : void 0, "ToDo", {
+  var assignmentCollection = useFrappeCollection(showSidebar && name && frappeConfig && !frappeConfig.fixtures ? frappeConfig : void 0, "ToDo", {
     fields: ["name", "allocated_to", "status", "reference_type", "reference_name"],
     filters: {
       reference_type: doctype,
@@ -467,16 +333,6 @@ function FrappeFormBody(param) {
   var assignmentRows = useMemo(function () {
     return assignmentCollection ? rawAssignmentRows !== null && rawAssignmentRows !== void 0 ? rawAssignmentRows : [] : void 0;
   }, [assignmentCollection, rawAssignmentRows]);
-  useEffect(function () {
-    everLoadedRef.current = false;
-    if (name) createDraftRef.current = void 0;
-    setWasDeleted(false);
-    setConflictFields([]);
-    setDocError(null);
-    var seed = seedRef.current;
-    setBaselineDoc(seed);
-    if (seed) setLocalDoc(seed);
-  }, [doctype, name]);
   var effectiveConnections = useMemo(function () {
     return connections !== null && connections !== void 0 ? connections : connectionsFromMeta(meta);
   }, [connections, meta]);
@@ -544,395 +400,48 @@ function FrappeFormBody(param) {
     var _connectionSnapshots_link_doctype;
     return (_ref2 = (_connectionSnapshots_link_doctype = connectionSnapshots[link.doctype]) === null || _connectionSnapshots_link_doctype === void 0 ? void 0 : _connectionSnapshots_link_doctype.isLoading) !== null && _ref2 !== void 0 ? _ref2 : true;
   });
-  useFrappeDoctypeEvents(name ? frappeConfig : void 0, doctype, function (event) {
-    if (event.type !== "doc_deleted") return;
-    var payload = event.payload;
-    if ((payload === null || payload === void 0 ? void 0 : payload.name) === name) setWasDeleted(true);
-  }, Boolean(name));
-  useEffect(function () {
-    var incoming = liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data;
-    if (incoming) {
-      everLoadedRef.current = true;
-      setWasDeleted(false);
-      var baseline = baselineRef.current;
-      if (!baseline) {
-        setBaselineDoc(incoming);
-        setLocalDoc(incoming);
-        return;
-      }
-      var local = localDocRef.current;
-      var merged = {
-        ...incoming
-      };
-      var newConflicts = [];
-      var _iteratorNormalCompletion = true,
-        _didIteratorError = false,
-        _iteratorError = void 0;
-      try {
-        for (var _iterator = Object.keys(local)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-          var key = _step.value;
-          var localValue = local[key];
-          if (localValue === baseline[key]) continue;
-          merged[key] = localValue;
-          var remote = incoming[key];
-          if (remote !== baseline[key] && remote !== localValue) newConflicts.push(key);
-        }
-      } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-      } finally {
-        try {
-          if (!_iteratorNormalCompletion && _iterator.return != null) {
-            _iterator.return();
-          }
-        } finally {
-          if (_didIteratorError) {
-            throw _iteratorError;
-          }
-        }
-      }
-      setBaselineDoc(incoming);
-      setLocalDoc(merged);
-      if (newConflicts.length > 0) {
-        setConflictFields(function (prev) {
-          return Array.from(/* @__PURE__ */new Set([...prev, ...newConflicts]));
-        });
-      }
-    } else if (name && everLoadedRef.current && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.isLoading)) {
-      setWasDeleted(true);
-    } else if (!name) {
-      var _createDraftRef_current;
-      if (((_createDraftRef_current = createDraftRef.current) === null || _createDraftRef_current === void 0 ? void 0 : _createDraftRef_current.doctype) !== doctype) {
-        createDraftRef.current = {
-          doctype,
-          values: takeCreatePrefill(doctype)
-        };
-      }
-      setLocalDoc({
-        ...createDraftRef.current.values,
-        doctype
-      });
-    }
-  }, [liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data, liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.isLoading, doctype, name]);
-  var dirtyFieldNames = useMemo(function () {
-    var local = localDoc;
-    var base = baselineDoc;
-    var dirty = [];
-    var _iteratorNormalCompletion = true,
-      _didIteratorError = false,
-      _iteratorError = void 0;
-    try {
-      for (var _iterator = Object.keys(local)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-        var key = _step.value;
-        if (key === "doctype" || key === "name") continue;
-        if (base ? local[key] !== base[key] : local[key] !== void 0) dirty.push(key);
-      }
-    } catch (err) {
-      _didIteratorError = true;
-      _iteratorError = err;
-    } finally {
-      try {
-        if (!_iteratorNormalCompletion && _iterator.return != null) {
-          _iterator.return();
-        }
-      } finally {
-        if (_didIteratorError) {
-          throw _iteratorError;
-        }
-      }
-    }
-    return dirty;
-  }, [localDoc, baselineDoc]);
-  var hasUnsavedChanges = dirtyFieldNames.length > 0;
-  var runFetchFrom = function runFetchFrom2(field, value) {
-    var rules = fetchMap === null || fetchMap === void 0 ? void 0 : fetchMap.get(field);
-    if (!rules || rules.length === 0) return;
-    var applyPatch = function applyPatch2(fetched2) {
-      setLocalDoc(function (prev) {
-        var current = prev;
-        if (current[field] !== value) return prev;
-        var patch = applyFetchedValues(rules, fetched2, current);
-        return Object.keys(patch).length > 0 ? {
-          ...current,
-          ...patch
-        } : prev;
-      });
-    };
-    if (isEmptyFieldValue(value)) {
-      applyPatch({});
-      return;
-    }
-    var linkField = meta === null || meta === void 0 ? void 0 : meta.fields.find(function (metaField) {
-      return metaField.fieldname === field;
-    });
-    var targetDoctype = typeof (linkField === null || linkField === void 0 ? void 0 : linkField.options) === "string" ? linkField.options : "";
-    if (!targetDoctype) return;
-    var sources = Array.from(new Set(rules.map(function (rule) {
-      return rule.source;
-    })));
-    var fixtures = frappeConfig.fixtures;
-    var fetched = fixtures ? fixtures.getDoc(targetDoctype, String(value), sources).then(function (doc) {
-      return doc !== null && doc !== void 0 ? doc : {};
-    }) : validateLink(createHttpClient(frappeConfig), targetDoctype, String(value), sources);
-    fetched.then(applyPatch).catch(function () {
-      return void 0;
-    });
-  };
-  var setValue = function setValue2(field, value) {
-    setLocalDoc(function (prev) {
-      return {
-        ...prev,
-        [field]: value
-      };
-    });
-    setErrors(function (prev) {
-      var newErrors = {
-        ...prev
-      };
-      delete newErrors[String(field)];
-      return newErrors;
-    });
-    runFetchFrom(String(field), value);
-  };
-  var validateRequiredFields = function validateRequiredFields2() {
-    if (!formTabs) return {};
-    var validationErrors = {};
-    var doc = localDoc;
-    if (promptNamed && isEmptyFieldValue(doc.name)) {
-      validationErrors.name = t("Name is required");
-    }
-    var _iteratorNormalCompletion = true,
-      _didIteratorError = false,
-      _iteratorError = void 0;
-    try {
-      for (var _iterator = formTabs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-        var tab = _step.value;
-        var _iteratorNormalCompletion1 = true,
-          _didIteratorError1 = false,
-          _iteratorError1 = void 0;
-        try {
-          for (var _iterator1 = tab.schema.fields[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true) {
-            var field = _step1.value;
-            if (!field.required) continue;
-            if (isEmptyFieldValue(doc[field.name])) {
-              validationErrors[field.name] = t("{{label}} is required", {
-                label: field.label || field.name
-              });
-            }
-          }
-        } catch (err) {
-          _didIteratorError1 = true;
-          _iteratorError1 = err;
-        } finally {
-          try {
-            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-              _iterator1.return();
-            }
-          } finally {
-            if (_didIteratorError1) {
-              throw _iteratorError1;
-            }
-          }
-        }
-      }
-    } catch (err) {
-      _didIteratorError = true;
-      _iteratorError = err;
-    } finally {
-      try {
-        if (!_iteratorNormalCompletion && _iterator.return != null) {
-          _iterator.return();
-        }
-      } finally {
-        if (_didIteratorError) {
-          throw _iteratorError;
-        }
-      }
-    }
-    return validationErrors;
-  };
-  var canWriteRecord = isCreate ? rights.create : rights.write;
   var handleSave = async function handleSave2() {
-    if (wasDeleted || !canWriteRecord) return;
-    var requiredErrors = validateRequiredFields();
-    if (Object.keys(requiredErrors).length > 0) {
-      setErrors(requiredErrors);
-      return;
-    }
-    setIsSubmitting(true);
-    setErrors({});
-    try {
-      if (name) {
-        if (!docCollection) return;
-        var changedFields = dirtyFieldNames;
-        if (changedFields.length > 0) {
-          var local = localDoc;
-          var tx = docCollection.update(name, function (draft) {
-            var _iteratorNormalCompletion2 = true,
-              _didIteratorError2 = false,
-              _iteratorError2 = void 0;
-            try {
-              for (var _iterator2 = changedFields[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true) {
-                var key = _step2.value;
-                draft[key] = local[key];
-              }
-            } catch (err) {
-              _didIteratorError2 = true;
-              _iteratorError2 = err;
-            } finally {
-              try {
-                if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
-                  _iterator2.return();
-                }
-              } finally {
-                if (_didIteratorError2) {
-                  throw _iteratorError2;
-                }
-              }
-            }
-          });
-          await tx.isPersisted.promise;
-        }
-        setConflictFields([]);
-      } else {
-        var _localDoc_name, _ref2;
-        var _getFrappeSyncModule;
-        if (!collection) return;
-        var temporaryName = (_localDoc_name = localDoc.name) !== null && _localDoc_name !== void 0 ? _localDoc_name : `new-${Date.now()}`;
-        var docToInsert = {
-          ...localDoc,
-          doctype,
-          name: temporaryName
-        };
-        var tx1 = collection.insert(docToInsert);
-        await tx1.isPersisted.promise;
-        var createdName = (_ref2 = (_getFrappeSyncModule = getFrappeSyncModule(frappeConfig)) === null || _getFrappeSyncModule === void 0 ? void 0 : _getFrappeSyncModule.createdName(temporaryName)) !== null && _ref2 !== void 0 ? _ref2 : temporaryName;
-        onSave === null || onSave === void 0 ? void 0 : onSave({
-          ...localDoc,
-          name: createdName
-        });
-        return;
-      }
-      onSave === null || onSave === void 0 ? void 0 : onSave(localDoc);
-    } catch (err1) {
-      var e = err1;
-      if ((e === null || e === void 0 ? void 0 : e.exc_type) === "ValidationError") {
-        var validationErrors = {};
-        if (e._server_messages) {
-          try {
-            var messages = JSON.parse(e._server_messages);
-            var _iteratorNormalCompletion = true,
-              _didIteratorError = false,
-              _iteratorError = void 0;
-            try {
-              for (var _iterator = messages[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-                var msg = _step.value;
-                var parsed = typeof msg === "string" ? JSON.parse(msg) : msg;
-                if (parsed.message) {
-                  validationErrors.general = parsed.message;
-                }
-              }
-            } catch (err) {
-              _didIteratorError = true;
-              _iteratorError = err;
-            } finally {
-              try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                  _iterator.return();
-                }
-              } finally {
-                if (_didIteratorError) {
-                  throw _iteratorError;
-                }
-              }
-            }
-          } catch (unused) {
-            validationErrors.general = t("Validation error occurred");
-          }
-        }
-        setErrors(validationErrors);
-      } else {
-        setErrors({
-          general: (e === null || e === void 0 ? void 0 : e.message) || t("Failed to save document")
-        });
-      }
-    } finally {
-      setIsSubmitting(false);
-    }
+    var saved = await form.save();
+    if (!saved) return;
+    onSave === null || onSave === void 0 ? void 0 : onSave(isCreate ? {
+      ...localDoc,
+      name: saved
+    } : localDoc);
   };
   var handleCancel = function handleCancel2() {
-    if (baselineDoc) {
-      setLocalDoc(baselineDoc);
-    } else if (liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data) {
-      setLocalDoc(liveDoc.data);
-    } else {
-      setLocalDoc({
-        doctype
-      });
-    }
-    setConflictFields([]);
-    setErrors({});
+    form.reset();
     onCancel === null || onCancel === void 0 ? void 0 : onCancel();
   };
   var handleDelete = async function handleDelete2() {
-    if (!docCollection || !name || wasDeleted || !rights.delete) return;
+    if (!name || wasDeleted || !rights.delete) return;
     if (!(await dialog.confirm(t("Delete this {{doctype}}?", {
       doctype
     })))) return;
-    setIsSubmitting(true);
-    setErrors({});
-    try {
-      var tx = docCollection.delete(name);
-      await tx.isPersisted.promise;
-      onDelete === null || onDelete === void 0 ? void 0 : onDelete(localDoc);
-    } catch (err) {
-      setErrors({
-        general: (err === null || err === void 0 ? void 0 : err.message) || t("Failed to delete")
-      });
-    } finally {
-      setIsSubmitting(false);
-    }
+    if (await form.remove()) onDelete === null || onDelete === void 0 ? void 0 : onDelete(localDoc);
   };
-  var transitionDocstatus = async function transitionDocstatus2(to, question, failure) {
-    if (!docCollection || !name || wasDeleted || !rights[to === 1 ? "submit" : "cancel"]) return;
-    if (to === 1) {
-      var requiredErrors = validateRequiredFields();
-      if (Object.keys(requiredErrors).length > 0) {
-        setErrors(requiredErrors);
-        return;
-      }
-    }
-    if (!(await dialog.confirm(question))) return;
-    setIsSubmitting(true);
-    setErrors({});
-    try {
-      var tx = docCollection.update(name, function (draft) {
-        draft.docstatus = to;
-      });
-      await tx.isPersisted.promise;
-    } catch (err) {
-      setErrors({
-        general: extractServerError(err, failure)
-      });
-    } finally {
-      setIsSubmitting(false);
+  var handleSubmitDocument = async function handleSubmitDocument2() {
+    if (!name || wasDeleted || !rights.submit) return;
+    var requiredErrors = form.validate();
+    if (Object.keys(requiredErrors).length > 0) {
+      form.setErrors(requiredErrors);
+      return;
     }
-  };
-  var handleSubmitDocument = function handleSubmitDocument2() {
-    return transitionDocstatus(1, t("Permanently Submit {{name}}?", {
+    if (!(await dialog.confirm(t("Permanently Submit {{name}}?", {
       name
-    }), t("Failed to submit"));
+    })))) return;
+    await form.submitDocument();
   };
-  var handleCancelDocument = function handleCancelDocument2() {
-    return transitionDocstatus(2, t("Permanently Cancel {{name}}?", {
+  var handleCancelDocument = async function handleCancelDocument2() {
+    if (!name || wasDeleted || !rights.cancel) return;
+    if (!(await dialog.confirm(t("Permanently Cancel {{name}}?", {
       name
-    }), t("Failed to cancel"));
+    })))) return;
+    await form.cancelDocument();
   };
   var handleAmend = function handleAmend2() {
-    if (!meta || !name || !onAmend || !rights.amend) return;
-    var draft = buildAmendValues(meta.fields, localDoc, name);
-    setCreatePrefill(doctype, draft);
-    onAmend(draft);
+    if (!onAmend) return;
+    var draft = form.amend();
+    if (draft) onAmend(draft);
   };
   var titleField = meta === null || meta === void 0 ? void 0 : meta.title_field;
   var titleValue = titleField ? localDoc[titleField] : void 0;
@@ -994,27 +503,34 @@ function FrappeFormBody(param) {
     }));
   }
   if (!children && metaError && !meta && !name) {
-    return frame(/* @__PURE__ */_jsxs(YStack, {
+    return frame(isPermissionError(metaError) ? /* @__PURE__ */_jsx(EmptyState, {
+      testID: "frappe-form-not-permitted",
+      title: t("You can't create {{doctype}}", {
+        doctype
+      }),
+      description: metaError.message
+    }) : /* @__PURE__ */_jsx(AsyncBoundary, {
       ...knobProps.panelPadding,
-      alignItems: "center",
-      ...knobProps.gap,
-      children: [/* @__PURE__ */_jsx(Text, {
-        color: formCommonColors.error,
-        ...knobProps.body,
-        children: t("Failed to load {{doctype}} form", {
-          doctype
-        })
-      }), /* @__PURE__ */_jsx(Text, {
-        color: formCommonColors.muted,
-        ...knobProps.body,
-        children: metaError.message
-      })]
+      error: metaError,
+      errorTitle: t("Failed to load {{doctype}} form", {
+        doctype
+      })
     }));
   }
-  var isDocReading = Boolean(name) && (!docCollection || Boolean(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.isLoading));
-  var showsSeed = Boolean(seedDoc) && isDocReading;
-  if (name && docError && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data) && !wasDeleted) {
+  if (name && form.status === "error" && docError) {
     if (errorFallback !== void 0) return frame(errorFallback);
+    if (isPermissionError(docError)) {
+      return frame(/* @__PURE__ */_jsx(EmptyState, {
+        testID: "frappe-form-not-permitted",
+        title: t("You can't open {{doctype}} {{name}}", {
+          doctype,
+          name
+        }),
+        description: t("Your session can't read this {{doctype}}.", {
+          doctype
+        })
+      }));
+    }
     return frame(/* @__PURE__ */_jsx(AsyncBoundary, {
       ...knobProps.panelPadding,
       error: docError,
@@ -1023,7 +539,7 @@ function FrappeFormBody(param) {
       })
     }));
   }
-  if (name && isDocReading && !showsSeed && !wasDeleted) {
+  if (name && form.status === "loading") {
     if (loadingFallback !== void 0) return frame(loadingFallback);
     return frame(/* @__PURE__ */_jsx(YStack, {
       ...knobProps.panelPadding,
@@ -1033,7 +549,7 @@ function FrappeFormBody(param) {
       })
     }));
   }
-  if (name && !isDocReading && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data) && !wasDeleted) {
+  if (name && form.status === "notFound") {
     if (notFoundFallback !== void 0) return frame(notFoundFallback);
     return frame(/* @__PURE__ */_jsxs(YStack, {
       ...knobProps.panelPadding,
@@ -1083,7 +599,7 @@ function FrappeFormBody(param) {
   var toolbarShown = showToolbar && !readsWithoutMeta && Boolean(indicator || docAction || showDelete || showEdit || showClose);
   var shownTabs = formTabs !== null && formTabs !== void 0 ? formTabs : recordTabs;
   var imageFieldName = meta === null || meta === void 0 ? void 0 : meta.image_field;
-  var sidebarImageUrl = imageFieldName ? resolveFileUrl(localDoc[imageFieldName], finalBaseURL) : void 0;
+  var sidebarImageUrl = imageFieldName ? resolveFileUrl(localDoc[imageFieldName], frappeConfig === null || frappeConfig === void 0 ? void 0 : frappeConfig.baseURL) : void 0;
   var conflictLabels = conflictFields.map(function (fieldname) {
     var field = meta === null || meta === void 0 ? void 0 : meta.fields.find(function (metaField) {
       return metaField.fieldname === fieldname;
@@ -1091,25 +607,27 @@ function FrappeFormBody(param) {
     return (field === null || field === void 0 ? void 0 : field.label) || fieldname;
   }).join(", ");
   var formTabItems = (shownTabs !== null && shownTabs !== void 0 ? shownTabs : []).map(function (tab) {
+    var content = /* @__PURE__ */_jsx(SchemaForm, {
+      schema: tab.schema,
+      doc: localDoc,
+      setValue: function setValue1(field, value) {
+        return setValue(field, value);
+      },
+      errors,
+      disabled: fieldsDisabled,
+      overrides,
+      readOnlyFields,
+      sectionHeadingLevel,
+      order,
+      renderFieldWrapper
+    });
     return {
       value: tab.key,
       label: tab.label,
-      content: /* @__PURE__ */_jsx(SchemaForm, {
-        schema: tab.schema,
-        doc: localDoc,
-        setValue: function setValue1(field, value) {
-          return setValue(field, value);
-        },
-        errors,
-        disabled: fieldsDisabled,
-        overrides,
-        readOnlyFields,
-        sectionHeadingLevel,
-        order
-      })
+      content: renderTab ? renderTab(tab, content) : content
     };
   });
-  var tabItems = showConnections && name && effectiveConnections.length > 0 ? [...formTabItems, {
+  var tabItems = [...formTabItems, ...(showConnections && name && frappeConfig && effectiveConnections.length > 0 ? [{
     value: "__connections",
     label: t("Connections"),
     content: /* @__PURE__ */_jsx(FrappeFormConnections, {
@@ -1117,14 +635,14 @@ function FrappeFormBody(param) {
       connections: effectiveConnections,
       name
     })
-  }] : formTabItems;
+  }] : []), ...(extraTabs !== null && extraTabs !== void 0 ? extraTabs : [])];
   var effectiveTab = activeTab && tabItems.some(function (tab) {
     return tab.value === activeTab;
   }) ? activeTab : (_tabItems_ = tabItems[0]) === null || _tabItems_ === void 0 ? void 0 : _tabItems_.value;
   var localName = localDoc.name;
   var sidebar = showSidebar && name && meta ? /* @__PURE__ */_jsx(FormSidebar, {
     imageUrl: sidebarImageUrl,
-    sections: buildSidebarSections(localDoc, shareRows, t, assignmentRows),
+    sections: buildSidebarSections(localDoc, form.shareRows, t, assignmentRows),
     metadata: mapDocToSidebarMetadata(localDoc, t)
   }) : void 0;
   return frame(
@@ -1138,16 +656,16 @@ function FrappeFormBody(param) {
     flexGrow: 1,
     flexShrink: 1,
     flexBasis: "auto",
-    children: [/* @__PURE__ */_jsx(FrappeReconnectIndicator, {
+    children: [frappeConfig ? /* @__PURE__ */_jsx(FrappeReconnectIndicator, {
       config: frappeConfig
-    }), connectionReads.map(function (read) {
+    }) : null, frappeConfig ? connectionReads.map(function (read) {
       return /* @__PURE__ */_jsx(FrappeRowsReader, {
         connection: frappeConfig,
         doctype: read.link.doctype,
         options: read.options,
         onChange: read.onChange
       }, read.link.doctype);
-    }), wasDeleted && /* @__PURE__ */_jsx(XStack, {
+    }) : null, showBanners && wasDeleted && /* @__PURE__ */_jsx(XStack, {
       role: "alert",
       alignItems: "center",
       ...knobProps.containerRadius,
@@ -1163,7 +681,7 @@ function FrappeFormBody(param) {
           doctype
         })
       })
-    }), !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */_jsx(XStack, {
+    }), showBanners && !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */_jsx(XStack, {
       role: "status",
       alignItems: "center",
       ...knobProps.containerRadius,
@@ -1220,7 +738,7 @@ function FrappeFormBody(param) {
             value: effectiveTab,
             onChange: setActiveTab,
             lazyMount: true
-          }) : (_ref1 = (_tabItems_1 = tabItems[0]) === null || _tabItems_1 === void 0 ? void 0 : _tabItems_1.content) !== null && _ref1 !== void 0 ? _ref1 : null]
+          }) : (_ref = (_tabItems_1 = tabItems[0]) === null || _tabItems_1 === void 0 ? void 0 : _tabItems_1.content) !== null && _ref !== void 0 ? _ref : null]
         }) :
         // Metadata unavailable (should be covered by metaError branch above)
         /* @__PURE__ */
@@ -1235,6 +753,7 @@ function FrappeFormBody(param) {
         }), errors.general && /* @__PURE__ */_jsx(Text, {
           color: formCommonColors.error,
           ...knobProps.body,
+          role: "alert",
           children: errors.general
         }), toolbarShown && /* @__PURE__ */_jsx(FrappeFormActions, {
           indicator,