@m4l/components 9.79.1 → 9.80.1-beta-docs-autocomplete-async-with-add-mf-sync.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/components",
-  "version": "9.79.1",
+  "version": "9.80.1-beta-docs-autocomplete-async-with-add-mf-sync.0",
   "publishConfig": {
     "access": "public"
   },
@@ -55,20 +55,20 @@
     "react-transition-group": "4.4.5",
     "@tanstack/react-virtual": "3.13.23",
     "react-color": "2.19.3",
-    "react-draggable": "4.5.0",
-    "react-dropzone": "14.4.1",
     "@mui/x-date-pickers": "6.20.2",
     "react-rnd": "10.5.2",
     "react-spinners": "0.13.8",
+    "react-dropzone": "14.4.1",
+    "react-draggable": "4.5.0",
     "chart.js": "4.5.1",
     "chartjs-chart-error-bars": "4.4.5",
     "qrcode.react": "3.2.0",
-    "react-simple-code-editor": "0.14.1",
-    "simplebar-react": "3.2.6",
-    "react-resizable-panels": "2.1.9",
     "react-data-grid": "7.0.0-beta.47",
     "react-dnd": "16.0.1",
     "react-dnd-html5-backend": "16.0.1",
+    "react-resizable-panels": "2.1.9",
+    "react-simple-code-editor": "0.14.1",
+    "simplebar-react": "3.2.6",
     "date-fns": "2.30.0",
     "react-resizable": "3.1.3",
     "react-window": "1.8.11"

package/utils/mfActions/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MF_ACTION_OPEN = "m4l:mf-action-open:v1";
+export declare const MF_ACTION_RESULT = "m4l:mf-action-result:v1";
+export declare const MF_ACTION_REQUEST_PARAM = "mfActionRequest";
+export declare const MF_ACTION_OPEN_ACK_TIMEOUT = 5000;
+export declare const MF_ACTION_CALLBACKS_PARAM = "mfActionCallbacks";
+//# sourceMappingURL=constants.d.ts.map

package/utils/mfActions/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/utils/mfActions/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,0BAA0B,CAAC;AACtD,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAC1D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,sBAAsB,CAAC"}

package/utils/mfActions/constants.js

@@ -0,0 +1,8 @@
+const A = "m4l:mf-action-open:v1", _ = "m4l:mf-action-result:v1", t = "mfActionRequest", o = 5e3, c = "mfActionCallbacks";
+export {
+  c as MF_ACTION_CALLBACKS_PARAM,
+  A as MF_ACTION_OPEN,
+  o as MF_ACTION_OPEN_ACK_TIMEOUT,
+  t as MF_ACTION_REQUEST_PARAM,
+  _ as MF_ACTION_RESULT
+};

package/utils/mfActions/index.d.ts

@@ -0,0 +1,5 @@
+export * from './constants';
+export * from './mfActions';
+export * from './openMFCallbackAction';
+export type { MFActionHostTools, MFActionOpen, MFActionOutcome, MFActionRequest, MFActionResult } from './types';
+//# sourceMappingURL=index.d.ts.map

package/utils/mfActions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/utils/mfActions/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/utils/mfActions/mfActions.d.ts

@@ -0,0 +1,10 @@
+import { MFActionHostTools, MFActionOpen, MFActionOutcome, MFActionRequest, MFActionResult } from './types';
+/** Validate the serializable request shared by one opener and its managed window. */
+export declare function isMFActionRequest(value: unknown): value is MFActionRequest;
+/** Compare the whole correlation identity before delivering an action result. */
+export declare function matchesMFAction(request: MFActionRequest, result: unknown): result is MFActionResult;
+/** Publish a terminal result only when the window carries a valid action request. */
+export declare function completeMFAction(hostTools: MFActionHostTools, request: unknown, outcome: MFActionOutcome): void;
+/** Open one request-scoped MF and release all listeners when it settles or is aborted. */
+export declare function openMFAction(hostTools: MFActionHostTools, payload: MFActionOpen, signal: AbortSignal): Promise<MFActionOutcome>;
+//# sourceMappingURL=mfActions.d.ts.map

package/utils/mfActions/mfActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mfActions.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/utils/mfActions/mfActions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjH,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAK1E;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,cAAc,CASnG;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAE/G;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAyC/H"}

package/utils/mfActions/mfActions.js

@@ -0,0 +1,47 @@
+import { MF_ACTION_RESULT as r, MF_ACTION_OPEN_ACK_TIMEOUT as I, MF_ACTION_OPEN as _, MF_ACTION_REQUEST_PARAM as m } from "./constants.js";
+function a(t) {
+  if (!t || typeof t != "object")
+    return !1;
+  const e = t;
+  return e.version === 1 && [e.requestId, e.requesterWindowId, e.moduleId, e.scopeKey].every((n) => typeof n == "string" && n.length > 0);
+}
+function w(t, e) {
+  return !a(e) || !("status" in e) || t.requestId !== e.requestId || t.requesterWindowId !== e.requesterWindowId || t.moduleId !== e.moduleId || t.scopeKey !== e.scopeKey ? !1 : e.status === "cancelled" ? !0 : e.status === "opened" ? "windowId" in e && typeof e.windowId == "string" && e.windowId.length > 0 : e.status === "failed" ? "errorCode" in e && typeof e.errorCode == "string" && e.errorCode.length > 0 : e.status === "created" && "entityId" in e && typeof e.entityId == "string" && e.entityId.length > 0 && "operationId" in e && typeof e.operationId == "string" && e.operationId.length > 0;
+}
+function A(t, e, n) {
+  a(e) && t.events_emit(r, { ...e, ...n });
+}
+function y(t, e, n) {
+  return n.aborted ? Promise.resolve({ status: "cancelled" }) : new Promise((u) => {
+    let d = !1;
+    const s = setTimeout(() => o({ status: "failed", errorCode: "host_action_unavailable" }), I);
+    function o(i) {
+      d || (d = !0, clearTimeout(s), t.events_remove_listener(r, c), n.removeEventListener("abort", f), u(i));
+    }
+    function c(i) {
+      w(e.request, i) && (i.status === "opened" ? clearTimeout(s) : o(i));
+    }
+    function f() {
+      o({ status: "cancelled" });
+    }
+    t.events_add_listener(r, c), n.addEventListener("abort", f, { once: !0 });
+    try {
+      t.events_emit(_, {
+        request: e.request,
+        window: {
+          ...e.window,
+          replaceMeId: `mf-action:${e.request.requestId}`,
+          dynamicParams: { ...e.window.dynamicParams, [m]: e.request }
+        }
+      });
+    } catch {
+      o({ status: "failed", errorCode: "host_action_open_failed" });
+    }
+  });
+}
+export {
+  A as completeMFAction,
+  a as isMFActionRequest,
+  w as matchesMFAction,
+  y as openMFAction
+};

package/utils/mfActions/openMFCallbackAction.d.ts

@@ -0,0 +1,4 @@
+import { MFActionHostTools, MFActionOpen, MFActionOutcome } from './types';
+/** Open an existing managed window and receive its saved ID through a local fullRefresh callback. */
+export declare function openMFCallbackAction(hostTools: Pick<MFActionHostTools, 'events_emit'>, window: MFActionOpen['window'], requestId: string, signal: AbortSignal): Promise<MFActionOutcome>;
+//# sourceMappingURL=openMFCallbackAction.d.ts.map

package/utils/mfActions/openMFCallbackAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openMFCallbackAction.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/utils/mfActions/openMFCallbackAction.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEnG,qGAAqG;AACrG,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACjD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,CAAC,CA4C1B"}

package/utils/mfActions/openMFCallbackAction.js

@@ -0,0 +1,36 @@
+import { EmitEvents as m } from "@m4l/core";
+import { MF_ACTION_OPEN_ACK_TIMEOUT as u, MF_ACTION_CALLBACKS_PARAM as f, MF_ACTION_REQUEST_PARAM as E } from "./constants.js";
+function A(c, s, i, o) {
+  return o.aborted ? Promise.resolve({ status: "cancelled" }) : new Promise((l) => {
+    let a = !1;
+    const e = (r) => {
+      a || (a = !0, clearTimeout(d), o.removeEventListener("abort", n), l(r));
+    }, n = () => e({ status: "cancelled" }), _ = {
+      onOpened: () => clearTimeout(d),
+      onClosed: () => e({ status: "cancelled" }),
+      onLoadError: () => e({ status: "failed", errorCode: "mf_load_failed" })
+    }, t = { ...s.dynamicParams };
+    delete t[E], delete t.resourceRefreshMode, delete t.requesterWindowId;
+    const d = setTimeout(() => e({ status: "failed", errorCode: "host_action_open_failed" }), u);
+    o.addEventListener("abort", n, { once: !0 });
+    try {
+      c.events_emit(m.EMMIT_EVENT_HOST_EMERGE_WINDOW, {
+        ...s,
+        replaceMeId: i,
+        dynamicParams: {
+          ...t,
+          [f]: _,
+          /** Deliver a committed ID once; a refresh without an ID does not complete creation. */
+          fullRefresh: (r) => {
+            r === void 0 || a || e({ status: "created", entityId: String(r), operationId: crypto.randomUUID() });
+          }
+        }
+      });
+    } catch {
+      e({ status: "failed", errorCode: "host_action_open_failed" });
+    }
+  });
+}
+export {
+  A as openMFCallbackAction
+};

package/utils/mfActions/tests/callbackHelpers.d.ts

@@ -0,0 +1,9 @@
+import { MFActionCallbacks } from '../types';
+import { ActionTestBus } from './types';
+/** Read one local launch without depending on the implementation's promise state. */
+export declare function getCallbackLaunch(bus: ActionTestBus, index?: number): {
+    window: import('../../../components/areas/types').EmmitNewPopupMFProps | Omit<import('../../../components/areas/types').AreaModalMFProps, "onClose" | "windowId" | "areaId">;
+    callbacks: MFActionCallbacks;
+    fullRefresh: (id?: number | string) => void;
+};
+//# sourceMappingURL=callbackHelpers.d.ts.map

package/utils/mfActions/tests/callbackHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbackHelpers.d.ts","sourceRoot":"","sources":["../../../../../../../packages/components/src/utils/mfActions/tests/callbackHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,SAAI;;eAQG,iBAAiB;iBAC9B,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI;EAElF"}

package/utils/mfActions/tests/constants.d.ts

@@ -0,0 +1,6 @@
+import { MFActionOpen, MFActionRequest } from '../types';
+export declare const ACTION_REQUEST: MFActionRequest;
+export declare const ACTION_OPEN: MFActionOpen;
+export declare const ACTION_MODAL_OPEN: MFActionOpen;
+export declare const INVALID_ACTION_REQUESTS: unknown[];
+//# sourceMappingURL=constants.d.ts.map

package/utils/mfActions/tests/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../../packages/components/src/utils/mfActions/tests/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE9D,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,YAazB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,YAQ/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,OAAO,EAQ5C,CAAC"}

package/utils/mfActions/tests/helpers.d.ts

@@ -0,0 +1,4 @@
+import { ActionTestBus } from './types';
+/** Use the event bus contract without relying on callbacks embedded in window payloads. */
+export declare function createActionTestBus(): ActionTestBus;
+//# sourceMappingURL=helpers.d.ts.map

package/utils/mfActions/tests/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../../packages/components/src/utils/mfActions/tests/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,SAAS,CAAC;AAElE,2FAA2F;AAC3F,wBAAgB,mBAAmB,IAAI,aAAa,CAsBnD"}

package/utils/mfActions/tests/types.d.ts

@@ -0,0 +1,8 @@
+import { MFActionHostTools } from '../types';
+export type ActionEventListener = (payload: unknown) => void;
+export interface ActionTestBus {
+    hostTools: MFActionHostTools;
+    emit: (event: string, payload: unknown) => void;
+    listenerCount: (event: string) => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/utils/mfActions/tests/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/components/src/utils/mfActions/tests/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C"}

package/utils/mfActions/types.d.ts

@@ -0,0 +1,47 @@
+import { HostToolsType } from '@m4l/core';
+import { EmmitNewModalProps, EmmitNewPopupProps } from '../../components/areas/types';
+export interface MFActionRequest {
+    version: 1;
+    requestId: string;
+    requesterWindowId: string;
+    moduleId: string;
+    scopeKey: string;
+}
+export type MFActionOutcome = {
+    status: 'created';
+    operationId: string;
+    entityId: string;
+} | {
+    status: 'cancelled';
+} | {
+    status: 'failed';
+    errorCode: string;
+};
+export type MFActionResult = MFActionRequest & (MFActionOutcome | {
+    status: 'opened';
+    windowId: string;
+});
+export interface MFActionOpen {
+    request: MFActionRequest;
+    window: Extract<EmmitNewPopupProps | EmmitNewModalProps, {
+        winType: 'microfrontend';
+    }>;
+}
+export type MFActionHostTools = Pick<HostToolsType, 'events_emit' | 'events_add_listener' | 'events_remove_listener'>;
+/** Local lifecycle callbacks owned by one opener, separate from resource notifications. */
+export interface MFActionCallbacks {
+    onOpened: () => void;
+    onClosed: () => void;
+    onLoadError: () => void;
+}
+declare module '@m4l/core' {
+    interface EmmitEventsGuard {
+        'm4l:mf-action-open:v1': MFActionOpen;
+        'm4l:mf-action-result:v1': MFActionResult;
+    }
+    interface EmmitListenerGuard {
+        'm4l:mf-action-open:v1': (payload: MFActionOpen) => void;
+        'm4l:mf-action-result:v1': (payload: MFActionResult) => void;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/utils/mfActions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/components/src/utils/mfActions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,CAC7C,eAAe,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CACzD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC,kBAAkB,GAAG,kBAAkB,EAAE;QAAE,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,qBAAqB,GAAG,wBAAwB,CAAC,CAAC;AAEtH,2FAA2F;AAC3F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAU,gBAAgB;QACxB,uBAAuB,EAAE,YAAY,CAAC;QACtC,yBAAyB,EAAE,cAAc,CAAC;KAC3C;IACD,UAAU,kBAAkB;QAC1B,uBAAuB,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;QACzD,yBAAyB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;KAC9D;CACF"}