@synergenius/flow-weaver 0.10.1 → 0.10.2

package/README.md

@@ -1,8 +1,12 @@
 # @synergenius/flow-weaver
 
-[![npm version](https://img.shields.io/npm/v/@synergenius/flow-weaver.svg)](https://www.npmjs.com/package/@synergenius/flow-weaver)
-[![License: Flow Weaver Library License](https://img.shields.io/badge/License-Flow%20Weaver%20Library-blue.svg)](./LICENSE)
-[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org)
+[![npm version](https://img.shields.io/npm/v/@synergenius/flow-weaver?style=flat)](https://www.npmjs.com/package/@synergenius/flow-weaver)
+[![npm downloads](https://img.shields.io/npm/dw/@synergenius/flow-weaver?style=flat)](https://www.npmjs.com/package/@synergenius/flow-weaver)
+[![CI](https://img.shields.io/github/actions/workflow/status/synergenius-fw/flow-weaver/ci.yml?branch=main&style=flat)](https://github.com/synergenius-fw/flow-weaver/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/moraispgsi/305430ef59a51d0a58eb61fefdfbe634/raw/flow-weaver-test-count.json&style=flat)](https://github.com/synergenius-fw/flow-weaver/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/codecov/c/github/synergenius-fw/flow-weaver?style=flat)](https://codecov.io/gh/synergenius-fw/flow-weaver)
+[![License: Flow Weaver Library License](https://img.shields.io/badge/License-Flow%20Weaver%20Library-blue?style=flat)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green?style=flat)](https://nodejs.org)
 
 **Build AI agent workflows visually. Ship them as your own code.**
 

package/dist/cli/flow-weaver.mjs

@@ -16881,6 +16881,121 @@ var require_browser = __commonJS({
   }
 });
 
+// node_modules/has-flag/index.js
+var require_has_flag = __commonJS({
+  "node_modules/has-flag/index.js"(exports2, module2) {
+    "use strict";
+    module2.exports = (flag, argv = process.argv) => {
+      const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
+      const position = argv.indexOf(prefix + flag);
+      const terminatorPosition = argv.indexOf("--");
+      return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
+    };
+  }
+});
+
+// node_modules/supports-color/index.js
+var require_supports_color = __commonJS({
+  "node_modules/supports-color/index.js"(exports2, module2) {
+    "use strict";
+    var os3 = __require("os");
+    var tty = __require("tty");
+    var hasFlag = require_has_flag();
+    var { env } = process;
+    var forceColor;
+    if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
+      forceColor = 0;
+    } else if (hasFlag("color") || hasFlag("colors") || hasFlag("color=true") || hasFlag("color=always")) {
+      forceColor = 1;
+    }
+    if ("FORCE_COLOR" in env) {
+      if (env.FORCE_COLOR === "true") {
+        forceColor = 1;
+      } else if (env.FORCE_COLOR === "false") {
+        forceColor = 0;
+      } else {
+        forceColor = env.FORCE_COLOR.length === 0 ? 1 : Math.min(parseInt(env.FORCE_COLOR, 10), 3);
+      }
+    }
+    function translateLevel(level) {
+      if (level === 0) {
+        return false;
+      }
+      return {
+        level,
+        hasBasic: true,
+        has256: level >= 2,
+        has16m: level >= 3
+      };
+    }
+    function supportsColor(haveStream, streamIsTTY) {
+      if (forceColor === 0) {
+        return 0;
+      }
+      if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
+        return 3;
+      }
+      if (hasFlag("color=256")) {
+        return 2;
+      }
+      if (haveStream && !streamIsTTY && forceColor === void 0) {
+        return 0;
+      }
+      const min = forceColor || 0;
+      if (env.TERM === "dumb") {
+        return min;
+      }
+      if (process.platform === "win32") {
+        const osRelease = os3.release().split(".");
+        if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
+          return Number(osRelease[2]) >= 14931 ? 3 : 2;
+        }
+        return 1;
+      }
+      if ("CI" in env) {
+        if (["TRAVIS", "CIRCLECI", "APPVEYOR", "GITLAB_CI", "GITHUB_ACTIONS", "BUILDKITE"].some((sign) => sign in env) || env.CI_NAME === "codeship") {
+          return 1;
+        }
+        return min;
+      }
+      if ("TEAMCITY_VERSION" in env) {
+        return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
+      }
+      if (env.COLORTERM === "truecolor") {
+        return 3;
+      }
+      if ("TERM_PROGRAM" in env) {
+        const version3 = parseInt((env.TERM_PROGRAM_VERSION || "").split(".")[0], 10);
+        switch (env.TERM_PROGRAM) {
+          case "iTerm.app":
+            return version3 >= 3 ? 3 : 2;
+          case "Apple_Terminal":
+            return 2;
+        }
+      }
+      if (/-256(color)?$/i.test(env.TERM)) {
+        return 2;
+      }
+      if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
+        return 1;
+      }
+      if ("COLORTERM" in env) {
+        return 1;
+      }
+      return min;
+    }
+    function getSupportLevel(stream2) {
+      const level = supportsColor(stream2, stream2 && stream2.isTTY);
+      return translateLevel(level);
+    }
+    module2.exports = {
+      supportsColor: getSupportLevel,
+      stdout: translateLevel(supportsColor(true, tty.isatty(1))),
+      stderr: translateLevel(supportsColor(true, tty.isatty(2)))
+    };
+  }
+});
+
 // node_modules/debug/src/node.js
 var require_node = __commonJS({
   "node_modules/debug/src/node.js"(exports2, module2) {
@@ -16899,7 +17014,7 @@ var require_node = __commonJS({
     );
     exports2.colors = [6, 2, 3, 4, 5, 1];
     try {
-      const supportsColor = __require("supports-color");
+      const supportsColor = require_supports_color();
       if (supportsColor && (supportsColor.stderr || supportsColor).level >= 2) {
         exports2.colors = [
           20,
@@ -61065,12 +61180,12 @@ function renderConnection(parts2, conn, gradIndex) {
     `  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
   );
 }
-function renderScopeConnection(parts2, conn, allConnections) {
+function renderScopeConnection(parts2, conn, allConnections, parentNodeId) {
   const gradIndex = allConnections.indexOf(conn);
   if (gradIndex < 0) return;
   const dashAttr = conn.isStepConnection ? "" : ' stroke-dasharray="8 4"';
   parts2.push(
-    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
+    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input" data-scope="${escapeXml(parentNodeId)}"/>`
   );
 }
 function renderNodeBody(parts2, node, theme, indent) {
@@ -61114,7 +61229,7 @@ function renderScopedContent(parts2, node, theme, themeName, allConnections) {
     `    <rect x="${scopeX}" y="${scopeY}" width="${scopeW}" height="${scopeH}" rx="4" fill="none" stroke="${theme.scopeAreaStroke}" stroke-width="1" stroke-dasharray="4 2" opacity="0.5"/>`
   );
   for (const conn of node.scopeConnections ?? []) {
-    renderScopeConnection(parts2, conn, allConnections);
+    renderScopeConnection(parts2, conn, allConnections, node.id);
   }
   if (scopePorts) {
     renderPortDots(parts2, node.id, scopePorts.inputs, scopePorts.outputs, themeName);
@@ -61662,7 +61777,7 @@ path[data-source].port-hover { opacity: 1; }
   var connIndex = [];
   content.querySelectorAll('path[data-source]').forEach(function(p) {
     var src = p.getAttribute('data-source'), tgt = p.getAttribute('data-target');
-    connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0] });
+    connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0], scopeOf: p.getAttribute('data-scope') || null });
   });
 
   // Snapshot of original port positions for reset
@@ -61704,9 +61819,18 @@ path[data-source].port-hover { opacity: 1; }
     off.dx += dx; off.dy += dy;
     var tr = 'translate(' + off.dx + ',' + off.dy + ')';
 
-    // Move node group
+    // Move node group (if nested inside a scoped parent, subtract parent offset)
     var nodeG = content.querySelector('.nodes [data-node-id="' + CSS.escape(nodeId) + '"]');
-    if (nodeG) nodeG.setAttribute('transform', tr);
+    if (nodeG) {
+      var parentNodeG = nodeG.parentElement ? nodeG.parentElement.closest('[data-node-id]') : null;
+      if (parentNodeG) {
+        var parentId = parentNodeG.getAttribute('data-node-id');
+        var parentOff = nodeOffsets[parentId] || { dx: 0, dy: 0 };
+        nodeG.setAttribute('transform', 'translate(' + (off.dx - parentOff.dx) + ',' + (off.dy - parentOff.dy) + ')');
+      } else {
+        nodeG.setAttribute('transform', tr);
+      }
+    }
 
     // Move label
     var labelG = content.querySelector('[data-label-for="' + CSS.escape(nodeId) + '"]');
@@ -61753,11 +61877,20 @@ path[data-source].port-hover { opacity: 1; }
       });
     }
 
-    // Recalculate affected connection paths
+    // Recalculate affected connection paths (skip scope connections when parent is dragged \u2014 they move with the group transform)
     connIndex.forEach(function(c) {
+      if (c.scopeOf === nodeId) return;
       if (c.srcNode === nodeId || c.tgtNode === nodeId) {
         var sp = portPositions[c.src], tp = portPositions[c.tgt];
-        if (sp && tp) c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+        if (sp && tp) {
+          if (c.scopeOf) {
+            // Scope connection paths live inside the parent group; use parent-local coords
+            var pOff = nodeOffsets[c.scopeOf] || { dx: 0, dy: 0 };
+            c.el.setAttribute('d', computeConnectionPath(sp.cx - pOff.dx, sp.cy - pOff.dy, tp.cx - pOff.dx, tp.cy - pOff.dy));
+          } else {
+            c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+          }
+        }
       }
       if (nodeG) {
         var children = nodeG.querySelectorAll(':scope > g[data-node-id]');
@@ -61765,7 +61898,14 @@ path[data-source].port-hover { opacity: 1; }
           var childId = childG.getAttribute('data-node-id');
           if (c.srcNode === childId || c.tgtNode === childId) {
             var sp = portPositions[c.src], tp = portPositions[c.tgt];
-            if (sp && tp) c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+            if (sp && tp) {
+              if (c.scopeOf) {
+                var pOff = nodeOffsets[c.scopeOf] || { dx: 0, dy: 0 };
+                c.el.setAttribute('d', computeConnectionPath(sp.cx - pOff.dx, sp.cy - pOff.dy, tp.cx - pOff.dx, tp.cy - pOff.dy));
+              } else {
+                c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+              }
+            }
           }
         });
       }
@@ -96590,7 +96730,7 @@ function displayInstalledPackage(pkg) {
 }
 
 // src/cli/index.ts
-var version2 = true ? "0.10.1" : "0.0.0-dev";
+var version2 = true ? "0.10.2" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").version(version2, "-v, --version", "Output the current version");
 program2.configureOutput({

package/dist/diagram/html-viewer.js

@@ -481,7 +481,7 @@ path[data-source].port-hover { opacity: 1; }
   var connIndex = [];
   content.querySelectorAll('path[data-source]').forEach(function(p) {
     var src = p.getAttribute('data-source'), tgt = p.getAttribute('data-target');
-    connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0] });
+    connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0], scopeOf: p.getAttribute('data-scope') || null });
   });
 
   // Snapshot of original port positions for reset
@@ -523,9 +523,18 @@ path[data-source].port-hover { opacity: 1; }
     off.dx += dx; off.dy += dy;
     var tr = 'translate(' + off.dx + ',' + off.dy + ')';
 
-    // Move node group
+    // Move node group (if nested inside a scoped parent, subtract parent offset)
     var nodeG = content.querySelector('.nodes [data-node-id="' + CSS.escape(nodeId) + '"]');
-    if (nodeG) nodeG.setAttribute('transform', tr);
+    if (nodeG) {
+      var parentNodeG = nodeG.parentElement ? nodeG.parentElement.closest('[data-node-id]') : null;
+      if (parentNodeG) {
+        var parentId = parentNodeG.getAttribute('data-node-id');
+        var parentOff = nodeOffsets[parentId] || { dx: 0, dy: 0 };
+        nodeG.setAttribute('transform', 'translate(' + (off.dx - parentOff.dx) + ',' + (off.dy - parentOff.dy) + ')');
+      } else {
+        nodeG.setAttribute('transform', tr);
+      }
+    }
 
     // Move label
     var labelG = content.querySelector('[data-label-for="' + CSS.escape(nodeId) + '"]');
@@ -572,11 +581,20 @@ path[data-source].port-hover { opacity: 1; }
       });
     }
 
-    // Recalculate affected connection paths
+    // Recalculate affected connection paths (skip scope connections when parent is dragged — they move with the group transform)
     connIndex.forEach(function(c) {
+      if (c.scopeOf === nodeId) return;
       if (c.srcNode === nodeId || c.tgtNode === nodeId) {
         var sp = portPositions[c.src], tp = portPositions[c.tgt];
-        if (sp && tp) c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+        if (sp && tp) {
+          if (c.scopeOf) {
+            // Scope connection paths live inside the parent group; use parent-local coords
+            var pOff = nodeOffsets[c.scopeOf] || { dx: 0, dy: 0 };
+            c.el.setAttribute('d', computeConnectionPath(sp.cx - pOff.dx, sp.cy - pOff.dy, tp.cx - pOff.dx, tp.cy - pOff.dy));
+          } else {
+            c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+          }
+        }
       }
       if (nodeG) {
         var children = nodeG.querySelectorAll(':scope > g[data-node-id]');
@@ -584,7 +602,14 @@ path[data-source].port-hover { opacity: 1; }
           var childId = childG.getAttribute('data-node-id');
           if (c.srcNode === childId || c.tgtNode === childId) {
             var sp = portPositions[c.src], tp = portPositions[c.tgt];
-            if (sp && tp) c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+            if (sp && tp) {
+              if (c.scopeOf) {
+                var pOff = nodeOffsets[c.scopeOf] || { dx: 0, dy: 0 };
+                c.el.setAttribute('d', computeConnectionPath(sp.cx - pOff.dx, sp.cy - pOff.dy, tp.cx - pOff.dx, tp.cy - pOff.dy));
+              } else {
+                c.el.setAttribute('d', computeConnectionPath(sp.cx, sp.cy, tp.cx, tp.cy));
+              }
+            }
           }
         });
       }

package/dist/diagram/renderer.js

@@ -100,12 +100,12 @@ function renderConnection(parts, conn, gradIndex) {
     const dashAttr = conn.isStepConnection ? '' : ' stroke-dasharray="8 4"';
     parts.push(`  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`);
 }
-function renderScopeConnection(parts, conn, allConnections) {
+function renderScopeConnection(parts, conn, allConnections, parentNodeId) {
     const gradIndex = allConnections.indexOf(conn);
     if (gradIndex < 0)
         return;
     const dashAttr = conn.isStepConnection ? '' : ' stroke-dasharray="8 4"';
-    parts.push(`    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`);
+    parts.push(`    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input" data-scope="${escapeXml(parentNodeId)}"/>`);
 }
 // ---- Node rendering ----
 /** Render node body rect + icon */
@@ -147,7 +147,7 @@ function renderScopedContent(parts, node, theme, themeName, allConnections) {
     parts.push(`    <rect x="${scopeX}" y="${scopeY}" width="${scopeW}" height="${scopeH}" rx="4" fill="none" stroke="${theme.scopeAreaStroke}" stroke-width="1" stroke-dasharray="4 2" opacity="0.5"/>`);
     // Scope connections (before ports so ports appear on top)
     for (const conn of node.scopeConnections ?? []) {
-        renderScopeConnection(parts, conn, allConnections);
+        renderScopeConnection(parts, conn, allConnections, node.id);
     }
     // Scope port dots (before children so dots sit on top of connections)
     if (scopePorts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",
@@ -145,6 +145,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.11.0",
     "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "esbuild": "^0.27.2",
     "prettier": "^3.1.1",
     "rimraf": "6.1.2",