@nocobase/flow-engine 2.1.0-alpha.3 → 2.1.0-alpha.31

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 (165) hide show
  1. package/LICENSE +201 -661
  2. package/README.md +79 -10
  3. package/lib/JSRunner.d.ts +10 -1
  4. package/lib/JSRunner.js +50 -5
  5. package/lib/ViewScopedFlowEngine.js +5 -1
  6. package/lib/components/FieldModelRenderer.js +2 -2
  7. package/lib/components/FlowModelRenderer.d.ts +3 -1
  8. package/lib/components/FlowModelRenderer.js +12 -6
  9. package/lib/components/FormItem.d.ts +6 -0
  10. package/lib/components/FormItem.js +11 -3
  11. package/lib/components/MobilePopup.js +6 -5
  12. package/lib/components/dnd/gridDragPlanner.d.ts +59 -2
  13. package/lib/components/dnd/gridDragPlanner.js +613 -21
  14. package/lib/components/dnd/index.d.ts +19 -1
  15. package/lib/components/dnd/index.js +243 -23
  16. package/lib/components/settings/wrappers/component/SelectWithTitle.d.ts +2 -1
  17. package/lib/components/settings/wrappers/component/SelectWithTitle.js +14 -12
  18. package/lib/components/settings/wrappers/contextual/DefaultSettingsIcon.d.ts +3 -0
  19. package/lib/components/settings/wrappers/contextual/DefaultSettingsIcon.js +68 -10
  20. package/lib/components/settings/wrappers/contextual/FlowsFloatContextMenu.d.ts +23 -43
  21. package/lib/components/settings/wrappers/contextual/FlowsFloatContextMenu.js +352 -295
  22. package/lib/components/settings/wrappers/contextual/StepSettingsDialog.js +16 -2
  23. package/lib/components/settings/wrappers/contextual/useFloatToolbarPortal.d.ts +36 -0
  24. package/lib/components/settings/wrappers/contextual/useFloatToolbarPortal.js +274 -0
  25. package/lib/components/settings/wrappers/contextual/useFloatToolbarVisibility.d.ts +30 -0
  26. package/lib/components/settings/wrappers/contextual/useFloatToolbarVisibility.js +315 -0
  27. package/lib/components/subModel/AddSubModelButton.js +27 -1
  28. package/lib/components/subModel/index.d.ts +1 -0
  29. package/lib/components/subModel/index.js +19 -0
  30. package/lib/components/subModel/utils.d.ts +1 -1
  31. package/lib/components/subModel/utils.js +2 -2
  32. package/lib/data-source/index.d.ts +75 -0
  33. package/lib/data-source/index.js +246 -4
  34. package/lib/executor/FlowExecutor.js +31 -8
  35. package/lib/flowContext.d.ts +2 -0
  36. package/lib/flowContext.js +31 -1
  37. package/lib/flowEngine.d.ts +151 -1
  38. package/lib/flowEngine.js +389 -15
  39. package/lib/flowI18n.js +2 -1
  40. package/lib/flowSettings.d.ts +14 -6
  41. package/lib/flowSettings.js +34 -6
  42. package/lib/lazy-helper.d.ts +14 -0
  43. package/lib/lazy-helper.js +71 -0
  44. package/lib/locale/en-US.json +1 -0
  45. package/lib/locale/index.d.ts +2 -0
  46. package/lib/locale/zh-CN.json +1 -0
  47. package/lib/models/DisplayItemModel.d.ts +1 -1
  48. package/lib/models/EditableItemModel.d.ts +1 -1
  49. package/lib/models/FilterableItemModel.d.ts +1 -1
  50. package/lib/models/flowModel.d.ts +13 -10
  51. package/lib/models/flowModel.js +78 -18
  52. package/lib/provider.js +38 -23
  53. package/lib/reactive/observer.js +46 -16
  54. package/lib/runjs-context/registry.d.ts +1 -1
  55. package/lib/runjs-context/setup.js +20 -12
  56. package/lib/runjs-context/snippets/index.js +13 -2
  57. package/lib/runjs-context/snippets/scene/detail/set-field-style.snippet.d.ts +11 -0
  58. package/lib/runjs-context/snippets/scene/detail/set-field-style.snippet.js +50 -0
  59. package/lib/runjs-context/snippets/scene/table/set-cell-style.snippet.d.ts +11 -0
  60. package/lib/runjs-context/snippets/scene/table/set-cell-style.snippet.js +54 -0
  61. package/lib/scheduler/ModelOperationScheduler.d.ts +5 -1
  62. package/lib/scheduler/ModelOperationScheduler.js +3 -2
  63. package/lib/types.d.ts +47 -1
  64. package/lib/utils/createCollectionContextMeta.js +6 -2
  65. package/lib/utils/index.d.ts +2 -2
  66. package/lib/utils/index.js +4 -0
  67. package/lib/utils/parsePathnameToViewParams.js +1 -1
  68. package/lib/utils/runjsTemplateCompat.js +1 -1
  69. package/lib/utils/runjsValue.js +41 -11
  70. package/lib/utils/schema-utils.d.ts +7 -1
  71. package/lib/utils/schema-utils.js +19 -0
  72. package/lib/views/FlowView.d.ts +7 -1
  73. package/lib/views/runViewBeforeClose.d.ts +10 -0
  74. package/lib/views/runViewBeforeClose.js +45 -0
  75. package/lib/views/useDialog.d.ts +2 -1
  76. package/lib/views/useDialog.js +20 -3
  77. package/lib/views/useDrawer.d.ts +2 -1
  78. package/lib/views/useDrawer.js +20 -3
  79. package/lib/views/usePage.d.ts +2 -1
  80. package/lib/views/usePage.js +10 -3
  81. package/package.json +6 -5
  82. package/src/JSRunner.ts +68 -4
  83. package/src/ViewScopedFlowEngine.ts +4 -0
  84. package/src/__tests__/JSRunner.test.ts +27 -1
  85. package/src/__tests__/flow-engine.test.ts +166 -0
  86. package/src/__tests__/flowContext.test.ts +65 -1
  87. package/src/__tests__/flowEngine.modelLoaders.test.ts +245 -0
  88. package/src/__tests__/flowSettings.test.ts +94 -15
  89. package/src/__tests__/objectVariable.test.ts +24 -0
  90. package/src/__tests__/provider.test.tsx +24 -2
  91. package/src/__tests__/renderHiddenInConfig.test.tsx +6 -6
  92. package/src/__tests__/runjsContext.test.ts +16 -0
  93. package/src/__tests__/runjsContextRuntime.test.ts +2 -0
  94. package/src/__tests__/runjsPreprocessDefault.test.ts +23 -0
  95. package/src/__tests__/runjsSnippets.test.ts +21 -0
  96. package/src/__tests__/viewScopedFlowEngine.test.ts +3 -3
  97. package/src/components/FieldModelRenderer.tsx +2 -1
  98. package/src/components/FlowModelRenderer.tsx +18 -6
  99. package/src/components/FormItem.tsx +7 -1
  100. package/src/components/MobilePopup.tsx +4 -2
  101. package/src/components/__tests__/FlowModelRenderer.test.tsx +65 -2
  102. package/src/components/__tests__/FormItem.test.tsx +25 -0
  103. package/src/components/__tests__/dnd.test.ts +44 -0
  104. package/src/components/__tests__/flow-model-render-error-fallback.test.tsx +20 -10
  105. package/src/components/__tests__/gridDragPlanner.test.ts +558 -3
  106. package/src/components/dnd/__tests__/DndProvider.test.tsx +98 -0
  107. package/src/components/dnd/gridDragPlanner.ts +758 -19
  108. package/src/components/dnd/index.tsx +291 -27
  109. package/src/components/settings/wrappers/component/SelectWithTitle.tsx +21 -9
  110. package/src/components/settings/wrappers/contextual/DefaultSettingsIcon.tsx +88 -10
  111. package/src/components/settings/wrappers/contextual/FlowsFloatContextMenu.tsx +487 -440
  112. package/src/components/settings/wrappers/contextual/StepSettingsDialog.tsx +18 -2
  113. package/src/components/settings/wrappers/contextual/__tests__/DefaultSettingsIcon.test.tsx +189 -3
  114. package/src/components/settings/wrappers/contextual/__tests__/FlowsFloatContextMenu.test.tsx +778 -0
  115. package/src/components/settings/wrappers/contextual/useFloatToolbarPortal.ts +360 -0
  116. package/src/components/settings/wrappers/contextual/useFloatToolbarVisibility.ts +361 -0
  117. package/src/components/subModel/AddSubModelButton.tsx +32 -2
  118. package/src/components/subModel/__tests__/AddSubModelButton.test.tsx +142 -32
  119. package/src/components/subModel/index.ts +1 -0
  120. package/src/components/subModel/utils.ts +1 -1
  121. package/src/data-source/__tests__/collection.test.ts +41 -2
  122. package/src/data-source/__tests__/index.test.ts +68 -1
  123. package/src/data-source/index.ts +303 -5
  124. package/src/executor/FlowExecutor.ts +34 -9
  125. package/src/executor/__tests__/flowExecutor.test.ts +57 -0
  126. package/src/flowContext.ts +37 -3
  127. package/src/flowEngine.ts +445 -11
  128. package/src/flowI18n.ts +2 -1
  129. package/src/flowSettings.ts +40 -6
  130. package/src/lazy-helper.tsx +57 -0
  131. package/src/locale/en-US.json +1 -0
  132. package/src/locale/zh-CN.json +1 -0
  133. package/src/models/DisplayItemModel.tsx +1 -1
  134. package/src/models/EditableItemModel.tsx +1 -1
  135. package/src/models/FilterableItemModel.tsx +1 -1
  136. package/src/models/__tests__/dispatchEvent.when.test.ts +214 -0
  137. package/src/models/__tests__/flowModel.test.ts +19 -3
  138. package/src/models/flowModel.tsx +119 -33
  139. package/src/provider.tsx +41 -25
  140. package/src/reactive/__tests__/observer.test.tsx +82 -0
  141. package/src/reactive/observer.tsx +87 -25
  142. package/src/runjs-context/registry.ts +1 -1
  143. package/src/runjs-context/setup.ts +22 -12
  144. package/src/runjs-context/snippets/index.ts +12 -1
  145. package/src/runjs-context/snippets/scene/detail/set-field-style.snippet.ts +30 -0
  146. package/src/runjs-context/snippets/scene/table/set-cell-style.snippet.ts +34 -0
  147. package/src/scheduler/ModelOperationScheduler.ts +14 -3
  148. package/src/types.ts +60 -0
  149. package/src/utils/__tests__/createCollectionContextMeta.test.ts +48 -0
  150. package/src/utils/__tests__/parsePathnameToViewParams.test.ts +7 -0
  151. package/src/utils/__tests__/runjsValue.test.ts +11 -0
  152. package/src/utils/__tests__/utils.test.ts +62 -0
  153. package/src/utils/createCollectionContextMeta.ts +6 -2
  154. package/src/utils/index.ts +2 -1
  155. package/src/utils/parsePathnameToViewParams.ts +2 -2
  156. package/src/utils/runjsTemplateCompat.ts +1 -1
  157. package/src/utils/runjsValue.ts +50 -11
  158. package/src/utils/schema-utils.ts +30 -1
  159. package/src/views/FlowView.tsx +11 -1
  160. package/src/views/__tests__/runViewBeforeClose.test.ts +30 -0
  161. package/src/views/__tests__/useDialog.closeDestroy.test.tsx +13 -12
  162. package/src/views/runViewBeforeClose.ts +19 -0
  163. package/src/views/useDialog.tsx +25 -3
  164. package/src/views/useDrawer.tsx +25 -3
  165. package/src/views/usePage.tsx +12 -3
@@ -134,6 +134,17 @@ const openStepSettingsDialog = async ({
134
134
  };
135
135
 
136
136
  const openView = model.context.viewer[mode].bind(model.context.viewer);
137
+ const resolvedUiModeProps = toJS(uiModeProps) || {};
138
+ const { zIndex: uiModeZIndex, ...restUiModeProps } = resolvedUiModeProps;
139
+ const resolveDialogZIndex = (rawZIndex?: number) => {
140
+ const nextZIndex =
141
+ typeof model.context.viewer?.getNextZIndex === 'function'
142
+ ? model.context.viewer.getNextZIndex()
143
+ : (model.context.themeToken?.zIndexPopupBase || 1000) + 1;
144
+ const inputZIndex = Number(rawZIndex) || 0;
145
+ return Math.max(nextZIndex, inputZIndex);
146
+ };
147
+ const mergedZIndex = resolveDialogZIndex(uiModeZIndex);
137
148
 
138
149
  const form = createForm({
139
150
  initialValues: compileUiSchema(scopes, initialValues),
@@ -152,7 +163,8 @@ const openStepSettingsDialog = async ({
152
163
  title: dialogTitle || t(title),
153
164
  width: dialogWidth,
154
165
  destroyOnClose: true,
155
- ...toJS(uiModeProps),
166
+ ...restUiModeProps,
167
+ zIndex: mergedZIndex,
156
168
  // 透传 navigation,便于变量元信息根据真实视图栈推断父级弹窗
157
169
  inputArgs,
158
170
  onClose: () => {
@@ -165,7 +177,11 @@ const openStepSettingsDialog = async ({
165
177
  useEffect(() => {
166
178
  return autorun(() => {
167
179
  const dynamicProps = toJS(uiModeProps);
168
- currentDialog.update(dynamicProps);
180
+ const { zIndex, ...restDynamicProps } = dynamicProps || {};
181
+ currentDialog.update({
182
+ ...restDynamicProps,
183
+ zIndex: resolveDialogZIndex(zIndex),
184
+ });
169
185
  });
170
186
  }, []);
171
187
 
@@ -37,6 +37,7 @@ vi.mock('antd', async (importOriginal) => {
37
37
  (globalThis as any).__lastDropdownMenu = props.menu;
38
38
  (globalThis as any).__lastDropdownOnOpenChange = props.onOpenChange;
39
39
  (globalThis as any).__lastDropdownOpen = props.open;
40
+ (globalThis as any).__lastDropdownGetPopupContainer = props.getPopupContainer;
40
41
  dropdownMenus.push(props.menu);
41
42
  return React.createElement('span', { 'data-testid': 'dropdown' }, props.children);
42
43
  };
@@ -105,7 +106,7 @@ const findElement = (node: any, predicate: (element: React.ReactElement) => bool
105
106
  return node;
106
107
  }
107
108
 
108
- const children = React.Children.toArray(node.props?.children);
109
+ const children = React.Children.toArray((node as React.ReactElement<any>).props?.children);
109
110
  for (const child of children) {
110
111
  const matched = findElement(child, predicate);
111
112
  if (matched) {
@@ -132,6 +133,7 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
132
133
  (globalThis as any).__lastDropdownMenu = undefined;
133
134
  (globalThis as any).__lastDropdownOnOpenChange = undefined;
134
135
  (globalThis as any).__lastDropdownOpen = undefined;
136
+ (globalThis as any).__lastDropdownGetPopupContainer = undefined;
135
137
  });
136
138
 
137
139
  afterEach(() => {
@@ -322,7 +324,9 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
322
324
  );
323
325
  expect(tooltipElement).toBeTruthy();
324
326
 
325
- const iconElement = React.isValidElement(tooltipElement) ? tooltipElement.props.children : null;
327
+ const iconElement = React.isValidElement(tooltipElement)
328
+ ? (tooltipElement as React.ReactElement<any>).props.children
329
+ : null;
326
330
  expect(React.isValidElement(iconElement)).toBe(true);
327
331
  expect((iconElement as any).props?.style?.color).toBe(mockColorTextTertiary);
328
332
 
@@ -414,6 +418,99 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
414
418
  });
415
419
  });
416
420
 
421
+ it('prefers the local toolbar container as popup host inside contextual toolbars', async () => {
422
+ class TestFlowModel extends FlowModel {}
423
+ const engine = new FlowEngine();
424
+ const model = new TestFlowModel({ uid: 'm-toolbar-popup-host', flowEngine: engine });
425
+ const externalPopupRoot = document.createElement('div');
426
+ externalPopupRoot.id = 'external-popup-root';
427
+ document.body.appendChild(externalPopupRoot);
428
+
429
+ TestFlowModel.registerFlow({
430
+ key: 'flowPopupHost',
431
+ title: 'Flow Popup Host',
432
+ steps: {
433
+ general: { title: 'General', uiSchema: { f: { type: 'string', 'x-component': 'Input' } } },
434
+ },
435
+ });
436
+
437
+ const { getByTestId, unmount } = render(
438
+ React.createElement(
439
+ ConfigProvider as any,
440
+ null,
441
+ React.createElement(
442
+ App as any,
443
+ null,
444
+ React.createElement(
445
+ 'div',
446
+ { className: 'nb-toolbar-container' },
447
+ React.createElement(
448
+ 'div',
449
+ { className: 'nb-toolbar-container-icons' },
450
+ React.createElement(DefaultSettingsIcon as any, {
451
+ model,
452
+ getPopupContainer: () => externalPopupRoot,
453
+ }),
454
+ ),
455
+ ),
456
+ ),
457
+ ),
458
+ );
459
+
460
+ await waitFor(() => {
461
+ expect((globalThis as any).__lastDropdownGetPopupContainer).toBeTruthy();
462
+ });
463
+
464
+ const popupContainer = (globalThis as any).__lastDropdownGetPopupContainer?.(getByTestId('dropdown'));
465
+ expect(popupContainer).toBeTruthy();
466
+ expect(popupContainer?.className).toContain('nb-toolbar-container-icons');
467
+
468
+ unmount();
469
+ externalPopupRoot.remove();
470
+ });
471
+
472
+ it('falls back to the provided popup host outside contextual toolbars', async () => {
473
+ class TestFlowModel extends FlowModel {}
474
+ const engine = new FlowEngine();
475
+ const model = new TestFlowModel({ uid: 'm-external-popup-host', flowEngine: engine });
476
+ const externalPopupRoot = document.createElement('div');
477
+ externalPopupRoot.id = 'external-popup-root';
478
+ document.body.appendChild(externalPopupRoot);
479
+
480
+ TestFlowModel.registerFlow({
481
+ key: 'flowExternalPopupHost',
482
+ title: 'Flow External Popup Host',
483
+ steps: {
484
+ general: { title: 'General', uiSchema: { f: { type: 'string', 'x-component': 'Input' } } },
485
+ },
486
+ });
487
+
488
+ const { getByTestId, unmount } = render(
489
+ React.createElement(
490
+ ConfigProvider as any,
491
+ null,
492
+ React.createElement(
493
+ App as any,
494
+ null,
495
+ React.createElement(DefaultSettingsIcon as any, {
496
+ model,
497
+ getPopupContainer: () => externalPopupRoot,
498
+ }),
499
+ ),
500
+ ),
501
+ );
502
+
503
+ await waitFor(() => {
504
+ expect((globalThis as any).__lastDropdownGetPopupContainer).toBeTruthy();
505
+ });
506
+
507
+ const popupContainer = (globalThis as any).__lastDropdownGetPopupContainer?.(getByTestId('dropdown'));
508
+ expect(popupContainer).toBe(externalPopupRoot);
509
+
510
+ unmount();
511
+ externalPopupRoot.remove();
512
+ });
513
+
417
514
  it('copy UID action writes model uid to clipboard', async () => {
418
515
  class TestFlowModel extends FlowModel {}
419
516
  const engine = new FlowEngine();
@@ -517,7 +614,9 @@ describe('DefaultSettingsIcon - only static flows are shown', () => {
517
614
  const items = (menu?.items || []) as any[];
518
615
  const subMenu = items.find((it) => Array.isArray(it?.children));
519
616
  expect(subMenu).toBeTruthy();
520
- expect(subMenu!.children.some((it: any) => String(it.key).startsWith('items[0]:childFlow:cstep'))).toBe(true);
617
+ expect((subMenu?.children || []).some((it: any) => String(it.key).startsWith('items[0]:childFlow:cstep'))).toBe(
618
+ true,
619
+ );
521
620
  });
522
621
  });
523
622
 
@@ -714,4 +813,91 @@ describe('DefaultSettingsIcon - extra menu items', () => {
714
813
  dispose?.();
715
814
  }
716
815
  });
816
+
817
+ it('supports nested extra menu items with sorting and disabled states', async () => {
818
+ const onInsertBefore = vi.fn();
819
+ const onInsertAfter = vi.fn();
820
+
821
+ class TestFlowModel extends FlowModel {}
822
+ const dispose = TestFlowModel.registerExtraMenuItems({
823
+ group: 'common-actions',
824
+ sort: 10,
825
+ items: [
826
+ {
827
+ key: 'insert-actions',
828
+ label: 'Insert actions',
829
+ children: [
830
+ { key: 'insert-after', label: 'Insert after', sort: 20, onClick: onInsertAfter },
831
+ { key: 'insert-before', label: 'Insert before', sort: 10, onClick: onInsertBefore },
832
+ { key: 'insert-inner', label: 'Insert inner', sort: 30, disabled: true, onClick: vi.fn() },
833
+ ],
834
+ },
835
+ ],
836
+ });
837
+
838
+ const engine = new FlowEngine();
839
+ const model = new TestFlowModel({ uid: 'm-extra-nested', flowEngine: engine });
840
+
841
+ TestFlowModel.registerFlow({
842
+ key: 'flow',
843
+ title: 'Flow',
844
+ steps: { s: { title: 'S', uiSchema: { f: { type: 'string', 'x-component': 'Input' } } } },
845
+ });
846
+
847
+ try {
848
+ render(
849
+ React.createElement(
850
+ ConfigProvider as any,
851
+ null,
852
+ React.createElement(
853
+ App as any,
854
+ null,
855
+ React.createElement(DefaultSettingsIcon as any, {
856
+ model,
857
+ showCopyUidButton: false,
858
+ showDeleteButton: false,
859
+ }),
860
+ ),
861
+ ),
862
+ );
863
+
864
+ await waitFor(() => {
865
+ expect((globalThis as any).__lastDropdownMenu).toBeTruthy();
866
+ expect((globalThis as any).__lastDropdownOnOpenChange).toBeTruthy();
867
+ });
868
+
869
+ await act(async () => {
870
+ (globalThis as any).__lastDropdownOnOpenChange?.(true, { source: 'trigger' });
871
+ });
872
+
873
+ await waitFor(() => {
874
+ const menu = (globalThis as any).__lastDropdownMenu;
875
+ const items = (menu?.items || []) as any[];
876
+ const nested = items.find((it) => String(it.key || '') === 'insert-actions');
877
+ expect(nested).toBeTruthy();
878
+ expect((nested.children || []).map((it) => String(it.key || ''))).toEqual([
879
+ 'insert-before',
880
+ 'insert-after',
881
+ 'insert-inner',
882
+ ]);
883
+ expect((nested.children || []).find((it) => String(it.key || '') === 'insert-inner')?.disabled).toBe(true);
884
+ });
885
+
886
+ const menu = (globalThis as any).__lastDropdownMenu;
887
+ await act(async () => {
888
+ menu.onClick?.({ key: 'insert-inner' });
889
+ });
890
+ expect(onInsertBefore).not.toHaveBeenCalled();
891
+ expect(onInsertAfter).not.toHaveBeenCalled();
892
+ expect((globalThis as any).__lastDropdownOpen).toBe(true);
893
+
894
+ await act(async () => {
895
+ menu.onClick?.({ key: 'insert-before' });
896
+ });
897
+ expect(onInsertBefore).toHaveBeenCalledTimes(1);
898
+ expect((globalThis as any).__lastDropdownOpen).toBe(false);
899
+ } finally {
900
+ dispose?.();
901
+ }
902
+ });
717
903
  });