@nocobase/plugin-flow-engine 2.1.0-alpha.13 → 2.1.0-alpha.14

package/dist/server/flow-surfaces/support-matrix.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 FormalFlowSurfaceBlockKey = 'js-block' | 'table' | 'create-form' | 'edit-form' | 'details' | 'filter-form' | 'list' | 'grid-card' | 'markdown' | 'iframe' | 'map' | 'chart' | 'comments' | 'action-panel';
+export type FlowSurfaceBlockSupportEntry = {
+    key: string;
+    formalKey?: FormalFlowSurfaceBlockKey;
+    label: string;
+    modelUse: string;
+    ownerPlugin: string;
+    topLevelAddable: boolean;
+    formalBuiltin: boolean;
+    fixtureCaptured: boolean;
+    readbackSupported: boolean;
+    createSupported: boolean;
+};
+export declare const FLOW_SURFACE_BLOCK_SUPPORT_MATRIX: FlowSurfaceBlockSupportEntry[];
+export declare const FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX: FlowSurfaceBlockSupportEntry[];
+export declare const FORMAL_FLOW_SURFACE_BLOCK_KEYS: FormalFlowSurfaceBlockKey[];
+export declare const FLOW_SURFACE_BLOCK_SUPPORT_BY_KEY: Map<string, FlowSurfaceBlockSupportEntry>;
+export declare const FLOW_SURFACE_BLOCK_SUPPORT_BY_USE: Map<string, FlowSurfaceBlockSupportEntry>;
+export declare const FLOW_SURFACE_SERVICE_KEY_TO_FORMAL_KEY: Map<string, FormalFlowSurfaceBlockKey>;
+export declare const FLOW_SURFACE_FORMAL_KEY_TO_SERVICE_KEY: Map<FormalFlowSurfaceBlockKey, string>;

package/dist/server/flow-surfaces/support-matrix.js

@@ -0,0 +1,246 @@
+/**
+ * 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 support_matrix_exports = {};
+__export(support_matrix_exports, {
+  FLOW_SURFACE_BLOCK_SUPPORT_BY_KEY: () => FLOW_SURFACE_BLOCK_SUPPORT_BY_KEY,
+  FLOW_SURFACE_BLOCK_SUPPORT_BY_USE: () => FLOW_SURFACE_BLOCK_SUPPORT_BY_USE,
+  FLOW_SURFACE_BLOCK_SUPPORT_MATRIX: () => FLOW_SURFACE_BLOCK_SUPPORT_MATRIX,
+  FLOW_SURFACE_FORMAL_KEY_TO_SERVICE_KEY: () => FLOW_SURFACE_FORMAL_KEY_TO_SERVICE_KEY,
+  FLOW_SURFACE_SERVICE_KEY_TO_FORMAL_KEY: () => FLOW_SURFACE_SERVICE_KEY_TO_FORMAL_KEY,
+  FORMAL_FLOW_SURFACE_BLOCK_KEYS: () => FORMAL_FLOW_SURFACE_BLOCK_KEYS,
+  FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX: () => FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX
+});
+module.exports = __toCommonJS(support_matrix_exports);
+const FLOW_SURFACE_BLOCK_SUPPORT_MATRIX = [
+  {
+    key: "jsBlock",
+    formalKey: "js-block",
+    label: "JS block",
+    modelUse: "JSBlockModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "table",
+    formalKey: "table",
+    label: "Table",
+    modelUse: "TableBlockModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "createForm",
+    formalKey: "create-form",
+    label: "Form (Add new)",
+    modelUse: "CreateFormModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "editForm",
+    formalKey: "edit-form",
+    label: "Form (Edit)",
+    modelUse: "EditFormModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "form",
+    label: "Form",
+    modelUse: "FormBlockModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: false,
+    formalBuiltin: false,
+    fixtureCaptured: false,
+    readbackSupported: true,
+    createSupported: false
+  },
+  {
+    key: "details",
+    formalKey: "details",
+    label: "Details",
+    modelUse: "DetailsBlockModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "filterForm",
+    formalKey: "filter-form",
+    label: "Filter form",
+    modelUse: "FilterFormBlockModel",
+    ownerPlugin: "@nocobase/core/client",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "list",
+    formalKey: "list",
+    label: "List",
+    modelUse: "ListBlockModel",
+    ownerPlugin: "@nocobase/plugin-block-list",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "gridCard",
+    formalKey: "grid-card",
+    label: "Grid card",
+    modelUse: "GridCardBlockModel",
+    ownerPlugin: "@nocobase/plugin-block-grid-card",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "markdown",
+    formalKey: "markdown",
+    label: "Markdown",
+    modelUse: "MarkdownBlockModel",
+    ownerPlugin: "@nocobase/plugin-block-markdown",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "iframe",
+    formalKey: "iframe",
+    label: "Iframe",
+    modelUse: "IframeBlockModel",
+    ownerPlugin: "@nocobase/plugin-block-iframe",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "map",
+    formalKey: "map",
+    label: "Map",
+    modelUse: "MapBlockModel",
+    ownerPlugin: "@nocobase/plugin-map",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: false
+  },
+  {
+    key: "chart",
+    formalKey: "chart",
+    label: "Chart",
+    modelUse: "ChartBlockModel",
+    ownerPlugin: "@nocobase/plugin-data-visualization",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  },
+  {
+    key: "comments",
+    formalKey: "comments",
+    label: "Comments",
+    modelUse: "CommentsBlockModel",
+    ownerPlugin: "@nocobase/plugin-comments",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: false
+  },
+  {
+    key: "actionPanel",
+    formalKey: "action-panel",
+    label: "Action panel",
+    modelUse: "ActionPanelBlockModel",
+    ownerPlugin: "@nocobase/plugin-block-workbench",
+    topLevelAddable: true,
+    formalBuiltin: true,
+    fixtureCaptured: true,
+    readbackSupported: true,
+    createSupported: true
+  }
+];
+const FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX = FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.filter(
+  (entry) => entry.formalBuiltin
+);
+const FORMAL_FLOW_SURFACE_BLOCK_KEYS = FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.map(
+  (entry) => entry.formalKey
+);
+const FLOW_SURFACE_BLOCK_SUPPORT_BY_KEY = new Map(
+  FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.map((entry) => [entry.key, entry])
+);
+const FLOW_SURFACE_BLOCK_SUPPORT_BY_USE = new Map(
+  FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.map((entry) => [entry.modelUse, entry])
+);
+const FLOW_SURFACE_SERVICE_KEY_TO_FORMAL_KEY = new Map(
+  FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.map((entry) => [entry.key, entry.formalKey])
+);
+const FLOW_SURFACE_FORMAL_KEY_TO_SERVICE_KEY = new Map(
+  FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX.map((entry) => [entry.formalKey, entry.key])
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FLOW_SURFACE_BLOCK_SUPPORT_BY_KEY,
+  FLOW_SURFACE_BLOCK_SUPPORT_BY_USE,
+  FLOW_SURFACE_BLOCK_SUPPORT_MATRIX,
+  FLOW_SURFACE_FORMAL_KEY_TO_SERVICE_KEY,
+  FLOW_SURFACE_SERVICE_KEY_TO_FORMAL_KEY,
+  FORMAL_FLOW_SURFACE_BLOCK_KEYS,
+  FORMAL_FLOW_SURFACE_BLOCK_SUPPORT_MATRIX
+});

package/dist/server/flow-surfaces/surface-context.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 FlowModelRepository from '../repository';
+import { SurfaceLocator } from './locator';
+import type { FlowSurfaceWriteTarget } from './types';
+export declare class FlowSurfaceContextResolver {
+    private readonly repository;
+    private readonly locator;
+    private readonly options;
+    constructor(repository: FlowModelRepository, locator: SurfaceLocator, options: {
+        hydrateRoute: (routeLike: any, transaction?: any) => Promise<any>;
+        ensureGridChild: (parentUid: string, use: string, transaction?: any) => Promise<string>;
+        ensurePopupSurface: (parentUid: string, transaction?: any) => Promise<any>;
+        getCollection: (dataSourceKey: string, collectionName: string) => any;
+    });
+    filterBlocksByTarget(targetNode?: any, resolved?: any): import("./types").FlowSurfaceCatalogItem[];
+    resolveFilterFormTarget(filterFormOwnerUid: string, targetBlockUid?: string, transaction?: any): Promise<{
+        ownerUid: any;
+        label: any;
+        resourceInit: any;
+    }>;
+    collectFilterFormTargets(uid: string, transaction?: any): Promise<{
+        ownerUid: any;
+        label: any;
+        resourceInit: any;
+    }[]>;
+    resolveBlockParent(target: FlowSurfaceWriteTarget, transaction?: any): any;
+    resolveFieldContainer(uid: string, transaction?: any): Promise<{
+        ownerUid: any;
+        ownerUse: any;
+        parentUid: any;
+        subKey: string;
+        subType: string;
+        wrapperUse: string;
+    }>;
+    resolveActionContainer(target: FlowSurfaceWriteTarget, transaction?: any): Promise<{
+        parentUid: any;
+        subKey: string;
+        subType: string;
+        ownerUid: any;
+        ownerUse: any;
+    }>;
+    resolveGridNode(uid: string, transaction?: any): Promise<any>;
+    findOwningBlockGrid(uid: string, transaction?: any): Promise<any>;
+}

package/dist/server/flow-surfaces/surface-context.js

@@ -0,0 +1,356 @@
+/**
+ * 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 surface_context_exports = {};
+__export(surface_context_exports, {
+  FlowSurfaceContextResolver: () => FlowSurfaceContextResolver
+});
+module.exports = __toCommonJS(surface_context_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_catalog = require("./catalog");
+var import_chart_config = require("./chart-config");
+var import_errors = require("./errors");
+var import_placement = require("./placement");
+const FILTER_TARGET_BLOCK_USES = /* @__PURE__ */ new Set([
+  "TableBlockModel",
+  "DetailsBlockModel",
+  "ListBlockModel",
+  "GridCardBlockModel",
+  "ChartBlockModel",
+  "MapBlockModel",
+  "CommentsBlockModel"
+]);
+const LIST_LIKE_BLOCK_USES = /* @__PURE__ */ new Set(["ListBlockModel", "GridCardBlockModel"]);
+const LIST_LIKE_ITEM_USES = /* @__PURE__ */ new Set(["ListItemModel", "GridCardItemModel"]);
+class FlowSurfaceContextResolver {
+  constructor(repository, locator, options) {
+    this.repository = repository;
+    this.locator = locator;
+    this.options = options;
+  }
+  filterBlocksByTarget(targetNode, resolved) {
+    if (!targetNode && !resolved) {
+      return import_catalog.blockCatalog;
+    }
+    if ((0, import_placement.canCatalogAddBlock)({ node: targetNode, resolved })) {
+      return import_catalog.blockCatalog;
+    }
+    return [];
+  }
+  async resolveFilterFormTarget(filterFormOwnerUid, targetBlockUid, transaction) {
+    const targets = await this.collectFilterFormTargets(filterFormOwnerUid, transaction);
+    if (!targets.length) {
+      (0, import_errors.throwBadRequest)("flowSurfaces addField cannot find filter targets on the current surface");
+    }
+    if (targetBlockUid) {
+      const matched = targets.find((item) => item.ownerUid === targetBlockUid);
+      if (!matched) {
+        (0, import_errors.throwBadRequest)(
+          `flowSurfaces addField filter target '${targetBlockUid}' is not available on the current surface`
+        );
+      }
+      return matched;
+    }
+    if (targets.length > 1) {
+      (0, import_errors.throwBadRequest)(
+        "flowSurfaces addField on filter-form requires defaultTargetUid when multiple target blocks are available"
+      );
+    }
+    return targets[0];
+  }
+  async collectFilterFormTargets(uid, transaction) {
+    var _a;
+    const blockGrid = await this.findOwningBlockGrid(uid, transaction);
+    if (!(blockGrid == null ? void 0 : blockGrid.uid)) {
+      return [];
+    }
+    return import_lodash.default.castArray(((_a = blockGrid.subModels) == null ? void 0 : _a.items) || []).filter((item) => FILTER_TARGET_BLOCK_USES.has(item == null ? void 0 : item.use) && (item == null ? void 0 : item.uid)).map((item) => {
+      var _a2, _b;
+      const resourceInit = import_lodash.default.get(item, ["stepParams", "resourceSettings", "init"]) || ((item == null ? void 0 : item.use) === "ChartBlockModel" ? (0, import_chart_config.getChartBuilderResourceInit)(import_lodash.default.get(item, ["stepParams", "chartSettings", "configure"])) : null);
+      if (!(resourceInit == null ? void 0 : resourceInit.dataSourceKey) || !(resourceInit == null ? void 0 : resourceInit.collectionName)) {
+        return null;
+      }
+      const collection = this.options.getCollection(resourceInit.dataSourceKey, resourceInit.collectionName);
+      return {
+        ownerUid: item.uid,
+        label: import_lodash.default.get(item, ["stepParams", "cardSettings", "titleDescription", "title"]) || ((_a2 = item == null ? void 0 : item.decoratorProps) == null ? void 0 : _a2.title) || ((_b = item == null ? void 0 : item.props) == null ? void 0 : _b.title) || (collection == null ? void 0 : collection.title) || (collection == null ? void 0 : collection.name) || item.uid,
+        resourceInit
+      };
+    }).filter(Boolean);
+  }
+  async resolveBlockParent(target, transaction) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+    const resolved = await this.locator.resolve(target, { transaction });
+    const node = resolved.node || await this.repository.findModelById(resolved.uid, { transaction, includeAsyncNode: true });
+    if ((_a = node == null ? void 0 : node.use) == null ? void 0 : _a.endsWith("GridModel")) {
+      return {
+        parentUid: node.uid,
+        subKey: "items",
+        subType: "array"
+      };
+    }
+    if ((node == null ? void 0 : node.use) === "ChildPageTabModel") {
+      return {
+        parentUid: ((_c = (_b = node == null ? void 0 : node.subModels) == null ? void 0 : _b.grid) == null ? void 0 : _c.uid) || await this.options.ensureGridChild(node.uid, "BlockGridModel", transaction),
+        subKey: "items",
+        subType: "array"
+      };
+    }
+    if ((node == null ? void 0 : node.use) === "ChildPageModel") {
+      const firstTab = import_lodash.default.castArray(((_d = node == null ? void 0 : node.subModels) == null ? void 0 : _d.tabs) || [])[0];
+      if (!(firstTab == null ? void 0 : firstTab.uid)) {
+        (0, import_errors.throwBadRequest)(`flowSurfaces addBlock target '${node.use}' is missing its popup tab subtree`);
+      }
+      return {
+        parentUid: ((_f = (_e = firstTab == null ? void 0 : firstTab.subModels) == null ? void 0 : _e.grid) == null ? void 0 : _f.uid) || await this.options.ensureGridChild(firstTab.uid, "BlockGridModel", transaction),
+        subKey: "items",
+        subType: "array"
+      };
+    }
+    if ((0, import_placement.isPopupHostUse)(node == null ? void 0 : node.use) || ((_h = (_g = node == null ? void 0 : node.subModels) == null ? void 0 : _g.page) == null ? void 0 : _h.use) === "ChildPageModel") {
+      const popupSurface = await this.options.ensurePopupSurface(node.uid, transaction);
+      return {
+        parentUid: popupSurface.gridUid,
+        subKey: "items",
+        subType: "array",
+        popupSurface
+      };
+    }
+    if ((0, import_placement.isTabsRouteType)(resolved.tabRoute) || (node == null ? void 0 : node.use) === "RouteModel" && (0, import_placement.isTabsRouteType)(resolved.route)) {
+      return {
+        parentUid: ((_j = (_i = node == null ? void 0 : node.subModels) == null ? void 0 : _i.grid) == null ? void 0 : _j.uid) || await this.options.ensureGridChild(
+          ((_l = (_k = resolved.tabRoute) == null ? void 0 : _k.get) == null ? void 0 : _l.call(_k, "schemaUid")) || node.uid,
+          "BlockGridModel",
+          transaction
+        ),
+        subKey: "items",
+        subType: "array"
+      };
+    }
+    if ((0, import_placement.isPageRouteType)(resolved.pageRoute)) {
+      const pageRoute = await this.options.hydrateRoute(resolved.pageRoute, transaction);
+      const firstTab = import_lodash.default.sortBy(
+        import_lodash.default.castArray(((_m = pageRoute == null ? void 0 : pageRoute.get) == null ? void 0 : _m.call(pageRoute, "children")) || (pageRoute == null ? void 0 : pageRoute.children) || []).map((item) => {
+          var _a2;
+          return ((_a2 = item == null ? void 0 : item.toJSON) == null ? void 0 : _a2.call(item)) || item;
+        }),
+        "sort"
+      )[0];
+      if (!(firstTab == null ? void 0 : firstTab.schemaUid)) {
+        (0, import_errors.throwBadRequest)("flowSurfaces addBlock requires a tab under page");
+      }
+      return this.resolveBlockParent({ uid: firstTab.schemaUid }, transaction);
+    }
+    (0, import_errors.throwBadRequest)(`flowSurfaces addBlock target '${(node == null ? void 0 : node.use) || resolved.uid}' is not a grid surface`);
+  }
+  async resolveFieldContainer(uid, transaction) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+    const target = await this.locator.resolve({ uid }, { transaction });
+    const node = target.node || await this.repository.findModelById(uid, { transaction, includeAsyncNode: true });
+    const use = node == null ? void 0 : node.use;
+    if ((0, import_placement.isFormBlockUse)(use)) {
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: ((_b = (_a = node.subModels) == null ? void 0 : _a.grid) == null ? void 0 : _b.uid) || await this.options.ensureGridChild(node.uid, "FormGridModel", transaction),
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "FormItemModel"
+      };
+    }
+    if (use === "FormGridModel") {
+      const parentUid = await this.locator.findParentUid(node.uid, transaction);
+      const parent = parentUid ? await this.repository.findModelById(parentUid, { transaction }) : null;
+      return {
+        ownerUid: (parent == null ? void 0 : parent.uid) || node.uid,
+        ownerUse: (parent == null ? void 0 : parent.use) || use,
+        parentUid: node.uid,
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "FormItemModel"
+      };
+    }
+    if ((0, import_placement.isDetailsBlockUse)(use)) {
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: ((_d = (_c = node.subModels) == null ? void 0 : _c.grid) == null ? void 0 : _d.uid) || await this.options.ensureGridChild(node.uid, "DetailsGridModel", transaction),
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "DetailsItemModel"
+      };
+    }
+    if (LIST_LIKE_BLOCK_USES.has(use)) {
+      const itemUid = (_f = (_e = node.subModels) == null ? void 0 : _e.item) == null ? void 0 : _f.uid;
+      if (!itemUid) {
+        (0, import_errors.throwBadRequest)(`flowSurfaces addField target '${use}' is missing its item subtree`);
+      }
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: ((_j = (_i = (_h = (_g = node.subModels) == null ? void 0 : _g.item) == null ? void 0 : _h.subModels) == null ? void 0 : _i.grid) == null ? void 0 : _j.uid) || await this.options.ensureGridChild(itemUid, "DetailsGridModel", transaction),
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "DetailsItemModel"
+      };
+    }
+    if (LIST_LIKE_ITEM_USES.has(use)) {
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: ((_l = (_k = node.subModels) == null ? void 0 : _k.grid) == null ? void 0 : _l.uid) || await this.options.ensureGridChild(node.uid, "DetailsGridModel", transaction),
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "DetailsItemModel"
+      };
+    }
+    if (use === "DetailsGridModel") {
+      const parentUid = await this.locator.findParentUid(node.uid, transaction);
+      const parent = parentUid ? await this.repository.findModelById(parentUid, { transaction }) : null;
+      return {
+        ownerUid: (parent == null ? void 0 : parent.uid) || node.uid,
+        ownerUse: (parent == null ? void 0 : parent.use) || use,
+        parentUid: node.uid,
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "DetailsItemModel"
+      };
+    }
+    if ((0, import_placement.isFilterFormBlockUse)(use)) {
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: ((_n = (_m = node.subModels) == null ? void 0 : _m.grid) == null ? void 0 : _n.uid) || await this.options.ensureGridChild(node.uid, "FilterFormGridModel", transaction),
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "FilterFormItemModel"
+      };
+    }
+    if (use === "FilterFormGridModel") {
+      const parentUid = await this.locator.findParentUid(node.uid, transaction);
+      const parent = parentUid ? await this.repository.findModelById(parentUid, { transaction }) : null;
+      return {
+        ownerUid: (parent == null ? void 0 : parent.uid) || node.uid,
+        ownerUse: (parent == null ? void 0 : parent.use) || use,
+        parentUid: node.uid,
+        subKey: "items",
+        subType: "array",
+        wrapperUse: "FilterFormItemModel"
+      };
+    }
+    if (use === "TableBlockModel") {
+      return {
+        ownerUid: node.uid,
+        ownerUse: use,
+        parentUid: node.uid,
+        subKey: "columns",
+        subType: "array",
+        wrapperUse: "TableColumnModel"
+      };
+    }
+    (0, import_errors.throwBadRequest)(`flowSurfaces addField target '${use || uid}' is not a field container`);
+  }
+  async resolveActionContainer(target, transaction) {
+    var _a;
+    const resolved = await this.locator.resolve(target, { transaction });
+    const node = resolved.node || await this.repository.findModelById(resolved.uid, { transaction, includeAsyncNode: true });
+    if (["TableBlockModel", "TableActionsColumnModel"].includes(node == null ? void 0 : node.use) || (node == null ? void 0 : node.use) === "ActionPanelBlockModel" || LIST_LIKE_BLOCK_USES.has(node == null ? void 0 : node.use) || LIST_LIKE_ITEM_USES.has(node == null ? void 0 : node.use)) {
+      return {
+        parentUid: node.uid,
+        subKey: "actions",
+        subType: "array",
+        ownerUid: node.uid,
+        ownerUse: node.use
+      };
+    }
+    if ((0, import_placement.isFormBlockUse)(node == null ? void 0 : node.use) || (0, import_placement.isDetailsBlockUse)(node == null ? void 0 : node.use) || (0, import_placement.isFilterFormBlockUse)(node == null ? void 0 : node.use)) {
+      return {
+        parentUid: node.uid,
+        subKey: "actions",
+        subType: "array",
+        ownerUid: node.uid,
+        ownerUse: node.use
+      };
+    }
+    if ((_a = node == null ? void 0 : node.subModels) == null ? void 0 : _a.actions) {
+      return {
+        parentUid: node.uid,
+        subKey: "actions",
+        subType: "array",
+        ownerUid: node.uid,
+        ownerUse: node.use
+      };
+    }
+    (0, import_errors.throwBadRequest)(`flowSurfaces addAction target '${(node == null ? void 0 : node.use) || resolved.uid}' is not an action container`);
+  }
+  async resolveGridNode(uid, transaction) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    const resolved = await this.locator.resolve({ uid }, { transaction });
+    const node = resolved.node || await this.repository.findModelById(uid, { transaction, includeAsyncNode: true });
+    if ((_a = node == null ? void 0 : node.use) == null ? void 0 : _a.endsWith("GridModel")) {
+      return node;
+    }
+    if ((((_c = (_b = resolved.tabRoute) == null ? void 0 : _b.get) == null ? void 0 : _c.call(_b, "type")) === "tabs" || ((_e = (_d = resolved.route) == null ? void 0 : _d.get) == null ? void 0 : _e.call(_d, "type")) === "tabs") && (node == null ? void 0 : node.use) === "RouteModel") {
+      return this.repository.findModelById(
+        ((_g = (_f = node == null ? void 0 : node.subModels) == null ? void 0 : _f.grid) == null ? void 0 : _g.uid) || await this.options.ensureGridChild(
+          ((_i = (_h = resolved.tabRoute) == null ? void 0 : _h.get) == null ? void 0 : _i.call(_h, "schemaUid")) || node.uid,
+          "BlockGridModel",
+          transaction
+        ),
+        { transaction, includeAsyncNode: true }
+      );
+    }
+    if ((_k = (_j = node == null ? void 0 : node.subModels) == null ? void 0 : _j.grid) == null ? void 0 : _k.uid) {
+      return this.repository.findModelById(node.subModels.grid.uid, { transaction, includeAsyncNode: true });
+    }
+    (0, import_errors.throwBadRequest)(`flowSurfaces setLayout target '${uid}' is not a grid node`);
+  }
+  async findOwningBlockGrid(uid, transaction) {
+    let cursor = uid;
+    while (cursor) {
+      const node = await this.repository.findModelById(cursor, { transaction, includeAsyncNode: true });
+      if ((node == null ? void 0 : node.use) === "BlockGridModel") {
+        return node;
+      }
+      cursor = await this.locator.findParentUid(cursor, transaction);
+    }
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlowSurfaceContextResolver
+});