@aranzatech/diagrams-bpmn 0.2.11 → 0.2.13

package/dist/xml/index.cjs

@@ -26,7 +26,29 @@ var ARANZA_DESCRIPTOR = {
         { name: "formKey", isAttr: true, type: "String" },
         // UserTask: Flowable task assignment — comma-separated ids
         { name: "candidateUsers", isAttr: true, type: "String" },
-        { name: "candidateGroups", isAttr: true, type: "String" }
+        { name: "candidateGroups", isAttr: true, type: "String" },
+        // UserTask: scheduling + skip expression
+        { name: "dueDate", isAttr: true, type: "String" },
+        { name: "skipExpression", isAttr: true, type: "String" },
+        { name: "businessCalendarName", isAttr: true, type: "String" }
+      ]
+    },
+    {
+      // BusinessRuleTask: simplified inline decision table (JSON-serialized)
+      name: "InlineDecision",
+      superClass: ["Element"],
+      properties: [
+        { name: "hitPolicy", isAttr: true, type: "String" },
+        { name: "tableJson", isAttr: true, type: "String" }
+      ]
+    },
+    {
+      // MessageFlow: payload schema + correlation key for executable BPMN
+      name: "MessageFlowConfig",
+      superClass: ["Element"],
+      properties: [
+        { name: "payloadSchema", isAttr: true, type: "String" },
+        { name: "correlationKey", isAttr: true, type: "String" }
       ]
     }
   ],
@@ -907,7 +929,20 @@ function extractAranzaExtensions(el) {
   }
   const ext = el.extensionElements;
   if (!ext) return result;
-  const taskConfig = asElements(ext.values).find((v) => v.$type === "aranza:TaskConfig");
+  const extValues = asElements(ext.values);
+  const inlineDecision = extValues.find((v) => v.$type === "aranza:InlineDecision");
+  if (inlineDecision) {
+    const hitPolicy = asString(inlineDecision.hitPolicy) ?? "UNIQUE";
+    const tableJson = asString(inlineDecision.tableJson);
+    if (tableJson) {
+      try {
+        const parsed = JSON.parse(tableJson);
+        result.inlineDecisionTable = { hitPolicy, ...parsed };
+      } catch {
+      }
+    }
+  }
+  const taskConfig = extValues.find((v) => v.$type === "aranza:TaskConfig");
   if (!taskConfig) return result;
   const priority = asString(taskConfig.priority);
   if (priority === "critical" || priority === "high" || priority === "medium" || priority === "low") {
@@ -933,6 +968,12 @@ function extractAranzaExtensions(el) {
   if (candidateUsers) result.candidateUsers = candidateUsers;
   const candidateGroups = asString(taskConfig.candidateGroups);
   if (candidateGroups) result.candidateGroups = candidateGroups;
+  const dueDate = asString(taskConfig.dueDate);
+  if (dueDate) result.dueDate = dueDate;
+  const skipExpression = asString(taskConfig.skipExpression);
+  if (skipExpression) result.skipExpression = skipExpression;
+  const businessCalendarName = asString(taskConfig.businessCalendarName);
+  if (businessCalendarName) result.businessCalendarName = businessCalendarName;
   return result;
 }
 function extractCompletionCondition(el) {
@@ -941,6 +982,25 @@ function extractCompletionCondition(el) {
   if (typeof cc === "string") return cc.trim() || void 0;
   return asString(cc.body);
 }
+function extractLoopCharacteristics(el) {
+  const lc = el.loopCharacteristics;
+  if (!lc) return {};
+  if (lc.$type === "bpmn:StandardLoopCharacteristics") {
+    const loopCondition = asString(lc.loopCondition?.body);
+    return { loopType: "loop", ...loopCondition ? { loopCondition } : {} };
+  }
+  if (lc.$type === "bpmn:MultiInstanceLoopCharacteristics") {
+    const loopType = lc.isSequential === true ? "sequentialMultiple" : "parallelMultiple";
+    const loopCardinality = asString(lc.loopCardinality?.body);
+    const loopCompletionCondition = asString(lc.completionCondition?.body);
+    return {
+      loopType,
+      ...loopCardinality ? { loopCardinality } : {},
+      ...loopCompletionCondition ? { loopCompletionCondition } : {}
+    };
+  }
+  return {};
+}
 function walkFlowElements(elements, parentId, ctx, nodes, edges) {
   for (const el of elements) {
     const { $type, id } = el;
@@ -958,7 +1018,7 @@ function walkFlowElements(elements, parentId, ctx, nodes, edges) {
     }
     buildNode(el, elementType, parentId, ctx, nodes);
     if ($type === "bpmn:SubProcess" || $type === "bpmn:Transaction" || $type === "bpmn:AdHocSubProcess") {
-      const children = asElements(el.flowElements);
+      const children = [...asElements(el.flowElements), ...asElements(el.artifacts)];
       const laneMembership = extractLaneMembership(el);
       walkFlowElements(children, id, { ...ctx, laneMembership }, nodes, edges);
     }
@@ -971,7 +1031,7 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
   const x = shape?.x ?? ctx.autoX.value;
   const y = shape?.y ?? 100;
   if (!shape) ctx.autoX.value += (meta?.defaultWidth ?? 120) + 20;
-  const label = asString(el.name);
+  const label = elementType === "Annotation" ? asString(el.text) ?? asString(el.name) : asString(el.name);
   const documentation = extractDocumentation(el);
   const trigger = extractTrigger(el);
   const eventDefinition = extractEventDefinition(el);
@@ -982,6 +1042,8 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
   const scriptFormat = elementType === "ScriptTask" ? asString(el.scriptFormat) : void 0;
   const script = elementType === "ScriptTask" ? asString(el.script) : void 0;
   const completionCondition = elementType === "AdHocSubProcess" ? extractCompletionCondition(el) : void 0;
+  const loopChars = extractLoopCharacteristics(el);
+  const dataObjectRef = elementType === "DataObjectReference" ? asString(el.dataObjectRef?.id) : void 0;
   const data = {
     elementType,
     ...label ? { label } : {},
@@ -1002,6 +1064,8 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
     ...scriptFormat ? { scriptFormat } : {},
     ...script ? { script } : {},
     ...completionCondition ? { completionCondition } : {},
+    ...dataObjectRef ? { dataObjectRef } : {},
+    ...loopChars,
     ...aranzaExt
   };
   if (elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess") {
@@ -1034,11 +1098,28 @@ function buildEdge(el, edgeType, ctx, edges) {
   const label = asString(el.name);
   const documentation = extractDocumentation(el);
   const condExpr = el.conditionExpression;
+  const rawDir = asString(el.associationDirection);
+  const associationDirection = edgeType === "association" && rawDir ? rawDir.toLowerCase() : void 0;
+  let payloadSchema;
+  let correlationKey;
+  if (edgeType === "messageFlow") {
+    const mfExt = el.extensionElements;
+    if (mfExt) {
+      const mfConfig = asElements(mfExt.values).find((v) => v.$type === "aranza:MessageFlowConfig");
+      if (mfConfig) {
+        payloadSchema = asString(mfConfig.payloadSchema) || void 0;
+        correlationKey = asString(mfConfig.correlationKey) || void 0;
+      }
+    }
+  }
   const data = {
     edgeType,
     ...label ? { label } : {},
     ...documentation ? { documentation } : {},
-    ...condExpr?.body ? { conditionExpression: condExpr.body } : {}
+    ...condExpr?.body ? { conditionExpression: condExpr.body } : {},
+    ...associationDirection ? { associationDirection } : {},
+    ...payloadSchema ? { payloadSchema } : {},
+    ...correlationKey ? { correlationKey } : {}
   };
   const waypoints = ctx.waypoints.get(id);
   if (waypoints?.length) data.routingPoints = waypoints;
@@ -1063,7 +1144,7 @@ function handleCollaboration(collaboration, ctx, nodes, edges) {
     if (processRef) {
       const laneMembership = extractLaneMembership(processRef);
       walkFlowElements(
-        asElements(processRef.flowElements),
+        [...asElements(processRef.flowElements), ...asElements(processRef.artifacts)],
         id,
         { ...ctx, laneMembership },
         nodes,
@@ -1095,7 +1176,7 @@ function addLaneNodes(laneSet, poolId, ctx, nodes) {
       data: { elementType: "Lane", ...label ? { label } : {} },
       width: shape?.width ?? 570,
       height: shape?.height ?? 120,
-      parentId: poolId
+      ...poolId ? { parentId: poolId } : {}
     });
     const child = lane.childLaneSet;
     if (child) addLaneNodes(child, poolId, ctx, nodes);
@@ -1129,9 +1210,9 @@ async function parseBpmnXml(xml) {
     } else if (rootEl.$type === "bpmn:Process") {
       const laneMembership = extractLaneMembership(rootEl);
       const laneSet = rootEl.laneSet;
-      if (laneSet) addLaneNodes(laneSet, "", ctx, nodes);
+      if (laneSet) addLaneNodes(laneSet, void 0, ctx, nodes);
       walkFlowElements(
-        asElements(rootEl.flowElements),
+        [...asElements(rootEl.flowElements), ...asElements(rootEl.artifacts)],
         void 0,
         { ...ctx, laneMembership },
         nodes,
@@ -1304,7 +1385,10 @@ function buildAranzaExtensionElements(moddle, node) {
   const formKey = typeof node.data.formKey === "string" ? node.data.formKey : void 0;
   const candidateUsers = typeof node.data.candidateUsers === "string" ? node.data.candidateUsers : void 0;
   const candidateGroups = typeof node.data.candidateGroups === "string" ? node.data.candidateGroups : void 0;
-  if (!priority && !owner && !sla && !connector && !action && !flowableType && !flowableDelegateExpression && !decisionRef && !formKey && !candidateUsers && !candidateGroups) {
+  const dueDate = typeof node.data.dueDate === "string" ? node.data.dueDate : void 0;
+  const skipExpression = typeof node.data.skipExpression === "string" ? node.data.skipExpression : void 0;
+  const businessCalendarName = typeof node.data.businessCalendarName === "string" ? node.data.businessCalendarName : void 0;
+  if (!priority && !owner && !sla && !connector && !action && !flowableType && !flowableDelegateExpression && !decisionRef && !formKey && !candidateUsers && !candidateGroups && !dueDate && !skipExpression && !businessCalendarName) {
     return null;
   }
   const configAttrs = {};
@@ -1319,9 +1403,24 @@ function buildAranzaExtensionElements(moddle, node) {
   if (formKey) configAttrs.formKey = formKey;
   if (candidateUsers) configAttrs.candidateUsers = candidateUsers;
   if (candidateGroups) configAttrs.candidateGroups = candidateGroups;
-  const taskConfig = moddle.create("aranza:TaskConfig", configAttrs);
-  return moddle.create("bpmn:ExtensionElements", { values: [taskConfig] });
+  if (dueDate) configAttrs.dueDate = dueDate;
+  if (skipExpression) configAttrs.skipExpression = skipExpression;
+  if (businessCalendarName) configAttrs.businessCalendarName = businessCalendarName;
+  const values = [moddle.create("aranza:TaskConfig", configAttrs)];
+  const inlineDecisionTable = node.data.inlineDecisionTable;
+  if (inlineDecisionTable && typeof inlineDecisionTable === "object") {
+    const tbl = inlineDecisionTable;
+    const { hitPolicy, ...rest } = tbl;
+    values.push(
+      moddle.create("aranza:InlineDecision", {
+        hitPolicy: hitPolicy ?? "UNIQUE",
+        tableJson: JSON.stringify(rest)
+      })
+    );
+  }
+  return moddle.create("bpmn:ExtensionElements", { values });
 }
+var ARTIFACT_ELEMENT_TYPES = /* @__PURE__ */ new Set(["Annotation", "Group"]);
 function buildSemanticModel(moddle, nodes, edges, opts) {
   const defId = opts.id ?? "Definitions_1";
   const defName = opts.name;
@@ -1356,14 +1455,24 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
     }
     const messageFlowEdges = edges.filter((e) => e.data?.edgeType === "messageFlow");
     const conversationLinkEdges = edges.filter((e) => e.data?.edgeType === "conversationLink");
-    const messageFlows = messageFlowEdges.map(
-      (e) => moddle.create("bpmn:MessageFlow", {
+    const messageFlows = messageFlowEdges.map((e) => {
+      const ps = typeof e.data?.payloadSchema === "string" ? e.data.payloadSchema : void 0;
+      const ck = typeof e.data?.correlationKey === "string" ? e.data.correlationKey : void 0;
+      const mfAttrs = {
         id: e.id,
         name: e.data?.label ?? "",
         sourceRef: { id: e.source },
         targetRef: { id: e.target }
-      })
-    );
+      };
+      if (ps || ck) {
+        const cfg = moddle.create("aranza:MessageFlowConfig", {
+          ...ps ? { payloadSchema: ps } : {},
+          ...ck ? { correlationKey: ck } : {}
+        });
+        mfAttrs.extensionElements = moddle.create("bpmn:ExtensionElements", { values: [cfg] });
+      }
+      return moddle.create("bpmn:MessageFlow", mfAttrs);
+    });
     const conversationLinks = conversationLinkEdges.map(
       (e) => moddle.create("bpmn:ConversationLink", {
         id: e.id,
@@ -1417,10 +1526,31 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId,
   };
   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 presentDataObjectIds = new Set(
+    myNodes.filter((n) => n.data.elementType === "DataObject").map((n) => n.id)
+  );
   const flowElements = [];
+  const artifacts = [];
+  for (const node of myNodes) {
+    if (node.data.elementType === "DataObjectReference") {
+      const explicitRef = typeof node.data.dataObjectRef === "string" ? node.data.dataObjectRef : null;
+      if (!explicitRef || !presentDataObjectIds.has(explicitRef)) {
+        const syntheticId = `DataObject_${node.id}`;
+        if (!presentDataObjectIds.has(syntheticId)) {
+          flowElements.push(moddle.create("bpmn:DataObject", { id: syntheticId }));
+          presentDataObjectIds.add(syntheticId);
+        }
+      }
+    }
+  }
   for (const node of myNodes) {
     const el = buildFlowElement(moddle, node, allNodes, allEdges);
-    if (el) flowElements.push(el);
+    if (!el) continue;
+    if (ARTIFACT_ELEMENT_TYPES.has(node.data.elementType)) {
+      artifacts.push(el);
+    } else {
+      flowElements.push(el);
+    }
   }
   const myNodeIds = new Set(myNodes.map((n) => n.id));
   const myEdges = allEdges.filter(
@@ -1428,7 +1558,12 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId,
   );
   for (const edge of myEdges) {
     const edgeMeta = buildEdgeElement(moddle, edge);
-    if (edgeMeta) flowElements.push(edgeMeta);
+    if (!edgeMeta) continue;
+    if (edge.data?.edgeType === "association") {
+      artifacts.push(edgeMeta);
+    } else {
+      flowElements.push(edgeMeta);
+    }
   }
   const elementById = new Map(
     flowElements.filter((element) => typeof element.id === "string").map((element) => [element.id, element])
@@ -1444,7 +1579,8 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId,
   const process = moddle.create("bpmn:Process", {
     id: processId,
     isExecutable: opts.process?.executable ?? true,
-    flowElements
+    flowElements,
+    ...artifacts.length > 0 ? { artifacts } : {}
   });
   if (opts.process?.documentation) {
     process.documentation = [
@@ -1476,6 +1612,10 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
     id: node.id,
     name: label ?? ""
   };
+  if (elementType === "Annotation") {
+    delete attrs.name;
+    attrs.text = label ?? "";
+  }
   if (node.data.documentation) {
     attrs.documentation = [
       moddle.create("bpmn:Documentation", { text: node.data.documentation })
@@ -1494,22 +1634,16 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
   if (elementType === "CallActivity" && node.data.calledElement) {
     attrs.calledElement = node.data.calledElement;
   }
+  if (elementType === "DataObjectReference") {
+    const refId = typeof node.data.dataObjectRef === "string" ? node.data.dataObjectRef : `DataObject_${node.id}`;
+    attrs.dataObjectRef = { id: refId };
+  }
   if (elementType === "ScriptTask") {
     const scriptFormat = typeof node.data.scriptFormat === "string" ? node.data.scriptFormat : void 0;
     const script = typeof node.data.script === "string" ? node.data.script : void 0;
     if (scriptFormat) attrs.scriptFormat = scriptFormat;
     if (script) attrs.script = script;
   }
-  if (elementType === "UserTask") {
-    const flowableAttrs = {};
-    const fk = typeof node.data.formKey === "string" ? node.data.formKey : void 0;
-    const cu = typeof node.data.candidateUsers === "string" ? node.data.candidateUsers : void 0;
-    const cg = typeof node.data.candidateGroups === "string" ? node.data.candidateGroups : void 0;
-    if (fk) flowableAttrs["flowable:formKey"] = fk;
-    if (cu) flowableAttrs["flowable:candidateUsers"] = cu;
-    if (cg) flowableAttrs["flowable:candidateGroups"] = cg;
-    if (Object.keys(flowableAttrs).length > 0) attrs.$attrs = flowableAttrs;
-  }
   if (elementType === "ServiceTask") {
     const flowableAttrs = {};
     const flowableType = typeof node.data.flowableType === "string" ? node.data.flowableType : void 0;
@@ -1526,7 +1660,9 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
   if (aranzaConfig) attrs.extensionElements = aranzaConfig;
   const isSubProcess = elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess";
   if (isSubProcess) {
-    attrs.flowElements = buildNestedFlowElements(moddle, node, allNodes, allEdges);
+    const nested = buildNestedFlowElements(moddle, node, allNodes, allEdges);
+    attrs.flowElements = nested.flowElements;
+    if (nested.artifacts.length > 0) attrs.artifacts = nested.artifacts;
     if (elementType === "EventSubProcess" || node.data.subProcessVariant === "event") {
       attrs.triggeredByEvent = true;
     }
@@ -1536,6 +1672,29 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
       });
     }
   }
+  const loopType = typeof node.data.loopType === "string" ? node.data.loopType : "none";
+  if (loopType && loopType !== "none") {
+    if (loopType === "loop") {
+      const lcAttrs = { id: uid("LoopChar", node.id) };
+      const loopCondition = typeof node.data.loopCondition === "string" ? node.data.loopCondition : void 0;
+      if (loopCondition) {
+        lcAttrs.loopCondition = moddle.create("bpmn:FormalExpression", { body: loopCondition });
+      }
+      attrs.loopCharacteristics = moddle.create("bpmn:StandardLoopCharacteristics", lcAttrs);
+    } else {
+      const isSequential = loopType === "sequentialMultiple";
+      const lcAttrs = { id: uid("LoopChar", node.id), isSequential };
+      const loopCardinality = typeof node.data.loopCardinality === "string" ? node.data.loopCardinality : void 0;
+      const loopCompletionCondition = typeof node.data.loopCompletionCondition === "string" ? node.data.loopCompletionCondition : void 0;
+      if (loopCardinality) {
+        lcAttrs.loopCardinality = moddle.create("bpmn:FormalExpression", { body: loopCardinality });
+      }
+      if (loopCompletionCondition) {
+        lcAttrs.completionCondition = moddle.create("bpmn:FormalExpression", { body: loopCompletionCondition });
+      }
+      attrs.loopCharacteristics = moddle.create("bpmn:MultiInstanceLoopCharacteristics", lcAttrs);
+    }
+  }
   const element = moddle.create(moddleType, attrs);
   return element;
 }
@@ -1543,16 +1702,42 @@ 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 = [];
+  const artifacts = [];
+  const presentDataObjectIds = new Set(
+    childNodes.filter((n) => n.data.elementType === "DataObject").map((n) => n.id)
+  );
+  for (const node of childNodes) {
+    if (node.data.elementType === "DataObjectReference") {
+      const explicitRef = typeof node.data.dataObjectRef === "string" ? node.data.dataObjectRef : null;
+      if (!explicitRef || !presentDataObjectIds.has(explicitRef)) {
+        const syntheticId = `DataObject_${node.id}`;
+        if (!presentDataObjectIds.has(syntheticId)) {
+          flowElements.push(moddle.create("bpmn:DataObject", { id: syntheticId }));
+          presentDataObjectIds.add(syntheticId);
+        }
+      }
+    }
+  }
   for (const child of childNodes) {
     const element = buildFlowElement(moddle, child, allNodes, allEdges);
-    if (element) flowElements.push(element);
+    if (!element) continue;
+    if (ARTIFACT_ELEMENT_TYPES.has(child.data.elementType)) {
+      artifacts.push(element);
+    } else {
+      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);
+    if (!element) continue;
+    if (edge.data?.edgeType === "association") {
+      artifacts.push(element);
+    } else {
+      flowElements.push(element);
+    }
   }
-  return flowElements;
+  return { flowElements, artifacts };
 }
 function buildEdgeElement(moddle, edge) {
   if (!edge.data) return null;
@@ -1574,6 +1759,9 @@ function buildEdgeElement(moddle, edge) {
       body: edge.data.conditionExpression
     });
   }
+  if (edge.data.edgeType === "association" && edge.data.associationDirection && edge.data.associationDirection !== "none") {
+    attrs.associationDirection = edge.data.associationDirection === "both" ? "Both" : "One";
+  }
   return moddle.create(moddleType, attrs);
 }
 function buildBpmnDI(moddle, definitions, nodes, edges) {