@multiplatform.one/frappe-ui 7.78.0 → 7.80.0

package/dist/jsx/list/defaultProjection.native.js

@@ -0,0 +1,107 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var defaultProjection_exports = {};
+__export(defaultProjection_exports, {
+  defaultProjection: () => defaultProjection,
+  defaultProjectionCap: () => defaultProjectionCap,
+  scopePinnedFields: () => scopePinnedFields
+});
+module.exports = __toCommonJS(defaultProjection_exports);
+function _type_of(obj) {
+  "@swc/helpers - typeof";
+
+  return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+var defaultProjectionCap = 5;
+function isScalar(value) {
+  return value === null || ["string", "number", "boolean"].includes(typeof value === "undefined" ? "undefined" : _type_of(value));
+}
+function scopePinnedFields(filters, doctype) {
+  var pinned = /* @__PURE__ */new Set();
+  if (!filters) return pinned;
+  if (!Array.isArray(filters)) {
+    var _iteratorNormalCompletion = true,
+      _didIteratorError = false,
+      _iteratorError = void 0;
+    try {
+      for (var _iterator = Object.entries(filters)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+        var [field, value] = _step.value;
+        if (isScalar(value)) pinned.add(field);
+      }
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator.return != null) {
+          _iterator.return();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+    return pinned;
+  }
+  var _iteratorNormalCompletion1 = true,
+    _didIteratorError1 = false,
+    _iteratorError1 = void 0;
+  try {
+    for (var _iterator1 = filters[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true) {
+      var condition = _step1.value;
+      var [field1, operator, value1] = condition.length === 4 ? condition[0] === doctype || doctype === void 0 ? [condition[1], condition[2], condition[3]] : [void 0, void 0, void 0] : condition;
+      if (field1 && operator === "=" && isScalar(value1)) pinned.add(field1);
+    }
+  } catch (err) {
+    _didIteratorError1 = true;
+    _iteratorError1 = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+        _iterator1.return();
+      }
+    } finally {
+      if (_didIteratorError1) {
+        throw _iteratorError1;
+      }
+    }
+  }
+  return pinned;
+}
+function defaultProjection(fields, pinned) {
+  var cap = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : defaultProjectionCap;
+  var open = fields.filter(function (field) {
+    return !pinned.has(field.fieldname);
+  });
+  return {
+    shown: open.slice(0, cap),
+    optIn: open.slice(cap),
+    pinned: fields.filter(function (field) {
+      return pinned.has(field.fieldname);
+    })
+  };
+}
+//# sourceMappingURL=defaultProjection.native.js.map

package/dist/jsx/list/defaultProjection.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__toCommonJS","mod","value","defaultProjection_exports","defaultProjection","defaultProjectionCap","scopePinnedFields","module","exports","_type_of","obj"],"sources":["../../../src/list/defaultProjection.ts"],"sourcesContent":[null],"mappings":"AAIO,YAAM;;AAOb,IAAAA,SAAS,GAAAC,MAAS,CAAAC,cAAyB;AACzC,IAAAC,gBAAiB,GAAAF,MAAS,CAAAG,wBAAoB;AAChD,IAAAC,iBAAA,GAAAJ,MAAA,CAAAK,mBAAA;AAOO,IAAAC,YAAS,GAAAN,MAAA,CAAAO,SAAkB,CAAkBC,cAA+B;AACjF,IAAAC,QAAM,GAAAA,CAAAC,MAAS,EAAAC,GAAA;EACf,KAAK,IAAAC,IAAS,IAAAD,GAAA,EACdZ,SAAW,CAAAW,MAAA,EAAQE,IAAA,EAAO;IAAAC,GAAG,EAAAF,GAAA,CAAAC,IAAA;IAAAE,UAAA;EAAA;AAC3B;AACE,IAAAC,WAAI,GAAAA,CAASC,EAAA,EAAAC,IAAQ,EAAAC,MAAO,EAAAC,IAAI,KAAK;EAAA,IACvCF,IAAA,WAAAA,IAAA,wBAAAA,IAAA;IACA,SAAOG,GAAA,IAAAhB,iBAAA,CAAAa,IAAA,GACT,KAAAX,YAAA,CAAAe,IAAA,CAAAL,EAAA,EAAAI,GAAA,KAAAA,GAAA,KAAAF,MAAA,EACAnB,SAAW,CAAAiB,EAAA,EAAAI,GAAA,EAAa;MAAAP,GAAA,EAAAA,CAAA,KAASI,IAAA,CAAAG,GAAA;MAAAN,UAAA,IAAAK,IAAA,GAAAjB,gBAAA,CAAAe,IAAA,EAAAG,GAAA,MAAAD,IAAA,CAAAL;IAAA;EAC/B;EAMA,OAAIE,EAAA;AAA8D;AAEpE,IAAAM,YAAO,GAAAC,GAAA,IAAAR,WAAA,CAAAhB,SAAA;EAAAyB,KAAA;AAAA,IAAAD,GAAA;AACT,IAAAE,yBAAA;AAeOhB,QAAA,CAASgB,yBACd,EACA;EAGAC,iBAAa,EAAAA,CAAA,KAAOA,iBAAmB;EACvCC,oBAAO,EAAAA,CAAA,KAAAA,oBAAA;EAAAC,iBACO,EAAAA,CAAA,KAASA;AAAG;AACHC,MACrB,CAAAC,OAAQ,GAAAR,YAAe,CAAAG,yBAA2B;AAAU,SAC9DM,SAAAC,GAAA;EACF","ignoreList":[]}

package/dist/jsx/shared/devWarn.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["seen","Set","frappeDevWarn","code","detail","process","env","NODE_ENV","key","component","id","doctype","join","has","add","bits","suggest","filter","Boolean","console","warn","length","__resetFrappeDevWarnSeen","clear"],"sources":["../../../src/shared/devWarn.ts"],"sourcesContent":[null],"mappings":"AAwBA,MAAMA,IAAA,GAAO,mBAAIC,GAAA,CAAY;AAEtB,SAASC,cAAcC,IAAA,EAAyBC,MAAA,GAA8B,CAAC,GAAS;EAC7F,IAAIC,OAAA,CAAQC,GAAA,CAAIC,QAAA,KAAa,cAAc;EAC3C,MAAMC,GAAA,GAAM,CAACL,IAAA,EAAMC,MAAA,CAAOK,SAAA,IAAa,IAAIL,MAAA,CAAOM,EAAA,IAAM,IAAIN,MAAA,CAAOO,OAAA,IAAW,EAAE,EAAEC,IAAA,CAAK,GAAG;EAC1F,IAAIZ,IAAA,CAAKa,GAAA,CAAIL,GAAG,GAAG;EACnBR,IAAA,CAAKc,GAAA,CAAIN,GAAG;EACZ,MAAMO,IAAA,GAAO,CACXX,MAAA,CAAOK,SAAA,GAAY,aAAaL,MAAA,CAAOK,SAAS,KAAK,QACrDL,MAAA,CAAOM,EAAA,GAAK,MAAMN,MAAA,CAAOM,EAAE,KAAK,QAChCN,MAAA,CAAOO,OAAA,GAAU,WAAWP,MAAA,CAAOO,OAAO,KAAK,QAC/CP,MAAA,CAAOY,OAAA,GAAU,WAAWZ,MAAA,CAAOY,OAAO,KAAK,OACjD,CAAEC,MAAA,CAAOC,OAAO;EAChBC,OAAA,CAAQC,IAAA,CAAK,eAAejB,IAAI,GAAGY,IAAA,CAAKM,MAAA,GAAS,KAAKN,IAAA,CAAKH,IAAA,CAAK,IAAI,CAAC,MAAM,EAAE,EAAE;AACjF;AAGO,SAASU,yBAAA,EAAiC;EAC/CtB,IAAA,CAAKuB,KAAA,CAAM;AACb","ignoreList":[]}
+{"version":3,"names":["seen","Set","frappeDevWarn","code","detail","process","env","NODE_ENV","key","component","id","doctype","join","has","add","bits","suggest","filter","Boolean","console","warn","length","__resetFrappeDevWarnSeen","clear"],"sources":["../../../src/shared/devWarn.ts"],"sourcesContent":[null],"mappings":"AAyBA,MAAMA,IAAA,GAAO,mBAAIC,GAAA,CAAY;AAEtB,SAASC,cAAcC,IAAA,EAAyBC,MAAA,GAA8B,CAAC,GAAS;EAC7F,IAAIC,OAAA,CAAQC,GAAA,CAAIC,QAAA,KAAa,cAAc;EAC3C,MAAMC,GAAA,GAAM,CAACL,IAAA,EAAMC,MAAA,CAAOK,SAAA,IAAa,IAAIL,MAAA,CAAOM,EAAA,IAAM,IAAIN,MAAA,CAAOO,OAAA,IAAW,EAAE,EAAEC,IAAA,CAAK,GAAG;EAC1F,IAAIZ,IAAA,CAAKa,GAAA,CAAIL,GAAG,GAAG;EACnBR,IAAA,CAAKc,GAAA,CAAIN,GAAG;EACZ,MAAMO,IAAA,GAAO,CACXX,MAAA,CAAOK,SAAA,GAAY,aAAaL,MAAA,CAAOK,SAAS,KAAK,QACrDL,MAAA,CAAOM,EAAA,GAAK,MAAMN,MAAA,CAAOM,EAAE,KAAK,QAChCN,MAAA,CAAOO,OAAA,GAAU,WAAWP,MAAA,CAAOO,OAAO,KAAK,QAC/CP,MAAA,CAAOY,OAAA,GAAU,WAAWZ,MAAA,CAAOY,OAAO,KAAK,OACjD,CAAEC,MAAA,CAAOC,OAAO;EAChBC,OAAA,CAAQC,IAAA,CAAK,eAAejB,IAAI,GAAGY,IAAA,CAAKM,MAAA,GAAS,KAAKN,IAAA,CAAKH,IAAA,CAAK,IAAI,CAAC,MAAM,EAAE,EAAE;AACjF;AAGO,SAASU,yBAAA,EAAiC;EAC/CtB,IAAA,CAAKuB,KAAA,CAAM;AACb","ignoreList":[]}

package/dist/jsx/shared/devWarn.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call"],"sources":["../../../src/shared/devWarn.ts"],"sourcesContent":[null],"mappings":"AAwBA,YAAM;;AAEC,IAAAA,SAAS,GAAAC,MAAA,CAAcC,cAAyB;AACrD,IAAAC,gBAAgB,GAAAF,MAAA,CAAAG,wBAA2B;AAC3C,IAAAC,iBAAmB,GAAAJ,MAAO,CAAAK,mBAAiB;AAC3C,IAAAC,YAAa,GAAGN,MAAG,CAAAO,SAAA,CAAAC,cAAA;AACnB,IAAAC,QAAS,GAAGA,CAAAC,MAAA,EAAAC,GAAA;EACZ,SAAMC,IAAO,IAAAD,GAAA,EACXZ,SAAO,CAAAW,MAAA,EAAAE,IAAY;IAAAC,GAAA,EAAAF,GAAa,CAAAC,IAAO;IAAAE,UAAS,EAAK;EAAA;AAAA;AACrB,IAChCC,WAAO,GAAAA,CAAAC,EAAU,EAAAC,IAAA,EAAAC,MAAW,EAAAC,IAAO,KAAO;EAAK,IAC/CF,IAAA,IAAO,OAAUA,IAAA,aAAW,IAAO,OAAOA,IAAK;IAC/C,SAAOG,GAAA,IAAOhB,iBAAA,CAAAa,IAAA,GAChB,IAAQ,CAAAX,YAAK,CAAAe,IAAA,CAAAL,EAAe,EAAAI,GAAI,CAAG,IAAAA,GAAK,KAAAF,MAAS,EACnDnB,SAAA,CAAAiB,EAAA,EAAAI,GAAA;MAAAP,GAAA,EAAAA,CAAA,KAAAI,IAAA,CAAAG,GAAA;MAAAN,UAAA,IAAAK,IAAA,GAAAjB,gBAAA,CAAAe,IAAA,EAAAG,GAAA,MAAAD,IAAA,CAAAL;IAAA;EAGO;EACL,OAAKE,EAAA;AACP","ignoreList":[]}
+{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call"],"sources":["../../../src/shared/devWarn.ts"],"sourcesContent":[null],"mappings":"AAyBA,YAAM;;AAEC,IAAAA,SAAS,GAAAC,MAAA,CAAcC,cAAyB;AACrD,IAAAC,gBAAgB,GAAAF,MAAA,CAAAG,wBAA2B;AAC3C,IAAAC,iBAAmB,GAAAJ,MAAO,CAAAK,mBAAiB;AAC3C,IAAAC,YAAa,GAAGN,MAAG,CAAAO,SAAA,CAAAC,cAAA;AACnB,IAAAC,QAAS,GAAGA,CAAAC,MAAA,EAAAC,GAAA;EACZ,SAAMC,IAAO,IAAAD,GAAA,EACXZ,SAAO,CAAAW,MAAA,EAAAE,IAAY;IAAAC,GAAA,EAAAF,GAAa,CAAAC,IAAO;IAAAE,UAAS,EAAK;EAAA;AAAA;AACrB,IAChCC,WAAO,GAAAA,CAAAC,EAAU,EAAAC,IAAA,EAAAC,MAAW,EAAAC,IAAO,KAAO;EAAK,IAC/CF,IAAA,IAAO,OAAUA,IAAA,aAAW,IAAO,OAAOA,IAAK;IAC/C,SAAOG,GAAA,IAAOhB,iBAAA,CAAAa,IAAA,GAChB,IAAQ,CAAAX,YAAK,CAAAe,IAAA,CAAAL,EAAe,EAAAI,GAAI,CAAG,IAAAA,GAAK,KAAAF,MAAS,EACnDnB,SAAA,CAAAiB,EAAA,EAAAI,GAAA;MAAAP,GAAA,EAAAA,CAAA,KAAAI,IAAA,CAAAG,GAAA;MAAAN,UAAA,IAAAK,IAAA,GAAAjB,gBAAA,CAAAe,IAAA,EAAAG,GAAA,MAAAD,IAAA,CAAAL;IAAA;EAGO;EACL,OAAKE,EAAA;AACP","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/frappe-ui",
-  "version": "7.78.0",
+  "version": "7.80.0",
   "description": "Pre-wired Tamagui components for Frappe doctypes with live data",
   "keywords": [
     "cross-platform",
@@ -72,18 +72,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@multiplatform.one/components": "^7.78.0",
-    "@multiplatform.one/desktop": "^7.78.0",
-    "@multiplatform.one/forms": "^7.78.0",
-    "@multiplatform.one/frappe": "^7.78.0",
-    "@multiplatform.one/i18n": "^7.78.0",
-    "@multiplatform.one/markdown": "^7.78.0",
-    "@multiplatform.one/platform": "^7.78.0",
-    "@multiplatform.one/rich-text": "^7.78.0",
-    "@multiplatform.one/router": "^7.78.0",
-    "@multiplatform.one/store": "^7.78.0",
-    "@multiplatform.one/table": "^7.78.0",
-    "@multiplatform.one/theme": "^7.78.0",
+    "@multiplatform.one/components": "^7.80.0",
+    "@multiplatform.one/desktop": "^7.80.0",
+    "@multiplatform.one/forms": "^7.80.0",
+    "@multiplatform.one/frappe": "^7.80.0",
+    "@multiplatform.one/i18n": "^7.80.0",
+    "@multiplatform.one/markdown": "^7.80.0",
+    "@multiplatform.one/platform": "^7.80.0",
+    "@multiplatform.one/rich-text": "^7.80.0",
+    "@multiplatform.one/router": "^7.80.0",
+    "@multiplatform.one/store": "^7.80.0",
+    "@multiplatform.one/table": "^7.80.0",
+    "@multiplatform.one/theme": "^7.80.0",
     "@phosphor-icons/react": "^2.1.10",
     "@tamagui/colors": "2.7.6",
     "@tanstack/db": "0.8.0",
@@ -100,9 +100,9 @@
     "tamagui": "2.7.6"
   },
   "devDependencies": {
-    "@multiplatform.one/config": "7.78.0",
-    "@multiplatform.one/storybook": "7.78.0",
-    "@multiplatform.one/test-utils": "7.78.0",
+    "@multiplatform.one/config": "7.80.0",
+    "@multiplatform.one/storybook": "7.80.0",
+    "@multiplatform.one/test-utils": "7.80.0",
     "@tamagui/build": "2.7.6",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",

package/src/FrappeForm.recordChanged.spec.tsx

@@ -0,0 +1,179 @@
+/**
+ * LC-191 RECORD-CHANGED-UNDER-YOU: an open record that changes on the server
+ * says so and keeps the work. A newer server version pushed mid-edit keeps
+ * the edit, names the field by its label and offers Reload or Overwrite; a
+ * record deleted mid-edit stays mounted, turns read-only and says so, which
+ * is not the not-found state.
+ *
+ * The server is the fixture corpus; a snapshot refresh of the shared
+ * SyncModule plays the change the live socket would deliver.
+ */
+
+import { getFrappeSyncModule, type InMemoryFixtureProvider } from "@multiplatform.one/frappe";
+import { renderWithProviders } from "@multiplatform.one/test-utils";
+import { act, cleanup, fireEvent, screen, waitFor } from "@testing-library/react";
+import i18next from "i18next";
+import { initReactI18next } from "react-i18next";
+import { Text } from "tamagui";
+import { afterEach, beforeAll, describe, expect, it } from "vitest";
+import { assetLoanLifecycleFixtures } from "../tests/fixtures/assetLoanLifecycle";
+import { FrappeForm } from "./FrappeForm";
+import { FrappeProvider } from "./FrappeProvider";
+import type { FieldOverride } from "./schemaForm";
+
+beforeAll(async () => {
+  await i18next.use(initReactI18next).init({
+    lng: "en",
+    interpolation: { escapeValue: false },
+    resources: { en: { translation: {} } },
+  });
+});
+
+afterEach(cleanup);
+
+const probe: FieldOverride = (props) => {
+  const name = props.fieldMeta?.name ?? "";
+  const value = props.value === undefined || props.value === null ? "" : String(props.value);
+  return (
+    <>
+      <Text
+        testID={`probe-${name}`}
+      >{`ro=${!!props.readOnly || !!props.disabled} val=${value}`}</Text>
+      <button type="button" data-testid={`set-${name}`} onClick={() => props.onChange("mine")}>
+        set
+      </button>
+    </>
+  );
+};
+
+const overrides = { employee_name: probe, serial_no: probe, remarks: probe };
+
+function renderDraft(fixtures: InMemoryFixtureProvider) {
+  return renderWithProviders(
+    <FrappeProvider baseURL="http://test" fixtures={fixtures}>
+      <FrappeForm
+        doctype="Asset Loan"
+        name="LOAN-DRAFT"
+        roles={["Loan Manager"]}
+        overrides={overrides}
+        showSidebar={false}
+        showTimeline={false}
+        onDelete={() => {}}
+      />
+    </FrappeProvider>,
+  );
+}
+
+async function serverWrites(fixtures: InMemoryFixtureProvider, write: () => Promise<unknown>) {
+  await act(async () => {
+    await write();
+    await getFrappeSyncModule({ fixtures })!.refreshSubscriptions({ doctypes: ["Asset Loan"] });
+  });
+}
+
+async function expectProbe(field: string, text: string) {
+  await waitFor(() => expect(screen.getByTestId(`probe-${field}`).textContent).toContain(text));
+}
+
+describe("a newer server version lands mid-edit (LC-191)", () => {
+  it("keeps the edit, names the field by its label and offers Reload and Overwrite", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("employee_name", "val=Ada Lovelace");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+    await expectProbe("employee_name", "val=mine");
+
+    await serverWrites(fixtures, () =>
+      fixtures.updateDoc("Asset Loan", "LOAN-DRAFT", { employee_name: "Grace Hopper" }),
+    );
+
+    const banner = await screen.findByTestId("frappe-form-conflict-banner");
+    expect(banner.textContent).toContain("Employee Name");
+    expect(banner.textContent).not.toContain("employee_name");
+    expect(screen.getByTestId("probe-employee_name").textContent).toContain("val=mine");
+    expect(banner.querySelector("[role='button'], button")).toBeTruthy();
+    expect(screen.getByText("Reload")).toBeTruthy();
+    expect(screen.getByText("Overwrite")).toBeTruthy();
+  });
+
+  it("a server change to a field the user left alone lands without a banner", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("remarks", "val=");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+
+    await serverWrites(fixtures, () =>
+      fixtures.updateDoc("Asset Loan", "LOAN-DRAFT", { remarks: "from the server" }),
+    );
+
+    await expectProbe("remarks", "val=from the server");
+    expect(screen.getByTestId("probe-employee_name").textContent).toContain("val=mine");
+    expect(screen.queryByTestId("frappe-form-conflict-banner")).toBeNull();
+  });
+
+  it("Reload drops the edit for the server copy", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("employee_name", "val=Ada Lovelace");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+    await serverWrites(fixtures, () =>
+      fixtures.updateDoc("Asset Loan", "LOAN-DRAFT", { employee_name: "Grace Hopper" }),
+    );
+    await screen.findByTestId("frappe-form-conflict-banner");
+
+    fireEvent.click(screen.getByText("Reload"));
+
+    await expectProbe("employee_name", "val=Grace Hopper");
+    expect(screen.queryByTestId("frappe-form-conflict-banner")).toBeNull();
+  });
+
+  it("Overwrite writes the edit over the newer server value", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("employee_name", "val=Ada Lovelace");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+    await serverWrites(fixtures, () =>
+      fixtures.updateDoc("Asset Loan", "LOAN-DRAFT", { employee_name: "Grace Hopper" }),
+    );
+    await screen.findByTestId("frappe-form-conflict-banner");
+
+    fireEvent.click(screen.getByText("Overwrite"));
+
+    await waitFor(async () =>
+      expect((await fixtures.getDoc("Asset Loan", "LOAN-DRAFT"))?.employee_name).toBe("mine"),
+    );
+    await waitFor(() => expect(screen.queryByTestId("frappe-form-conflict-banner")).toBeNull());
+  });
+});
+
+describe("the record is deleted mid-edit (LC-191)", () => {
+  it("stays mounted, turns read-only and says the edits can no longer be saved", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("employee_name", "ro=false val=Ada Lovelace");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+
+    await serverWrites(fixtures, () => fixtures.deleteDoc("Asset Loan", "LOAN-DRAFT"));
+
+    const banner = await screen.findByTestId("frappe-form-deleted-banner");
+    expect(banner.textContent).toContain("deleted on the server");
+    expect(banner.textContent).toContain("unsaved edits can no longer be saved");
+    await expectProbe("employee_name", "ro=true val=mine");
+    expect(screen.queryByTestId("frappe-form-status-notFound")).toBeNull();
+    expect(screen.queryByText("Asset Loan not found")).toBeNull();
+    expect(screen.queryByTestId("frappe-form-conflict-banner")).toBeNull();
+  });
+
+  it("a clean record says only that it is read-only now", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    renderDraft(fixtures);
+    await expectProbe("employee_name", "ro=false val=Ada Lovelace");
+
+    await serverWrites(fixtures, () => fixtures.deleteDoc("Asset Loan", "LOAN-DRAFT"));
+
+    const banner = await screen.findByTestId("frappe-form-deleted-banner");
+    expect(banner.textContent).toContain("Fields are read-only.");
+    expect(banner.textContent).not.toContain("unsaved edits");
+    await expectProbe("employee_name", "ro=true val=Ada Lovelace");
+  });
+});

package/src/FrappeForm.recordChanged.stories.tsx

@@ -0,0 +1,83 @@
+import { getFrappeSyncModule, type InMemoryFixtureProvider } from "@multiplatform.one/frappe";
+import { useEffect, useMemo, useRef } from "react";
+import { assetLoanLifecycleFixtures } from "../tests/fixtures/assetLoanLifecycle";
+import { FrappeForm } from "./FrappeForm";
+import { FrappeProvider } from "./FrappeProvider";
+import { useFrappeForm } from "./useFrappeForm";
+
+export default {
+  title: "FrappeUI/FrappeForm Record Changed",
+  component: FrappeForm,
+  tags: ["!test"],
+  parameters: {
+    status: { type: "beta" },
+    docs: {
+      description: {
+        component:
+          "LC-191: the open record changes on the server. A newer version that touches a field the reader edited keeps the edit, names the field by its label and offers Reload or Overwrite. A record deleted mid-edit stays on screen, read-only, and says the unsaved edits can no longer be saved. Each story edits Employee Name, then plays the server change on the fixture corpus.",
+      },
+    },
+  },
+};
+
+type Loan = { name: string; doctype: string; employee_name?: string };
+
+function Changed({
+  fixtures,
+  serverChange,
+}: {
+  fixtures: InMemoryFixtureProvider;
+  serverChange: (fixtures: InMemoryFixtureProvider) => Promise<unknown>;
+}) {
+  const form = useFrappeForm<Loan>({
+    doctype: "Asset Loan",
+    name: "LOAN-DRAFT",
+    roles: ["Loan Manager"],
+  });
+  const played = useRef(false);
+  const loaded = form.status === "ready" && form.baseline?.employee_name === "Ada Lovelace";
+  useEffect(() => {
+    if (!loaded || played.current) return;
+    played.current = true;
+    form.setValue("employee_name", "Ada King");
+    void serverChange(fixtures).then(() =>
+      getFrappeSyncModule({ fixtures })?.refreshSubscriptions({ doctypes: ["Asset Loan"] }),
+    );
+  }, [loaded, form, fixtures, serverChange]);
+  return (
+    <FrappeForm<Loan>
+      form={form}
+      doctype="Asset Loan"
+      name="LOAN-DRAFT"
+      showSidebar={false}
+      showTimeline={false}
+    />
+  );
+}
+
+function Story({
+  serverChange,
+}: {
+  serverChange: (fixtures: InMemoryFixtureProvider) => Promise<unknown>;
+}) {
+  const fixtures = useMemo(() => assetLoanLifecycleFixtures(), []);
+  return (
+    <FrappeProvider baseURL="https://form-record-changed.mock.test" fixtures={fixtures}>
+      <Changed fixtures={fixtures} serverChange={serverChange} />
+    </FrappeProvider>
+  );
+}
+
+/** Someone else saved Employee Name while it was being edited. */
+export const ChangedOnServer = () => (
+  <Story
+    serverChange={(fixtures) =>
+      fixtures.updateDoc("Asset Loan", "LOAN-DRAFT", { employee_name: "Grace Hopper" })
+    }
+  />
+);
+
+/** The record was deleted while it was open with an unsaved edit. */
+export const DeletedOnServer = () => (
+  <Story serverChange={(fixtures) => fixtures.deleteDoc("Asset Loan", "LOAN-DRAFT")} />
+);

package/src/FrappeForm.successIsCallback.spec.tsx

@@ -0,0 +1,154 @@
+/**
+ * LC-194 SUCCESS-IS-A-CALLBACK: a data component reports, the page reacts.
+ * FrappeForm completes a create, a save and a delete and hands each result to
+ * its callback, with no toast or notify of its own and no navigation, even
+ * when the host has a router it could push.
+ */
+
+import type { InMemoryFixtureProvider } from "@multiplatform.one/frappe";
+import { renderWithProviders } from "@multiplatform.one/test-utils";
+import { cleanup, fireEvent, screen, waitFor } from "@testing-library/react";
+import i18next from "i18next";
+import { initReactI18next } from "react-i18next";
+import { Text } from "tamagui";
+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { assetLoanLifecycleFixtures } from "../tests/fixtures/assetLoanLifecycle";
+import { FrappeForm } from "./FrappeForm";
+import type { FrappeNavigation } from "./frappeNavigation";
+import { FrappeProvider } from "./FrappeProvider";
+import type { FieldOverride } from "./schemaForm";
+
+const feedback = vi.hoisted(() => ({ notify: vi.fn(), showToast: vi.fn() }));
+
+vi.mock("@multiplatform.one/components", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@multiplatform.one/components")>();
+  return {
+    ...actual,
+    notify: (...args: Parameters<typeof actual.notify>) => {
+      feedback.notify(...args);
+      return actual.notify(...args);
+    },
+    showToast: (...args: Parameters<typeof actual.showToast>) => {
+      feedback.showToast(...args);
+      return actual.showToast(...args);
+    },
+  };
+});
+
+beforeAll(async () => {
+  await i18next.use(initReactI18next).init({
+    lng: "en",
+    interpolation: { escapeValue: false },
+    resources: { en: { translation: {} } },
+  });
+});
+
+beforeEach(() => {
+  vi.stubGlobal(
+    "confirm",
+    vi.fn(() => true),
+  );
+});
+
+afterEach(() => {
+  cleanup();
+  vi.unstubAllGlobals();
+  feedback.notify.mockClear();
+  feedback.showToast.mockClear();
+});
+
+const probe: FieldOverride = (props) => {
+  const name = props.fieldMeta?.name ?? "";
+  const value = props.value === undefined || props.value === null ? "" : String(props.value);
+  return (
+    <>
+      <Text testID={`probe-${name}`}>{`val=${value}`}</Text>
+      <button type="button" data-testid={`set-${name}`} onClick={() => props.onChange("Edited")}>
+        set
+      </button>
+    </>
+  );
+};
+
+const overrides = { employee_name: probe, serial_no: probe, remarks: probe };
+
+function renderForm(fixtures: InMemoryFixtureProvider, name?: string) {
+  const pushed: string[] = [];
+  const navigation: FrappeNavigation = {
+    usePathname: () => "/loans",
+    useNavigate: () => (href) => pushed.push(href),
+  };
+  const onSave = vi.fn();
+  const onDelete = vi.fn();
+  renderWithProviders(
+    <FrappeProvider baseURL="http://test" fixtures={fixtures} navigation={navigation}>
+      <FrappeForm
+        doctype="Asset Loan"
+        name={name}
+        roles={["Loan Manager"]}
+        overrides={overrides}
+        showSidebar={false}
+        showTimeline={false}
+        onSave={onSave}
+        onDelete={onDelete}
+      />
+    </FrappeProvider>,
+  );
+  return { pushed, onSave, onDelete };
+}
+
+function press(name: string) {
+  const byLabel = document.querySelector(`[aria-label='${name}']`);
+  fireEvent.click((byLabel as HTMLElement | null) ?? screen.getByText(name));
+}
+
+function expectNoOwnFeedback(pushed: string[]) {
+  expect(feedback.notify).not.toHaveBeenCalled();
+  expect(feedback.showToast).not.toHaveBeenCalled();
+  expect(pushed).toEqual([]);
+}
+
+describe("FrappeForm reports a mutation through its callback only (LC-194)", () => {
+  it("a create hands the new record to onSave", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    const { pushed, onSave } = renderForm(fixtures);
+    await screen.findByTestId("probe-employee_name");
+    fireEvent.click(screen.getByTestId("set-employee_name"));
+
+    press("Save");
+
+    await waitFor(() => expect(onSave).toHaveBeenCalledTimes(1));
+    expect(onSave.mock.calls[0]?.[0]).toMatchObject({ employee_name: "Edited" });
+    expect(typeof onSave.mock.calls[0]?.[0].name).toBe("string");
+    expectNoOwnFeedback(pushed);
+  });
+
+  it("a save hands the saved record to onSave", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    const { pushed, onSave } = renderForm(fixtures, "LOAN-DRAFT");
+    await waitFor(() => expect(screen.getByTestId("probe-remarks").textContent).toBe("val="));
+    fireEvent.click(screen.getByTestId("set-remarks"));
+
+    press("Save");
+
+    await waitFor(() => expect(onSave).toHaveBeenCalledTimes(1));
+    expect(onSave.mock.calls[0]?.[0]).toMatchObject({ name: "LOAN-DRAFT", remarks: "Edited" });
+    expect((await fixtures.getDoc("Asset Loan", "LOAN-DRAFT"))?.remarks).toBe("Edited");
+    expectNoOwnFeedback(pushed);
+  });
+
+  it("a delete hands the removed record to onDelete", async () => {
+    const fixtures = assetLoanLifecycleFixtures();
+    const { pushed, onDelete } = renderForm(fixtures, "LOAN-DRAFT");
+    await waitFor(() =>
+      expect(screen.getByTestId("probe-employee_name").textContent).toBe("val=Ada Lovelace"),
+    );
+
+    press("Delete");
+
+    await waitFor(() => expect(onDelete).toHaveBeenCalledTimes(1));
+    expect(onDelete.mock.calls[0]?.[0]).toMatchObject({ name: "LOAN-DRAFT" });
+    expect(await fixtures.getDoc("Asset Loan", "LOAN-DRAFT")).toBeFalsy();
+    expectNoOwnFeedback(pushed);
+  });
+});