@aranzatech/diagrams-bpmn 0.1.3 → 0.2.0

package/dist/index.cjs

@@ -4,6 +4,8 @@ var react = require('@xyflow/react');
 var jsxRuntime = require('react/jsx-runtime');
 var routing = require('@aranzatech/diagrams-core/routing');
 var bpmnModdle = require('bpmn-moddle');
+var diagramsCore = require('@aranzatech/diagrams-core');
+var serialization = require('@aranzatech/diagrams-core/serialization');
 
 // src/elements/catalog.ts
 var BPMN_ELEMENT_CATALOG = {
@@ -1238,11 +1240,24 @@ function GatewayNode({ data, selected }) {
     /* @__PURE__ */ jsxRuntime.jsx(BpmnLabel, { external: true, children: d.label })
   ] });
 }
+function resolveVariant(d) {
+  if (d.subProcessVariant) return d.subProcessVariant;
+  switch (d.elementType) {
+    case "Transaction":
+      return "transaction";
+    case "EventSubProcess":
+      return "event";
+    case "AdHocSubProcess":
+      return "adhoc";
+    default:
+      return "embedded";
+  }
+}
 function SubProcessNode({ data, selected }) {
   const d = data;
   const stroke = resolveStroke(selected, d.color?.stroke);
   const sw = resolveStrokeWidth(selected);
-  const variant = d.subProcessVariant ?? "embedded";
+  const variant = resolveVariant(d);
   const isExpanded = d.isExpanded ?? true;
   const hasMarkers = d.markers && d.markers.length > 0;
   const borderStyle = variant === "event" ? "dashed" : "solid";
@@ -1334,6 +1349,7 @@ function PoolNode({ data, selected }) {
             "div",
             {
               "aria-label": "pool-header",
+              className: "pool-drag-handle",
               style: {
                 height: HEADER_HEIGHT,
                 minHeight: HEADER_HEIGHT,
@@ -1342,7 +1358,8 @@ function PoolNode({ data, selected }) {
                 alignItems: "center",
                 justifyContent: "center",
                 background: headerFill,
-                padding: "0 8px"
+                padding: "0 8px",
+                cursor: "grab"
               },
               children: /* @__PURE__ */ jsxRuntime.jsx(
                 "span",
@@ -1391,7 +1408,8 @@ function PoolNode({ data, selected }) {
               display: "flex",
               alignItems: "center",
               justifyContent: "center",
-              background: headerFill
+              background: headerFill,
+              cursor: "grab"
             },
             children: /* @__PURE__ */ jsxRuntime.jsx(
               "span",
@@ -1446,6 +1464,7 @@ function LaneNode({ data, selected }) {
             "div",
             {
               "aria-label": "lane-header",
+              className: "lane-drag-handle",
               style: {
                 width: HEADER_WIDTH2,
                 minWidth: HEADER_WIDTH2,
@@ -1454,7 +1473,8 @@ function LaneNode({ data, selected }) {
                 alignItems: "center",
                 justifyContent: "center",
                 background: headerFill,
-                padding: "6px 0"
+                padding: "6px 0",
+                cursor: "grab"
               },
               children: /* @__PURE__ */ jsxRuntime.jsx(
                 "span",
@@ -1500,6 +1520,7 @@ function LaneNode({ data, selected }) {
           "div",
           {
             "aria-label": "lane-header",
+            className: "lane-drag-handle",
             style: {
               height: HEADER_HEIGHT2,
               minHeight: HEADER_HEIGHT2,
@@ -1510,7 +1531,8 @@ function LaneNode({ data, selected }) {
               background: headerFill,
               fontSize: BPMN_THEME.fontSize,
               fontWeight: 500,
-              color: BPMN_THEME.labelColor
+              color: BPMN_THEME.labelColor,
+              cursor: "grab"
             },
             children: d.label
           }
@@ -2084,8 +2106,11 @@ var BPMN_NODE_TYPES = {
   ParallelGateway: GatewayNode,
   EventBasedGateway: GatewayNode,
   ComplexGateway: GatewayNode,
-  // Containers
+  // Containers — Transaction, EventSubProcess, AdHocSubProcess derive their visual variant from elementType
   SubProcess: SubProcessNode,
+  Transaction: SubProcessNode,
+  EventSubProcess: SubProcessNode,
+  AdHocSubProcess: SubProcessNode,
   Pool: PoolNode,
   Lane: LaneNode,
   // Artifacts
@@ -2408,8 +2433,8 @@ var MODDLE_TO_ELEMENT_TYPE = {
   "bpmn:EventBasedGateway": "EventBasedGateway",
   "bpmn:ComplexGateway": "ComplexGateway",
   "bpmn:SubProcess": "SubProcess",
-  "bpmn:AdHocSubProcess": "SubProcess",
-  "bpmn:Transaction": "SubProcess",
+  "bpmn:AdHocSubProcess": "AdHocSubProcess",
+  "bpmn:Transaction": "Transaction",
   "bpmn:TextAnnotation": "Annotation",
   "bpmn:Group": "Group",
   "bpmn:DataObject": "DataObject",
@@ -2447,6 +2472,9 @@ var ELEMENT_TYPE_TO_MODDLE = {
   EventBasedGateway: "bpmn:EventBasedGateway",
   ComplexGateway: "bpmn:ComplexGateway",
   SubProcess: "bpmn:SubProcess",
+  Transaction: "bpmn:Transaction",
+  EventSubProcess: "bpmn:SubProcess",
+  AdHocSubProcess: "bpmn:AdHocSubProcess",
   Pool: "bpmn:Participant",
   Lane: "bpmn:Lane",
   Annotation: "bpmn:TextAnnotation",
@@ -2511,6 +2539,10 @@ function asElements(v) {
 function asString(v) {
   return typeof v === "string" && v.trim() ? v.trim() : void 0;
 }
+function extractDocumentation(el) {
+  const [doc] = asElements(el.documentation);
+  return asString(doc?.text);
+}
 function extractDiagramInfo(definitions) {
   const shapes = /* @__PURE__ */ new Map();
   const waypoints = /* @__PURE__ */ new Map();
@@ -2566,6 +2598,7 @@ function extractTrigger(el) {
 function extractSubProcessVariant(el) {
   if (el.$type === "bpmn:Transaction") return "transaction";
   if (el.$type === "bpmn:AdHocSubProcess") return "adhoc";
+  if (el.$type === "bpmn:SubProcess" && el.triggeredByEvent === true) return "event";
   if (el.triggeredByEvent === true) return "event";
   return "embedded";
 }
@@ -2579,7 +2612,7 @@ function walkFlowElements(elements, parentId, ctx, nodes, edges) {
       continue;
     }
     if ($type === "bpmn:LaneSet") continue;
-    const elementType = MODDLE_TO_ELEMENT_TYPE[$type];
+    const elementType = $type === "bpmn:SubProcess" && el.triggeredByEvent === true ? "EventSubProcess" : MODDLE_TO_ELEMENT_TYPE[$type];
     if (!elementType) {
       ctx.warnings.push(`Unknown element type "${$type}" (id=${id}) \u2014 skipped.`);
       continue;
@@ -2600,22 +2633,26 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
   const y = shape?.y ?? 100;
   if (!shape) ctx.autoX.value += (meta?.defaultWidth ?? 120) + 20;
   const label = asString(el.name);
+  const documentation = extractDocumentation(el);
   const trigger = extractTrigger(el);
   const isNonInterrupting = el.cancelActivity === false;
+  const attachedToRef = el.attachedToRef?.id;
   const data = {
     elementType,
     ...label ? { label } : {},
+    ...documentation ? { documentation } : {},
     ...trigger ? { trigger } : {},
-    ...isNonInterrupting ? { isNonInterrupting: true } : {}
+    ...isNonInterrupting ? { isNonInterrupting: true } : {},
+    ...attachedToRef ? { attachedToRef } : {}
   };
-  if (elementType === "SubProcess") {
+  if (elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess") {
     const variant = extractSubProcessVariant(el);
     if (variant) data.subProcessVariant = variant;
     const isExpanded = shape?.isExpanded ?? true;
     data.isExpanded = isExpanded;
   }
   const laneId = ctx.laneMembership.get(id);
-  const effectiveParentId = laneId ?? parentId;
+  const effectiveParentId = attachedToRef ?? laneId ?? parentId;
   const node = {
     id,
     type: elementType,
@@ -2636,10 +2673,12 @@ function buildEdge(el, edgeType, ctx, edges) {
     return;
   }
   const label = asString(el.name);
+  const documentation = extractDocumentation(el);
   const condExpr = el.conditionExpression;
   const data = {
     edgeType,
     ...label ? { label } : {},
+    ...documentation ? { documentation } : {},
     ...condExpr?.body ? { conditionExpression: condExpr.body } : {}
   };
   const waypoints = ctx.waypoints.get(id);
@@ -2740,7 +2779,46 @@ async function parseBpmnXml(xml) {
       );
     }
   }
-  return { nodes, edges, warnings };
+  const defaultFlowById = /* @__PURE__ */ new Set();
+  const nodeIds = new Set(nodes.map((node) => node.id));
+  for (const rootEl of asElements(rootElement.rootElements)) {
+    collectDefaultFlows(rootEl, defaultFlowById);
+  }
+  const normalizedEdges = edges.map((edge) => {
+    if (!defaultFlowById.has(edge.id)) return edge;
+    const data = {
+      edgeType: edge.data?.edgeType ?? edge.type,
+      ...edge.data ?? {},
+      isDefault: true
+    };
+    return { ...edge, data };
+  });
+  return {
+    nodes: normalizeChildPositions(nodes, nodeIds),
+    edges: normalizedEdges,
+    warnings
+  };
+}
+function collectDefaultFlows(el, defaultFlowById) {
+  const defaultRef = el.default;
+  if (defaultRef?.id) defaultFlowById.add(defaultRef.id);
+  for (const child of asElements(el.rootElements)) collectDefaultFlows(child, defaultFlowById);
+  for (const child of asElements(el.flowElements)) collectDefaultFlows(child, defaultFlowById);
+}
+function normalizeChildPositions(nodes, nodeIds) {
+  const absoluteById = new Map(nodes.map((node) => [node.id, node.position]));
+  return nodes.map((node) => {
+    if (!node.parentId || !nodeIds.has(node.parentId)) return node;
+    const parentPosition = absoluteById.get(node.parentId);
+    if (!parentPosition) return node;
+    return {
+      ...node,
+      position: {
+        x: node.position.x - parentPosition.x,
+        y: node.position.y - parentPosition.y
+      }
+    };
+  });
 }
 function uid(prefix, id) {
   return `${prefix}_${id}`;
@@ -2748,19 +2826,6 @@ function uid(prefix, id) {
 function asNodes(nodes, types) {
   return nodes.filter((n) => types.includes(n.data.elementType));
 }
-function buildFlowableAttrs(data) {
-  const attrs = {};
-  if (data.flowableAssignee) attrs["flowable:assignee"] = data.flowableAssignee;
-  if (data.flowableCandidateGroups) attrs["flowable:candidateGroups"] = data.flowableCandidateGroups;
-  if (data.flowableCandidateUsers) attrs["flowable:candidateUsers"] = data.flowableCandidateUsers;
-  if (data.flowableFormKey) attrs["flowable:formKey"] = data.flowableFormKey;
-  if (data.flowableDueDate) attrs["flowable:dueDate"] = data.flowableDueDate;
-  if (data.flowableType) attrs["flowable:type"] = data.flowableType;
-  if (data.flowableExpression) attrs["flowable:expression"] = data.flowableExpression;
-  if (data.flowableClass) attrs["flowable:class"] = data.flowableClass;
-  if (data.flowableDelegateExpression) attrs["flowable:delegateExpression"] = data.flowableDelegateExpression;
-  return attrs;
-}
 function buildSemanticModel(moddle, nodes, edges, opts) {
   const defId = opts.id ?? "Definitions_1";
   const defName = opts.name;
@@ -2819,13 +2884,26 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
   return definitions;
 }
 function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId) {
-  const myNodes = poolId ? allNodes.filter(
+  const subProcessIds = new Set(
+    allNodes.filter(
+      (n) => n.data.elementType === "SubProcess" || n.data.elementType === "Transaction" || n.data.elementType === "EventSubProcess" || n.data.elementType === "AdHocSubProcess"
+    ).map((n) => n.id)
+  );
+  const isInsideSubProcess = (node) => {
+    let parentId = node.parentId;
+    while (parentId) {
+      if (subProcessIds.has(parentId)) return true;
+      parentId = allNodes.find((candidate) => candidate.id === parentId)?.parentId;
+    }
+    return false;
+  };
+  const myNodes = (poolId ? allNodes.filter(
     (n) => n.parentId === poolId || laneNodes.some((l) => l.id === n.parentId && l.parentId === poolId)
-  ) : allNodes.filter((n) => n.data.elementType !== "Pool" && n.data.elementType !== "Lane");
+  ) : allNodes.filter((n) => n.data.elementType !== "Pool" && n.data.elementType !== "Lane")).filter((n) => !isInsideSubProcess(n));
   const myLanes = laneNodes.filter((l) => poolId ? l.parentId === poolId : true);
   const flowElements = [];
   for (const node of myNodes) {
-    const el = buildFlowElement(moddle, node);
+    const el = buildFlowElement(moddle, node, allNodes, allEdges);
     if (el) flowElements.push(el);
   }
   const myNodeIds = new Set(myNodes.map((n) => n.id));
@@ -2836,6 +2914,17 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId)
     const edgeMeta = buildEdgeElement(moddle, edge);
     if (edgeMeta) flowElements.push(edgeMeta);
   }
+  const elementById = new Map(
+    flowElements.filter((element) => typeof element.id === "string").map((element) => [element.id, element])
+  );
+  for (const edge of myEdges) {
+    if (!edge.data?.isDefault) continue;
+    const sourceElement = elementById.get(edge.source);
+    const edgeElement = elementById.get(edge.id);
+    if (sourceElement && edgeElement) {
+      sourceElement.default = edgeElement;
+    }
+  }
   const process = moddle.create("bpmn:Process", {
     id: processId,
     isExecutable: true,
@@ -2856,7 +2945,7 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId)
   }
   return process;
 }
-function buildFlowElement(moddle, node, _allNodes, _allEdges) {
+function buildFlowElement(moddle, node, allNodes, allEdges) {
   const { elementType, label, trigger } = node.data;
   if (elementType === "Pool" || elementType === "Lane") return null;
   const moddleType = ELEMENT_TYPE_TO_MODDLE[elementType];
@@ -2865,25 +2954,46 @@ function buildFlowElement(moddle, node, _allNodes, _allEdges) {
     id: node.id,
     name: label ?? ""
   };
+  if (node.data.documentation) {
+    attrs.documentation = [
+      moddle.create("bpmn:Documentation", { text: node.data.documentation })
+    ];
+  }
   if (trigger && trigger !== "none") {
     const defType = TRIGGER_TO_EVENT_DEF[trigger];
     if (defType) {
       attrs.eventDefinitions = [moddle.create(defType, { id: uid("EventDef", node.id) })];
     }
   }
-  if (elementType === "SubProcess" && node.data.subProcessVariant === "transaction") {
-    return moddle.create("bpmn:Transaction", attrs);
+  if (elementType === "BoundaryEvent") {
+    attrs.attachedToRef = { id: node.data.attachedToRef ?? node.parentId };
+    attrs.cancelActivity = node.data.isNonInterrupting ? false : true;
   }
-  if (elementType === "SubProcess" && node.data.subProcessVariant === "adhoc") {
-    return moddle.create("bpmn:AdHocSubProcess", attrs);
+  const isSubProcess2 = elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess";
+  if (isSubProcess2) {
+    attrs.flowElements = buildNestedFlowElements(moddle, node, allNodes, allEdges);
+    if (elementType === "EventSubProcess" || node.data.subProcessVariant === "event") {
+      attrs.triggeredByEvent = true;
+    }
   }
   const element = moddle.create(moddleType, attrs);
-  const flowableAttrs = buildFlowableAttrs(node.data);
-  if (Object.keys(flowableAttrs).length > 0) {
-    element.$attrs = flowableAttrs;
-  }
   return element;
 }
+function buildNestedFlowElements(moddle, parent, allNodes, allEdges) {
+  const childNodes = allNodes.filter((node) => node.parentId === parent.id);
+  const childNodeIds = new Set(childNodes.map((node) => node.id));
+  const flowElements = [];
+  for (const child of childNodes) {
+    const element = buildFlowElement(moddle, child, allNodes, allEdges);
+    if (element) flowElements.push(element);
+  }
+  for (const edge of allEdges) {
+    if (!childNodeIds.has(edge.source) || !childNodeIds.has(edge.target)) continue;
+    const element = buildEdgeElement(moddle, edge);
+    if (element) flowElements.push(element);
+  }
+  return flowElements;
+}
 function buildEdgeElement(moddle, edge) {
   if (!edge.data) return null;
   const moddleType = EDGE_TYPE_TO_MODDLE[edge.data.edgeType];
@@ -2894,6 +3004,11 @@ function buildEdgeElement(moddle, edge) {
     sourceRef: { id: edge.source },
     targetRef: { id: edge.target }
   };
+  if (edge.data.documentation) {
+    attrs.documentation = [
+      moddle.create("bpmn:Documentation", { text: edge.data.documentation })
+    ];
+  }
   if (edge.data.conditionExpression) {
     attrs.conditionExpression = moddle.create("bpmn:FormalExpression", {
       body: edge.data.conditionExpression
@@ -2904,13 +3019,14 @@ function buildEdgeElement(moddle, edge) {
 function buildBpmnDI(moddle, definitions, nodes, edges) {
   const shapes = [];
   const edgeShapes = [];
+  const absolutePositionById = buildAbsolutePositionMap(nodes);
   for (const node of nodes) {
     const meta = BPMN_ELEMENT_CATALOG[node.data.elementType];
     const w = node.width ?? meta?.defaultWidth ?? 120;
     const h = node.height ?? meta?.defaultHeight ?? 60;
     const bounds = moddle.create("dc:Bounds", {
-      x: node.position.x,
-      y: node.position.y,
+      x: absolutePositionById.get(node.id)?.x ?? node.position.x,
+      y: absolutePositionById.get(node.id)?.y ?? node.position.y,
       width: w,
       height: h
     });
@@ -2949,6 +3065,24 @@ function buildBpmnDI(moddle, definitions, nodes, edges) {
   });
   definitions.diagrams = [diagram];
 }
+function buildAbsolutePositionMap(nodes) {
+  const nodeById2 = new Map(nodes.map((node) => [node.id, node]));
+  const absoluteById = /* @__PURE__ */ new Map();
+  function resolve(node) {
+    const cached = absoluteById.get(node.id);
+    if (cached) return cached;
+    const parent = node.parentId ? nodeById2.get(node.parentId) : void 0;
+    const parentPosition = parent ? resolve(parent) : { x: 0, y: 0 };
+    const absolute = {
+      x: parentPosition.x + node.position.x,
+      y: parentPosition.y + node.position.y
+    };
+    absoluteById.set(node.id, absolute);
+    return absolute;
+  }
+  for (const node of nodes) resolve(node);
+  return absoluteById;
+}
 async function serializeBpmnXml(nodes, edges, opts = {}) {
   const moddle = new bpmnModdle.BpmnModdle();
   const definitions = buildSemanticModel(moddle, nodes, edges, opts);
@@ -3431,44 +3565,280 @@ function isCompleted(state) {
 function setVariable(state, key, value) {
   return { ...state, variables: { ...state.variables, [key]: value } };
 }
-
-// src/flowable/adapter.ts
-var PreviewAdapter = class {
-  constructor(diagram, initialVariables = {}) {
-    this.diagram = diagram;
-    this.mode = "preview";
-    this.state = createSimulation(diagram, initialVariables);
+function createBpmnNode(options) {
+  const meta = BPMN_ELEMENT_CATALOG[options.elementType];
+  return {
+    id: options.id,
+    type: options.elementType,
+    position: options.position,
+    data: {
+      elementType: options.elementType,
+      ...options.label ? { label: options.label } : {},
+      ...options.data ?? {}
+    },
+    width: options.width ?? meta.defaultWidth,
+    height: options.height ?? meta.defaultHeight,
+    ...options.parentId ? { parentId: options.parentId } : {}
+  };
+}
+function inferBpmnEdgeType(state, sourceId, targetId) {
+  const source = diagramsCore.getNode(state, sourceId);
+  const target = diagramsCore.getNode(state, targetId);
+  if (!source || !target) return "sequenceFlow";
+  if (isDataType(source.data.elementType) || isDataType(target.data.elementType)) {
+    return "dataAssociation";
   }
-  async start(variables) {
-    this.state = tick(this.diagram, createSimulation(this.diagram, variables ?? {}));
-    return this.state;
+  if (source.data.elementType === "Annotation" || target.data.elementType === "Annotation" || source.data.elementType === "Group" || target.data.elementType === "Group") {
+    return "association";
   }
-  async tick() {
-    this.state = tick(this.diagram, this.state);
-    return this.state;
+  if (source.data.elementType === "Conversation" || source.data.elementType === "SubConversation" || source.data.elementType === "CallConversation" || target.data.elementType === "Conversation" || target.data.elementType === "SubConversation" || target.data.elementType === "CallConversation") {
+    return "conversationLink";
   }
-  async fire(elementId, variables) {
-    this.state = fire(this.diagram, this.state, elementId, variables);
-    return this.state;
+  if (source.parentId && target.parentId && source.parentId !== target.parentId) {
+    return "messageFlow";
   }
-  async getFireable() {
-    return getFireable(this.diagram, this.state);
+  return "sequenceFlow";
+}
+function canUseSequenceFlow(type) {
+  const meta = BPMN_ELEMENT_CATALOG[type];
+  return meta.handlePolicy !== "none" && !isDataType(type) && type !== "Annotation" && type !== "Group" && meta.category !== "conversation";
+}
+function validateEdgeCardinality(state, edgeType, source, target) {
+  if (edgeType !== "sequenceFlow") return true;
+  const sourceMax = BPMN_ELEMENT_CATALOG[source.data.elementType].maxOutgoing;
+  const targetMax = BPMN_ELEMENT_CATALOG[target.data.elementType].maxIncoming;
+  const outgoing = diagramsCore.getOutgoingEdges(state, source.id).filter(
+    (edge) => edge.data?.edgeType === "sequenceFlow"
+  );
+  const incoming = diagramsCore.getIncomingEdges(state, target.id).filter(
+    (edge) => edge.data?.edgeType === "sequenceFlow"
+  );
+  if (sourceMax !== void 0 && outgoing.length >= sourceMax) {
+    return `${source.data.elementType} cannot have more than ${sourceMax} outgoing sequence flow(s).`;
   }
-  getState() {
-    return this.state;
+  if (targetMax !== void 0 && incoming.length >= targetMax) {
+    return `${target.data.elementType} cannot have more than ${targetMax} incoming sequence flow(s).`;
   }
-  isCompleted() {
-    return isCompleted(this.state);
+  return true;
+}
+var bpmnConnectionValidators = [
+  ({ state, source, target }) => {
+    if (source.id === target.id) return "BPMN self-connections are not allowed.";
+    const edgeType = inferBpmnEdgeType(state, source.id, target.id);
+    if (getHandlePolicy(source.data.elementType) === "none" || getHandlePolicy(target.data.elementType) === "none") {
+      return "Elements without BPMN connection handles cannot be directly connected.";
+    }
+    if (edgeType === "sequenceFlow") {
+      if (!canUseSequenceFlow(source.data.elementType) || !canUseSequenceFlow(target.data.elementType)) {
+        return "Sequence flows can only connect BPMN flow nodes.";
+      }
+      if (source.data.elementType === "EndEvent") return "End events cannot have outgoing sequence flows.";
+      if (target.data.elementType === "StartEvent") return "Start events cannot have incoming sequence flows.";
+      return validateEdgeCardinality(state, edgeType, source, target);
+    }
+    return true;
   }
-};
-function createPreviewAdapter(diagram, initialVariables) {
-  return new PreviewAdapter(diagram, initialVariables);
+];
+var BPMN_MODELING_RULES = diagramsCore.createModelingRules({
+  connect: [
+    ({ state, source, target }) => {
+      if (!source || !target) return false;
+      for (const validator of bpmnConnectionValidators) {
+        const result = validator({
+          state,
+          source,
+          target,
+          existingEdges: state.edges
+        });
+        if (result !== true) return result;
+      }
+      return true;
+    }
+  ],
+  drop: [
+    ({ node, parent }) => {
+      if (!node || !parent) return true;
+      if (node.data.elementType === "BoundaryEvent") {
+        return acceptsBoundaryEvents(parent.data.elementType) ? true : "Boundary events can only be attached to tasks or subprocesses.";
+      }
+      if (parent.data.elementType === "Pool" || parent.data.elementType === "Lane") {
+        return isEventType(node.data.elementType) || node.data.elementType.includes("Task") || node.data.elementType.includes("Gateway") || node.data.elementType.includes("SubProcess") ? true : "Only flow nodes can be dropped into pools or lanes.";
+      }
+      return true;
+    }
+  ],
+  reparent: [
+    ({ node, parent }) => {
+      if (!node || !parent) return true;
+      if (node.data.elementType === "BoundaryEvent") {
+        return acceptsBoundaryEvents(parent.data.elementType) ? true : "Boundary events can only be reparented to tasks or subprocesses.";
+      }
+      return true;
+    }
+  ],
+  delete: [() => true],
+  resize: [() => true]
+});
+function createBpmnNodeCommand(options) {
+  return {
+    id: `bpmn.createNode.${options.id}`,
+    label: `Create ${options.elementType}`,
+    execute: (state) => diagramsCore.addNode(state, createBpmnNode(options))
+  };
+}
+function connectBpmnCommand(options) {
+  return {
+    id: `bpmn.connect.${options.id ?? `${options.source}-${options.target}`}`,
+    label: "Connect BPMN elements",
+    execute: (state) => {
+      const edgeType = options.edgeType ?? inferBpmnEdgeType(state, options.source, options.target);
+      return diagramsCore.connectNodes(
+        state,
+        {
+          source: options.source,
+          target: options.target,
+          type: edgeType,
+          ...options.sourceHandle !== void 0 ? { sourceHandle: options.sourceHandle } : {},
+          ...options.targetHandle !== void 0 ? { targetHandle: options.targetHandle } : {},
+          ...options.id ? { id: options.id } : {},
+          data: {
+            edgeType,
+            ...options.label ? { label: options.label } : {},
+            ...options.data ?? {}
+          }
+        },
+        bpmnConnectionValidators
+      );
+    }
+  };
+}
+function attachBoundaryEventCommand(boundaryId, hostId) {
+  return {
+    id: `bpmn.attachBoundary.${boundaryId}.${hostId}`,
+    label: "Attach boundary event",
+    execute: (state) => {
+      const host = diagramsCore.getNode(state, hostId);
+      if (!host || !acceptsBoundaryEvents(host.data.elementType)) {
+        throw new Error(`Element "${hostId}" cannot host boundary events.`);
+      }
+      const boundary = diagramsCore.getNode(state, boundaryId);
+      if (!boundary || boundary.data.elementType !== "BoundaryEvent") {
+        throw new Error(`Element "${boundaryId}" is not a boundary event.`);
+      }
+      const reparented = diagramsCore.reparentNode(state, boundaryId, { parentId: hostId });
+      return diagramsCore.patchNode(reparented, boundaryId, {
+        data: { attachedToRef: hostId }
+      });
+    }
+  };
+}
+function replaceBpmnNodeCommand(options) {
+  return {
+    id: `bpmn.replaceNode.${options.id}.${options.elementType}`,
+    label: `Replace with ${options.elementType}`,
+    execute: (state) => {
+      const current = diagramsCore.getNode(state, options.id);
+      if (!current) throw new Error(`Element "${options.id}" does not exist.`);
+      const meta = BPMN_ELEMENT_CATALOG[options.elementType];
+      return diagramsCore.replaceNode(state, options.id, {
+        ...current,
+        type: options.elementType,
+        width: options.width ?? current.width ?? meta.defaultWidth,
+        height: options.height ?? current.height ?? meta.defaultHeight,
+        data: {
+          ...current.data,
+          elementType: options.elementType,
+          ...options.label ? { label: options.label } : {},
+          ...options.data ?? {}
+        }
+      });
+    }
+  };
+}
+function reparentBpmnNodeCommand(options) {
+  return {
+    id: `bpmn.reparent.${options.id}.${options.parentId ?? "root"}`,
+    label: "Reparent BPMN element",
+    execute: (state) => {
+      const node = diagramsCore.getNode(state, options.id);
+      const parent = options.parentId ? diagramsCore.getNode(state, options.parentId) : void 0;
+      if (!node) throw new Error(`Element "${options.id}" does not exist.`);
+      if (parent && node.data.elementType === "BoundaryEvent" && !acceptsBoundaryEvents(parent.data.elementType)) {
+        throw new Error("Boundary events can only be reparented to tasks or subprocesses.");
+      }
+      return diagramsCore.reparentNode(state, options.id, {
+        ...options.parentId !== void 0 ? { parentId: options.parentId } : {},
+        ...options.position ? { position: options.position } : {}
+      });
+    }
+  };
+}
+function resizeBpmnNodeCommand(options) {
+  return {
+    id: `bpmn.resize.${options.id}`,
+    label: "Resize BPMN element",
+    execute: (state) => diagramsCore.resizeNode(state, options.id, options)
+  };
+}
+function deleteBpmnElementsCommand(ids) {
+  return {
+    id: `bpmn.delete.${ids.join(".")}`,
+    label: "Delete BPMN elements",
+    execute: (state) => diagramsCore.removeElements(state, ids)
+  };
+}
+function copyBpmnElements(state, selection) {
+  return diagramsCore.copyElements(state, selection);
+}
+function pasteBpmnElementsCommand(clipboard, options = {}) {
+  return {
+    id: "bpmn.paste",
+    label: "Paste BPMN elements",
+    execute: (state) => diagramsCore.pasteElements(state, clipboard, options)
+  };
+}
+function selectBpmnElementsCommand(selection) {
+  return {
+    id: "bpmn.select",
+    label: "Select BPMN elements",
+    execute: (state) => diagramsCore.setSelection(state, diagramsCore.createSelectionState(selection.nodeIds, selection.edgeIds))
+  };
+}
+function createBpmnDiagramDocument(state, options = {}) {
+  return serialization.createDiagramDocument(diagramsCore.normalizeDiagramState(state), {
+    ...options,
+    diagramType: "bpmn"
+  });
+}
+function serializeBpmnDiagram(state, options = {}) {
+  return serialization.serializeDiagram(diagramsCore.normalizeDiagramState(state), {
+    ...options,
+    diagramType: "bpmn"
+  });
+}
+function parseBpmnDiagramDocument(json) {
+  const document = serialization.parseDiagramDocument(json);
+  if (document.diagramType && document.diagramType !== "bpmn") {
+    throw new Error(`Expected a BPMN diagram document, received "${document.diagramType}".`);
+  }
+  return document;
+}
+function deserializeBpmnDiagram(json) {
+  const document = parseBpmnDiagramDocument(json);
+  return serialization.deserializeDiagram(JSON.stringify(document));
+}
+function runBpmnCommand(stack, command) {
+  return diagramsCore.executeCommand(stack, command);
+}
+function runBpmnCommands(stack, commands, options = {}) {
+  return diagramsCore.executeCommands(stack, commands, options);
 }
 
 exports.AnnotationNode = AnnotationNode;
 exports.AssociationEdge = AssociationEdge;
 exports.BPMN_EDGE_TYPES = BPMN_EDGE_TYPES;
 exports.BPMN_ELEMENT_CATALOG = BPMN_ELEMENT_CATALOG;
+exports.BPMN_MODELING_RULES = BPMN_MODELING_RULES;
 exports.BPMN_NODE_TYPES = BPMN_NODE_TYPES;
 exports.BoundaryEventNode = BoundaryEventNode;
 exports.CallChoreographyNode = CallChoreographyNode;
@@ -3498,13 +3868,22 @@ exports.SubConversationNode = SubConversationNode;
 exports.SubProcessNode = SubProcessNode;
 exports.TaskNode = TaskNode;
 exports.acceptsBoundaryEvents = acceptsBoundaryEvents;
-exports.createPreviewAdapter = createPreviewAdapter;
+exports.attachBoundaryEventCommand = attachBoundaryEventCommand;
+exports.bpmnConnectionValidators = bpmnConnectionValidators;
+exports.connectBpmnCommand = connectBpmnCommand;
+exports.copyBpmnElements = copyBpmnElements;
+exports.createBpmnDiagramDocument = createBpmnDiagramDocument;
+exports.createBpmnNode = createBpmnNode;
+exports.createBpmnNodeCommand = createBpmnNodeCommand;
 exports.createSimulation = createSimulation;
+exports.deleteBpmnElementsCommand = deleteBpmnElementsCommand;
+exports.deserializeBpmnDiagram = deserializeBpmnDiagram;
 exports.fire = fire;
 exports.getElementMeta = getElementMeta;
 exports.getFireable = getFireable;
 exports.getHandlePolicy = getHandlePolicy;
 exports.getOrientation = getOrientation;
+exports.inferBpmnEdgeType = inferBpmnEdgeType;
 exports.isChoreographyType = isChoreographyType;
 exports.isCompleted = isCompleted;
 exports.isContainerType = isContainerType;
@@ -3513,7 +3892,16 @@ exports.isDataType = isDataType;
 exports.isEventType = isEventType;
 exports.isGatewayType = isGatewayType;
 exports.isTaskType = isTaskType;
+exports.parseBpmnDiagramDocument = parseBpmnDiagramDocument;
 exports.parseBpmnXml = parseBpmnXml;
+exports.pasteBpmnElementsCommand = pasteBpmnElementsCommand;
+exports.reparentBpmnNodeCommand = reparentBpmnNodeCommand;
+exports.replaceBpmnNodeCommand = replaceBpmnNodeCommand;
+exports.resizeBpmnNodeCommand = resizeBpmnNodeCommand;
+exports.runBpmnCommand = runBpmnCommand;
+exports.runBpmnCommands = runBpmnCommands;
+exports.selectBpmnElementsCommand = selectBpmnElementsCommand;
+exports.serializeBpmnDiagram = serializeBpmnDiagram;
 exports.serializeBpmnXml = serializeBpmnXml;
 exports.setVariable = setVariable;
 exports.supportsCollapse = supportsCollapse;