@multiplatform.one/frappe-ui 7.28.1 → 7.29.0

package/dist/jsx/FrappeForm.mjs

@@ -1,10 +1,9 @@
-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.mjs";
 import { FormSidebar } from "./FormSidebar.mjs";
-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";
@@ -13,56 +12,23 @@ import { useFrappeConfig } from "./FrappeProvider.mjs";
 import { FrappeReconnectIndicator } from "./FrappeReconnectIndicator.mjs";
 import { Timeline } from "./components/timeline.mjs";
 import { dialog } from "@multiplatform.one/desktop";
-import { applyFetchedValues, buildFetchMap } from "./formEngine/fetchFrom.mjs";
-import { buildPermLevelMatrix } from "./formEngine/fieldPermissions.mjs";
-import { createHttpClient, validateLink } from "./formEngine/formActions.mjs";
-import { buildFormTabs, isPromptNamed } from "./formEngine/formLayout.mjs";
-import { setCreatePrefill, takeCreatePrefill } from "./formEngine/createPrefill.mjs";
-import { buildAmendValues, canDeleteDoc, canEditDoc, isAmendable, resolveDocAction, resolveDocIndicator } from "./formEngine/docLifecycle.mjs";
-import { useAmendedAs } from "./formEngine/useAmendedAs.mjs";
-import { useDocRights } from "./formEngine/useDocRights.mjs";
-import { extractServerError } from "./formEngine/useFormEngine.mjs";
+import { canDeleteDoc, canEditDoc, isAmendable, resolveDocAction, resolveDocIndicator } from "./formEngine/docLifecycle.mjs";
 import { FrappeFormActions } from "./FrappeFormActions.mjs";
 import { connectionFields, connectionsFromMeta } from "./frappeConnections.mjs";
 import { FrappeFormConnections } from "./FrappeFormConnections.mjs";
 import { FrappeNotConfigured } from "./FrappeNotConfigured.mjs";
 import { FrappeRowsReader } from "./FrappeRowsReader.mjs";
+import { isPermissionError } from "./liveErrors.mjs";
+import { fieldsFromRecord } from "./recordShape.mjs";
 import { frappeRouteHref, frappeRouteTarget, useFrappeRouter } from "./frappeNavigation.mjs";
+import { useFrappeForm } from "./useFrappeForm.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { createElement } from "react";
-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) {
-  const fields = [];
-  sections.forEach((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((column, columnIndex) => {
-      if (columnIndex > 0) {
-        fields.push({
-          fieldname: `__column_${sectionIndex}_${columnIndex}`,
-          fieldtype: "Column Break"
-        });
-      }
-      fields.push(...column.fields);
-    });
-  });
-  return fields;
-}
-const 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(([key, value]) => !key.startsWith("$") && !documentBookkeeping.has(key) && (value === null || typeof value === "string" || typeof value === "number")).map(([key, value]) => ({
-    name: key,
-    label: key.replace(/_/g, " ").replace(/(^|\s)\S/g, c => c.toUpperCase()),
-    type: typeof value === "number" ? Number.isInteger(value) ? "Int" : "Float" : "Data",
+function schemaFieldsFromRecord(doc) {
+  return fieldsFromRecord(doc).map(field => ({
+    name: field.fieldname,
+    label: field.label,
+    type: field.fieldtype,
     readOnly: true
   }));
 }
@@ -206,20 +172,48 @@ function FrappeFormRoute({
     }))
   });
 }
-function FrappeFormBody({
-  baseURL,
-  auth,
-  syncOptions,
+function FrappeFormBody(props) {
+  if (props.form) return /* @__PURE__ */jsx(FrappeFormView, {
+    ...props,
+    form: props.form
+  });
+  return /* @__PURE__ */jsx(FrappeFormOwned, {
+    ...props
+  });
+}
+function FrappeFormOwned(props) {
+  const config = useFrappeConfig();
+  if (!(props.baseURL ?? config?.baseURL)) {
+    throw new Error("FrappeForm requires baseURL prop or FrappeProvider with baseURL");
+  }
+  const 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 ?? true,
+    disabled: props.disabled,
+    initialDoc: props.initialDoc
+  });
+  return /* @__PURE__ */jsx(FrappeFormView, {
+    ...props,
+    form
+  });
+}
+function FrappeFormView({
+  form,
   doctype,
   name,
-  fields,
   children,
   overrides,
-  hideFields,
   readOnlyFields,
-  sections,
   order,
-  roles,
   onSave,
   onCancel,
   onDelete,
@@ -228,73 +222,55 @@ function FrappeFormBody({
   showToolbar = true,
   showSidebar = true,
   showTimeline = true,
+  showBanners = true,
   disabled = false,
   sectionHeadingLevel,
   connections,
   showConnections = true,
-  initialDoc,
+  extraTabs,
+  renderFieldWrapper,
+  renderTab,
   loadingFallback,
   notFoundFallback,
   errorFallback,
   routePage
 }) {
-  const config = useFrappeConfig();
   const {
     knobProps
   } = useResolvedKnobs();
   const {
     t
   } = useTranslation();
-  const seedDoc = name && initialDoc && initialDoc.name === name ? initialDoc : void 0;
-  const seedRef = useRef(seedDoc);
-  seedRef.current = seedDoc;
-  const [localDoc, setLocalDoc] = useState(() => seedDoc ?? {});
-  const [baselineDoc, setBaselineDoc] = useState(() => seedDoc);
-  const [docError, setDocError] = useState(null);
-  const [conflictFields, setConflictFields] = useState([]);
-  const [wasDeleted, setWasDeleted] = useState(false);
-  const [isSubmitting, setIsSubmitting] = useState(false);
-  const [errors, setErrors] = useState({});
-  const [activeTab, setActiveTab] = useState(void 0);
-  const everLoadedRef = useRef(false);
-  const localDocRef = useRef(localDoc);
-  localDocRef.current = localDoc;
-  const baselineRef = useRef(baselineDoc);
-  baselineRef.current = baselineDoc;
-  const createDraftRef = useRef(void 0);
-  const finalBaseURL = baseURL ?? config?.baseURL;
-  const finalAuth = auth ?? config?.auth;
-  const finalSyncOptions = syncOptions ?? config?.syncOptions;
-  if (!finalBaseURL) {
-    throw new Error("FrappeForm requires baseURL prop or FrappeProvider with baseURL");
-  }
-  const frappeConfig = useMemo(() => ({
-    baseURL: finalBaseURL,
-    socketPort: config?.socketPort,
-    siteName: config?.siteName,
-    socketBaseURL: config?.socketBaseURL,
-    auth: finalAuth,
-    syncOptions: finalSyncOptions,
-    realtime: config?.realtime,
-    fixtures: config?.fixtures
-  }), [finalBaseURL, config?.socketPort, config?.siteName, config?.socketBaseURL, config?.realtime, finalAuth, finalSyncOptions, config?.fixtures]);
   const {
     meta,
-    isLoading: isMetaLoading,
-    error: metaError
-  } = useDocTypeMeta(frappeConfig, doctype);
-  const isSubmittable = !!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;
+  const frappeConfig = form.connection;
   const isCreate = !name;
-  const docstatus = Number(baselineDoc?.docstatus ?? 0);
-  const layoutFields = useMemo(() => {
-    if (!meta) return void 0;
-    return sections ? sectionsToLayoutFields(sections) : meta.fields;
-  }, [meta, sections]);
-  const amendedAs = useAmendedAs(isSubmittable && docstatus === 2 ? frappeConfig : void 0, doctype, name);
+  const hasUnsavedChanges = form.isDirty;
   const readsWithoutMeta = !children && !meta && Boolean(metaError) && Boolean(name);
   const recordTabs = useMemo(() => {
     if (!readsWithoutMeta || !baselineDoc) return void 0;
-    const recordFields = fieldsFromDocument(baselineDoc);
+    const recordFields = schemaFieldsFromRecord(baselineDoc);
     return [{
       key: "__details",
       label: t("Details"),
@@ -308,87 +284,7 @@ function FrappeFormBody({
       }
     }];
   }, [readsWithoutMeta, baselineDoc, t]);
-  const promptNamed = isCreate && !!meta && isPromptNamed(meta.autoname, meta.naming_rule);
-  const fetchMap = useMemo(() => meta ? buildFetchMap(meta.fields) : void 0, [meta]);
-  const handleDocSyncError = useCallback(err => {
-    setDocError(err instanceof Error ? err : new Error(String(err)));
-  }, []);
-  const docCollection = useFrappeCollection(name ? frappeConfig : void 0, doctype, {
-    fields,
-    filters: name ? {
-      name
-    } : void 0,
-    onSyncError: handleDocSyncError
-  });
-  const {
-    data: rawDocData,
-    isLoading: isDocLoading
-  } = useLiveQuery(q => {
-    if (!docCollection || !name) return null;
-    return q.from({
-      _doc: docCollection
-    }).where(({
-      _doc
-    }) => {
-      if (!_doc) return eq(name, name);
-      return eq(_doc.name, name);
-    });
-  }, [docCollection, name]);
-  const liveDoc = useMemo(() => {
-    const arr = Array.isArray(rawDocData) ? rawDocData : rawDocData ? [rawDocData] : [];
-    const doc = arr[0] ?? null;
-    return doc ? {
-      data: doc,
-      isLoading: isDocLoading
-    } : name ? {
-      data: null,
-      isLoading: isDocLoading
-    } : null;
-  }, [rawDocData, isDocLoading, name]);
-  const collection = useFrappeCollection(name ? void 0 : frappeConfig, doctype, {
-    fields
-  });
-  const shareCollection = useFrappeCollection(showSidebar && name ? frappeConfig : void 0, "DocShare", {
-    fields: ["name", "user", "everyone", "read", "write", "share"],
-    filters: {
-      share_doctype: doctype,
-      share_name: name
-    }
-  });
-  const {
-    data: rawShareRows
-  } = useLiveQuery(q => shareCollection ? q.from({
-    _share: shareCollection
-  }) : null, [shareCollection]);
-  const shareRows = useMemo(() => shareCollection ? rawShareRows ?? [] : void 0, [shareCollection, rawShareRows]);
-  const owner = baselineDoc?.owner;
-  const {
-    rights,
-    pending: rightsPending,
-    roles: effectiveRoles
-  } = useDocRights(frappeConfig, meta, {
-    roles,
-    owner: typeof owner === "string" ? owner : void 0,
-    shares: shareRows
-  });
-  const permLevels = useMemo(() => buildPermLevelMatrix(meta?.permissions, effectiveRoles), [meta?.permissions, effectiveRoles]);
-  const formTabs = useMemo(() => {
-    if (!layoutFields) return void 0;
-    return buildFormTabs({
-      fields: layoutFields,
-      doc: {
-        ...localDoc,
-        __islocal: isCreate ? 1 : 0
-      },
-      docstatus,
-      formReadOnly: !!meta?.read_only,
-      isCreate,
-      detailsLabel: t("Details"),
-      permLevels,
-      hiddenFields: hideFields
-    });
-  }, [layoutFields, localDoc, docstatus, meta?.read_only, isCreate, permLevels, hideFields, t]);
-  const assignmentCollection = useFrappeCollection(showSidebar && name && !frappeConfig.fixtures ? frappeConfig : void 0, "ToDo", {
+  const assignmentCollection = useFrappeCollection(showSidebar && name && frappeConfig && !frappeConfig.fixtures ? frappeConfig : void 0, "ToDo", {
     fields: ["name", "allocated_to", "status", "reference_type", "reference_name"],
     filters: {
       reference_type: doctype,
@@ -402,16 +298,6 @@ function FrappeFormBody({
     _assignment: assignmentCollection
   }) : null, [assignmentCollection]);
   const assignmentRows = useMemo(() => assignmentCollection ? rawAssignmentRows ?? [] : void 0, [assignmentCollection, rawAssignmentRows]);
-  useEffect(() => {
-    everLoadedRef.current = false;
-    if (name) createDraftRef.current = void 0;
-    setWasDeleted(false);
-    setConflictFields([]);
-    setDocError(null);
-    const seed = seedRef.current;
-    setBaselineDoc(seed);
-    if (seed) setLocalDoc(seed);
-  }, [doctype, name]);
   const effectiveConnections = useMemo(() => connections ?? connectionsFromMeta(meta), [connections, meta]);
   const readsConnections = Boolean(children) && Boolean(name) && effectiveConnections.length > 0;
   const [connectionSnapshots, setConnectionSnapshots] = useState({});
@@ -442,262 +328,48 @@ function FrappeFormBody({
   const connectionsLoading = connectionReads.some(({
     link
   }) => connectionSnapshots[link.doctype]?.isLoading ?? true);
-  useFrappeDoctypeEvents(name ? frappeConfig : void 0, doctype, event => {
-    if (event.type !== "doc_deleted") return;
-    const payload = event.payload;
-    if (payload?.name === name) setWasDeleted(true);
-  }, Boolean(name));
-  useEffect(() => {
-    const incoming = liveDoc?.data;
-    if (incoming) {
-      everLoadedRef.current = true;
-      setWasDeleted(false);
-      const baseline = baselineRef.current;
-      if (!baseline) {
-        setBaselineDoc(incoming);
-        setLocalDoc(incoming);
-        return;
-      }
-      const local = localDocRef.current;
-      const merged = {
-        ...incoming
-      };
-      const newConflicts = [];
-      for (const key of Object.keys(local)) {
-        const localValue = local[key];
-        if (localValue === baseline[key]) continue;
-        merged[key] = localValue;
-        const remote = incoming[key];
-        if (remote !== baseline[key] && remote !== localValue) newConflicts.push(key);
-      }
-      setBaselineDoc(incoming);
-      setLocalDoc(merged);
-      if (newConflicts.length > 0) {
-        setConflictFields(prev => Array.from(/* @__PURE__ */new Set([...prev, ...newConflicts])));
-      }
-    } else if (name && everLoadedRef.current && !liveDoc?.isLoading) {
-      setWasDeleted(true);
-    } else if (!name) {
-      if (createDraftRef.current?.doctype !== doctype) {
-        createDraftRef.current = {
-          doctype,
-          values: takeCreatePrefill(doctype)
-        };
-      }
-      setLocalDoc({
-        ...createDraftRef.current.values,
-        doctype
-      });
-    }
-  }, [liveDoc?.data, liveDoc?.isLoading, doctype, name]);
-  const dirtyFieldNames = useMemo(() => {
-    const local = localDoc;
-    const base = baselineDoc;
-    const dirty = [];
-    for (const key of Object.keys(local)) {
-      if (key === "doctype" || key === "name") continue;
-      if (base ? local[key] !== base[key] : local[key] !== void 0) dirty.push(key);
-    }
-    return dirty;
-  }, [localDoc, baselineDoc]);
-  const hasUnsavedChanges = dirtyFieldNames.length > 0;
-  const runFetchFrom = (field, value) => {
-    const rules = fetchMap?.get(field);
-    if (!rules || rules.length === 0) return;
-    const applyPatch = fetched2 => {
-      setLocalDoc(prev => {
-        const current = prev;
-        if (current[field] !== value) return prev;
-        const patch = applyFetchedValues(rules, fetched2, current);
-        return Object.keys(patch).length > 0 ? {
-          ...current,
-          ...patch
-        } : prev;
-      });
-    };
-    if (isEmptyFieldValue(value)) {
-      applyPatch({});
-      return;
-    }
-    const linkField = meta?.fields.find(metaField => metaField.fieldname === field);
-    const targetDoctype = typeof linkField?.options === "string" ? linkField.options : "";
-    if (!targetDoctype) return;
-    const sources = Array.from(new Set(rules.map(rule => rule.source)));
-    const fixtures = frappeConfig.fixtures;
-    const fetched = fixtures ? fixtures.getDoc(targetDoctype, String(value), sources).then(doc => doc ?? {}) : validateLink(createHttpClient(frappeConfig), targetDoctype, String(value), sources);
-    fetched.then(applyPatch).catch(() => void 0);
-  };
-  const setValue = (field, value) => {
-    setLocalDoc(prev => ({
-      ...prev,
-      [field]: value
-    }));
-    setErrors(prev => {
-      const newErrors = {
-        ...prev
-      };
-      delete newErrors[String(field)];
-      return newErrors;
-    });
-    runFetchFrom(String(field), value);
-  };
-  const validateRequiredFields = () => {
-    if (!formTabs) return {};
-    const validationErrors = {};
-    const doc = localDoc;
-    if (promptNamed && isEmptyFieldValue(doc.name)) {
-      validationErrors.name = t("Name is required");
-    }
-    for (const tab of formTabs) {
-      for (const field of tab.schema.fields) {
-        if (!field.required) continue;
-        if (isEmptyFieldValue(doc[field.name])) {
-          validationErrors[field.name] = t("{{label}} is required", {
-            label: field.label || field.name
-          });
-        }
-      }
-    }
-    return validationErrors;
-  };
-  const canWriteRecord = isCreate ? rights.create : rights.write;
   const handleSave = async () => {
-    if (wasDeleted || !canWriteRecord) return;
-    const requiredErrors = validateRequiredFields();
-    if (Object.keys(requiredErrors).length > 0) {
-      setErrors(requiredErrors);
-      return;
-    }
-    setIsSubmitting(true);
-    setErrors({});
-    try {
-      if (name) {
-        if (!docCollection) return;
-        const changedFields = dirtyFieldNames;
-        if (changedFields.length > 0) {
-          const local = localDoc;
-          const tx = docCollection.update(name, draft => {
-            for (const key of changedFields) {
-              draft[key] = local[key];
-            }
-          });
-          await tx.isPersisted.promise;
-        }
-        setConflictFields([]);
-      } else {
-        if (!collection) return;
-        const temporaryName = localDoc.name ?? `new-${Date.now()}`;
-        const docToInsert = {
-          ...localDoc,
-          doctype,
-          name: temporaryName
-        };
-        const tx = collection.insert(docToInsert);
-        await tx.isPersisted.promise;
-        const createdName = getFrappeSyncModule(frappeConfig)?.createdName(temporaryName) ?? temporaryName;
-        onSave?.({
-          ...localDoc,
-          name: createdName
-        });
-        return;
-      }
-      onSave?.(localDoc);
-    } catch (err) {
-      const e = err;
-      if (e?.exc_type === "ValidationError") {
-        const validationErrors = {};
-        if (e._server_messages) {
-          try {
-            const messages = JSON.parse(e._server_messages);
-            for (const msg of messages) {
-              const parsed = typeof msg === "string" ? JSON.parse(msg) : msg;
-              if (parsed.message) {
-                validationErrors.general = parsed.message;
-              }
-            }
-          } catch {
-            validationErrors.general = t("Validation error occurred");
-          }
-        }
-        setErrors(validationErrors);
-      } else {
-        setErrors({
-          general: e?.message || t("Failed to save document")
-        });
-      }
-    } finally {
-      setIsSubmitting(false);
-    }
+    const saved = await form.save();
+    if (!saved) return;
+    onSave?.(isCreate ? {
+      ...localDoc,
+      name: saved
+    } : localDoc);
   };
   const handleCancel = () => {
-    if (baselineDoc) {
-      setLocalDoc(baselineDoc);
-    } else if (liveDoc?.data) {
-      setLocalDoc(liveDoc.data);
-    } else {
-      setLocalDoc({
-        doctype
-      });
-    }
-    setConflictFields([]);
-    setErrors({});
+    form.reset();
     onCancel?.();
   };
   const handleDelete = async () => {
-    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 {
-      const tx = docCollection.delete(name);
-      await tx.isPersisted.promise;
-      onDelete?.(localDoc);
-    } catch (err) {
-      setErrors({
-        general: err?.message || t("Failed to delete")
-      });
-    } finally {
-      setIsSubmitting(false);
-    }
+    if (await form.remove()) onDelete?.(localDoc);
   };
-  const transitionDocstatus = async (to, question, failure) => {
-    if (!docCollection || !name || wasDeleted || !rights[to === 1 ? "submit" : "cancel"]) return;
-    if (to === 1) {
-      const requiredErrors = validateRequiredFields();
-      if (Object.keys(requiredErrors).length > 0) {
-        setErrors(requiredErrors);
-        return;
-      }
-    }
-    if (!(await dialog.confirm(question))) return;
-    setIsSubmitting(true);
-    setErrors({});
-    try {
-      const tx = docCollection.update(name, draft => {
-        draft.docstatus = to;
-      });
-      await tx.isPersisted.promise;
-    } catch (err) {
-      setErrors({
-        general: extractServerError(err, failure)
-      });
-    } finally {
-      setIsSubmitting(false);
+  const handleSubmitDocument = async () => {
+    if (!name || wasDeleted || !rights.submit) return;
+    const requiredErrors = form.validate();
+    if (Object.keys(requiredErrors).length > 0) {
+      form.setErrors(requiredErrors);
+      return;
     }
+    if (!(await dialog.confirm(t("Permanently Submit {{name}}?", {
+      name
+    })))) return;
+    await form.submitDocument();
+  };
+  const handleCancelDocument = async () => {
+    if (!name || wasDeleted || !rights.cancel) return;
+    if (!(await dialog.confirm(t("Permanently Cancel {{name}}?", {
+      name
+    })))) return;
+    await form.cancelDocument();
   };
-  const handleSubmitDocument = () => transitionDocstatus(1, t("Permanently Submit {{name}}?", {
-    name
-  }), t("Failed to submit"));
-  const handleCancelDocument = () => transitionDocstatus(2, t("Permanently Cancel {{name}}?", {
-    name
-  }), t("Failed to cancel"));
   const handleAmend = () => {
-    if (!meta || !name || !onAmend || !rights.amend) return;
-    const draft = buildAmendValues(meta.fields, localDoc, name);
-    setCreatePrefill(doctype, draft);
-    onAmend(draft);
+    if (!onAmend) return;
+    const draft = form.amend();
+    if (draft) onAmend(draft);
   };
   const titleField = meta?.title_field;
   const titleValue = titleField ? localDoc[titleField] : void 0;
@@ -757,27 +429,34 @@ function FrappeFormBody({
     }));
   }
   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
+      })
     }));
   }
-  const isDocReading = Boolean(name) && (!docCollection || Boolean(liveDoc?.isLoading));
-  const showsSeed = Boolean(seedDoc) && isDocReading;
-  if (name && docError && !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,
@@ -786,7 +465,7 @@ function FrappeFormBody({
       })
     }));
   }
-  if (name && isDocReading && !showsSeed && !wasDeleted) {
+  if (name && form.status === "loading") {
     if (loadingFallback !== void 0) return frame(loadingFallback);
     return frame(/* @__PURE__ */jsx(YStack, {
       ...knobProps.panelPadding,
@@ -796,7 +475,7 @@ function FrappeFormBody({
       })
     }));
   }
-  if (name && !isDocReading && !liveDoc?.data && !wasDeleted) {
+  if (name && form.status === "notFound") {
     if (notFoundFallback !== void 0) return frame(notFoundFallback);
     return frame(/* @__PURE__ */jsxs(YStack, {
       ...knobProps.panelPadding,
@@ -846,15 +525,13 @@ function FrappeFormBody({
   const toolbarShown = showToolbar && !readsWithoutMeta && Boolean(indicator || docAction || showDelete || showEdit || showClose);
   const shownTabs = formTabs ?? recordTabs;
   const imageFieldName = meta?.image_field;
-  const sidebarImageUrl = imageFieldName ? resolveFileUrl(localDoc[imageFieldName], finalBaseURL) : void 0;
+  const sidebarImageUrl = imageFieldName ? resolveFileUrl(localDoc[imageFieldName], frappeConfig?.baseURL) : void 0;
   const conflictLabels = conflictFields.map(fieldname => {
     const field = meta?.fields.find(metaField => metaField.fieldname === fieldname);
     return field?.label || fieldname;
   }).join(", ");
-  const formTabItems = (shownTabs ?? []).map(tab => ({
-    value: tab.key,
-    label: tab.label,
-    content: /* @__PURE__ */jsx(SchemaForm, {
+  const formTabItems = (shownTabs ?? []).map(tab => {
+    const content = /* @__PURE__ */jsx(SchemaForm, {
       schema: tab.schema,
       doc: localDoc,
       setValue: (field, value) => setValue(field, value),
@@ -863,10 +540,16 @@ function FrappeFormBody({
       overrides,
       readOnlyFields,
       sectionHeadingLevel,
-      order
-    })
-  }));
-  const tabItems = showConnections && name && effectiveConnections.length > 0 ? [...formTabItems, {
+      order,
+      renderFieldWrapper
+    });
+    return {
+      value: tab.key,
+      label: tab.label,
+      content: renderTab ? renderTab(tab, content) : content
+    };
+  });
+  const tabItems = [...formTabItems, ...(showConnections && name && frappeConfig && effectiveConnections.length > 0 ? [{
     value: "__connections",
     label: t("Connections"),
     content: /* @__PURE__ */jsx(FrappeFormConnections, {
@@ -874,12 +557,12 @@ function FrappeFormBody({
       connections: effectiveConnections,
       name
     })
-  }] : formTabItems;
+  }] : []), ...(extraTabs ?? [])];
   const effectiveTab = activeTab && tabItems.some(tab => tab.value === activeTab) ? activeTab : tabItems[0]?.value;
   const localName = localDoc.name;
   const 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(
@@ -893,14 +576,14 @@ function FrappeFormBody({
     flexGrow: 1,
     flexShrink: 1,
     flexBasis: "auto",
-    children: [/* @__PURE__ */jsx(FrappeReconnectIndicator, {
+    children: [frappeConfig ? /* @__PURE__ */jsx(FrappeReconnectIndicator, {
       config: frappeConfig
-    }), connectionReads.map(read => /* @__PURE__ */jsx(FrappeRowsReader, {
+    }) : null, frappeConfig ? connectionReads.map(read => /* @__PURE__ */jsx(FrappeRowsReader, {
       connection: frappeConfig,
       doctype: read.link.doctype,
       options: read.options,
       onChange: read.onChange
-    }, read.link.doctype)), wasDeleted && /* @__PURE__ */jsx(XStack, {
+    }, read.link.doctype)) : null, showBanners && wasDeleted && /* @__PURE__ */jsx(XStack, {
       role: "alert",
       alignItems: "center",
       ...knobProps.containerRadius,
@@ -916,7 +599,7 @@ function FrappeFormBody({
           doctype
         })
       })
-    }), !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */jsx(XStack, {
+    }), showBanners && !wasDeleted && conflictFields.length > 0 && /* @__PURE__ */jsx(XStack, {
       role: "status",
       alignItems: "center",
       ...knobProps.containerRadius,
@@ -978,6 +661,7 @@ function FrappeFormBody({
         }), errors.general && /* @__PURE__ */jsx(Text, {
           color: formCommonColors.error,
           ...knobProps.body,
+          role: "alert",
           children: errors.general
         }), toolbarShown && /* @__PURE__ */jsx(FrappeFormActions, {
           indicator,