@multiplatform.one/frappe-ui 7.11.0 → 7.16.0

package/dist/esm/FrappeForm.native.js

@@ -1,62 +1,87 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useFrappeCollection, useFrappeDoctypeEvents, useLiveQuery, useDocTypeMeta } from "@multiplatform.one/frappe";
-import { AsyncSkeleton } from "@multiplatform.one/components";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
+import { getFrappeSyncModule, useFrappeCollection, useFrappeDoctypeEvents, useLiveQuery, useDocTypeMeta } from "@multiplatform.one/frappe";
+import { AsyncBoundary, AsyncSkeleton, DetailPageLayout, 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 { FloppyDiskIcon, TrashIcon, XIcon } from "@phosphor-icons/react";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { ArrowLeftIcon, FloppyDiskIcon, PencilSimpleIcon, TrashIcon, XIcon } from "@phosphor-icons/react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useTranslation } from "react-i18next";
-import { Button, formCommonColors } from "@multiplatform.one/forms";
+import { Button, Input, formCommonColors } from "@multiplatform.one/forms";
 import { Text, XStack, YStack } from "tamagui";
 import { useResolvedKnobs } from "@multiplatform.one/theme";
 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";
-var LAYOUT_FIELDTYPES = /* @__PURE__ */new Set(["Section Break", "Column Break", "Tab Break"]);
+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 { useSessionRoles } from "./formEngine/useSessionRoles.native.js";
+import { connectionFields, connectionsFromMeta } from "./frappeConnections.native.js";
+import { FrappeFormConnections } from "./FrappeFormConnections.native.js";
+import { FrappeRowsReader } from "./FrappeRowsReader.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 mapFieldToGenericSchema(field) {
-  return {
-    type: field.fieldtype,
-    name: field.fieldname,
-    label: field.label,
-    options: field.options,
-    required: !!field.reqd,
-    hidden: !!field.hidden,
-    readOnly: !!field.read_only,
-    precision: field.precision,
-    depends_on: field.depends_on,
-    // Pass through additional Frappe-specific metadata
-    fieldtype: field.fieldtype,
-    fieldname: field.fieldname,
-    in_list_view: field.in_list_view,
-    in_standard_filter: field.in_standard_filter
-  };
+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;
 }
-function mapMetaToFormSchema(meta, sectionOverrides) {
-  var sections = sectionOverrides !== null && sectionOverrides !== void 0 ? sectionOverrides : meta.sections;
-  var genericSections = sections.map(function (section) {
+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;
     return {
-      label: section.label,
-      collapsible: section.collapsible,
-      columns: section.columns.map(function (col) {
-        return {
-          fields: col.fields.map(mapFieldToGenericSchema)
-        };
-      })
+      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",
+      readOnly: true
     };
   });
-  var allFields = meta.fields.map(mapFieldToGenericSchema);
-  return {
-    sections: genericSections,
-    fields: allFields
-  };
+}
+function hasRestrictedPermLevel(meta) {
+  return !!(meta === null || meta === void 0 ? void 0 : meta.fields.some(function (field) {
+    var _field_permlevel;
+    return Number((_field_permlevel = field.permlevel) !== null && _field_permlevel !== void 0 ? _field_permlevel : 0) > 0;
+  }));
 }
 function resolveFileUrl(value, baseURL) {
   if (!value || typeof value !== "string") return void 0;
@@ -131,7 +156,85 @@ function mapDocToSidebarMetadata(doc, t) {
   }
   return metadata;
 }
-function FrappeForm(param) {
+function FrappeForm(props) {
+  var {
+    route,
+    ...formProps
+  } = props;
+  if (route === void 0) return /* @__PURE__ */_jsx(FrappeFormBody, {
+    ...formProps
+  });
+  return /* @__PURE__ */_jsx(FrappeFormRoute, {
+    ...formProps,
+    route
+  });
+}
+function FrappeFormRoute(param) {
+  var {
+    route,
+    name: nameProp,
+    onSave,
+    onCancel,
+    onDelete,
+    onEdit,
+    ...props
+  } = param;
+  var router = useFrappeRouter();
+  var fromPath = router ? frappeRouteTarget(route, router.pathname) : void 0;
+  var target = nameProp ? {
+    mode: (fromPath === null || fromPath === void 0 ? void 0 : fromPath.mode) === "view" ? "view" : "edit",
+    name: nameProp
+  } : (fromPath === null || fromPath === void 0 ? void 0 : fromPath.mode) === "view" || (fromPath === null || fromPath === void 0 ? void 0 : fromPath.mode) === "edit" ? fromPath : {
+    mode: "create"
+  };
+  var go = function go2(next) {
+    return router === null || router === void 0 ? void 0 : router.navigate(frappeRouteHref(route, next));
+  };
+  var name = target.mode === "view" || target.mode === "edit" ? target.name : void 0;
+  return /* @__PURE__ */_createElement(FrappeFormBody, {
+    ...props,
+    // A new target is a new page: no state carries over from the last one.
+    key: `${target.mode}:${name !== null && name !== void 0 ? name : ""}`,
+    name,
+    routePage: {
+      onBack: function onBack() {
+        return go({
+          mode: "list"
+        });
+      }
+    },
+    onEdit: target.mode === "view" ? onEdit !== null && onEdit !== void 0 ? onEdit : function () {
+      return go({
+        mode: "edit",
+        name: target.name
+      });
+    } : void 0,
+    onSave: onSave !== null && onSave !== void 0 ? onSave : function (doc) {
+      var _doc_name;
+      var saved = (_doc_name = doc.name) !== null && _doc_name !== void 0 ? _doc_name : name;
+      go(saved ? {
+        mode: "view",
+        name: saved
+      } : {
+        mode: "list"
+      });
+    },
+    onCancel: onCancel !== null && onCancel !== void 0 ? onCancel : function () {
+      return go(name ? {
+        mode: "view",
+        name
+      } : {
+        mode: "list"
+      });
+    },
+    onDelete: onDelete !== null && onDelete !== void 0 ? onDelete : function () {
+      return go({
+        mode: "list"
+      });
+    }
+  });
+}
+function FrappeFormBody(param) {
   var {
     baseURL,
     auth,
@@ -145,15 +248,26 @@ function FrappeForm(param) {
     readOnlyFields,
     sections,
     order,
+    roles,
     onSave,
     onCancel,
     onDelete,
+    onEdit,
     showToolbar = true,
     showSidebar = true,
     showTimeline = true,
     disabled = false,
-    sectionHeadingLevel
+    sectionHeadingLevel,
+    connections,
+    showConnections = true,
+    initialDoc,
+    loadingFallback,
+    notFoundFallback,
+    errorFallback,
+    routePage
   } = param;
+  var _ref, _ref1;
+  var _tabItems_, _tabItems_1;
   var config = useFrappeConfig();
   var {
     knobProps
@@ -161,12 +275,21 @@ function FrappeForm(param) {
   var {
     t
   } = useTranslation();
-  var [localDoc, setLocalDoc] = useState({});
-  var [baselineDoc, setBaselineDoc] = useState(void 0);
+  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;
@@ -195,18 +318,63 @@ function FrappeForm(param) {
     isLoading: isMetaLoading,
     error: metaError
   } = useDocTypeMeta(frappeConfig, doctype);
-  var formSchema = useMemo(function () {
+  var sessionRoles = useSessionRoles(!roles && hasRestrictedPermLevel(meta) ? frappeConfig : void 0);
+  var effectiveRoles = roles !== null && roles !== void 0 ? roles : sessionRoles;
+  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 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 mapMetaToFormSchema(meta, sections);
+    return sections ? sectionsToLayoutFields(sections) : meta.fields;
   }, [meta, sections]);
-  var hideFieldSet = useMemo(function () {
-    return new Set(hideFields !== null && hideFields !== void 0 ? hideFields : []);
-  }, [hideFields]);
+  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 readsWithoutMeta = !children && !meta && Boolean(metaError) && Boolean(name);
+  var recordTabs = useMemo(function () {
+    if (!readsWithoutMeta || !baselineDoc) return void 0;
+    var recordFields = fieldsFromDocument(baselineDoc);
+    return [{
+      key: "__details",
+      label: t("Details"),
+      schema: {
+        sections: [{
+          columns: [{
+            fields: recordFields
+          }]
+        }],
+        fields: recordFields
+      }
+    }];
+  }, [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
+    } : void 0,
+    onSyncError: handleDocSyncError
   });
   var {
     data: rawDocData,
@@ -277,8 +445,78 @@ function FrappeForm(param) {
     everLoadedRef.current = false;
     setWasDeleted(false);
     setConflictFields([]);
-    setBaselineDoc(void 0);
+    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]);
+  var readsConnections = Boolean(children) && Boolean(name) && effectiveConnections.length > 0;
+  var [connectionSnapshots, setConnectionSnapshots] = useState({});
+  useEffect(function () {
+    setConnectionSnapshots({});
+  }, [doctype, name]);
+  var connectionReads = useMemo(function () {
+    return readsConnections && name ? effectiveConnections.map(function (link) {
+      var _link_limit;
+      return {
+        link,
+        options: {
+          fields: connectionFields(link),
+          filters: [[link.fieldname, "=", name]],
+          limit: (_link_limit = link.limit) !== null && _link_limit !== void 0 ? _link_limit : 0
+        },
+        onChange: function onChange(snapshot) {
+          return setConnectionSnapshots(function (prev) {
+            return {
+              ...prev,
+              [link.doctype]: snapshot
+            };
+          });
+        }
+      };
+    }) : [];
+  }, [readsConnections, effectiveConnections, name]);
+  var connectionRows = useMemo(function () {
+    var rows = {};
+    var _iteratorNormalCompletion = true,
+      _didIteratorError = false,
+      _iteratorError = void 0;
+    try {
+      for (var _iterator = connectionReads[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+        var {
+          link
+        } = _step.value;
+        var _ref2;
+        var _connectionSnapshots_link_doctype;
+        rows[link.doctype] = (_ref2 = (_connectionSnapshots_link_doctype = connectionSnapshots[link.doctype]) === null || _connectionSnapshots_link_doctype === void 0 ? void 0 : _connectionSnapshots_link_doctype.rows) !== null && _ref2 !== void 0 ? _ref2 : [];
+      }
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator.return != null) {
+          _iterator.return();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+    return rows;
+  }, [connectionReads, connectionSnapshots]);
+  var connectionsLoading = connectionReads.some(function (param2) {
+    var {
+      link
+    } = param2;
+    var _ref2;
+    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;
@@ -371,6 +609,40 @@ function FrappeForm(param) {
     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 {
@@ -385,24 +657,47 @@ function FrappeForm(param) {
       delete newErrors[String(field)];
       return newErrors;
     });
+    runFetchFrom(String(field), value);
   };
   var validateRequiredFields = function validateRequiredFields2() {
-    if (!meta) return {};
+    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 = meta.fields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-        var field = _step.value;
-        if (!field.reqd) continue;
-        if (field.hidden || LAYOUT_FIELDTYPES.has(field.fieldtype)) continue;
-        if (hideFieldSet.has(field.fieldname)) continue;
-        if (isEmptyFieldValue(doc[field.fieldname])) {
-          validationErrors[field.fieldname] = t("{{label}} is required", {
-            label: field.label || field.fieldname
-          });
+      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) {
@@ -464,15 +759,23 @@ function FrappeForm(param) {
         }
         setConflictFields([]);
       } else {
-        var _localDoc_name;
+        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: (_localDoc_name = localDoc.name) !== null && _localDoc_name !== void 0 ? _localDoc_name : `new-${Date.now()}`
+          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) {
@@ -554,17 +857,47 @@ function FrappeForm(param) {
       setIsSubmitting(false);
     }
   };
+  var titleField = meta === null || meta === void 0 ? void 0 : meta.title_field;
+  var titleValue = titleField ? localDoc[titleField] : void 0;
+  var pageTitle = isCreate ? t("New {{doctype}}", {
+    doctype
+  }) : String(titleValue || name);
+  var frame = function frame2(content, aside) {
+    return routePage ?
+    // flexBasis auto: see DeskFormPage (react-native-web's min-height:0
+    // reset would cap the scroll page at viewport height).
+    /* @__PURE__ */
+    _jsx(DetailPageLayout, {
+      flexBasis: "auto",
+      toolbarLeading: /* @__PURE__ */_jsx(Button, {
+        size: "$3",
+        chromeless: true,
+        icon: ArrowLeftIcon,
+        onPress: routePage.onBack,
+        "aria-label": t("Back to {{doctype}} list", {
+          doctype
+        }),
+        children: doctype
+      }),
+      header: /* @__PURE__ */_jsx(PageHeader, {
+        title: pageTitle,
+        divider: false
+      }),
+      aside,
+      children: content
+    }) : content;
+  };
   if (!children && isMetaLoading && !meta) {
-    return /* @__PURE__ */_jsx(YStack, {
+    return frame(/* @__PURE__ */_jsx(YStack, {
       ...knobProps.panelPadding,
       testID: "frappe-form-skeleton",
       children: /* @__PURE__ */_jsx(AsyncSkeleton, {
         layout: "generic"
       })
-    });
+    }));
   }
-  if (!children && metaError && !meta) {
-    return /* @__PURE__ */_jsxs(YStack, {
+  if (!children && metaError && !meta && !name) {
+    return frame(/* @__PURE__ */_jsxs(YStack, {
       ...knobProps.panelPadding,
       alignItems: "center",
       ...knobProps.gap,
@@ -579,19 +912,33 @@ function FrappeForm(param) {
         ...knobProps.body,
         children: metaError.message
       })]
-    });
+    }));
   }
-  if (name && (liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.isLoading) && !wasDeleted) {
-    return /* @__PURE__ */_jsx(YStack, {
+  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 (errorFallback !== void 0) return frame(errorFallback);
+    return frame(/* @__PURE__ */_jsx(AsyncBoundary, {
+      ...knobProps.panelPadding,
+      error: docError,
+      errorTitle: t("Failed to load {{doctype}}", {
+        doctype
+      })
+    }));
+  }
+  if (name && isDocReading && !showsSeed && !wasDeleted) {
+    if (loadingFallback !== void 0) return frame(loadingFallback);
+    return frame(/* @__PURE__ */_jsx(YStack, {
       ...knobProps.panelPadding,
       testID: "frappe-form-skeleton",
       children: /* @__PURE__ */_jsx(AsyncSkeleton, {
         layout: "generic"
       })
-    });
+    }));
   }
-  if (name && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.isLoading) && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data) && !wasDeleted) {
-    return /* @__PURE__ */_jsxs(YStack, {
+  if (name && !isDocReading && !(liveDoc === null || liveDoc === void 0 ? void 0 : liveDoc.data) && !wasDeleted) {
+    if (notFoundFallback !== void 0) return frame(notFoundFallback);
+    return frame(/* @__PURE__ */_jsxs(YStack, {
       ...knobProps.panelPadding,
       alignItems: "center",
       ...knobProps.gap,
@@ -608,9 +955,12 @@ function FrappeForm(param) {
           name
         })
       })]
-    });
+    }));
   }
   var effectiveDisabled = disabled || wasDeleted;
+  var readOnlyView = Boolean(onEdit) || readsWithoutMeta;
+  var fieldsDisabled = effectiveDisabled || readOnlyView;
+  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 conflictLabels = conflictFields.map(function (fieldname) {
@@ -619,131 +969,185 @@ function FrappeForm(param) {
     });
     return (field === null || field === void 0 ? void 0 : field.label) || fieldname;
   }).join(", ");
-  return (
-    // flexBasis auto (not the flex:1 shorthand's 0%): inside scroll-flow page
-    // scaffolds (LC-29 templates) the parent is auto-height, and a 0% basis
-    // collapses this stack to zero height on web — content then paints over
-    // whatever follows. Bounded parents still fill (grow 1) exactly as before.
+  var formTabItems = (shownTabs !== null && shownTabs !== void 0 ? shownTabs : []).map(function (tab) {
+    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
+      })
+    };
+  });
+  var tabItems = showConnections && name && effectiveConnections.length > 0 ? [...formTabItems, {
+    value: "__connections",
+    label: t("Connections"),
+    content: /* @__PURE__ */_jsx(FrappeFormConnections, {
+      connection: frappeConfig,
+      connections: effectiveConnections,
+      name
+    })
+  }] : formTabItems;
+  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),
+    metadata: mapDocToSidebarMetadata(localDoc, t)
+  }) : void 0;
+  return frame(
+  // flexBasis auto (not the flex:1 shorthand's 0%): inside scroll-flow page
+  // scaffolds (LC-29 templates) the parent is auto-height, and a 0% basis
+  // collapses this stack to zero height on web — content then paints over
+  // whatever follows. Bounded parents still fill (grow 1) exactly as before.
+  /* @__PURE__ */
+  _jsxs(YStack, {
+    ...knobProps.gapLg,
+    flexGrow: 1,
+    flexShrink: 1,
+    flexBasis: "auto",
+    children: [/* @__PURE__ */_jsx(FrappeReconnectIndicator, {
+      config: 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, {
+      role: "alert",
+      alignItems: "center",
+      ...knobProps.containerRadius,
+      ...knobProps.panelPadding,
+      backgroundColor: "$red3",
+      testID: "frappe-form-deleted-banner",
+      children: /* @__PURE__ */_jsx(Text, {
+        color: formCommonColors.error,
+        ...knobProps.body,
+        children: hasUnsavedChanges ? t("This {{doctype}} was deleted on the server. Fields are read-only and your unsaved edits can no longer be saved.", {
+          doctype
+        }) : t("This {{doctype}} was deleted on the server. Fields are read-only.", {
+          doctype
+        })
+      })
+    }), !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */_jsx(XStack, {
+      role: "status",
+      alignItems: "center",
+      ...knobProps.containerRadius,
+      ...knobProps.panelPadding,
+      backgroundColor: "$orange3",
+      testID: "frappe-form-conflict-banner",
+      children: /* @__PURE__ */_jsx(Text, {
+        color: "$orange11",
+        ...knobProps.body,
+        children: t("Changed elsewhere while you were editing: {{fields}}. Your edits are kept \u2014 saving will overwrite the newer server values.", {
+          fields: conflictLabels
+        })
+      })
+    }),
+    /* flexBasis auto — see the root stack note (zero-height collapse in
+    auto-height scroll flows would paint the Timeline over the form). */
     /* @__PURE__ */
-    _jsxs(YStack, {
-      ...knobProps.gapLg,
+    _jsxs(XStack, {
       flexGrow: 1,
       flexShrink: 1,
       flexBasis: "auto",
-      children: [/* @__PURE__ */_jsx(FrappeReconnectIndicator, {
-        config: frappeConfig
-      }), wasDeleted && /* @__PURE__ */_jsx(XStack, {
-        role: "alert",
-        alignItems: "center",
-        ...knobProps.containerRadius,
-        ...knobProps.panelPadding,
-        backgroundColor: "$red3",
-        testID: "frappe-form-deleted-banner",
-        children: /* @__PURE__ */_jsx(Text, {
-          color: formCommonColors.error,
-          ...knobProps.body,
-          children: hasUnsavedChanges ? t("This {{doctype}} was deleted on the server. Fields are read-only and your unsaved edits can no longer be saved.", {
-            doctype
-          }) : t("This {{doctype}} was deleted on the server. Fields are read-only.", {
-            doctype
-          })
-        })
-      }), !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */_jsx(XStack, {
-        role: "status",
-        alignItems: "center",
-        ...knobProps.containerRadius,
-        ...knobProps.panelPadding,
-        backgroundColor: "$orange3",
-        testID: "frappe-form-conflict-banner",
-        children: /* @__PURE__ */_jsx(Text, {
-          color: "$orange11",
-          ...knobProps.body,
-          children: t("Changed elsewhere while you were editing: {{fields}}. Your edits are kept \u2014 saving will overwrite the newer server values.", {
-            fields: conflictLabels
-          })
-        })
-      }),
-      /* flexBasis auto — see the root stack note (zero-height collapse in
-      auto-height scroll flows would paint the Timeline over the form). */
-      /* @__PURE__ */
-      _jsxs(XStack, {
-        flexGrow: 1,
-        flexShrink: 1,
-        flexBasis: "auto",
+      ...knobProps.gapLg,
+      children: [
+      /* Sidebar (edit mode only) — assignments/shares/image are live.
+      A routed page carries it in the template's aside instead. */
+      routePage ? null : sidebar, /* Form body */
+      /* @__PURE__ */_jsxs(YStack, {
+        flex: 1,
         ...knobProps.gapLg,
-        children: [/* Sidebar (edit mode only) — assignments/shares/image are live */
-        showSidebar && name && meta && /* @__PURE__ */_jsx(FormSidebar, {
-          imageUrl: sidebarImageUrl,
-          sections: buildSidebarSections(localDoc, shareRows, t, assignmentRows),
-          metadata: mapDocToSidebarMetadata(localDoc, t)
-        }), /* Form body */
-        /* @__PURE__ */_jsxs(YStack, {
-          flex: 1,
+        children: [children ?
+        // Render-prop mode
+        children({
+          doc: localDoc,
+          setValue,
+          isSubmitting,
+          errors,
+          meta,
+          disabled: fieldsDisabled,
+          connections: connectionRows,
+          connectionsLoading
+        }) : shownTabs ? /* @__PURE__ */_jsxs(YStack, {
           ...knobProps.gapLg,
-          children: [children ?
-          // Render-prop mode
-          children({
-            doc: localDoc,
-            setValue,
-            isSubmitting,
-            errors,
-            meta,
-            disabled: effectiveDisabled
-          }) : formSchema ?
-          // Schema-driven mode using generic SchemaForm from @multiplatform.one/forms
-          /* @__PURE__ */
-          _jsx(SchemaForm, {
-            schema: formSchema,
-            doc: localDoc,
-            setValue: function setValue1(field, value) {
-              return setValue(field, value);
+          children: [promptNamed && /* @__PURE__ */_jsx(Input, {
+            label: t("Name"),
+            value: typeof localName === "string" ? localName : "",
+            onChangeText: function onChangeText(value) {
+              return setValue("name", value);
             },
-            errors,
-            disabled: effectiveDisabled,
-            overrides,
-            hideFields,
-            readOnlyFields,
-            sectionHeadingLevel,
-            order
-          }) :
-          // Metadata unavailable (should be covered by metaError branch above)
-          /* @__PURE__ */
-          _jsx(YStack, {
-            ...knobProps.panelPadding,
-            alignItems: "center",
-            children: /* @__PURE__ */_jsx(Text, {
-              color: formCommonColors.muted,
-              ...knobProps.body,
-              children: t("Form schema unavailable")
-            })
-          }), errors.general && /* @__PURE__ */_jsx(Text, {
-            color: formCommonColors.error,
+            placeholder: t("New document name"),
+            error: errors.name,
+            disabled: effectiveDisabled
+          }), tabItems.length > 1 ? /* @__PURE__ */_jsx(Tabs, {
+            items: tabItems,
+            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]
+        }) :
+        // Metadata unavailable (should be covered by metaError branch above)
+        /* @__PURE__ */
+        _jsx(YStack, {
+          ...knobProps.panelPadding,
+          alignItems: "center",
+          children: /* @__PURE__ */_jsx(Text, {
+            color: formCommonColors.muted,
             ...knobProps.body,
-            children: errors.general
-          }), showToolbar && /* @__PURE__ */_jsxs(XStack, {
-            ...knobProps.gap,
-            justifyContent: "flex-end",
-            alignItems: "center",
-            paddingTop: "$3",
-            children: [hasUnsavedChanges && /* @__PURE__ */_jsx(Text, {
-              color: "$orange11",
-              marginInlineEnd: "auto",
-              ...knobProps.body,
-              children: t("Not Saved")
-            }), name && onDelete && !wasDeleted && /* @__PURE__ */_jsx(Button, {
-              outlined: true,
-              error: true,
-              icon: TrashIcon,
-              loading: isSubmitting,
-              disabled: effectiveDisabled,
-              disabledReason: t("Form is read-only"),
-              disabledReasonPlacement: "inline",
-              onPress: handleDelete,
-              children: t("Delete")
-            }), onCancel && /* @__PURE__ */_jsx(Button, {
+            children: t("Form schema unavailable")
+          })
+        }), errors.general && /* @__PURE__ */_jsx(Text, {
+          color: formCommonColors.error,
+          ...knobProps.body,
+          children: errors.general
+        }), showToolbar && !readsWithoutMeta && /* @__PURE__ */_jsxs(XStack, {
+          ...knobProps.gap,
+          justifyContent: "flex-end",
+          alignItems: "center",
+          paddingTop: "$3",
+          children: [hasUnsavedChanges && !onEdit && /* @__PURE__ */_jsx(Text, {
+            color: "$orange11",
+            marginInlineEnd: "auto",
+            ...knobProps.body,
+            children: t("Not Saved")
+          }), name && onDelete && !wasDeleted && /* @__PURE__ */_jsx(Button, {
+            outlined: true,
+            error: true,
+            icon: TrashIcon,
+            loading: isSubmitting,
+            disabled: effectiveDisabled,
+            disabledReason: t("Form is read-only"),
+            disabledReasonPlacement: "inline",
+            onPress: handleDelete,
+            children: t("Delete")
+          }), onEdit ? /* @__PURE__ */_jsx(Button, {
+            accent: true,
+            icon: PencilSimpleIcon,
+            disabled: effectiveDisabled,
+            disabledReason: t("Form is read-only"),
+            disabledReasonPlacement: "inline",
+            onPress: onEdit,
+            children: t("Edit")
+          }) : /* @__PURE__ */_jsxs(_Fragment, {
+            children: [onCancel && /* @__PURE__ */_jsx(Button, {
               outlined: true,
               icon: XIcon,
-              disabled: isSubmitting || disabled,
+              disabled,
               disabledReason: t("Form is read-only"),
               disabledReasonPlacement: "inline",
               onPress: handleCancel,
@@ -760,14 +1164,14 @@ function FrappeForm(param) {
             })]
           })]
         })]
-      }), /* Timeline (edit mode only) — live Comment/Version via useFrappeCollection */
-      showTimeline && name && /* @__PURE__ */_jsx(Timeline, {
-        doctype,
-        docname: name,
-        label: t("Activity")
       })]
-    })
-  );
+    }), /* Timeline (edit mode only) — live Comment/Version via useFrappeCollection */
+    showTimeline && name && !readsWithoutMeta && /* @__PURE__ */_jsx(Timeline, {
+      doctype,
+      docname: name,
+      label: t("Activity")
+    })]
+  }), routePage ? sidebar : void 0);
 }
 export { FrappeForm, buildSidebarSections, mapDocToSidebarMetadata, resolveFileUrl };
 //# sourceMappingURL=FrappeForm.native.js.map