@nocobase/flow-engine 2.0.51 → 2.0.53

package/lib/views/usePage.js

@@ -58,6 +58,102 @@ var import_runViewBeforeClose = require("./runViewBeforeClose");
 let uuid = 0;
 const GLOBAL_EMBED_CONTAINER_ID = "nocobase-embed-container";
 const EMBED_REPLACING_DATA_KEY = "nocobaseEmbedReplacing";
+function isPromiseLike(value) {
+  return !!value && typeof value.then === "function";
+}
+__name(isPromiseLike, "isPromiseLike");
+function closeReplacingGlobalEmbed(target, activeView) {
+  target.dataset[EMBED_REPLACING_DATA_KEY] = "1";
+  try {
+    const closeResult = activeView.close();
+    if (isPromiseLike(closeResult)) {
+      return Promise.resolve(closeResult).finally(() => {
+        delete target.dataset[EMBED_REPLACING_DATA_KEY];
+      });
+    }
+    delete target.dataset[EMBED_REPLACING_DATA_KEY];
+    return closeResult;
+  } catch (error) {
+    delete target.dataset[EMBED_REPLACING_DATA_KEY];
+    throw error;
+  }
+}
+__name(closeReplacingGlobalEmbed, "closeReplacingGlobalEmbed");
+function createPendingGlobalEmbedView(openedPromise, inputArgs, preventClose) {
+  let openedPage;
+  const pendingActions = {};
+  const readyPromise = openedPromise.then(({ page }) => {
+    openedPage = page;
+    if (openedPage) {
+      if ("beforeClose" in pendingActions) {
+        openedPage.beforeClose = pendingActions.beforeClose;
+      }
+      if ("update" in pendingActions) {
+        openedPage.update(pendingActions.update);
+      }
+      if ("footer" in pendingActions) {
+        openedPage.setFooter(pendingActions.footer);
+      }
+      if ("header" in pendingActions) {
+        openedPage.setHeader(pendingActions.header);
+      }
+      if (pendingActions.destroyed) {
+        openedPage.destroy(pendingActions.destroyed.result);
+      }
+    }
+    return { page };
+  });
+  return Object.assign(
+    readyPromise.then(({ page }) => page ? page : false),
+    {
+      type: "embed",
+      inputArgs,
+      preventClose,
+      Header: null,
+      Footer: null,
+      get beforeClose() {
+        return (openedPage == null ? void 0 : openedPage.beforeClose) ?? pendingActions.beforeClose;
+      },
+      set beforeClose(value) {
+        if (openedPage) {
+          openedPage.beforeClose = value;
+        } else {
+          pendingActions.beforeClose = value;
+        }
+      },
+      close: /* @__PURE__ */ __name((result, force) => readyPromise.then(({ page }) => page ? page.close(result, force) : false), "close"),
+      destroy: /* @__PURE__ */ __name((result) => {
+        if (openedPage) {
+          openedPage.destroy(result);
+        } else {
+          pendingActions.destroyed = { result };
+        }
+      }, "destroy"),
+      update: /* @__PURE__ */ __name((newConfig) => {
+        if (openedPage) {
+          openedPage.update(newConfig);
+        } else {
+          pendingActions.update = { ...pendingActions.update, ...newConfig };
+        }
+      }, "update"),
+      setFooter: /* @__PURE__ */ __name((footer) => {
+        if (openedPage) {
+          openedPage.setFooter(footer);
+        } else {
+          pendingActions.footer = footer;
+        }
+      }, "setFooter"),
+      setHeader: /* @__PURE__ */ __name((header) => {
+        if (openedPage) {
+          openedPage.setHeader(header);
+        } else {
+          pendingActions.header = header;
+        }
+      }, "setHeader")
+    }
+  );
+}
+__name(createPendingGlobalEmbedView, "createPendingGlobalEmbedView");
 const PageElementsHolder = import_react.default.memo(
   import_react.default.forwardRef((props, ref) => {
     const [elements, patchElement] = (0, import_usePatchElement.default)();
@@ -68,174 +164,229 @@ const PageElementsHolder = import_react.default.memo(
 function usePage() {
   const holderRef = import_react.default.useRef(null);
   const globalEmbedActiveRef = import_react.default.useRef(null);
+  const globalEmbedReplacementTokenRef = import_react.default.useRef(0);
   const open = /* @__PURE__ */ __name((config, flowContext) => {
-    var _a, _b, _c;
-    const parentEngine = flowContext == null ? void 0 : flowContext.engine;
-    uuid += 1;
-    const pageRef = import_react.default.createRef();
-    let closeFunc;
-    let resolvePromise;
-    const promise = new Promise((resolve) => {
-      resolvePromise = resolve;
-    });
-    const FooterComponent = /* @__PURE__ */ __name(({ children }) => {
-      import_react.default.useEffect(() => {
-        var _a2;
-        (_a2 = pageRef.current) == null ? void 0 : _a2.setFooter(children);
-        return () => {
-          var _a3;
-          (_a3 = pageRef.current) == null ? void 0 : _a3.setFooter(null);
-        };
-      }, [children]);
-      return null;
-    }, "FooterComponent");
-    const HeaderComponent = /* @__PURE__ */ __name((props) => {
-      import_react.default.useEffect(() => {
-        var _a2;
-        (_a2 = pageRef.current) == null ? void 0 : _a2.setHeader(props);
-        return () => {
-          var _a3;
-          (_a3 = pageRef.current) == null ? void 0 : _a3.setHeader(null);
-        };
-      }, [props]);
-      return null;
-    }, "HeaderComponent");
     const {
       target,
       content,
       preventClose,
       inheritContext = true,
       inputArgs: viewInputArgs = {},
+      onOpenCancelled,
       ...restConfig
     } = config;
     const isGlobalEmbedContainer = target instanceof HTMLElement && target.id === GLOBAL_EMBED_CONTAINER_ID;
-    if (isGlobalEmbedContainer && globalEmbedActiveRef.current) {
-      try {
-        target.dataset[EMBED_REPLACING_DATA_KEY] = "1";
-        globalEmbedActiveRef.current.destroy();
-      } finally {
-        delete target.dataset[EMBED_REPLACING_DATA_KEY];
-        globalEmbedActiveRef.current = null;
+    const openCurrentPage = /* @__PURE__ */ __name(() => {
+      var _a, _b, _c;
+      const parentEngine = flowContext == null ? void 0 : flowContext.engine;
+      uuid += 1;
+      const pageRef = import_react.default.createRef();
+      let closeFunc;
+      let resolvePromise;
+      const promise = new Promise((resolve) => {
+        resolvePromise = resolve;
+      });
+      const FooterComponent = /* @__PURE__ */ __name(({ children }) => {
+        import_react.default.useEffect(() => {
+          var _a2;
+          (_a2 = pageRef.current) == null ? void 0 : _a2.setFooter(children);
+          return () => {
+            var _a3;
+            (_a3 = pageRef.current) == null ? void 0 : _a3.setFooter(null);
+          };
+        }, [children]);
+        return null;
+      }, "FooterComponent");
+      const HeaderComponent = /* @__PURE__ */ __name((props) => {
+        import_react.default.useEffect(() => {
+          var _a2;
+          (_a2 = pageRef.current) == null ? void 0 : _a2.setHeader(props);
+          return () => {
+            var _a3;
+            (_a3 = pageRef.current) == null ? void 0 : _a3.setHeader(null);
+          };
+        }, [props]);
+        return null;
+      }, "HeaderComponent");
+      const ctx = new import_flowContext.FlowContext();
+      const scopedEngine = (0, import_ViewScopedFlowEngine.createViewScopedEngine)(flowContext.engine);
+      const openerEngine = (0, import_viewEvents.resolveOpenerEngine)(parentEngine, scopedEngine);
+      ctx.defineProperty("engine", { value: scopedEngine });
+      ctx.addDelegate(scopedEngine.context);
+      if (inheritContext) {
+        ctx.addDelegate(flowContext);
+      } else {
+        ctx.addDelegate(flowContext.engine.context);
       }
-    }
-    const ctx = new import_flowContext.FlowContext();
-    const scopedEngine = (0, import_ViewScopedFlowEngine.createViewScopedEngine)(flowContext.engine);
-    const openerEngine = (0, import_viewEvents.resolveOpenerEngine)(parentEngine, scopedEngine);
-    ctx.defineProperty("engine", { value: scopedEngine });
-    ctx.addDelegate(scopedEngine.context);
-    if (inheritContext) {
-      ctx.addDelegate(flowContext);
-    } else {
-      ctx.addDelegate(flowContext.engine.context);
-    }
-    const currentPage = {
-      type: "embed",
-      inputArgs: viewInputArgs,
-      preventClose: !!config.preventClose,
-      beforeClose: void 0,
-      destroy: /* @__PURE__ */ __name((result) => {
-        var _a2, _b2, _c2, _d, _e;
-        (_a2 = config.onClose) == null ? void 0 : _a2.call(config);
-        resolvePromise == null ? void 0 : resolvePromise(result);
-        (_b2 = pageRef.current) == null ? void 0 : _b2.destroy();
-        closeFunc == null ? void 0 : closeFunc();
-        if (isGlobalEmbedContainer) {
-          globalEmbedActiveRef.current = null;
-        }
-        const isReplacing = isGlobalEmbedContainer && target instanceof HTMLElement && ((_c2 = target.dataset) == null ? void 0 : _c2[EMBED_REPLACING_DATA_KEY]) === "1";
-        if (!isReplacing) {
-          const openerEmitter = openerEngine == null ? void 0 : openerEngine.emitter;
-          (0, import_viewEvents.bumpViewActivatedVersion)(openerEmitter);
-          (_e = openerEmitter == null ? void 0 : openerEmitter.emit) == null ? void 0 : _e.call(openerEmitter, import_viewEvents.VIEW_ACTIVATED_EVENT, { type: "embed", viewUid: (_d = currentPage == null ? void 0 : currentPage.inputArgs) == null ? void 0 : _d.viewUid });
-        }
-        scopedEngine.unlinkFromStack();
-      }, "destroy"),
-      update: /* @__PURE__ */ __name((newConfig) => {
-        var _a2;
-        return (_a2 = pageRef.current) == null ? void 0 : _a2.update(newConfig);
-      }, "update"),
-      close: /* @__PURE__ */ __name(async (result, force) => {
-        var _a2, _b2;
-        if (preventClose && !force) {
-          return false;
-        }
-        const shouldClose = await (0, import_runViewBeforeClose.runViewBeforeClose)(currentPage, { result, force });
-        if (!shouldClose) {
-          return false;
+      let destroyed = false;
+      let closingPromise;
+      const currentPage = {
+        type: "embed",
+        inputArgs: viewInputArgs,
+        preventClose: !!config.preventClose,
+        beforeClose: void 0,
+        destroy: /* @__PURE__ */ __name((result) => {
+          var _a2, _b2, _c2, _d, _e;
+          if (destroyed) return;
+          destroyed = true;
+          (_a2 = config.onClose) == null ? void 0 : _a2.call(config);
+          resolvePromise == null ? void 0 : resolvePromise(result);
+          (_b2 = pageRef.current) == null ? void 0 : _b2.destroy();
+          closeFunc == null ? void 0 : closeFunc();
+          if (isGlobalEmbedContainer && globalEmbedActiveRef.current === currentPage) {
+            globalEmbedActiveRef.current = null;
+          }
+          const isReplacing = isGlobalEmbedContainer && target instanceof HTMLElement && ((_c2 = target.dataset) == null ? void 0 : _c2[EMBED_REPLACING_DATA_KEY]) === "1";
+          if (!isReplacing) {
+            const openerEmitter = openerEngine == null ? void 0 : openerEngine.emitter;
+            (0, import_viewEvents.bumpViewActivatedVersion)(openerEmitter);
+            (_e = openerEmitter == null ? void 0 : openerEmitter.emit) == null ? void 0 : _e.call(openerEmitter, import_viewEvents.VIEW_ACTIVATED_EVENT, { type: "embed", viewUid: (_d = currentPage == null ? void 0 : currentPage.inputArgs) == null ? void 0 : _d.viewUid });
+          }
+          scopedEngine.unlinkFromStack();
+        }, "destroy"),
+        update: /* @__PURE__ */ __name((newConfig) => {
+          var _a2;
+          return (_a2 = pageRef.current) == null ? void 0 : _a2.update(newConfig);
+        }, "update"),
+        close: /* @__PURE__ */ __name((result, force) => {
+          if (destroyed) {
+            return Promise.resolve(true);
+          }
+          if (closingPromise) {
+            return closingPromise;
+          }
+          closingPromise = (async () => {
+            var _a2, _b2;
+            try {
+              if (preventClose && !force) {
+                closingPromise = void 0;
+                return false;
+              }
+              const shouldClose = await (0, import_runViewBeforeClose.runViewBeforeClose)(currentPage, { result, force });
+              if (destroyed) {
+                return true;
+              }
+              if (!shouldClose) {
+                closingPromise = void 0;
+                return false;
+              }
+              if (config.triggerByRouter && ((_b2 = (_a2 = config.inputArgs) == null ? void 0 : _a2.navigation) == null ? void 0 : _b2.back)) {
+                config.inputArgs.navigation.back();
+                return true;
+              }
+              currentPage.destroy(result);
+              return true;
+            } catch (error) {
+              if (!destroyed) {
+                closingPromise = void 0;
+              }
+              throw error;
+            }
+          })();
+          return closingPromise;
+        }, "close"),
+        Header: HeaderComponent,
+        Footer: FooterComponent,
+        setFooter: /* @__PURE__ */ __name((footer) => {
+          var _a2;
+          (_a2 = pageRef.current) == null ? void 0 : _a2.setFooter(footer);
+        }, "setFooter"),
+        setHeader: /* @__PURE__ */ __name((header) => {
+          var _a2;
+          (_a2 = pageRef.current) == null ? void 0 : _a2.setHeader(header);
+        }, "setHeader"),
+        navigation: (_a = config.inputArgs) == null ? void 0 : _a.navigation,
+        get record() {
+          return (0, import_variablesParams.getViewRecordFromParent)(flowContext, ctx);
         }
-        if (config.triggerByRouter && ((_b2 = (_a2 = config.inputArgs) == null ? void 0 : _a2.navigation) == null ? void 0 : _b2.back)) {
-          config.inputArgs.navigation.back();
-          return true;
+      };
+      ctx.defineProperty("view", {
+        get: /* @__PURE__ */ __name(() => currentPage, "get"),
+        // 仅当访问关联字段或前端无本地记录数据时，才交给服务端解析
+        resolveOnServer: (0, import_variablesParams.createViewRecordResolveOnServer)(ctx, () => (0, import_variablesParams.getViewRecordFromParent)(flowContext, ctx))
+      });
+      (0, import_createViewMeta.registerPopupVariable)(ctx, currentPage);
+      const PageWithContext = (0, import__.observer)(
+        () => {
+          var _a2, _b2, _c2, _d;
+          const mountedRef = import_react.default.useRef(false);
+          const pageContent = import_react.default.useMemo(
+            () => typeof content === "function" ? content(currentPage, ctx) : content,
+            []
+          );
+          void ctx.themeToken;
+          import_react.default.useEffect(() => {
+            var _a3;
+            (_a3 = config.onOpen) == null ? void 0 : _a3.call(config, currentPage, ctx);
+          }, []);
+          if (((_b2 = (_a2 = config.inputArgs) == null ? void 0 : _a2.hidden) == null ? void 0 : _b2.value) && !mountedRef.current) {
+            return null;
+          }
+          mountedRef.current = true;
+          return /* @__PURE__ */ import_react.default.createElement(
+            import_PageComponent.PageComponent,
+            {
+              ref: pageRef,
+              hidden: (_d = (_c2 = config.inputArgs) == null ? void 0 : _c2.hidden) == null ? void 0 : _d.value,
+              ...restConfig,
+              onClose: () => {
+                return currentPage.close(config.result);
+              }
+            },
+            pageContent
+          );
+        },
+        {
+          displayName: "PageWithContext"
         }
-        currentPage.destroy(result);
-        return true;
-      }, "close"),
-      Header: HeaderComponent,
-      Footer: FooterComponent,
-      setFooter: /* @__PURE__ */ __name((footer) => {
-        var _a2;
-        (_a2 = pageRef.current) == null ? void 0 : _a2.setFooter(footer);
-      }, "setFooter"),
-      setHeader: /* @__PURE__ */ __name((header) => {
-        var _a2;
-        (_a2 = pageRef.current) == null ? void 0 : _a2.setHeader(header);
-      }, "setHeader"),
-      navigation: (_a = config.inputArgs) == null ? void 0 : _a.navigation,
-      get record() {
-        return (0, import_variablesParams.getViewRecordFromParent)(flowContext, ctx);
+      );
+      const key = (viewInputArgs == null ? void 0 : viewInputArgs.viewUid) || `page-${uuid}`;
+      const page = /* @__PURE__ */ import_react.default.createElement(import_provider.FlowEngineProvider, { key, engine: scopedEngine }, /* @__PURE__ */ import_react.default.createElement(import_FlowContextProvider.FlowViewContextProvider, { context: ctx }, /* @__PURE__ */ import_react.default.createElement(PageWithContext, null)));
+      if (target && target instanceof HTMLElement) {
+        closeFunc = (_b = holderRef.current) == null ? void 0 : _b.patchElement(import_react_dom.default.createPortal(page, target, key));
+      } else {
+        closeFunc = (_c = holderRef.current) == null ? void 0 : _c.patchElement(page);
       }
-    };
-    ctx.defineProperty("view", {
-      get: /* @__PURE__ */ __name(() => currentPage, "get"),
-      // 仅当访问关联字段或前端无本地记录数据时，才交给服务端解析
-      resolveOnServer: (0, import_variablesParams.createViewRecordResolveOnServer)(ctx, () => (0, import_variablesParams.getViewRecordFromParent)(flowContext, ctx))
-    });
-    (0, import_createViewMeta.registerPopupVariable)(ctx, currentPage);
-    const PageWithContext = (0, import__.observer)(
-      () => {
-        var _a2, _b2, _c2, _d;
-        const mountedRef = import_react.default.useRef(false);
-        const pageContent = import_react.default.useMemo(
-          () => typeof content === "function" ? content(currentPage, ctx) : content,
-          []
-        );
-        void ctx.themeToken;
-        import_react.default.useEffect(() => {
-          var _a3;
-          (_a3 = config.onOpen) == null ? void 0 : _a3.call(config, currentPage, ctx);
-        }, []);
-        if (((_b2 = (_a2 = config.inputArgs) == null ? void 0 : _a2.hidden) == null ? void 0 : _b2.value) && !mountedRef.current) {
-          return null;
-        }
-        mountedRef.current = true;
-        return /* @__PURE__ */ import_react.default.createElement(
-          import_PageComponent.PageComponent,
-          {
-            ref: pageRef,
-            hidden: (_d = (_c2 = config.inputArgs) == null ? void 0 : _c2.hidden) == null ? void 0 : _d.value,
-            ...restConfig,
-            onClose: () => {
-              currentPage.close(config.result);
+      if (isGlobalEmbedContainer) {
+        globalEmbedActiveRef.current = currentPage;
+      }
+      return Object.assign(promise, currentPage);
+    }, "openCurrentPage");
+    if (isGlobalEmbedContainer && globalEmbedActiveRef.current) {
+      const replacementToken = globalEmbedReplacementTokenRef.current += 1;
+      const cancelOpen = /* @__PURE__ */ __name(() => onOpenCancelled == null ? void 0 : onOpenCancelled(), "cancelOpen");
+      let closeResult;
+      try {
+        closeResult = closeReplacingGlobalEmbed(target, globalEmbedActiveRef.current);
+      } catch (error) {
+        cancelOpen();
+        throw error;
+      }
+      if (isPromiseLike(closeResult)) {
+        return createPendingGlobalEmbedView(
+          Promise.resolve(closeResult).then(
+            (closed) => {
+              if (closed === false || replacementToken !== globalEmbedReplacementTokenRef.current) {
+                cancelOpen();
+                return { page: null };
+              }
+              return { page: openCurrentPage() };
+            },
+            (error) => {
+              cancelOpen();
+              throw error;
             }
-          },
-          pageContent
+          ),
+          viewInputArgs,
+          !!config.preventClose
         );
-      },
-      {
-        displayName: "PageWithContext"
       }
-    );
-    const key = (viewInputArgs == null ? void 0 : viewInputArgs.viewUid) || `page-${uuid}`;
-    const page = /* @__PURE__ */ import_react.default.createElement(import_provider.FlowEngineProvider, { key, engine: scopedEngine }, /* @__PURE__ */ import_react.default.createElement(import_FlowContextProvider.FlowViewContextProvider, { context: ctx }, /* @__PURE__ */ import_react.default.createElement(PageWithContext, null)));
-    if (target && target instanceof HTMLElement) {
-      closeFunc = (_b = holderRef.current) == null ? void 0 : _b.patchElement(import_react_dom.default.createPortal(page, target, key));
-    } else {
-      closeFunc = (_c = holderRef.current) == null ? void 0 : _c.patchElement(page);
-    }
-    if (isGlobalEmbedContainer) {
-      globalEmbedActiveRef.current = { destroy: currentPage.destroy };
+      if (closeResult === false) {
+        cancelOpen();
+        return createPendingGlobalEmbedView(Promise.resolve({ page: null }), viewInputArgs, !!config.preventClose);
+      }
     }
-    return Object.assign(promise, currentPage);
+    return openCurrentPage();
   }, "open");
   const api = import_react.default.useMemo(() => ({ open }), []);
   return [api, /* @__PURE__ */ import_react.default.createElement(PageElementsHolder, { key: "page-holder", ref: holderRef })];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/flow-engine",
-  "version": "2.0.51",
+  "version": "2.0.53",
   "private": false,
   "description": "A standalone flow engine for NocoBase, managing workflows, models, and actions.",
   "main": "lib/index.js",
@@ -8,8 +8,8 @@
   "dependencies": {
     "@formily/antd-v5": "1.x",
     "@formily/reactive": "2.x",
-    "@nocobase/sdk": "2.0.51",
-    "@nocobase/shared": "2.0.51",
+    "@nocobase/sdk": "2.0.53",
+    "@nocobase/shared": "2.0.53",
     "ahooks": "^3.7.2",
     "axios": "^1.7.0",
     "dayjs": "^1.11.9",
@@ -37,5 +37,5 @@
   ],
   "author": "NocoBase Team",
   "license": "Apache-2.0",
-  "gitHead": "f77260e6a5471835f9dac39c55fe1aebd11b65f1"
+  "gitHead": "652f01597d2293faea886f803c3dfefbecfc654f"
 }

package/src/__tests__/flowContext.test.ts

@@ -160,6 +160,23 @@ describe('FlowContext properties and methods', () => {
     expect(ctx.shared).toBe('from delegate');
   });
 
+  it('should expose current language as a top-level variable', async () => {
+    const engine = new FlowEngine();
+    const ctx = engine.context;
+    ctx.defineProperty('api', { value: { auth: { locale: 'zh-CN' } } });
+    ctx.defineProperty('i18n', { value: { language: 'en-US' } });
+
+    expect(ctx.locale).toBe('zh-CN');
+    await expect(ctx.resolveJsonTemplate('{{ ctx.locale }}')).resolves.toBe('zh-CN');
+
+    const localeNode = ctx.getPropertyMetaTree().find((node) => node.name === 'locale');
+    expect(localeNode).toMatchObject({
+      name: 'locale',
+      title: '{{t("Current language")}}',
+      paths: ['locale'],
+    });
+  });
+
   it('should throw sync error in get', () => {
     const ctx = new FlowContext();
     ctx.defineProperty('error', {

package/src/components/subModel/__tests__/AddSubModelButton.test.tsx

@@ -1142,6 +1142,7 @@ describe('AddSubModelButton toggleable behavior', () => {
       },
       { timeout: 3000 },
     );
+    await waitFor(() => expect(screen.getByRole('switch')).toHaveAttribute('aria-checked', 'true'));
 
     // dropdown should remain open and children should still be visible (no flicker / reload)
     expect(screen.getByText('Async Group')).toBeInTheDocument();
@@ -1158,6 +1159,7 @@ describe('AddSubModelButton toggleable behavior', () => {
 
     // ensure destroy has been called (avoid flakiness on exact call counts)
     await waitFor(() => {
+      expect(screen.getByRole('switch')).toHaveAttribute('aria-checked', 'false');
       expect(repo.destroy).toHaveBeenCalled();
     });
   });

package/src/flow-registry/DetachedFlowRegistry.ts

@@ -0,0 +1,46 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import _ from 'lodash';
+import { FlowDefinition } from '../FlowDefinition';
+import { FlowDefinitionOptions } from '../types';
+import { BaseFlowRegistry, IFlowRepository } from './BaseFlowRegistry';
+
+export type FlowRegistryData = Record<string, Omit<FlowDefinitionOptions, 'key'> & { key?: string }>;
+
+export class DetachedFlowRegistry extends BaseFlowRegistry {
+  constructor(flows: FlowRegistryData = {}) {
+    super();
+    this.addFlows(_.cloneDeep(flows));
+  }
+
+  saveFlow(_flow: FlowDefinition): void {}
+
+  destroyFlow(flowKey: string): void {
+    this.removeFlow(flowKey);
+  }
+}
+
+export function serializeFlowRegistry(registry: Pick<IFlowRepository, 'getFlows'>): FlowRegistryData {
+  const flows: FlowRegistryData = {};
+  for (const [key, flow] of registry.getFlows()) {
+    flows[key] = _.cloneDeep(flow.toData());
+  }
+  return flows;
+}
+
+export function replaceFlowRegistry(
+  registry: Pick<IFlowRepository, 'getFlows' | 'removeFlow' | 'addFlows'>,
+  flows: FlowRegistryData,
+) {
+  for (const key of Array.from(registry.getFlows().keys())) {
+    registry.removeFlow(key);
+  }
+  registry.addFlows(_.cloneDeep(flows));
+}

package/src/flow-registry/__tests__/detachedFlowRegistry.test.ts

@@ -0,0 +1,47 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { describe, expect, test } from 'vitest';
+import { DetachedFlowRegistry, replaceFlowRegistry, serializeFlowRegistry } from '../DetachedFlowRegistry';
+
+describe('DetachedFlowRegistry', () => {
+  test('keeps flow edits detached and can replace another registry', () => {
+    const source = {
+      flow1: {
+        title: 'Flow 1',
+        steps: {
+          step1: { title: 'Step 1' } as any,
+        },
+      },
+    };
+    const registry = new DetachedFlowRegistry(source);
+
+    source.flow1.title = 'Changed outside';
+    expect(registry.getFlow('flow1')?.title).toBe('Flow 1');
+
+    const flow = registry.getFlow('flow1');
+    expect(flow).toBeDefined();
+    if (!flow) {
+      throw new Error('flow1 should exist');
+    }
+    flow.title = 'Draft title';
+    const serialized = serializeFlowRegistry(registry);
+    serialized.flow1.title = 'Changed serialized';
+    expect(registry.getFlow('flow1')?.title).toBe('Draft title');
+
+    const target = new DetachedFlowRegistry({ stale: { title: 'Stale', steps: {} } });
+    replaceFlowRegistry(target, serializeFlowRegistry(registry));
+
+    expect(target.hasFlow('stale')).toBe(false);
+    expect(target.getFlow('flow1')?.title).toBe('Draft title');
+
+    target.destroyFlow('flow1');
+    expect(target.hasFlow('flow1')).toBe(false);
+  });
+});

package/src/flow-registry/index.ts

@@ -10,3 +10,4 @@
 export * from './BaseFlowRegistry';
 export * from './InstanceFlowRegistry';
 export * from './GlobalFlowRegistry';
+export * from './DetachedFlowRegistry';