@aranzatech/diagrams-bpmn 0.1.3 → 0.2.0

package/dist/nodes/index.js

@@ -1,4 +1,4 @@
-export { AnnotationNode, BPMN_NODE_TYPES, BoundaryEventNode, CallChoreographyNode, CallConversationNode, ChoreographyTaskNode, ConversationNode, DataInputNode, DataObjectNode, DataObjectReferenceNode, DataOutputNode, DataStoreNode, DataStoreReferenceNode, EndEventNode, GatewayNode, GroupNode, IntermediateCatchEventNode, IntermediateThrowEventNode, LaneNode, PoolNode, StartEventNode, SubChoreographyNode, SubConversationNode, SubProcessNode, TaskNode } from '../chunk-NXMUX67A.js';
+export { AnnotationNode, BPMN_NODE_TYPES, BoundaryEventNode, CallChoreographyNode, CallConversationNode, ChoreographyTaskNode, ConversationNode, DataInputNode, DataObjectNode, DataObjectReferenceNode, DataOutputNode, DataStoreNode, DataStoreReferenceNode, EndEventNode, GatewayNode, GroupNode, IntermediateCatchEventNode, IntermediateThrowEventNode, LaneNode, PoolNode, StartEventNode, SubChoreographyNode, SubConversationNode, SubProcessNode, TaskNode } from '../chunk-S3GGEEA5.js';
 import '../chunk-23B2IGK5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{types-C78d_Kdh.d.cts → types-BKA0GZz5.d.cts}

@@ -51,6 +51,10 @@ interface BpmnNodeData extends Record<string, unknown> {
     trigger?: EventTrigger;
     /** True for non-interrupting boundary events / event sub-process starts. */
     isNonInterrupting?: boolean;
+    /** BoundaryEvent only: BPMN element id this boundary event is attached to. */
+    attachedToRef?: string;
+    /** Raw BPMN documentation text. */
+    documentation?: string;
     /** Task instance markers shown at the bottom of the task box. */
     markers?: TaskMarker[];
     /** Sub-process structural variant (defaults to "embedded"). */
@@ -76,24 +80,6 @@ interface BpmnNodeData extends Record<string, unknown> {
     owner?: string;
     /** ISO 8601 duration, e.g. "PT4H". */
     sla?: string;
-    /** flowable:assignee — UEL expression or static user id. */
-    flowableAssignee?: string;
-    /** flowable:candidateGroups — comma-separated group ids or UEL expression. */
-    flowableCandidateGroups?: string;
-    /** flowable:candidateUsers — comma-separated user ids or UEL expression. */
-    flowableCandidateUsers?: string;
-    /** flowable:formKey — form definition key (for UserTask / StartEvent). */
-    flowableFormKey?: string;
-    /** flowable:dueDate — UEL expression resolving to a Date. */
-    flowableDueDate?: string;
-    /** flowable:type — service task type: "http" | "mail" | "camel" | "mule". */
-    flowableType?: string;
-    /** flowable:expression — UEL expression for ServiceTask / SequenceFlow. */
-    flowableExpression?: string;
-    /** flowable:class — fully-qualified Java class name for ServiceTask. */
-    flowableClass?: string;
-    /** flowable:delegateExpression — UEL expression resolving to a JavaDelegate. */
-    flowableDelegateExpression?: string;
 }
 interface BpmnEdgeData extends Record<string, unknown> {
     label?: string;
@@ -101,6 +87,8 @@ interface BpmnEdgeData extends Record<string, unknown> {
     conditionExpression?: string;
     /** Sequence flow marked as the default path of a gateway/activity. */
     isDefault?: boolean;
+    /** Raw BPMN documentation text. */
+    documentation?: string;
     /** Directionality for associations. */
     associationDirection?: "none" | "one" | "both";
     /** Routing points produced by ELK. */

package/dist/{types-C78d_Kdh.d.ts → types-BKA0GZz5.d.ts}

@@ -51,6 +51,10 @@ interface BpmnNodeData extends Record<string, unknown> {
     trigger?: EventTrigger;
     /** True for non-interrupting boundary events / event sub-process starts. */
     isNonInterrupting?: boolean;
+    /** BoundaryEvent only: BPMN element id this boundary event is attached to. */
+    attachedToRef?: string;
+    /** Raw BPMN documentation text. */
+    documentation?: string;
     /** Task instance markers shown at the bottom of the task box. */
     markers?: TaskMarker[];
     /** Sub-process structural variant (defaults to "embedded"). */
@@ -76,24 +80,6 @@ interface BpmnNodeData extends Record<string, unknown> {
     owner?: string;
     /** ISO 8601 duration, e.g. "PT4H". */
     sla?: string;
-    /** flowable:assignee — UEL expression or static user id. */
-    flowableAssignee?: string;
-    /** flowable:candidateGroups — comma-separated group ids or UEL expression. */
-    flowableCandidateGroups?: string;
-    /** flowable:candidateUsers — comma-separated user ids or UEL expression. */
-    flowableCandidateUsers?: string;
-    /** flowable:formKey — form definition key (for UserTask / StartEvent). */
-    flowableFormKey?: string;
-    /** flowable:dueDate — UEL expression resolving to a Date. */
-    flowableDueDate?: string;
-    /** flowable:type — service task type: "http" | "mail" | "camel" | "mule". */
-    flowableType?: string;
-    /** flowable:expression — UEL expression for ServiceTask / SequenceFlow. */
-    flowableExpression?: string;
-    /** flowable:class — fully-qualified Java class name for ServiceTask. */
-    flowableClass?: string;
-    /** flowable:delegateExpression — UEL expression resolving to a JavaDelegate. */
-    flowableDelegateExpression?: string;
 }
 interface BpmnEdgeData extends Record<string, unknown> {
     label?: string;
@@ -101,6 +87,8 @@ interface BpmnEdgeData extends Record<string, unknown> {
     conditionExpression?: string;
     /** Sequence flow marked as the default path of a gateway/activity. */
     isDefault?: boolean;
+    /** Raw BPMN documentation text. */
+    documentation?: string;
     /** Directionality for associations. */
     associationDirection?: "none" | "one" | "both";
     /** Routing points produced by ELK. */

package/dist/types-CCkHqtC_.d.cts

@@ -0,0 +1,20 @@
+import { Node, Edge } from '@xyflow/react';
+import { g as BpmnNodeData, a as BpmnEdgeData } from './types-BKA0GZz5.cjs';
+
+type BpmnRFNode = Node<BpmnNodeData>;
+type BpmnRFEdge = Edge<BpmnEdgeData>;
+interface BpmnImportResult {
+    nodes: BpmnRFNode[];
+    edges: BpmnRFEdge[];
+    warnings: string[];
+}
+interface BpmnExportOptions {
+    /** Diagram name written into the XML. */
+    name?: string;
+    /** Definitions element id. Defaults to "Definitions_1". */
+    id?: string;
+    /** Pretty-print the XML output. Defaults to true. */
+    format?: boolean;
+}
+
+export type { BpmnExportOptions as B, BpmnImportResult as a, BpmnRFEdge as b, BpmnRFNode as c };

package/dist/types-hj621ZRJ.d.ts

@@ -0,0 +1,20 @@
+import { Node, Edge } from '@xyflow/react';
+import { g as BpmnNodeData, a as BpmnEdgeData } from './types-BKA0GZz5.js';
+
+type BpmnRFNode = Node<BpmnNodeData>;
+type BpmnRFEdge = Edge<BpmnEdgeData>;
+interface BpmnImportResult {
+    nodes: BpmnRFNode[];
+    edges: BpmnRFEdge[];
+    warnings: string[];
+}
+interface BpmnExportOptions {
+    /** Diagram name written into the XML. */
+    name?: string;
+    /** Definitions element id. Defaults to "Definitions_1". */
+    id?: string;
+    /** Pretty-print the XML output. Defaults to true. */
+    format?: boolean;
+}
+
+export type { BpmnExportOptions as B, BpmnImportResult as a, BpmnRFEdge as b, BpmnRFNode as c };

package/dist/xml/index.cjs

@@ -592,8 +592,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",
@@ -631,6 +631,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",
@@ -695,6 +698,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();
@@ -750,6 +757,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";
 }
@@ -763,7 +771,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;
@@ -784,22 +792,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,
@@ -820,10 +832,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);
@@ -924,7 +938,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}`;
@@ -932,19 +985,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;
@@ -1003,13 +1043,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));
@@ -1020,6 +1073,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,
@@ -1040,7 +1104,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];
@@ -1049,25 +1113,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];
@@ -1078,6 +1163,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
@@ -1088,13 +1178,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
     });
@@ -1133,6 +1224,24 @@ function buildBpmnDI(moddle, definitions, nodes, edges) {
   });
   definitions.diagrams = [diagram];
 }
+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.BpmnModdle();
   const definitions = buildSemanticModel(moddle, nodes, edges, opts);