@aranzatech/diagrams-bpmn 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## Unreleased
+
+- Expanded BPMN modeling helpers on top of the new `diagrams-core` primitives.
+- Added BPMN node factory, edge-type inference and BPMN document serialization helpers.
+- Added replace, resize, reparent, select, copy/paste and batch-command helpers.
+- Improved BPMN connection rules to allow subprocesses as flow nodes while blocking pools/lanes/artifacts without handles.
+- Added sequence-flow cardinality checks based on the BPMN element catalog.
+- Boundary attachment now updates both `parentId` and BPMN `attachedToRef` data.
+
+## 0.2.1
+
+- Added BPMN modeling helpers built on `@aranzatech/diagrams-core` commands and rules.
+- Added public `@aranzatech/diagrams-bpmn/modeling` subpath.
+- Improved XML roundtrip for default sequence flows, boundary event attachment,
+  non-interrupting boundary events, documentation and parent-relative coordinates.
+- Removed Flowable adapter exports from the root public API; Flowable integration
+  is planned as a separate wrapper concern.
+- Added README coverage matrix and stable-scope notes.

package/README.md

@@ -0,0 +1,121 @@
+# @aranzatech/diagrams-bpmn
+
+BPMN 2.0 building blocks for the Aranza diagram ecosystem. This package owns
+BPMN-specific visual components, element metadata, BPMN modeling helpers, XML
+import/export and preview token simulation.
+
+It is intentionally not responsible for execution-engine communication. Flowable
+integration belongs in a future wrapper package or in the consuming app backend.
+
+## Public Subpaths
+
+```ts
+import { BPMN_NODE_TYPES } from "@aranzatech/diagrams-bpmn/nodes";
+import { BPMN_EDGE_TYPES } from "@aranzatech/diagrams-bpmn/edges";
+import { BPMN_ELEMENT_CATALOG } from "@aranzatech/diagrams-bpmn/elements";
+import { parseBpmnXml, serializeBpmnXml } from "@aranzatech/diagrams-bpmn/xml";
+import {
+  createBpmnNodeCommand,
+  replaceBpmnNodeCommand,
+  serializeBpmnDiagram,
+} from "@aranzatech/diagrams-bpmn/modeling";
+import { createSimulation } from "@aranzatech/diagrams-bpmn/simulation";
+```
+
+## Scope
+
+- BPMN visual node and edge renderers for ReactFlow.
+- BPMN element catalog and guards.
+- BPMN XML import/export through `bpmn-moddle`.
+- BPMN modeling commands and interaction rules on top of `diagrams-core`.
+- Client-side preview token simulation.
+
+## Out Of Scope
+
+- Flowable REST/backend communication.
+- BPMN business validation rules. Those belong in `@aranzatech/flowslint`.
+- Full execution semantics.
+
+## Coverage Matrix
+
+| Area | Status | Notes |
+|---|---:|---|
+| Events | Partial | Start, end, intermediate catch/throw, boundary; common triggers rendered/imported. |
+| Tasks | Partial | Task variants and call activity rendered; advanced task semantics still need richer XML mapping. |
+| Gateways | Good | Exclusive, inclusive, parallel, event-based and complex rendered. |
+| Containers | Partial | Pool, lane, subprocess, transaction, event subprocess and ad-hoc subprocess rendered; lane resizing/modeling still needs depth. |
+| Artifacts | Partial | Text annotation and group rendered; association semantics are basic. |
+| Data | Partial | Data object/input/output/store and refs rendered; full item definitions/data states pending. |
+| Conversation | Partial | Conversation nodes and links rendered; full conversation model pending. |
+| Choreography | Partial | Choreography nodes rendered; participant semantics are lightweight. |
+| XML import/export | Partial | Basic BPMN + DI, default flows, boundary attachment, docs and relative child coordinates; full lossless roundtrip pending. |
+| Modeling | Growing | Commands and rules for create/connect/attach/delete/replace/resize/reparent/copy/paste; palette/context-pad/auto-place can build on this. |
+| Simulation | Preview | Useful design-time token simulation, not an execution engine. |
+
+## Modeling Example
+
+```ts
+import { createCommandStackState } from "@aranzatech/diagrams-core/commands";
+import {
+  createBpmnNodeCommand,
+  connectBpmnCommand,
+  replaceBpmnNodeCommand,
+  runBpmnCommands,
+  runBpmnCommand,
+} from "@aranzatech/diagrams-bpmn/modeling";
+
+let stack = createCommandStackState({ nodes: [], edges: [] });
+
+stack = runBpmnCommand(
+  stack,
+  createBpmnNodeCommand({
+    id: "task_1",
+    elementType: "Task",
+    position: { x: 100, y: 100 },
+    label: "Review request",
+  }),
+);
+
+stack = runBpmnCommand(
+  stack,
+  connectBpmnCommand({
+    source: "start_1",
+    target: "task_1",
+  }),
+);
+
+stack = runBpmnCommands(
+  stack,
+  [
+    replaceBpmnNodeCommand({
+      id: "task_1",
+      elementType: "UserTask",
+      label: "Human review",
+    }),
+  ],
+  { id: "review-as-user-task" },
+);
+```
+
+## BPMN Diagram Document Example
+
+```ts
+import {
+  deserializeBpmnDiagram,
+  serializeBpmnDiagram,
+} from "@aranzatech/diagrams-bpmn/modeling";
+
+const json = serializeBpmnDiagram(stack.current, {
+  metadata: { source: "designer" },
+});
+
+const restored = deserializeBpmnDiagram(json);
+```
+
+## Road To Stable
+
+- Expand XML to preserve more BPMN semantics losslessly.
+- Add real-world XML fixtures from bpmn.io/Camunda/Flowable modelers.
+- Add palette/context-pad and auto-place commands on top of the current modeling API.
+- Add robust lane/pool resize and reparent behavior.
+- Move engine-specific extensions to a dedicated package.

package/dist/catalog-OVnBDD8R.d.ts

@@ -0,0 +1,9 @@
+import { e as BpmnElementType, c as BpmnElementMeta, d as BpmnElementSize } from './types-DznxZxpV.js';
+
+declare const BPMN_ELEMENT_CATALOG: Record<BpmnElementType, BpmnElementMeta>;
+declare function getElementMeta(type: BpmnElementType): BpmnElementMeta;
+declare const BPMN_RESIZABLE_ELEMENT_TYPES: ("Task" | "UserTask" | "ServiceTask" | "ScriptTask" | "ManualTask" | "BusinessRuleTask" | "ReceiveTask" | "SendTask" | "CallActivity" | "SubProcess" | "Transaction" | "AdHocSubProcess" | "EventSubProcess" | "Pool" | "Lane" | "Annotation" | "Group" | "SubConversation" | "ChoreographyTask" | "SubChoreography" | "CallChoreography")[];
+declare function isBpmnElementResizable(type: BpmnElementType): boolean;
+declare function getBpmnElementSize(type: BpmnElementType): BpmnElementSize;
+
+export { BPMN_ELEMENT_CATALOG as B, BPMN_RESIZABLE_ELEMENT_TYPES as a, getElementMeta as b, getBpmnElementSize as g, isBpmnElementResizable as i };

package/dist/catalog-OWfI_yHU.d.cts

@@ -0,0 +1,9 @@
+import { e as BpmnElementType, c as BpmnElementMeta, d as BpmnElementSize } from './types-DznxZxpV.cjs';
+
+declare const BPMN_ELEMENT_CATALOG: Record<BpmnElementType, BpmnElementMeta>;
+declare function getElementMeta(type: BpmnElementType): BpmnElementMeta;
+declare const BPMN_RESIZABLE_ELEMENT_TYPES: ("Task" | "UserTask" | "ServiceTask" | "ScriptTask" | "ManualTask" | "BusinessRuleTask" | "ReceiveTask" | "SendTask" | "CallActivity" | "SubProcess" | "Transaction" | "AdHocSubProcess" | "EventSubProcess" | "Pool" | "Lane" | "Annotation" | "Group" | "SubConversation" | "ChoreographyTask" | "SubChoreography" | "CallChoreography")[];
+declare function isBpmnElementResizable(type: BpmnElementType): boolean;
+declare function getBpmnElementSize(type: BpmnElementType): BpmnElementSize;
+
+export { BPMN_ELEMENT_CATALOG as B, BPMN_RESIZABLE_ELEMENT_TYPES as a, getElementMeta as b, getBpmnElementSize as g, isBpmnElementResizable as i };

package/dist/{chunk-W3ROOC6E.js → chunk-33AR3PXF.js}

@@ -1,4 +1,4 @@
-import { BPMN_ELEMENT_CATALOG } from './chunk-DNR5WBQH.js';
+import { BPMN_ELEMENT_CATALOG } from './chunk-L5Z22RLX.js';
 import { BpmnModdle } from 'bpmn-moddle';
 
 // src/xml/mapper.ts
@@ -23,8 +23,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",
@@ -62,6 +62,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",
@@ -126,6 +129,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();
@@ -181,6 +188,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";
 }
@@ -194,7 +202,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;
@@ -215,22 +223,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,
@@ -251,10 +263,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);
@@ -355,7 +369,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}`;
@@ -363,19 +416,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;
@@ -434,13 +474,32 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
   return definitions;
 }
 function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId) {
-  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");
+  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 belongsToPool = (node) => {
+    let parentId = node.parentId;
+    while (parentId) {
+      if (parentId === poolId) return true;
+      parentId = allNodes.find((candidate) => candidate.id === parentId)?.parentId;
+    }
+    return false;
+  };
+  const myNodes = (poolId ? allNodes.filter((n) => belongsToPool(n)) : 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));
@@ -451,6 +510,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,
@@ -471,7 +541,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];
@@ -480,25 +550,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 isSubProcess = elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess";
+  if (isSubProcess) {
+    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];
@@ -509,6 +600,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
@@ -519,13 +615,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
     });
@@ -540,9 +637,9 @@ function buildBpmnDI(moddle, definitions, nodes, edges) {
     shapes.push(shape);
   }
   for (const edge of edges) {
-    const waypoints = edge.data?.routingPoints?.map(
+    const waypoints = resolveEdgeWaypoints(edge, nodes, absolutePositionById).map(
       (p) => moddle.create("dc:Point", { x: p.x, y: p.y })
-    ) ?? [];
+    );
     edgeShapes.push(
       moddle.create("bpmndi:BPMNEdge", {
         id: uid("BPMNEdge", edge.id),
@@ -564,6 +661,46 @@ function buildBpmnDI(moddle, definitions, nodes, edges) {
   });
   definitions.diagrams = [diagram];
 }
+function resolveEdgeWaypoints(edge, nodes, absolutePositionById) {
+  if (edge.data?.routingPoints && edge.data.routingPoints.length >= 2) {
+    return edge.data.routingPoints;
+  }
+  const source = nodes.find((node) => node.id === edge.source);
+  const target = nodes.find((node) => node.id === edge.target);
+  if (!source || !target) return [];
+  const sourceMeta = BPMN_ELEMENT_CATALOG[source.data.elementType];
+  const targetMeta = BPMN_ELEMENT_CATALOG[target.data.elementType];
+  const sourcePosition = absolutePositionById.get(source.id) ?? source.position;
+  const targetPosition = absolutePositionById.get(target.id) ?? target.position;
+  return [
+    {
+      x: sourcePosition.x + (source.width ?? sourceMeta.defaultWidth) / 2,
+      y: sourcePosition.y + (source.height ?? sourceMeta.defaultHeight) / 2
+    },
+    {
+      x: targetPosition.x + (target.width ?? targetMeta.defaultWidth) / 2,
+      y: targetPosition.y + (target.height ?? targetMeta.defaultHeight) / 2
+    }
+  ];
+}
+function buildAbsolutePositionMap(nodes) {
+  const nodeById = 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 ? nodeById.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();
   const definitions = buildSemanticModel(moddle, nodes, edges, opts);
@@ -575,5 +712,5 @@ async function serializeBpmnXml(nodes, edges, opts = {}) {
 }
 
 export { parseBpmnXml, serializeBpmnXml };
-//# sourceMappingURL=chunk-W3ROOC6E.js.map
-//# sourceMappingURL=chunk-W3ROOC6E.js.map
+//# sourceMappingURL=chunk-33AR3PXF.js.map
+//# sourceMappingURL=chunk-33AR3PXF.js.map