@nocobase/plugin-flow-engine 2.1.0-beta.33 → 2.1.0-beta.35

package/dist/node_modules/@ant-design/icons-svg/lib/types.d.ts

@@ -0,0 +1,14 @@
+export interface AbstractNode {
+    tag: string;
+    attrs: {
+        [key: string]: string;
+    };
+    children?: AbstractNode[];
+}
+export interface IconDefinition {
+    name: string;
+    theme: ThemeType;
+    icon: ((primaryColor: string, secondaryColor: string) => AbstractNode) | AbstractNode;
+}
+export type ThemeType = 'filled' | 'outlined' | 'twotone';
+export type ThemeTypeUpperCase = 'Filled' | 'Outlined' | 'TwoTone';

package/dist/node_modules/@ant-design/icons-svg/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/node_modules/@ant-design/icons-svg/package.json

@@ -0,0 +1 @@
+{"name":"@ant-design/icons-svg","version":"4.3.1","sideEffects":false,"description":"Abstract nodes for ant design icons.","contributors":["HeskeyBaozi <hezhiyu233@foxmail.com>"],"homepage":"https://github.com/ant-design/ant-design-icons/","license":"MIT","main":"lib/index.js","module":"es/index.js","files":["lib","es","inline-svg","inline-namespaced-svg"],"repository":{"type":"git","url":"git+https://github.com/ant-design/ant-design-icons.git"},"scripts":{"g":"npm run generate","generate":"cross-env NODE_ENV=production gulp --require ts-node/register/transpile-only","type-check":"tsc --noEmit","build:es":"tsc --project tsconfig.build.json --module esnext --outDir es","build:lib":"tsc --project tsconfig.build.json --module commonjs --outDir lib","build":"cross-env NODE_ENV=production && npm run build:es && npm run build:lib","test":"cross-env NODE_ENV=test && npm run test:unit","test:unit":"jest","prepublishOnly":"npm run test && npm run g && npm run build && npm run type-check && npm run digest","digest":"node scripts/digest.js"},"bugs":{"url":"https://github.com/ant-design/ant-design-icons/issues"},"devDependencies":{"@babel/core":"^7.8.6","@babel/preset-env":"^7.8.6","@babel/preset-typescript":"^7.8.3","@rgrove/parse-xml":"^2.0.2","@types/gulp":"^4.0.6","@types/gulp-concat":"^0.0.32","@types/gulp-rename":"^0.0.33","@types/jest":"^25.1.3","@types/lodash.camelcase":"^4.3.6","@types/lodash.template":"^4.4.6","@types/lodash.upperfirst":"^4.3.6","@types/node":"^13.9.3","@types/ramda":"^0.26.43","@types/rgrove__parse-xml":"^1.1.0","@types/svgo":"^1.3.1","@types/through2":"^2.0.34","@typescript-eslint/eslint-plugin":"^2.21.0","@typescript-eslint/parser":"^2.21.0","babel-jest":"^25.1.0","cross-env":"^7.0.0","del":"^5.1.0","eslint":"^7.16.0","globby":"^11.0.0","gulp":"^4.0.2","gulp-clone":"^2.0.1","gulp-concat":"^2.6.1","gulp-header":"^2.0.9","gulp-rename":"^2.0.0","jest":"^25.1.0","lodash.camelcase":"^4.3.0","lodash.template":"^4.5.0","lodash.upperfirst":"^4.3.1","ramda":"^0.27.0","svgo":"^1.3.2","through2":"^3.0.1","ts-node":"^8.6.2","typescript":"^4.0.0","vinyl":"^2.2.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_lastModified":"2026-05-19T16:49:04.462Z"}

package/dist/node_modules/ses/package.json

@@ -1 +1 @@
-{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-05-15T15:54:01.054Z"}
+{"name":"ses","version":"1.14.0","description":"Hardened JavaScript for Fearless Cooperation","keywords":["lockdown","harden","Compartment","assert","security","confinement","isolation","object capabilities","ocaps","secure execution","third-party code","prototype pollution","supply-chain attack","plugin"],"author":"Agoric","license":"Apache-2.0","homepage":"https://github.com/Agoric/SES-shim/tree/master/packages/ses#readme","repository":{"type":"git","url":"git+https://github.com/endojs/endo.git","directory":"packages/ses"},"bugs":{"url":"https://github.com/endojs/endo/issues"},"type":"module","main":"./dist/ses.cjs","module":"./index.js","unpkg":"./dist/ses.umd.js","types":"./types.d.ts","exports":{".":{"import":{"types":"./types.d.ts","xs":"./src-xs/index.js","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./lockdown":{"import":{"types":"./types.d.ts","default":"./index.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/ses.cjs"}},"./hermes":{"require":{"types":"./dist/types.d.cts","default":"./dist/ses-hermes.cjs"}},"./tools.js":"./tools.js","./assert-shim.js":"./assert-shim.js","./lockdown-shim.js":{"xs":"./src-xs/lockdown-shim.js","default":"./lockdown-shim.js"},"./compartment-shim.js":{"xs":"./src-xs/compartment-shim.js","default":"./compartment-shim.js"},"./console-shim.js":"./console-shim.js","./package.json":"./package.json"},"scripts":{"build:vanilla":"node scripts/bundle.js","build:hermes":"node scripts/bundle.js hermes","build":"yarn build:vanilla && yarn build:hermes","clean":"rm -rf dist","cover":"c8 ava","demo":"python3 -m http.server","lint":"yarn lint:types && yarn lint:eslint","lint-fix":"eslint --fix .","lint:eslint":"eslint .","lint:types":"tsc","prepare":"npm run clean && npm run build","qt":"ava","test":"tsd && ava","test:hermes":"./scripts/hermes-test.sh","test:xs":"xst dist/ses.umd.js test/_lockdown-safe.js && node scripts/generate-test-xs.js && xst tmp/test-xs.js && rm -rf tmp","postpack":"git clean -fX \"*.d.ts*\" \"*.d.cts*\" \"*.d.mts*\" \"*.tsbuildinfo\""},"dependencies":{"@endo/cache-map":"^1.1.0","@endo/env-options":"^1.1.11","@endo/immutable-arraybuffer":"^1.1.2"},"devDependencies":{"@babel/generator":"^7.26.3","@babel/parser":"~7.26.2","@babel/traverse":"~7.25.9","@babel/types":"~7.26.0","@endo/compartment-mapper":"^1.6.3","@endo/module-source":"^1.3.3","@endo/test262-runner":"^0.1.48","@types/babel__traverse":"^7.20.5","ava":"^6.1.3","babel-eslint":"^10.1.0","c8":"^7.14.0","core-js":"^3.31.0","eslint":"^8.57.1","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^9.1.0","eslint-plugin-eslint-comments":"^3.2.0","eslint-plugin-import":"^2.31.0","hermes-engine-cli":"^0.12.0","prettier":"^3.5.3","terser":"^5.16.6","tsd":"^0.31.2","typescript":"~5.8.3"},"files":["./*.d.ts","./*.js","./*.map","LICENSE*","SECURITY*","dist","lib","src","tools"],"publishConfig":{"access":"public"},"eslintConfig":{"extends":["plugin:@endo/ses"]},"ava":{"files":["test/**/*.test.*"],"timeout":"2m"},"typeCoverage":{"atLeast":81.17},"gitHead":"9815aea9541f241389d2135c6097a7442bdffa17","_lastModified":"2026-05-19T16:49:04.968Z"}

package/dist/node_modules/zod/package.json

@@ -1 +1 @@
-{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-05-15T15:54:02.192Z"}
+{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-05-19T16:49:06.141Z"}

package/dist/server/flow-surfaces/apply/compiler.js

@@ -770,16 +770,68 @@ function emitDomainSettingOps(ops, nodeRef, currentNode, desiredNode, explicitTa
       values
     });
   }
-  if (!import_lodash.default.isNil(desiredNode.flowRegistry) && !import_lodash.default.isEqual(desiredNode.flowRegistry, currentNode == null ? void 0 : currentNode.flowRegistry)) {
+  emitFlowRegistryOps(ops, nodeRef, currentNode, desiredNode, explicitTarget);
+}
+function emitFlowRegistryOps(ops, nodeRef, currentNode, desiredNode, explicitTarget) {
+  if (import_lodash.default.isNil(desiredNode.flowRegistry) || import_lodash.default.isEqual(desiredNode.flowRegistry, currentNode == null ? void 0 : currentNode.flowRegistry)) {
+    return;
+  }
+  const target = explicitTarget || { uid: nodeRef.uidRef };
+  const currentFlowRegistry = import_lodash.default.isPlainObject(currentNode == null ? void 0 : currentNode.flowRegistry) ? currentNode.flowRegistry : {};
+  const desiredFlowRegistry = import_lodash.default.isPlainObject(desiredNode.flowRegistry) ? desiredNode.flowRegistry : {};
+  const currentKeys = Object.keys(currentFlowRegistry);
+  const desiredKeys = Object.keys(desiredFlowRegistry);
+  for (const key of currentKeys) {
+    if (!Object.prototype.hasOwnProperty.call(desiredFlowRegistry, key)) {
+      ops.push({
+        type: "removeEventFlow",
+        target,
+        values: {
+          key
+        }
+      });
+    }
+  }
+  for (const key of desiredKeys) {
+    const flow = desiredFlowRegistry[key];
+    if (Object.prototype.hasOwnProperty.call(currentFlowRegistry, key)) {
+      if (import_lodash.default.isEqual(flow, currentFlowRegistry[key])) {
+        continue;
+      }
+      ops.push({
+        type: "setEventFlow",
+        target,
+        values: {
+          key,
+          flow
+        }
+      });
+      continue;
+    }
+    if (isBeforeAllEventFlow(flow)) {
+      ops.push({
+        type: "addEventFlow",
+        target,
+        values: {
+          key,
+          flow
+        }
+      });
+      continue;
+    }
     ops.push({
-      type: "setEventFlows",
-      target: explicitTarget || { uid: nodeRef.uidRef },
+      type: "setEventFlow",
+      target,
       values: {
-        flowRegistry: desiredNode.flowRegistry
+        key,
+        flow
       }
     });
   }
 }
+function isBeforeAllEventFlow(flow) {
+  return import_lodash.default.isPlainObject(flow) && import_lodash.default.isPlainObject(flow.on) && typeof flow.on.eventName === "string" && (typeof flow.on.phase === "undefined" || flow.on.phase === "beforeAllFlows");
+}
 function getDefaultChildRef(parentRef, subKey, childUse) {
   if (!parentRef.sourceOpId || !childUse) {
     return null;

package/dist/server/flow-surfaces/association-title-field.d.ts

@@ -12,9 +12,31 @@ export type FlowSurfaceResolvedAssociationTitleField = {
     source: 'explicit' | 'firstTitleable' | 'relationFieldLabel';
     targetCollection?: any;
 };
+export type FlowSurfaceTitleFieldErrorOptions = {
+    action?: string;
+    path?: string;
+    fieldPath?: string;
+    titleField?: string;
+    targetCollection?: any;
+    targetCollectionName?: string;
+    invalidReason?: string;
+    details?: Record<string, any>;
+};
 export declare function isTitleableCollectionField(field: any): any;
 export declare function getExplicitCollectionTitleFieldName(collection: any): string;
-export declare function assertCollectionTitleFieldExists(collection: any, fieldName: string): any;
-export declare function resolveCollectionSafeTitleField(collection: any): FlowSurfaceResolvedAssociationTitleField | null;
+export declare function normalizeFlowSurfaceTitleField(value: any): string;
+export declare function getFlowSurfaceTitleFieldCandidateNames(collection: any, limit?: number): {
+    availableFields: any[];
+    availableFieldsTruncated: boolean;
+};
+export declare function buildFlowSurfaceTitleFieldErrorDetails(options?: FlowSurfaceTitleFieldErrorOptions, candidates?: {
+    availableFields: any[];
+    availableFieldsTruncated: boolean;
+}): {
+    [k: string]: any;
+};
+export declare function assertFlowSurfaceTitleFieldIsNotId(value: any, options?: FlowSurfaceTitleFieldErrorOptions): void;
+export declare function assertCollectionTitleFieldExists(collection: any, fieldName: string, options?: FlowSurfaceTitleFieldErrorOptions): any;
+export declare function resolveCollectionSafeTitleField(collection: any, options?: FlowSurfaceTitleFieldErrorOptions): FlowSurfaceResolvedAssociationTitleField | null;
 export declare function resolveAssociationTitleFieldTargetCollection(field: any, dataSourceKey: string, getCollection: (dataSourceKey: string, collectionName: string) => any): any;
-export declare function resolveAssociationSafeTitleField(field: any, dataSourceKey: string, getCollection: (dataSourceKey: string, collectionName: string) => any): FlowSurfaceResolvedAssociationTitleField | null;
+export declare function resolveAssociationSafeTitleField(field: any, dataSourceKey: string, getCollection: (dataSourceKey: string, collectionName: string) => any, options?: FlowSurfaceTitleFieldErrorOptions): FlowSurfaceResolvedAssociationTitleField | null;

package/dist/server/flow-surfaces/association-title-field.js

@@ -27,8 +27,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var association_title_field_exports = {};
 __export(association_title_field_exports, {
   assertCollectionTitleFieldExists: () => assertCollectionTitleFieldExists,
+  assertFlowSurfaceTitleFieldIsNotId: () => assertFlowSurfaceTitleFieldIsNotId,
+  buildFlowSurfaceTitleFieldErrorDetails: () => buildFlowSurfaceTitleFieldErrorDetails,
   getExplicitCollectionTitleFieldName: () => getExplicitCollectionTitleFieldName,
+  getFlowSurfaceTitleFieldCandidateNames: () => getFlowSurfaceTitleFieldCandidateNames,
   isTitleableCollectionField: () => isTitleableCollectionField,
+  normalizeFlowSurfaceTitleField: () => normalizeFlowSurfaceTitleField,
   resolveAssociationSafeTitleField: () => resolveAssociationSafeTitleField,
   resolveAssociationTitleFieldTargetCollection: () => resolveAssociationTitleFieldTargetCollection,
   resolveCollectionSafeTitleField: () => resolveCollectionSafeTitleField
@@ -65,6 +69,7 @@ const FALLBACK_TITLE_USABLE_INTERFACES = /* @__PURE__ */ new Set([
 ]);
 const LAST_RESORT_TITLE_FIELD_NAMES = /* @__PURE__ */ new Set(["createdAt", "updatedAt"]);
 const LAST_RESORT_TITLE_FIELD_INTERFACES = /* @__PURE__ */ new Set(["createdAt", "updatedAt"]);
+const TITLE_FIELD_CANDIDATE_LIMIT = 20;
 function isTitleableCollectionField(field) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const configured = (field == null ? void 0 : field.titleable) ?? (field == null ? void 0 : field.titleUsable) ?? ((_a = field == null ? void 0 : field.options) == null ? void 0 : _a.titleable) ?? ((_b = field == null ? void 0 : field.options) == null ? void 0 : _b.titleUsable);
@@ -90,16 +95,80 @@ function getExplicitCollectionTitleFieldName(collection) {
   const explicit = (_a = collection == null ? void 0 : collection.options) == null ? void 0 : _a.titleField;
   return typeof explicit === "string" ? explicit.trim() || void 0 : void 0;
 }
-function normalizeTitleFieldName(value) {
+function normalizeFlowSurfaceTitleField(value) {
   if (typeof value !== "string") {
     return void 0;
   }
   const normalized = value.trim();
   return normalized || void 0;
 }
+function getFlowSurfaceTitleFieldCandidateNames(collection, limit = TITLE_FIELD_CANDIDATE_LIMIT) {
+  const candidates = (0, import_service_helpers.getCollectionFields)(collection).filter((field) => {
+    const fieldName = (0, import_service_helpers.getFieldName)(field);
+    return !!fieldName && !isIdTitleFieldName(fieldName) && !(0, import_service_helpers.isAssociationField)(field);
+  }).map(import_service_helpers.getFieldName).filter(Boolean);
+  return {
+    availableFields: candidates.slice(0, limit),
+    availableFieldsTruncated: candidates.length > limit
+  };
+}
+function buildDefinedTitleFieldDetails(details) {
+  return Object.fromEntries(Object.entries(details).filter(([, value]) => typeof value !== "undefined"));
+}
+function buildFlowSurfaceTitleFieldErrorDetails(options = {}, candidates = getFlowSurfaceTitleFieldCandidateNames(options.targetCollection)) {
+  const { availableFields, availableFieldsTruncated } = candidates;
+  return buildDefinedTitleFieldDetails({
+    action: options.action,
+    fieldPath: options.fieldPath,
+    titleField: options.titleField,
+    targetCollection: getTitleFieldTargetCollectionName(options),
+    invalidReason: options.invalidReason,
+    availableFields: availableFields.length ? availableFields : void 0,
+    availableFieldsTruncated: availableFieldsTruncated || void 0,
+    suggestion: buildTitleFieldSuggestion(options, availableFields),
+    ...options.details
+  });
+}
+function getTitleFieldTargetCollectionName(options) {
+  return String(options.targetCollectionName || "").trim() || (0, import_service_helpers.getCollectionName)(options.targetCollection) || void 0;
+}
+function buildTitleFieldSuggestion(options, availableFields) {
+  const targetCollectionName = getTitleFieldTargetCollectionName(options);
+  const target = targetCollectionName ? ` on target collection '${targetCollectionName}'` : "";
+  if (availableFields.length) {
+    return `Use one of: ${availableFields.join(", ")}.`;
+  }
+  return `Set titleField to a readable non-association field${target}.`;
+}
+function buildTitleFieldGuidance(options, availableFields) {
+  const targetCollectionName = getTitleFieldTargetCollectionName(options);
+  const target = targetCollectionName ? ` on target collection '${targetCollectionName}'` : "";
+  const suggestion = availableFields.length ? ` Use one of: ${availableFields.join(", ")}.` : "";
+  return `; relation titleField must be a readable non-association field${target}.${suggestion}`;
+}
+function throwTitleFieldBadRequest(baseMessage, ruleId, options = {}) {
+  const candidates = getFlowSurfaceTitleFieldCandidateNames(options.targetCollection);
+  const details = buildFlowSurfaceTitleFieldErrorDetails(options, candidates);
+  const errorOptions = buildDefinedTitleFieldDetails({
+    path: options.path,
+    ruleId,
+    details
+  });
+  (0, import_errors.throwBadRequest)(`${baseMessage}${buildTitleFieldGuidance(options, candidates.availableFields)}`, errorOptions);
+}
+function assertFlowSurfaceTitleFieldIsNotId(value, options = {}) {
+  const normalizedTitleField = normalizeFlowSurfaceTitleField(value);
+  if (normalizedTitleField === "id") {
+    throwTitleFieldBadRequest("flowSurfaces titleField cannot use 'id'", "relation-titleField-unreadable", {
+      ...options,
+      titleField: normalizedTitleField,
+      invalidReason: options.invalidReason || "id"
+    });
+  }
+}
 function getAssociationConfiguredLabelFieldName(field) {
   var _a, _b, _c, _d, _e, _f, _g;
-  return normalizeTitleFieldName((_c = (_b = (_a = field == null ? void 0 : field.uiSchema) == null ? void 0 : _a["x-component-props"]) == null ? void 0 : _b.fieldNames) == null ? void 0 : _c.label) || normalizeTitleFieldName((_g = (_f = (_e = (_d = field == null ? void 0 : field.options) == null ? void 0 : _d.uiSchema) == null ? void 0 : _e["x-component-props"]) == null ? void 0 : _f.fieldNames) == null ? void 0 : _g.label);
+  return normalizeFlowSurfaceTitleField((_c = (_b = (_a = field == null ? void 0 : field.uiSchema) == null ? void 0 : _a["x-component-props"]) == null ? void 0 : _b.fieldNames) == null ? void 0 : _c.label) || normalizeFlowSurfaceTitleField((_g = (_f = (_e = (_d = field == null ? void 0 : field.options) == null ? void 0 : _d.uiSchema) == null ? void 0 : _e["x-component-props"]) == null ? void 0 : _f.fieldNames) == null ? void 0 : _g.label);
 }
 function isLastResortTitleField(field) {
   const fieldName = (0, import_service_helpers.getFieldName)(field);
@@ -109,26 +178,60 @@ function isLastResortTitleField(field) {
   const fieldInterface = (0, import_service_helpers.getFieldInterface)(field);
   return !!(fieldInterface && LAST_RESORT_TITLE_FIELD_INTERFACES.has(fieldInterface));
 }
-function assertCollectionTitleFieldExists(collection, fieldName) {
+function isIdTitleFieldName(value) {
+  return normalizeFlowSurfaceTitleField(value) === "id";
+}
+function assertCollectionTitleFieldExists(collection, fieldName, options = {}) {
   const normalizedFieldName = typeof fieldName === "string" ? fieldName.trim() : String(fieldName || "").trim();
   if (!normalizedFieldName) {
-    (0, import_errors.throwBadRequest)("flowSurfaces association titleField must be a non-empty string");
+    throwTitleFieldBadRequest(
+      "flowSurfaces association titleField must be a non-empty string",
+      "relation-titleField-invalid-shape",
+      {
+        ...options,
+        targetCollection: collection,
+        invalidReason: "empty"
+      }
+    );
   }
+  assertFlowSurfaceTitleFieldIsNotId(normalizedFieldName, {
+    ...options,
+    targetCollection: collection
+  });
   const field = (0, import_service_helpers.resolveFieldFromCollection)(collection, normalizedFieldName);
   if (!field) {
-    (0, import_errors.throwBadRequest)(
-      `flowSurfaces collection '${(0, import_service_helpers.getCollectionName)(collection) || "unknown"}' titleField '${normalizedFieldName}' not found`
+    throwTitleFieldBadRequest(
+      `flowSurfaces collection '${(0, import_service_helpers.getCollectionName)(collection) || "unknown"}' titleField '${normalizedFieldName}' not found`,
+      "relation-titleField-unknown",
+      {
+        ...options,
+        targetCollection: collection,
+        titleField: normalizedFieldName,
+        invalidReason: "missing"
+      }
+    );
+  }
+  if ((0, import_service_helpers.isAssociationField)(field)) {
+    throwTitleFieldBadRequest(
+      `flowSurfaces collection '${(0, import_service_helpers.getCollectionName)(collection) || "unknown"}' titleField '${normalizedFieldName}' is not readable`,
+      "relation-titleField-unreadable",
+      {
+        ...options,
+        targetCollection: collection,
+        titleField: normalizedFieldName,
+        invalidReason: "association"
+      }
     );
   }
   return field;
 }
-function resolveCollectionSafeTitleField(collection) {
+function resolveCollectionSafeTitleField(collection, options = {}) {
   if (!collection) {
     return null;
   }
   const explicitTitleField = getExplicitCollectionTitleFieldName(collection);
   if (explicitTitleField) {
-    const field = assertCollectionTitleFieldExists(collection, explicitTitleField);
+    const field = assertCollectionTitleFieldExists(collection, explicitTitleField, options);
     return {
       field,
       fieldName: (0, import_service_helpers.getFieldName)(field) || explicitTitleField,
@@ -136,15 +239,12 @@ function resolveCollectionSafeTitleField(collection) {
       targetCollection: collection
     };
   }
-  const firstTitleableField = (0, import_service_helpers.getCollectionFields)(collection).find(
-    (field) => !!(0, import_service_helpers.getFieldName)(field) && isTitleableCollectionField(field)
-  );
+  const isSafeTitleableField = (field) => !!(0, import_service_helpers.getFieldName)(field) && !isIdTitleFieldName((0, import_service_helpers.getFieldName)(field)) && !(0, import_service_helpers.isAssociationField)(field) && isTitleableCollectionField(field);
+  const firstTitleableField = (0, import_service_helpers.getCollectionFields)(collection).find(isSafeTitleableField);
   if (!firstTitleableField) {
     return null;
   }
-  const preferredTitleableField = (0, import_service_helpers.getCollectionFields)(collection).find(
-    (field) => !!(0, import_service_helpers.getFieldName)(field) && isTitleableCollectionField(field) && !isLastResortTitleField(field)
-  ) || firstTitleableField;
+  const preferredTitleableField = (0, import_service_helpers.getCollectionFields)(collection).find((field) => isSafeTitleableField(field) && !isLastResortTitleField(field)) || firstTitleableField;
   return {
     field: preferredTitleableField,
     fieldName: (0, import_service_helpers.getFieldName)(preferredTitleableField),
@@ -155,15 +255,27 @@ function resolveCollectionSafeTitleField(collection) {
 function resolveAssociationTitleFieldTargetCollection(field, dataSourceKey, getCollection) {
   return (0, import_service_helpers.resolveFieldTargetCollection)(field, dataSourceKey, getCollection) || null;
 }
-function resolveAssociationSafeTitleField(field, dataSourceKey, getCollection) {
+function resolveAssociationSafeTitleField(field, dataSourceKey, getCollection, options = {}) {
   const targetCollection = resolveAssociationTitleFieldTargetCollection(field, dataSourceKey, getCollection);
   if (!targetCollection) {
     return null;
   }
+  const titleFieldErrorOptions = {
+    ...options,
+    targetCollection
+  };
   const configuredLabelFieldName = getAssociationConfiguredLabelFieldName(field);
   if (configuredLabelFieldName) {
+    assertFlowSurfaceTitleFieldIsNotId(configuredLabelFieldName, {
+      ...titleFieldErrorOptions,
+      titleField: configuredLabelFieldName
+    });
     const configuredLabelField = (0, import_service_helpers.resolveFieldFromCollection)(targetCollection, configuredLabelFieldName);
     if (configuredLabelField) {
+      assertCollectionTitleFieldExists(targetCollection, configuredLabelFieldName, {
+        ...titleFieldErrorOptions,
+        titleField: configuredLabelFieldName
+      });
       return {
         field: configuredLabelField,
         fieldName: configuredLabelFieldName,
@@ -172,7 +284,7 @@ function resolveAssociationSafeTitleField(field, dataSourceKey, getCollection) {
       };
     }
   }
-  const resolved = resolveCollectionSafeTitleField(targetCollection);
+  const resolved = resolveCollectionSafeTitleField(targetCollection, titleFieldErrorOptions);
   if (!resolved) {
     return null;
   }
@@ -184,8 +296,12 @@ function resolveAssociationSafeTitleField(field, dataSourceKey, getCollection) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   assertCollectionTitleFieldExists,
+  assertFlowSurfaceTitleFieldIsNotId,
+  buildFlowSurfaceTitleFieldErrorDetails,
   getExplicitCollectionTitleFieldName,
+  getFlowSurfaceTitleFieldCandidateNames,
   isTitleableCollectionField,
+  normalizeFlowSurfaceTitleField,
   resolveAssociationSafeTitleField,
   resolveAssociationTitleFieldTargetCollection,
   resolveCollectionSafeTitleField

package/dist/server/flow-surfaces/authoring-validation.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 { FlowSurfaceErrorItemInput } from './errors';
+export type FlowSurfaceAuthoringWriteAction = 'applyBlueprint' | 'compose' | 'addBlock' | 'addBlocks' | 'configure';
+export interface FlowSurfaceAuthoringValidationContext {
+    authoringActionName?: FlowSurfaceAuthoringWriteAction;
+    applyBlueprintScriptAssets?: Record<string, any>;
+    getCollection?: (dataSourceKey: string, collectionName: string) => any;
+    findMenuGroupRoutesByTitle?: (title: string, transaction?: any) => Promise<any[]>;
+    transaction?: any;
+    hostBlockType?: string;
+    hostCollectionName?: string;
+    hostDataSourceKey?: string;
+    currentCollectionName?: string;
+    currentDataSourceKey?: string;
+    enabledPackages?: ReadonlySet<string>;
+    currentNode?: any;
+    skipGeneratedPopupDefaultFieldGroups?: boolean;
+    skipGeneratedLayoutSingleColumnErrors?: boolean;
+    findModelById?: (uid: string, options?: {
+        transaction?: any;
+        includeAsyncNode?: boolean;
+    }) => Promise<any>;
+    findOwningBlockGrid?: (uid: string, transaction?: any) => Promise<any>;
+}
+export declare function assertFlowSurfaceAuthoringPayload(actionName: FlowSurfaceAuthoringWriteAction, values: any, context?: FlowSurfaceAuthoringValidationContext): Promise<void>;
+export declare function collectFlowSurfaceAuthoringErrors(actionName: FlowSurfaceAuthoringWriteAction, values: any, context?: FlowSurfaceAuthoringValidationContext): Promise<FlowSurfaceErrorItemInput[]>;