@nocobase/plugin-flow-engine 2.1.0-alpha.10 → 2.1.0-alpha.11

package/dist/server/flow-schema-contributions/shared.js

@@ -0,0 +1,1649 @@
+/**
+ * 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 shared_exports = {};
+__export(shared_exports, {
+  aclCheckRefreshParamsSchema: () => aclCheckRefreshParamsSchema,
+  actionButtonGeneralStepParamsSchema: () => actionButtonGeneralStepParamsSchema,
+  actionButtonSettingsStepParamsSchema: () => actionButtonSettingsStepParamsSchema,
+  assignFormItemStepParamsSchema: () => assignFormItemStepParamsSchema,
+  childPageSettingsStepParamsSchema: () => childPageSettingsStepParamsSchema,
+  collectionActionUses: () => collectionActionUses,
+  collectionResourceInitSchema: () => collectionResourceInitSchema,
+  collectionResourceSettingsStepParamsSchema: () => collectionResourceSettingsStepParamsSchema,
+  confirmStepParamsSchema: () => confirmStepParamsSchema,
+  coreBlockGridItemUses: () => coreBlockGridItemUses,
+  createActionStepParamsSchema: () => createActionStepParamsSchema,
+  createAssociatedCollectionPattern: () => createAssociatedCollectionPattern,
+  createCollectionResourceInit: () => createCollectionResourceInit,
+  createCollectionResourceStepParams: () => createCollectionResourceStepParams,
+  createCurrentRecordCollectionPattern: () => createCurrentRecordCollectionPattern,
+  createFieldBoundStepParamsSchema: () => createFieldBoundStepParamsSchema,
+  createFieldModelSchemaContribution: () => createFieldModelSchemaContribution,
+  createFieldModelSkeleton: () => createFieldModelSkeleton,
+  createFieldModelStepParamsSchema: () => createFieldModelStepParamsSchema,
+  createFormBlockCommonPatterns: () => createFormBlockCommonPatterns,
+  createFormBlockDynamicHints: () => createFormBlockDynamicHints,
+  createFormBlockMinimalExample: () => createFormBlockMinimalExample,
+  createFormBlockSkeleton: () => createFormBlockSkeleton,
+  createFormBlockSubModelSlots: () => createFormBlockSubModelSlots,
+  createFormGridDynamicHints: () => createFormGridDynamicHints,
+  createGridLayoutDocs: () => createGridLayoutDocs,
+  createGridLayoutStepParamsSchema: () => createGridLayoutStepParamsSchema,
+  createPopupActionExample: () => createPopupActionExample,
+  createPopupActionOpenViewParams: () => createPopupActionOpenViewParams,
+  createPopupActionPattern: () => createPopupActionPattern,
+  createPopupActionStepParams: () => createPopupActionStepParams,
+  createPopupBlockGrid: () => createPopupBlockGrid,
+  createPopupChildPageTree: () => createPopupChildPageTree,
+  createPopupPageSlotSchema: () => createPopupPageSlotSchema,
+  createRuntimeFieldDynamicHint: () => createRuntimeFieldDynamicHint,
+  createRuntimeFieldModelSlotSchema: () => createRuntimeFieldModelSlotSchema,
+  dataScopeParamsSchema: () => dataScopeParamsSchema,
+  defaultValueStepParamsSchema: () => defaultValueStepParamsSchema,
+  deleteActionSettingsStepParamsSchema: () => deleteActionSettingsStepParamsSchema,
+  descriptionStepParamsSchema: () => descriptionStepParamsSchema,
+  detailItemStepParamsSchema: () => detailItemStepParamsSchema,
+  detailsGridItemUses: () => detailsGridItemUses,
+  emptyObjectSchema: () => emptyObjectSchema,
+  expandCollapseActionSettingsStepParamsSchema: () => expandCollapseActionSettingsStepParamsSchema,
+  fieldBindingInitSchema: () => fieldBindingInitSchema,
+  filterActionSettingsStepParamsSchema: () => filterActionSettingsStepParamsSchema,
+  filterFieldMetadataSchema: () => filterFieldMetadataSchema,
+  filterFormActionUses: () => filterFormActionUses,
+  filterFormCollapseSettingsStepParamsSchema: () => filterFormCollapseSettingsStepParamsSchema,
+  filterFormGridItemUses: () => filterFormGridItemUses,
+  filterFormItemInitStepParamsSchema: () => filterFormItemInitStepParamsSchema,
+  filterFormItemStepParamsSchema: () => filterFormItemStepParamsSchema,
+  formBlockActionUses: () => formBlockActionUses,
+  formBlockAntiPatterns: () => formBlockAntiPatterns,
+  formBlockBaseStepParamsSchema: () => formBlockBaseStepParamsSchema,
+  formGridItemUses: () => formGridItemUses,
+  formItemStepParamsSchema: () => formItemStepParamsSchema,
+  formSubmitSettingsStepParamsSchema: () => formSubmitSettingsStepParamsSchema,
+  genericFilterSchema: () => genericFilterSchema,
+  genericModelNodeSchema: () => genericModelNodeSchema,
+  gridRowOrderSchema: () => gridRowOrderSchema,
+  gridRowsSchema: () => gridRowsSchema,
+  gridSizesSchema: () => gridSizesSchema,
+  labelStepParamsSchema: () => labelStepParamsSchema,
+  layoutParamsSchema: () => layoutParamsSchema,
+  linkActionSettingsStepParamsSchema: () => linkActionSettingsStepParamsSchema,
+  linkageRuleValueSchema: () => linkageRuleValueSchema,
+  linkageRulesRefreshParamsSchema: () => linkageRulesRefreshParamsSchema,
+  openViewParamsSchema: () => openViewParamsSchema,
+  pageTabSettingsStepParamsSchema: () => pageTabSettingsStepParamsSchema,
+  pageTabUses: () => pageTabUses,
+  popupActionAntiPatterns: () => popupActionAntiPatterns,
+  popupActionSettingsStepParamsSchema: () => popupActionSettingsStepParamsSchema,
+  publicBlockRootUses: () => publicBlockRootUses,
+  recordActionUses: () => recordActionUses,
+  refreshActionSettingsStepParamsSchema: () => refreshActionSettingsStepParamsSchema,
+  runJsActionSettingsStepParamsSchema: () => runJsActionSettingsStepParamsSchema,
+  showLabelStepParamsSchema: () => showLabelStepParamsSchema,
+  sortingRuleParamsSchema: () => sortingRuleParamsSchema,
+  tableColumnEditableStepParamsSchema: () => tableColumnEditableStepParamsSchema,
+  tableColumnSorterStepParamsSchema: () => tableColumnSorterStepParamsSchema,
+  tableColumnStepParamsSchema: () => tableColumnStepParamsSchema,
+  tableColumnUses: () => tableColumnUses,
+  tableColumnWidthStepParamsSchema: () => tableColumnWidthStepParamsSchema,
+  tooltipStepParamsSchema: () => tooltipStepParamsSchema
+});
+module.exports = __toCommonJS(shared_exports);
+const genericFilterSchemaId = "urn:nocobase:schema:plugin-flow-engine:generic-filter";
+const genericFilterSchema = {
+  $id: genericFilterSchemaId,
+  definitions: {
+    filterCondition: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string"
+        },
+        operator: {
+          type: "string"
+        },
+        value: {},
+        noValue: {
+          type: "boolean"
+        }
+      },
+      required: ["path"],
+      additionalProperties: true,
+      allOf: [
+        {
+          not: {
+            required: ["logic"]
+          }
+        },
+        {
+          not: {
+            required: ["items"]
+          }
+        }
+      ]
+    },
+    filterGroup: {
+      type: "object",
+      properties: {
+        logic: {
+          type: "string",
+          enum: ["$and", "$or"]
+        },
+        items: {
+          type: "array",
+          items: {
+            oneOf: [
+              { $ref: `${genericFilterSchemaId}#/definitions/filterCondition` },
+              { $ref: `${genericFilterSchemaId}#/definitions/filterGroup` }
+            ]
+          }
+        }
+      },
+      required: ["logic", "items"],
+      additionalProperties: true,
+      allOf: [
+        {
+          not: {
+            required: ["path"]
+          }
+        },
+        {
+          not: {
+            required: ["operator"]
+          }
+        },
+        {
+          not: {
+            required: ["value"]
+          }
+        },
+        {
+          not: {
+            required: ["noValue"]
+          }
+        }
+      ]
+    }
+  },
+  type: "object",
+  properties: {
+    logic: {
+      type: "string",
+      enum: ["$and", "$or"]
+    },
+    items: {
+      type: "array",
+      items: {
+        oneOf: [
+          { $ref: `${genericFilterSchemaId}#/definitions/filterCondition` },
+          { $ref: `${genericFilterSchemaId}#/definitions/filterGroup` }
+        ]
+      }
+    }
+  },
+  required: ["logic", "items"],
+  additionalProperties: true,
+  allOf: [
+    {
+      not: {
+        required: ["path"]
+      }
+    },
+    {
+      not: {
+        required: ["operator"]
+      }
+    },
+    {
+      not: {
+        required: ["value"]
+      }
+    },
+    {
+      not: {
+        required: ["noValue"]
+      }
+    }
+  ]
+};
+const genericModelNodeSchema = {
+  type: "object",
+  required: ["uid", "use"],
+  properties: {
+    uid: { type: "string" },
+    use: { type: "string" }
+  },
+  additionalProperties: true
+};
+const emptyObjectSchema = {
+  type: "object",
+  additionalProperties: false
+};
+const linkageRuleValueSchema = {
+  type: "object",
+  properties: {
+    value: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: true
+      }
+    }
+  },
+  additionalProperties: false
+};
+const layoutParamsSchema = {
+  type: "object",
+  properties: {
+    layout: {
+      type: "string",
+      enum: ["vertical", "horizontal"]
+    },
+    labelAlign: {
+      type: "string",
+      enum: ["left", "right"]
+    },
+    labelWidth: {
+      type: ["number", "string", "null"]
+    },
+    labelWrap: {
+      type: "boolean"
+    },
+    colon: {
+      type: "boolean"
+    }
+  },
+  required: ["layout"],
+  additionalProperties: false
+};
+const dataScopeParamsSchema = {
+  type: "object",
+  properties: {
+    filter: genericFilterSchema
+  },
+  additionalProperties: false
+};
+const sortingRuleParamsSchema = {
+  type: "object",
+  properties: {
+    sort: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          field: { type: "string" },
+          direction: {
+            type: "string",
+            enum: ["asc", "desc"]
+          }
+        },
+        required: ["field", "direction"],
+        additionalProperties: false
+      }
+    }
+  },
+  additionalProperties: false
+};
+const aclCheckRefreshParamsSchema = {
+  type: "object",
+  properties: {
+    strategy: {
+      type: "string",
+      enum: ["default", "formItem"]
+    }
+  },
+  additionalProperties: false
+};
+const linkageRulesRefreshParamsSchema = {
+  type: "object",
+  properties: {
+    actionName: { type: "string" },
+    flowKey: { type: "string" },
+    stepKey: { type: "string" }
+  },
+  required: ["actionName", "flowKey"],
+  additionalProperties: false
+};
+const openViewParamsSchema = {
+  type: "object",
+  properties: {
+    uid: { type: "string" },
+    mode: {
+      type: "string",
+      enum: ["drawer", "dialog", "embed"]
+    },
+    size: {
+      type: "string",
+      enum: ["small", "medium", "large"]
+    },
+    pageModelClass: {
+      type: "string",
+      enum: ["ChildPageModel", "RootPageModel"]
+    },
+    filterByTk: { type: ["string", "number", "object"] },
+    sourceId: { type: ["string", "number"] },
+    dataSourceKey: { type: "string" },
+    collectionName: { type: "string" },
+    associationName: { type: "string" },
+    preventClose: { type: "boolean" },
+    navigation: { type: "boolean" },
+    tabUid: { type: "string" }
+  },
+  additionalProperties: true
+};
+const gridRowsSchema = {
+  type: "object",
+  description: "Map of row ids to column definitions. Each row value is a string[][] where every inner array lists the child model UIDs rendered inside one column.",
+  additionalProperties: {
+    type: "array",
+    items: {
+      type: "array",
+      items: {
+        type: "string"
+      }
+    }
+  }
+};
+const gridSizesSchema = {
+  type: "object",
+  description: "Map of row ids to column widths. Each width array uses the 24-column grid system, for example [12, 12] or [8, 8, 8].",
+  additionalProperties: {
+    type: "array",
+    items: {
+      type: "number"
+    }
+  }
+};
+const gridRowOrderSchema = {
+  type: "array",
+  description: "Optional explicit row order. When omitted, the persisted row key order is used.",
+  items: {
+    type: "string"
+  }
+};
+function createGridLayoutStepParamsSchema() {
+  return {
+    type: "object",
+    properties: {
+      gridSettings: {
+        type: "object",
+        properties: {
+          grid: {
+            type: "object",
+            description: "Persisted multi-row, multi-column grid layout.",
+            properties: {
+              rows: gridRowsSchema,
+              sizes: gridSizesSchema,
+              rowOrder: gridRowOrderSchema
+            },
+            additionalProperties: false
+          }
+        },
+        additionalProperties: true
+      }
+    },
+    additionalProperties: true
+  };
+}
+function createGridLayoutStepParamsValue(rows, sizes, rowOrder) {
+  return {
+    gridSettings: {
+      grid: {
+        rows,
+        sizes,
+        rowOrder
+      }
+    }
+  };
+}
+function createGridLayoutItems(itemUses, prefix, count) {
+  const uses = itemUses.length > 0 ? itemUses : ["FlowModel"];
+  return Array.from({ length: count }, (_, index) => ({
+    uid: `${prefix}-item-${index + 1}`,
+    use: uses[index % uses.length]
+  }));
+}
+function createGridLayoutDocs(options) {
+  const minimalItems = createGridLayoutItems(options.itemUses, `${options.prefix}-minimal`, 1);
+  const standardItems = createGridLayoutItems(options.itemUses, `${options.prefix}-standard`, 5);
+  const customSizeItems = createGridLayoutItems(options.itemUses, `${options.prefix}-sizes`, 5);
+  const minimalRows = {
+    rowMain: [[minimalItems[0].uid]]
+  };
+  const standardRows = {
+    rowTop: [[standardItems[0].uid], [standardItems[1].uid]],
+    rowBottom: [[standardItems[2].uid], [standardItems[3].uid], [standardItems[4].uid]]
+  };
+  const customSizeRows = {
+    rowTop: [[customSizeItems[0].uid], [customSizeItems[1].uid]],
+    rowBottom: [[customSizeItems[2].uid], [customSizeItems[3].uid], [customSizeItems[4].uid]]
+  };
+  return {
+    minimalExample: {
+      uid: `${options.prefix}-grid`,
+      use: options.use,
+      stepParams: createGridLayoutStepParamsValue(minimalRows, { rowMain: [24] }, ["rowMain"]),
+      subModels: {
+        items: minimalItems
+      }
+    },
+    commonPatterns: [
+      {
+        title: "Single row with one column",
+        description: "Use one row with a single 24-column slot when the grid only needs one child model.",
+        snippet: {
+          use: options.use,
+          stepParams: createGridLayoutStepParamsValue(minimalRows, { rowMain: [24] }, ["rowMain"]),
+          subModels: {
+            items: minimalItems
+          }
+        }
+      },
+      {
+        title: "Two rows with 2 + 3 columns",
+        description: "The first row has 2 columns and the second row has 3 columns with equal widths.",
+        snippet: {
+          use: options.use,
+          stepParams: createGridLayoutStepParamsValue(
+            standardRows,
+            {
+              rowTop: [12, 12],
+              rowBottom: [8, 8, 8]
+            },
+            ["rowTop", "rowBottom"]
+          ),
+          subModels: {
+            items: standardItems
+          }
+        }
+      },
+      {
+        title: "Two rows with custom column sizes",
+        description: "Use sizes to express non-equal column widths while keeping the rows definition stable.",
+        snippet: {
+          use: options.use,
+          stepParams: createGridLayoutStepParamsValue(
+            customSizeRows,
+            {
+              rowTop: [8, 16],
+              rowBottom: [6, 10, 8]
+            },
+            ["rowTop", "rowBottom"]
+          ),
+          subModels: {
+            items: customSizeItems
+          }
+        }
+      }
+    ],
+    dynamicHints: options.dynamicHints || []
+  };
+}
+const publicBlockRootUses = [
+  "CreateFormModel",
+  "DetailsBlockModel",
+  "EditFormModel",
+  "FilterFormBlockModel",
+  "JSBlockModel",
+  "TableBlockModel"
+];
+const pageTabUses = ["RootPageTabModel", "PageTabModel"];
+const tableColumnUses = [
+  "TableColumnModel",
+  "TableActionsColumnModel",
+  "JSColumnModel",
+  "TableCustomColumnModel"
+];
+const coreBlockGridItemUses = [...publicBlockRootUses];
+const collectionActionUses = [
+  "AddNewActionModel",
+  "BulkDeleteActionModel",
+  "ExpandCollapseActionModel",
+  "FilterActionModel",
+  "JSCollectionActionModel",
+  "LinkActionModel",
+  "PopupCollectionActionModel",
+  "RefreshActionModel"
+];
+const recordActionUses = [
+  "AddChildActionModel",
+  "DeleteActionModel",
+  "EditActionModel",
+  "JSRecordActionModel",
+  "LinkActionModel",
+  "PopupCollectionActionModel",
+  "UpdateRecordActionModel",
+  "ViewActionModel"
+];
+const formBlockActionUses = ["FormSubmitActionModel", "JSFormActionModel"];
+const filterFormActionUses = [
+  "FilterFormSubmitActionModel",
+  "FilterFormResetActionModel",
+  "FilterFormCollapseActionModel",
+  "FilterFormJSActionModel"
+];
+const formGridItemUses = ["FormItemModel", "FormAssociationItemModel", "JSItemModel"];
+const detailsGridItemUses = ["DetailsItemModel"];
+const filterFormGridItemUses = ["FilterFormItemModel", "FilterFormCustomFieldModel"];
+const fieldBindingInitSchema = {
+  type: "object",
+  properties: {
+    dataSourceKey: { type: "string" },
+    collectionName: { type: "string" },
+    fieldPath: { type: "string" },
+    associationPathName: { type: "string" }
+  },
+  required: ["dataSourceKey", "collectionName", "fieldPath"],
+  additionalProperties: true
+};
+const filterFieldMetadataSchema = {
+  type: "object",
+  properties: {
+    name: { type: "string" },
+    title: { type: "string" },
+    interface: { type: "string" },
+    type: { type: "string" }
+  },
+  additionalProperties: true
+};
+function createRuntimeFieldModelSlotSchema(fieldBindingContext, description = "Field renderer model is resolved from runtime field bindings.") {
+  return {
+    type: "object",
+    dynamic: true,
+    fieldBindingContext,
+    schema: genericModelNodeSchema,
+    description
+  };
+}
+const showLabelStepParamsSchema = {
+  type: "object",
+  properties: {
+    showLabel: { type: "boolean" }
+  },
+  additionalProperties: false
+};
+const labelStepParamsSchema = {
+  type: "object",
+  properties: {
+    label: { type: "string" },
+    title: { type: "string" }
+  },
+  additionalProperties: false
+};
+const tooltipStepParamsSchema = {
+  type: "object",
+  properties: {
+    tooltip: { type: "string" }
+  },
+  additionalProperties: false
+};
+const descriptionStepParamsSchema = {
+  type: "object",
+  properties: {
+    description: { type: "string" }
+  },
+  additionalProperties: false
+};
+const defaultValueStepParamsSchema = {
+  type: "object",
+  properties: {
+    defaultValue: {}
+  },
+  additionalProperties: false
+};
+const tableColumnWidthStepParamsSchema = {
+  type: "object",
+  properties: {
+    width: {
+      type: "number"
+    }
+  },
+  additionalProperties: false
+};
+const tableColumnEditableStepParamsSchema = {
+  type: "object",
+  properties: {
+    editable: { type: "boolean" }
+  },
+  additionalProperties: false
+};
+const tableColumnSorterStepParamsSchema = {
+  type: "object",
+  properties: {
+    sorter: { type: "boolean" }
+  },
+  additionalProperties: false
+};
+const filterFormItemInitStepParamsSchema = {
+  type: "object",
+  properties: {
+    filterField: filterFieldMetadataSchema,
+    defaultTargetUid: { type: "string" }
+  },
+  additionalProperties: true
+};
+const actionButtonGeneralStepParamsSchema = {
+  type: "object",
+  properties: {
+    title: { type: "string" },
+    tooltip: { type: "string" },
+    type: {
+      type: "string",
+      enum: ["default", "primary", "dashed", "link", "text"]
+    },
+    danger: { type: "boolean" },
+    icon: { type: ["string", "null"] },
+    color: { type: "string" }
+  },
+  additionalProperties: true
+};
+const actionButtonSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    buttonSettings: {
+      type: "object",
+      properties: {
+        general: actionButtonGeneralStepParamsSchema,
+        linkageRules: linkageRuleValueSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+function createActionStepParamsSchema(extraProperties = {}) {
+  return {
+    type: "object",
+    properties: {
+      ...actionButtonSettingsStepParamsSchema.properties || {},
+      ...extraProperties
+    },
+    additionalProperties: true
+  };
+}
+const confirmStepParamsSchema = {
+  type: "object",
+  properties: {
+    enable: { type: "boolean" },
+    title: { type: "string" },
+    content: { type: "string" }
+  },
+  additionalProperties: false
+};
+const popupActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    openView: openViewParamsSchema
+  },
+  additionalProperties: true
+};
+const runJsActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    runJs: {
+      type: "object",
+      properties: {
+        version: { type: "string" },
+        code: { type: "string" }
+      },
+      required: ["code"],
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const deleteActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    confirm: confirmStepParamsSchema
+  },
+  additionalProperties: true
+};
+const refreshActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    refresh: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const expandCollapseActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    expandCollapse: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const filterActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    position: {
+      type: "object",
+      properties: {
+        position: {
+          type: "string",
+          enum: ["left", "right"]
+        }
+      },
+      additionalProperties: false
+    },
+    filterableFieldNames: {
+      type: "object",
+      properties: {
+        filterableFieldNames: {
+          type: "array",
+          items: {
+            type: "string"
+          }
+        }
+      },
+      additionalProperties: false
+    },
+    defaultFilter: {
+      type: "object",
+      properties: {
+        defaultFilter: genericFilterSchema
+      },
+      additionalProperties: false
+    }
+  },
+  additionalProperties: true
+};
+const linkActionSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    editLink: {
+      type: "object",
+      properties: {
+        url: { type: "string" },
+        searchParams: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string" },
+              value: { type: "string" }
+            },
+            additionalProperties: true
+          }
+        },
+        openInNewWindow: { type: "boolean" }
+      },
+      required: ["url"],
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const formSubmitSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    confirm: {
+      type: "object",
+      properties: {
+        enable: { type: "boolean" },
+        title: { type: "string" },
+        content: { type: "string" }
+      },
+      additionalProperties: true
+    },
+    saveResource: {
+      type: "object",
+      additionalProperties: true
+    },
+    refreshAndClose: {
+      type: "object",
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const filterFormCollapseSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    toggle: {
+      type: "object",
+      properties: {
+        collapsedRows: {
+          type: "number"
+        }
+      },
+      additionalProperties: false
+    },
+    defaultCollapsed: {
+      type: "object",
+      properties: {
+        value: { type: "boolean" }
+      },
+      additionalProperties: false
+    }
+  },
+  additionalProperties: true
+};
+const pageTabSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    pageTabSettings: {
+      type: "object",
+      properties: {
+        tab: {
+          type: "object",
+          properties: {
+            title: { type: "string" },
+            documentTitle: { type: "string" },
+            icon: { type: ["string", "null"] }
+          },
+          additionalProperties: false
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const childPageSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    pageSettings: {
+      type: "object",
+      properties: {
+        general: {
+          type: "object",
+          properties: {
+            title: { type: "string" },
+            documentTitle: { type: "string" },
+            displayTitle: { type: "boolean" },
+            enableTabs: { type: "boolean" }
+          },
+          additionalProperties: false
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+function createPopupActionOpenViewParams(overrides = {}) {
+  return {
+    mode: "drawer",
+    size: "medium",
+    pageModelClass: "ChildPageModel",
+    ...overrides
+  };
+}
+function createPopupBlockGrid(options) {
+  return {
+    uid: `${options.prefix}-grid`,
+    use: "BlockGridModel",
+    subModels: {
+      items: options.items || []
+    }
+  };
+}
+function createPopupChildPageTree(options) {
+  return {
+    uid: `${options.prefix}-page`,
+    use: "ChildPageModel",
+    stepParams: {
+      pageSettings: {
+        general: {
+          displayTitle: false,
+          enableTabs: true
+        }
+      }
+    },
+    subModels: {
+      tabs: [
+        {
+          uid: `${options.prefix}-tab`,
+          use: "ChildPageTabModel",
+          stepParams: {
+            pageTabSettings: {
+              tab: {
+                title: options.tabTitle || "Popup"
+              }
+            }
+          },
+          subModels: {
+            grid: createPopupBlockGrid({
+              prefix: `${options.prefix}-tab`,
+              items: options.items
+            })
+          }
+        }
+      ]
+    }
+  };
+}
+function createPopupPageSlotSchema() {
+  return {
+    type: "object",
+    use: "ChildPageModel",
+    description: "Popup child page.",
+    childSchemaPatch: {
+      subModelSlots: {
+        tabs: {
+          type: "array",
+          uses: ["ChildPageTabModel"],
+          required: true,
+          minItems: 1,
+          description: "Popup child page tabs."
+        }
+      }
+    }
+  };
+}
+const popupActionAntiPatterns = [
+  {
+    title: "Do not treat openView parameters alone as a complete popup",
+    description: "A usable popup action should provide a popup child page tree instead of relying only on runtime defaults."
+  },
+  {
+    title: "Do not use arbitrary pageModelClass values",
+    description: "pageModelClass is restricted to ChildPageModel or RootPageModel."
+  }
+];
+function createPopupActionStepParams(title, overrides = {}) {
+  return {
+    buttonSettings: {
+      general: {
+        title,
+        type: "default"
+      }
+    },
+    popupSettings: {
+      openView: createPopupActionOpenViewParams(overrides)
+    }
+  };
+}
+function createPopupActionExample(options) {
+  return {
+    uid: options.uid,
+    use: options.use,
+    stepParams: createPopupActionStepParams(options.title, options.openView),
+    subModels: {
+      page: createPopupChildPageTree({
+        prefix: options.prefix,
+        tabTitle: options.tabTitle,
+        items: options.items
+      })
+    }
+  };
+}
+function createPopupActionPattern(options) {
+  return {
+    title: options.title,
+    description: options.description,
+    snippet: {
+      use: options.use,
+      stepParams: createPopupActionStepParams(options.buttonTitle, options.openView),
+      subModels: {
+        page: createPopupChildPageTree({
+          prefix: options.prefix,
+          tabTitle: options.tabTitle,
+          items: options.items
+        })
+      }
+    }
+  };
+}
+const detailItemStepParamsSchema = {
+  type: "object",
+  properties: {
+    fieldSettings: {
+      type: "object",
+      properties: {
+        init: fieldBindingInitSchema
+      },
+      additionalProperties: true
+    },
+    detailItemSettings: {
+      type: "object",
+      properties: {
+        showLabel: showLabelStepParamsSchema,
+        label: labelStepParamsSchema,
+        aclCheck: emptyObjectSchema,
+        init: emptyObjectSchema,
+        tooltip: tooltipStepParamsSchema,
+        description: descriptionStepParamsSchema,
+        model: {
+          type: "object",
+          additionalProperties: true
+        },
+        fieldNames: {
+          type: "object",
+          additionalProperties: true
+        }
+      },
+      additionalProperties: true
+    },
+    paginationChange: {
+      type: "object",
+      properties: {
+        aclCheckRefresh: aclCheckRefreshParamsSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const formItemStepParamsSchema = {
+  type: "object",
+  properties: {
+    fieldSettings: {
+      type: "object",
+      properties: {
+        init: fieldBindingInitSchema
+      },
+      additionalProperties: true
+    },
+    editItemSettings: {
+      type: "object",
+      properties: {
+        showLabel: showLabelStepParamsSchema,
+        label: labelStepParamsSchema,
+        aclCheck: emptyObjectSchema,
+        init: emptyObjectSchema,
+        tooltip: tooltipStepParamsSchema,
+        description: descriptionStepParamsSchema,
+        initialValue: defaultValueStepParamsSchema,
+        validation: {
+          type: "object",
+          additionalProperties: true
+        },
+        required: {
+          type: "object",
+          additionalProperties: true
+        },
+        model: {
+          type: "object",
+          additionalProperties: true
+        },
+        pattern: {
+          type: "object",
+          additionalProperties: true
+        },
+        titleField: {
+          type: "object",
+          additionalProperties: true
+        }
+      },
+      additionalProperties: true
+    },
+    paginationChange: {
+      type: "object",
+      properties: {
+        aclCheckRefresh: aclCheckRefreshParamsSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const assignFormItemStepParamsSchema = {
+  type: "object",
+  properties: {
+    fieldSettings: {
+      type: "object",
+      properties: {
+        init: fieldBindingInitSchema,
+        assignValue: {
+          type: "object",
+          properties: {
+            value: {}
+          },
+          additionalProperties: true
+        }
+      },
+      additionalProperties: true
+    },
+    editItemSettings: {
+      type: "object",
+      properties: {
+        showLabel: showLabelStepParamsSchema,
+        label: labelStepParamsSchema,
+        init: emptyObjectSchema,
+        tooltip: tooltipStepParamsSchema,
+        description: descriptionStepParamsSchema,
+        validation: {
+          type: "object",
+          additionalProperties: true
+        },
+        required: {
+          type: "object",
+          additionalProperties: true
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const filterFormItemStepParamsSchema = {
+  type: "object",
+  properties: {
+    fieldSettings: {
+      type: "object",
+      properties: {
+        init: fieldBindingInitSchema
+      },
+      additionalProperties: true
+    },
+    filterFormItemSettings: {
+      type: "object",
+      properties: {
+        init: filterFormItemInitStepParamsSchema,
+        label: labelStepParamsSchema,
+        showLabel: showLabelStepParamsSchema,
+        tooltip: tooltipStepParamsSchema,
+        description: descriptionStepParamsSchema,
+        initialValue: defaultValueStepParamsSchema,
+        model: {
+          type: "object",
+          additionalProperties: true
+        },
+        connectFields: {
+          type: "object",
+          additionalProperties: true
+        },
+        defaultOperator: {
+          type: "object",
+          additionalProperties: true
+        },
+        operatorComponentProps: {
+          type: "object",
+          additionalProperties: true
+        },
+        customizeFilterRender: {
+          type: "object",
+          additionalProperties: true
+        },
+        initField: emptyObjectSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+const tableColumnStepParamsSchema = {
+  type: "object",
+  properties: {
+    fieldSettings: {
+      type: "object",
+      properties: {
+        init: fieldBindingInitSchema
+      },
+      additionalProperties: true
+    },
+    tableColumnSettings: {
+      type: "object",
+      properties: {
+        init: emptyObjectSchema,
+        title: {
+          type: "object",
+          properties: {
+            title: { type: "string" }
+          },
+          additionalProperties: false
+        },
+        tooltip: tooltipStepParamsSchema,
+        width: tableColumnWidthStepParamsSchema,
+        aclCheck: emptyObjectSchema,
+        quickEdit: tableColumnEditableStepParamsSchema,
+        model: {
+          type: "object",
+          additionalProperties: true
+        },
+        sorter: tableColumnSorterStepParamsSchema,
+        fixed: {
+          type: "object",
+          additionalProperties: true
+        },
+        fieldNames: {
+          type: "object",
+          additionalProperties: true
+        }
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+function createFieldBoundStepParamsSchema(bindingFlowKey, bindingFlowSchema, extraProperties = {}) {
+  return {
+    type: "object",
+    properties: {
+      fieldSettings: {
+        type: "object",
+        properties: {
+          init: fieldBindingInitSchema,
+          ...bindingFlowKey === "fieldSettings" ? extraProperties : {}
+        },
+        additionalProperties: true
+      },
+      ...bindingFlowKey === "fieldSettings" ? {} : { [bindingFlowKey]: bindingFlowSchema },
+      ...bindingFlowKey === "fieldSettings" ? {} : extraProperties
+    },
+    additionalProperties: true
+  };
+}
+function createRuntimeFieldDynamicHint(modelUse, path, contextRequirements, unresolvedReason) {
+  return {
+    kind: "dynamic-children",
+    path,
+    message: `${modelUse} field renderer depends on runtime field bindings and collection metadata.`,
+    "x-flow": {
+      slotRules: {
+        slotKey: "field",
+        type: "object"
+      },
+      contextRequirements,
+      unresolvedReason
+    }
+  };
+}
+function createFieldModelStepParamsSchema(extraFieldSettingsProperties = {}) {
+  return {
+    type: "object",
+    properties: {
+      fieldSettings: {
+        type: "object",
+        properties: {
+          init: fieldBindingInitSchema,
+          ...extraFieldSettingsProperties
+        },
+        additionalProperties: true
+      }
+    },
+    additionalProperties: true
+  };
+}
+function createFieldModelSkeleton(use, init = {}) {
+  return {
+    uid: `todo-${use}`.replace(/[^a-zA-Z0-9]+/g, "-").toLowerCase(),
+    use,
+    ...Object.keys(init).length > 0 ? {
+      stepParams: {
+        fieldSettings: {
+          init: {
+            ...init
+          }
+        }
+      }
+    } : {}
+  };
+}
+function createFieldModelSchemaContribution(options) {
+  const contribution = {
+    use: options.use,
+    title: options.title,
+    source: options.source ?? "official",
+    strict: options.strict ?? false,
+    exposure: options.exposure ?? "internal",
+    abstract: options.abstract,
+    allowDirectUse: options.allowDirectUse,
+    suggestedUses: options.suggestedUses,
+    stepParamsSchema: options.stepParamsSchema || createFieldModelStepParamsSchema(),
+    skeleton: options.skeleton || createFieldModelSkeleton(options.use)
+  };
+  return contribution;
+}
+const collectionResourceInitSchema = {
+  type: "object",
+  properties: {
+    dataSourceKey: { type: "string" },
+    collectionName: { type: "string" },
+    associationName: { type: "string" },
+    sourceId: { type: ["string", "number"] },
+    filterByTk: { type: ["string", "number"] }
+  },
+  required: ["dataSourceKey", "collectionName"],
+  additionalProperties: true
+};
+const collectionResourceSettingsStepParamsSchema = {
+  type: "object",
+  properties: {
+    resourceSettings: {
+      type: "object",
+      properties: {
+        init: collectionResourceInitSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+function createCollectionResourceInit(init = {}) {
+  return {
+    dataSourceKey: "main",
+    collectionName: "users",
+    ...init
+  };
+}
+function createCollectionResourceStepParams(init = {}, extraStepParams = {}) {
+  return {
+    resourceSettings: {
+      init: createCollectionResourceInit(init)
+    },
+    ...extraStepParams
+  };
+}
+function createCurrentRecordCollectionPattern(use, extraStepParams = {}) {
+  return {
+    title: "Current record mode",
+    description: "Bind the block to the current record when the page or popup provides filterByTk.",
+    snippet: {
+      use,
+      stepParams: createCollectionResourceStepParams(
+        {
+          filterByTk: "{{ctx.view.inputArgs.filterByTk}}"
+        },
+        extraStepParams
+      )
+    }
+  };
+}
+function createAssociatedCollectionPattern(use, extraStepParams = {}) {
+  return {
+    title: "Associated records in popup/new scene",
+    description: "Use associationName + sourceId when the block should load records through a parent relation.",
+    snippet: {
+      use,
+      stepParams: createCollectionResourceStepParams(
+        {
+          collectionName: "roles",
+          associationName: "users.roles",
+          sourceId: "{{ctx.view.inputArgs.sourceId}}"
+        },
+        extraStepParams
+      )
+    }
+  };
+}
+const formBlockBaseStepParamsSchema = {
+  type: "object",
+  properties: {
+    ...collectionResourceSettingsStepParamsSchema.properties || {},
+    formModelSettings: {
+      type: "object",
+      properties: {
+        layout: layoutParamsSchema,
+        assignRules: linkageRuleValueSchema
+      },
+      additionalProperties: true
+    },
+    eventSettings: {
+      type: "object",
+      properties: {
+        linkageRules: linkageRuleValueSchema
+      },
+      additionalProperties: true
+    }
+  },
+  additionalProperties: true
+};
+function createFormGridDynamicHints() {
+  return [
+    {
+      kind: "dynamic-children",
+      path: "FormGridModel.subModels.items",
+      message: "Form grid items depend on the form field tree and runtime field model factories.",
+      "x-flow": {
+        slotRules: {
+          slotKey: "items",
+          type: "array",
+          allowedUses: formGridItemUses
+        },
+        contextRequirements: ["form field tree", "field model factories"],
+        unresolvedReason: "runtime-form-grid-items"
+      }
+    }
+  ];
+}
+function createFormBlockSubModelSlots() {
+  return {
+    grid: {
+      type: "object",
+      use: "FormGridModel",
+      description: "Primary form grid container."
+    },
+    actions: {
+      type: "array",
+      uses: formBlockActionUses,
+      schema: genericModelNodeSchema,
+      description: "Form actions are resolved from the runtime form action registry."
+    }
+  };
+}
+function createFormBlockSkeleton(use) {
+  return {
+    uid: "todo-uid",
+    use,
+    stepParams: createCollectionResourceStepParams(
+      {},
+      {
+        formModelSettings: {
+          layout: {
+            layout: "vertical",
+            colon: true
+          },
+          assignRules: {
+            value: []
+          }
+        },
+        eventSettings: {
+          linkageRules: {
+            value: []
+          }
+        }
+      }
+    ),
+    subModels: {
+      grid: {
+        uid: "todo-grid-uid",
+        use: "FormGridModel"
+      },
+      actions: []
+    }
+  };
+}
+function createFormBlockMinimalExample(use) {
+  return {
+    uid: `${use}-users`.toLowerCase(),
+    use,
+    stepParams: createCollectionResourceStepParams(
+      {},
+      {
+        formModelSettings: {
+          layout: {
+            layout: "vertical",
+            colon: true
+          },
+          assignRules: {
+            value: []
+          }
+        },
+        eventSettings: {
+          linkageRules: {
+            value: []
+          }
+        }
+      }
+    ),
+    subModels: {
+      grid: {
+        uid: `${use}-grid-users`.toLowerCase(),
+        use: "FormGridModel"
+      },
+      actions: []
+    }
+  };
+}
+function createFormBlockCommonPatterns(use) {
+  return [
+    {
+      title: "Empty editable form block shell",
+      snippet: {
+        use,
+        stepParams: createCollectionResourceStepParams(
+          {},
+          {
+            formModelSettings: {
+              layout: {
+                layout: "vertical",
+                colon: true
+              }
+            }
+          }
+        ),
+        subModels: {
+          grid: {
+            uid: "form-grid-uid",
+            use: "FormGridModel"
+          }
+        }
+      }
+    }
+  ];
+}
+const formBlockAntiPatterns = [
+  {
+    title: "Do not omit grid when generating a complete form tree",
+    description: "A form block can be persisted without subModels, but useful form payloads usually need a grid child."
+  }
+];
+function createFormBlockDynamicHints(use) {
+  return [
+    {
+      kind: "dynamic-children",
+      path: `${use}.subModels`,
+      message: "Form block child models are assembled from runtime model classes and field metadata.",
+      "x-flow": {
+        slotRules: {
+          slotKey: "actions",
+          type: "array",
+          allowedUses: formBlockActionUses
+        },
+        contextRequirements: ["form field tree", "collection metadata"],
+        unresolvedReason: "runtime-form-children"
+      }
+    }
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  aclCheckRefreshParamsSchema,
+  actionButtonGeneralStepParamsSchema,
+  actionButtonSettingsStepParamsSchema,
+  assignFormItemStepParamsSchema,
+  childPageSettingsStepParamsSchema,
+  collectionActionUses,
+  collectionResourceInitSchema,
+  collectionResourceSettingsStepParamsSchema,
+  confirmStepParamsSchema,
+  coreBlockGridItemUses,
+  createActionStepParamsSchema,
+  createAssociatedCollectionPattern,
+  createCollectionResourceInit,
+  createCollectionResourceStepParams,
+  createCurrentRecordCollectionPattern,
+  createFieldBoundStepParamsSchema,
+  createFieldModelSchemaContribution,
+  createFieldModelSkeleton,
+  createFieldModelStepParamsSchema,
+  createFormBlockCommonPatterns,
+  createFormBlockDynamicHints,
+  createFormBlockMinimalExample,
+  createFormBlockSkeleton,
+  createFormBlockSubModelSlots,
+  createFormGridDynamicHints,
+  createGridLayoutDocs,
+  createGridLayoutStepParamsSchema,
+  createPopupActionExample,
+  createPopupActionOpenViewParams,
+  createPopupActionPattern,
+  createPopupActionStepParams,
+  createPopupBlockGrid,
+  createPopupChildPageTree,
+  createPopupPageSlotSchema,
+  createRuntimeFieldDynamicHint,
+  createRuntimeFieldModelSlotSchema,
+  dataScopeParamsSchema,
+  defaultValueStepParamsSchema,
+  deleteActionSettingsStepParamsSchema,
+  descriptionStepParamsSchema,
+  detailItemStepParamsSchema,
+  detailsGridItemUses,
+  emptyObjectSchema,
+  expandCollapseActionSettingsStepParamsSchema,
+  fieldBindingInitSchema,
+  filterActionSettingsStepParamsSchema,
+  filterFieldMetadataSchema,
+  filterFormActionUses,
+  filterFormCollapseSettingsStepParamsSchema,
+  filterFormGridItemUses,
+  filterFormItemInitStepParamsSchema,
+  filterFormItemStepParamsSchema,
+  formBlockActionUses,
+  formBlockAntiPatterns,
+  formBlockBaseStepParamsSchema,
+  formGridItemUses,
+  formItemStepParamsSchema,
+  formSubmitSettingsStepParamsSchema,
+  genericFilterSchema,
+  genericModelNodeSchema,
+  gridRowOrderSchema,
+  gridRowsSchema,
+  gridSizesSchema,
+  labelStepParamsSchema,
+  layoutParamsSchema,
+  linkActionSettingsStepParamsSchema,
+  linkageRuleValueSchema,
+  linkageRulesRefreshParamsSchema,
+  openViewParamsSchema,
+  pageTabSettingsStepParamsSchema,
+  pageTabUses,
+  popupActionAntiPatterns,
+  popupActionSettingsStepParamsSchema,
+  publicBlockRootUses,
+  recordActionUses,
+  refreshActionSettingsStepParamsSchema,
+  runJsActionSettingsStepParamsSchema,
+  showLabelStepParamsSchema,
+  sortingRuleParamsSchema,
+  tableColumnEditableStepParamsSchema,
+  tableColumnSorterStepParamsSchema,
+  tableColumnStepParamsSchema,
+  tableColumnUses,
+  tableColumnWidthStepParamsSchema,
+  tooltipStepParamsSchema
+});