aurea-eden 1.43.1 → 1.44.0

package/README.md

@@ -72,6 +72,8 @@ Aurea EDEN addresses this gap.
 | **Value Bars** | Animate 3D data columns atop elements in ANALYZE mode — color-coded per slot |
 | **Multiple Bars** | Elements can carry 1–N side-by-side bars, independently normalized per slot |
 | **Active Task Badges** | Gold/silver animated 3D star badges for my-task / other-task process states |
+| **Native Auto-Layout** | Robust 2-pass BFS topology engine with support for geometric user overrides |
+| **Headless Graphs** | Decoupled semantics allow instantiating and exporting zero-coordinate edges natively |
 | **Method Chaining API** | Fluent, composable API: `.addTask().positionRightOf().addValueBar()...` |
 | **BPMN Import** | Parse BPMN 2.0 XML and render it as a live 3D diagram |
 | **Vue Component** | Drop-in `<AureaEdenBpmnDiagram>` component for Vue 3 / Vuetify apps |
@@ -294,6 +296,25 @@ Connection point identifiers: `'N'`, `'S'`, `'E'`, `'W'` (and their full-name eq
 
 ---
 
+### Auto-Layout (Topology Engine)
+
+Aurea EDEN features a powerful, fully-native multi-pass rendering engine that eliminates the need for manual `.positionRightOf()` boilerplate when handling complex logical graphs. 
+
+```javascript
+// 1. Pass the unpositioned, arbitrary topology
+// 2. Provide an optional array of manual visual overrides
+diagram.autoLayout([
+    { elementId: 'task_3', placementCommand: 'positionUpOf', relativeToId: 'task_2' }
+]);
+```
+* **Pass 1:** Cleanses manual alignment drift and reorganizes the logical graph using a mathematically pure Breadth-First-Search (BFS) parallel lane strategy.
+* **Pass 2:** Automatically executes a Topological Depth-First-Search (DFS) sort across your explicit visual `overrides` array, safely applying them without creating dependency cycles.
+* **Pass 3:** Scans the finished scene and resolves any remaining physical AABB overlaps through geometric physics sweeps.
+
+> **Note:** The semantic connection framework is fully decoupled from visual geometry. This means you can flawlessly instantiate hundreds of zero-coordinate sequence edges "headlessly" without breaking the engine, and then perfectly reorganize them later with a single `.autoLayout()` call!
+
+---
+
 ### Value Bars (ANALYZE mode)
 
 Value bars are 3D columns that rise from elements when the diagram is in `ANALYZE` mode. Each element can have **one or more** bars placed side-by-side (element width is divided equally).

package/dist/bpmn-diagram.es.js

@@ -60421,7 +60421,7 @@ SPREAD LOG: Target ${nodeId} Port ${basePort}`);
     return text.replace(/\n/g, "\\n").replace(/'/g, "\\'");
   }
 }
-const version = "1.43.1";
+const version = "1.44.0";
 var Easing = Object.freeze({
   Linear: Object.freeze({
     None: function(amount) {
@@ -64618,9 +64618,17 @@ class RoundedCornerOrthogonalConnectorShape extends Shape2 {
     const width = lineWidth / 2;
     const color = Colors.ELEMENT_STROKE;
     const extrudeSettings = ExtrusionParameters$1;
-    if (!connectorPoints || connectorPoints.length < 2) {
+    let pathLength = 0;
+    if (connectorPoints && connectorPoints.length >= 2) {
+      for (let i3 = 1; i3 < connectorPoints.length; i3++) {
+        pathLength += Math.sqrt(
+          Math.pow(connectorPoints[i3].x - connectorPoints[i3 - 1].x, 2) + Math.pow(connectorPoints[i3].y - connectorPoints[i3 - 1].y, 2)
+        );
+      }
+    }
+    if (!connectorPoints || connectorPoints.length < 2 || pathLength < 1e-3) {
       super(new BufferGeometry(), new DiagramEditMaterial(color));
-      this.points = [];
+      this.points = connectorPoints || [];
       return;
     }
     var connectorShape = new Shape$1();
@@ -65320,6 +65328,11 @@ class StraightDottedConnectorShape extends Shape2 {
     const gapLength = radius * 6;
     const direction = new Vector2().subVectors(p2, p1);
     const totalLength = direction.length();
+    if (totalLength < 1e-3) {
+      super(new BufferGeometry(), new DiagramEditMaterial(color));
+      this.points = connectorPoints || [];
+      return;
+    }
     direction.normalize();
     const shapes = [];
     let currentDist = 0;