@nocobase/flow-engine 2.0.0-alpha.2

package/lib/utils/context.js

@@ -0,0 +1,63 @@
+/**
+ * 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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 context_exports = {};
+__export(context_exports, {
+  extractPropertyPath: () => extractPropertyPath,
+  formatPathToVariable: () => formatPathToVariable,
+  isVariableExpression: () => isVariableExpression
+});
+module.exports = __toCommonJS(context_exports);
+function extractPropertyPath(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  const variableRegex = /^\{\{\s*ctx(?:\.(.+?))?\s*\}\}$/;
+  const match = trimmed.match(variableRegex);
+  if (!match) return null;
+  const pathString = match[1];
+  if (!pathString) return [];
+  return pathString.split(".").map((part) => part.trim()).filter((part) => part.length > 0);
+}
+__name(extractPropertyPath, "extractPropertyPath");
+function formatPathToVariable(path) {
+  if (path.length === 0) return "{{ ctx }}";
+  return `{{ ctx.${path.join(".")} }}`;
+}
+__name(formatPathToVariable, "formatPathToVariable");
+function isVariableExpression(value) {
+  if (typeof value !== "string") return false;
+  const trimmed = value.trim();
+  const variableRegex = /^\{\{\s*ctx(?:\..+?)?\s*\}\}$/;
+  return variableRegex.test(trimmed);
+}
+__name(isVariableExpression, "isVariableExpression");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  extractPropertyPath,
+  formatPathToVariable,
+  isVariableExpression
+});

package/lib/utils/createCollectionContextMeta.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 { Collection } from '../data-source';
+import type { PropertyMetaFactory } from '../flowContext';
+export declare function createCollectionContextMeta(collectionOrFactory: Collection | (() => Collection | null), title?: string): PropertyMetaFactory;

package/lib/utils/createCollectionContextMeta.js

@@ -0,0 +1,117 @@
+/**
+ * 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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 createCollectionContextMeta_exports = {};
+__export(createCollectionContextMeta_exports, {
+  createCollectionContextMeta: () => createCollectionContextMeta
+});
+module.exports = __toCommonJS(createCollectionContextMeta_exports);
+const RELATION_FIELD_TYPES = ["belongsTo", "hasOne", "hasMany", "belongsToMany", "belongsToArray"];
+const NUMERIC_FIELD_TYPES = ["integer", "float", "double", "decimal"];
+function createFieldMetadata(field) {
+  const baseProperties = createMetaBaseProperties(field);
+  if (field.isAssociationField()) {
+    const targetCollection = field.targetCollection;
+    if (!targetCollection) {
+      return {
+        type: "object",
+        ...baseProperties
+      };
+    }
+    return {
+      type: "object",
+      // 所有关系字段统一使用 object 类型
+      ...baseProperties,
+      properties: /* @__PURE__ */ __name(async () => {
+        const subProperties = {};
+        targetCollection.fields.forEach((subField) => {
+          subProperties[subField.name] = createFieldMetadata(subField);
+        });
+        return subProperties;
+      }, "properties")
+    };
+  }
+  return {
+    type: getFieldType(field),
+    ...baseProperties
+  };
+}
+__name(createFieldMetadata, "createFieldMetadata");
+function getFieldType(field) {
+  const fieldType = field.type;
+  if (RELATION_FIELD_TYPES.includes(fieldType)) {
+    return "object";
+  }
+  if (NUMERIC_FIELD_TYPES.includes(fieldType)) {
+    return "number";
+  }
+  switch (fieldType) {
+    case "boolean":
+      return "boolean";
+    case "json":
+      return "object";
+    case "array":
+      return "array";
+    default:
+      return "string";
+  }
+}
+__name(getFieldType, "getFieldType");
+function createMetaBaseProperties(field) {
+  return {
+    title: field.title || field.name,
+    interface: field.interface,
+    uiSchema: field.uiSchema || {}
+  };
+}
+__name(createMetaBaseProperties, "createMetaBaseProperties");
+function createCollectionContextMeta(collectionOrFactory, title) {
+  const metaFn = /* @__PURE__ */ __name(async () => {
+    const collection = typeof collectionOrFactory === "function" ? collectionOrFactory() : collectionOrFactory;
+    if (!collection) {
+      return null;
+    }
+    return {
+      type: "object",
+      title: title || collection.title || collection.name,
+      properties: /* @__PURE__ */ __name(async () => {
+        const properties = {};
+        collection.fields.forEach((field) => {
+          properties[field.name] = createFieldMetadata(field);
+        });
+        return properties;
+      }, "properties")
+    };
+  }, "metaFn");
+  metaFn.title = title;
+  return metaFn;
+}
+__name(createCollectionContextMeta, "createCollectionContextMeta");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCollectionContextMeta
+});

package/lib/utils/exceptions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ */
+/**
+ * 流程正常退出异常类
+ * 用于标识通过 ctx.exit() 正常退出的情况
+ */
+export declare class FlowExitException extends Error {
+    readonly flowKey: string;
+    readonly modelUid: string;
+    constructor(flowKey: string, modelUid: string, message?: string);
+}
+export declare class FlowExitAllException extends Error {
+    readonly flowKey: string;
+    readonly modelUid: string;
+    constructor(flowKey: string, modelUid: string, message?: string);
+}

package/lib/utils/exceptions.js

@@ -0,0 +1,62 @@
+/**
+ * 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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 exceptions_exports = {};
+__export(exceptions_exports, {
+  FlowExitAllException: () => FlowExitAllException,
+  FlowExitException: () => FlowExitException
+});
+module.exports = __toCommonJS(exceptions_exports);
+const _FlowExitException = class _FlowExitException extends Error {
+  flowKey;
+  modelUid;
+  constructor(flowKey, modelUid, message) {
+    super(message || `Flow '${flowKey}' on model '${modelUid}' exited via ctx.exit().`);
+    this.name = "FlowExitException";
+    this.flowKey = flowKey;
+    this.modelUid = modelUid;
+  }
+};
+__name(_FlowExitException, "FlowExitException");
+let FlowExitException = _FlowExitException;
+const _FlowExitAllException = class _FlowExitAllException extends Error {
+  flowKey;
+  modelUid;
+  constructor(flowKey, modelUid, message) {
+    super(message || `Flow '${flowKey}' on model '${modelUid}' exited via ctx.exitAll().`);
+    this.name = "FlowExitAllException";
+    this.flowKey = flowKey;
+    this.modelUid = modelUid;
+  }
+};
+__name(_FlowExitAllException, "FlowExitAllException");
+let FlowExitAllException = _FlowExitAllException;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlowExitAllException,
+  FlowExitException
+});

package/lib/utils/flow-definitions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 { ActionDefinition } from '../types';
+import { FlowModel } from '../models/flowModel';
+export declare function defineAction<TModel extends FlowModel = FlowModel>(options: ActionDefinition<TModel>): ActionDefinition<TModel, import("..").FlowContext>;

package/lib/utils/flow-definitions.js

@@ -0,0 +1,40 @@
+/**
+ * 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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 flow_definitions_exports = {};
+__export(flow_definitions_exports, {
+  defineAction: () => defineAction
+});
+module.exports = __toCommonJS(flow_definitions_exports);
+function defineAction(options) {
+  return options;
+}
+__name(defineAction, "defineAction");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineAction
+});

package/lib/utils/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 { BLOCK_GROUP_CONFIGS, BLOCK_TYPES, FLOW_ENGINE_NAMESPACE, MENU_KEYS, type BlockBuilderConfig, } from './constants';
+export { escapeT, getT, tExpr } from './translation';
+export { FlowExitException } from './exceptions';
+export { defineAction } from './flow-definitions';
+export { isInheritedFrom } from './inheritance';
+export { resolveCreateModelOptions, resolveDefaultParams, resolveExpressions } from './params-resolvers';
+export { compileUiSchema, resolveStepUiSchema, resolveUiMode } from './schema-utils';
+export { setupRuntimeContextSteps } from './setupRuntimeContextSteps';
+export { createCollectionContextMeta } from './createCollectionContextMeta';
+export { buildRecordMeta, collectContextParamsForTemplate, createCurrentRecordMetaFactory, createRecordMetaFactory, extractUsedVariableNames, extractUsedVariablePaths, inferParentRecordRef, inferRecordRef, type RecordParamsBuilder, } from './variablesParams';
+export { extractPropertyPath, formatPathToVariable, isVariableExpression } from './context';
+export { clearAutoFlowError, getAutoFlowError, setAutoFlowError, type AutoFlowError } from './autoFlowError';
+export { parsePathnameToViewParams, type ViewParam } from './parsePathnameToViewParams';
+export { createSafeDocument, createSafeWindow } from './safeGlobals';

package/lib/utils/index.js

@@ -0,0 +1,117 @@
+/**
+ * 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 utils_exports = {};
+__export(utils_exports, {
+  BLOCK_GROUP_CONFIGS: () => import_constants.BLOCK_GROUP_CONFIGS,
+  BLOCK_TYPES: () => import_constants.BLOCK_TYPES,
+  FLOW_ENGINE_NAMESPACE: () => import_constants.FLOW_ENGINE_NAMESPACE,
+  FlowExitException: () => import_exceptions.FlowExitException,
+  MENU_KEYS: () => import_constants.MENU_KEYS,
+  buildRecordMeta: () => import_variablesParams.buildRecordMeta,
+  clearAutoFlowError: () => import_autoFlowError.clearAutoFlowError,
+  collectContextParamsForTemplate: () => import_variablesParams.collectContextParamsForTemplate,
+  compileUiSchema: () => import_schema_utils.compileUiSchema,
+  createCollectionContextMeta: () => import_createCollectionContextMeta.createCollectionContextMeta,
+  createCurrentRecordMetaFactory: () => import_variablesParams.createCurrentRecordMetaFactory,
+  createRecordMetaFactory: () => import_variablesParams.createRecordMetaFactory,
+  createSafeDocument: () => import_safeGlobals.createSafeDocument,
+  createSafeWindow: () => import_safeGlobals.createSafeWindow,
+  defineAction: () => import_flow_definitions.defineAction,
+  escapeT: () => import_translation.escapeT,
+  extractPropertyPath: () => import_context.extractPropertyPath,
+  extractUsedVariableNames: () => import_variablesParams.extractUsedVariableNames,
+  extractUsedVariablePaths: () => import_variablesParams.extractUsedVariablePaths,
+  formatPathToVariable: () => import_context.formatPathToVariable,
+  getAutoFlowError: () => import_autoFlowError.getAutoFlowError,
+  getT: () => import_translation.getT,
+  inferParentRecordRef: () => import_variablesParams.inferParentRecordRef,
+  inferRecordRef: () => import_variablesParams.inferRecordRef,
+  isInheritedFrom: () => import_inheritance.isInheritedFrom,
+  isVariableExpression: () => import_context.isVariableExpression,
+  parsePathnameToViewParams: () => import_parsePathnameToViewParams.parsePathnameToViewParams,
+  resolveCreateModelOptions: () => import_params_resolvers.resolveCreateModelOptions,
+  resolveDefaultParams: () => import_params_resolvers.resolveDefaultParams,
+  resolveExpressions: () => import_params_resolvers.resolveExpressions,
+  resolveStepUiSchema: () => import_schema_utils.resolveStepUiSchema,
+  resolveUiMode: () => import_schema_utils.resolveUiMode,
+  setAutoFlowError: () => import_autoFlowError.setAutoFlowError,
+  setupRuntimeContextSteps: () => import_setupRuntimeContextSteps.setupRuntimeContextSteps,
+  tExpr: () => import_translation.tExpr
+});
+module.exports = __toCommonJS(utils_exports);
+var import_constants = require("./constants");
+var import_translation = require("./translation");
+var import_exceptions = require("./exceptions");
+var import_flow_definitions = require("./flow-definitions");
+var import_inheritance = require("./inheritance");
+var import_params_resolvers = require("./params-resolvers");
+var import_schema_utils = require("./schema-utils");
+var import_setupRuntimeContextSteps = require("./setupRuntimeContextSteps");
+var import_createCollectionContextMeta = require("./createCollectionContextMeta");
+var import_variablesParams = require("./variablesParams");
+var import_context = require("./context");
+var import_autoFlowError = require("./autoFlowError");
+var import_parsePathnameToViewParams = require("./parsePathnameToViewParams");
+var import_safeGlobals = require("./safeGlobals");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BLOCK_GROUP_CONFIGS,
+  BLOCK_TYPES,
+  FLOW_ENGINE_NAMESPACE,
+  FlowExitException,
+  MENU_KEYS,
+  buildRecordMeta,
+  clearAutoFlowError,
+  collectContextParamsForTemplate,
+  compileUiSchema,
+  createCollectionContextMeta,
+  createCurrentRecordMetaFactory,
+  createRecordMetaFactory,
+  createSafeDocument,
+  createSafeWindow,
+  defineAction,
+  escapeT,
+  extractPropertyPath,
+  extractUsedVariableNames,
+  extractUsedVariablePaths,
+  formatPathToVariable,
+  getAutoFlowError,
+  getT,
+  inferParentRecordRef,
+  inferRecordRef,
+  isInheritedFrom,
+  isVariableExpression,
+  parsePathnameToViewParams,
+  resolveCreateModelOptions,
+  resolveDefaultParams,
+  resolveExpressions,
+  resolveStepUiSchema,
+  resolveUiMode,
+  setAutoFlowError,
+  setupRuntimeContextSteps,
+  tExpr
+});

package/lib/utils/inheritance.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 { ModelConstructor } from '../types';
+/**
+ * 检查一个类是否继承自指定的父类（支持多层继承）
+ * @param {ModelConstructor} childClass 要检查的子类
+ * @param {ModelConstructor} parentClass 父类
+ * @returns {boolean} 如果子类继承自父类则返回 true
+ */
+export declare function isInheritedFrom(childClass: ModelConstructor, parentClass: ModelConstructor): boolean;

package/lib/utils/inheritance.js

@@ -0,0 +1,53 @@
+/**
+ * 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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 inheritance_exports = {};
+__export(inheritance_exports, {
+  isInheritedFrom: () => isInheritedFrom
+});
+module.exports = __toCommonJS(inheritance_exports);
+function isInheritedFrom(childClass, parentClass) {
+  if (childClass === parentClass) {
+    return false;
+  }
+  if (childClass.prototype instanceof parentClass) {
+    return true;
+  }
+  let currentProto = Object.getPrototypeOf(childClass.prototype);
+  while (currentProto && currentProto !== Object.prototype) {
+    if (currentProto.constructor === parentClass) {
+      return true;
+    }
+    currentProto = Object.getPrototypeOf(currentProto);
+  }
+  return false;
+}
+__name(isInheritedFrom, "isInheritedFrom");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isInheritedFrom
+});

package/lib/utils/params-resolvers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { FlowContext, FlowModelContext, FlowRuntimeContext } from '../flowContext';
+import type { FlowModel } from '../models';
+import type { ServerContextParams } from './serverContextParams';
+/**
+ * 解析 defaultParams，支持静态值和函数形式
+ * @param {Record<string, any> | ((ctx: any) => Record<string, any> | Promise<Record<string, any>>)} defaultParams 默认参数
+ * @param {FlowRuntimeContext<TModel>} ctx 上下文
+ * @returns {Promise<Record<string, any>>} 解析后的参数对象
+ */
+export declare function resolveDefaultParams<TModel extends FlowModel = FlowModel>(defaultParams: Record<string, any> | ((ctx: any) => Record<string, any> | Promise<Record<string, any>>) | undefined, ctx: FlowContext): Promise<Record<string, any>>;
+/**
+ * 解析 FlowModelMeta 中的 createModelOptions，支持静态值和函数形式
+ * @param defaultOptions - 可以是静态对象或返回对象的函数
+ * @param ctx - 模型上下文实例，用于传递给函数形式
+ * @returns 解析后的选项对象
+ */
+export declare function resolveCreateModelOptions(createModelOptions: Record<string, any> | ((ctx: FlowModelContext, extra?: any) => Record<string, any> | Promise<Record<string, any>>) | undefined, ctx: FlowModelContext, extra?: any): Promise<Record<string, any>>;
+export type JSONValue = string | {
+    [key: string]: JSONValue;
+} | JSONValue[];
+type BatchPayload = {
+    template: JSONValue;
+    contextParams?: ServerContextParams | undefined;
+};
+export declare function enqueueVariablesResolve(ctx: FlowRuntimeContext, payload: BatchPayload): Promise<unknown>;
+/**
+ * 解析参数中的 {{xxx}} 表达式，自动处理异步属性访问
+ */
+export declare function resolveExpressions<TModel extends FlowModel = FlowModel>(params: JSONValue, ctx: FlowContext): Promise<any>;
+/**
+ * 预处理表达式字符串，插入必要的 await 和 RecordProxy 检查
+ *
+ * 1. 统一提取所有一层 ctx 路径（如 ctx.record, ctx.user）
+ * 2. 批量 await 获取这些值，判断是否为 RecordProxy 实例
+ * 3. 根据预处理结果决定每个多层路径的 await 插入方式
+ * 4. 避免重复解析，提高性能
+ *
+ * @param expression 原始表达式
+ * @param ctx FlowContext
+ * @returns 预处理后的表达式字符串
+ */
+export declare function preprocessExpression(expression: string, ctx: FlowContext): Promise<string>;
+export {};