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

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

@@ -0,0 +1,175 @@
+/**
+ * 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 layout_exports = {};
+__export(layout_exports, {
+  buildAutoLayout: () => buildAutoLayout,
+  didItemRefsChange: () => didItemRefsChange,
+  emitLayoutOp: () => emitLayoutOp,
+  emitMoveOps: () => emitMoveOps,
+  emitMovePopupTabOps: () => emitMovePopupTabOps,
+  emitMoveTabOps: () => emitMoveTabOps,
+  omitLayoutProps: () => omitLayoutProps
+});
+module.exports = __toCommonJS(layout_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_placement = require("../placement");
+function extractLayout(props) {
+  if (!props || !("rows" in props) && !("sizes" in props) && !("rowOrder" in props)) {
+    return null;
+  }
+  return {
+    rows: props.rows || {},
+    sizes: props.sizes || {},
+    rowOrder: props.rowOrder || Object.keys(props.rows || {})
+  };
+}
+function omitLayoutProps(props) {
+  if (!props) {
+    return props;
+  }
+  const next = import_lodash.default.omit(props, ["rows", "sizes", "rowOrder"]);
+  return Object.keys(next).length ? next : void 0;
+}
+function resolveLayoutRefs(layout, childClientKeyRefs) {
+  if (!layout) {
+    return layout;
+  }
+  return {
+    rows: Object.fromEntries(
+      Object.entries(layout.rows || {}).map(([rowId, cells]) => [
+        rowId,
+        import_lodash.default.castArray(cells).map(
+          (cell) => import_lodash.default.castArray(cell).map((itemUid) => childClientKeyRefs[itemUid] ?? itemUid)
+        )
+      ])
+    ),
+    sizes: layout.sizes || {},
+    rowOrder: layout.rowOrder || []
+  };
+}
+function hasRefValue(value) {
+  if (Array.isArray(value)) {
+    return value.some((item) => hasRefValue(item));
+  }
+  if (import_lodash.default.isPlainObject(value)) {
+    if (typeof value.ref === "string") {
+      return true;
+    }
+    return Object.values(value).some((item) => hasRefValue(item));
+  }
+  return false;
+}
+function buildAutoLayout(itemRefs) {
+  if (!itemRefs.length) {
+    return {
+      rows: {},
+      sizes: {},
+      rowOrder: []
+    };
+  }
+  return {
+    rows: Object.fromEntries(itemRefs.map((itemRef, index) => [`autoRow${index + 1}`, [[itemRef]]])),
+    sizes: Object.fromEntries(itemRefs.map((_2, index) => [`autoRow${index + 1}`, [24]])),
+    rowOrder: itemRefs.map((_2, index) => `autoRow${index + 1}`)
+  };
+}
+function didItemRefsChange(currentChildren, desiredRefs) {
+  if (currentChildren.length !== desiredRefs.length) {
+    return true;
+  }
+  return desiredRefs.some(
+    (item, index) => {
+      var _a;
+      return typeof item.uidRef !== "string" || ((_a = currentChildren[index]) == null ? void 0 : _a.uid) !== item.uidRef;
+    }
+  );
+}
+function emitLayoutOp(ops, target, currentNode, desiredNode, childSync) {
+  const explicitLayout = resolveLayoutRefs(extractLayout(desiredNode.props), childSync.childClientKeyRefs);
+  const desiredLayout = explicitLayout || ((0, import_placement.isGridUse)((currentNode == null ? void 0 : currentNode.use) || desiredNode.use) && childSync.itemsSpecified ? buildAutoLayout(childSync.finalItemRefs.map((item) => item.uidRef)) : null);
+  if (!desiredLayout) {
+    return;
+  }
+  if (!hasRefValue(desiredLayout) && import_lodash.default.isEqual(desiredLayout, extractLayout(currentNode == null ? void 0 : currentNode.props))) {
+    return;
+  }
+  ops.push({
+    type: "setLayout",
+    target,
+    values: desiredLayout
+  });
+}
+function emitMoveOps(ops, desiredRefs) {
+  for (let index = desiredRefs.length - 2; index >= 0; index -= 1) {
+    ops.push({
+      type: "moveNode",
+      values: {
+        sourceUid: desiredRefs[index].uidRef,
+        targetUid: desiredRefs[index + 1].uidRef,
+        position: "before"
+      }
+    });
+  }
+}
+function emitOrderedTabMoves(ops, desiredRefs, type) {
+  for (let index = desiredRefs.length - 2; index >= 0; index -= 1) {
+    ops.push({
+      type,
+      values: {
+        sourceUid: desiredRefs[index].uidRef,
+        targetUid: desiredRefs[index + 1].uidRef,
+        position: "before"
+      }
+    });
+  }
+}
+function emitMoveTabOps(ops, desiredRefs) {
+  emitOrderedTabMoves(ops, desiredRefs, "moveTab");
+}
+function emitMovePopupTabOps(ops, desiredRefs) {
+  emitOrderedTabMoves(ops, desiredRefs, "movePopupTab");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildAutoLayout,
+  didItemRefsChange,
+  emitLayoutOp,
+  emitMoveOps,
+  emitMovePopupTabOps,
+  emitMoveTabOps,
+  omitLayoutProps
+});

package/dist/server/flow-surfaces/apply/matching.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 { FlowSurfaceApplySpec, FlowSurfaceNodeSpec } from '../types';
+export declare function normalizeChildren(input: any): FlowSurfaceNodeSpec[];
+export declare function hasExplicitSubModelKey(node: Pick<FlowSurfaceNodeSpec, 'subModels'> | FlowSurfaceApplySpec, key: string): any;
+export declare function matchesObjectChild(currentChild: any, desiredChild: FlowSurfaceNodeSpec): boolean;
+export declare function planArrayChildMatches(currentChildren: FlowSurfaceNodeSpec[], desiredChildren: FlowSurfaceNodeSpec[], parentUse: string, subKey: string): {
+    matchesByDesiredIndex: Map<number, FlowSurfaceNodeSpec>;
+    matchedCurrentUids: Set<string>;
+};

package/dist/server/flow-surfaces/apply/matching.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 matching_exports = {};
+__export(matching_exports, {
+  hasExplicitSubModelKey: () => hasExplicitSubModelKey,
+  matchesObjectChild: () => matchesObjectChild,
+  normalizeChildren: () => normalizeChildren,
+  planArrayChildMatches: () => planArrayChildMatches
+});
+module.exports = __toCommonJS(matching_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_errors = require("../errors");
+function normalizeChildren(input) {
+  if (!input) {
+    return [];
+  }
+  return import_lodash.default.castArray(input).filter(Boolean);
+}
+function hasExplicitSubModelKey(node, key) {
+  return !!(node == null ? void 0 : node.subModels) && Object.prototype.hasOwnProperty.call(node.subModels, key);
+}
+function matchesObjectChild(currentChild, desiredChild) {
+  return currentChild.uid === desiredChild.uid || !desiredChild.uid && currentChild.use === desiredChild.use;
+}
+function planArrayChildMatches(currentChildren, desiredChildren, parentUse, subKey) {
+  const matchesByDesiredIndex = /* @__PURE__ */ new Map();
+  const matchedCurrentUids = /* @__PURE__ */ new Set();
+  const remainingDesiredByUse = /* @__PURE__ */ new Map();
+  for (const [desiredIndex, desiredChild] of desiredChildren.entries()) {
+    const matchedCurrent = findExactArrayChildMatch(currentChildren, desiredChild, matchedCurrentUids);
+    if (matchedCurrent) {
+      matchesByDesiredIndex.set(desiredIndex, matchedCurrent);
+      if (matchedCurrent.uid) {
+        matchedCurrentUids.add(matchedCurrent.uid);
+      }
+      continue;
+    }
+    if ((desiredChild == null ? void 0 : desiredChild.use) && !desiredChild.uid) {
+      const desiredIndexes = remainingDesiredByUse.get(desiredChild.use) || [];
+      desiredIndexes.push(desiredIndex);
+      remainingDesiredByUse.set(desiredChild.use, desiredIndexes);
+    }
+  }
+  const remainingCurrentByUse = /* @__PURE__ */ new Map();
+  for (const currentChild of currentChildren) {
+    if (!(currentChild == null ? void 0 : currentChild.use) || matchedCurrentUids.has(currentChild.uid || "")) {
+      continue;
+    }
+    const currentGroup = remainingCurrentByUse.get(currentChild.use) || [];
+    currentGroup.push(currentChild);
+    remainingCurrentByUse.set(currentChild.use, currentGroup);
+  }
+  const uses = /* @__PURE__ */ new Set([...remainingCurrentByUse.keys(), ...remainingDesiredByUse.keys()]);
+  for (const use of uses) {
+    const currentGroup = remainingCurrentByUse.get(use) || [];
+    const desiredIndexes = remainingDesiredByUse.get(use) || [];
+    const shouldReuseByOrder = currentGroup.length > 1 || desiredIndexes.length > 1;
+    if (currentGroup.length > 0 && desiredIndexes.length > 0 && currentGroup.length !== desiredIndexes.length && shouldReuseByOrder) {
+      throw new import_errors.FlowSurfaceBadRequestError(
+        `flowSurfaces apply cannot safely match duplicate '${use}' nodes under '${parentUse}.${subKey}' without explicit uid or signature`
+      );
+    }
+    if (!shouldReuseByOrder) {
+      continue;
+    }
+    const reuseCount = Math.min(currentGroup.length, desiredIndexes.length);
+    for (let index = 0; index < reuseCount; index += 1) {
+      const currentChild = currentGroup[index];
+      const desiredIndex = desiredIndexes[index];
+      matchesByDesiredIndex.set(desiredIndex, currentChild);
+      if (currentChild == null ? void 0 : currentChild.uid) {
+        matchedCurrentUids.add(currentChild.uid);
+      }
+    }
+  }
+  return {
+    matchesByDesiredIndex,
+    matchedCurrentUids
+  };
+}
+function findExactArrayChildMatch(currentChildren, desiredChild, matchedCurrent) {
+  if (desiredChild.uid) {
+    return currentChildren.find((item) => (item == null ? void 0 : item.uid) === desiredChild.uid);
+  }
+  const desiredStrongSignature = getStrongNodeSignature(desiredChild);
+  if (desiredStrongSignature) {
+    return currentChildren.find(
+      (item) => !matchedCurrent.has(item.uid || "") && getStrongNodeSignature(item) === desiredStrongSignature
+    );
+  }
+  const desiredWeakSignature = getWeakNodeSignature(desiredChild);
+  if (desiredWeakSignature) {
+    return currentChildren.find(
+      (item) => !matchedCurrent.has(item.uid || "") && getWeakNodeSignature(item) === desiredWeakSignature
+    );
+  }
+  return void 0;
+}
+function getStrongNodeSignature(node) {
+  if (!(node == null ? void 0 : node.use)) {
+    return null;
+  }
+  const resourceInit = import_lodash.default.get(node, ["stepParams", "resourceSettings", "init"]);
+  if ((resourceInit == null ? void 0 : resourceInit.dataSourceKey) || (resourceInit == null ? void 0 : resourceInit.collectionName) || (resourceInit == null ? void 0 : resourceInit.associationName) || (resourceInit == null ? void 0 : resourceInit.associationPathName) || !import_lodash.default.isUndefined(resourceInit == null ? void 0 : resourceInit.sourceId)) {
+    return [
+      "resource",
+      node.use,
+      resourceInit.dataSourceKey || "",
+      resourceInit.collectionName || "",
+      resourceInit.associationName || "",
+      resourceInit.associationPathName || "",
+      import_lodash.default.isUndefined(resourceInit.sourceId) ? "" : String(resourceInit.sourceId)
+    ].join(":");
+  }
+  const fieldInit = import_lodash.default.get(node, ["stepParams", "fieldSettings", "init"]) || import_lodash.default.get(node, ["subModels", "field", "stepParams", "fieldSettings", "init"]);
+  if (fieldInit == null ? void 0 : fieldInit.fieldPath) {
+    return [
+      "field",
+      node.use,
+      fieldInit.dataSourceKey || "",
+      fieldInit.collectionName || "",
+      fieldInit.associationPathName || "",
+      fieldInit.fieldPath
+    ].join(":");
+  }
+  if (node.use === "TableActionsColumnModel") {
+    return "slot:table-actions-column";
+  }
+  return null;
+}
+function getWeakNodeSignature(node) {
+  if (!(node == null ? void 0 : node.use)) {
+    return null;
+  }
+  const title = import_lodash.default.get(node, ["stepParams", "pageTabSettings", "tab", "title"]) || import_lodash.default.get(node, ["stepParams", "buttonSettings", "general", "title"]) || import_lodash.default.get(node, ["props", "title"]);
+  if (typeof title === "string" && title.trim()) {
+    return ["title", node.use, title.trim()].join(":");
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasExplicitSubModelKey,
+  matchesObjectChild,
+  normalizeChildren,
+  planArrayChildMatches
+});

package/dist/server/flow-surfaces/association-title-field.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 type FlowSurfaceResolvedAssociationTitleField = {
+    field: any;
+    fieldName: string;
+    source: 'explicit' | 'firstTitleable';
+    targetCollection?: 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 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;

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

@@ -0,0 +1,158 @@
+/**
+ * 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 association_title_field_exports = {};
+__export(association_title_field_exports, {
+  assertCollectionTitleFieldExists: () => assertCollectionTitleFieldExists,
+  getExplicitCollectionTitleFieldName: () => getExplicitCollectionTitleFieldName,
+  isTitleableCollectionField: () => isTitleableCollectionField,
+  resolveAssociationSafeTitleField: () => resolveAssociationSafeTitleField,
+  resolveAssociationTitleFieldTargetCollection: () => resolveAssociationTitleFieldTargetCollection,
+  resolveCollectionSafeTitleField: () => resolveCollectionSafeTitleField
+});
+module.exports = __toCommonJS(association_title_field_exports);
+var import_errors = require("./errors");
+var import_service_helpers = require("./service-helpers");
+const FALLBACK_TITLE_USABLE_INTERFACES = /* @__PURE__ */ new Set([
+  "attachmentURL",
+  "createdAt",
+  "date",
+  "datetime",
+  "datetimeNoTz",
+  "email",
+  "formula",
+  "id",
+  "input",
+  "integer",
+  "nanoid",
+  "number",
+  "percent",
+  "phone",
+  "radioGroup",
+  "select",
+  "sequence",
+  "snowflakeId",
+  "sort",
+  "space",
+  "textarea",
+  "time",
+  "unixTimestamp",
+  "updatedAt",
+  "url",
+  "uuid",
+  "vditor"
+]);
+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);
+  if (typeof configured === "boolean") {
+    return configured;
+  }
+  const interfaceOptions = typeof (field == null ? void 0 : field.getInterfaceOptions) === "function" ? field.getInterfaceOptions() : void 0;
+  if (typeof (interfaceOptions == null ? void 0 : interfaceOptions.titleUsable) === "boolean") {
+    return interfaceOptions.titleUsable;
+  }
+  const interfaceName = typeof (field == null ? void 0 : field.interface) === "string" ? field.interface : typeof ((_c = field == null ? void 0 : field.options) == null ? void 0 : _c.interface) === "string" ? field.options.interface : void 0;
+  const interfaceCtor = ((_f = (_e = (_d = field == null ? void 0 : field.collection) == null ? void 0 : _d.collectionManager) == null ? void 0 : _e.getFieldInterface) == null ? void 0 : _f.call(_e, interfaceName)) || ((_j = (_i = (_h = (_g = field == null ? void 0 : field.collection) == null ? void 0 : _g.db) == null ? void 0 : _h.interfaceManager) == null ? void 0 : _i.getInterfaceType) == null ? void 0 : _j.call(_i, interfaceName));
+  if (interfaceCtor) {
+    const interfaceInstance = typeof interfaceCtor === "function" ? new interfaceCtor(void 0) : interfaceCtor;
+    if (typeof (interfaceInstance == null ? void 0 : interfaceInstance.titleUsable) === "boolean") {
+      return interfaceInstance.titleUsable;
+    }
+  }
+  return !!(interfaceName && FALLBACK_TITLE_USABLE_INTERFACES.has(interfaceName));
+}
+function getExplicitCollectionTitleFieldName(collection) {
+  var _a;
+  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 assertCollectionTitleFieldExists(collection, fieldName) {
+  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");
+  }
+  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`
+    );
+  }
+  return field;
+}
+function resolveCollectionSafeTitleField(collection) {
+  if (!collection) {
+    return null;
+  }
+  const explicitTitleField = getExplicitCollectionTitleFieldName(collection);
+  if (explicitTitleField) {
+    const field = assertCollectionTitleFieldExists(collection, explicitTitleField);
+    return {
+      field,
+      fieldName: (0, import_service_helpers.getFieldName)(field) || explicitTitleField,
+      source: "explicit",
+      targetCollection: collection
+    };
+  }
+  const firstTitleableField = (0, import_service_helpers.getCollectionFields)(collection).find(
+    (field) => !!(0, import_service_helpers.getFieldName)(field) && isTitleableCollectionField(field)
+  );
+  if (!firstTitleableField) {
+    return null;
+  }
+  return {
+    field: firstTitleableField,
+    fieldName: (0, import_service_helpers.getFieldName)(firstTitleableField),
+    source: "firstTitleable",
+    targetCollection: collection
+  };
+}
+function resolveAssociationTitleFieldTargetCollection(field, dataSourceKey, getCollection) {
+  return (0, import_service_helpers.resolveFieldTargetCollection)(field, dataSourceKey, getCollection) || null;
+}
+function resolveAssociationSafeTitleField(field, dataSourceKey, getCollection) {
+  const targetCollection = resolveAssociationTitleFieldTargetCollection(field, dataSourceKey, getCollection);
+  if (!targetCollection) {
+    return null;
+  }
+  const resolved = resolveCollectionSafeTitleField(targetCollection);
+  if (!resolved) {
+    return null;
+  }
+  return {
+    ...resolved,
+    targetCollection
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertCollectionTitleFieldExists,
+  getExplicitCollectionTitleFieldName,
+  isTitleableCollectionField,
+  resolveAssociationSafeTitleField,
+  resolveAssociationTitleFieldTargetCollection,
+  resolveCollectionSafeTitleField
+});

package/dist/server/flow-surfaces/blueprint/compile-blocks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 _ from 'lodash';
+import type { FlowSurfaceApplyBlueprintDocument, FlowSurfaceApplyBlueprintLayout, FlowSurfaceApplyBlueprintTabDocument } from './public-types';
+export declare function collectReferencedBlockKeys(layout: FlowSurfaceApplyBlueprintLayout | undefined, context: string): Set<string>;
+export declare function compileTabComposeValues(tab: FlowSurfaceApplyBlueprintTabDocument, document: FlowSurfaceApplyBlueprintDocument, tabIndex: number, options: {
+    mode: 'append' | 'replace';
+}): _.Dictionary<any>;