@aranzatech/diagrams-bpmn 0.2.15 → 0.3.0

package/README.md

@@ -2,10 +2,12 @@
 
 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.
+import/export, execution-extension contracts 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.
+It is intentionally not responsible for execution-engine communication. Backend
+orchestrators still own actual Flowable runtime calls, deployment and instance
+management. This package only owns the BPMN-side contract used to model and
+round-trip those extensions safely.
 
 ## Public Subpaths
 
@@ -27,15 +29,43 @@ import { createSimulation } from "@aranzatech/diagrams-bpmn/simulation";
 - BPMN visual node and edge renderers for ReactFlow.
 - BPMN element catalog and guards.
 - BPMN XML import/export through `bpmn-moddle`.
+- BPMN extension contracts for Aranza/Flowable task and message metadata.
 - BPMN modeling commands and interaction rules on top of `diagrams-core`.
 - Client-side preview token simulation.
 
 ## Out Of Scope
 
-- Flowable REST/backend communication.
+- Flowable REST/backend communication and engine lifecycle.
 - BPMN business validation rules. Those belong in `@aranzatech/flowslint`.
 - Full execution semantics.
 
+## Extension Contract
+
+Engine-specific metadata that still belongs to the BPMN model lives here.
+
+- `ARANZA_DESCRIPTOR` defines the XML extension namespace.
+- `BpmnFlowableExportOptions` defines Flowable export enrichment options.
+- `getBpmnTaskExecutionExtensions(...)` reads the task-side execution payload.
+- `getBpmnMessageFlowExecutionExtensions(...)` reads message-flow execution metadata.
+
+That lets `webapp` focus on UX and lets `flowslint` validate the same contract
+without inventing app-local shapes again.
+
+## Validation Scope
+
+`@aranzatech/diagrams-bpmn/validation` remains available only as a deprecated
+compatibility layer for structural editor invariants:
+
+- edge references must point to existing nodes
+- self-loops are rejected
+- boundary events must attach to valid hosts
+- lanes must belong to pools
+- edge endpoint families must be structurally valid
+
+For semantic BPMN 2.0 linting such as start/end requirements, gateway rules,
+reachability, naming, Aranza conventions and publish-time findings, use
+`@aranzatech/flowslint`.
+
 ## Coverage Matrix
 
 | Area | Status | Notes |

package/dist/{catalog-xOMF2ifW.d.cts → catalog-DAGDhO-D.d.cts}

@@ -1,4 +1,4 @@
-import { f as BpmnElementType, d as BpmnElementMeta, e as BpmnElementSize } from './types-y-ZbX-ff.cjs';
+import { f as BpmnElementType, d as BpmnElementMeta, e as BpmnElementSize } from './types-BYN4Zuee.cjs';
 
 declare const BPMN_ELEMENT_CATALOG: Record<BpmnElementType, BpmnElementMeta>;
 declare function getElementMeta(type: BpmnElementType): BpmnElementMeta;

package/dist/{catalog-CK3_4cOb.d.ts → catalog-Q1QmKLDD.d.ts}

@@ -1,4 +1,4 @@
-import { f as BpmnElementType, d as BpmnElementMeta, e as BpmnElementSize } from './types-y-ZbX-ff.js';
+import { f as BpmnElementType, d as BpmnElementMeta, e as BpmnElementSize } from './types-BYN4Zuee.js';
 
 declare const BPMN_ELEMENT_CATALOG: Record<BpmnElementType, BpmnElementMeta>;
 declare function getElementMeta(type: BpmnElementType): BpmnElementMeta;

package/dist/{chunk-YUE5EM3W.js → chunk-334WN4JZ.js}

@@ -1,61 +1,6 @@
+import { ARANZA_DESCRIPTOR, getBpmnMessageFlowExecutionExtensions, getBpmnTaskExecutionExtensions } from './chunk-TB6V4S5N.js';
 import { BPMN_ELEMENT_CATALOG } from './chunk-L5Z22RLX.js';
 
-// src/xml/aranza-descriptor.ts
-var ARANZA_DESCRIPTOR = {
-  name: "Aranza",
-  uri: "http://aranzatech.io/schema/bpmn-extension/1.0",
-  prefix: "aranza",
-  xml: { tagAlias: "lowerCase" },
-  types: [
-    {
-      name: "TaskConfig",
-      superClass: ["Element"],
-      properties: [
-        { name: "priority", isAttr: true, type: "String" },
-        { name: "owner", isAttr: true, type: "String" },
-        { name: "sla", isAttr: true, type: "String" },
-        // Aranza connector execution config (resolved at runtime by the Flowable delegate)
-        { name: "connector", isAttr: true, type: "String" },
-        { name: "action", isAttr: true, type: "String" },
-        // Flowable implementation hints stored for round-trip fidelity
-        { name: "flowableType", isAttr: true, type: "String" },
-        { name: "flowableDelegateExpression", isAttr: true, type: "String" },
-        // BusinessRuleTask: reference to a DMN decision table id
-        { name: "decisionRef", isAttr: true, type: "String" },
-        // UserTask: form key resolved to a FormDefinition name at runtime
-        { 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" },
-        // 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" }
-      ]
-    }
-  ],
-  enumerations: [],
-  associations: []
-};
-
 // src/xml/mapper.ts
 var MODDLE_TO_ELEMENT_TYPE = {
   "bpmn:StartEvent": "StartEvent",
@@ -184,6 +129,11 @@ function asElements(v) {
 function asString(v) {
   return typeof v === "string" && v.trim() ? v.trim() : void 0;
 }
+function asStringRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entries = Object.entries(value).filter((entry) => typeof entry[1] === "string");
+  return entries.length > 0 ? Object.fromEntries(entries) : void 0;
+}
 function extractDocumentation(el) {
   const [doc] = asElements(el.documentation);
   return asString(doc?.text);
@@ -362,6 +312,35 @@ function extractAranzaExtensions(el) {
   if (owner) result.owner = owner;
   const sla = asString(taskConfig.sla);
   if (sla) result.sla = sla;
+  const serviceConfig = {};
+  const implementation = asString(taskConfig.implementation);
+  if (implementation === "none" || implementation === "connector" || implementation === "http" || implementation === "webService") {
+    serviceConfig.implementation = implementation;
+  }
+  const connectorInstanceId = asString(taskConfig.connectorInstanceId);
+  if (connectorInstanceId) serviceConfig.connectorInstanceId = connectorInstanceId;
+  const connectorId = asString(taskConfig.connectorId);
+  if (connectorId) serviceConfig.connectorId = connectorId;
+  const connectorAction = asString(taskConfig.connectorAction);
+  if (connectorAction) serviceConfig.connectorAction = connectorAction;
+  const connectorParamsJson = asString(taskConfig.connectorParamsJson);
+  if (connectorParamsJson) {
+    try {
+      const parsed = JSON.parse(connectorParamsJson);
+      const connectorParams = asStringRecord(parsed);
+      if (connectorParams) serviceConfig.connectorParams = connectorParams;
+    } catch {
+    }
+  }
+  const httpMethod = asString(taskConfig.httpMethod);
+  if (httpMethod === "GET" || httpMethod === "POST" || httpMethod === "PUT" || httpMethod === "DELETE" || httpMethod === "PATCH") {
+    serviceConfig.httpMethod = httpMethod;
+  }
+  const endpoint = asString(taskConfig.endpoint);
+  if (endpoint) serviceConfig.endpoint = endpoint;
+  const operationRef = asString(taskConfig.operationRef);
+  if (operationRef) serviceConfig.operationRef = operationRef;
+  if (Object.keys(serviceConfig).length > 0) result.serviceConfig = serviceConfig;
   const connector = asString(taskConfig.connector);
   if (connector) result.connector = connector;
   const action = asString(taskConfig.action);
@@ -454,6 +433,7 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
   const completionCondition = elementType === "AdHocSubProcess" ? extractCompletionCondition(el) : void 0;
   const loopChars = extractLoopCharacteristics(el);
   const dataObjectRef = elementType === "DataObjectReference" ? asString(el.dataObjectRef?.id) : void 0;
+  const dataStoreRef = elementType === "DataStoreReference" ? asString(el.dataStoreRef?.id) : void 0;
   const data = {
     elementType,
     ...label ? { label } : {},
@@ -475,6 +455,7 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
     ...script ? { script } : {},
     ...completionCondition ? { completionCondition } : {},
     ...dataObjectRef ? { dataObjectRef } : {},
+    ...dataStoreRef ? { dataStoreRef } : {},
     ...loopChars,
     ...aranzaExt
   };
@@ -631,9 +612,10 @@ async function parseBpmnXml(xml) {
     }
   }
   const defaultFlowById = /* @__PURE__ */ new Set();
+  const defaultFlowBySourceId = /* @__PURE__ */ new Map();
   const nodeIds = new Set(nodes.map((node) => node.id));
   for (const rootEl of asElements(rootElement.rootElements)) {
-    collectDefaultFlows(rootEl, defaultFlowById);
+    collectDefaultFlows(rootEl, defaultFlowById, defaultFlowBySourceId);
   }
   const normalizedEdges = edges.map((edge) => {
     if (!defaultFlowById.has(edge.id)) return edge;
@@ -656,18 +638,36 @@ async function parseBpmnXml(xml) {
     if (importedDefinitions) importedProcess.definitions = importedDefinitions;
     return importedProcess;
   })() : importedDefinitions ? { definitions: importedDefinitions } : void 0;
+  const normalizedNodes = normalizeChildPositions(nodes, nodeIds).map((node) => {
+    const defaultFlowId = defaultFlowBySourceId.get(node.id);
+    if (!defaultFlowId) return node;
+    return {
+      ...node,
+      data: {
+        ...node.data,
+        default: defaultFlowId
+      }
+    };
+  });
   return {
-    nodes: normalizeChildPositions(nodes, nodeIds),
+    nodes: normalizedNodes,
     edges: normalizedEdges,
     warnings,
     ...process ? { process } : {}
   };
 }
-function collectDefaultFlows(el, defaultFlowById) {
+function collectDefaultFlows(el, defaultFlowById, defaultFlowBySourceId) {
   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);
+  if (defaultRef?.id) {
+    defaultFlowById.add(defaultRef.id);
+    if (el.id) defaultFlowBySourceId.set(el.id, defaultRef.id);
+  }
+  for (const child of asElements(el.rootElements)) {
+    collectDefaultFlows(child, defaultFlowById, defaultFlowBySourceId);
+  }
+  for (const child of asElements(el.flowElements)) {
+    collectDefaultFlows(child, defaultFlowById, defaultFlowBySourceId);
+  }
 }
 function normalizeChildPositions(nodes, nodeIds) {
   const absoluteById = new Map(nodes.map((node) => [node.id, node.position]));
@@ -728,6 +728,12 @@ function parseVariableType2(type) {
       return "xsd:string";
   }
 }
+function escapeXml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function escapeRegex(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function buildGlobalDefinitions(moddle, definitionsSet) {
   if (!definitionsSet) return [];
   const rootElements = [];
@@ -753,6 +759,33 @@ function buildGlobalDefinitions(moddle, definitionsSet) {
   }
   return rootElements;
 }
+function collectReferencedDataStoreIds(nodes) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const node of nodes) {
+    if (node.data.elementType !== "DataStoreReference") continue;
+    const explicitRef = typeof node.data.dataStoreRef === "string" ? node.data.dataStoreRef : `DataStore_${node.id}`;
+    ids.add(explicitRef);
+  }
+  return ids;
+}
+function buildGlobalDataStores(moddle, nodes) {
+  const referencedIds = collectReferencedDataStoreIds(nodes);
+  if (referencedIds.size === 0) return [];
+  const byId = new Map(nodes.map((node) => [node.id, node]));
+  const rootElements = [];
+  for (const id of referencedIds) {
+    const existing = byId.get(id);
+    if (existing?.data.elementType === "DataStore") {
+      rootElements.push(moddle.create("bpmn:DataStore", {
+        id,
+        name: existing.data.label ?? ""
+      }));
+      continue;
+    }
+    rootElements.push(moddle.create("bpmn:DataStore", { id }));
+  }
+  return rootElements;
+}
 function buildItemDefinitions(moddle, variables) {
   return (variables ?? []).map(
     (variable) => moddle.create("bpmn:ItemDefinition", {
@@ -786,38 +819,41 @@ function buildEventDefinitions(moddle, node, eventDefinition) {
   return [moddle.create(defType, attrs)];
 }
 function buildAranzaExtensionElements(moddle, node) {
-  const { priority, owner, sla } = node.data;
-  const connector = typeof node.data.connector === "string" ? node.data.connector : void 0;
-  const action = typeof node.data.action === "string" ? node.data.action : void 0;
-  const flowableType = typeof node.data.flowableType === "string" ? node.data.flowableType : void 0;
-  const flowableDelegateExpression = typeof node.data.flowableDelegateExpression === "string" ? node.data.flowableDelegateExpression : void 0;
-  const decisionRef = typeof node.data.decisionRef === "string" ? node.data.decisionRef : void 0;
-  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;
-  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) {
+  const ext = getBpmnTaskExecutionExtensions(node.data);
+  if (!ext) {
     return null;
   }
   const configAttrs = {};
-  if (priority) configAttrs.priority = priority;
-  if (owner) configAttrs.owner = owner;
-  if (sla) configAttrs.sla = sla;
-  if (connector) configAttrs.connector = connector;
-  if (action) configAttrs.action = action;
-  if (flowableType) configAttrs.flowableType = flowableType;
-  if (flowableDelegateExpression) configAttrs.flowableDelegateExpression = flowableDelegateExpression;
-  if (decisionRef) configAttrs.decisionRef = decisionRef;
-  if (formKey) configAttrs.formKey = formKey;
-  if (candidateUsers) configAttrs.candidateUsers = candidateUsers;
-  if (candidateGroups) configAttrs.candidateGroups = candidateGroups;
-  if (dueDate) configAttrs.dueDate = dueDate;
-  if (skipExpression) configAttrs.skipExpression = skipExpression;
-  if (businessCalendarName) configAttrs.businessCalendarName = businessCalendarName;
+  if (ext.priority) configAttrs.priority = ext.priority;
+  if (ext.owner) configAttrs.owner = ext.owner;
+  if (ext.sla) configAttrs.sla = ext.sla;
+  if (ext.serviceConfig?.implementation) configAttrs.implementation = ext.serviceConfig.implementation;
+  if (ext.serviceConfig?.connectorInstanceId) {
+    configAttrs.connectorInstanceId = ext.serviceConfig.connectorInstanceId;
+  }
+  if (ext.serviceConfig?.connectorId) configAttrs.connectorId = ext.serviceConfig.connectorId;
+  if (ext.serviceConfig?.connectorAction) {
+    configAttrs.connectorAction = ext.serviceConfig.connectorAction;
+  }
+  if (ext.serviceConfig?.connectorParams && Object.keys(ext.serviceConfig.connectorParams).length > 0) {
+    configAttrs.connectorParamsJson = JSON.stringify(ext.serviceConfig.connectorParams);
+  }
+  if (ext.serviceConfig?.httpMethod) configAttrs.httpMethod = ext.serviceConfig.httpMethod;
+  if (ext.serviceConfig?.endpoint) configAttrs.endpoint = ext.serviceConfig.endpoint;
+  if (ext.serviceConfig?.operationRef) configAttrs.operationRef = ext.serviceConfig.operationRef;
+  if (ext.connector) configAttrs.connector = ext.connector;
+  if (ext.action) configAttrs.action = ext.action;
+  if (ext.flowableType) configAttrs.flowableType = ext.flowableType;
+  if (ext.flowableDelegateExpression) configAttrs.flowableDelegateExpression = ext.flowableDelegateExpression;
+  if (ext.decisionRef) configAttrs.decisionRef = ext.decisionRef;
+  if (ext.formKey) configAttrs.formKey = ext.formKey;
+  if (ext.candidateUsers) configAttrs.candidateUsers = ext.candidateUsers;
+  if (ext.candidateGroups) configAttrs.candidateGroups = ext.candidateGroups;
+  if (ext.dueDate) configAttrs.dueDate = ext.dueDate;
+  if (ext.skipExpression) configAttrs.skipExpression = ext.skipExpression;
+  if (ext.businessCalendarName) configAttrs.businessCalendarName = ext.businessCalendarName;
   const values = [moddle.create("aranza:TaskConfig", configAttrs)];
-  const inlineDecisionTable = node.data.inlineDecisionTable;
+  const inlineDecisionTable = ext.inlineDecisionTable;
   if (inlineDecisionTable && typeof inlineDecisionTable === "object") {
     const tbl = inlineDecisionTable;
     const { hitPolicy, ...rest } = tbl;
@@ -837,13 +873,15 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
   const poolNodes = asNodes(nodes, ["Pool"]);
   const laneNodes = asNodes(nodes, ["Lane"]);
   const isCollaboration = poolNodes.length > 0;
+  const referencedDataStoreIds = collectReferencedDataStoreIds(nodes);
   const definitions = moddle.create("bpmn:Definitions", {
     id: defId,
     targetNamespace: "http://bpmn.io/schema/bpmn",
     ...defName ? { name: defName } : {}
   });
   const rootElements = [
-    ...buildGlobalDefinitions(moddle, opts.process?.definitions)
+    ...buildGlobalDefinitions(moddle, opts.process?.definitions),
+    ...buildGlobalDataStores(moddle, nodes)
   ];
   const itemDefinitions = buildItemDefinitions(moddle, opts.process?.definitions?.variables);
   if (itemDefinitions.length > 0) {
@@ -854,7 +892,7 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
     const processes = [];
     for (const pool of poolNodes) {
       const processId = `Process_${pool.id}`;
-      const process = buildProcess(moddle, nodes, edges, pool.id, laneNodes, processId, opts);
+      const process = buildProcess(moddle, nodes, edges, pool.id, laneNodes, processId, opts, referencedDataStoreIds);
       processes.push(process);
       const participant = moddle.create("bpmn:Participant", {
         id: pool.id,
@@ -866,18 +904,17 @@ 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) => {
-      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 ext = e.data ? getBpmnMessageFlowExecutionExtensions(e.data) : void 0;
       const mfAttrs = {
         id: e.id,
         name: e.data?.label ?? "",
         sourceRef: { id: e.source },
         targetRef: { id: e.target }
       };
-      if (ps || ck) {
+      if (ext?.payloadSchema || ext?.correlationKey) {
         const cfg = moddle.create("aranza:MessageFlowConfig", {
-          ...ps ? { payloadSchema: ps } : {},
-          ...ck ? { correlationKey: ck } : {}
+          ...ext.payloadSchema ? { payloadSchema: ext.payloadSchema } : {},
+          ...ext.correlationKey ? { correlationKey: ext.correlationKey } : {}
         });
         mfAttrs.extensionElements = moddle.create("bpmn:ExtensionElements", { values: [cfg] });
       }
@@ -905,14 +942,15 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
       void 0,
       laneNodes,
       opts.process?.processId ?? "Process_1",
-      opts
+      opts,
+      referencedDataStoreIds
     );
     rootElements.push(process);
   }
   definitions.rootElements = rootElements;
   return definitions;
 }
-function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId, opts) {
+function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId, opts, referencedDataStoreIds) {
   const subProcessIds = new Set(
     allNodes.filter(
       (n) => n.data.elementType === "SubProcess" || n.data.elementType === "Transaction" || n.data.elementType === "EventSubProcess" || n.data.elementType === "AdHocSubProcess"
@@ -934,7 +972,7 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId,
     }
     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 myNodes = (poolId ? allNodes.filter((n) => belongsToPool(n)) : allNodes.filter((n) => n.data.elementType !== "Pool" && n.data.elementType !== "Lane")).filter((n) => !isInsideSubProcess(n)).filter((n) => !(n.data.elementType === "DataStore" && referencedDataStoreIds.has(n.id)));
   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)
@@ -978,10 +1016,18 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId,
   const elementById = new Map(
     flowElements.filter((element) => typeof element.id === "string").map((element) => [element.id, element])
   );
+  const defaultEdgeBySource = /* @__PURE__ */ new Map();
+  for (const node of myNodes) {
+    const defaultFlowId = typeof node.data.default === "string" ? node.data.default : void 0;
+    if (defaultFlowId) defaultEdgeBySource.set(node.id, defaultFlowId);
+  }
   for (const edge of myEdges) {
-    if (!edge.data?.isDefault) continue;
-    const sourceElement = elementById.get(edge.source);
-    const edgeElement = elementById.get(edge.id);
+    if (!edge.data?.isDefault || defaultEdgeBySource.has(edge.source)) continue;
+    defaultEdgeBySource.set(edge.source, edge.id);
+  }
+  for (const [sourceId, edgeId] of defaultEdgeBySource) {
+    const sourceElement = elementById.get(sourceId);
+    const edgeElement = elementById.get(edgeId);
     if (sourceElement && edgeElement) {
       sourceElement.default = edgeElement;
     }
@@ -1048,6 +1094,10 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
     const refId = typeof node.data.dataObjectRef === "string" ? node.data.dataObjectRef : `DataObject_${node.id}`;
     attrs.dataObjectRef = { id: refId };
   }
+  if (elementType === "DataStoreReference") {
+    const refId = typeof node.data.dataStoreRef === "string" ? node.data.dataStoreRef : `DataStore_${node.id}`;
+    attrs.dataStoreRef = { 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;
@@ -1109,7 +1159,8 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
   return element;
 }
 function buildNestedFlowElements(moddle, parent, allNodes, allEdges) {
-  const childNodes = allNodes.filter((node) => node.parentId === parent.id);
+  const referencedDataStoreIds = collectReferencedDataStoreIds(allNodes);
+  const childNodes = allNodes.filter((node) => node.parentId === parent.id).filter((node) => !(node.data.elementType === "DataStore" && referencedDataStoreIds.has(node.id)));
   const childNodeIds = new Set(childNodes.map((node) => node.id));
   const flowElements = [];
   const artifacts = [];
@@ -1263,6 +1314,124 @@ function buildAbsolutePositionMap(nodes) {
   for (const node of nodes) resolve(node);
   return absoluteById;
 }
+function getServiceTaskConfig(node, opts) {
+  const override = opts.flowable?.serviceTaskConfigs?.[node.id];
+  if (override) return override;
+  const config = node.data.serviceConfig;
+  return config && typeof config === "object" ? config : void 0;
+}
+function injectFlowableNamespace(xml) {
+  if (xml.includes("xmlns:flowable=")) return xml;
+  return xml.replace(
+    "<bpmn:definitions",
+    '<bpmn:definitions xmlns:flowable="http://flowable.org/bpmn"'
+  );
+}
+function ensureOpeningTagAttribute(openTag, name, value) {
+  if (new RegExp(`\\b${escapeRegex(name)}=`).test(openTag)) return openTag;
+  return openTag.replace(/>$/, ` ${name}="${escapeXml(value)}">`);
+}
+function injectFlowableFieldsIntoElement(xml, elementTagName, nodeId, fieldsXml, flowableType) {
+  const idPattern = escapeRegex(nodeId);
+  const selfClosingPattern = new RegExp(
+    `<bpmn:${elementTagName}\\b[^>]*?\\bid="${idPattern}"[^>]*/>`,
+    "s"
+  );
+  const blockPattern = new RegExp(
+    `<bpmn:${elementTagName}\\b[^>]*?\\bid="${idPattern}"[^>]*>[\\s\\S]*?<\\/bpmn:${elementTagName}>`,
+    "s"
+  );
+  if (selfClosingPattern.test(xml)) {
+    return xml.replace(selfClosingPattern, (match) => {
+      const openTag = ensureOpeningTagAttribute(match.replace(/\/>$/, ">"), "flowable:type", flowableType);
+      return `${openTag}
+      <bpmn:extensionElements>
+${fieldsXml}
+      </bpmn:extensionElements>
+    </bpmn:${elementTagName}>`;
+    });
+  }
+  return xml.replace(blockPattern, (block) => {
+    const openTagMatch = block.match(new RegExp(`^<bpmn:${elementTagName}\\b[^>]*>`, "s"));
+    if (!openTagMatch) return block;
+    const openTag = ensureOpeningTagAttribute(openTagMatch[0], "flowable:type", flowableType);
+    let nextBlock = openTag + block.slice(openTagMatch[0].length);
+    if (nextBlock.includes("<bpmn:extensionElements>")) {
+      return nextBlock.replace(
+        /<bpmn:extensionElements>([\s\S]*?)<\/bpmn:extensionElements>/,
+        (_match, inner) => `<bpmn:extensionElements>${inner.trimEnd()}
+${fieldsXml}
+      </bpmn:extensionElements>`
+      );
+    }
+    return nextBlock.replace(
+      openTag,
+      `${openTag}
+      <bpmn:extensionElements>
+${fieldsXml}
+      </bpmn:extensionElements>`
+    );
+  });
+}
+function injectFlowableConnectorServiceTasks(xml, nodes, opts) {
+  let result = xml;
+  const backendUrlTemplate = opts.flowable?.backendUrlTemplate ?? "%%ARANZAFLOWS_BACKEND_URL%%";
+  const responseVariableName = opts.flowable?.connectorResponseVariableName ?? "connectorResult";
+  for (const node of nodes) {
+    if (node.data.elementType !== "ServiceTask") continue;
+    const cfg = getServiceTaskConfig(node, opts);
+    if (cfg?.implementation !== "connector" || !cfg.connectorInstanceId || !cfg.connectorAction) {
+      continue;
+    }
+    result = injectFlowableNamespace(result);
+    const bodyObj = {
+      action: cfg.connectorAction,
+      params: cfg.connectorParams ?? {}
+    };
+    const url = `${backendUrlTemplate}/api/v1/integrations/${encodeURIComponent(cfg.connectorInstanceId)}/execute-internal`;
+    const fieldsXml = [
+      '        <flowable:field name="requestMethod"><flowable:string>POST</flowable:string></flowable:field>',
+      `        <flowable:field name="requestUrl"><flowable:string>${escapeXml(url)}</flowable:string></flowable:field>`,
+      '        <flowable:field name="requestHeaders"><flowable:string>Content-Type: application/json</flowable:string></flowable:field>',
+      `        <flowable:field name="requestBody"><flowable:expression>${escapeXml(JSON.stringify(bodyObj))}</flowable:expression></flowable:field>`,
+      `        <flowable:field name="responseVariableName"><flowable:string>${escapeXml(responseVariableName)}</flowable:string></flowable:field>`,
+      '        <flowable:field name="saveResponseParameters"><flowable:string>false</flowable:string></flowable:field>'
+    ].join("\n");
+    result = injectFlowableFieldsIntoElement(result, "serviceTask", node.id, fieldsXml, "http");
+  }
+  return result;
+}
+function injectFlowableDecisionTasks(xml, nodes, opts) {
+  let result = xml;
+  const variables = opts.process?.definitions?.variables ?? [];
+  const backendUrlTemplate = opts.flowable?.backendUrlTemplate ?? "%%ARANZAFLOWS_BACKEND_URL%%";
+  const responseVariableName = opts.flowable?.decisionResponseVariableName ?? "decisionResult";
+  for (const node of nodes) {
+    if (node.data.elementType !== "BusinessRuleTask") continue;
+    const decisionRef = typeof node.data.decisionRef === "string" ? node.data.decisionRef : void 0;
+    if (!decisionRef) continue;
+    result = injectFlowableNamespace(result);
+    const url = `${backendUrlTemplate}/api/v1/decisions/${encodeURIComponent(decisionRef)}/evaluate-internal`;
+    const bodyField = variables.length > 0 ? `<flowable:expression>${escapeXml(
+      `{${variables.map((variable) => `"${variable.name}": \${${variable.name}}`).join(", ")}}`
+    )}</flowable:expression>` : "<flowable:string>{}</flowable:string>";
+    const fieldsXml = [
+      '        <flowable:field name="requestMethod"><flowable:string>POST</flowable:string></flowable:field>',
+      `        <flowable:field name="requestUrl"><flowable:string>${escapeXml(url)}</flowable:string></flowable:field>`,
+      '        <flowable:field name="requestHeaders"><flowable:string>Content-Type: application/json</flowable:string></flowable:field>',
+      `        <flowable:field name="requestBody">${bodyField}</flowable:field>`,
+      `        <flowable:field name="responseVariableName"><flowable:string>${escapeXml(responseVariableName)}</flowable:string></flowable:field>`,
+      '        <flowable:field name="saveResponseParameters"><flowable:string>false</flowable:string></flowable:field>'
+    ].join("\n");
+    result = injectFlowableFieldsIntoElement(result, "businessRuleTask", node.id, fieldsXml, "http");
+  }
+  return result;
+}
+function applyFlowableExportEnrichment(xml, nodes, opts) {
+  if (!opts.flowable?.enabled) return xml;
+  const withServiceTasks = injectFlowableConnectorServiceTasks(xml, nodes, opts);
+  return injectFlowableDecisionTasks(withServiceTasks, nodes, opts);
+}
 async function serializeBpmnXml(nodes, edges, opts = {}) {
   const { BpmnModdle } = await import('bpmn-moddle');
   const moddle = new BpmnModdle({ aranza: ARANZA_DESCRIPTOR });
@@ -1271,9 +1440,9 @@ async function serializeBpmnXml(nodes, edges, opts = {}) {
   const { xml } = await moddle.toXML(definitions, {
     format: opts.format ?? true
   });
-  return xml;
+  return applyFlowableExportEnrichment(xml, nodes, opts);
 }
 
 export { parseBpmnXml, serializeBpmnXml };
-//# sourceMappingURL=chunk-YUE5EM3W.js.map
-//# sourceMappingURL=chunk-YUE5EM3W.js.map
+//# sourceMappingURL=chunk-334WN4JZ.js.map
+//# sourceMappingURL=chunk-334WN4JZ.js.map