@aranzatech/diagrams-bpmn 0.2.4 → 0.2.6

package/dist/index.cjs

@@ -3,7 +3,6 @@
 var react = require('@xyflow/react');
 var jsxRuntime = require('react/jsx-runtime');
 var routing = require('@aranzatech/diagrams-core/routing');
-var bpmnModdle = require('bpmn-moddle');
 var diagramsCore = require('@aranzatech/diagrams-core');
 var serialization = require('@aranzatech/diagrams-core/serialization');
 
@@ -2493,6 +2492,27 @@ var BPMN_EDGE_TYPES = {
   conversationLink: ConversationLinkEdge
 };
 
+// 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" }
+      ]
+    }
+  ],
+  enumerations: [],
+  associations: []
+};
+
 // src/xml/mapper.ts
 var MODDLE_TO_ELEMENT_TYPE = {
   "bpmn:StartEvent": "StartEvent",
@@ -2674,9 +2694,84 @@ function extractLaneMembership(process) {
 function extractTrigger(el) {
   const defs = asElements(el.eventDefinitions);
   if (defs.length === 0) return void 0;
-  if (defs.length > 1) return el.$type.includes("Parallel") ? "parallelMultiple" : "multiple";
+  if (defs.length > 1) {
+    return defs.some((def) => def.$type === "bpmn:ParallelMultipleEventDefinition") ? "parallelMultiple" : "multiple";
+  }
   return EVENT_DEF_TO_TRIGGER[defs[0].$type];
 }
+function parseVariableType(value) {
+  const text = asString(value) ?? "";
+  if (text.includes("int")) return "integer";
+  if (text.includes("boolean")) return "boolean";
+  if (text.includes("date")) return "date";
+  if (text.includes("array")) return "array";
+  if (text.includes("anyType")) return "object";
+  return "string";
+}
+function extractEventDefinition(el) {
+  const defs = asElements(el.eventDefinitions);
+  if (defs.length === 0) return void 0;
+  if (defs.length > 1) {
+    return {
+      type: defs.some((def2) => def2.$type === "bpmn:ParallelMultipleEventDefinition") ? "parallelMultiple" : "multiple"
+    };
+  }
+  const [def] = defs;
+  const type = EVENT_DEF_TO_TRIGGER[def.$type];
+  if (!type) return void 0;
+  const eventDefinition = {
+    type,
+    ...asString(def.messageRef?.id) ? { messageRef: def.messageRef.id } : {},
+    ...asString(def.signalRef?.id) ? { signalRef: def.signalRef.id } : {},
+    ...asString(def.errorRef?.id) ? { errorRef: def.errorRef.id } : {},
+    ...asString(def.escalationRef?.id) ? { escalationRef: def.escalationRef.id } : {},
+    ...asString(def.condition?.body) ? { conditionExpression: def.condition.body } : {}
+  };
+  const timeDate = asString(def.timeDate?.body);
+  const timeDuration = asString(def.timeDuration?.body);
+  const timeCycle = asString(def.timeCycle?.body);
+  if (timeDate) eventDefinition.timer = { kind: "date", value: timeDate };
+  else if (timeCycle) eventDefinition.timer = { kind: "cycle", value: timeCycle };
+  else if (timeDuration) eventDefinition.timer = { kind: "duration", value: timeDuration };
+  if (type === "link") {
+    const linkName = asString(el.name) ?? asString(def.name);
+    if (linkName) eventDefinition.linkName = linkName;
+  }
+  return eventDefinition;
+}
+function extractDefinitions(rootElement) {
+  const definitions = {};
+  const rootElements = asElements(rootElement.rootElements);
+  const messages = rootElements.filter((element) => element.$type === "bpmn:Message" && asString(element.id)).map((message) => ({
+    id: message.id,
+    name: asString(message.name) ?? message.id
+  }));
+  if (messages.length > 0) definitions.messages = messages;
+  const signals = rootElements.filter((element) => element.$type === "bpmn:Signal" && asString(element.id)).map((signal) => ({
+    id: signal.id,
+    name: asString(signal.name) ?? signal.id
+  }));
+  if (signals.length > 0) definitions.signals = signals;
+  const errors = rootElements.filter((element) => element.$type === "bpmn:Error" && asString(element.id)).map((error) => ({
+    id: error.id,
+    name: asString(error.name) ?? error.id,
+    ...asString(error.errorCode) ? { errorCode: error.errorCode } : {}
+  }));
+  if (errors.length > 0) definitions.errors = errors;
+  const escalations = rootElements.filter((element) => element.$type === "bpmn:Escalation" && asString(element.id)).map((escalation) => ({
+    id: escalation.id,
+    name: asString(escalation.name) ?? escalation.id,
+    ...asString(escalation.escalationCode) ? { escalationCode: escalation.escalationCode } : {}
+  }));
+  if (escalations.length > 0) definitions.escalations = escalations;
+  const itemDefinitions = asElements(rootElement.itemDefinitions).filter((item) => asString(item.id)).map((item) => ({
+    id: String(item.id).replace(/_item$/, ""),
+    name: String(item.id).replace(/_item$/, ""),
+    type: parseVariableType(item.structureRef)
+  }));
+  if (itemDefinitions.length > 0) definitions.variables = itemDefinitions;
+  return Object.keys(definitions).length > 0 ? definitions : void 0;
+}
 function extractSubProcessVariant(el) {
   if (el.$type === "bpmn:Transaction") return "transaction";
   if (el.$type === "bpmn:AdHocSubProcess") return "adhoc";
@@ -2684,6 +2779,22 @@ function extractSubProcessVariant(el) {
   if (el.triggeredByEvent === true) return "event";
   return "embedded";
 }
+function extractAranzaExtensions(el) {
+  const ext = el.extensionElements;
+  if (!ext) return {};
+  const taskConfig = asElements(ext.values).find((v) => v.$type === "aranza:TaskConfig");
+  if (!taskConfig) return {};
+  const result = {};
+  const priority = asString(taskConfig.priority);
+  if (priority === "critical" || priority === "high" || priority === "medium" || priority === "low") {
+    result.priority = priority;
+  }
+  const owner = asString(taskConfig.owner);
+  if (owner) result.owner = owner;
+  const sla = asString(taskConfig.sla);
+  if (sla) result.sla = sla;
+  return result;
+}
 function walkFlowElements(elements, parentId, ctx, nodes, edges) {
   for (const el of elements) {
     const { $type, id } = el;
@@ -2717,15 +2828,29 @@ function buildNode(el, elementType, parentId, ctx, nodes) {
   const label = asString(el.name);
   const documentation = extractDocumentation(el);
   const trigger = extractTrigger(el);
+  const eventDefinition = extractEventDefinition(el);
   const isNonInterrupting = el.cancelActivity === false;
   const attachedToRef = el.attachedToRef?.id;
+  const calledElement = elementType === "CallActivity" ? asString(el.calledElement) : void 0;
+  const aranzaExt = extractAranzaExtensions(el);
   const data = {
     elementType,
     ...label ? { label } : {},
     ...documentation ? { documentation } : {},
     ...trigger ? { trigger } : {},
+    ...eventDefinition ? { eventDefinition } : {},
     ...isNonInterrupting ? { isNonInterrupting: true } : {},
-    ...attachedToRef ? { attachedToRef } : {}
+    ...elementType === "BoundaryEvent" ? { cancelActivity: el.cancelActivity !== false } : {},
+    ...attachedToRef ? { attachedToRef } : {},
+    ...eventDefinition?.timer ? { timer: eventDefinition.timer, timerExpression: eventDefinition.timer } : {},
+    ...eventDefinition?.messageRef ? { messageRef: eventDefinition.messageRef } : {},
+    ...eventDefinition?.signalRef ? { signalRef: eventDefinition.signalRef } : {},
+    ...eventDefinition?.errorRef ? { errorRef: eventDefinition.errorRef } : {},
+    ...eventDefinition?.escalationRef ? { escalationRef: eventDefinition.escalationRef } : {},
+    ...eventDefinition?.conditionExpression ? { conditionExpression: eventDefinition.conditionExpression } : {},
+    ...eventDefinition?.linkName ? { linkName: eventDefinition.linkName } : {},
+    ...calledElement ? { calledElement } : {},
+    ...aranzaExt
   };
   if (elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess") {
     const variant = extractSubProcessVariant(el);
@@ -2825,7 +2950,8 @@ function addLaneNodes(laneSet, poolId, ctx, nodes) {
   }
 }
 async function parseBpmnXml(xml) {
-  const moddle = new bpmnModdle.BpmnModdle();
+  const { BpmnModdle } = await import('bpmn-moddle');
+  const moddle = new BpmnModdle({ aranza: ARANZA_DESCRIPTOR });
   const warnings = [];
   let rootElement;
   try {
@@ -2875,10 +3001,23 @@ async function parseBpmnXml(xml) {
     };
     return { ...edge, data };
   });
+  const firstProcess = asElements(rootElement.rootElements).find((rootEl) => rootEl.$type === "bpmn:Process");
+  const importedDefinitions = extractDefinitions(rootElement);
+  const process = firstProcess ? (() => {
+    const importedProcess = {};
+    const processId = asString(firstProcess.id);
+    const documentation = extractDocumentation(firstProcess);
+    if (processId) importedProcess.processId = processId;
+    if (typeof firstProcess.isExecutable === "boolean") importedProcess.executable = firstProcess.isExecutable;
+    if (documentation) importedProcess.documentation = documentation;
+    if (importedDefinitions) importedProcess.definitions = importedDefinitions;
+    return importedProcess;
+  })() : importedDefinitions ? { definitions: importedDefinitions } : void 0;
   return {
     nodes: normalizeChildPositions(nodes, nodeIds),
     edges: normalizedEdges,
-    warnings
+    warnings,
+    ...process ? { process } : {}
   };
 }
 function collectDefaultFlows(el, defaultFlowById) {
@@ -2902,12 +3041,117 @@ function normalizeChildPositions(nodes, nodeIds) {
     };
   });
 }
+
+// src/xml/exporter.ts
 function uid(prefix, id) {
   return `${prefix}_${id}`;
 }
 function asNodes(nodes, types) {
   return nodes.filter((n) => types.includes(n.data.elementType));
 }
+function normalizeEventDefinition(data) {
+  const trigger = data.eventDefinition?.type ?? data.trigger;
+  if (!trigger || trigger === "none") return void 0;
+  const normalized = { type: trigger };
+  const timer = data.eventDefinition?.timer ?? data.timer ?? data.timerExpression;
+  const messageRef = data.eventDefinition?.messageRef ?? (typeof data.messageRef === "string" ? data.messageRef : void 0);
+  const signalRef = data.eventDefinition?.signalRef ?? (typeof data.signalRef === "string" ? data.signalRef : void 0);
+  const errorRef = data.eventDefinition?.errorRef ?? (typeof data.errorRef === "string" ? data.errorRef : void 0);
+  const escalationRef = data.eventDefinition?.escalationRef ?? (typeof data.escalationRef === "string" ? data.escalationRef : void 0);
+  const conditionExpression = data.eventDefinition?.conditionExpression ?? (typeof data.conditionExpression === "string" ? data.conditionExpression : void 0);
+  const linkName = data.eventDefinition?.linkName ?? (typeof data.linkName === "string" ? data.linkName : void 0);
+  if (timer) normalized.timer = timer;
+  if (messageRef) normalized.messageRef = messageRef;
+  if (signalRef) normalized.signalRef = signalRef;
+  if (errorRef) normalized.errorRef = errorRef;
+  if (escalationRef) normalized.escalationRef = escalationRef;
+  if (conditionExpression) normalized.conditionExpression = conditionExpression;
+  if (linkName) normalized.linkName = linkName;
+  return normalized;
+}
+function parseVariableType2(type) {
+  switch (type) {
+    case "integer":
+      return "xsd:int";
+    case "boolean":
+      return "xsd:boolean";
+    case "date":
+      return "xsd:dateTime";
+    case "object":
+      return "xsd:anyType";
+    case "array":
+      return "xsd:anyType";
+    default:
+      return "xsd:string";
+  }
+}
+function buildGlobalDefinitions(moddle, definitionsSet) {
+  if (!definitionsSet) return [];
+  const rootElements = [];
+  for (const message of definitionsSet.messages ?? []) {
+    rootElements.push(moddle.create("bpmn:Message", { id: message.id, name: message.name }));
+  }
+  for (const signal of definitionsSet.signals ?? []) {
+    rootElements.push(moddle.create("bpmn:Signal", { id: signal.id, name: signal.name }));
+  }
+  for (const error of definitionsSet.errors ?? []) {
+    rootElements.push(moddle.create("bpmn:Error", {
+      id: error.id,
+      name: error.name,
+      ...error.errorCode ? { errorCode: error.errorCode } : {}
+    }));
+  }
+  for (const escalation of definitionsSet.escalations ?? []) {
+    rootElements.push(moddle.create("bpmn:Escalation", {
+      id: escalation.id,
+      name: escalation.name,
+      ...escalation.escalationCode ? { escalationCode: escalation.escalationCode } : {}
+    }));
+  }
+  return rootElements;
+}
+function buildItemDefinitions(moddle, variables) {
+  return (variables ?? []).map(
+    (variable) => moddle.create("bpmn:ItemDefinition", {
+      id: `${variable.id}_item`,
+      itemKind: "Information",
+      structureRef: parseVariableType2(variable.type)
+    })
+  );
+}
+function buildEventDefinitions(moddle, node, eventDefinition) {
+  if (eventDefinition.type === "multiple" || eventDefinition.type === "parallelMultiple") {
+    return [];
+  }
+  const defType = TRIGGER_TO_EVENT_DEF[eventDefinition.type];
+  if (!defType) return [];
+  const attrs = { id: uid("EventDef", node.id) };
+  if (eventDefinition.messageRef) attrs.messageRef = { id: eventDefinition.messageRef };
+  if (eventDefinition.signalRef) attrs.signalRef = { id: eventDefinition.signalRef };
+  if (eventDefinition.errorRef) attrs.errorRef = { id: eventDefinition.errorRef };
+  if (eventDefinition.escalationRef) attrs.escalationRef = { id: eventDefinition.escalationRef };
+  if (eventDefinition.conditionExpression) {
+    attrs.condition = moddle.create("bpmn:FormalExpression", {
+      body: eventDefinition.conditionExpression
+    });
+  }
+  if (eventDefinition.timer?.value) {
+    attrs[eventDefinition.timer.kind === "date" ? "timeDate" : eventDefinition.timer.kind === "cycle" ? "timeCycle" : "timeDuration"] = moddle.create("bpmn:FormalExpression", {
+      body: eventDefinition.timer.value
+    });
+  }
+  return [moddle.create(defType, attrs)];
+}
+function buildAranzaExtensionElements(moddle, node) {
+  const { priority, owner, sla } = node.data;
+  if (!priority && !owner && !sla) return null;
+  const configAttrs = {};
+  if (priority) configAttrs.priority = priority;
+  if (owner) configAttrs.owner = owner;
+  if (sla) configAttrs.sla = sla;
+  const taskConfig = moddle.create("aranza:TaskConfig", configAttrs);
+  return moddle.create("bpmn:ExtensionElements", { values: [taskConfig] });
+}
 function buildSemanticModel(moddle, nodes, edges, opts) {
   const defId = opts.id ?? "Definitions_1";
   const defName = opts.name;
@@ -2919,13 +3163,19 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
     targetNamespace: "http://bpmn.io/schema/bpmn",
     ...defName ? { name: defName } : {}
   });
-  const rootElements = [];
+  const rootElements = [
+    ...buildGlobalDefinitions(moddle, opts.process?.definitions)
+  ];
+  const itemDefinitions = buildItemDefinitions(moddle, opts.process?.definitions?.variables);
+  if (itemDefinitions.length > 0) {
+    definitions.itemDefinitions = itemDefinitions;
+  }
   if (isCollaboration) {
     const participants = [];
     const processes = [];
     for (const pool of poolNodes) {
       const processId = `Process_${pool.id}`;
-      const process = buildProcess(moddle, nodes, edges, pool.id, laneNodes, processId);
+      const process = buildProcess(moddle, nodes, edges, pool.id, laneNodes, processId, opts);
       processes.push(process);
       const participant = moddle.create("bpmn:Participant", {
         id: pool.id,
@@ -2959,13 +3209,21 @@ function buildSemanticModel(moddle, nodes, edges, opts) {
     });
     rootElements.push(collaboration, ...processes);
   } else {
-    const process = buildProcess(moddle, nodes, edges, void 0, laneNodes, "Process_1");
+    const process = buildProcess(
+      moddle,
+      nodes,
+      edges,
+      void 0,
+      laneNodes,
+      opts.process?.processId ?? "Process_1",
+      opts
+    );
     rootElements.push(process);
   }
   definitions.rootElements = rootElements;
   return definitions;
 }
-function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId) {
+function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId, opts) {
   const subProcessIds = new Set(
     allNodes.filter(
       (n) => n.data.elementType === "SubProcess" || n.data.elementType === "Transaction" || n.data.elementType === "EventSubProcess" || n.data.elementType === "AdHocSubProcess"
@@ -3015,9 +3273,14 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId)
   }
   const process = moddle.create("bpmn:Process", {
     id: processId,
-    isExecutable: true,
+    isExecutable: opts.process?.executable ?? true,
     flowElements
   });
+  if (opts.process?.documentation) {
+    process.documentation = [
+      moddle.create("bpmn:Documentation", { text: opts.process.documentation })
+    ];
+  }
   if (myLanes.length > 0) {
     const laneElements = myLanes.map(
       (l) => moddle.create("bpmn:Lane", {
@@ -3034,7 +3297,8 @@ function buildProcess(moddle, allNodes, allEdges, poolId, laneNodes, processId)
   return process;
 }
 function buildFlowElement(moddle, node, allNodes, allEdges) {
-  const { elementType, label, trigger } = node.data;
+  const { elementType, label } = node.data;
+  const eventDefinition = normalizeEventDefinition(node.data);
   if (elementType === "Pool" || elementType === "Lane") return null;
   const moddleType = ELEMENT_TYPE_TO_MODDLE[elementType];
   if (!moddleType) return null;
@@ -3047,18 +3311,23 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
       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 (eventDefinition) {
+    const eventDefinitions = buildEventDefinitions(moddle, node, eventDefinition);
+    if (eventDefinitions.length > 0) attrs.eventDefinitions = eventDefinitions;
+    if (eventDefinition.linkName) attrs.name = eventDefinition.linkName;
   }
   if (elementType === "BoundaryEvent") {
     attrs.attachedToRef = { id: node.data.attachedToRef ?? node.parentId };
-    attrs.cancelActivity = node.data.isNonInterrupting ? false : true;
+    const interrupting = node.data.cancelActivity ?? !node.data.isNonInterrupting;
+    attrs.cancelActivity = interrupting;
   }
-  const isSubProcess3 = elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess";
-  if (isSubProcess3) {
+  if (elementType === "CallActivity" && node.data.calledElement) {
+    attrs.calledElement = node.data.calledElement;
+  }
+  const aranzaConfig = buildAranzaExtensionElements(moddle, node);
+  if (aranzaConfig) attrs.extensionElements = aranzaConfig;
+  const isSubProcess2 = elementType === "SubProcess" || elementType === "Transaction" || elementType === "EventSubProcess" || elementType === "AdHocSubProcess";
+  if (isSubProcess2) {
     attrs.flowElements = buildNestedFlowElements(moddle, node, allNodes, allEdges);
     if (elementType === "EventSubProcess" || node.data.subProcessVariant === "event") {
       attrs.triggeredByEvent = true;
@@ -3194,7 +3463,8 @@ function buildAbsolutePositionMap(nodes) {
   return absoluteById;
 }
 async function serializeBpmnXml(nodes, edges, opts = {}) {
-  const moddle = new bpmnModdle.BpmnModdle();
+  const { BpmnModdle } = await import('bpmn-moddle');
+  const moddle = new BpmnModdle({ aranza: ARANZA_DESCRIPTOR });
   const definitions = buildSemanticModel(moddle, nodes, edges, opts);
   buildBpmnDI(moddle, definitions, nodes, edges);
   const { xml } = await moddle.toXML(definitions, {
@@ -4225,6 +4495,41 @@ function reparentBpmnNodeAtPosition(state, options) {
     position: nextPosition
   });
 }
+var BE_HALF = 18;
+function clampBoundaryEventsAfterResize(state, hostId, oldW, oldH, newW, newH) {
+  const boundaryEvents = state.nodes.filter(
+    (n) => n.data.elementType === "BoundaryEvent" && n.parentId === hostId
+  );
+  let next = state;
+  for (const be of boundaryEvents) {
+    const px = be.position?.x ?? 0;
+    const py = be.position?.y ?? 0;
+    const cx = px + BE_HALF;
+    const cy = py + BE_HALF;
+    const distLeft = Math.abs(cx);
+    const distRight = Math.abs(cx - oldW);
+    const distTop = Math.abs(cy);
+    const distBottom = Math.abs(cy - oldH);
+    const minDist = Math.min(distLeft, distRight, distTop, distBottom);
+    let newCx;
+    let newCy;
+    if (minDist === distBottom) {
+      newCy = newH;
+      newCx = Math.min(Math.max(cx, BE_HALF), newW - BE_HALF);
+    } else if (minDist === distRight) {
+      newCx = newW;
+      newCy = Math.min(Math.max(cy, BE_HALF), newH - BE_HALF);
+    } else if (minDist === distTop) {
+      newCy = 0;
+      newCx = Math.min(Math.max(cx, BE_HALF), newW - BE_HALF);
+    } else {
+      newCx = 0;
+      newCy = Math.min(Math.max(cy, BE_HALF), newH - BE_HALF);
+    }
+    next = diagramsCore.moveNode(next, be.id, { x: newCx - BE_HALF, y: newCy - BE_HALF });
+  }
+  return next;
+}
 function resizeBpmnNodeCommand(options) {
   return {
     id: `bpmn.resize.${options.id}`,
@@ -4236,10 +4541,18 @@ function resizeBpmnNodeCommand(options) {
       if (!size.resizable) {
         throw new Error(`${node.data.elementType} is not resizable in BPMN.`);
       }
-      return diagramsCore.resizeNode(state, options.id, {
-        width: options.width === void 0 ? void 0 : Math.max(size.minWidth, options.width),
-        height: options.height === void 0 ? void 0 : Math.max(size.minHeight, options.height)
+      const oldW = node.width ?? size.width;
+      const oldH = node.height ?? size.height;
+      const clampedW = options.width === void 0 ? void 0 : Math.max(size.minWidth, options.width);
+      const clampedH = options.height === void 0 ? void 0 : Math.max(size.minHeight, options.height);
+      const resized = diagramsCore.resizeNode(state, options.id, {
+        width: clampedW,
+        height: clampedH
       });
+      const updatedNode = diagramsCore.getNode(resized, options.id);
+      const newW = updatedNode?.width ?? clampedW ?? oldW;
+      const newH = updatedNode?.height ?? clampedH ?? oldH;
+      return clampBoundaryEventsAfterResize(resized, options.id, oldW, oldH, newW, newH);
     }
   };
 }
@@ -4319,10 +4632,15 @@ function createBpmnDiagramDocument(state, options = {}) {
   });
 }
 function serializeBpmnDiagram(state, options = {}) {
-  return serialization.serializeDiagram(diagramsCore.normalizeDiagramState(state), {
-    ...options,
-    diagramType: "bpmn"
-  });
+  const { viewport, ...docOptions } = options;
+  const normalized = diagramsCore.normalizeDiagramState(state);
+  if (viewport) {
+    return serialization.serializeDiagramSnapshot(
+      { nodes: normalized.nodes, edges: normalized.edges, viewport },
+      { ...docOptions, diagramType: "bpmn" }
+    );
+  }
+  return serialization.serializeDiagram(normalized, { ...docOptions, diagramType: "bpmn" });
 }
 function parseBpmnDiagramDocument(json) {
   const document = serialization.parseDiagramDocument(json);
@@ -4335,232 +4653,140 @@ function deserializeBpmnDiagram(json) {
   const document = parseBpmnDiagramDocument(json);
   return serialization.deserializeDiagram(JSON.stringify(document));
 }
-function runBpmnCommand(stack, command) {
-  return diagramsCore.executeCommand(stack, command);
-}
-function runBpmnCommands(stack, commands, options = {}) {
-  return diagramsCore.executeCommands(stack, commands, options);
-}
-
-// src/validation/index.ts
-function isFlowNode(type) {
-  return isEventType(type) || isGatewayType(type) || type.includes("Task") || type === "CallActivity" || type === "SubProcess" || type === "Transaction" || type === "EventSubProcess" || type === "AdHocSubProcess" || type === "ChoreographyTask" || type === "SubChoreography" || type === "CallChoreography";
-}
-function isProcessNode(type) {
-  return isFlowNode(type) && type !== "BoundaryEvent";
-}
-function isSubProcess2(type) {
-  return type === "SubProcess" || type === "Transaction" || type === "EventSubProcess" || type === "AdHocSubProcess";
-}
-function isCatchTarget(type) {
-  return type === "IntermediateCatchEvent" || type === "ReceiveTask";
-}
-function poolAncestor(node, nodeById2) {
-  let current = node;
-  const visited = /* @__PURE__ */ new Set();
-  while (current?.parentId && !visited.has(current.id)) {
-    visited.add(current.id);
-    const parent = nodeById2.get(current.parentId);
-    if (parent?.data.elementType === "Pool") return parent.id;
-    current = parent;
-  }
-  return void 0;
+function deserializeBpmnDiagramSnapshot(json) {
+  const document = parseBpmnDiagramDocument(json);
+  return serialization.deserializeDiagramSnapshot(JSON.stringify(document));
 }
-function countSequenceEdges(edges, nodeId, direction) {
-  return edges.filter((edge) => {
-    if (edge.data?.edgeType !== "sequenceFlow") return false;
-    return direction === "in" ? edge.target === nodeId : edge.source === nodeId;
-  }).length;
+function createBpmnEventBus() {
+  return diagramsCore.createDiagramEventBus();
 }
-function sequenceEdges(edges) {
-  return edges.filter((edge) => (edge.data?.edgeType ?? edge.type) === "sequenceFlow");
+function runBpmnCommand(stack, command, bus) {
+  const next = diagramsCore.executeCommand(stack, command);
+  bus?.emit("command:executed", {
+    commandId: command.id,
+    ...command.label !== void 0 ? { label: command.label } : {},
+    state: next.current
+  });
+  return next;
 }
-function sequenceOut(edges, nodeId) {
-  return sequenceEdges(edges).filter((edge) => edge.source === nodeId);
+function runBpmnCommands(stack, commands, options = {}) {
+  const { bus, ...execOptions } = options;
+  const next = diagramsCore.executeCommands(stack, commands, execOptions);
+  bus?.emit("command:executed", {
+    commandId: execOptions.id ?? "bpmn.batch",
+    ...execOptions.label !== void 0 ? { label: execOptions.label } : {},
+    state: next.current
+  });
+  return next;
 }
-function sequenceIn(edges, nodeId) {
-  return sequenceEdges(edges).filter((edge) => edge.target === nodeId);
+function persistBpmnHistory(stack, diagramId) {
+  diagramsCore.persistCommandHistory(stack, `bpmn.history.${diagramId}`);
+}
+function restoreBpmnHistory(diagramId) {
+  return diagramsCore.restoreCommandHistory(`bpmn.history.${diagramId}`);
+}
+function computeBpmnSmartGuides(movingNodes, state, poolId) {
+  const movingIds = new Set(movingNodes.map((n) => n.id));
+  const staticNodes = state.nodes.filter((n) => {
+    if (movingIds.has(n.id)) return false;
+    const et = n.data.elementType;
+    if (et === "BoundaryEvent" || et === "Lane" || et === "Pool") return false;
+    if (poolId) {
+      const inPool = n.parentId === poolId || n.parentId !== void 0 && diagramsCore.getNode(state, n.parentId)?.parentId === poolId;
+      if (!inPool) return false;
+    }
+    return true;
+  });
+  return diagramsCore.computeSmartGuides(movingNodes, staticNodes);
 }
-function issue(code, severity, message, elementId, relatedElementIds) {
+function groupAsBpmnSubProcessCommand(options) {
   return {
-    id: `${code}:${elementId ?? relatedElementIds?.join(",") ?? "diagram"}`,
-    code,
-    severity,
-    message,
-    ...elementId ? { elementId } : {},
-    ...relatedElementIds ? { relatedElementIds } : {}
-  };
-}
-function validateBpmnDiagram(nodes, edges, options = {}) {
-  const opts = {
-    requireStartEvent: true,
-    requireEndEvent: true,
-    strictNames: false,
-    ...options
-  };
-  const issues = [];
-  const nodeById2 = new Map(nodes.map((node) => [node.id, node]));
-  const seqEdges = sequenceEdges(edges);
-  const processNodes = nodes.filter((node) => isProcessNode(node.data.elementType));
-  if (opts.requireStartEvent && !processNodes.some((node) => node.data.elementType === "StartEvent")) {
-    issues.push(issue("bpmn/start-event-required", "error", "The diagram must contain at least one start event."));
-  }
-  if (opts.requireEndEvent && !processNodes.some((node) => node.data.elementType === "EndEvent")) {
-    issues.push(issue("bpmn/end-event-required", "error", "The diagram must contain at least one end event."));
-  }
-  for (const edge of edges) {
-    const edgeType = edge.data?.edgeType ?? edge.type;
-    const source = nodeById2.get(edge.source);
-    const target = nodeById2.get(edge.target);
-    if (!source || !target) {
-      issues.push(issue(
-        "bpmn/no-orphan-edges",
-        "error",
-        `Edge "${edge.id}" references a missing ${!source ? "source" : "target"} node.`,
-        edge.id,
-        [edge.source, edge.target]
-      ));
-      continue;
-    }
-    if (edge.source === edge.target) {
-      issues.push(issue("bpmn/no-self-loop", "error", "BPMN edges cannot connect an element to itself.", edge.id, [edge.source]));
-    }
-    if (edgeType === "sequenceFlow") {
-      if (!isFlowNode(source.data.elementType) || !isFlowNode(target.data.elementType) || isDataType(source.data.elementType) || isDataType(target.data.elementType)) {
-        issues.push(issue("bpmn/sequence-flow-valid-endpoints", "error", "Sequence flows must connect BPMN flow nodes.", edge.id, [source.id, target.id]));
-      }
-      const sourcePool = poolAncestor(source, nodeById2);
-      const targetPool = poolAncestor(target, nodeById2);
-      if (sourcePool && targetPool && sourcePool !== targetPool) {
-        issues.push(issue("bpmn/sequence-flow-no-cross-pool", "error", "Sequence flows cannot cross pools. Use message flow between participants.", edge.id, [source.id, target.id]));
-      }
-    }
-    if (edgeType === "messageFlow") {
-      const sourcePool = poolAncestor(source, nodeById2);
-      const targetPool = poolAncestor(target, nodeById2);
-      if (!sourcePool || !targetPool || sourcePool === targetPool) {
-        issues.push(issue("bpmn/message-flow-valid-endpoints", "error", "Message flows must connect flow nodes in different pools.", edge.id, [source.id, target.id]));
-      }
-      if (!isFlowNode(source.data.elementType) || !isFlowNode(target.data.elementType)) {
-        issues.push(issue("bpmn/message-flow-valid-endpoints", "error", "Message flows must connect BPMN flow nodes, not containers.", edge.id, [source.id, target.id]));
-      }
-    }
-    if (edgeType === "dataAssociation") {
-      const hasDataEndpoint = isDataType(source.data.elementType) || isDataType(target.data.elementType);
-      const hasFlowEndpoint = isFlowNode(source.data.elementType) || isFlowNode(target.data.elementType);
-      if (!hasDataEndpoint || !hasFlowEndpoint) {
-        issues.push(issue("bpmn/data-association-valid-endpoints", "error", "Data associations must connect data elements with flow nodes.", edge.id, [source.id, target.id]));
+    id: `bpmn.groupAsSubProcess.${options.groupId ?? options.nodeIds.join(".")}`,
+    label: "Group as SubProcess",
+    execute: (state) => {
+      for (const nodeId of options.nodeIds) {
+        const node = diagramsCore.getNode(state, nodeId);
+        if (!node) continue;
+        const result = canContainBpmnElement("SubProcess", node.data.elementType);
+        if (result !== true) throw new Error(result);
       }
+      const groupId = options.groupId ?? diagramsCore.createUniqueId("subprocess", state.nodes.map((n) => n.id));
+      const groupNode = createBpmnNode({
+        id: groupId,
+        elementType: "SubProcess",
+        position: { x: 0, y: 0 },
+        ...options.label !== void 0 ? { label: options.label } : {},
+        ...options.data !== void 0 ? { data: options.data } : {}
+      });
+      return diagramsCore.groupNodes(state, {
+        groupNode,
+        nodeIds: options.nodeIds,
+        padding: options.padding ?? 20
+      });
     }
+  };
+}
+function getBpmnTabOrder(state, poolId) {
+  if (!poolId) return diagramsCore.getNodeTabOrder(state);
+  const pool = diagramsCore.getNode(state, poolId);
+  if (!pool) return [];
+  const scopeIds = state.nodes.filter((n) => {
+    if (n.id === poolId) return false;
+    if (n.parentId === poolId) return true;
+    const parent = diagramsCore.getNode(state, n.parentId ?? "");
+    return parent?.parentId === poolId;
+  }).map((n) => n.id);
+  return diagramsCore.getNodeTabOrder(state, scopeIds);
+}
+function getBpmnEdgeLabelLayout(edgeId, state, options) {
+  const edge = state.edges.find((e) => e.id === edgeId);
+  if (!edge) return null;
+  const routingPoints = edge.data?.routingPoints ?? [];
+  if (routingPoints.length >= 2) {
+    return diagramsCore.getEdgeLabelLayout(routingPoints, options);
   }
-  const duplicateSequenceKeys = /* @__PURE__ */ new Set();
-  const reportedDuplicateKeys = /* @__PURE__ */ new Set();
-  for (const edge of seqEdges) {
-    const key = `${edge.source}->${edge.target}`;
-    if (duplicateSequenceKeys.has(key) && !reportedDuplicateKeys.has(key)) {
-      reportedDuplicateKeys.add(key);
-      issues.push(issue("bpmn/no-duplicate-sequence-flow", "error", "Only one sequence flow is allowed between the same source and target.", edge.id, [edge.source, edge.target]));
-    }
-    duplicateSequenceKeys.add(key);
-  }
-  for (const node of nodes) {
-    const type = node.data.elementType;
-    const incoming = countSequenceEdges(edges, node.id, "in");
-    const outgoing = countSequenceEdges(edges, node.id, "out");
-    const meta = BPMN_ELEMENT_CATALOG[type];
-    if (type === "StartEvent" && incoming > 0) {
-      issues.push(issue("bpmn/start-event-no-incoming", "error", "Start events cannot have incoming sequence flows.", node.id));
-    }
-    if (type === "EndEvent") {
-      if (outgoing > 0) issues.push(issue("bpmn/no-outgoing-from-end-event", "error", "End events cannot have outgoing sequence flows.", node.id));
-      if (incoming === 0) issues.push(issue("bpmn/end-event-has-incoming", "error", "End events should have at least one incoming sequence flow.", node.id));
-    }
-    if ((type === "IntermediateCatchEvent" || type === "IntermediateThrowEvent") && (incoming === 0 || outgoing === 0)) {
-      issues.push(issue("bpmn/intermediate-event-both-flows", "error", "Intermediate events should have both incoming and outgoing sequence flows.", node.id));
-    }
-    if (type === "BoundaryEvent") {
-      const hostId = node.data.attachedToRef ?? node.parentId;
-      const host = hostId ? nodeById2.get(hostId) : void 0;
-      if (!host || !BPMN_ELEMENT_CATALOG[host.data.elementType]?.acceptsBoundaryEvents) {
-        issues.push(issue("bpmn/boundary-event-attached", "error", "Boundary events must be attached to an activity or subprocess.", node.id, hostId ? [hostId] : void 0));
-      }
-      if (sequenceIn(edges, node.id).length > 0) {
-        issues.push(issue("bpmn/boundary-no-incoming", "error", "Boundary events cannot have incoming sequence flows.", node.id));
-      }
-      if (sequenceOut(edges, node.id).length === 0) {
-        issues.push(issue("bpmn/boundary-has-outgoing", "warning", "Boundary events should define an outgoing exception path.", node.id));
-      }
-    }
-    if (isGatewayType(type)) {
-      if (incoming === 0) issues.push(issue("bpmn/gateway-has-incoming", "error", "Gateways should have at least one incoming sequence flow.", node.id));
-      if (outgoing === 0) issues.push(issue("bpmn/gateway-has-outgoing", "error", "Gateways should have at least one outgoing sequence flow.", node.id));
-    }
-    if (type === "ExclusiveGateway" || type === "InclusiveGateway" || type === "ComplexGateway") {
-      const outgoingEdges = sequenceOut(edges, node.id);
-      const defaults = outgoingEdges.filter((edge) => edge.data?.isDefault);
-      if (defaults.length > 1) {
-        issues.push(issue("bpmn/gateway-single-default", "error", "Gateways can have at most one default sequence flow.", node.id, defaults.map((edge) => edge.id)));
-      }
-      if (outgoingEdges.length >= 2) {
-        for (const edge of outgoingEdges) {
-          if (!edge.data?.isDefault && !edge.data?.conditionExpression) {
-            issues.push(issue("bpmn/gateway-condition", "error", "Conditional gateway branches should have a condition or be marked as default.", edge.id, [node.id, edge.target]));
-          }
-        }
-      }
-    }
-    if (type === "EventBasedGateway") {
-      const outgoingEdges = edges.filter((edge) => edge.data?.edgeType === "sequenceFlow" && edge.source === node.id);
-      if (outgoingEdges.length < 2) {
-        issues.push(issue("bpmn/event-based-gateway-min-outgoing", "error", "Event-based gateways should have at least two outgoing sequence flows.", node.id));
-      }
-      for (const edge of outgoingEdges) {
-        const target = nodeById2.get(edge.target);
-        if (target && !isCatchTarget(target.data.elementType)) {
-          issues.push(issue("bpmn/event-based-gateway-valid-targets", "error", "Event-based gateways must target catch events or receive tasks.", edge.id, [node.id, target.id]));
-        }
-      }
-    }
-    if (meta.maxIncoming !== void 0 && incoming > meta.maxIncoming) {
-      issues.push(issue("bpmn/max-incoming", "error", `${type} cannot have more than ${meta.maxIncoming} incoming sequence flow(s).`, node.id));
-    }
-    if (meta.maxOutgoing !== void 0 && outgoing > meta.maxOutgoing) {
-      issues.push(issue("bpmn/max-outgoing", "error", `${type} cannot have more than ${meta.maxOutgoing} outgoing sequence flow(s).`, node.id));
-    }
-    if (opts.strictNames && (type.includes("Task") || isGatewayType(type)) && !node.data.label) {
-      issues.push(issue("bpmn/name-required", "warning", `${type} should have a label.`, node.id));
-    }
-    if (isSubProcess2(type)) {
-      const childNodes = nodes.filter((child) => child.parentId === node.id);
-      if (childNodes.length > 0) {
-        if (!childNodes.some((child) => child.data.elementType === "StartEvent")) {
-          issues.push(issue("bpmn/subprocess-has-start-end", "error", "Expanded subprocesses should contain a start event.", node.id));
-        }
-        if (!childNodes.some((child) => child.data.elementType === "EndEvent")) {
-          issues.push(issue("bpmn/subprocess-has-start-end", "error", "Expanded subprocesses should contain an end event.", node.id));
-        }
-      }
-      if (type === "EventSubProcess") {
-        const starts = childNodes.filter((child) => child.data.elementType === "StartEvent");
-        for (const start of starts) {
-          if (!start.data.trigger || start.data.trigger === "none") {
-            issues.push(issue("bpmn/event-subprocess-triggered-start", "error", "Event subprocess start events must define an event trigger.", start.id, [node.id]));
-          }
-        }
-      }
-    }
-    if (type === "Lane") {
-      const parent = node.parentId ? nodeById2.get(node.parentId) : void 0;
-      if (parent?.data.elementType !== "Pool") {
-        issues.push(issue("bpmn/lane-parent-pool", "error", "Lanes must be contained by a pool.", node.id));
+  const sourceNode = diagramsCore.getNode(state, edge.source);
+  const targetNode = diagramsCore.getNode(state, edge.target);
+  if (!sourceNode || !targetNode) return null;
+  const sourceAbsPos = getBpmnNodeAbsolutePosition(state, edge.source) ?? sourceNode.position;
+  const targetAbsPos = getBpmnNodeAbsolutePosition(state, edge.target) ?? targetNode.position;
+  const sourceCenter = diagramsCore.getNodeCenterPosition(sourceAbsPos, getBpmnNodeSize(sourceNode));
+  const targetCenter = diagramsCore.getNodeCenterPosition(targetAbsPos, getBpmnNodeSize(targetNode));
+  return diagramsCore.getEdgeLabelLayout([sourceCenter, targetCenter], options);
+}
+function resizeBpmnNodeByHandleCommand(options) {
+  return {
+    id: `bpmn.resizeByHandle.${options.id}`,
+    label: "Resize BPMN element",
+    execute: (state) => {
+      const node = diagramsCore.getNode(state, options.id);
+      if (!node) throw new Error(`Element "${options.id}" does not exist.`);
+      const size = getBpmnElementSize(node.data.elementType);
+      if (!size.resizable) {
+        throw new Error(`${node.data.elementType} is not resizable in BPMN.`);
       }
+      const oldW = node.width ?? size.width;
+      const oldH = node.height ?? size.height;
+      const resized = diagramsCore.resizeNodeByHandle(state, {
+        id: options.id,
+        handle: options.handle,
+        dx: options.dx,
+        dy: options.dy,
+        constraints: { minWidth: size.minWidth, minHeight: size.minHeight }
+      });
+      const updatedNode = diagramsCore.getNode(resized, options.id);
+      const newW = updatedNode?.width ?? oldW;
+      const newH = updatedNode?.height ?? oldH;
+      return clampBoundaryEventsAfterResize(resized, options.id, oldW, oldH, newW, newH);
     }
-  }
-  return {
-    valid: issues.every((item) => item.severity !== "error"),
-    issues
   };
 }
+function createBpmnLayoutCache(options) {
+  return diagramsCore.createLayoutCache(options);
+}
+function withBpmnLayoutCache(layoutFn, cache) {
+  return diagramsCore.withLayoutCache(layoutFn, cache ?? diagramsCore.createLayoutCache());
+}
 
 exports.AnnotationNode = AnnotationNode;
 exports.AssociationEdge = AssociationEdge;
@@ -4604,17 +4830,22 @@ exports.acceptsBoundaryEvents = acceptsBoundaryEvents;
 exports.attachBoundaryEventCommand = attachBoundaryEventCommand;
 exports.bpmnConnectionValidators = bpmnConnectionValidators;
 exports.canContainBpmnElement = canContainBpmnElement;
+exports.computeBpmnSmartGuides = computeBpmnSmartGuides;
 exports.connectBpmnCommand = connectBpmnCommand;
 exports.copyBpmnElements = copyBpmnElements;
 exports.createBpmnDiagramDocument = createBpmnDiagramDocument;
+exports.createBpmnEventBus = createBpmnEventBus;
+exports.createBpmnLayoutCache = createBpmnLayoutCache;
 exports.createBpmnNode = createBpmnNode;
 exports.createBpmnNodeCommand = createBpmnNodeCommand;
 exports.createSimulation = createSimulation;
 exports.deleteBpmnElementsCommand = deleteBpmnElementsCommand;
 exports.deserializeBpmnDiagram = deserializeBpmnDiagram;
+exports.deserializeBpmnDiagramSnapshot = deserializeBpmnDiagramSnapshot;
 exports.findBpmnContainerAt = findBpmnContainerAt;
 exports.fire = fire;
 exports.getBpmnDragHandleSelector = getBpmnDragHandleSelector;
+exports.getBpmnEdgeLabelLayout = getBpmnEdgeLabelLayout;
 exports.getBpmnElementSize = getBpmnElementSize;
 exports.getBpmnLaneIndexAtPosition = getBpmnLaneIndexAtPosition;
 exports.getBpmnNodeAbsolutePosition = getBpmnNodeAbsolutePosition;
@@ -4622,10 +4853,12 @@ exports.getBpmnNodeCenter = getBpmnNodeCenter;
 exports.getBpmnNodeSize = getBpmnNodeSize;
 exports.getBpmnNodeZIndex = getBpmnNodeZIndex;
 exports.getBpmnPoolLanes = getBpmnPoolLanes;
+exports.getBpmnTabOrder = getBpmnTabOrder;
 exports.getElementMeta = getElementMeta;
 exports.getFireable = getFireable;
 exports.getHandlePolicy = getHandlePolicy;
 exports.getOrientation = getOrientation;
+exports.groupAsBpmnSubProcessCommand = groupAsBpmnSubProcessCommand;
 exports.inferBpmnEdgeType = inferBpmnEdgeType;
 exports.isBpmnEdgeRoutingEditable = isBpmnEdgeRoutingEditable;
 exports.isBpmnElementResizable = isBpmnElementResizable;
@@ -4644,13 +4877,16 @@ exports.moveBpmnLaneCommand = moveBpmnLaneCommand;
 exports.parseBpmnDiagramDocument = parseBpmnDiagramDocument;
 exports.parseBpmnXml = parseBpmnXml;
 exports.pasteBpmnElementsCommand = pasteBpmnElementsCommand;
+exports.persistBpmnHistory = persistBpmnHistory;
 exports.reorderBpmnLane = reorderBpmnLane;
 exports.reorderBpmnLaneAfterDrop = reorderBpmnLaneAfterDrop;
 exports.reorderBpmnLaneCommand = reorderBpmnLaneCommand;
 exports.reparentBpmnNodeAtPosition = reparentBpmnNodeAtPosition;
 exports.reparentBpmnNodeCommand = reparentBpmnNodeCommand;
 exports.replaceBpmnNodeCommand = replaceBpmnNodeCommand;
+exports.resizeBpmnNodeByHandleCommand = resizeBpmnNodeByHandleCommand;
 exports.resizeBpmnNodeCommand = resizeBpmnNodeCommand;
+exports.restoreBpmnHistory = restoreBpmnHistory;
 exports.routeBpmnEdgeCommand = routeBpmnEdgeCommand;
 exports.runBpmnCommand = runBpmnCommand;
 exports.runBpmnCommands = runBpmnCommands;
@@ -4663,7 +4899,7 @@ exports.supportsMarkers = supportsMarkers;
 exports.tick = tick;
 exports.toBpmnRelativePosition = toBpmnRelativePosition;
 exports.validateBpmnConnectionForEdgeType = validateBpmnConnectionForEdgeType;
-exports.validateBpmnDiagram = validateBpmnDiagram;
+exports.withBpmnLayoutCache = withBpmnLayoutCache;
 exports.withBpmnNodeZIndexes = withBpmnNodeZIndexes;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map