@nocobase/plugin-flow-engine 2.1.0-beta.2 → 2.1.0-beta.20

package/dist/server/flow-surfaces/node-use-sets.js

@@ -0,0 +1,134 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var node_use_sets_exports = {};
+__export(node_use_sets_exports, {
+  ACTION_BUTTON_USES: () => ACTION_BUTTON_USES,
+  COLLECTION_BLOCK_USES: () => COLLECTION_BLOCK_USES,
+  CREATABLE_STANDALONE_FIELD_USES: () => CREATABLE_STANDALONE_FIELD_USES,
+  FIELD_WRAPPER_USES: () => FIELD_WRAPPER_USES,
+  JS_BLOCK_USES: () => JS_BLOCK_USES,
+  STANDALONE_FIELD_NODE_USES: () => STANDALONE_FIELD_NODE_USES,
+  STATIC_CONTENT_BLOCK_USES: () => STATIC_CONTENT_BLOCK_USES
+});
+module.exports = __toCommonJS(node_use_sets_exports);
+var import_approval = require("./approval");
+const COLLECTION_BLOCK_USES = /* @__PURE__ */ new Set([
+  "TableBlockModel",
+  "CalendarBlockModel",
+  "KanbanBlockModel",
+  "CreateFormModel",
+  "EditFormModel",
+  "FormBlockModel",
+  "DetailsBlockModel",
+  "FilterFormBlockModel",
+  "ListBlockModel",
+  "GridCardBlockModel",
+  "MapBlockModel",
+  "CommentsBlockModel",
+  ...import_approval.APPROVAL_FORM_BLOCK_USES,
+  ...import_approval.APPROVAL_DETAILS_BLOCK_USES
+]);
+const STATIC_CONTENT_BLOCK_USES = /* @__PURE__ */ new Set([
+  "MarkdownBlockModel",
+  "IframeBlockModel",
+  "ChartBlockModel",
+  "ActionPanelBlockModel",
+  "JSBlockModel"
+]);
+const FIELD_WRAPPER_USES = /* @__PURE__ */ new Set([
+  "FormItemModel",
+  "FormAssociationItemModel",
+  "DetailsItemModel",
+  "FilterFormItemModel",
+  "TableColumnModel",
+  ...import_approval.APPROVAL_FIELD_WRAPPER_USES
+]);
+const CREATABLE_STANDALONE_FIELD_USES = /* @__PURE__ */ new Set(["JSColumnModel", "JSItemModel", "DividerItemModel"]);
+const STANDALONE_FIELD_NODE_USES = /* @__PURE__ */ new Set([...CREATABLE_STANDALONE_FIELD_USES, "FormJSFieldItemModel"]);
+const ACTION_BUTTON_USES = /* @__PURE__ */ new Set([
+  "AddNewActionModel",
+  "ViewActionModel",
+  "EditActionModel",
+  "PopupCollectionActionModel",
+  "DeleteActionModel",
+  "BulkDeleteActionModel",
+  "BulkEditActionModel",
+  "UpdateRecordActionModel",
+  "BulkUpdateActionModel",
+  "DuplicateActionModel",
+  "AddChildActionModel",
+  "FilterActionModel",
+  "ExpandCollapseActionModel",
+  "FormSubmitActionModel",
+  "FilterFormSubmitActionModel",
+  "FilterFormResetActionModel",
+  "FilterFormCollapseActionModel",
+  "RefreshActionModel",
+  "LinkActionModel",
+  "ExportActionModel",
+  "ExportAttachmentActionModel",
+  "ImportActionModel",
+  "UploadActionModel",
+  "TemplatePrintCollectionActionModel",
+  "TemplatePrintRecordActionModel",
+  "CollectionTriggerWorkflowActionModel",
+  "RecordTriggerWorkflowActionModel",
+  "FormTriggerWorkflowActionModel",
+  "WorkbenchTriggerWorkflowActionModel",
+  "MailSendActionModel",
+  "JSCollectionActionModel",
+  "JSRecordActionModel",
+  "JSFormActionModel",
+  "JSItemActionModel",
+  "FilterFormJSActionModel",
+  "JSActionModel",
+  "CalendarTodayActionModel",
+  "CalendarNavActionModel",
+  "CalendarTitleActionModel",
+  "CalendarViewSelectActionModel",
+  "KanbanQuickCreateActionModel",
+  "KanbanCardViewActionModel",
+  "ApplyFormSubmitModel",
+  "ApplyFormSaveDraftModel",
+  "ApplyFormWithdrawModel",
+  "ProcessFormApproveModel",
+  "ProcessFormRejectModel",
+  "ProcessFormReturnModel",
+  "ProcessFormDelegateModel",
+  "ProcessFormAddAssigneeModel"
+]);
+const JS_BLOCK_USES = /* @__PURE__ */ new Set(["JSBlockModel"]);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACTION_BUTTON_USES,
+  COLLECTION_BLOCK_USES,
+  CREATABLE_STANDALONE_FIELD_USES,
+  FIELD_WRAPPER_USES,
+  JS_BLOCK_USES,
+  STANDALONE_FIELD_NODE_USES,
+  STATIC_CONTENT_BLOCK_USES
+});

package/dist/server/flow-surfaces/payload-shape.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+export declare function validateFlowSurfacePayloadShape(actionName: string, value: any, path: string): void;

package/dist/server/flow-surfaces/payload-shape.js

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var payload_shape_exports = {};
+__export(payload_shape_exports, {
+  validateFlowSurfacePayloadShape: () => validateFlowSurfacePayloadShape
+});
+module.exports = __toCommonJS(payload_shape_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_errors = require("./errors");
+var import_key_registry = require("./planning/key-registry");
+function validateFlowSurfacePayloadShape(actionName, value, path) {
+  if (Array.isArray(value)) {
+    value.forEach((item, index) => validateFlowSurfacePayloadShape(actionName, item, `${path}[${index}]`));
+    return;
+  }
+  if (!import_lodash.default.isPlainObject(value)) {
+    return;
+  }
+  if (import_lodash.default.isPlainObject(value.stepParams) && Object.prototype.hasOwnProperty.call(value.stepParams, import_key_registry.FLOW_SURFACE_INTERNAL_META_KEY)) {
+    (0, import_errors.throwBadRequest)(`flowSurfaces ${actionName} ${path}.stepParams.${import_key_registry.FLOW_SURFACE_INTERNAL_META_KEY} is reserved`);
+  }
+  Object.entries(value).forEach(([key, child]) => validateFlowSurfacePayloadShape(actionName, child, `${path}.${key}`));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateFlowSurfacePayloadShape
+});

package/dist/server/flow-surfaces/placement.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 { FlowSurfaceResolvedTarget } from './types';
+export declare const FLOW_SURFACE_POPUP_HOST_USES: Set<string>;
+export declare const FLOW_SURFACE_FORM_BLOCK_USES: Set<string>;
+export declare const FLOW_SURFACE_DETAILS_BLOCK_USES: Set<string>;
+export declare const FLOW_SURFACE_FILTER_FORM_BLOCK_USES: Set<string>;
+export declare const FLOW_SURFACE_GRID_USES: Set<string>;
+export declare const FLOW_SURFACE_FIELD_WRAPPER_USES: Set<string>;
+export declare const FLOW_SURFACE_PAGE_MODEL_USES: Set<string>;
+export declare const FLOW_SURFACE_PAGE_ROUTE_TYPES: Set<string>;
+export declare function isPopupHostUse(use?: string): boolean;
+export declare function isFormBlockUse(use?: string): boolean;
+export declare function isDetailsBlockUse(use?: string): boolean;
+export declare function isFilterFormBlockUse(use?: string): boolean;
+export declare function isGridUse(use?: string): boolean;
+export declare function isFieldWrapperUse(use?: string): boolean;
+export declare function isPageModelUse(use?: string): boolean;
+export declare function isPageRouteType(routeLike?: any): boolean;
+export declare function isTabsRouteType(routeLike?: any): boolean;
+export declare function canCatalogAddBlock(input: {
+    node?: any;
+    resolved?: Pick<FlowSurfaceResolvedTarget, 'route' | 'pageRoute' | 'tabRoute'> | null;
+}): boolean;
+export declare function isFieldContainerUse(parentUse?: string, subKey?: string): boolean;
+export declare function isBlockContainerUse(parentUse?: string, subKey?: string): boolean;
+export declare function isActionContainerUse(parentUse?: string): boolean;

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

@@ -0,0 +1,198 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var placement_exports = {};
+__export(placement_exports, {
+  FLOW_SURFACE_DETAILS_BLOCK_USES: () => FLOW_SURFACE_DETAILS_BLOCK_USES,
+  FLOW_SURFACE_FIELD_WRAPPER_USES: () => FLOW_SURFACE_FIELD_WRAPPER_USES,
+  FLOW_SURFACE_FILTER_FORM_BLOCK_USES: () => FLOW_SURFACE_FILTER_FORM_BLOCK_USES,
+  FLOW_SURFACE_FORM_BLOCK_USES: () => FLOW_SURFACE_FORM_BLOCK_USES,
+  FLOW_SURFACE_GRID_USES: () => FLOW_SURFACE_GRID_USES,
+  FLOW_SURFACE_PAGE_MODEL_USES: () => FLOW_SURFACE_PAGE_MODEL_USES,
+  FLOW_SURFACE_PAGE_ROUTE_TYPES: () => FLOW_SURFACE_PAGE_ROUTE_TYPES,
+  FLOW_SURFACE_POPUP_HOST_USES: () => FLOW_SURFACE_POPUP_HOST_USES,
+  canCatalogAddBlock: () => canCatalogAddBlock,
+  isActionContainerUse: () => isActionContainerUse,
+  isBlockContainerUse: () => isBlockContainerUse,
+  isDetailsBlockUse: () => isDetailsBlockUse,
+  isFieldContainerUse: () => isFieldContainerUse,
+  isFieldWrapperUse: () => isFieldWrapperUse,
+  isFilterFormBlockUse: () => isFilterFormBlockUse,
+  isFormBlockUse: () => isFormBlockUse,
+  isGridUse: () => isGridUse,
+  isPageModelUse: () => isPageModelUse,
+  isPageRouteType: () => isPageRouteType,
+  isPopupHostUse: () => isPopupHostUse,
+  isTabsRouteType: () => isTabsRouteType
+});
+module.exports = __toCommonJS(placement_exports);
+var import_approval = require("./approval");
+var import_node_use_sets = require("./node-use-sets");
+const FLOW_SURFACE_POPUP_HOST_USES = /* @__PURE__ */ new Set([
+  "AddNewActionModel",
+  "ViewActionModel",
+  "EditActionModel",
+  "PopupCollectionActionModel",
+  "CalendarQuickCreateActionModel",
+  "CalendarEventViewActionModel",
+  "KanbanQuickCreateActionModel",
+  "KanbanCardViewActionModel",
+  "ClickableFieldModel",
+  "DisplayTextFieldModel",
+  "DisplayEnumFieldModel",
+  "DisplayDateTimeFieldModel",
+  "DisplayNumberFieldModel",
+  "DisplayPercentFieldModel",
+  "DisplayTimeFieldModel",
+  "DisplayAssociationFieldModel",
+  "DisplayAssociationField",
+  "DisplayTitleFieldModel",
+  "DisplayURLFieldModel"
+]);
+const FLOW_SURFACE_FORM_BLOCK_USES = /* @__PURE__ */ new Set([
+  "FormBlockModel",
+  "CreateFormModel",
+  "EditFormModel",
+  "AssignFormModel"
+]);
+const FLOW_SURFACE_DETAILS_BLOCK_USES = /* @__PURE__ */ new Set(["DetailsBlockModel"]);
+const FLOW_SURFACE_FILTER_FORM_BLOCK_USES = /* @__PURE__ */ new Set(["FilterFormBlockModel"]);
+const FLOW_SURFACE_GRID_USES = /* @__PURE__ */ new Set([
+  "BlockGridModel",
+  "FormGridModel",
+  "DetailsGridModel",
+  "FilterFormGridModel",
+  "AssignFormGridModel"
+]);
+const FLOW_SURFACE_FIELD_WRAPPER_USES = import_node_use_sets.FIELD_WRAPPER_USES;
+const FLOW_SURFACE_PAGE_MODEL_USES = /* @__PURE__ */ new Set([
+  "RootPageModel",
+  "ChildPageModel",
+  "RootPageTabModel",
+  "ChildPageTabModel"
+]);
+const FLOW_SURFACE_PAGE_ROUTE_TYPES = /* @__PURE__ */ new Set(["page", "flowPage"]);
+function isPopupHostUse(use) {
+  return FLOW_SURFACE_POPUP_HOST_USES.has(use || "");
+}
+function isFormBlockUse(use) {
+  return FLOW_SURFACE_FORM_BLOCK_USES.has((0, import_approval.normalizeApprovalSemanticUse)(use) || "");
+}
+function isDetailsBlockUse(use) {
+  return FLOW_SURFACE_DETAILS_BLOCK_USES.has((0, import_approval.normalizeApprovalSemanticUse)(use) || "");
+}
+function isFilterFormBlockUse(use) {
+  return FLOW_SURFACE_FILTER_FORM_BLOCK_USES.has((0, import_approval.normalizeApprovalSemanticUse)(use) || "");
+}
+function isGridUse(use) {
+  return FLOW_SURFACE_GRID_USES.has((0, import_approval.normalizeApprovalSemanticUse)(use) || "");
+}
+function isFieldWrapperUse(use) {
+  return FLOW_SURFACE_FIELD_WRAPPER_USES.has(use || "");
+}
+function isPageModelUse(use) {
+  return FLOW_SURFACE_PAGE_MODEL_USES.has((0, import_approval.normalizeApprovalSemanticUse)(use) || "");
+}
+function isPageRouteType(routeLike) {
+  var _a;
+  const type = ((_a = routeLike == null ? void 0 : routeLike.get) == null ? void 0 : _a.call(routeLike, "type")) || (routeLike == null ? void 0 : routeLike.type);
+  return FLOW_SURFACE_PAGE_ROUTE_TYPES.has(type || "");
+}
+function isTabsRouteType(routeLike) {
+  var _a;
+  const type = ((_a = routeLike == null ? void 0 : routeLike.get) == null ? void 0 : _a.call(routeLike, "type")) || (routeLike == null ? void 0 : routeLike.type);
+  return type === "tabs";
+}
+function canCatalogAddBlock(input) {
+  var _a, _b;
+  const node = input.node;
+  const resolved = input.resolved;
+  if (!node && !resolved) {
+    return true;
+  }
+  if ((0, import_approval.isApprovalTaskCardGridUse)(node == null ? void 0 : node.use)) {
+    return false;
+  }
+  if (isGridUse(node == null ? void 0 : node.use) || isPageModelUse(node == null ? void 0 : node.use)) {
+    return true;
+  }
+  if (isPopupHostUse(node == null ? void 0 : node.use) || (0, import_approval.normalizeApprovalSemanticUse)((_b = (_a = node == null ? void 0 : node.subModels) == null ? void 0 : _a.page) == null ? void 0 : _b.use) === "ChildPageModel") {
+    return true;
+  }
+  if (!(node == null ? void 0 : node.use) && isTabsRouteType(resolved == null ? void 0 : resolved.tabRoute) || (node == null ? void 0 : node.use) === "RouteModel" && isTabsRouteType(resolved == null ? void 0 : resolved.route)) {
+    return true;
+  }
+  if (!(node == null ? void 0 : node.use) && isPageRouteType(resolved == null ? void 0 : resolved.pageRoute) || (node == null ? void 0 : node.use) === "RouteModel" && isPageRouteType(resolved == null ? void 0 : resolved.route)) {
+    return true;
+  }
+  return false;
+}
+function isFieldContainerUse(parentUse, subKey) {
+  if (subKey === "columns" && parentUse === "TableBlockModel") {
+    return true;
+  }
+  return subKey === "items" && (isGridUse(parentUse) || isFormBlockUse(parentUse) || isDetailsBlockUse(parentUse) || isFilterFormBlockUse(parentUse));
+}
+function isBlockContainerUse(parentUse, subKey) {
+  return subKey === "items" && (isGridUse(parentUse) && !(0, import_approval.isApprovalTaskCardGridUse)(parentUse) || isPopupHostUse(parentUse));
+}
+function isActionContainerUse(parentUse) {
+  return [
+    "TableBlockModel",
+    "CalendarBlockModel",
+    "KanbanBlockModel",
+    "TableActionsColumnModel",
+    "ListBlockModel",
+    "GridCardBlockModel",
+    "ListItemModel",
+    "GridCardItemModel",
+    "ActionPanelBlockModel"
+  ].includes(parentUse || "") || isFormBlockUse(parentUse) || isDetailsBlockUse(parentUse) || isFilterFormBlockUse(parentUse);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FLOW_SURFACE_DETAILS_BLOCK_USES,
+  FLOW_SURFACE_FIELD_WRAPPER_USES,
+  FLOW_SURFACE_FILTER_FORM_BLOCK_USES,
+  FLOW_SURFACE_FORM_BLOCK_USES,
+  FLOW_SURFACE_GRID_USES,
+  FLOW_SURFACE_PAGE_MODEL_USES,
+  FLOW_SURFACE_PAGE_ROUTE_TYPES,
+  FLOW_SURFACE_POPUP_HOST_USES,
+  canCatalogAddBlock,
+  isActionContainerUse,
+  isBlockContainerUse,
+  isDetailsBlockUse,
+  isFieldContainerUse,
+  isFieldWrapperUse,
+  isFilterFormBlockUse,
+  isFormBlockUse,
+  isGridUse,
+  isPageModelUse,
+  isPageRouteType,
+  isPopupHostUse,
+  isTabsRouteType
+});

package/dist/server/flow-surfaces/planning/action-specs.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 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.
+ */
+export type FlowSurfacePlanSelectorMode = 'none' | 'target' | 'rootUidTarget' | 'sourceTarget';
+export type FlowSurfacePlanActionSpec = {
+    selectorMode: FlowSurfacePlanSelectorMode;
+};
+export type FlowSurfacePlanMutateActionSpec = FlowSurfacePlanActionSpec & {
+    executionKind: 'mutate';
+};
+export type FlowSurfacePlanOnlyActionSpec = FlowSurfacePlanActionSpec & {
+    executionKind: 'planOnly';
+};
+export type FlowSurfaceResolvedPlanActionSpec = FlowSurfacePlanMutateActionSpec | FlowSurfacePlanOnlyActionSpec;
+export declare const FLOW_SURFACE_PLAN_ACTION_SPECS: {
+    readonly createMenu: {
+        readonly selectorMode: "none";
+        readonly executionKind: "mutate";
+    };
+    readonly createPage: {
+        readonly selectorMode: "none";
+        readonly executionKind: "mutate";
+    };
+    readonly compose: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly configure: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly setFieldValueRules: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly setBlockLinkageRules: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly setFieldLinkageRules: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly setActionLinkageRules: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly updateSettings: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly setEventFlows: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly setLayout: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly addTab: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly updateTab: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly moveTab: {
+        readonly selectorMode: "sourceTarget";
+        readonly executionKind: "mutate";
+    };
+    readonly removeTab: {
+        readonly selectorMode: "rootUidTarget";
+        readonly executionKind: "mutate";
+    };
+    readonly addPopupTab: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly updatePopupTab: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly movePopupTab: {
+        readonly selectorMode: "sourceTarget";
+        readonly executionKind: "mutate";
+    };
+    readonly removePopupTab: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly addBlock: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly addField: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly addAction: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly addRecordAction: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly moveNode: {
+        readonly selectorMode: "sourceTarget";
+        readonly executionKind: "mutate";
+    };
+    readonly removeNode: {
+        readonly selectorMode: "target";
+        readonly executionKind: "mutate";
+    };
+    readonly convertTemplateToCopy: {
+        readonly selectorMode: "target";
+        readonly executionKind: "planOnly";
+    };
+    readonly destroyPage: {
+        readonly selectorMode: "rootUidTarget";
+        readonly executionKind: "mutate";
+    };
+} & {
+    readonly createMenu: unknown;
+    readonly createPage: unknown;
+    readonly compose: unknown;
+    readonly configure: unknown;
+    readonly setFieldValueRules: unknown;
+    readonly setBlockLinkageRules: unknown;
+    readonly setFieldLinkageRules: unknown;
+    readonly setActionLinkageRules: unknown;
+    readonly updateSettings: unknown;
+    readonly setEventFlows: unknown;
+    readonly setLayout: unknown;
+    readonly addTab: unknown;
+    readonly updateTab: unknown;
+    readonly moveTab: unknown;
+    readonly removeTab: unknown;
+    readonly addPopupTab: unknown;
+    readonly updatePopupTab: unknown;
+    readonly movePopupTab: unknown;
+    readonly removePopupTab: unknown;
+    readonly addBlock: unknown;
+    readonly addField: unknown;
+    readonly addAction: unknown;
+    readonly addRecordAction: unknown;
+    readonly moveNode: unknown;
+    readonly removeNode: unknown;
+    readonly convertTemplateToCopy: unknown;
+    readonly destroyPage: unknown;
+};
+export type FlowSurfacePlanStepActionName = keyof typeof FLOW_SURFACE_PLAN_ACTION_SPECS;
+export type FlowSurfacePlanOnlyActionName = {
+    [K in FlowSurfacePlanStepActionName]: (typeof FLOW_SURFACE_PLAN_ACTION_SPECS)[K] extends {
+        executionKind: 'planOnly';
+    } ? K : never;
+}[FlowSurfacePlanStepActionName];
+export declare const FLOW_SURFACE_PLAN_STEP_ACTIONS: ("createMenu" | "setFieldValueRules" | "setBlockLinkageRules" | "setFieldLinkageRules" | "setActionLinkageRules" | "convertTemplateToCopy" | "compose" | "configure" | "createPage" | "destroyPage" | "addTab" | "updateTab" | "moveTab" | "removeTab" | "addPopupTab" | "updatePopupTab" | "movePopupTab" | "removePopupTab" | "addBlock" | "addField" | "addAction" | "addRecordAction" | "updateSettings" | "setEventFlows" | "setLayout" | "moveNode" | "removeNode")[];
+export declare function getFlowSurfacePlanSelectorRequirements(selectorMode: FlowSurfacePlanSelectorMode): {
+    readonly requiresTarget: false;
+    readonly requiresSource: false;
+} | {
+    readonly requiresTarget: true;
+    readonly requiresSource: false;
+} | {
+    readonly requiresTarget: true;
+    readonly requiresSource: false;
+} | {
+    readonly requiresTarget: true;
+    readonly requiresSource: true;
+};
+export declare function getFlowSurfacePlanActionSpec(action: string): FlowSurfaceResolvedPlanActionSpec | undefined;
+export declare function isFlowSurfacePlanOnlyAction(action: string): action is FlowSurfacePlanOnlyActionName;