@m4l/testing 1.2.0 → 1.2.1-beta-docs-autocomplete-async-with-add-mf-sync.0

package/README.md

@@ -312,6 +312,7 @@ Current shared Vitest helpers in `@m4l/testing/vitest` include:
 - `createM4lAppFormLayoutsModuleOverrides(...)`
 - `createM4lAppCoreModuleMock(...)`
 - `createM4lPackageGclickModuleMock(...)`
+- `createM4lResourceSynchronizationModuleOverrides()`
 - `createM4lPackageGclickRealtimeModuleMock(...)`
 - `createM4lAppGraphicsModuleMock(...)`
   Includes a neutral `useInfinitePaginate()` entry (no rows, `hasMore: false`,
@@ -338,8 +339,9 @@ Current shared Vitest helpers in `@m4l/testing/vitest` include:
 - `createReResizableModuleMock(...)`
 - `createReactLeafletModuleMock(...)`
   Reusable module factories for M4L component consumers plus app and package `test/setup.ts` files so packages, hosts, and MFs can keep thin local adapters instead of repeating the same large `vi.mock(...)` payloads. When a consumer needs untouched real exports too, pass `baseModule` populated from `importOriginal(...)` and let the shared factory override only the test-facing surface.
-  `createM4lAppFormComponentsModuleOverrides(...)` provides a reusable override payload for app/MF `@m4l/components` setups that need the dynamic-MF parameters store plus neutral form container/action placeholders (`FormContainer`, `ActionsContainer`, `ActionFormCancel`, `ActionFormIntro`, `RHFAutocompleteAsync`, and `RHFRadioGroup`) without copying the same local override object across app test setups.
+  `createM4lAppFormComponentsModuleOverrides(...)` provides a reusable override payload for app/MF `@m4l/components` setups that need the dynamic-MF parameters store plus neutral form container/action placeholders (`FormContainer`, `ActionsContainer`, `ActionFormCancel`, `ActionFormIntro`, `RHFAutocompleteAsync`, and `RHFRadioGroup`) without copying the same local override object across app test setups. The canonical `RHFAutocompleteAsync` mock remains a neutral placeholder; inspect its props for optional `add` configuration without opening a real creation window.
   `createM4lAppFormLayoutsModuleOverrides(...)` provides a reusable override payload for app/MF `@m4l/layouts` setups that need neutral paper-form seams (`useDynamicPaperForm`, `useFormAddEdit`) and a configurable `createComponentField(...)` identity baseline without repeating the same setup-local overrides.
+  `createM4lMFActionModuleOverrides()` provides opt-in `completeMFAction` and `isMFActionRequest` spies plus the production `MF_ACTION_REQUEST_PARAM` identity for save-orchestration tests. Request recognition defaults to false and completion is a no-op; individual scenarios can enable recognition or make the observer throw. Compose it through app-component `moduleOverrides` instead of dynamically importing a component implementation from an MF setup, because that dynamic workspace import marks the component package as lazy in Nx's dependency graph. The standard factory continues to preserve real action helpers through `baseModule`; transport and lifecycle behavior have their own component-level tests.
   `createReactHookFormModuleMock(...)` now accepts `useFormContextData` so tests can inject package-local `setValue`, `reset`, `formState`, and related RHF behavior without rebuilding the full `react-hook-form` contract in each file.
   `createLeafletModuleMock(...)` now covers the repeated partial `leaflet` seams that showed up during the `GpsMap` normalization work: configurable `L.control.scale()` and `L.DomEvent.disableClickPropagation()` / `disableScrollPropagation()` behavior, while still preserving real exports through `baseModule` when the consumer needs the untouched runtime surface.
   `createReactLeafletModuleMock(...)` now covers neutral `Circle`, `GeoJSON`, `Polygon`, `Polyline`, `LayerGroup`, `Marker`, `Popup`, and configurable `useMap()` behavior. Use `useMapData` when the test can keep one stable map object for the whole file, or `useMapImplementation` when the test needs `useMap()` to read mutable per-test state such as a late-bound fake map ref. When a test still needs real exports such as `MapContainer`, keep the mock partial by passing `baseModule` from `importOriginal(...)` and override only the shape components or `useMap()` contract that belong to the scenario.
@@ -361,6 +363,7 @@ Current shared Vitest helpers in `@m4l/testing/vitest` include:
   The shared M4L app factories now also cover neutral platform-shell and MF-loading collaborators that repeatedly show up in app tests, including provider passthrough components such as `ModuleDictionaryProvider`, `ModuleSkeletonProvider`, `DomainCountryProvider`, `FormatterProvider`, `ModalProvider`, `PopupsProvider`, `AreasProvider`, `FlagsProvider`, `EnvironmentProvider`, `HostToolsProvider`, `NetworkProvider`, `AuthProvider`, `LocalesProvider`, `ThemeSettingsProvider`, `DeviceTypeProvider`, and `HostThemeProvider`, plus shell primitives such as `SideBar`, `AppBar`, `HelmetPage`, `AreasAdmin`, `LanguagePopover`, `AccountPopover`, `MFNoAuthApp`, `MFLoader`, `createDynamicMFStore(...)`, `createToaster(...)`, `getMFLoaderComponentsDictionary()`, `getLoadingErrorComponentsDictionary()`, and locale/domain hooks such as `useLocales()`, `useDomainCountry()`, and `getLocaleFromNetwork()`.
   The shared base `@m4l/components` layer now also owns reusable view primitives such as `Divider`, `NavLink`, and `WindowBase`, plus focused placeholder helpers such as `createDividerComponentMock(...)`, `createNavLinkComponentMock(...)`, and `createWindowBaseComponentMock(...)` so app tests can stay on top of the setup-owned baseline instead of rebuilding local workspace-library mocks.
   `createM4lPackageGclickModuleMock(...)` remains intentionally specific to the `@m4l/gclick` package and covers map-store, indicator, and GNSS enum behavior that only makes sense when mocking that exact runtime package.
+  `createM4lResourceSynchronizationModuleOverrides()` is an explicit opt-in for MF orchestration suites that need controllable `useResourceInvalidation`, `useResourceMutation`, and `useEntityReferenceAdd` hooks plus the `PERSONS_RESOURCE` and `PROTOCOL_PERSON_REPORT_METHODS_RESOURCE` identities. A lightweight MF setup can use this payload directly without importing the full map/video runtime; a suite that needs other GClick exports can pass it through `moduleOverrides` or combine it with its existing partial mock. The standard package factory keeps these new exports real by default. Each factory invocation owns stable hook results and action functions, so component rerenders do not create artificial subscription changes. The resource contract test imports the real public root while isolating unrelated feature barrels, and compares the two identity constants with production values. Component passthrough contracts reuse the existing real Components preload; the generic autocomplete and MF action helpers remain real unless explicitly overridden.
   The shared app-components baseline now exposes a minimal but stable
   `WINDOW_SIZES.square` contract with both `medium` and `large` entries so app
   tests can open modal windows without each suite rebuilding the same shape

package/chunks/{reactLeaflet-Ca5S8G_T.js → reactLeaflet-CYEpmWXL.js}

@@ -5,7 +5,7 @@ import { q as Q, l as x, r as B, w as ee, v as te, u as re } from "./userPrefere
 import "date-fns";
 import "history";
 import y from "react";
-const O = "__rhfOnSubmitRef", ne = {
+const k = "__rhfOnSubmitRef", ne = {
   square: {
     large: {
       width: 800,
@@ -102,13 +102,13 @@ function he(e) {
 function Se(e) {
   return e?.type === "icon";
 }
-function Pe(e) {
+function Me(e) {
   return e?.type === "color";
 }
-function Me(e) {
+function Pe(e) {
   return e?.type === "image";
 }
-function k(e) {
+function O(e) {
   return typeof e == "string" ? JSON.stringify(e) : typeof e == "symbol" ? e.toString() : $(e, {
     depth: 4,
     breakLength: 1 / 0,
@@ -118,15 +118,15 @@ function k(e) {
 }
 function A(e, n, o, r, a) {
   e.push(
-    `${n} ${o}: expected ${k(r)}, got ${k(a)}`
+    `${n} ${o}: expected ${O(r)}, got ${O(a)}`
   );
 }
-function _(e, n, o) {
+function R(e, n, o) {
   e.push(`${n} ${o}: expected a function, got undefined`);
 }
-function w(e, n, o) {
+function L(e, n, o) {
   e.push(
-    `${n} ${o}: expected undefined, got ${k("function")}`
+    `${n} ${o}: expected undefined, got ${O("function")}`
   );
 }
 function Ae(e, n, o, r) {
@@ -136,7 +136,7 @@ function Ae(e, n, o, r) {
   }
   const a = Object.keys(o).sort(), i = Object.keys(r).sort();
   g(a, i) || e.push(
-    `${n} testProps keys: expected ${k(i)}, got ${k(a)}`
+    `${n} testProps keys: expected ${O(i)}, got ${O(a)}`
   ), i.forEach((s) => {
     const c = r[s], d = o[s];
     if (c === D) {
@@ -264,14 +264,14 @@ function be(e) {
     requiresFormatter: !0,
     requiresFilter: !1,
     requiresSort: !1
-  } : Pe(e) ? {
+  } : Me(e) ? {
     expectedTestProps: {
       fieldValue: e.fieldValue
     },
     requiresFormatter: !0,
     requiresFilter: !1,
     requiresSort: !1
-  } : Me(e) ? {
+  } : Pe(e) ? {
     expectedTestProps: {
       fieldValue: e.fieldValue,
       fieldText: e.fieldText,
@@ -287,7 +287,7 @@ function be(e) {
 function Te(e) {
   return {
     expectedTestProps: {
-      unsupportedHookCall: k(e)
+      unsupportedHookCall: O(e)
     },
     requiresFormatter: !0,
     requiresFilter: !0,
@@ -335,10 +335,10 @@ function et(e, n) {
         s,
         i.testProps,
         c.expectedTestProps
-      ), i.formatter === void 0 && _(o, s, "formatter"), c.requiresFilter && i.customFilter === void 0 && _(o, s, "customFilter"), c.requiresSort && i.customSort === void 0 && _(o, s, "customSort");
+      ), i.formatter === void 0 && R(o, s, "formatter"), c.requiresFilter && i.customFilter === void 0 && R(o, s, "customFilter"), c.requiresSort && i.customSort === void 0 && R(o, s, "customSort");
       return;
     }
-    i.formatter !== void 0 && w(o, s, "formatter"), i.customFilter !== void 0 && w(o, s, "customFilter"), i.customSort !== void 0 && w(o, s, "customSort");
+    i.formatter !== void 0 && L(o, s, "formatter"), i.customFilter !== void 0 && L(o, s, "customFilter"), i.customSort !== void 0 && L(o, s, "customSort");
   }), o;
 }
 function p(e) {
@@ -387,21 +387,21 @@ function T(e) {
     })
   );
 }
-function ke(e = "property") {
+function Oe(e = "property") {
   return t.fn(
     ({ property: n }) => y.createElement("div", {
       "data-testid": `${e}-${String(n)}`
     })
   );
 }
-function Fe(e = "data-src") {
+function Ee(e = "data-src") {
   return t.fn(
     ({ src: n }) => y.createElement("span", {
       [e]: String(n)
     })
   );
 }
-function Ee(e = "divider") {
+function Fe(e = "divider") {
   return t.fn(
     ({ customVariant: n, orientation: o }) => y.createElement("div", {
       "data-testid": e,
@@ -410,7 +410,7 @@ function Ee(e = "divider") {
     })
   );
 }
-function Oe(e = "nav-link") {
+function ke(e = "nav-link") {
   return t.fn(
     ({ children: n, reloadDocument: o, text: r, to: a, ...i }) => y.createElement(
       "a",
@@ -444,7 +444,7 @@ function Ie(e = "window-base") {
     )
   );
 }
-function Le({
+function _e({
   testId: e,
   disabledProp: n = "disabled",
   handlerProp: o = "onClick",
@@ -490,7 +490,7 @@ function C() {
     testProps: e
   }));
 }
-function R(e) {
+function w(e) {
   return typeof e == "string" ? JSON.stringify(e) : $(e, {
     depth: 4,
     breakLength: 1 / 0,
@@ -498,9 +498,9 @@ function R(e) {
     sorted: !0
   });
 }
-function M(e, n, o, r, a) {
+function P(e, n, o, r, a) {
   e.push(
-    `${n} ${o}: expected ${R(r)}, got ${R(a)}`
+    `${n} ${o}: expected ${w(r)}, got ${w(a)}`
   );
 }
 function rt(e, n) {
@@ -513,37 +513,37 @@ function rt(e, n) {
       o.push(`${s} missing field at index ${a}`);
       return;
     }
-    if (i.name !== r.name && M(
+    if (i.name !== r.name && P(
       o,
       s,
       "name",
       r.name,
       i.name
-    ), g(i.dictionaryId, r.dictionaryId) || M(
+    ), g(i.dictionaryId, r.dictionaryId) || P(
       o,
       s,
       "dictionaryId",
       r.dictionaryId,
       i.dictionaryId
-    ), i.type !== r.type && M(
+    ), i.type !== r.type && P(
       o,
       s,
       "type",
       r.type,
       i.type
-    ), g(i.multiple, r.multiple) || M(
+    ), g(i.multiple, r.multiple) || P(
       o,
       s,
       "multiple",
       r.multiple,
       i.multiple
-    ), g(i.presence, r.presence) || M(
+    ), g(i.presence, r.presence) || P(
       o,
       s,
       "presence",
       r.presence,
       i.presence
-    ), r.defaultOperator !== void 0 && !g(i.defaultOperator, r.defaultOperator) && M(
+    ), r.defaultOperator !== void 0 && !g(i.defaultOperator, r.defaultOperator) && P(
       o,
       s,
       "defaultOperator",
@@ -552,19 +552,19 @@ function rt(e, n) {
     ), r.restritcOperatorsTo !== void 0 && !g(
       i.restritcOperatorsTo,
       r.restritcOperatorsTo
-    ) && M(
+    ) && P(
       o,
       s,
       "restritcOperatorsTo",
       r.restritcOperatorsTo,
       i.restritcOperatorsTo
-    ), r.defaultOperand1 !== void 0 && !g(i.defaultOperand1, r.defaultOperand1) && M(
+    ), r.defaultOperand1 !== void 0 && !g(i.defaultOperand1, r.defaultOperand1) && P(
       o,
       s,
       "defaultOperand1",
       r.defaultOperand1,
       i.defaultOperand1
-    ), r.urlIcon !== void 0 && !g(i.urlIcon, r.urlIcon) && M(
+    ), r.urlIcon !== void 0 && !g(i.urlIcon, r.urlIcon) && P(
       o,
       s,
       "urlIcon",
@@ -580,7 +580,7 @@ function rt(e, n) {
       r.selectAsyncOptions && !g(
         i.selectAsyncOptions,
         r.selectAsyncOptions
-      ) && M(
+      ) && P(
         o,
         s,
         "selectAsyncOptions",
@@ -589,13 +589,13 @@ function rt(e, n) {
       );
     }
   }), o) : (o.push(
-    `[fields] type: expected "array", got ${R(typeof e)}`
+    `[fields] type: expected "array", got ${w(typeof e)}`
   ), o);
 }
-function _e(e = O) {
+function Re(e = k) {
   return globalThis[e];
 }
-function we(e) {
+function Le(e) {
   return e === void 0 ? "" : JSON.stringify(e);
 }
 function V(e) {
@@ -606,7 +606,7 @@ function V(e) {
     sorted: !0
   });
 }
-function F(e, n, o, r, a) {
+function E(e, n, o, r, a) {
   e.push(
     `${n} ${o}: expected ${V(r)}, got ${V(a)}`
   );
@@ -621,31 +621,31 @@ function nt(e, n) {
       o.push(`${s} missing field at index ${a}`);
       return;
     }
-    i.name !== r.name && F(
+    i.name !== r.name && E(
       o,
       s,
       "name",
       r.name,
       i.name
-    ), g(i.dictionaryId, r.dictionaryId) || F(
+    ), g(i.dictionaryId, r.dictionaryId) || E(
       o,
       s,
       "dictionaryId",
       r.dictionaryId,
       i.dictionaryId
-    ), i.type !== r.type && F(
+    ), i.type !== r.type && E(
       o,
       s,
       "type",
       r.type,
       i.type
-    ), g(i.presence, r.presence) || F(
+    ), g(i.presence, r.presence) || E(
       o,
       s,
       "presence",
       r.presence,
       i.presence
-    ), r.urlIcon !== void 0 && !g(i.urlIcon, r.urlIcon) && F(
+    ), r.urlIcon !== void 0 && !g(i.urlIcon, r.urlIcon) && E(
       o,
       s,
       "urlIcon",
@@ -656,7 +656,7 @@ function nt(e, n) {
     `[fields] type: expected "array", got ${V(typeof e)}`
   ), o);
 }
-function Re() {
+function we() {
   return {
     hashLayers: {},
     mapActions: {
@@ -711,7 +711,7 @@ function at({
     console.error = n;
   });
 }
-function st(e = O) {
+function st(e = k) {
   globalThis[e] = {
     current: null
   };
@@ -795,7 +795,7 @@ function ct({
 function W({
   baseModule: e = {},
   moduleOverrides: n = {},
-  submitRefGlobalKey: o = O
+  submitRefGlobalKey: o = k
 } = {}) {
   const r = e.createValidationPartialObject, a = e.createValidationFullObject, i = e.createValidationSchema, s = e.getStepsAndValidationSchema;
   return {
@@ -803,7 +803,7 @@ function W({
     Accordion: p("accordion"),
     ContainerFlow: S("container-flow"),
     ActionsGroup: p("actions-group"),
-    Divider: Ee(),
+    Divider: Fe(),
     ChipStatusFormatter: t.fn(({ label: c }) => /* @__PURE__ */ u("div", { "data-testid": "chip-status-formatter", children: c ?? "" })),
     BooleanFormatter: t.fn(({ value: c }) => /* @__PURE__ */ u("div", { "data-testid": "boolean-formatter", children: `${c ?? ""}` })),
     DateFormatter: t.fn(({ value: c }) => `${c ?? ""}`),
@@ -813,9 +813,9 @@ function W({
     getTypographyStyles: t.fn(() => ({})),
     getComponentClasses: t.fn(
       (c, d) => (Array.isArray(d) ? d : Object.keys(d)).reduce(
-        (m, P) => ({
+        (m, M) => ({
           ...m,
-          [P]: P
+          [M]: M
         }),
         {}
       )
@@ -847,7 +847,7 @@ function W({
         onSubmit: d,
         statusLoad: l
       }) => {
-        const m = _e(o);
+        const m = Re(o);
         return m && d && (m.current = d), /* @__PURE__ */ u(
           "div",
           {
@@ -884,10 +884,10 @@ function W({
     DataGrid: t.fn(({ children: c }) => /* @__PURE__ */ u("div", { "data-testid": "data-grid", children: c })),
     Stack: v("stack"),
     Button: t.fn(
-      ({ children: c, disabled: d, label: l, onClick: m, "data-testid": P }) => /* @__PURE__ */ u(
+      ({ children: c, disabled: d, label: l, onClick: m, "data-testid": M }) => /* @__PURE__ */ u(
         "button",
         {
-          "data-testid": typeof P == "string" ? P : "button",
+          "data-testid": typeof M == "string" ? M : "button",
           disabled: !!d,
           onClick: m,
           children: String(l ?? c ?? "")
@@ -898,7 +898,7 @@ function W({
     WindowBase: Ie(),
     Card: v("card"),
     Typography: v("typography"),
-    NavLink: Oe(),
+    NavLink: ke(),
     Tooltip: t.fn(
       ({
         children: c,
@@ -931,8 +931,8 @@ function W({
         }
       )
     ),
-    Icon: Fe(),
-    ReactJsonViewer: t.fn(({ data: c }) => /* @__PURE__ */ u("div", { "data-testid": "react-json-view", children: we(c) })),
+    Icon: Ee(),
+    ReactJsonViewer: t.fn(({ data: c }) => /* @__PURE__ */ u("div", { "data-testid": "react-json-view", children: Le(c) })),
     TabsNavigator: S("tabs-navigator", "TabsNavigator"),
     DistanceToNowFormatter: t.fn(
       ({
@@ -967,7 +967,7 @@ function W({
       (c, d, l) => d.filter((m) => c.has(l(m)))
     ),
     PaperForm: Ce(),
-    PropertyValue: ke(),
+    PropertyValue: Oe(),
     RHFColorPicker: T("rhf-color"),
     RHFCheckbox: T("rhf-checkbox"),
     RHFHelperError: T("rhf-helper"),
@@ -995,7 +995,7 @@ function W({
     StepperNextButton: S("stepper-next"),
     StepperPrevButton: S("stepper-prev"),
     StepperSubmitButton: S("stepper-submit"),
-    StepperCancelButton: Le({
+    StepperCancelButton: _e({
       testId: "stepper-cancel-button",
       handlerProp: "onClose",
       labelProp: "children"
@@ -1013,7 +1013,7 @@ function W({
 function dt({
   baseModule: e = {},
   moduleOverrides: n = {},
-  submitRefGlobalKey: o = O
+  submitRefGlobalKey: o = k
 } = {}) {
   return {
     ...W({ baseModule: e, submitRefGlobalKey: o }),
@@ -1106,7 +1106,14 @@ function ut({
     RHFRadioGroup: t.fn(() => null)
   };
 }
-function ft({
+function ft() {
+  return {
+    MF_ACTION_REQUEST_PARAM: "mfActionRequest",
+    completeMFAction: t.fn(),
+    isMFActionRequest: t.fn(() => !1)
+  };
+}
+function lt({
   baseModule: e = {},
   baseStoreState: n,
   environmentData: o,
@@ -1124,7 +1131,7 @@ function ft({
   const m = x({
     ...U,
     ...o
-  }), P = r ?? B(), h = ee(
+  }), M = r ?? B(), h = ee(
     s
   ), b = te(s), K = n ?? {}, z = l ?? {
     flagsActions: {
@@ -1170,16 +1177,16 @@ function ft({
       EMMIT_EVENT_HOST_EMERGE_WINDOW: "EMMIT_EVENT_HOST_EMERGE_WINDOW"
     },
     getPropertyByString: t.fn(
-      (f, I, L) => {
+      (f, I, _) => {
         if (f == null)
-          return L;
+          return _;
         try {
           return I.split(".").reduce(
             (Z, X) => Z?.[X],
             f
-          ) ?? L;
+          ) ?? _;
         } catch {
-          return L;
+          return _;
         }
       }
     ),
@@ -1195,7 +1202,7 @@ function ft({
     useFlagsStore: t.fn(
       (f) => f(z)
     ),
-    useHostTools: t.fn(() => P),
+    useHostTools: t.fn(() => M),
     useModuleDictionary: t.fn(() => ({
       getLabel: t.fn(i),
       getModuleLabel: t.fn(() => a)
@@ -1238,7 +1245,7 @@ function ft({
     ...c
   };
 }
-function lt({
+function pt({
   baseModule: e = {},
   moduleOverrides: n = {}
 } = {}) {
@@ -1301,7 +1308,7 @@ function lt({
     ...n
   };
 }
-function pt({
+function mt({
   baseModule: e = {},
   moduleOverrides: n = {}
 } = {}) {
@@ -1340,7 +1347,7 @@ function pt({
     ...n
   };
 }
-function mt({
+function yt({
   createComponentFieldImplementation: e
 } = {}) {
   return {
@@ -1351,7 +1358,7 @@ function mt({
     )
   };
 }
-function yt({
+function gt({
   baseModule: e = {},
   domEventData: n,
   moduleOverrides: o = {},
@@ -1375,7 +1382,7 @@ function yt({
     ...o
   };
 }
-function gt({
+function vt({
   baseModule: e = {},
   dataGridPersistenceData: n,
   dynamicFilterAndSortData: o,
@@ -1406,7 +1413,7 @@ function gt({
     popupsActions: {
       addPopup: t.fn()
     }
-  }, P = s ?? {
+  }, M = s ?? {
     getCookie: t.fn(),
     getWindowId: t.fn(() => "test-window-id"),
     setCookie: t.fn(),
@@ -1424,11 +1431,11 @@ function gt({
     ),
     useWatchTyped: t.fn(() => {
     }),
-    useWindowToolsMF: t.fn(() => P),
+    useWindowToolsMF: t.fn(() => M),
     ...a
   };
 }
-function vt({
+function ht({
   baseModule: e = {},
   environmentData: n,
   getLabel: o = (d, l) => l ? `label:${d}:${l}` : `label:${d}`,
@@ -1443,7 +1450,7 @@ function vt({
     ...n
   }), l = r ?? B(), m = s ?? {
     hasPrivilege: t.fn(() => !0)
-  }, P = c ?? {
+  }, M = c ?? {
     networkOperation: t.fn()
   };
   return {
@@ -1459,17 +1466,17 @@ function vt({
     })),
     useModulePrivileges: t.fn(() => m),
     useModuleSkeleton: t.fn(() => !1),
-    useNetwork: t.fn(() => P),
+    useNetwork: t.fn(() => M),
     ...a
   };
 }
-function ht({
+function St({
   baseModule: e = {},
   mapStoreState: n,
   moduleOverrides: o = {}
 } = {}) {
   const r = {
-    ...Re(),
+    ...we(),
     ...n
   };
   return {
@@ -1537,16 +1544,30 @@ function ht({
     ...o
   };
 }
+function Mt() {
+  const e = { scopeKey: "test-scope", refreshKey: void 0 }, n = {
+    scopeKey: "test-scope",
+    publishResourceChange: t.fn(async (r) => r.operationId ?? "operation-test"),
+    reportFailure: t.fn()
+  }, o = t.fn(async () => ({ status: "cancelled" }));
+  return {
+    PERSONS_RESOURCE: "rt_persons",
+    PROTOCOL_PERSON_REPORT_METHODS_RESOURCE: "rt_protocol_person_report_methods",
+    useResourceInvalidation: t.fn(() => e),
+    useResourceMutation: t.fn(() => n),
+    useEntityReferenceAdd: t.fn(() => o)
+  };
+}
 const He = "#1E96DC", Ne = /* @__PURE__ */ new Set(["state", "updatedAt", "value"]);
 var G = /* @__PURE__ */ ((e) => (e[e.off = 0] = "off", e[e.moving = 1] = "moving", e[e.stopped = 2] = "stopped", e[e.stoppedRalenti = 3] = "stoppedRalenti", e[e.stoppedExcesiveRalenti = 4] = "stoppedExcesiveRalenti", e[e.towing = 5] = "towing", e[e.powerSaving = 6] = "powerSaving", e[e.maxSpeed = 7] = "maxSpeed", e[e.notDetectable = 250] = "notDetectable", e))(G || {}), J = /* @__PURE__ */ ((e) => (e[e.reliable = 0] = "reliable", e[e.acceptable = 1] = "acceptable", e[e.noSignal = 2] = "noSignal", e))(J || {});
-function E(e) {
+function F(e) {
   if (typeof e != "object" || e === null || Array.isArray(e))
     return !1;
   const n = Object.getPrototypeOf(e);
   return n === Object.prototype || n === null;
 }
 function N(e) {
-  return E(e) ? Object.keys(e).some((n) => Ne.has(n)) : !1;
+  return F(e) ? Object.keys(e).some((n) => Ne.has(n)) : !1;
 }
 function qe(e, n) {
   const o = e.updatedAt, r = n.updatedAt;
@@ -1580,7 +1601,7 @@ function j(e, n) {
       };
     if (Array.isArray(n))
       return n;
-    if (E(e) && E(n)) {
+    if (F(e) && F(n)) {
       let o = n, r = !1;
       return Object.entries(n).forEach(([a, i]) => {
         const s = j(
@@ -1598,9 +1619,9 @@ function Ue(e, n) {
     e,
     n
   );
-  return E(o) ? o : n;
+  return F(o) ? o : n;
 }
-function St({
+function Pt({
   baseModule: e = {},
   moduleOverrides: n = {},
   surface: o = "root"
@@ -1622,7 +1643,7 @@ function St({
     ...n
   };
 }
-function Pt({
+function At({
   baseModule: e = {},
   moduleOverrides: n = {}
 } = {}) {
@@ -1648,7 +1669,7 @@ function Pt({
     ...n
   };
 }
-function Mt({
+function bt({
   baseModule: e = {},
   moduleOverrides: n = {}
 } = {}) {
@@ -1684,7 +1705,7 @@ function Mt({
     ...n
   };
 }
-function At({
+function Tt({
   baseModule: e = {},
   moduleOverrides: n = {},
   useFormContextData: o = {}
@@ -1707,12 +1728,12 @@ function At({
     ...n
   };
 }
-function bt() {
+function Ct() {
   return {
     Resizable: t.fn(({ children: e }) => /* @__PURE__ */ u("div", { "data-testid": "resizable", children: e }))
   };
 }
-function Tt({
+function Dt({
   baseModule: e = {},
   moduleOverrides: n = {},
   useMapData: o,
@@ -1810,10 +1831,11 @@ function Tt({
   };
 }
 export {
+  Dt as $,
   H as A,
   ot as B,
   it as C,
-  O as D,
+  k as D,
   at as E,
   st as F,
   ct as G,
@@ -1824,18 +1846,19 @@ export {
   pt as L,
   ne as M,
   mt as N,
-  W as O,
-  yt as P,
-  $e as Q,
-  gt as R,
+  yt as O,
+  W as P,
+  gt as Q,
+  $e as R,
   vt as S,
   ht as T,
   St as U,
-  Pt as V,
-  Mt as W,
+  Mt as V,
+  Pt as W,
   At as X,
   bt as Y,
   Tt as Z,
+  Ct as _,
   oe as a,
   ie as b,
   ae as c,
@@ -1849,17 +1872,17 @@ export {
   v as k,
   De as l,
   T as m,
-  ke as n,
-  Fe as o,
-  Ee as p,
-  Oe as q,
+  Oe as n,
+  Ee as o,
+  Fe as p,
+  ke as q,
   Ie as r,
-  Le as s,
+  _e as s,
   tt as t,
   C as u,
   rt as v,
-  _e as w,
-  we as x,
+  Re as w,
+  Le as x,
   nt as y,
-  Re as z
+  we as z
 };

package/index.js

@@ -1,78 +1,80 @@
 import { act as o } from "react";
-import { afterAll as r, afterEach as c, beforeAll as s, beforeEach as M, describe as l, expect as n, it as i, test as k, vi as p } from "vitest";
+import { afterAll as r, afterEach as c, beforeAll as s, beforeEach as M, describe as l, expect as n, it as i, test as k, vi as d } from "vitest";
 import { cleanup as u, fireEvent as m, renderHook as C, screen as f, waitFor as g, within as A } from "@testing-library/react";
 import { default as E } from "@testing-library/user-event";
-import { c as S } from "./chunks/render-CsuV8xqo.js";
-import { D as x, a as L, M as R, f as D, v as _, y as G, s as h, k as b, h as B, u as H, z as I, p as O, l as T, o as w, P as y, G as N, H as W, J as K, I as U, N as V, K as z, L as Y, O as Z, Q as j, R as q, S as J, T as Q, U as X, V as $, W as ee, m as ae, q as oe, j as te, n as re, Y as ce, X as se, Z as Me, i as le, t as ne, r as ie, d as ke, b as pe, c as de, e as ue, g as me, B as Ce, A as fe, C as ge, w as Ae, E as Fe, F as Ee, x as Pe } from "./chunks/reactLeaflet-Ca5S8G_T.js";
+import { c as v } from "./chunks/render-CsuV8xqo.js";
+import { D as R, a as x, M as L, f as _, v as D, y as h, s as G, k as O, h as b, u as B, z as H, p as I, l as y, o as T, Q as w, G as N, H as W, K, I as z, O as U, L as V, N as Y, P as Z, J as j, R as q, S as J, T as Q, U as X, W as $, X as ee, Y as ae, V as oe, m as te, q as re, j as ce, n as se, _ as Me, Z as le, $ as ne, i as ie, t as ke, r as de, d as pe, b as ue, c as me, e as Ce, g as fe, B as ge, A as Ae, C as Fe, w as Ee, E as Pe, F as ve, x as Se } from "./chunks/reactLeaflet-CYEpmWXL.js";
 export {
-  x as DEFAULT_RHF_SUBMIT_REF_GLOBAL_KEY,
-  L as M4L_APP_DATAGRID_SEMANTIC_WIDTHS,
-  R as M4L_APP_WINDOW_SIZES,
+  R as DEFAULT_RHF_SUBMIT_REF_GLOBAL_KEY,
+  x as M4L_APP_DATAGRID_SEMANTIC_WIDTHS,
+  L as M4L_APP_WINDOW_SIZES,
   o as act,
   r as afterAll,
   c as afterEach,
-  D as assertColumnConfigs,
-  _ as assertFilterFields,
-  G as assertSortFields,
+  _ as assertColumnConfigs,
+  D as assertFilterFields,
+  h as assertSortFields,
   s as beforeAll,
   M as beforeEach,
   u as cleanup,
-  h as createActionButtonComponentMock,
-  b as createChildrenContainerComponentMock,
-  B as createChildrenDivComponentMock,
-  H as createDataGridColumnHookMock,
-  I as createDefaultM4lPackageGclickMapStoreState,
-  O as createDividerComponentMock,
-  T as createHelmetPageComponentMock,
-  w as createIconComponentMock,
-  y as createLeafletModuleMock,
+  G as createActionButtonComponentMock,
+  O as createChildrenContainerComponentMock,
+  b as createChildrenDivComponentMock,
+  B as createDataGridColumnHookMock,
+  H as createDefaultM4lPackageGclickMapStoreState,
+  I as createDividerComponentMock,
+  y as createHelmetPageComponentMock,
+  T as createIconComponentMock,
+  w as createLeafletModuleMock,
   N as createM4lAppBaseModuleMock,
   W as createM4lAppComponentsModuleMock,
   K as createM4lAppCoreModuleMock,
-  U as createM4lAppFormComponentsModuleOverrides,
-  V as createM4lAppFormLayoutsModuleOverrides,
-  z as createM4lAppGraphicsModuleMock,
+  z as createM4lAppFormComponentsModuleOverrides,
+  U as createM4lAppFormLayoutsModuleOverrides,
+  V as createM4lAppGraphicsModuleMock,
   Y as createM4lAppLayoutsModuleMock,
   Z as createM4lBaseComponentsModuleMock,
-  j as createM4lPackageBaseModuleMock,
-  q as createM4lPackageComponentsModuleMock,
-  J as createM4lPackageCoreModuleMock,
-  Q as createM4lPackageGclickModuleMock,
-  X as createM4lPackageGclickRealtimeModuleMock,
-  $ as createM4lPackageGraphicsModuleMock,
-  ee as createM4lPackageLayoutsModuleMock,
-  ae as createNamedFieldComponentMock,
-  oe as createNavLinkComponentMock,
-  te as createPaperFormComponentMock,
-  re as createPropertyValueComponentMock,
-  ce as createReResizableModuleMock,
-  se as createReactHookFormModuleMock,
-  Me as createReactLeafletModuleMock,
-  le as createStaticDivComponentMock,
-  ne as createSuspenseLoadableComponentMock,
-  ie as createWindowBaseComponentMock,
-  ke as defaultM4lAppEnvironmentOverrides,
-  pe as defaultM4lPackageEnvironmentOverrides,
+  j as createM4lMFActionModuleOverrides,
+  q as createM4lPackageBaseModuleMock,
+  J as createM4lPackageComponentsModuleMock,
+  Q as createM4lPackageCoreModuleMock,
+  X as createM4lPackageGclickModuleMock,
+  $ as createM4lPackageGclickRealtimeModuleMock,
+  ee as createM4lPackageGraphicsModuleMock,
+  ae as createM4lPackageLayoutsModuleMock,
+  oe as createM4lResourceSynchronizationModuleOverrides,
+  te as createNamedFieldComponentMock,
+  re as createNavLinkComponentMock,
+  ce as createPaperFormComponentMock,
+  se as createPropertyValueComponentMock,
+  Me as createReResizableModuleMock,
+  le as createReactHookFormModuleMock,
+  ne as createReactLeafletModuleMock,
+  ie as createStaticDivComponentMock,
+  ke as createSuspenseLoadableComponentMock,
+  de as createWindowBaseComponentMock,
+  pe as defaultM4lAppEnvironmentOverrides,
+  ue as defaultM4lPackageEnvironmentOverrides,
   l as describe,
-  de as distanceToNowFormatterFixture,
+  me as distanceToNowFormatterFixture,
   n as expect,
   m as fireEvent,
-  ue as gclickGnssMotionStatusEnumFixture,
-  me as gclickGnssSignalEnumFixture,
-  Ce as getMissingModuleMockExports,
-  fe as getModuleExportContractKind,
-  ge as getModuleMockKindMismatches,
-  Ae as getRHFSubmitRef,
-  Fe as installConsoleErrorFilter,
-  Ee as installRhfOnSubmitRef,
+  Ce as gclickGnssMotionStatusEnumFixture,
+  fe as gclickGnssSignalEnumFixture,
+  ge as getMissingModuleMockExports,
+  Ae as getModuleExportContractKind,
+  Fe as getModuleMockKindMismatches,
+  Ee as getRHFSubmitRef,
+  Pe as installConsoleErrorFilter,
+  ve as installRhfOnSubmitRef,
   i as it,
-  S as render,
+  v as render,
   C as renderHook,
   f as screen,
-  Pe as stringifyViewerData,
+  Se as stringifyViewerData,
   k as test,
   E as userEvent,
-  p as vi,
+  d as vi,
   g as waitFor,
   A as within
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/testing",
-  "version": "1.2.0",
+  "version": "1.2.1-beta-docs-autocomplete-async-with-add-mf-sync.0",
   "description": "Shared M4L testing contracts for React, Vitest and Playwright",
   "license": "UNLICENSED",
   "engines": {

package/types/packages/testing/vitest/src/factories/app/m4lAppComponents.d.ts

@@ -1,4 +1,4 @@
-import type { CreateM4lAppComponentsModuleMockOptions, CreateM4lAppFormComponentsModuleOverridesOptions, VitestModuleMockExports } from '../../types';
+import type { CreateM4lAppComponentsModuleMockOptions, CreateM4lAppFormComponentsModuleOverridesOptions, MFActionModuleOverrides, VitestModuleMockExports } from '../../types';
 /**
  * Builds the shared `@m4l/components` mock payload used by M4L app test
  * setups.
@@ -18,3 +18,5 @@ export declare function createM4lAppComponentsModuleMock({ baseModule, moduleOve
  * `moduleOverrides` payloads.
  */
 export declare function createM4lAppFormComponentsModuleOverrides({ dynamicMFParameters, }?: CreateM4lAppFormComponentsModuleOverridesOptions): VitestModuleMockExports;
+/** Isolate MF completion observers for app tests while leaving the standard factory's real exports intact. */
+export declare function createM4lMFActionModuleOverrides(): MFActionModuleOverrides;

package/types/packages/testing/vitest/src/factories/packages/m4lPackageGclick.d.ts

@@ -1,4 +1,4 @@
-import type { CreateM4lPackageGclickModuleMockOptions, VitestModuleMockExports } from '../../types';
+import type { CreateM4lPackageGclickModuleMockOptions, ResourceSynchronizationModuleOverrides, VitestModuleMockExports } from '../../types';
 /**
  * Builds the shared `@m4l/gclick` mock payload used by tests that depend on
  * the exact runtime package.
@@ -8,3 +8,5 @@ import type { CreateM4lPackageGclickModuleMockOptions, VitestModuleMockExports }
  * on orchestration logic.
  */
 export declare function createM4lPackageGclickModuleMock({ baseModule, mapStoreState, moduleOverrides, }?: CreateM4lPackageGclickModuleMockOptions): VitestModuleMockExports;
+/** Supply isolated resource hooks and stable identities without loading unrelated GClick feature runtimes. */
+export declare function createM4lResourceSynchronizationModuleOverrides(): ResourceSynchronizationModuleOverrides;

package/types/packages/testing/vitest/src/types.d.ts

@@ -1,5 +1,6 @@
 import type { EnvironmentFixture, HostToolsFixture, UserPreferencesFixture } from '../../mocks/src/index';
 import type React from 'react';
+import type { Mock } from 'vitest';
 export type UnknownRecord = Record<string, unknown>;
 export type VitestModuleMockExports = Record<string, unknown>;
 export type PropsWithChildren = {
@@ -67,6 +68,12 @@ export interface CreateM4lAppComponentsModuleMockOptions extends CreateVitestMod
 export interface CreateM4lAppFormComponentsModuleOverridesOptions {
     dynamicMFParameters?: UnknownRecord;
 }
+/** Describe opt-in MF completion collaborators without importing the runtime component package. */
+export type MFActionModuleOverrides = {
+    MF_ACTION_REQUEST_PARAM: 'mfActionRequest';
+    completeMFAction: Mock<(hostTools: unknown, request: unknown, outcome: unknown) => void>;
+    isMFActionRequest: Mock<(value: unknown) => boolean>;
+};
 export interface CreateM4lAppFormLayoutsModuleOverridesOptions {
     createComponentFieldImplementation?: (field: UnknownRecord) => unknown;
 }
@@ -95,6 +102,31 @@ export type CreateM4lPackageGraphicsModuleMockOptions = CreateVitestModuleMockOp
 export interface CreateM4lPackageGclickModuleMockOptions extends CreateVitestModuleMockOptions {
     mapStoreState?: UnknownRecord;
 }
+/** Mirrors the committed-mutation input needed by resource synchronization mocks. */
+export interface ResourceMutationMockInput {
+    mutation: 'created' | 'updated' | 'deleted' | 'revalidate';
+    entityId: string;
+    operationId?: string;
+    requestId?: string;
+    requesterWindowId?: string;
+}
+/** Names resource-hook mocks through Vitest's public types for portable declarations. */
+export type ResourceSynchronizationModuleOverrides = {
+    PERSONS_RESOURCE: 'rt_persons';
+    PROTOCOL_PERSON_REPORT_METHODS_RESOURCE: 'rt_protocol_person_report_methods';
+    useResourceInvalidation: Mock<() => {
+        scopeKey: string;
+        refreshKey: string | undefined;
+    }>;
+    useResourceMutation: Mock<() => {
+        scopeKey: string;
+        publishResourceChange: Mock<(change: ResourceMutationMockInput) => Promise<string>>;
+        reportFailure: Mock;
+    }>;
+    useEntityReferenceAdd: Mock<() => Mock<() => Promise<{
+        status: 'cancelled';
+    }>>>;
+};
 export interface CreateM4lPackageGclickRealtimeModuleMockOptions extends CreateVitestModuleMockOptions {
     surface?: 'root' | 'payload' | 'contracts';
 }

package/vitest/index.js

@@ -1,4 +1,4 @@
-import { D as o, a as t, M as c, f as s, v as r, y as M, s as l, k as n, h as i, u as k, z as p, p as d, l as u, o as m, P as C, G as g, H as F, J as A, I as P, N as S, K as E, L, O as R, Q as f, R as D, S as _, T as v, U as G, V as B, W as I, m as O, q as h, j as x, n as H, Y as T, X as y, Z as N, i as b, t as W, r as w, d as K, b as U, c as V, e as z, g as Y, B as Z, A as j, C as q, w as J, E as Q, F as X, x as $ } from "../chunks/reactLeaflet-Ca5S8G_T.js";
+import { D as o, a as t, M as c, f as s, v as r, y as M, s as l, k as n, h as i, u as k, z as d, p as u, l as p, o as m, Q as C, G as g, H as F, K as A, I as P, O as S, L as R, N as v, P as E, J as L, R as _, S as f, T as D, U as G, W as O, X as h, Y as B, V as I, m as x, q as y, j as H, n as T, _ as N, Z as b, $ as W, i as w, t as K, r as z, d as U, b as V, c as Y, e as Z, g as j, B as q, A as J, C as Q, w as X, E as $, F as ee, x as ae } from "../chunks/reactLeaflet-CYEpmWXL.js";
 export {
   o as DEFAULT_RHF_SUBMIT_REF_GLOBAL_KEY,
   t as M4L_APP_DATAGRID_SEMANTIC_WIDTHS,
@@ -10,9 +10,9 @@ export {
   n as createChildrenContainerComponentMock,
   i as createChildrenDivComponentMock,
   k as createDataGridColumnHookMock,
-  p as createDefaultM4lPackageGclickMapStoreState,
-  d as createDividerComponentMock,
-  u as createHelmetPageComponentMock,
+  d as createDefaultM4lPackageGclickMapStoreState,
+  u as createDividerComponentMock,
+  p as createHelmetPageComponentMock,
   m as createIconComponentMock,
   C as createLeafletModuleMock,
   g as createM4lAppBaseModuleMock,
@@ -20,36 +20,38 @@ export {
   A as createM4lAppCoreModuleMock,
   P as createM4lAppFormComponentsModuleOverrides,
   S as createM4lAppFormLayoutsModuleOverrides,
-  E as createM4lAppGraphicsModuleMock,
-  L as createM4lAppLayoutsModuleMock,
-  R as createM4lBaseComponentsModuleMock,
-  f as createM4lPackageBaseModuleMock,
-  D as createM4lPackageComponentsModuleMock,
-  _ as createM4lPackageCoreModuleMock,
-  v as createM4lPackageGclickModuleMock,
-  G as createM4lPackageGclickRealtimeModuleMock,
-  B as createM4lPackageGraphicsModuleMock,
-  I as createM4lPackageLayoutsModuleMock,
-  O as createNamedFieldComponentMock,
-  h as createNavLinkComponentMock,
-  x as createPaperFormComponentMock,
-  H as createPropertyValueComponentMock,
-  T as createReResizableModuleMock,
-  y as createReactHookFormModuleMock,
-  N as createReactLeafletModuleMock,
-  b as createStaticDivComponentMock,
-  W as createSuspenseLoadableComponentMock,
-  w as createWindowBaseComponentMock,
-  K as defaultM4lAppEnvironmentOverrides,
-  U as defaultM4lPackageEnvironmentOverrides,
-  V as distanceToNowFormatterFixture,
-  z as gclickGnssMotionStatusEnumFixture,
-  Y as gclickGnssSignalEnumFixture,
-  Z as getMissingModuleMockExports,
-  j as getModuleExportContractKind,
-  q as getModuleMockKindMismatches,
-  J as getRHFSubmitRef,
-  Q as installConsoleErrorFilter,
-  X as installRhfOnSubmitRef,
-  $ as stringifyViewerData
+  R as createM4lAppGraphicsModuleMock,
+  v as createM4lAppLayoutsModuleMock,
+  E as createM4lBaseComponentsModuleMock,
+  L as createM4lMFActionModuleOverrides,
+  _ as createM4lPackageBaseModuleMock,
+  f as createM4lPackageComponentsModuleMock,
+  D as createM4lPackageCoreModuleMock,
+  G as createM4lPackageGclickModuleMock,
+  O as createM4lPackageGclickRealtimeModuleMock,
+  h as createM4lPackageGraphicsModuleMock,
+  B as createM4lPackageLayoutsModuleMock,
+  I as createM4lResourceSynchronizationModuleOverrides,
+  x as createNamedFieldComponentMock,
+  y as createNavLinkComponentMock,
+  H as createPaperFormComponentMock,
+  T as createPropertyValueComponentMock,
+  N as createReResizableModuleMock,
+  b as createReactHookFormModuleMock,
+  W as createReactLeafletModuleMock,
+  w as createStaticDivComponentMock,
+  K as createSuspenseLoadableComponentMock,
+  z as createWindowBaseComponentMock,
+  U as defaultM4lAppEnvironmentOverrides,
+  V as defaultM4lPackageEnvironmentOverrides,
+  Y as distanceToNowFormatterFixture,
+  Z as gclickGnssMotionStatusEnumFixture,
+  j as gclickGnssSignalEnumFixture,
+  q as getMissingModuleMockExports,
+  J as getModuleExportContractKind,
+  Q as getModuleMockKindMismatches,
+  X as getRHFSubmitRef,
+  $ as installConsoleErrorFilter,
+  ee as installRhfOnSubmitRef,
+  ae as stringifyViewerData
 };