@nocobase/flow-engine 2.1.0-alpha.1 → 2.1.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (312) hide show
  1. package/LICENSE +201 -661
  2. package/README.md +79 -10
  3. package/lib/BlockScopedFlowEngine.js +0 -1
  4. package/lib/FlowDefinition.d.ts +6 -0
  5. package/lib/FlowSchemaRegistry.d.ts +154 -0
  6. package/lib/FlowSchemaRegistry.js +1427 -0
  7. package/lib/JSRunner.d.ts +15 -0
  8. package/lib/JSRunner.js +82 -7
  9. package/lib/ViewScopedFlowEngine.js +8 -1
  10. package/lib/acl/Acl.js +13 -3
  11. package/lib/components/FlowContextSelector.js +155 -10
  12. package/lib/components/MobilePopup.js +6 -5
  13. package/lib/components/dnd/gridDragPlanner.d.ts +1 -0
  14. package/lib/components/dnd/gridDragPlanner.js +59 -3
  15. package/lib/components/settings/wrappers/component/SwitchWithTitle.js +2 -1
  16. package/lib/components/settings/wrappers/contextual/DefaultSettingsIcon.js +76 -15
  17. package/lib/components/settings/wrappers/contextual/FlowsContextMenu.js +24 -4
  18. package/lib/components/settings/wrappers/contextual/StepSettingsDialog.js +21 -3
  19. package/lib/components/subModel/AddSubModelButton.js +27 -1
  20. package/lib/components/subModel/utils.js +2 -2
  21. package/lib/components/variables/VariableInput.js +9 -4
  22. package/lib/components/variables/VariableTag.js +46 -39
  23. package/lib/components/variables/utils.d.ts +7 -0
  24. package/lib/components/variables/utils.js +42 -2
  25. package/lib/data-source/index.d.ts +7 -27
  26. package/lib/data-source/index.js +84 -51
  27. package/lib/executor/FlowExecutor.d.ts +2 -1
  28. package/lib/executor/FlowExecutor.js +190 -26
  29. package/lib/flow-schema-registry/fieldBinding.d.ts +32 -0
  30. package/lib/flow-schema-registry/fieldBinding.js +165 -0
  31. package/lib/flow-schema-registry/modelPatches.d.ts +16 -0
  32. package/lib/flow-schema-registry/modelPatches.js +235 -0
  33. package/lib/flow-schema-registry/schemaInference.d.ts +17 -0
  34. package/lib/flow-schema-registry/schemaInference.js +207 -0
  35. package/lib/flow-schema-registry/utils.d.ts +25 -0
  36. package/lib/flow-schema-registry/utils.js +293 -0
  37. package/lib/flowContext.d.ts +230 -7
  38. package/lib/flowContext.js +2270 -148
  39. package/lib/flowEngine.d.ts +160 -1
  40. package/lib/flowEngine.js +387 -27
  41. package/lib/flowI18n.js +6 -4
  42. package/lib/flowSettings.d.ts +14 -6
  43. package/lib/flowSettings.js +51 -17
  44. package/lib/index.d.ts +8 -1
  45. package/lib/index.js +24 -1
  46. package/lib/lazy-helper.d.ts +14 -0
  47. package/lib/lazy-helper.js +71 -0
  48. package/lib/locale/en-US.json +9 -2
  49. package/lib/locale/index.d.ts +14 -0
  50. package/lib/locale/zh-CN.json +8 -1
  51. package/lib/models/CollectionFieldModel.d.ts +1 -0
  52. package/lib/models/CollectionFieldModel.js +3 -2
  53. package/lib/models/DisplayItemModel.d.ts +1 -1
  54. package/lib/models/EditableItemModel.d.ts +1 -1
  55. package/lib/models/FilterableItemModel.d.ts +1 -1
  56. package/lib/models/flowModel.d.ts +7 -0
  57. package/lib/models/flowModel.js +83 -8
  58. package/lib/provider.js +7 -6
  59. package/lib/resources/baseRecordResource.d.ts +5 -0
  60. package/lib/resources/baseRecordResource.js +24 -0
  61. package/lib/resources/multiRecordResource.d.ts +1 -0
  62. package/lib/resources/multiRecordResource.js +11 -4
  63. package/lib/resources/singleRecordResource.js +2 -0
  64. package/lib/resources/sqlResource.d.ts +4 -3
  65. package/lib/resources/sqlResource.js +8 -3
  66. package/lib/runjs-context/contexts/FormJSFieldItemRunJSContext.js +12 -2
  67. package/lib/runjs-context/contexts/JSBlockRunJSContext.js +2 -2
  68. package/lib/runjs-context/contexts/JSEditableFieldRunJSContext.d.ts +16 -0
  69. package/lib/runjs-context/contexts/JSEditableFieldRunJSContext.js +125 -0
  70. package/lib/runjs-context/contexts/JSItemRunJSContext.js +12 -2
  71. package/lib/runjs-context/contexts/base.js +706 -41
  72. package/lib/runjs-context/contributions.d.ts +33 -0
  73. package/lib/runjs-context/contributions.js +88 -0
  74. package/lib/runjs-context/helpers.js +12 -1
  75. package/lib/runjs-context/registry.d.ts +1 -1
  76. package/lib/runjs-context/setup.js +23 -9
  77. package/lib/runjs-context/snippets/global/api-request.snippet.js +3 -3
  78. package/lib/runjs-context/snippets/global/import-esm.snippet.js +2 -3
  79. package/lib/runjs-context/snippets/global/query-selector.snippet.js +8 -3
  80. package/lib/runjs-context/snippets/global/require-amd.snippet.js +1 -1
  81. package/lib/runjs-context/snippets/index.d.ts +11 -1
  82. package/lib/runjs-context/snippets/index.js +61 -40
  83. package/lib/runjs-context/snippets/scene/block/add-event-listener.snippet.js +10 -7
  84. package/lib/runjs-context/snippets/scene/block/api-fetch-render-list.snippet.js +3 -3
  85. package/lib/runjs-context/snippets/scene/block/chartjs-bar.snippet.js +2 -2
  86. package/lib/runjs-context/snippets/scene/block/echarts-init.snippet.js +2 -2
  87. package/lib/runjs-context/snippets/scene/block/render-iframe.snippet.js +2 -2
  88. package/lib/runjs-context/snippets/scene/block/render-react.snippet.js +1 -1
  89. package/lib/runjs-context/snippets/scene/block/render-statistics.snippet.js +1 -1
  90. package/lib/runjs-context/snippets/scene/block/render-timeline.snippet.js +1 -1
  91. package/lib/runjs-context/snippets/scene/block/resource-example.snippet.js +5 -5
  92. package/lib/runjs-context/snippets/scene/block/three-users-orbit.snippet.js +6 -6
  93. package/lib/runjs-context/snippets/scene/block/vue-component.snippet.js +3 -4
  94. package/lib/runjs-context/snippets/scene/detail/color-by-value.snippet.js +1 -1
  95. package/lib/runjs-context/snippets/scene/detail/copy-to-clipboard.snippet.js +20 -3
  96. package/lib/runjs-context/snippets/scene/detail/format-number.snippet.js +1 -1
  97. package/lib/runjs-context/snippets/scene/detail/innerHTML-value.snippet.js +1 -1
  98. package/lib/runjs-context/snippets/scene/detail/percentage-bar.snippet.js +3 -3
  99. package/lib/runjs-context/snippets/scene/detail/relative-time.snippet.js +3 -3
  100. package/lib/runjs-context/snippets/scene/detail/status-tag.snippet.js +2 -2
  101. package/lib/runjs-context/snippets/scene/form/cascade-select.snippet.js +1 -1
  102. package/lib/runjs-context/snippets/scene/form/render-basic.snippet.js +2 -2
  103. package/lib/runjs-context/snippets/scene/table/cell-open-dialog.snippet.js +6 -3
  104. package/lib/runjs-context/snippets/scene/table/concat-fields.snippet.js +3 -1
  105. package/lib/runjsLibs.d.ts +28 -0
  106. package/lib/runjsLibs.js +532 -0
  107. package/lib/scheduler/ModelOperationScheduler.d.ts +7 -1
  108. package/lib/scheduler/ModelOperationScheduler.js +28 -23
  109. package/lib/server.d.ts +10 -0
  110. package/lib/server.js +32 -0
  111. package/lib/types.d.ts +296 -1
  112. package/lib/utils/associationObjectVariable.d.ts +2 -2
  113. package/lib/utils/createCollectionContextMeta.js +1 -0
  114. package/lib/utils/createEphemeralContext.js +2 -2
  115. package/lib/utils/dateVariable.d.ts +16 -0
  116. package/lib/utils/dateVariable.js +380 -0
  117. package/lib/utils/exceptions.d.ts +7 -0
  118. package/lib/utils/exceptions.js +10 -0
  119. package/lib/utils/index.d.ts +8 -3
  120. package/lib/utils/index.js +49 -0
  121. package/lib/utils/params-resolvers.js +16 -9
  122. package/lib/utils/parsePathnameToViewParams.js +1 -1
  123. package/lib/utils/resolveModuleUrl.d.ts +58 -0
  124. package/lib/utils/resolveModuleUrl.js +65 -0
  125. package/lib/utils/resolveRunJSObjectValues.d.ts +16 -0
  126. package/lib/utils/resolveRunJSObjectValues.js +61 -0
  127. package/lib/utils/runjsModuleLoader.d.ts +58 -0
  128. package/lib/utils/runjsModuleLoader.js +422 -0
  129. package/lib/utils/runjsTemplateCompat.d.ts +35 -0
  130. package/lib/utils/runjsTemplateCompat.js +743 -0
  131. package/lib/utils/runjsValue.d.ts +29 -0
  132. package/lib/utils/runjsValue.js +275 -0
  133. package/lib/utils/safeGlobals.d.ts +18 -8
  134. package/lib/utils/safeGlobals.js +164 -17
  135. package/lib/utils/schema-utils.d.ts +17 -1
  136. package/lib/utils/schema-utils.js +80 -0
  137. package/lib/views/FlowView.d.ts +7 -1
  138. package/lib/views/createViewMeta.d.ts +0 -7
  139. package/lib/views/createViewMeta.js +19 -70
  140. package/lib/views/index.d.ts +1 -2
  141. package/lib/views/index.js +4 -3
  142. package/lib/views/runViewBeforeClose.d.ts +10 -0
  143. package/lib/views/runViewBeforeClose.js +45 -0
  144. package/lib/views/useDialog.d.ts +2 -1
  145. package/lib/views/useDialog.js +28 -6
  146. package/lib/views/useDrawer.d.ts +2 -1
  147. package/lib/views/useDrawer.js +27 -5
  148. package/lib/views/usePage.d.ts +6 -1
  149. package/lib/views/usePage.js +53 -9
  150. package/lib/views/usePopover.js +4 -1
  151. package/lib/views/viewEvents.d.ts +17 -0
  152. package/lib/views/viewEvents.js +90 -0
  153. package/package.json +5 -5
  154. package/server.d.ts +1 -0
  155. package/server.js +1 -0
  156. package/src/BlockScopedFlowEngine.ts +2 -5
  157. package/src/FlowSchemaRegistry.ts +1799 -0
  158. package/src/JSRunner.ts +111 -5
  159. package/src/ViewScopedFlowEngine.ts +8 -0
  160. package/src/__tests__/FlowSchemaRegistry.test.ts +1951 -0
  161. package/src/__tests__/JSRunner.test.ts +91 -1
  162. package/src/__tests__/createViewMeta.popup.test.ts +62 -1
  163. package/src/__tests__/flow-engine.test.ts +48 -0
  164. package/src/__tests__/flowContext.test.ts +693 -1
  165. package/src/__tests__/flowEngine.dataSourceDirty.test.ts +63 -0
  166. package/src/__tests__/flowEngine.modelLoaders.test.ts +249 -0
  167. package/src/__tests__/flowEngine.saveModel.test.ts +4 -0
  168. package/src/__tests__/flowModel.openView.navigation.test.ts +28 -0
  169. package/src/__tests__/flowRunJSContextDefine.test.ts +63 -0
  170. package/src/__tests__/flowRuntimeContext.test.ts +2 -1
  171. package/src/__tests__/flowSettings.open.test.tsx +123 -19
  172. package/src/__tests__/flowSettings.test.ts +94 -15
  173. package/src/__tests__/provider.test.tsx +0 -5
  174. package/src/__tests__/renderHiddenInConfig.test.tsx +6 -6
  175. package/src/__tests__/runjsContext.test.ts +26 -7
  176. package/src/__tests__/runjsContextImplementations.test.ts +34 -3
  177. package/src/__tests__/runjsContextRuntime.test.ts +5 -3
  178. package/src/__tests__/runjsContributions.test.ts +89 -0
  179. package/src/__tests__/runjsExternalLibs.test.ts +242 -0
  180. package/src/__tests__/runjsLibsLazyLoading.test.ts +44 -0
  181. package/src/__tests__/runjsLocales.test.ts +4 -1
  182. package/src/__tests__/runjsPreprocessDefault.test.ts +72 -0
  183. package/src/__tests__/runjsRuntimeFeatures.test.ts +166 -0
  184. package/src/__tests__/runjsSnippets.test.ts +40 -3
  185. package/src/__tests__/viewScopedFlowEngine.test.ts +3 -3
  186. package/src/acl/Acl.tsx +3 -3
  187. package/src/components/FlowContextSelector.tsx +208 -12
  188. package/src/components/MobilePopup.tsx +4 -2
  189. package/src/components/__tests__/flow-model-render-error-fallback.test.tsx +3 -3
  190. package/src/components/__tests__/gridDragPlanner.test.ts +229 -1
  191. package/src/components/dnd/gridDragPlanner.ts +68 -2
  192. package/src/components/settings/wrappers/component/SwitchWithTitle.tsx +2 -1
  193. package/src/components/settings/wrappers/component/__tests__/InlineControls.test.tsx +74 -0
  194. package/src/components/settings/wrappers/contextual/DefaultSettingsIcon.tsx +109 -16
  195. package/src/components/settings/wrappers/contextual/FlowsContextMenu.tsx +41 -7
  196. package/src/components/settings/wrappers/contextual/StepSettingsDialog.tsx +31 -4
  197. package/src/components/settings/wrappers/contextual/__tests__/DefaultSettingsIcon.test.tsx +157 -5
  198. package/src/components/subModel/AddSubModelButton.tsx +32 -2
  199. package/src/components/subModel/__tests__/AddSubModelButton.test.tsx +143 -32
  200. package/src/components/subModel/utils.ts +1 -1
  201. package/src/components/variables/VariableInput.tsx +12 -4
  202. package/src/components/variables/VariableTag.tsx +54 -45
  203. package/src/components/variables/__tests__/FlowContextSelector.test.tsx +260 -3
  204. package/src/components/variables/__tests__/VariableTag.test.tsx +50 -0
  205. package/src/components/variables/__tests__/utils.test.ts +81 -3
  206. package/src/components/variables/utils.ts +67 -6
  207. package/src/data-source/index.ts +88 -110
  208. package/src/executor/FlowExecutor.ts +230 -28
  209. package/src/executor/__tests__/flowExecutor.test.ts +123 -0
  210. package/src/flow-schema-registry/fieldBinding.ts +171 -0
  211. package/src/flow-schema-registry/modelPatches.ts +260 -0
  212. package/src/flow-schema-registry/schemaInference.ts +210 -0
  213. package/src/flow-schema-registry/utils.ts +268 -0
  214. package/src/flowContext.ts +2989 -212
  215. package/src/flowEngine.ts +434 -23
  216. package/src/flowI18n.ts +7 -5
  217. package/src/flowSettings.ts +58 -18
  218. package/src/index.ts +15 -1
  219. package/src/lazy-helper.tsx +57 -0
  220. package/src/locale/en-US.json +9 -2
  221. package/src/locale/zh-CN.json +8 -1
  222. package/src/models/CollectionFieldModel.tsx +3 -1
  223. package/src/models/DisplayItemModel.tsx +1 -1
  224. package/src/models/EditableItemModel.tsx +1 -1
  225. package/src/models/FilterableItemModel.tsx +1 -1
  226. package/src/models/__tests__/dispatchEvent.when.test.ts +768 -0
  227. package/src/models/__tests__/flowModel.clone.test.ts +416 -0
  228. package/src/models/__tests__/flowModel.test.ts +20 -4
  229. package/src/models/flowModel.tsx +112 -7
  230. package/src/provider.tsx +9 -7
  231. package/src/resources/__tests__/multiRecordResource.test.ts +44 -0
  232. package/src/resources/__tests__/sqlResource.test.ts +60 -0
  233. package/src/resources/baseRecordResource.ts +31 -0
  234. package/src/resources/multiRecordResource.ts +11 -4
  235. package/src/resources/singleRecordResource.ts +3 -0
  236. package/src/resources/sqlResource.ts +11 -6
  237. package/src/runjs-context/contexts/FormJSFieldItemRunJSContext.ts +10 -0
  238. package/src/runjs-context/contexts/JSBlockRunJSContext.ts +6 -2
  239. package/src/runjs-context/contexts/JSEditableFieldRunJSContext.ts +106 -0
  240. package/src/runjs-context/contexts/JSItemRunJSContext.ts +10 -0
  241. package/src/runjs-context/contexts/base.ts +715 -44
  242. package/src/runjs-context/contributions.ts +88 -0
  243. package/src/runjs-context/helpers.ts +11 -1
  244. package/src/runjs-context/registry.ts +1 -1
  245. package/src/runjs-context/setup.ts +25 -9
  246. package/src/runjs-context/snippets/global/api-request.snippet.ts +3 -3
  247. package/src/runjs-context/snippets/global/import-esm.snippet.ts +2 -3
  248. package/src/runjs-context/snippets/global/query-selector.snippet.ts +8 -3
  249. package/src/runjs-context/snippets/global/require-amd.snippet.ts +1 -1
  250. package/src/runjs-context/snippets/index.ts +75 -41
  251. package/src/runjs-context/snippets/scene/block/add-event-listener.snippet.ts +11 -13
  252. package/src/runjs-context/snippets/scene/block/api-fetch-render-list.snippet.ts +3 -3
  253. package/src/runjs-context/snippets/scene/block/chartjs-bar.snippet.ts +2 -2
  254. package/src/runjs-context/snippets/scene/block/echarts-init.snippet.ts +2 -2
  255. package/src/runjs-context/snippets/scene/block/render-iframe.snippet.ts +2 -2
  256. package/src/runjs-context/snippets/scene/block/render-react.snippet.ts +1 -1
  257. package/src/runjs-context/snippets/scene/block/render-statistics.snippet.ts +1 -1
  258. package/src/runjs-context/snippets/scene/block/render-timeline.snippet.ts +1 -1
  259. package/src/runjs-context/snippets/scene/block/resource-example.snippet.ts +6 -11
  260. package/src/runjs-context/snippets/scene/block/three-users-orbit.snippet.ts +6 -6
  261. package/src/runjs-context/snippets/scene/block/vue-component.snippet.ts +3 -4
  262. package/src/runjs-context/snippets/scene/detail/color-by-value.snippet.ts +1 -1
  263. package/src/runjs-context/snippets/scene/detail/copy-to-clipboard.snippet.ts +20 -3
  264. package/src/runjs-context/snippets/scene/detail/format-number.snippet.ts +1 -1
  265. package/src/runjs-context/snippets/scene/detail/innerHTML-value.snippet.ts +1 -1
  266. package/src/runjs-context/snippets/scene/detail/percentage-bar.snippet.ts +3 -3
  267. package/src/runjs-context/snippets/scene/detail/relative-time.snippet.ts +3 -3
  268. package/src/runjs-context/snippets/scene/detail/status-tag.snippet.ts +2 -2
  269. package/src/runjs-context/snippets/scene/form/cascade-select.snippet.ts +1 -1
  270. package/src/runjs-context/snippets/scene/form/render-basic.snippet.ts +3 -8
  271. package/src/runjs-context/snippets/scene/table/cell-open-dialog.snippet.ts +6 -3
  272. package/src/runjs-context/snippets/scene/table/concat-fields.snippet.ts +3 -1
  273. package/src/runjsLibs.ts +622 -0
  274. package/src/scheduler/ModelOperationScheduler.ts +41 -24
  275. package/src/server.ts +11 -0
  276. package/src/types.ts +359 -1
  277. package/src/utils/__tests__/dateVariable.test.ts +101 -0
  278. package/src/utils/__tests__/params-resolvers.test.ts +40 -0
  279. package/src/utils/__tests__/parsePathnameToViewParams.test.ts +7 -0
  280. package/src/utils/__tests__/runjsRequireAsyncAutoWhitelist.test.ts +38 -0
  281. package/src/utils/__tests__/runjsTemplateCompat.test.ts +159 -0
  282. package/src/utils/__tests__/runjsValue.test.ts +44 -0
  283. package/src/utils/__tests__/safeGlobals.test.ts +57 -2
  284. package/src/utils/__tests__/utils.test.ts +157 -0
  285. package/src/utils/associationObjectVariable.ts +2 -2
  286. package/src/utils/createCollectionContextMeta.ts +1 -0
  287. package/src/utils/createEphemeralContext.ts +5 -4
  288. package/src/utils/dateVariable.ts +397 -0
  289. package/src/utils/exceptions.ts +11 -0
  290. package/src/utils/index.ts +38 -3
  291. package/src/utils/params-resolvers.ts +23 -9
  292. package/src/utils/parsePathnameToViewParams.ts +2 -2
  293. package/src/utils/resolveModuleUrl.ts +91 -0
  294. package/src/utils/resolveRunJSObjectValues.ts +46 -0
  295. package/src/utils/runjsModuleLoader.ts +553 -0
  296. package/src/utils/runjsTemplateCompat.ts +828 -0
  297. package/src/utils/runjsValue.ts +287 -0
  298. package/src/utils/safeGlobals.ts +188 -17
  299. package/src/utils/schema-utils.ts +109 -1
  300. package/src/views/FlowView.tsx +11 -1
  301. package/src/views/__tests__/FlowView.usePage.test.tsx +54 -1
  302. package/src/views/__tests__/runViewBeforeClose.test.ts +30 -0
  303. package/src/views/__tests__/useDialog.closeDestroy.test.tsx +44 -16
  304. package/src/views/__tests__/viewEvents.resolveOpenerEngine.test.ts +28 -0
  305. package/src/views/createViewMeta.ts +22 -75
  306. package/src/views/index.tsx +1 -2
  307. package/src/views/runViewBeforeClose.ts +19 -0
  308. package/src/views/useDialog.tsx +34 -5
  309. package/src/views/useDrawer.tsx +33 -4
  310. package/src/views/usePage.tsx +63 -8
  311. package/src/views/usePopover.tsx +4 -1
  312. package/src/views/viewEvents.ts +55 -0
@@ -18,6 +18,7 @@ import { DefaultSettingsIcon } from '../DefaultSettingsIcon';
18
18
 
19
19
  // ---- Mock antd to capture Dropdown menu props ----
20
20
  const dropdownMenus: any[] = [];
21
+ const mockColorTextTertiary = '#8c8c8c';
21
22
  vi.mock('antd', async (importOriginal) => {
22
23
  const messageApi = {
23
24
  success: vi.fn(),
@@ -35,6 +36,7 @@ vi.mock('antd', async (importOriginal) => {
35
36
  const Dropdown = (props: any) => {
36
37
  (globalThis as any).__lastDropdownMenu = props.menu;
37
38
  (globalThis as any).__lastDropdownOnOpenChange = props.onOpenChange;
39
+ (globalThis as any).__lastDropdownOpen = props.open;
38
40
  dropdownMenus.push(props.menu);
39
41
  return React.createElement('span', { 'data-testid': 'dropdown' }, props.children);
40
42
  };
@@ -71,6 +73,7 @@ vi.mock('antd', async (importOriginal) => {
71
73
  const Alert = (props: any) => React.createElement('div', { role: 'alert' }, props.message ?? 'Alert');
72
74
  const Button = (props: any) => React.createElement('button', props, props.children ?? 'Button');
73
75
  const Result = (props: any) => React.createElement('div', null, props.children ?? 'Result');
76
+ const Tooltip = ({ children }: any) => React.createElement('span', null, children);
74
77
 
75
78
  // Keep other components from original mock/default
76
79
  return {
@@ -89,15 +92,46 @@ vi.mock('antd', async (importOriginal) => {
89
92
  Alert,
90
93
  Button,
91
94
  Result,
92
- theme: { useToken: () => ({}) },
95
+ Tooltip,
96
+ theme: { useToken: () => ({ token: { colorTextTertiary: mockColorTextTertiary } }) },
93
97
  };
94
98
  });
95
99
 
100
+ const findElement = (node: any, predicate: (element: React.ReactElement) => boolean): React.ReactElement | null => {
101
+ if (!node) return null;
102
+
103
+ if (React.isValidElement(node)) {
104
+ if (predicate(node)) {
105
+ return node;
106
+ }
107
+
108
+ const children = React.Children.toArray(node.props?.children);
109
+ for (const child of children) {
110
+ const matched = findElement(child, predicate);
111
+ if (matched) {
112
+ return matched;
113
+ }
114
+ }
115
+ }
116
+
117
+ if (Array.isArray(node)) {
118
+ for (const child of node) {
119
+ const matched = findElement(child, predicate);
120
+ if (matched) {
121
+ return matched;
122
+ }
123
+ }
124
+ }
125
+
126
+ return null;
127
+ };
128
+
96
129
  describe('DefaultSettingsIcon - only static flows are shown', () => {
97
130
  beforeEach(() => {
98
131
  dropdownMenus.length = 0;
99
132
  (globalThis as any).__lastDropdownMenu = undefined;
100
133
  (globalThis as any).__lastDropdownOnOpenChange = undefined;
134
+ (globalThis as any).__lastDropdownOpen = undefined;
101
135
  });
102
136
 
103
137
  afterEach(() => {
@@ -239,6 +273,67 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
239
273
  });
240
274
  });
241
275
 
276
+ it('keeps disabled legacy step visible with tooltip and blocks click', async () => {
277
+ class TestFlowModel extends FlowModel {}
278
+ const engine = new FlowEngine();
279
+ const model = new TestFlowModel({ uid: 'm-disabled', flowEngine: engine });
280
+ const openSpy = vi.spyOn(model, 'openFlowSettings').mockResolvedValue(undefined as any);
281
+ const disabledReason = 'This setting has been moved to: Form block settings > Field values';
282
+
283
+ TestFlowModel.registerFlow({
284
+ key: 'flowDisabled',
285
+ title: 'Flow Disabled',
286
+ steps: {
287
+ legacyDefault: {
288
+ title: 'Default value',
289
+ disabledInSettings: true,
290
+ disabledReasonInSettings: disabledReason,
291
+ uiSchema: { f: { type: 'string', 'x-component': 'Input' } },
292
+ },
293
+ },
294
+ });
295
+
296
+ render(
297
+ React.createElement(
298
+ ConfigProvider as any,
299
+ null,
300
+ React.createElement(App as any, null, React.createElement(DefaultSettingsIcon as any, { model })),
301
+ ),
302
+ );
303
+
304
+ let disabledItem: any;
305
+ await waitFor(() => {
306
+ const menu = (globalThis as any).__lastDropdownMenu;
307
+ const items = (menu?.items || []) as any[];
308
+ disabledItem = items.find((it) => String(it.key || '') === 'flowDisabled:legacyDefault');
309
+ expect(disabledItem).toBeTruthy();
310
+ expect(disabledItem.disabled).toBe(true);
311
+ });
312
+
313
+ const resolvedLabel =
314
+ React.isValidElement(disabledItem.label) && typeof disabledItem.label.type === 'function'
315
+ ? (disabledItem.label.type as any)(disabledItem.label.props)
316
+ : disabledItem.label;
317
+
318
+ const tooltipElement = findElement(
319
+ resolvedLabel,
320
+ (element) =>
321
+ Object.prototype.hasOwnProperty.call(element.props || {}, 'title') && element.props.title === disabledReason,
322
+ );
323
+ expect(tooltipElement).toBeTruthy();
324
+
325
+ const iconElement = React.isValidElement(tooltipElement) ? tooltipElement.props.children : null;
326
+ expect(React.isValidElement(iconElement)).toBe(true);
327
+ expect((iconElement as any).props?.style?.color).toBe(mockColorTextTertiary);
328
+
329
+ const menu = (globalThis as any).__lastDropdownMenu;
330
+ await act(async () => {
331
+ menu.onClick?.({ key: 'flowDisabled:legacyDefault' });
332
+ });
333
+
334
+ expect(openSpy).not.toHaveBeenCalled();
335
+ });
336
+
242
337
  it('clicking a step item opens flow settings with correct args', async () => {
243
338
  class TestFlowModel extends FlowModel {}
244
339
  const engine = new FlowEngine();
@@ -265,10 +360,60 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
265
360
  expect((globalThis as any).__lastDropdownMenu).toBeTruthy();
266
361
  });
267
362
  const menu = (globalThis as any).__lastDropdownMenu;
268
- menu.onClick?.({ key: 'flowC:general' });
363
+ await act(async () => {
364
+ menu.onClick?.({ key: 'flowC:general' });
365
+ });
269
366
  expect(openSpy).toHaveBeenCalledWith({ flowKey: 'flowC', stepKey: 'general' });
270
367
  });
271
368
 
369
+ it('closes dropdown when opening flow settings modal', async () => {
370
+ class TestFlowModel extends FlowModel {}
371
+ const engine = new FlowEngine();
372
+ const model = new TestFlowModel({ uid: 'm-close', flowEngine: engine });
373
+ vi.spyOn(model, 'openFlowSettings').mockResolvedValue(undefined as any);
374
+
375
+ TestFlowModel.registerFlow({
376
+ key: 'flowClose',
377
+ title: 'Flow Close',
378
+ steps: {
379
+ general: { title: 'General', uiSchema: { f: { type: 'string', 'x-component': 'Input' } } },
380
+ },
381
+ });
382
+
383
+ render(
384
+ React.createElement(
385
+ ConfigProvider as any,
386
+ null,
387
+ React.createElement(App as any, null, React.createElement(DefaultSettingsIcon as any, { model })),
388
+ ),
389
+ );
390
+
391
+ await waitFor(() => {
392
+ expect((globalThis as any).__lastDropdownMenu).toBeTruthy();
393
+ expect((globalThis as any).__lastDropdownOnOpenChange).toBeTruthy();
394
+ });
395
+
396
+ // open dropdown
397
+ await act(async () => {
398
+ (globalThis as any).__lastDropdownOnOpenChange?.(true, { source: 'trigger' });
399
+ });
400
+
401
+ await waitFor(() => {
402
+ expect((globalThis as any).__lastDropdownOpen).toBe(true);
403
+ });
404
+
405
+ const menu = (globalThis as any).__lastDropdownMenu;
406
+
407
+ // click config item to open modal
408
+ await act(async () => {
409
+ menu.onClick?.({ key: 'flowClose:general' });
410
+ });
411
+
412
+ await waitFor(() => {
413
+ expect((globalThis as any).__lastDropdownOpen).toBe(false);
414
+ });
415
+ });
416
+
272
417
  it('copy UID action writes model uid to clipboard', async () => {
273
418
  class TestFlowModel extends FlowModel {}
274
419
  const engine = new FlowEngine();
@@ -298,7 +443,9 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
298
443
  expect((globalThis as any).__lastDropdownMenu).toBeTruthy();
299
444
  });
300
445
  const menu = (globalThis as any).__lastDropdownMenu;
301
- menu.onClick?.({ key: 'copy-uid' });
446
+ await act(async () => {
447
+ menu.onClick?.({ key: 'copy-uid' });
448
+ });
302
449
  expect((navigator as any).clipboard.writeText).toHaveBeenCalledWith('m-copy');
303
450
  });
304
451
 
@@ -326,7 +473,9 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
326
473
  expect((globalThis as any).__lastDropdownMenu).toBeTruthy();
327
474
  });
328
475
  const menu = (globalThis as any).__lastDropdownMenu;
329
- menu.onClick?.({ key: 'delete' });
476
+ await act(async () => {
477
+ menu.onClick?.({ key: 'delete' });
478
+ });
330
479
  expect(destroySpy).toHaveBeenCalled();
331
480
  });
332
481
 
@@ -556,8 +705,11 @@ describe('DefaultSettingsIcon - extra menu items', () => {
556
705
  });
557
706
 
558
707
  const menu = (globalThis as any).__lastDropdownMenu;
559
- menu.onClick?.({ key: 'extra-action' });
708
+ await act(async () => {
709
+ menu.onClick?.({ key: 'extra-action' });
710
+ });
560
711
  expect(onClick).toHaveBeenCalled();
712
+ expect((globalThis as any).__lastDropdownOpen).toBe(false);
561
713
  } finally {
562
714
  dispose?.();
563
715
  }
@@ -9,7 +9,7 @@
9
9
 
10
10
  import { Switch } from 'antd';
11
11
  import _ from 'lodash';
12
- import React, { useMemo } from 'react';
12
+ import React, { useEffect, useMemo } from 'react';
13
13
  import { FlowModelContext } from '../../flowContext';
14
14
  import { FlowModel } from '../../models';
15
15
  import { CreateModelOptions, ModelConstructor } from '../../types';
@@ -542,6 +542,22 @@ const AddSubModelButtonCore = function AddSubModelButton({
542
542
  [model, subModelKey, subModelType],
543
543
  );
544
544
 
545
+ React.useEffect(() => {
546
+ const handleSubModelChanged = () => {
547
+ setRefreshTick((x) => x + 1);
548
+ };
549
+
550
+ model.emitter?.on('onSubModelAdded', handleSubModelChanged);
551
+ model.emitter?.on('onSubModelRemoved', handleSubModelChanged);
552
+ model.emitter?.on('onSubModelReplaced', handleSubModelChanged);
553
+
554
+ return () => {
555
+ model.emitter?.off('onSubModelAdded', handleSubModelChanged);
556
+ model.emitter?.off('onSubModelRemoved', handleSubModelChanged);
557
+ model.emitter?.off('onSubModelReplaced', handleSubModelChanged);
558
+ };
559
+ }, [model]);
560
+
545
561
  // 点击处理逻辑
546
562
  const onClick = async (info: any) => {
547
563
  const clickedItem = info.originalItem || info;
@@ -594,7 +610,7 @@ const AddSubModelButtonCore = function AddSubModelButton({
594
610
  let addedModel: FlowModel | undefined;
595
611
 
596
612
  try {
597
- addedModel = model.flowEngine.createModel({
613
+ addedModel = await model.flowEngine.createModelAsync({
598
614
  ..._.cloneDeep(createOpts),
599
615
  parentId: model.uid,
600
616
  subKey: subModelKey,
@@ -651,6 +667,20 @@ const AddSubModelButtonCore = function AddSubModelButton({
651
667
  [finalItems, model, subModelKey, subModelType],
652
668
  );
653
669
 
670
+ useEffect(() => {
671
+ const handleSubModelChange = () => {
672
+ setRefreshTick((x) => x + 1);
673
+ };
674
+
675
+ model.emitter.on('onSubModelAdded', handleSubModelChange);
676
+ model.emitter.on('onSubModelRemoved', handleSubModelChange);
677
+
678
+ return () => {
679
+ model.emitter.off('onSubModelAdded', handleSubModelChange);
680
+ model.emitter.off('onSubModelRemoved', handleSubModelChange);
681
+ };
682
+ }, [model]);
683
+
654
684
  return (
655
685
  <LazyDropdown
656
686
  menu={{
@@ -25,7 +25,7 @@ describe('AddSubModelButton - preset settings open on add', () => {
25
25
  test('calls openFlowSettings with preset=true for subModel with preset steps', async () => {
26
26
  // Arrange: set up engine and models
27
27
  const engine = new FlowEngine();
28
- engine.flowSettings.forceEnable();
28
+ await engine.flowSettings.forceEnable();
29
29
 
30
30
  class ParentModel extends FlowModel {}
31
31
 
@@ -99,12 +99,70 @@ describe('AddSubModelButton - preset settings open on add', () => {
99
99
  });
100
100
  });
101
101
 
102
+ describe('AddSubModelButton - model loader integration', () => {
103
+ test('resolves model loaders before creating sub models', async () => {
104
+ const engine = new FlowEngine();
105
+ await engine.flowSettings.forceEnable();
106
+
107
+ class ParentModel extends FlowModel {}
108
+ class ChildModel extends FlowModel {}
109
+
110
+ const childLoader = vi.fn(async () => ({ ChildModel }));
111
+
112
+ engine.registerModels({ ParentModel });
113
+ engine.registerModelLoaders({
114
+ ChildModel: {
115
+ loader: childLoader,
116
+ },
117
+ });
118
+
119
+ const parent = engine.createModel<ParentModel>({ use: 'ParentModel', uid: 'parent-loader' });
120
+
121
+ render(
122
+ <FlowEngineProvider engine={engine}>
123
+ <ConfigProvider>
124
+ <App>
125
+ <AddSubModelButton
126
+ model={parent}
127
+ subModelKey="items"
128
+ items={[
129
+ {
130
+ key: 'child',
131
+ label: 'Add Child',
132
+ createModelOptions: { use: 'ChildModel' },
133
+ },
134
+ ]}
135
+ >
136
+ Add SubModel
137
+ </AddSubModelButton>
138
+ </App>
139
+ </ConfigProvider>
140
+ </FlowEngineProvider>,
141
+ );
142
+
143
+ await act(async () => {
144
+ await userEvent.click(screen.getByText('Add SubModel'));
145
+ });
146
+
147
+ await waitFor(() => expect(screen.getByText('Add Child')).toBeInTheDocument());
148
+
149
+ await act(async () => {
150
+ await userEvent.click(screen.getByText('Add Child'));
151
+ });
152
+
153
+ await waitFor(() => expect(childLoader).toHaveBeenCalledTimes(1));
154
+ const items = parent.subModels.items as FlowModel[];
155
+ expect(Array.isArray(items)).toBe(true);
156
+ expect(items[0]).toBeInstanceOf(ChildModel);
157
+ });
158
+ });
159
+
102
160
  describe('AddSubModelButton - async group children (nested)', () => {
103
161
  const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
104
162
 
105
163
  it('renders group and nested async group leaf items', async () => {
106
164
  const engine = new FlowEngine();
107
- engine.flowSettings.forceEnable();
165
+ await engine.flowSettings.forceEnable();
108
166
  class Parent extends FlowModel {}
109
167
  engine.registerModels({ Parent });
110
168
  const parent = engine.createModel<FlowModel>({ use: 'Parent', uid: 'p1' });
@@ -162,7 +220,7 @@ describe('AddSubModelButton - async group children (nested)', () => {
162
220
  describe('transformItems - searchable flags', () => {
163
221
  it('preserves searchable + placeholder on non-group submenu items', async () => {
164
222
  const engine = new FlowEngine();
165
- engine.flowSettings.forceEnable();
223
+ await engine.flowSettings.forceEnable();
166
224
  class Parent extends FlowModel {}
167
225
  engine.registerModels({ Parent });
168
226
  const parent = engine.createModel<FlowModel>({ use: 'Parent' });
@@ -193,7 +251,7 @@ describe('transformItems - searchable flags', () => {
193
251
  describe('transformItems - hide', () => {
194
252
  it('filters items by hide flag/function recursively', async () => {
195
253
  const engine = new FlowEngine();
196
- engine.flowSettings.forceEnable();
254
+ await engine.flowSettings.forceEnable();
197
255
  class Parent extends FlowModel {}
198
256
  engine.registerModels({ Parent });
199
257
  const parent = engine.createModel<FlowModel>({ use: 'Parent', uid: 'p-hide' });
@@ -239,7 +297,7 @@ describe('transformItems - hide', () => {
239
297
 
240
298
  it('removes group when all children are hidden (even with async hide)', async () => {
241
299
  const engine = new FlowEngine();
242
- engine.flowSettings.forceEnable();
300
+ await engine.flowSettings.forceEnable();
243
301
  class Parent extends FlowModel {}
244
302
  engine.registerModels({ Parent });
245
303
  const parent = engine.createModel<FlowModel>({ use: 'Parent', uid: 'p-empty-group' });
@@ -272,7 +330,7 @@ describe('transformItems - hide', () => {
272
330
 
273
331
  it('supports async hide functions and disables cache', async () => {
274
332
  const engine = new FlowEngine();
275
- engine.flowSettings.forceEnable();
333
+ await engine.flowSettings.forceEnable();
276
334
  class Parent extends FlowModel {}
277
335
  engine.registerModels({ Parent });
278
336
  const parent = engine.createModel<FlowModel>({ use: 'Parent', uid: 'p-async-hide' });
@@ -300,7 +358,7 @@ describe('transformItems - hide', () => {
300
358
 
301
359
  it('shows items when hide function throws (conservative fallback)', async () => {
302
360
  const engine = new FlowEngine();
303
- engine.flowSettings.forceEnable();
361
+ await engine.flowSettings.forceEnable();
304
362
  class Parent extends FlowModel {}
305
363
  engine.registerModels({ Parent });
306
364
  const parent = engine.createModel<FlowModel>({ use: 'Parent', uid: 'p-hide-throws' });
@@ -331,15 +389,15 @@ describe('transformItems - toggleable items', () => {
331
389
  class ToggleParent extends FlowModel {}
332
390
  class ToggleChild extends FlowModel {}
333
391
 
334
- const setupEngine = () => {
392
+ const setupEngine = async () => {
335
393
  const engine = new FlowEngine();
336
- engine.flowSettings.forceEnable();
394
+ await engine.flowSettings.forceEnable();
337
395
  engine.registerModels({ ToggleParent, ToggleChild });
338
396
  return engine;
339
397
  };
340
398
 
341
399
  it('marks toggleable item as active when matching sub model exists', async () => {
342
- const engine = setupEngine();
400
+ const engine = await setupEngine();
343
401
  const parent = engine.createModel<ToggleParent>({ use: 'ToggleParent', uid: 'toggle-parent-on' });
344
402
  const child = engine.createModel<ToggleChild>({ use: 'ToggleChild', uid: 'toggle-child-on' });
345
403
  parent.addSubModel('items', child);
@@ -371,7 +429,7 @@ describe('transformItems - toggleable items', () => {
371
429
  });
372
430
 
373
431
  it('infers useModel from createModelOptions when toggleable is enabled', async () => {
374
- const engine = setupEngine();
432
+ const engine = await setupEngine();
375
433
  const parent = engine.createModel<ToggleParent>({ use: 'ToggleParent', uid: 'toggle-parent-infer' });
376
434
  const child = engine.createModel<ToggleChild>({ use: 'ToggleChild', uid: 'toggle-child-infer' });
377
435
  parent.addSubModel('items', child);
@@ -397,7 +455,7 @@ describe('transformItems - toggleable items', () => {
397
455
  });
398
456
 
399
457
  it('keeps toggleable item off when sub model missing', async () => {
400
- const engine = setupEngine();
458
+ const engine = await setupEngine();
401
459
  const parent = engine.createModel<ToggleParent>({ use: 'ToggleParent', uid: 'toggle-parent-off' });
402
460
 
403
461
  const definition: SubModelItem[] = [
@@ -420,7 +478,7 @@ describe('transformItems - toggleable items', () => {
420
478
  });
421
479
 
422
480
  it('respects keepDropdownOpen override on toggleable items', async () => {
423
- const engine = setupEngine();
481
+ const engine = await setupEngine();
424
482
  const parent = engine.createModel<ToggleParent>({ use: 'ToggleParent', uid: 'toggle-parent-keep' });
425
483
 
426
484
  const definition: SubModelItem[] = [
@@ -443,7 +501,7 @@ describe('transformItems - toggleable items', () => {
443
501
 
444
502
  it('removes object sub model via default remove handler when toggleDetector provided', async () => {
445
503
  const engine = new FlowEngine();
446
- engine.flowSettings.forceEnable();
504
+ await engine.flowSettings.forceEnable();
447
505
 
448
506
  class ObjectParent extends FlowModel {}
449
507
  class ObjectChild extends FlowModel {}
@@ -481,6 +539,8 @@ describe('transformItems - toggleable items', () => {
481
539
  </FlowEngineProvider>,
482
540
  );
483
541
 
542
+ await waitFor(() => expect(screen.getByText('Toggle Menu')).toBeInTheDocument());
543
+
484
544
  await act(async () => {
485
545
  await userEvent.click(screen.getByText('Toggle Menu'));
486
546
  });
@@ -519,16 +579,16 @@ describe('transformItems - caching behaviour', () => {
519
579
  class CacheParent extends FlowModel {}
520
580
  class CacheChild extends FlowModel {}
521
581
 
522
- const setupEngine = () => {
582
+ const setupEngine = async () => {
523
583
  const engine = new FlowEngine();
524
- engine.flowSettings.forceEnable();
584
+ await engine.flowSettings.forceEnable();
525
585
  engine.registerModels({ CacheParent, CacheChild });
526
586
  const parent = engine.createModel<CacheParent>({ use: 'CacheParent', uid: 'cache-parent' });
527
587
  return { engine, parent };
528
588
  };
529
589
 
530
590
  it('reuses cached result when no toggleable items exist', async () => {
531
- const { parent } = setupEngine();
591
+ const { parent } = await setupEngine();
532
592
  const definition: SubModelItem[] = [{ key: 'basic', label: 'Basic', createModelOptions: { use: 'CacheChild' } }];
533
593
 
534
594
  const factory = transformItems(definition, parent, 'items', 'array');
@@ -541,7 +601,7 @@ describe('transformItems - caching behaviour', () => {
541
601
  });
542
602
 
543
603
  it('refreshes toggle state after new sub model is added', async () => {
544
- const { parent, engine } = setupEngine();
604
+ const { parent, engine } = await setupEngine();
545
605
  const createDefinition = (): SubModelItem[] => [
546
606
  {
547
607
  key: 'toggleable',
@@ -570,7 +630,7 @@ describe('transformItems - caching behaviour', () => {
570
630
  describe('AddSubModelButton - refreshTargets linkage', () => {
571
631
  it('clicking an item with refreshTargets triggers toggle recomputation on target branch', async () => {
572
632
  const engine = new FlowEngine();
573
- engine.flowSettings.forceEnable();
633
+ await engine.flowSettings.forceEnable();
574
634
 
575
635
  class Parent extends FlowModel {}
576
636
  class ToggleModel extends FlowModel {}
@@ -642,7 +702,7 @@ describe('AddSubModelButton - base class menu groups', () => {
642
702
 
643
703
  it('renders async children provided by subModelBaseClasses', async () => {
644
704
  const engine = new FlowEngine();
645
- engine.flowSettings.forceEnable();
705
+ await engine.flowSettings.forceEnable();
646
706
 
647
707
  class Parent extends FlowModel {}
648
708
  class AsyncLeaf extends FlowModel {}
@@ -687,7 +747,7 @@ describe('AddSubModelButton - base class menu groups', () => {
687
747
 
688
748
  it('skips base class groups whose children resolve to empty', async () => {
689
749
  const engine = new FlowEngine();
690
- engine.flowSettings.forceEnable();
750
+ await engine.flowSettings.forceEnable();
691
751
 
692
752
  class Parent extends FlowModel {}
693
753
  class EmptyLeaf extends FlowModel {}
@@ -739,7 +799,7 @@ describe('AddSubModelButton - base class menu groups', () => {
739
799
 
740
800
  it('renders submenu base class with children and respects meta.sort', async () => {
741
801
  const engine = new FlowEngine();
742
- engine.flowSettings.forceEnable();
802
+ await engine.flowSettings.forceEnable();
743
803
 
744
804
  class Parent extends FlowModel {}
745
805
  class Leaf extends FlowModel {}
@@ -803,7 +863,7 @@ describe('AddSubModelButton - base class menu groups', () => {
803
863
 
804
864
  it('merges explicit items with base class and grouped sources', async () => {
805
865
  const engine = new FlowEngine();
806
- engine.flowSettings.forceEnable();
866
+ await engine.flowSettings.forceEnable();
807
867
 
808
868
  class Parent extends FlowModel {}
809
869
  class BaseChild extends FlowModel {}
@@ -862,7 +922,7 @@ describe('AddSubModelButton - base class menu groups', () => {
862
922
  describe('AddSubModelButton - toggle interactions', () => {
863
923
  it('removes existing toggleable sub model and triggers callbacks', async () => {
864
924
  const engine = new FlowEngine();
865
- engine.flowSettings.forceEnable();
925
+ await engine.flowSettings.forceEnable();
866
926
 
867
927
  class ToggleParent extends FlowModel {}
868
928
  const destroySpy = vi.fn();
@@ -926,7 +986,7 @@ describe('AddSubModelButton - toggle interactions', () => {
926
986
 
927
987
  it('creates toggleable sub model and runs lifecycle callbacks', async () => {
928
988
  const engine = new FlowEngine();
929
- engine.flowSettings.forceEnable();
989
+ await engine.flowSettings.forceEnable();
930
990
 
931
991
  class ToggleParent extends FlowModel {}
932
992
  const saveSpy = vi.fn();
@@ -995,6 +1055,56 @@ describe('AddSubModelButton - toggle interactions', () => {
995
1055
  const subModels = ((parent.subModels as any).items as FlowModel[]) || [];
996
1056
  expect(subModels).toHaveLength(1);
997
1057
  });
1058
+
1059
+ it('updates toggle state after external sub model removal', async () => {
1060
+ const engine = new FlowEngine();
1061
+ await engine.flowSettings.forceEnable();
1062
+
1063
+ class ToggleParent extends FlowModel {}
1064
+ class ToggleChild extends FlowModel {}
1065
+
1066
+ engine.registerModels({ ToggleParent, ToggleChild });
1067
+ const parent = engine.createModel<ToggleParent>({ use: 'ToggleParent', uid: 'toggle-parent-external-remove' });
1068
+ const existing = engine.createModel<ToggleChild>({ use: 'ToggleChild', uid: 'toggle-child-external-remove' });
1069
+ parent.addSubModel('items', existing);
1070
+
1071
+ render(
1072
+ <FlowEngineProvider engine={engine}>
1073
+ <ConfigProvider>
1074
+ <App>
1075
+ <AddSubModelButton
1076
+ model={parent}
1077
+ subModelKey="items"
1078
+ items={[
1079
+ {
1080
+ key: 'toggle-child',
1081
+ label: 'Toggle Child',
1082
+ toggleable: true,
1083
+ useModel: 'ToggleChild',
1084
+ createModelOptions: { use: 'ToggleChild' },
1085
+ },
1086
+ ]}
1087
+ >
1088
+ Toggle Menu
1089
+ </AddSubModelButton>
1090
+ </App>
1091
+ </ConfigProvider>
1092
+ </FlowEngineProvider>,
1093
+ );
1094
+
1095
+ await act(async () => {
1096
+ await userEvent.click(screen.getByText('Toggle Menu'));
1097
+ });
1098
+
1099
+ await waitFor(() => expect(screen.getByText('Toggle Child')).toBeInTheDocument());
1100
+ await waitFor(() => expect(screen.getByRole('switch')).toHaveAttribute('aria-checked', 'true'));
1101
+
1102
+ await act(async () => {
1103
+ await existing.destroy();
1104
+ });
1105
+
1106
+ await waitFor(() => expect(screen.getByRole('switch')).toHaveAttribute('aria-checked', 'false'));
1107
+ });
998
1108
  });
999
1109
 
1000
1110
  // ========================
@@ -1007,15 +1117,16 @@ describe('AddSubModelButton toggleable behavior', () => {
1007
1117
  // Minimal fake repository for save/destroy
1008
1118
  class FakeRepo implements IFlowModelRepository<any> {
1009
1119
  findOne = vi.fn().mockResolvedValue(null);
1120
+ ensure = vi.fn(async (values: any) => await this.findOne(values));
1010
1121
  save = vi.fn().mockResolvedValue({});
1011
1122
  destroy = vi.fn().mockResolvedValue(true);
1012
1123
  move = vi.fn().mockResolvedValue(undefined);
1013
1124
  duplicate = vi.fn().mockResolvedValue(null);
1014
1125
  }
1015
1126
 
1016
- function setup() {
1127
+ async function setup() {
1017
1128
  const engine = new FlowEngine();
1018
- engine.flowSettings.forceEnable();
1129
+ await engine.flowSettings.forceEnable();
1019
1130
  engine.registerModels({ ToggleModel });
1020
1131
  engine.setModelRepository(new FakeRepo());
1021
1132
 
@@ -1068,7 +1179,7 @@ describe('AddSubModelButton toggleable behavior', () => {
1068
1179
  });
1069
1180
 
1070
1181
  test('keeps dropdown open and preserves loaded children on toggle add/remove', async () => {
1071
- const { engine, ui } = setup();
1182
+ const { engine, ui } = await setup();
1072
1183
  const user = userEvent.setup();
1073
1184
 
1074
1185
  render(ui);
@@ -1113,7 +1224,7 @@ describe('AddSubModelButton toggleable behavior', () => {
1113
1224
  });
1114
1225
 
1115
1226
  test('toggle state updates without menu closing', async () => {
1116
- const { ui } = setup();
1227
+ const { ui } = await setup();
1117
1228
  const user = userEvent.setup();
1118
1229
 
1119
1230
  render(ui);
@@ -1131,7 +1242,7 @@ describe('AddSubModelButton toggleable behavior', () => {
1131
1242
 
1132
1243
  test('nested submenu (static items) toggle keeps menu open and reflects state', async () => {
1133
1244
  const engine = new FlowEngine();
1134
- engine.flowSettings.forceEnable();
1245
+ await engine.flowSettings.forceEnable();
1135
1246
  engine.registerModels({ ToggleModel });
1136
1247
  const parent = engine.createModel<FlowModel>({ use: FlowModel });
1137
1248
 
@@ -1213,7 +1324,7 @@ describe('AddSubModelButton toggleable behavior', () => {
1213
1324
 
1214
1325
  test('submenu (second-level) toggleable stays open and updates state', async () => {
1215
1326
  const engine = new FlowEngine();
1216
- engine.flowSettings.forceEnable();
1327
+ await engine.flowSettings.forceEnable();
1217
1328
  engine.registerModels({ ToggleModel });
1218
1329
  engine.setModelRepository(new FakeRepo());
1219
1330
  vi.spyOn(engine.flowSettings, 'open').mockResolvedValue(false as any);
@@ -1272,7 +1383,7 @@ describe('AddSubModelButton toggleable behavior', () => {
1272
1383
 
1273
1384
  test('top-level toggle updates after opening a second-level branch', async () => {
1274
1385
  const engine = new FlowEngine();
1275
- engine.flowSettings.forceEnable();
1386
+ await engine.flowSettings.forceEnable();
1276
1387
  engine.registerModels({ ToggleModel });
1277
1388
  engine.setModelRepository(new FakeRepo());
1278
1389
  vi.spyOn(engine.flowSettings, 'open').mockResolvedValue(false as any);