@nocobase/plugin-flow-engine 2.1.0-alpha.15 → 2.1.0-alpha.17

package/dist/server/flow-surfaces/planning/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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 { FlowSurfaceMutateOp, FlowSurfacePlanStepLink, FlowSurfacePlanStepAction, FlowSurfaceReadLocator, FlowSurfaceReadTarget, FlowSurfaceResolvedTarget, FlowSurfaceSurfaceSelector } from '../types';
+import type { FlowSurfaceCreatedKeySpec } from './created-keys';
+export type FlowSurfaceResolvedKey = {
+    key: string;
+    uid: string;
+    source: 'declared' | 'request' | 'system';
+    kind: string;
+    locator: FlowSurfaceReadLocator;
+    rebind?: boolean;
+    reboundFromUid?: string;
+};
+export type FlowSurfaceResolvedSelectorSummary = {
+    uid?: string;
+    kind?: string;
+    key?: string;
+    step?: string;
+    path?: string;
+    source: FlowSurfaceResolvedKey['source'] | 'step' | 'created';
+};
+export type FlowSurfacePlanSurfaceContext = {
+    surfaceSelector?: FlowSurfaceSurfaceSelector;
+    surfaceTarget?: FlowSurfaceReadLocator;
+    surfaceResolved?: FlowSurfaceResolvedTarget;
+    rawTree?: any;
+    publicTree?: any;
+    publicNodeMap: Record<string, any>;
+    targetSummary: FlowSurfaceReadTarget | null;
+    fingerprint: string | null;
+    uidSet: Set<string>;
+    keyMap: Map<string, FlowSurfaceResolvedKey>;
+    requestKeyMap: Map<string, FlowSurfaceResolvedKey>;
+};
+export type FlowSurfaceCompiledPlanStepSelectorLink = FlowSurfacePlanStepLink & {
+    summary: FlowSurfaceResolvedSelectorSummary;
+};
+export type FlowSurfaceCompiledPlanStep = {
+    index: number;
+    id?: string;
+    action: FlowSurfacePlanStepAction;
+    payload: Record<string, any>;
+    executionPayload?: Record<string, any>;
+    resolvedSelectors: Partial<Record<'target' | 'source', FlowSurfaceResolvedSelectorSummary>>;
+    usedKeys: FlowSurfaceResolvedKey[];
+    usedStepLinks: FlowSurfaceCompiledPlanStepSelectorLink[];
+    createdKeys: FlowSurfaceCreatedKeySpec[];
+    mutateOp?: FlowSurfaceMutateOp;
+};

package/dist/server/flow-surfaces/planning/types.js

@@ -0,0 +1,24 @@
+/**
+ * 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 __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 types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/server/flow-surfaces/reaction/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 const FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND = "FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND";
+export declare const FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE = "FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE";
+export declare const FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE = "FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE";
+export declare const FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY = "FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY";
+export declare const FLOW_SURFACE_REACTION_DUPLICATE_SLOT = "FLOW_SURFACE_REACTION_DUPLICATE_SLOT";
+export declare const FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH = "FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH";
+export declare const FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR = "FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR";
+export declare const FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE = "FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE";
+export declare const FLOW_SURFACE_REACTION_INVALID_VALUE_PATH = "FLOW_SURFACE_REACTION_INVALID_VALUE_PATH";
+export declare const FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD = "FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD";
+export declare const FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT = "FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT";
+export declare const FLOW_SURFACE_REACTION_FORM_ONLY = "FLOW_SURFACE_REACTION_FORM_ONLY";

package/dist/server/flow-surfaces/reaction/errors.js

@@ -0,0 +1,69 @@
+/**
+ * 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 errors_exports = {};
+__export(errors_exports, {
+  FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE: () => FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE,
+  FLOW_SURFACE_REACTION_DUPLICATE_SLOT: () => FLOW_SURFACE_REACTION_DUPLICATE_SLOT,
+  FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT: () => FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT,
+  FLOW_SURFACE_REACTION_FORM_ONLY: () => FLOW_SURFACE_REACTION_FORM_ONLY,
+  FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR: () => FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR,
+  FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH: () => FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH,
+  FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD: () => FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD,
+  FLOW_SURFACE_REACTION_INVALID_VALUE_PATH: () => FLOW_SURFACE_REACTION_INVALID_VALUE_PATH,
+  FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE: () => FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE,
+  FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY: () => FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY,
+  FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE: () => FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE,
+  FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND: () => FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND
+});
+module.exports = __toCommonJS(errors_exports);
+const FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND = "FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND";
+const FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE = "FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE";
+const FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE = "FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE";
+const FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY = "FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY";
+const FLOW_SURFACE_REACTION_DUPLICATE_SLOT = "FLOW_SURFACE_REACTION_DUPLICATE_SLOT";
+const FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH = "FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH";
+const FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR = "FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR";
+const FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE = "FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE";
+const FLOW_SURFACE_REACTION_INVALID_VALUE_PATH = "FLOW_SURFACE_REACTION_INVALID_VALUE_PATH";
+const FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD = "FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD";
+const FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT = "FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT";
+const FLOW_SURFACE_REACTION_FORM_ONLY = "FLOW_SURFACE_REACTION_FORM_ONLY";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FLOW_SURFACE_REACTION_AMBIGUOUS_SCENE,
+  FLOW_SURFACE_REACTION_DUPLICATE_SLOT,
+  FLOW_SURFACE_REACTION_FINGERPRINT_CONFLICT,
+  FLOW_SURFACE_REACTION_FORM_ONLY,
+  FLOW_SURFACE_REACTION_INVALID_CONDITION_OPERATOR,
+  FLOW_SURFACE_REACTION_INVALID_CONDITION_PATH,
+  FLOW_SURFACE_REACTION_INVALID_TARGET_FIELD,
+  FLOW_SURFACE_REACTION_INVALID_VALUE_PATH,
+  FLOW_SURFACE_REACTION_INVALID_VALUE_SOURCE,
+  FLOW_SURFACE_REACTION_UNKNOWN_TARGET_KEY,
+  FLOW_SURFACE_REACTION_UNSUPPORTED_ACTION_FOR_SCENE,
+  FLOW_SURFACE_REACTION_UNSUPPORTED_TARGET_KIND
+});

package/dist/server/flow-surfaces/reaction/field-value.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 { FlowSurfaceFieldValueRule, FlowSurfaceReactionTargetSummary, FlowSurfaceReactionWriteResult } from './types';
+export type FlowSurfaceFieldValueTarget = FlowSurfaceReactionTargetSummary & {
+    use?: string | null;
+    collection?: any;
+};
+export type FlowSurfaceFieldValueCompileResult = FlowSurfaceReactionWriteResult<FlowSurfaceFieldValueRule> & {
+    updateAssociationValues: string[];
+};
+export declare function isFieldValueTargetUseSupported(use?: string | null): boolean;
+export declare function assertFieldValueTargetSupported(target: FlowSurfaceFieldValueTarget): void;
+export declare function normalizeFieldValueRules(rules: FlowSurfaceFieldValueRule[] | undefined): FlowSurfaceFieldValueRule[];
+export declare function compileFieldValueRulesToCanonical(rules: FlowSurfaceFieldValueRule[] | undefined): {
+    key: string;
+    enable: boolean;
+    targetPath: string;
+    mode: string;
+    condition: import("./types").FlowSurfaceReactionFilter;
+    value: any;
+}[];
+export declare function collectUpdateAssociationValuesFromFieldValueRules(items: Array<{
+    targetPath?: string;
+} | any>, rootCollection: any): string[];
+export declare function buildFieldValueWriteResult(params: {
+    target: FlowSurfaceFieldValueTarget;
+    rules: FlowSurfaceFieldValueRule[] | undefined;
+}): FlowSurfaceFieldValueCompileResult;

package/dist/server/flow-surfaces/reaction/field-value.js

@@ -0,0 +1,181 @@
+/**
+ * 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 field_value_exports = {};
+__export(field_value_exports, {
+  assertFieldValueTargetSupported: () => assertFieldValueTargetSupported,
+  buildFieldValueWriteResult: () => buildFieldValueWriteResult,
+  collectUpdateAssociationValuesFromFieldValueRules: () => collectUpdateAssociationValuesFromFieldValueRules,
+  compileFieldValueRulesToCanonical: () => compileFieldValueRulesToCanonical,
+  isFieldValueTargetUseSupported: () => isFieldValueTargetUseSupported,
+  normalizeFieldValueRules: () => normalizeFieldValueRules
+});
+module.exports = __toCommonJS(field_value_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_errors = require("../errors");
+var import_errors2 = require("./errors");
+var import_fingerprint = require("./fingerprint");
+var import_registry = require("./registry");
+var import_value_expr = require("./value-expr");
+const FLOW_SURFACE_FIELD_VALUE_SUPPORTED_USES = /* @__PURE__ */ new Set(["CreateFormModel", "EditFormModel"]);
+const FLOW_SURFACE_FIELD_VALUE_SCENE = "form";
+const FLOW_SURFACE_FIELD_VALUE_SLOT = (0, import_registry.getReactionSlot)(
+  "fieldValue",
+  FLOW_SURFACE_FIELD_VALUE_SCENE
+);
+function isFieldValueTargetUseSupported(use) {
+  return FLOW_SURFACE_FIELD_VALUE_SUPPORTED_USES.has(String(use || "").trim());
+}
+function assertFieldValueTargetSupported(target) {
+  if (isFieldValueTargetUseSupported(target == null ? void 0 : target.use)) {
+    return;
+  }
+  const label = (target == null ? void 0 : target.publicPath) || (target == null ? void 0 : target.uid) || "target";
+  (0, import_errors.throwBadRequest)(
+    `flowSurfaces field value rules only support createForm/editForm targets; got '${label}' (${(target == null ? void 0 : target.use) || "unknown"})`,
+    import_errors2.FLOW_SURFACE_REACTION_FORM_ONLY
+  );
+}
+function normalizeFieldValueRule(rule, index) {
+  const current = import_lodash.default.isPlainObject(rule) ? rule : {};
+  const key = String(current.key || `idx:${index}`).trim();
+  return {
+    ...key ? { key } : {},
+    enabled: current.enabled !== false,
+    targetPath: (0, import_value_expr.normalizeReactionPath)(current.targetPath, `rules[${index}].targetPath`),
+    mode: current.mode === "default" ? "default" : "assign",
+    when: (0, import_value_expr.normalizeReactionFilter)(current.when),
+    value: (0, import_value_expr.normalizeReactionValueExpr)(current.value)
+  };
+}
+function normalizeFieldValueRules(rules) {
+  const list = Array.isArray(rules) ? rules : [];
+  return list.map((rule, index) => normalizeFieldValueRule(rule, index));
+}
+function compileFieldValueRulesToCanonical(rules) {
+  return normalizeFieldValueRules(rules).map((rule) => ({
+    key: rule.key,
+    enable: rule.enabled !== false,
+    targetPath: rule.targetPath,
+    mode: rule.mode === "default" ? "default" : "assign",
+    condition: (0, import_value_expr.compileReactionFilter)(rule.when),
+    value: (0, import_value_expr.compileReactionValueExpr)(rule.value)
+  }));
+}
+function collectUpdateAssociationValuesFromFieldValueRules(items, rootCollection) {
+  const list = Array.isArray(items) ? items : [];
+  const output = /* @__PURE__ */ new Set();
+  const getDeepestAssociationPath = (targetPath) => {
+    var _a, _b, _c;
+    if (!rootCollection || typeof rootCollection.getField !== "function") return null;
+    if (typeof targetPath !== "string" || !targetPath.includes(".")) return null;
+    const segments = targetPath.split(".").filter(Boolean);
+    if (segments.length < 2) return null;
+    let currentCollection = rootCollection;
+    const associationSegments = [];
+    let deepest = null;
+    let deepestField = null;
+    for (let index = 0; index < segments.length - 1; index += 1) {
+      const segment = segments[index];
+      const field = (_a = currentCollection == null ? void 0 : currentCollection.getField) == null ? void 0 : _a.call(currentCollection, segment);
+      if (!((_b = field == null ? void 0 : field.isAssociationField) == null ? void 0 : _b.call(field)) || !(field == null ? void 0 : field.targetCollection)) break;
+      associationSegments.push(segment);
+      deepest = associationSegments.join(".");
+      deepestField = field;
+      currentCollection = field.targetCollection;
+    }
+    if (deepest && deepestField) {
+      const leaf = segments[segments.length - 1];
+      const rawKey = (deepestField == null ? void 0 : deepestField.targetKey) ?? ((_c = deepestField == null ? void 0 : deepestField.targetCollection) == null ? void 0 : _c.filterTargetKey) ?? "id";
+      const keyFields = Array.isArray(rawKey) ? rawKey.filter((value) => typeof value === "string" && !!value) : typeof rawKey === "string" && rawKey ? [rawKey] : ["id"];
+      if (typeof leaf === "string" && keyFields.includes(leaf)) {
+        return null;
+      }
+    }
+    return deepest;
+  };
+  for (const item of list) {
+    const targetPath = typeof (item == null ? void 0 : item.targetPath) === "string" ? item.targetPath : "";
+    if (!targetPath) continue;
+    const associationPath = getDeepestAssociationPath(targetPath);
+    if (associationPath) {
+      output.add(associationPath);
+    }
+  }
+  return Array.from(output);
+}
+function buildFieldValueWriteResult(params) {
+  assertFieldValueTargetSupported(params.target);
+  const normalizedRules = normalizeFieldValueRules(params.rules);
+  const canonicalRules = normalizedRules.map((rule) => ({
+    key: rule.key,
+    enable: rule.enabled !== false,
+    targetPath: rule.targetPath,
+    mode: rule.mode,
+    condition: (0, import_value_expr.compileReactionFilter)(rule.when),
+    value: (0, import_value_expr.compileReactionValueExpr)(rule.value)
+  }));
+  const fingerprint = (0, import_fingerprint.buildReactionFingerprint)({
+    kind: "fieldValue",
+    scene: FLOW_SURFACE_FIELD_VALUE_SCENE,
+    slot: FLOW_SURFACE_FIELD_VALUE_SLOT,
+    canonicalRules
+  });
+  return {
+    target: {
+      uid: params.target.uid,
+      ...params.target.publicPath ? { publicPath: params.target.publicPath } : {}
+    },
+    resolvedScene: FLOW_SURFACE_FIELD_VALUE_SCENE,
+    resolvedSlot: FLOW_SURFACE_FIELD_VALUE_SLOT,
+    fingerprint,
+    normalizedRules,
+    canonicalRules,
+    updateAssociationValues: collectUpdateAssociationValuesFromFieldValueRules(
+      canonicalRules,
+      params.target.collection
+    )
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertFieldValueTargetSupported,
+  buildFieldValueWriteResult,
+  collectUpdateAssociationValuesFromFieldValueRules,
+  compileFieldValueRulesToCanonical,
+  isFieldValueTargetUseSupported,
+  normalizeFieldValueRules
+});

package/dist/server/flow-surfaces/reaction/fingerprint.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 { FlowSurfaceReactionKind, FlowSurfaceReactionScene, FlowSurfaceReactionSlot } from './types';
+export declare function buildReactionStableFingerprintString(value: any): string;
+export declare function buildReactionFingerprint(params: {
+    kind: FlowSurfaceReactionKind;
+    scene: FlowSurfaceReactionScene;
+    slot: FlowSurfaceReactionSlot;
+    canonicalRules: any[];
+}): string;

package/dist/server/flow-surfaces/reaction/fingerprint.js

@@ -0,0 +1,71 @@
+/**
+ * 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 fingerprint_exports = {};
+__export(fingerprint_exports, {
+  buildReactionFingerprint: () => buildReactionFingerprint,
+  buildReactionStableFingerprintString: () => buildReactionStableFingerprintString
+});
+module.exports = __toCommonJS(fingerprint_exports);
+var import_crypto = require("crypto");
+var import_lodash = __toESM(require("lodash"));
+function buildReactionStableFingerprintString(value) {
+  if (import_lodash.default.isNil(value)) {
+    return "null";
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => buildReactionStableFingerprintString(item)).join(",")}]`;
+  }
+  if (import_lodash.default.isPlainObject(value)) {
+    const entries = Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${buildReactionStableFingerprintString(value[key])}`);
+    return `{${entries.join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function buildReactionFingerprint(params) {
+  const payload = {
+    kind: params.kind,
+    scene: params.scene,
+    slot: params.slot,
+    canonicalRules: Array.isArray(params.canonicalRules) ? params.canonicalRules : []
+  };
+  return (0, import_crypto.createHash)("sha1").update(buildReactionStableFingerprintString(payload)).digest("hex");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildReactionFingerprint,
+  buildReactionStableFingerprintString
+});

package/dist/server/flow-surfaces/reaction/linkage.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 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 { FlowSurfaceActionLinkageRule, FlowSurfaceFieldLinkageRule, FlowSurfaceFieldLinkageScene, FlowSurfaceFieldOption, FlowSurfaceFieldPathToUidResolver, FlowSurfaceFieldUidToPathResolver, FlowSurfaceBlockLinkageRule } from './types';
+type NormalizeFieldRuleOptions = {
+    scene: FlowSurfaceFieldLinkageScene;
+    resolveFieldPath?: FlowSurfaceFieldUidToPathResolver;
+};
+type CompileFieldRuleOptions = {
+    scene: FlowSurfaceFieldLinkageScene;
+    resolveFieldUid?: FlowSurfaceFieldPathToUidResolver;
+};
+type FlowSurfaceLinkageValidationCapability = {
+    conditionMeta: {
+        operatorsByPath: Record<string, string[]>;
+    };
+};
+type FlowSurfaceFieldLinkageValidationCapability = FlowSurfaceLinkageValidationCapability & {
+    targetFields: FlowSurfaceFieldOption[];
+    valueExprMeta?: {
+        supportedSources: Array<'literal' | 'path' | 'runjs'>;
+    };
+};
+export declare function buildReactionFingerprint(value: any): string;
+export declare function normalizeBlockLinkageRules(rawRules: unknown): FlowSurfaceBlockLinkageRule[];
+export declare function normalizeActionLinkageRules(rawRules: unknown): FlowSurfaceActionLinkageRule[];
+export declare function normalizeFieldLinkageRules(rawRules: unknown, options: NormalizeFieldRuleOptions): FlowSurfaceFieldLinkageRule[];
+export declare function validateBlockLinkageSceneSupport(scene: string, rules?: FlowSurfaceBlockLinkageRule[]): void;
+export declare function validateBlockLinkageRulesAgainstCapability(rules: FlowSurfaceBlockLinkageRule[], capability: FlowSurfaceLinkageValidationCapability): void;
+export declare function validateActionLinkageSceneSupport(scene: string, rules?: FlowSurfaceActionLinkageRule[]): void;
+export declare function validateActionLinkageRulesAgainstCapability(rules: FlowSurfaceActionLinkageRule[], capability: FlowSurfaceLinkageValidationCapability): void;
+export declare function validateFieldLinkageSceneSupport(scene: FlowSurfaceFieldLinkageScene, rules?: FlowSurfaceFieldLinkageRule[]): void;
+export declare function validateFieldLinkageRulesAgainstCapability(rules: FlowSurfaceFieldLinkageRule[], capability: FlowSurfaceFieldLinkageValidationCapability): void;
+export declare function compileBlockLinkageCanonicalRules(rules: FlowSurfaceBlockLinkageRule[]): {
+    key: string;
+    title: string;
+    enable: boolean;
+    condition: any;
+    actions: ({
+        key: string;
+        name: "linkageSetBlockProps";
+        params: {
+            value: "visible" | "hidden";
+        };
+    } | {
+        key: string;
+        name: "linkageRunjs";
+        params: {
+            value: {
+                version?: "v2" | "v1";
+                script: string;
+            };
+        };
+    })[];
+}[];
+export declare function compileActionLinkageCanonicalRules(rules: FlowSurfaceActionLinkageRule[]): {
+    key: string;
+    title: string;
+    enable: boolean;
+    condition: any;
+    actions: ({
+        key: string;
+        name: "linkageSetActionProps";
+        params: {
+            value: "disabled" | "visible" | "hidden" | "hiddenText" | "enabled";
+        };
+    } | {
+        key: string;
+        name: "linkageRunjs";
+        params: {
+            value: {
+                version?: "v2" | "v1";
+                script: string;
+            };
+        };
+    })[];
+}[];
+export declare function compileFieldLinkageCanonicalRules(rules: FlowSurfaceFieldLinkageRule[], options: CompileFieldRuleOptions): {
+    key: string;
+    title: string;
+    enable: boolean;
+    condition: any;
+    actions: ({
+        key: string;
+        name: "linkageSetFieldProps" | "linkageSetDetailsFieldProps" | "subFormLinkageSetFieldProps";
+        params: {
+            value: {
+                fields: string[];
+                state: "disabled" | "required" | "visible" | "hidden" | "enabled" | "hiddenReservedValue" | "notRequired";
+            };
+        };
+    } | {
+        key: string;
+        name: "linkageAssignField" | "subFormLinkageAssignField";
+        params: {
+            value: {
+                key: string;
+                enable: boolean;
+                targetPath: string;
+                mode: "default" | "assign";
+                condition: any;
+                value: any;
+            }[];
+        };
+    } | {
+        key: string;
+        name: "setFieldsDefaultValue";
+        params: {
+            value: {
+                key: string;
+                enable: boolean;
+                targetPath: string;
+                mode: "default" | "assign";
+                condition: any;
+                value: any;
+            }[];
+        };
+    } | {
+        key: string;
+        name: "linkageRunjs";
+        params: {
+            value: {
+                version?: "v2" | "v1";
+                script: string;
+                fields?: undefined;
+                state?: undefined;
+            };
+        };
+    })[];
+}[];
+export {};