@nocobase/plugin-flow-engine 2.1.0-alpha.14 → 2.1.0-alpha.16

package/dist/server/flow-surfaces/catalog.js

@@ -52,6 +52,7 @@ module.exports = __toCommonJS(catalog_exports);
 var import_action_scope = require("./action-scope");
 var import_errors = require("./errors");
 var import_field_semantics = require("./field-semantics");
+var import_field_binding_registry = require("./field-binding-registry");
 var import_support_matrix = require("./support-matrix");
 const ANY_VALUE_SCHEMA = {};
 const STRING_SCHEMA = { type: "string" };
@@ -111,7 +112,10 @@ const OPEN_VIEW_ALLOWED_PATHS = [
   "openView.title",
   "openView.uid",
   "openView.subModelKey",
-  "openView.navigation"
+  "openView.navigation",
+  "openView.template",
+  "openView.template.uid",
+  "openView.template.mode"
 ];
 const OPEN_VIEW_PATH_SCHEMAS = {
   "openView.mode": OPEN_VIEW_MODE_SCHEMA,
@@ -126,7 +130,13 @@ const OPEN_VIEW_PATH_SCHEMAS = {
   "openView.title": STRING_SCHEMA,
   "openView.uid": STRING_SCHEMA,
   "openView.subModelKey": STRING_SCHEMA,
-  "openView.navigation": BOOLEAN_SCHEMA
+  "openView.navigation": BOOLEAN_SCHEMA,
+  "openView.template": OBJECT_SCHEMA,
+  "openView.template.uid": STRING_SCHEMA,
+  "openView.template.mode": {
+    type: "string",
+    enum: ["reference", "copy"]
+  }
 };
 const CONFIRM_ALLOWED_PATHS = ["confirm.enable", "confirm.title", "confirm.content"];
 const TABLE_COLUMN_ALLOWED_PATHS = ["title.title"];
@@ -264,6 +274,14 @@ const FILTER_FORM_BLOCK_SETTINGS_GROUP = {
     "defaultValues.value": ARRAY_SCHEMA
   }
 };
+const BLOCK_LINKAGE_CARD_SETTINGS_GROUP = {
+  allowedPaths: ["linkageRules"],
+  mergeStrategy: "deep",
+  eventBindingSteps: ["linkageRules"],
+  pathSchemas: {
+    linkageRules: ARRAY_SCHEMA
+  }
+};
 const TABLE_SETTINGS_GROUP = {
   allowedPaths: [
     "quickEdit.editable",
@@ -308,6 +326,9 @@ const FLOW_SURFACE_BLOCK_OWNER_PLUGIN_BY_USE = new Map(
 );
 const JS_EDITABLE_FIELD_USE_SET = /* @__PURE__ */ new Set(["JSEditableFieldModel"]);
 const JS_DISPLAY_FIELD_USE_SET = /* @__PURE__ */ new Set(["JSFieldModel"]);
+const REGISTERED_EDITABLE_FIELD_USE_SET = (0, import_field_binding_registry.getRegisteredFieldUses)("editable");
+const REGISTERED_DISPLAY_FIELD_USE_SET = (0, import_field_binding_registry.getRegisteredFieldUses)("display");
+const REGISTERED_FILTER_FIELD_USE_SET = (0, import_field_binding_registry.getRegisteredFieldUses)("filter");
 const EDITABLE_FIELD_USE_SET = /* @__PURE__ */ new Set([
   ...JS_EDITABLE_FIELD_USE_SET,
   "RecordSelectFieldModel",
@@ -360,7 +381,10 @@ const FILTER_FIELD_USE_SET = /* @__PURE__ */ new Set([
 const KNOWN_FIELD_NODE_USES = /* @__PURE__ */ new Set([
   ...EDITABLE_FIELD_USE_SET,
   ...DISPLAY_FIELD_USE_SET,
-  ...FILTER_FIELD_USE_SET
+  ...FILTER_FIELD_USE_SET,
+  ...REGISTERED_EDITABLE_FIELD_USE_SET,
+  ...REGISTERED_DISPLAY_FIELD_USE_SET,
+  ...REGISTERED_FILTER_FIELD_USE_SET
 ]);
 function keyedDomain(allowedKeys, mergeStrategy = "deep") {
   return {
@@ -508,6 +532,29 @@ const GRID_NODE_CONTRACT = createContract({
   }
 });
 GRID_NODE_CONTRACT.domains.props = keyedDomain(["rows", "sizes", "rowOrder"], "replace");
+const FORM_GRID_NODE_CONTRACT = createContract({
+  editableDomains: ["props", "stepParams", "flowRegistry"],
+  props: ["rows", "sizes", "rowOrder"],
+  stepParams: ["formModelSettings", "eventSettings"],
+  flowRegistry: true,
+  layoutCapabilities: GRID_LAYOUT_CAPABILITIES,
+  eventCapabilities: {
+    direct: DEFAULT_DIRECT_EVENTS
+  },
+  eventBindings: {
+    formModelSettings: {
+      stepKeys: ["layout", "assignRules"]
+    },
+    eventSettings: {
+      stepKeys: ["linkageRules"]
+    }
+  }
+});
+FORM_GRID_NODE_CONTRACT.domains.props = keyedDomain(["rows", "sizes", "rowOrder"], "replace");
+FORM_GRID_NODE_CONTRACT.domains.stepParams = groupedDomain({
+  formModelSettings: FORM_MODEL_SETTINGS_GROUP,
+  eventSettings: EVENT_SETTINGS_GROUP
+});
 const PAGE_NODE_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "enableTabs", "icon", "enableHeader"],
@@ -574,7 +621,7 @@ const TABLE_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "height", "heightMode"],
   decoratorProps: ["height", "heightMode"],
-  stepParams: ["resourceSettings", "tableSettings"],
+  stepParams: ["resourceSettings", "tableSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: ["beforeRender", "paginationChange"],
@@ -583,13 +630,14 @@ const TABLE_BLOCK_CONTRACT = createContract({
 });
 TABLE_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   resourceSettings: RESOURCE_SETTINGS_GROUP,
-  tableSettings: TABLE_SETTINGS_GROUP
+  tableSettings: TABLE_SETTINGS_GROUP,
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const FORM_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "labelWidth", "labelWrap"],
   decoratorProps: ["labelWidth", "labelWrap"],
-  stepParams: ["resourceSettings", "formModelSettings", "eventSettings"],
+  stepParams: ["resourceSettings", "formModelSettings", "eventSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -599,13 +647,14 @@ const FORM_BLOCK_CONTRACT = createContract({
 FORM_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   resourceSettings: RESOURCE_SETTINGS_GROUP,
   formModelSettings: FORM_MODEL_SETTINGS_GROUP,
-  eventSettings: EVENT_SETTINGS_GROUP
+  eventSettings: EVENT_SETTINGS_GROUP,
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const CREATE_FORM_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "labelWidth", "labelWrap"],
   decoratorProps: ["labelWidth", "labelWrap"],
-  stepParams: ["resourceSettings", "formModelSettings", "eventSettings", "formSettings"],
+  stepParams: ["resourceSettings", "formModelSettings", "eventSettings", "formSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -616,13 +665,14 @@ CREATE_FORM_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   resourceSettings: RESOURCE_SETTINGS_GROUP,
   formModelSettings: FORM_MODEL_SETTINGS_GROUP,
   eventSettings: EVENT_SETTINGS_GROUP,
-  formSettings: CREATE_FORM_SETTINGS_EVENT_ONLY_GROUP
+  formSettings: CREATE_FORM_SETTINGS_EVENT_ONLY_GROUP,
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const EDIT_FORM_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "labelWidth", "labelWrap"],
   decoratorProps: ["labelWidth", "labelWrap"],
-  stepParams: ["resourceSettings", "formModelSettings", "eventSettings", "formSettings"],
+  stepParams: ["resourceSettings", "formModelSettings", "eventSettings", "formSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -633,13 +683,14 @@ EDIT_FORM_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   resourceSettings: RESOURCE_SETTINGS_GROUP,
   formModelSettings: FORM_MODEL_SETTINGS_GROUP,
   eventSettings: EVENT_SETTINGS_GROUP,
-  formSettings: EDIT_FORM_SETTINGS_GROUP
+  formSettings: EDIT_FORM_SETTINGS_GROUP,
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const DETAILS_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "labelWidth", "labelWrap"],
   decoratorProps: ["labelWidth", "labelWrap"],
-  stepParams: ["resourceSettings", "detailsSettings"],
+  stepParams: ["resourceSettings", "detailsSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -648,7 +699,8 @@ const DETAILS_BLOCK_CONTRACT = createContract({
 });
 DETAILS_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   resourceSettings: RESOURCE_SETTINGS_GROUP,
-  detailsSettings: DETAILS_SETTINGS_GROUP
+  detailsSettings: DETAILS_SETTINGS_GROUP,
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const FILTER_FORM_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
@@ -669,7 +721,7 @@ const LIST_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle"],
   decoratorProps: ["height", "heightMode"],
-  stepParams: ["resourceSettings", "listSettings"],
+  stepParams: ["resourceSettings", "listSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -702,13 +754,14 @@ LIST_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
       "dataScope.filter": FILTER_GROUP_SCHEMA,
       "layout.layout": STRING_SCHEMA
     }
-  }
+  },
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const GRID_CARD_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle"],
   decoratorProps: ["height", "heightMode"],
-  stepParams: ["resourceSettings", "GridCardSettings"],
+  stepParams: ["resourceSettings", "GridCardSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -758,7 +811,8 @@ GRID_CARD_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
       "dataScope.filter": FILTER_GROUP_SCHEMA,
       "layout.layout": STRING_SCHEMA
     }
-  }
+  },
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const MARKDOWN_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
@@ -813,14 +867,15 @@ IFRAME_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
   }
 });
 const CHART_CARD_SETTINGS_GROUP = {
-  allowedPaths: ["titleDescription.title", "blockHeight.heightMode", "blockHeight.height"],
+  allowedPaths: ["titleDescription.title", "blockHeight.heightMode", "blockHeight.height", "linkageRules"],
   clearable: true,
   mergeStrategy: "deep",
-  eventBindingSteps: ["titleDescription", "blockHeight"],
+  eventBindingSteps: ["titleDescription", "blockHeight", "linkageRules"],
   pathSchemas: {
     "titleDescription.title": STRING_SCHEMA,
     "blockHeight.heightMode": STRING_SCHEMA,
-    "blockHeight.height": NUMBER_SCHEMA
+    "blockHeight.height": NUMBER_SCHEMA,
+    linkageRules: ARRAY_SCHEMA
   }
 };
 const CHART_BLOCK_CONTRACT = createContract({
@@ -846,7 +901,7 @@ CHART_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
 const ACTION_PANEL_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "layout", "ellipsis"],
-  stepParams: ["actionPanelBlockSetting"],
+  stepParams: ["actionPanelBlockSetting", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS
@@ -860,7 +915,8 @@ ACTION_PANEL_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
       "layout.layout": STRING_SCHEMA,
       "ellipsis.ellipsis": BOOLEAN_SCHEMA
     }
-  }
+  },
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const JS_BLOCK_CONTRACT = createContract({
   editableDomains: ["decoratorProps", "stepParams", "flowRegistry"],
@@ -882,7 +938,7 @@ JS_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
 const MAP_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle", "height", "heightMode", "mapField", "marker", "lineSort", "zoom"],
-  stepParams: ["resourceSettings", "createMapBlock"],
+  stepParams: ["resourceSettings", "createMapBlock", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -917,12 +973,13 @@ MAP_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
       "lineSort.sort": ARRAY_SCHEMA,
       "mapZoom.zoom": NUMBER_SCHEMA
     }
-  }
+  },
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP
 });
 const COMMENTS_BLOCK_CONTRACT = createContract({
   editableDomains: ["props", "stepParams", "flowRegistry"],
   props: ["title", "displayTitle"],
-  stepParams: ["resourceSettings", "commentsSettings"],
+  stepParams: ["resourceSettings", "commentsSettings", "cardSettings"],
   flowRegistry: true,
   eventCapabilities: {
     direct: DEFAULT_DIRECT_EVENTS,
@@ -947,6 +1004,7 @@ COMMENTS_BLOCK_CONTRACT.domains.stepParams = groupedDomain({
       "init.associationPathName": STRING_SCHEMA
     }
   },
+  cardSettings: BLOCK_LINKAGE_CARD_SETTINGS_GROUP,
   commentsSettings: {
     allowedPaths: ["pageSize.pageSize", "dataScope.filter"],
     clearable: true,
@@ -1227,6 +1285,61 @@ FIELD_NODE_CONTRACT.domains.stepParams = groupedDomain({
     pathSchemas: OPEN_VIEW_PATH_SCHEMAS
   }
 });
+const SUB_FORM_FIELD_NODE_CONTRACT = createContract({
+  editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
+  props: [
+    "title",
+    "icon",
+    "titleField",
+    "clickToOpen",
+    "autoSize",
+    "allowMultiple",
+    "multiple",
+    "quickCreate",
+    "allowClear",
+    "displayStyle",
+    "options"
+  ],
+  decoratorProps: ["labelWidth", "labelWrap"],
+  stepParams: ["fieldSettings", "displayFieldSettings", "popupSettings", "eventSettings"],
+  flowRegistry: true,
+  eventCapabilities: {
+    direct: ACTION_DIRECT_EVENTS,
+    object: ACTION_OBJECT_EVENTS
+  },
+  eventBindings: {
+    displayFieldSettings: {
+      stepKeys: ["displayStyle", "clickToOpen"]
+    },
+    popupSettings: {
+      stepKeys: ["openView"]
+    },
+    eventSettings: {
+      stepKeys: ["linkageRules"]
+    }
+  }
+});
+SUB_FORM_FIELD_NODE_CONTRACT.domains.stepParams = groupedDomain({
+  fieldSettings: FIELD_SETTINGS_INIT_GROUP,
+  displayFieldSettings: {
+    allowedPaths: ["displayStyle.displayStyle", "clickToOpen.clickToOpen"],
+    clearable: true,
+    mergeStrategy: "deep",
+    eventBindingSteps: ["displayStyle", "clickToOpen"],
+    pathSchemas: {
+      "displayStyle.displayStyle": STRING_SCHEMA,
+      "clickToOpen.clickToOpen": BOOLEAN_SCHEMA
+    }
+  },
+  popupSettings: {
+    allowedPaths: OPEN_VIEW_ALLOWED_PATHS,
+    clearable: true,
+    mergeStrategy: "deep",
+    eventBindingSteps: ["openView"],
+    pathSchemas: OPEN_VIEW_PATH_SCHEMAS
+  },
+  eventSettings: EVENT_SETTINGS_GROUP
+});
 const POPUP_ACTION_CONTRACT = createContract({
   editableDomains: ["props", "decoratorProps", "stepParams", "flowRegistry"],
   props: ACTION_PROP_KEYS,
@@ -1705,10 +1818,10 @@ const NODE_CONTRACT_ENTRIES = [
   ["RootPageTabModel", TAB_NODE_CONTRACT],
   ["ChildPageTabModel", TAB_NODE_CONTRACT],
   ["BlockGridModel", GRID_NODE_CONTRACT],
-  ["FormGridModel", GRID_NODE_CONTRACT],
+  ["FormGridModel", FORM_GRID_NODE_CONTRACT],
   ["DetailsGridModel", GRID_NODE_CONTRACT],
   ["FilterFormGridModel", GRID_NODE_CONTRACT],
-  ["AssignFormGridModel", GRID_NODE_CONTRACT],
+  ["AssignFormGridModel", FORM_GRID_NODE_CONTRACT],
   ["TableBlockModel", TABLE_BLOCK_CONTRACT],
   ["CreateFormModel", CREATE_FORM_BLOCK_CONTRACT],
   ["EditFormModel", EDIT_FORM_BLOCK_CONTRACT],
@@ -1730,6 +1843,8 @@ const NODE_CONTRACT_ENTRIES = [
   ["FormAssociationItemModel", DETAILS_ITEM_CONTRACT],
   ["DetailsItemModel", DETAILS_ITEM_CONTRACT],
   ["FilterFormItemModel", FILTER_FORM_ITEM_CONTRACT],
+  ["SubFormFieldModel", SUB_FORM_FIELD_NODE_CONTRACT],
+  ["SubFormListFieldModel", SUB_FORM_FIELD_NODE_CONTRACT],
   ["TableColumnModel", TABLE_COLUMN_CONTRACT],
   ["JSColumnModel", JS_COLUMN_CONTRACT],
   ["JSItemModel", JS_ITEM_CONTRACT],
@@ -1917,22 +2032,32 @@ function inferFilterFieldUse(fieldInterface) {
   };
   return map[fieldInterface] || "InputFieldModel";
 }
-function getAllowedFieldUseSet(containerUse) {
+function getAllowedFieldUseSet(containerUse, enabledPackages) {
   switch (normalizeFieldContainerUse(containerUse)) {
     case "form":
-      return EDITABLE_FIELD_USE_SET;
+      return /* @__PURE__ */ new Set([...EDITABLE_FIELD_USE_SET, ...(0, import_field_binding_registry.getRegisteredFieldUses)("editable", enabledPackages)]);
     case "details":
     case "table":
-      return DISPLAY_FIELD_USE_SET;
+      return /* @__PURE__ */ new Set([...DISPLAY_FIELD_USE_SET, ...(0, import_field_binding_registry.getRegisteredFieldUses)("display", enabledPackages)]);
     case "filter-form":
-      return FILTER_FIELD_USE_SET;
+      return /* @__PURE__ */ new Set([...FILTER_FIELD_USE_SET, ...(0, import_field_binding_registry.getRegisteredFieldUses)("filter", enabledPackages)]);
     default:
       return null;
   }
 }
-function inferFieldUseByContainer(containerUse, field) {
+function inferFieldUseByContainer(containerUse, field, options = {}) {
   var _a;
   const fieldInterface = (field == null ? void 0 : field.interface) || ((_a = field == null ? void 0 : field.options) == null ? void 0 : _a.interface);
+  const registeredBinding = (0, import_field_binding_registry.resolveRegisteredFieldBinding)({
+    containerUse,
+    field,
+    dataSourceKey: options.dataSourceKey,
+    enabledPackages: options.enabledPackages,
+    getCollection: options.getCollection
+  });
+  if (registeredBinding == null ? void 0 : registeredBinding.modelClassName) {
+    return registeredBinding.modelClassName;
+  }
   if ((0, import_field_semantics.shouldUseAssociationTitleTextDisplay)({
     containerUse,
     fieldInterface
@@ -2023,7 +2148,11 @@ function resolveSupportedFieldCapability(input) {
       `flowSurfaces field wrapper '${input.requestedWrapperUse}' is not allowed under '${input.containerUse}', expected '${wrapperUse}'`
     );
   }
-  const inferredFieldUse = requestedRenderer === "js" ? inferJsFieldUseByContainer(input.containerUse) : input.field ? inferFieldUseByContainer(input.containerUse, input.field) : void 0;
+  const inferredFieldUse = requestedRenderer === "js" ? inferJsFieldUseByContainer(input.containerUse) : input.field ? inferFieldUseByContainer(input.containerUse, input.field, {
+    enabledPackages: input.enabledPackages,
+    dataSourceKey: input.dataSourceKey,
+    getCollection: input.getCollection
+  }) : void 0;
   const fieldUse = input.requestedFieldUse || inferredFieldUse;
   if (!fieldUse) {
     if (input.allowUnresolvedFieldUse) {
@@ -2042,7 +2171,7 @@ function resolveSupportedFieldCapability(input) {
       `flowSurfaces fieldUse '${input.requestedFieldUse}' does not match inferred fieldUse '${inferredFieldUse}' under '${input.containerUse}'`
     );
   }
-  const allowedFieldUses = getAllowedFieldUseSet(input.containerUse);
+  const allowedFieldUses = getAllowedFieldUseSet(input.containerUse, input.enabledPackages);
   if (!(allowedFieldUses == null ? void 0 : allowedFieldUses.has(fieldUse))) {
     throw new import_errors.FlowSurfaceBadRequestError(
       `flowSurfaces fieldUse '${fieldUse}' is not allowed under '${input.containerUse}'`

package/dist/server/flow-surfaces/compose-compiler.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 type { FlowSurfaceComposeMode } from './types';
+export type FlowSurfaceComposeObject = Record<string, unknown>;
+export type FlowSurfaceComposeTargetKey = {
+    uid?: string;
+};
+export type FlowSurfaceComposeNormalizedResource = {
+    kind: 'semantic' | 'raw';
+    value: FlowSurfaceComposeObject;
+} | undefined;
+export type FlowSurfaceComposeNormalizedFieldSpec = {
+    index?: number;
+    key: string;
+    fieldPath?: string;
+    associationPathName?: string;
+    renderer?: string;
+    type?: string;
+    target?: string | Record<string, unknown>;
+    settings?: FlowSurfaceComposeObject;
+    popup?: FlowSurfaceComposeObject;
+};
+export type FlowSurfaceComposeNormalizedActionSpec = {
+    key: string;
+    type: string;
+    settings?: FlowSurfaceComposeObject;
+    popup?: FlowSurfaceComposeObject;
+};
+export type FlowSurfaceComposeNormalizedBlockSpec = {
+    index?: number;
+    key: string;
+    type?: string;
+    catalogItem?: FlowSurfaceComposeObject | null;
+    resource?: FlowSurfaceComposeNormalizedResource;
+    template?: FlowSurfaceComposeObject;
+    settings?: FlowSurfaceComposeObject;
+    fields: FlowSurfaceComposeNormalizedFieldSpec[];
+    actions: FlowSurfaceComposeNormalizedActionSpec[];
+    recordActions: FlowSurfaceComposeNormalizedActionSpec[];
+};
+export type FlowSurfaceComposeBlockCreatePayload = {
+    target: {
+        uid: string;
+    };
+    type?: string;
+    resource?: FlowSurfaceComposeObject;
+    resourceInit?: FlowSurfaceComposeObject;
+    template?: FlowSurfaceComposeObject;
+    key?: string;
+};
+export type FlowSurfaceCompiledComposeBlockTask = {
+    key: string;
+    spec: FlowSurfaceComposeNormalizedBlockSpec;
+    payload: FlowSurfaceComposeBlockCreatePayload;
+};
+export type FlowSurfaceCompiledComposeFieldTask = {
+    blockKey: string;
+    spec: FlowSurfaceComposeNormalizedFieldSpec;
+    containerSource: 'block' | 'item';
+    payload: FlowSurfaceComposeObject;
+};
+export type FlowSurfaceCompiledComposeActionTask = {
+    blockKey: string;
+    spec: FlowSurfaceComposeNormalizedActionSpec;
+    payload: FlowSurfaceComposeObject;
+};
+export type FlowSurfaceCompiledComposeRecordActionTask = {
+    blockKey: string;
+    spec: FlowSurfaceComposeNormalizedActionSpec;
+    payload: FlowSurfaceComposeObject;
+};
+export type FlowSurfaceComposeLayoutPlan = {
+    kind: 'none';
+} | {
+    kind: 'explicit';
+    layout?: FlowSurfaceComposeObject;
+} | {
+    kind: 'append';
+};
+export type FlowSurfaceCompiledComposePlan = {
+    gridUid: string;
+    mode: FlowSurfaceComposeMode;
+    existingItemUids: string[];
+    blocks: FlowSurfaceCompiledComposeBlockTask[];
+    fields: FlowSurfaceCompiledComposeFieldTask[];
+    actions: FlowSurfaceCompiledComposeActionTask[];
+    recordActions: FlowSurfaceCompiledComposeRecordActionTask[];
+    layoutPlan: FlowSurfaceComposeLayoutPlan;
+};
+export declare function compileComposeExecutionPlan(input: {
+    gridUid: string;
+    mode: FlowSurfaceComposeMode;
+    normalizedBlocks: FlowSurfaceComposeNormalizedBlockSpec[];
+    existingItemUids?: string[];
+    layout?: FlowSurfaceComposeObject;
+}): FlowSurfaceCompiledComposePlan;
+export declare function resolveComposeFieldContainerSource(blockSpec: Pick<FlowSurfaceComposeNormalizedBlockSpec, 'type'>): 'block' | 'item';
+export declare function resolveComposeTargetKey(targetKey: string, keyMap: Record<string, FlowSurfaceComposeTargetKey | undefined>, kind: 'field' | 'layout'): string;