@aranzatech/diagrams-bpmn 0.2.9 → 0.2.11

package/dist/index.d.cts

@@ -1,14 +1,112 @@
-export { B as BPMN_ELEMENT_CATALOG, a as BPMN_RESIZABLE_ELEMENT_TYPES, g as getBpmnElementSize, b as getElementMeta, i as isBpmnElementResizable } from './catalog-CjGdTFxc.cjs';
+export { B as BPMN_ELEMENT_CATALOG, a as BPMN_RESIZABLE_ELEMENT_TYPES, g as getBpmnElementSize, b as getElementMeta, i as isBpmnElementResizable } from './catalog-Ch3YT0-0.cjs';
 export { acceptsBoundaryEvents, getHandlePolicy, getOrientation, isChoreographyType, isContainerType, isConversationType, isDataType, isEventType, isGatewayType, isTaskType, supportsCollapse, supportsMarkers } from './elements/index.cjs';
-export { B as BpmnCategory, a as BpmnDefinitionsSet, b as BpmnEdgeData, c as BpmnEdgeType, d as BpmnElementMeta, e as BpmnElementSize, f as BpmnElementType, g as BpmnErrorDefinition, h as BpmnEscalationDefinition, i as BpmnEventDefinition, j as BpmnEventSemantics, k as BpmnHandlePolicy, l as BpmnMessageDefinition, m as BpmnNodeData, n as BpmnOrientation, o as BpmnProcessVariable, p as BpmnSignalDefinition, q as BpmnTimerDefinition, r as BpmnTimerKind, E as EventTrigger, S as SubProcessVariant, T as TaskMarker } from './types-wFn_tJLY.cjs';
+export { B as BpmnCategory, a as BpmnDefinitionsSet, b as BpmnEdgeData, c as BpmnEdgeType, d as BpmnElementMeta, e as BpmnElementSize, f as BpmnElementType, g as BpmnErrorDefinition, h as BpmnEscalationDefinition, i as BpmnEventDefinition, j as BpmnEventSemantics, k as BpmnHandlePolicy, l as BpmnMessageDefinition, m as BpmnNodeData, n as BpmnOrientation, o as BpmnProcessVariable, p as BpmnSignalDefinition, q as BpmnTimerDefinition, r as BpmnTimerKind, E as EventTrigger, S as SubProcessVariant, T as TaskMarker } from './types-BTuiBv7p.cjs';
 export { AnnotationNode, BPMN_NODE_TYPES, BoundaryEventNode, CallChoreographyNode, CallConversationNode, ChoreographyTaskNode, ConversationNode, DataInputNode, DataObjectNode, DataObjectReferenceNode, DataOutputNode, DataStoreNode, DataStoreReferenceNode, EndEventNode, GatewayNode, GroupNode, IntermediateCatchEventNode, IntermediateThrowEventNode, LaneNode, PoolNode, StartEventNode, SubChoreographyNode, SubConversationNode, SubProcessNode, TaskNode } from './nodes/index.cjs';
 export { AssociationEdge, BPMN_EDGE_TYPES, ConversationLinkEdge, DataAssociationEdge, MessageFlowEdge, SequenceFlowEdge } from './edges/index.cjs';
 export { parseBpmnXml, serializeBpmnXml } from './xml/index.cjs';
-export { B as BpmnExportOptions, a as BpmnImportResult, b as BpmnProcessModel, c as BpmnRFEdge, d as BpmnRFNode } from './types-BjVERSZn.cjs';
-export { SimDiagram, SimEdge, SimLogEntry, SimLogType, SimNode, SimStatus, SimToken, SimVariables, SimulationState, createSimulation, fire, getFireable, isCompleted, setVariable, tick } from './simulation/index.cjs';
+export { B as BpmnExportOptions, a as BpmnImportResult, b as BpmnProcessModel, c as BpmnRFEdge, d as BpmnRFNode } from './types-C7tONwP5.cjs';
+import { SimDiagram } from './simulation/index.cjs';
+export { SimEdge, SimLogEntry, SimLogType, SimNode, SimStatus, SimToken, SimVariables, SimulationState, createSimulation, fire, getFireable, isCompleted, setVariable, tick } from './simulation/index.cjs';
 export { BPMN_EDGE_CONNECTION_RULES, BPMN_MODELING_RULES, BPMN_POOL_LANE_LAYOUT, BPMN_ROUTABLE_EDGE_TYPES, BPMN_SELECTION_STYLE, BpmnClipboardState, BpmnConnectionRule, BpmnDiagramDocument, BpmnDiagramSnapshot, BpmnDiagramState, BpmnEventBus, ConnectBpmnOptions, CreateBpmnNodeOptions, FindBpmnContainerAtOptions, GroupAsBpmnSubProcessOptions, MoveBpmnLaneOptions, PasteBpmnOptions, ReorderBpmnLaneOptions, ReparentBpmnNodeAtPositionOptions, ReparentBpmnNodeOptions, ReplaceBpmnNodeOptions, ResizeBpmnNodeByHandleOptions, ResizeBpmnNodeOptions, RouteBpmnEdgeOptions, attachBoundaryEventCommand, bpmnConnectionValidators, canContainBpmnElement, computeBpmnSmartGuides, connectBpmnCommand, copyBpmnElements, createBpmnDiagramDocument, createBpmnEventBus, createBpmnLayoutCache, createBpmnNode, createBpmnNodeCommand, deleteBpmnElementsCommand, deserializeBpmnDiagram, deserializeBpmnDiagramSnapshot, findBpmnContainerAt, getBpmnDragHandleSelector, getBpmnEdgeLabelLayout, getBpmnLaneIndexAtPosition, getBpmnNodeAbsolutePosition, getBpmnNodeCenter, getBpmnNodeSize, getBpmnNodeZIndex, getBpmnPoolLanes, getBpmnTabOrder, groupAsBpmnSubProcessCommand, inferBpmnEdgeType, isBpmnDroppableInContainer, isBpmnEdgeRoutingEditable, isBpmnProcessNode, layoutBpmnPoolLaneNodes, layoutBpmnPoolLanes, moveBpmnLaneCommand, parseBpmnDiagramDocument, pasteBpmnElementsCommand, persistBpmnHistory, reorderBpmnLane, reorderBpmnLaneAfterDrop, reorderBpmnLaneCommand, reparentBpmnNodeAtPosition, reparentBpmnNodeCommand, replaceBpmnNodeCommand, resizeBpmnNodeByHandleCommand, resizeBpmnNodeCommand, restoreBpmnHistory, routeBpmnEdgeCommand, runBpmnCommand, runBpmnCommands, selectBpmnElementsCommand, serializeBpmnDiagram, toBpmnRelativePosition, validateBpmnConnectionForEdgeType, withBpmnLayoutCache, withBpmnNodeZIndexes } from './modeling/index.cjs';
 export { BpmnValidationIssue, BpmnValidationOptions, BpmnValidationResult, BpmnValidationSeverity } from './validation/index.cjs';
 import 'react/jsx-runtime';
 import '@xyflow/react';
 import '@aranzatech/diagrams-core';
 import '@aranzatech/diagrams-core/serialization';
+
+/**
+ * Branch weights for one gateway.
+ * Maps each outgoing sequence-flow edge ID to a non-negative weight.
+ * Weights are normalised internally so they need not sum to any specific value.
+ * An edge absent from the map inherits weight 1.
+ */
+type GatewayWeights = Record<string, number>;
+interface BatchSimConfig {
+    /**
+     * Number of process instances to simulate.
+     * @default 100
+     */
+    instances?: number;
+    /**
+     * Gateway branch weights. Keys are gateway node IDs; values map
+     * each outgoing edge ID to its relative weight.
+     * Applies to ExclusiveGateway and InclusiveGateway nodes.
+     * Gateways absent from this map fall back to condition evaluation
+     * or first-edge behaviour.
+     */
+    gatewayWeights?: Record<string, GatewayWeights>;
+    /**
+     * Simulated activity duration per node in milliseconds.
+     * Used to compute the `totalDurationMs` load indicator:
+     *   totalDurationMs = visits × nodeDurations[nodeId]
+     * Nodes absent from this map contribute 0 ms.
+     */
+    nodeDurations?: Record<string, number>;
+    /**
+     * Safety limit: maximum tick iterations per instance.
+     * Prevents infinite-loop diagrams from blocking indefinitely.
+     * @default 500
+     */
+    maxSteps?: number;
+}
+interface NodeSimStats {
+    /**
+     * Number of instances in which at least one token passed through
+     * this node. Value in [0, config.instances].
+     */
+    visits: number;
+    /**
+     * visits × nodeDurations[nodeId].
+     * Higher values indicate heavier aggregate load on this activity.
+     */
+    totalDurationMs: number;
+    /**
+     * Highest number of concurrent tokens at this node observed within
+     * any single instance. Values > 1 occur inside parallel branches.
+     */
+    peakConcurrency: number;
+}
+interface BatchSimResult {
+    /** Per-node aggregated statistics, keyed by node ID. */
+    nodeStats: Record<string, NodeSimStats>;
+    /** Instances that reached the EndEvent(s) successfully. */
+    completed: number;
+    /** Instances that stalled with tokens still present (deadlock). */
+    deadlocked: number;
+    /** Total instances attempted — equals `config.instances`. */
+    total: number;
+    /**
+     * Mean number of simulation steps across completed instances.
+     * Proxy for relative cycle time (higher = longer path).
+     * 0 when no instance completed.
+     */
+    avgSteps: number;
+}
+/**
+ * Run `config.instances` process instances through the diagram and
+ * aggregate per-node statistics for bottleneck analysis.
+ *
+ * Tasks are completed instantly (no wait time); gateway choices follow
+ * either the weights in `config.gatewayWeights` or the existing
+ * condition/default/first-edge logic when no weights are specified.
+ *
+ * @param diagram  - The BPMN graph to simulate.
+ * @param config   - Simulation parameters.
+ * @returns Aggregated {@link BatchSimResult}.
+ *
+ * @example
+ * ```ts
+ * const result = runBatchSimulation(diagram, {
+ *   instances: 200,
+ *   gatewayWeights: {
+ *     "gw_approve": { "edge_approved": 70, "edge_rejected": 30 },
+ *   },
+ *   nodeDurations: { "task_review": 3600_000 }, // 1 hour
+ * });
+ * const topBottleneck = Object.entries(result.nodeStats)
+ *   .sort((a, b) => b[1].totalDurationMs - a[1].totalDurationMs)[0];
+ * ```
+ */
+declare function runBatchSimulation(diagram: SimDiagram, config?: BatchSimConfig): BatchSimResult;
+
+export { type BatchSimConfig, type BatchSimResult, type GatewayWeights, type NodeSimStats, SimDiagram, runBatchSimulation };

package/dist/index.d.ts

@@ -1,14 +1,112 @@
-export { B as BPMN_ELEMENT_CATALOG, a as BPMN_RESIZABLE_ELEMENT_TYPES, g as getBpmnElementSize, b as getElementMeta, i as isBpmnElementResizable } from './catalog-DW0Hknp2.js';
+export { B as BPMN_ELEMENT_CATALOG, a as BPMN_RESIZABLE_ELEMENT_TYPES, g as getBpmnElementSize, b as getElementMeta, i as isBpmnElementResizable } from './catalog-BOwJOaXV.js';
 export { acceptsBoundaryEvents, getHandlePolicy, getOrientation, isChoreographyType, isContainerType, isConversationType, isDataType, isEventType, isGatewayType, isTaskType, supportsCollapse, supportsMarkers } from './elements/index.js';
-export { B as BpmnCategory, a as BpmnDefinitionsSet, b as BpmnEdgeData, c as BpmnEdgeType, d as BpmnElementMeta, e as BpmnElementSize, f as BpmnElementType, g as BpmnErrorDefinition, h as BpmnEscalationDefinition, i as BpmnEventDefinition, j as BpmnEventSemantics, k as BpmnHandlePolicy, l as BpmnMessageDefinition, m as BpmnNodeData, n as BpmnOrientation, o as BpmnProcessVariable, p as BpmnSignalDefinition, q as BpmnTimerDefinition, r as BpmnTimerKind, E as EventTrigger, S as SubProcessVariant, T as TaskMarker } from './types-wFn_tJLY.js';
+export { B as BpmnCategory, a as BpmnDefinitionsSet, b as BpmnEdgeData, c as BpmnEdgeType, d as BpmnElementMeta, e as BpmnElementSize, f as BpmnElementType, g as BpmnErrorDefinition, h as BpmnEscalationDefinition, i as BpmnEventDefinition, j as BpmnEventSemantics, k as BpmnHandlePolicy, l as BpmnMessageDefinition, m as BpmnNodeData, n as BpmnOrientation, o as BpmnProcessVariable, p as BpmnSignalDefinition, q as BpmnTimerDefinition, r as BpmnTimerKind, E as EventTrigger, S as SubProcessVariant, T as TaskMarker } from './types-BTuiBv7p.js';
 export { AnnotationNode, BPMN_NODE_TYPES, BoundaryEventNode, CallChoreographyNode, CallConversationNode, ChoreographyTaskNode, ConversationNode, DataInputNode, DataObjectNode, DataObjectReferenceNode, DataOutputNode, DataStoreNode, DataStoreReferenceNode, EndEventNode, GatewayNode, GroupNode, IntermediateCatchEventNode, IntermediateThrowEventNode, LaneNode, PoolNode, StartEventNode, SubChoreographyNode, SubConversationNode, SubProcessNode, TaskNode } from './nodes/index.js';
 export { AssociationEdge, BPMN_EDGE_TYPES, ConversationLinkEdge, DataAssociationEdge, MessageFlowEdge, SequenceFlowEdge } from './edges/index.js';
 export { parseBpmnXml, serializeBpmnXml } from './xml/index.js';
-export { B as BpmnExportOptions, a as BpmnImportResult, b as BpmnProcessModel, c as BpmnRFEdge, d as BpmnRFNode } from './types-CBgWMl9p.js';
-export { SimDiagram, SimEdge, SimLogEntry, SimLogType, SimNode, SimStatus, SimToken, SimVariables, SimulationState, createSimulation, fire, getFireable, isCompleted, setVariable, tick } from './simulation/index.js';
+export { B as BpmnExportOptions, a as BpmnImportResult, b as BpmnProcessModel, c as BpmnRFEdge, d as BpmnRFNode } from './types-DSDMCAre.js';
+import { SimDiagram } from './simulation/index.js';
+export { SimEdge, SimLogEntry, SimLogType, SimNode, SimStatus, SimToken, SimVariables, SimulationState, createSimulation, fire, getFireable, isCompleted, setVariable, tick } from './simulation/index.js';
 export { BPMN_EDGE_CONNECTION_RULES, BPMN_MODELING_RULES, BPMN_POOL_LANE_LAYOUT, BPMN_ROUTABLE_EDGE_TYPES, BPMN_SELECTION_STYLE, BpmnClipboardState, BpmnConnectionRule, BpmnDiagramDocument, BpmnDiagramSnapshot, BpmnDiagramState, BpmnEventBus, ConnectBpmnOptions, CreateBpmnNodeOptions, FindBpmnContainerAtOptions, GroupAsBpmnSubProcessOptions, MoveBpmnLaneOptions, PasteBpmnOptions, ReorderBpmnLaneOptions, ReparentBpmnNodeAtPositionOptions, ReparentBpmnNodeOptions, ReplaceBpmnNodeOptions, ResizeBpmnNodeByHandleOptions, ResizeBpmnNodeOptions, RouteBpmnEdgeOptions, attachBoundaryEventCommand, bpmnConnectionValidators, canContainBpmnElement, computeBpmnSmartGuides, connectBpmnCommand, copyBpmnElements, createBpmnDiagramDocument, createBpmnEventBus, createBpmnLayoutCache, createBpmnNode, createBpmnNodeCommand, deleteBpmnElementsCommand, deserializeBpmnDiagram, deserializeBpmnDiagramSnapshot, findBpmnContainerAt, getBpmnDragHandleSelector, getBpmnEdgeLabelLayout, getBpmnLaneIndexAtPosition, getBpmnNodeAbsolutePosition, getBpmnNodeCenter, getBpmnNodeSize, getBpmnNodeZIndex, getBpmnPoolLanes, getBpmnTabOrder, groupAsBpmnSubProcessCommand, inferBpmnEdgeType, isBpmnDroppableInContainer, isBpmnEdgeRoutingEditable, isBpmnProcessNode, layoutBpmnPoolLaneNodes, layoutBpmnPoolLanes, moveBpmnLaneCommand, parseBpmnDiagramDocument, pasteBpmnElementsCommand, persistBpmnHistory, reorderBpmnLane, reorderBpmnLaneAfterDrop, reorderBpmnLaneCommand, reparentBpmnNodeAtPosition, reparentBpmnNodeCommand, replaceBpmnNodeCommand, resizeBpmnNodeByHandleCommand, resizeBpmnNodeCommand, restoreBpmnHistory, routeBpmnEdgeCommand, runBpmnCommand, runBpmnCommands, selectBpmnElementsCommand, serializeBpmnDiagram, toBpmnRelativePosition, validateBpmnConnectionForEdgeType, withBpmnLayoutCache, withBpmnNodeZIndexes } from './modeling/index.js';
 export { BpmnValidationIssue, BpmnValidationOptions, BpmnValidationResult, BpmnValidationSeverity } from './validation/index.js';
 import 'react/jsx-runtime';
 import '@xyflow/react';
 import '@aranzatech/diagrams-core';
 import '@aranzatech/diagrams-core/serialization';
+
+/**
+ * Branch weights for one gateway.
+ * Maps each outgoing sequence-flow edge ID to a non-negative weight.
+ * Weights are normalised internally so they need not sum to any specific value.
+ * An edge absent from the map inherits weight 1.
+ */
+type GatewayWeights = Record<string, number>;
+interface BatchSimConfig {
+    /**
+     * Number of process instances to simulate.
+     * @default 100
+     */
+    instances?: number;
+    /**
+     * Gateway branch weights. Keys are gateway node IDs; values map
+     * each outgoing edge ID to its relative weight.
+     * Applies to ExclusiveGateway and InclusiveGateway nodes.
+     * Gateways absent from this map fall back to condition evaluation
+     * or first-edge behaviour.
+     */
+    gatewayWeights?: Record<string, GatewayWeights>;
+    /**
+     * Simulated activity duration per node in milliseconds.
+     * Used to compute the `totalDurationMs` load indicator:
+     *   totalDurationMs = visits × nodeDurations[nodeId]
+     * Nodes absent from this map contribute 0 ms.
+     */
+    nodeDurations?: Record<string, number>;
+    /**
+     * Safety limit: maximum tick iterations per instance.
+     * Prevents infinite-loop diagrams from blocking indefinitely.
+     * @default 500
+     */
+    maxSteps?: number;
+}
+interface NodeSimStats {
+    /**
+     * Number of instances in which at least one token passed through
+     * this node. Value in [0, config.instances].
+     */
+    visits: number;
+    /**
+     * visits × nodeDurations[nodeId].
+     * Higher values indicate heavier aggregate load on this activity.
+     */
+    totalDurationMs: number;
+    /**
+     * Highest number of concurrent tokens at this node observed within
+     * any single instance. Values > 1 occur inside parallel branches.
+     */
+    peakConcurrency: number;
+}
+interface BatchSimResult {
+    /** Per-node aggregated statistics, keyed by node ID. */
+    nodeStats: Record<string, NodeSimStats>;
+    /** Instances that reached the EndEvent(s) successfully. */
+    completed: number;
+    /** Instances that stalled with tokens still present (deadlock). */
+    deadlocked: number;
+    /** Total instances attempted — equals `config.instances`. */
+    total: number;
+    /**
+     * Mean number of simulation steps across completed instances.
+     * Proxy for relative cycle time (higher = longer path).
+     * 0 when no instance completed.
+     */
+    avgSteps: number;
+}
+/**
+ * Run `config.instances` process instances through the diagram and
+ * aggregate per-node statistics for bottleneck analysis.
+ *
+ * Tasks are completed instantly (no wait time); gateway choices follow
+ * either the weights in `config.gatewayWeights` or the existing
+ * condition/default/first-edge logic when no weights are specified.
+ *
+ * @param diagram  - The BPMN graph to simulate.
+ * @param config   - Simulation parameters.
+ * @returns Aggregated {@link BatchSimResult}.
+ *
+ * @example
+ * ```ts
+ * const result = runBatchSimulation(diagram, {
+ *   instances: 200,
+ *   gatewayWeights: {
+ *     "gw_approve": { "edge_approved": 70, "edge_rejected": 30 },
+ *   },
+ *   nodeDurations: { "task_review": 3600_000 }, // 1 hour
+ * });
+ * const topBottleneck = Object.entries(result.nodeStats)
+ *   .sort((a, b) => b[1].totalDurationMs - a[1].totalDurationMs)[0];
+ * ```
+ */
+declare function runBatchSimulation(diagram: SimDiagram, config?: BatchSimConfig): BatchSimResult;
+
+export { type BatchSimConfig, type BatchSimResult, type GatewayWeights, type NodeSimStats, SimDiagram, runBatchSimulation };

package/dist/index.js

@@ -2,10 +2,137 @@ import './chunk-OZKTOILD.js';
 export { AnnotationNode, BPMN_NODE_TYPES, BoundaryEventNode, CallChoreographyNode, CallConversationNode, ChoreographyTaskNode, ConversationNode, DataInputNode, DataObjectNode, DataObjectReferenceNode, DataOutputNode, DataStoreNode, DataStoreReferenceNode, EndEventNode, GatewayNode, GroupNode, IntermediateCatchEventNode, IntermediateThrowEventNode, LaneNode, PoolNode, StartEventNode, SubChoreographyNode, SubConversationNode, SubProcessNode, TaskNode } from './chunk-IMW6RG6F.js';
 export { AssociationEdge, BPMN_EDGE_TYPES, ConversationLinkEdge, DataAssociationEdge, MessageFlowEdge, SequenceFlowEdge } from './chunk-O3NWJ5H7.js';
 import './chunk-PDTXM32P.js';
-export { parseBpmnXml, serializeBpmnXml } from './chunk-KW2QVBOB.js';
+export { parseBpmnXml, serializeBpmnXml } from './chunk-HLCUGTEK.js';
+import { createSimulation, tick, getFireable, fire } from './chunk-M46UDUN3.js';
 export { createSimulation, fire, getFireable, isCompleted, setVariable, tick } from './chunk-M46UDUN3.js';
 export { BPMN_EDGE_CONNECTION_RULES, BPMN_MODELING_RULES, BPMN_POOL_LANE_LAYOUT, BPMN_ROUTABLE_EDGE_TYPES, BPMN_SELECTION_STYLE, attachBoundaryEventCommand, bpmnConnectionValidators, canContainBpmnElement, computeBpmnSmartGuides, connectBpmnCommand, copyBpmnElements, createBpmnDiagramDocument, createBpmnEventBus, createBpmnLayoutCache, createBpmnNode, createBpmnNodeCommand, deleteBpmnElementsCommand, deserializeBpmnDiagram, deserializeBpmnDiagramSnapshot, findBpmnContainerAt, getBpmnDragHandleSelector, getBpmnEdgeLabelLayout, getBpmnLaneIndexAtPosition, getBpmnNodeAbsolutePosition, getBpmnNodeCenter, getBpmnNodeSize, getBpmnNodeZIndex, getBpmnPoolLanes, getBpmnTabOrder, groupAsBpmnSubProcessCommand, inferBpmnEdgeType, isBpmnDroppableInContainer, isBpmnEdgeRoutingEditable, isBpmnProcessNode, layoutBpmnPoolLaneNodes, layoutBpmnPoolLanes, moveBpmnLaneCommand, parseBpmnDiagramDocument, pasteBpmnElementsCommand, persistBpmnHistory, reorderBpmnLane, reorderBpmnLaneAfterDrop, reorderBpmnLaneCommand, reparentBpmnNodeAtPosition, reparentBpmnNodeCommand, replaceBpmnNodeCommand, resizeBpmnNodeByHandleCommand, resizeBpmnNodeCommand, restoreBpmnHistory, routeBpmnEdgeCommand, runBpmnCommand, runBpmnCommands, selectBpmnElementsCommand, serializeBpmnDiagram, toBpmnRelativePosition, validateBpmnConnectionForEdgeType, withBpmnLayoutCache, withBpmnNodeZIndexes } from './chunk-UAWLUDKC.js';
 export { acceptsBoundaryEvents, getHandlePolicy, getOrientation, isChoreographyType, isContainerType, isConversationType, isDataType, isEventType, isGatewayType, isTaskType, supportsCollapse, supportsMarkers } from './chunk-RLAJNRF2.js';
 export { BPMN_ELEMENT_CATALOG, BPMN_RESIZABLE_ELEMENT_TYPES, getBpmnElementSize, getElementMeta, isBpmnElementResizable } from './chunk-L5Z22RLX.js';
+
+// src/simulation/batch.ts
+function weightedChoice(edgeIds, weights) {
+  if (edgeIds.length === 0) return "";
+  const w = edgeIds.map((id) => Math.max(0, weights[id] ?? 1));
+  const total = w.reduce((a, b) => a + b, 0);
+  if (total === 0) return edgeIds[0];
+  let r = Math.random() * total;
+  for (let i = 0; i < edgeIds.length; i++) {
+    r -= w[i];
+    if (r <= 0) return edgeIds[i];
+  }
+  return edgeIds[edgeIds.length - 1];
+}
+function buildBatchDiagram(diagram, gatewayWeights, gwVarMap) {
+  const patchedEdges = diagram.edges.map((edge) => {
+    const gwId = edge.source;
+    if (!(gwId in gatewayWeights) || edge.type !== "sequenceFlow") return edge;
+    const varName = gwVarMap[gwId];
+    const outEdges = diagram.edges.filter(
+      (e) => e.source === gwId && e.type === "sequenceFlow"
+    );
+    const idx = outEdges.findIndex((e) => e.id === edge.id);
+    if (idx === -1) return edge;
+    return {
+      ...edge,
+      conditionExpression: `\${${varName} == ${idx}}`,
+      isDefault: false
+    };
+  });
+  return { nodes: diagram.nodes, edges: patchedEdges };
+}
+function runOneInstance(diagram, initialVars, maxSteps) {
+  let state = createSimulation(diagram, initialVars);
+  state = tick(diagram, state);
+  const visitedNodes = /* @__PURE__ */ new Set();
+  const peakPerNode = {};
+  function snapshot() {
+    const counts = {};
+    for (const token of state.tokens) {
+      visitedNodes.add(token.elementId);
+      counts[token.elementId] = (counts[token.elementId] ?? 0) + 1;
+    }
+    for (const [nodeId, c] of Object.entries(counts)) {
+      if (c > (peakPerNode[nodeId] ?? 0)) peakPerNode[nodeId] = c;
+    }
+  }
+  snapshot();
+  let steps = 0;
+  while (state.status === "running" && steps < maxSteps) {
+    const fireable = getFireable(diagram, state);
+    if (fireable.length === 0) break;
+    for (const id of fireable) {
+      if (state.status !== "running") break;
+      state = fire(diagram, state, id);
+      snapshot();
+    }
+    steps++;
+  }
+  for (const entry of state.log) {
+    visitedNodes.add(entry.elementId);
+  }
+  return {
+    visitedNodes,
+    peakPerNode,
+    steps: state.step,
+    completed: state.status === "completed"
+  };
+}
+function runBatchSimulation(diagram, config = {}) {
+  const n = Math.max(1, config.instances ?? 100);
+  const maxSteps = Math.max(1, config.maxSteps ?? 500);
+  const gwWeights = config.gatewayWeights ?? {};
+  const nodeDurations = config.nodeDurations ?? {};
+  const gwVarMap = {};
+  Object.keys(gwWeights).forEach((gwId, i) => {
+    gwVarMap[gwId] = `__g${i}`;
+  });
+  const batchDiagram = Object.keys(gwWeights).length > 0 ? buildBatchDiagram(diagram, gwWeights, gwVarMap) : diagram;
+  const nodeStats = {};
+  function node(id) {
+    if (!nodeStats[id]) {
+      nodeStats[id] = { visits: 0, totalDurationMs: 0, peakConcurrency: 0 };
+    }
+    return nodeStats[id];
+  }
+  let completed = 0;
+  let deadlocked = 0;
+  let totalSteps = 0;
+  for (let i = 0; i < n; i++) {
+    const instanceVars = {};
+    for (const [gwId, varName] of Object.entries(gwVarMap)) {
+      const outEdges = diagram.edges.filter(
+        (e) => e.source === gwId && e.type === "sequenceFlow"
+      );
+      const edgeIds = outEdges.map((e) => e.id);
+      const chosen = weightedChoice(edgeIds, gwWeights[gwId]);
+      instanceVars[varName] = outEdges.findIndex((e) => e.id === chosen);
+    }
+    const result = runOneInstance(batchDiagram, instanceVars, maxSteps);
+    if (result.completed) {
+      completed++;
+      totalSteps += result.steps;
+    } else {
+      deadlocked++;
+    }
+    for (const nodeId of result.visitedNodes) {
+      const s = node(nodeId);
+      s.visits++;
+      s.totalDurationMs += nodeDurations[nodeId] ?? 0;
+    }
+    for (const [nodeId, peak] of Object.entries(result.peakPerNode)) {
+      const s = node(nodeId);
+      if (peak > s.peakConcurrency) s.peakConcurrency = peak;
+    }
+  }
+  return {
+    nodeStats,
+    completed,
+    deadlocked,
+    total: n,
+    avgSteps: completed > 0 ? Math.round(totalSteps / completed) : 0
+  };
+}
+
+export { runBatchSimulation };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../src/simulation/batch.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  createSimulation,\n  tick,\n  fire,\n  getFireable,\n} from \"./index\";\nimport type { SimDiagram, SimEdge } from \"./index\";\n\n// ─── Public types ─────────────────────────────────────────────────────────────\n\n/**\n * Branch weights for one gateway.\n * Maps each outgoing sequence-flow edge ID to a non-negative weight.\n * Weights are normalised internally so they need not sum to any specific value.\n * An edge absent from the map inherits weight 1.\n */\nexport type GatewayWeights = Record<string, number>;\n\nexport interface BatchSimConfig {\n  /**\n   * Number of process instances to simulate.\n   * @default 100\n   */\n  instances?: number;\n\n  /**\n   * Gateway branch weights. Keys are gateway node IDs; values map\n   * each outgoing edge ID to its relative weight.\n   * Applies to ExclusiveGateway and InclusiveGateway nodes.\n   * Gateways absent from this map fall back to condition evaluation\n   * or first-edge behaviour.\n   */\n  gatewayWeights?: Record<string, GatewayWeights>;\n\n  /**\n   * Simulated activity duration per node in milliseconds.\n   * Used to compute the `totalDurationMs` load indicator:\n   *   totalDurationMs = visits × nodeDurations[nodeId]\n   * Nodes absent from this map contribute 0 ms.\n   */\n  nodeDurations?: Record<string, number>;\n\n  /**\n   * Safety limit: maximum tick iterations per instance.\n   * Prevents infinite-loop diagrams from blocking indefinitely.\n   * @default 500\n   */\n  maxSteps?: number;\n}\n\nexport interface NodeSimStats {\n  /**\n   * Number of instances in which at least one token passed through\n   * this node. Value in [0, config.instances].\n   */\n  visits: number;\n\n  /**\n   * visits × nodeDurations[nodeId].\n   * Higher values indicate heavier aggregate load on this activity.\n   */\n  totalDurationMs: number;\n\n  /**\n   * Highest number of concurrent tokens at this node observed within\n   * any single instance. Values > 1 occur inside parallel branches.\n   */\n  peakConcurrency: number;\n}\n\nexport interface BatchSimResult {\n  /** Per-node aggregated statistics, keyed by node ID. */\n  nodeStats: Record<string, NodeSimStats>;\n\n  /** Instances that reached the EndEvent(s) successfully. */\n  completed: number;\n\n  /** Instances that stalled with tokens still present (deadlock). */\n  deadlocked: number;\n\n  /** Total instances attempted — equals `config.instances`. */\n  total: number;\n\n  /**\n   * Mean number of simulation steps across completed instances.\n   * Proxy for relative cycle time (higher = longer path).\n   * 0 when no instance completed.\n   */\n  avgSteps: number;\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\n/** Weighted random selection from a list of edge IDs. */\nfunction weightedChoice(edgeIds: string[], weights: GatewayWeights): string {\n  if (edgeIds.length === 0) return \"\";\n  const w = edgeIds.map((id) => Math.max(0, weights[id] ?? 1));\n  const total = w.reduce((a, b) => a + b, 0);\n  if (total === 0) return edgeIds[0];\n\n  let r = Math.random() * total;\n  for (let i = 0; i < edgeIds.length; i++) {\n    r -= w[i];\n    if (r <= 0) return edgeIds[i];\n  }\n  return edgeIds[edgeIds.length - 1];\n}\n\n/**\n * Builds a modified diagram where each weighted gateway's outgoing\n * sequence edges carry a synthetic condition expression keyed to a\n * deterministic per-instance variable `__g{i}`.\n *\n * This lets the existing ExclusiveGateway evaluator (condition-based)\n * implement probabilistic branching without touching the engine core.\n */\nfunction buildBatchDiagram(\n  diagram: SimDiagram,\n  gatewayWeights: Record<string, GatewayWeights>,\n  gwVarMap: Record<string, string>,\n): SimDiagram {\n  const patchedEdges: SimEdge[] = diagram.edges.map((edge) => {\n    const gwId = edge.source;\n    if (!(gwId in gatewayWeights) || edge.type !== \"sequenceFlow\") return edge;\n\n    const varName = gwVarMap[gwId];\n    const outEdges = diagram.edges.filter(\n      (e) => e.source === gwId && e.type === \"sequenceFlow\",\n    );\n    const idx = outEdges.findIndex((e) => e.id === edge.id);\n    if (idx === -1) return edge;\n\n    return {\n      ...edge,\n      conditionExpression: `\\${${varName} == ${idx}}`,\n      isDefault: false,\n    };\n  });\n\n  return { nodes: diagram.nodes, edges: patchedEdges };\n}\n\ninterface InstanceResult {\n  /** All node IDs touched by any token during this instance. */\n  visitedNodes: Set<string>;\n  /** Peak concurrent-token count per node observed during this instance. */\n  peakPerNode: Record<string, number>;\n  /** Final simulation step count. */\n  steps: number;\n  completed: boolean;\n}\n\n/**\n * Runs a single process instance to completion (or until the safety\n * limit is reached). Manual elements (Tasks, CatchEvents) are fired\n * immediately — simulating instant activity completion — so the\n * run is fully automated.\n */\nfunction runOneInstance(\n  diagram: SimDiagram,\n  initialVars: Record<string, string | number | boolean>,\n  maxSteps: number,\n): InstanceResult {\n  let state = createSimulation(diagram, initialVars);\n  state = tick(diagram, state);\n\n  const visitedNodes = new Set<string>();\n  const peakPerNode: Record<string, number> = {};\n\n  function snapshot() {\n    // Track which nodes are occupied and peak concurrency.\n    const counts: Record<string, number> = {};\n    for (const token of state.tokens) {\n      visitedNodes.add(token.elementId);\n      counts[token.elementId] = (counts[token.elementId] ?? 0) + 1;\n    }\n    for (const [nodeId, c] of Object.entries(counts)) {\n      if (c > (peakPerNode[nodeId] ?? 0)) peakPerNode[nodeId] = c;\n    }\n  }\n\n  snapshot();\n\n  let steps = 0;\n  while (state.status === \"running\" && steps < maxSteps) {\n    const fireable = getFireable(diagram, state);\n    if (fireable.length === 0) break;\n\n    for (const id of fireable) {\n      if (state.status !== \"running\") break;\n      state = fire(diagram, state, id);\n      snapshot();\n    }\n    steps++;\n  }\n\n  // Capture all nodes mentioned in the log (covers automatics that\n  // never appear as token positions but do appear in log entries).\n  for (const entry of state.log) {\n    visitedNodes.add(entry.elementId);\n  }\n\n  return {\n    visitedNodes,\n    peakPerNode,\n    steps: state.step,\n    completed: state.status === \"completed\",\n  };\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Run `config.instances` process instances through the diagram and\n * aggregate per-node statistics for bottleneck analysis.\n *\n * Tasks are completed instantly (no wait time); gateway choices follow\n * either the weights in `config.gatewayWeights` or the existing\n * condition/default/first-edge logic when no weights are specified.\n *\n * @param diagram  - The BPMN graph to simulate.\n * @param config   - Simulation parameters.\n * @returns Aggregated {@link BatchSimResult}.\n *\n * @example\n * ```ts\n * const result = runBatchSimulation(diagram, {\n *   instances: 200,\n *   gatewayWeights: {\n *     \"gw_approve\": { \"edge_approved\": 70, \"edge_rejected\": 30 },\n *   },\n *   nodeDurations: { \"task_review\": 3600_000 }, // 1 hour\n * });\n * const topBottleneck = Object.entries(result.nodeStats)\n *   .sort((a, b) => b[1].totalDurationMs - a[1].totalDurationMs)[0];\n * ```\n */\nexport function runBatchSimulation(\n  diagram: SimDiagram,\n  config: BatchSimConfig = {},\n): BatchSimResult {\n  const n = Math.max(1, config.instances ?? 100);\n  const maxSteps = Math.max(1, config.maxSteps ?? 500);\n  const gwWeights = config.gatewayWeights ?? {};\n  const nodeDurations = config.nodeDurations ?? {};\n\n  // Map each weighted gateway to a synthetic variable name (__g0, __g1, …)\n  const gwVarMap: Record<string, string> = {};\n  Object.keys(gwWeights).forEach((gwId, i) => {\n    gwVarMap[gwId] = `__g${i}`;\n  });\n\n  const batchDiagram =\n    Object.keys(gwWeights).length > 0\n      ? buildBatchDiagram(diagram, gwWeights, gwVarMap)\n      : diagram;\n\n  const nodeStats: Record<string, NodeSimStats> = {};\n\n  function node(id: string): NodeSimStats {\n    if (!nodeStats[id]) {\n      nodeStats[id] = { visits: 0, totalDurationMs: 0, peakConcurrency: 0 };\n    }\n    return nodeStats[id];\n  }\n\n  let completed = 0;\n  let deadlocked = 0;\n  let totalSteps = 0;\n\n  for (let i = 0; i < n; i++) {\n    // Resolve branch choices for this instance based on configured weights.\n    const instanceVars: Record<string, string | number | boolean> = {};\n    for (const [gwId, varName] of Object.entries(gwVarMap)) {\n      const outEdges = diagram.edges.filter(\n        (e) => e.source === gwId && e.type === \"sequenceFlow\",\n      );\n      const edgeIds = outEdges.map((e) => e.id);\n      const chosen = weightedChoice(edgeIds, gwWeights[gwId]);\n      instanceVars[varName] = outEdges.findIndex((e) => e.id === chosen);\n    }\n\n    const result = runOneInstance(batchDiagram, instanceVars, maxSteps);\n\n    if (result.completed) {\n      completed++;\n      totalSteps += result.steps;\n    } else {\n      deadlocked++;\n    }\n\n    // Accumulate per-node stats.\n    for (const nodeId of result.visitedNodes) {\n      const s = node(nodeId);\n      s.visits++;\n      s.totalDurationMs += nodeDurations[nodeId] ?? 0;\n    }\n\n    for (const [nodeId, peak] of Object.entries(result.peakPerNode)) {\n      const s = node(nodeId);\n      if (peak > s.peakConcurrency) s.peakConcurrency = peak;\n    }\n  }\n\n  return {\n    nodeStats,\n    completed,\n    deadlocked,\n    total: n,\n    avgSteps: completed > 0 ? Math.round(totalSteps / completed) : 0,\n  };\n}\n"]}

package/dist/layout/index.d.cts

@@ -1,12 +1,12 @@
 import { LayoutResult, LayoutOptions } from '@aranzatech/diagrams-core/types';
 export { applyLayoutResultToDiagram } from '@aranzatech/diagrams-core/layout';
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-BjVERSZn.cjs';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-C7tONwP5.cjs';
 import { BpmnDiagramState } from '../modeling/index.cjs';
 import '@xyflow/react';
-import '../types-wFn_tJLY.cjs';
+import '../types-BTuiBv7p.cjs';
 import '@aranzatech/diagrams-core';
 import '@aranzatech/diagrams-core/serialization';
-import '../catalog-CjGdTFxc.cjs';
+import '../catalog-Ch3YT0-0.cjs';
 
 /**
  * Dagre layout pre-configured for BPMN diagrams.

package/dist/layout/index.d.ts

@@ -1,12 +1,12 @@
 import { LayoutResult, LayoutOptions } from '@aranzatech/diagrams-core/types';
 export { applyLayoutResultToDiagram } from '@aranzatech/diagrams-core/layout';
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-CBgWMl9p.js';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-DSDMCAre.js';
 import { BpmnDiagramState } from '../modeling/index.js';
 import '@xyflow/react';
-import '../types-wFn_tJLY.js';
+import '../types-BTuiBv7p.js';
 import '@aranzatech/diagrams-core';
 import '@aranzatech/diagrams-core/serialization';
-import '../catalog-DW0Hknp2.js';
+import '../catalog-BOwJOaXV.js';
 
 /**
  * Dagre layout pre-configured for BPMN diagrams.

package/dist/modeling/index.d.cts

@@ -1,8 +1,8 @@
 import { ModelingRules, ClipboardState, DiagramSnapshot, DiagramState, DiagramEventBus, ResizeHandlePosition, DiagramCommand, ConnectionValidator, SmartGuideResult, SelectionState, LayoutCacheOptions, LayoutCache, EdgeLabelOffsetOptions, EdgeLabelLayout, CommandStackState, Viewport, LayoutFn } from '@aranzatech/diagrams-core';
 import { DiagramDocument, CreateDiagramDocumentOptions } from '@aranzatech/diagrams-core/serialization';
-import { c as BpmnEdgeType, b as BpmnEdgeData, f as BpmnElementType, m as BpmnNodeData } from '../types-wFn_tJLY.cjs';
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-BjVERSZn.cjs';
-export { g as getBpmnElementSize, i as isBpmnElementResizable } from '../catalog-CjGdTFxc.cjs';
+import { c as BpmnEdgeType, b as BpmnEdgeData, f as BpmnElementType, m as BpmnNodeData } from '../types-BTuiBv7p.cjs';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-C7tONwP5.cjs';
+export { g as getBpmnElementSize, i as isBpmnElementResizable } from '../catalog-Ch3YT0-0.cjs';
 import '@xyflow/react';
 
 type BpmnDiagramState = DiagramState<BpmnRFNode, BpmnRFEdge>;

package/dist/modeling/index.d.ts

@@ -1,8 +1,8 @@
 import { ModelingRules, ClipboardState, DiagramSnapshot, DiagramState, DiagramEventBus, ResizeHandlePosition, DiagramCommand, ConnectionValidator, SmartGuideResult, SelectionState, LayoutCacheOptions, LayoutCache, EdgeLabelOffsetOptions, EdgeLabelLayout, CommandStackState, Viewport, LayoutFn } from '@aranzatech/diagrams-core';
 import { DiagramDocument, CreateDiagramDocumentOptions } from '@aranzatech/diagrams-core/serialization';
-import { c as BpmnEdgeType, b as BpmnEdgeData, f as BpmnElementType, m as BpmnNodeData } from '../types-wFn_tJLY.js';
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-CBgWMl9p.js';
-export { g as getBpmnElementSize, i as isBpmnElementResizable } from '../catalog-DW0Hknp2.js';
+import { c as BpmnEdgeType, b as BpmnEdgeData, f as BpmnElementType, m as BpmnNodeData } from '../types-BTuiBv7p.js';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-DSDMCAre.js';
+export { g as getBpmnElementSize, i as isBpmnElementResizable } from '../catalog-BOwJOaXV.js';
 import '@xyflow/react';
 
 type BpmnDiagramState = DiagramState<BpmnRFNode, BpmnRFEdge>;

package/dist/{types-wFn_tJLY.d.cts → types-BTuiBv7p.d.cts}

@@ -168,6 +168,10 @@ interface BpmnNodeData extends Record<string, unknown> {
     decisionRef?: string;
     /** UserTask: form key resolved to a FormDefinition by name at runtime. */
     formKey?: string;
+    /** UserTask: comma-separated Flowable user ids that can claim this task. */
+    candidateUsers?: string;
+    /** UserTask: comma-separated Flowable group ids that can claim this task. */
+    candidateGroups?: string;
     /** AdHocSubProcess: FEEL expression that determines when the sub-process completes. */
     completionCondition?: string;
 }

package/dist/{types-wFn_tJLY.d.ts → types-BTuiBv7p.d.ts}

@@ -168,6 +168,10 @@ interface BpmnNodeData extends Record<string, unknown> {
     decisionRef?: string;
     /** UserTask: form key resolved to a FormDefinition by name at runtime. */
     formKey?: string;
+    /** UserTask: comma-separated Flowable user ids that can claim this task. */
+    candidateUsers?: string;
+    /** UserTask: comma-separated Flowable group ids that can claim this task. */
+    candidateGroups?: string;
     /** AdHocSubProcess: FEEL expression that determines when the sub-process completes. */
     completionCondition?: string;
 }

package/dist/{types-BjVERSZn.d.cts → types-C7tONwP5.d.cts}

@@ -1,5 +1,5 @@
 import { Node, Edge } from '@xyflow/react';
-import { m as BpmnNodeData, b as BpmnEdgeData, a as BpmnDefinitionsSet } from './types-wFn_tJLY.cjs';
+import { m as BpmnNodeData, b as BpmnEdgeData, a as BpmnDefinitionsSet } from './types-BTuiBv7p.cjs';
 
 type BpmnRFNode = Node<BpmnNodeData>;
 type BpmnRFEdge = Edge<BpmnEdgeData>;

package/dist/{types-CBgWMl9p.d.ts → types-DSDMCAre.d.ts}

@@ -1,5 +1,5 @@
 import { Node, Edge } from '@xyflow/react';
-import { m as BpmnNodeData, b as BpmnEdgeData, a as BpmnDefinitionsSet } from './types-wFn_tJLY.js';
+import { m as BpmnNodeData, b as BpmnEdgeData, a as BpmnDefinitionsSet } from './types-BTuiBv7p.js';
 
 type BpmnRFNode = Node<BpmnNodeData>;
 type BpmnRFEdge = Edge<BpmnEdgeData>;

package/dist/validation/index.d.cts

@@ -1,6 +1,6 @@
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-BjVERSZn.cjs';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-C7tONwP5.cjs';
 import '@xyflow/react';
-import '../types-wFn_tJLY.cjs';
+import '../types-BTuiBv7p.cjs';
 
 type BpmnValidationSeverity = "error" | "warning" | "info";
 interface BpmnValidationIssue {

package/dist/validation/index.d.ts

@@ -1,6 +1,6 @@
-import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-CBgWMl9p.js';
+import { d as BpmnRFNode, c as BpmnRFEdge } from '../types-DSDMCAre.js';
 import '@xyflow/react';
-import '../types-wFn_tJLY.js';
+import '../types-BTuiBv7p.js';
 
 type BpmnValidationSeverity = "error" | "warning" | "info";
 interface BpmnValidationIssue {

package/dist/xml/index.cjs

@@ -23,7 +23,10 @@ var ARANZA_DESCRIPTOR = {
         // 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" }
+        { 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" }
       ]
     }
   ],
@@ -897,6 +900,10 @@ function extractAranzaExtensions(el) {
     if (fde) result.flowableDelegateExpression = fde;
     const fk = asString(elAttrs["flowable:formKey"]);
     if (fk) result.formKey = fk;
+    const cu = asString(elAttrs["flowable:candidateUsers"]);
+    if (cu) result.candidateUsers = cu;
+    const cg = asString(elAttrs["flowable:candidateGroups"]);
+    if (cg) result.candidateGroups = cg;
   }
   const ext = el.extensionElements;
   if (!ext) return result;
@@ -922,6 +929,10 @@ function extractAranzaExtensions(el) {
   if (decisionRef) result.decisionRef = decisionRef;
   const formKey = asString(taskConfig.formKey);
   if (formKey) result.formKey = formKey;
+  const candidateUsers = asString(taskConfig.candidateUsers);
+  if (candidateUsers) result.candidateUsers = candidateUsers;
+  const candidateGroups = asString(taskConfig.candidateGroups);
+  if (candidateGroups) result.candidateGroups = candidateGroups;
   return result;
 }
 function extractCompletionCondition(el) {
@@ -1291,7 +1302,9 @@ function buildAranzaExtensionElements(moddle, node) {
   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;
-  if (!priority && !owner && !sla && !connector && !action && !flowableType && !flowableDelegateExpression && !decisionRef && !formKey) {
+  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) {
     return null;
   }
   const configAttrs = {};
@@ -1304,6 +1317,8 @@ function buildAranzaExtensionElements(moddle, node) {
   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;
   const taskConfig = moddle.create("aranza:TaskConfig", configAttrs);
   return moddle.create("bpmn:ExtensionElements", { values: [taskConfig] });
 }
@@ -1486,8 +1501,14 @@ function buildFlowElement(moddle, node, allNodes, allEdges) {
     if (script) attrs.script = script;
   }
   if (elementType === "UserTask") {
+    const flowableAttrs = {};
     const fk = typeof node.data.formKey === "string" ? node.data.formKey : void 0;
-    if (fk) attrs.$attrs = { "flowable:formKey": fk };
+    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 = {};