npm - @synergenius/flow-weaver - Versions diffs - 0.10.0 → 0.10.1 - Mend

@synergenius/flow-weaver 0.10.0 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md +9 -3
package/dist/cli/flow-weaver.mjs +79 -1
package/dist/diagram/html-viewer.js +78 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -10,11 +10,17 @@ Design agent workflows in the Studio, in TypeScript, or let AI build them for yo
 ## Three Ways to Build
-**Studio.** Drag, drop, connect. The visual editor renders your workflow as an interactive graph with bidirectional sync: canvas changes write code, code changes update the canvas. 80+ plugins handle rendering, state, minimap, undo/redo, and more.
+**Studio.**
+A unified environment that combines a full code editor with a visual graph builder. You can write and refactor workflows directly in code or compose them visually on the canvas. Both representations stay synchronized at all times. Editing either one updates the other instantly, so you can move between abstraction levels without friction.
-**TypeScript.** Annotate plain functions with JSDoc tags. The compiler turns them into executable workflow graphs with full type safety, IDE autocomplete, and compile-time validation. No YAML, no JSON configs.
+**TypeScript.**
+Define workflows in plain TypeScript by annotating functions with JSDoc. The compiler derives an executable workflow graph with static typing and compile-time validation.
+There is no YAML, no JSON configuration, and no runtime layer.
+No lock-in. Remove the annotations and you keep a clean, readable TypeScript file with zero dependencies.
-**AI Agents.** Connect Claude Code, Cursor, or OpenClaw and they scaffold, validate, and ship workflows using 30+ MCP tools. The agent reads validation errors, fixes issues, and re-validates until the workflow compiles clean. The development loop (steps 1-4 are fully autonomous):
+**AI Agents.**
+Connect Claude Code, Cursor, or OpenClaw to design and ship workflows. Agents scaffold implementations, run the compiler, interpret validation errors, apply corrections, and repeat the process until the workflow compiles successfully.
+With more than 30 MCP tools available, the entire build loop can run autonomously.
 1. **Agent creates**: scaffolds from templates, builds from a model, or writes from scratch
 2. **Compiler validates**: 15+ validation passes catch missing connections, type mismatches, unreachable paths

package/dist/cli/flow-weaver.mjs CHANGED Viewed

@@ -61351,6 +61351,21 @@ path[data-source].port-hover { opacity: 1; }
   border-radius: 3px; font-family: 'SF Mono', 'Fira Code', monospace;
   font-size: 12px; background: rgba(255,255,255,0.1);
 }
+/* Studio nudge toast */
+#studio-hint {
+  position: fixed; bottom: 60px; left: 50%;
+  transform: translateX(-50%);
+  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
+  padding: 8px 16px; border-radius: 8px;
+  font-size: 13px; color: ${textMed};
+  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
+  z-index: 20; opacity: 0; transition: opacity 0.4s;
+  pointer-events: none;
+}
+#studio-hint.visible { opacity: 1; pointer-events: auto; }
+#studio-hint a { color: ${brandAccent}; text-decoration: none; font-weight: 600; }
+#studio-hint a:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
@@ -61374,6 +61389,12 @@ path[data-source].port-hover { opacity: 1; }
       <path d="M1 5h12M1 9h12M5 1v12M9 1v12" opacity="0.4"/>
     </svg>
   </button>
+  <button class="ctrl-btn" id="btn-reset" title="Reset layout" aria-label="Reset layout">
+    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" stroke-width="1.5">
+      <path d="M1.5 2v3.5h3.5"/>
+      <path d="M2.1 8.5a5 5 0 1 0 .9-4L1.5 5.5"/>
+    </svg>
+  </button>
 </div>
 <div id="info-panel">
   <h3 id="info-title"></h3>
@@ -61384,6 +61405,7 @@ path[data-source].port-hover { opacity: 1; }
   <span>Flow Weaver</span>
 </a>
 <div id="scroll-hint">Use <kbd id="mod-key">Ctrl</kbd> + scroll to zoom</div>
+<div id="studio-hint">Like rearranging? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> saves your layouts.</div>
 <script>
 (function() {
   'use strict';
@@ -61396,6 +61418,7 @@ path[data-source].port-hover { opacity: 1; }
   var infoTitle = document.getElementById('info-title');
   var infoBody = document.getElementById('info-body');
   var scrollHint = document.getElementById('scroll-hint');
+  var studioHint = document.getElementById('studio-hint');
   // Parse the original viewBox (diagram bounding box)
   var vbParts = '${viewBox}'.split(/\\s+/).map(Number);
@@ -61467,6 +61490,17 @@ path[data-source].port-hover { opacity: 1; }
   // ---- Pan (drag) + Node drag ----
   var draggedNodeId = null, dragNodeStart = null, didDragNode = false;
+  var dragCount = 0, nudgeIndex = 0, nudgeTimer = null;
+  var nudgeMessages = [
+    'Like rearranging? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> saves your layouts.',
+    'Changes here are temporary. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Try the Studio</a> to keep them.',
+    'Want to collaborate? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> has real-time sharing.',
+    'Build and deploy from the cloud with <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a>.',
+    'This viewer is read-only. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Build workflows</a> in the Studio.',
+    'Version history, diff viewer, rollbacks. All in <a href="https://flowweaver.ai" target="_blank" rel="noopener">the Studio</a>.',
+    'Debug workflows step by step in <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a>.',
+    'Ship faster. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> runs your workflows in the cloud.'
+  ];
   canvas.addEventListener('pointerdown', function(e) {
     if (e.button !== 0) return;
@@ -61525,6 +61559,18 @@ path[data-source].port-hover { opacity: 1; }
   });
   function endDrag() {
+    if (didDragNode) {
+      dragCount++;
+      var threshold = nudgeIndex === 0 ? 3 : 5;
+      if (dragCount >= threshold) {
+        dragCount = 0;
+        studioHint.innerHTML = nudgeMessages[nudgeIndex % nudgeMessages.length];
+        nudgeIndex++;
+        studioHint.classList.add('visible');
+        clearTimeout(nudgeTimer);
+        nudgeTimer = setTimeout(function() { studioHint.classList.remove('visible'); }, 5000);
+      }
+    }
     pointerDown = false;
     draggedNodeId = null;
     canvas.classList.remove('dragging');
@@ -61619,6 +61665,38 @@ path[data-source].port-hover { opacity: 1; }
     connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0] });
   });
+  // Snapshot of original port positions for reset
+  var origPortPositions = {};
+  for (var pid in portPositions) {
+    origPortPositions[pid] = { cx: portPositions[pid].cx, cy: portPositions[pid].cy };
+  }
+  function resetLayout() {
+    for (var nid in nodeOffsets) {
+      var esc = CSS.escape(nid);
+      var nodeG = content.querySelector('.nodes [data-node-id="' + esc + '"]');
+      if (nodeG) nodeG.removeAttribute('transform');
+      var labelG = content.querySelector('[data-label-for="' + esc + '"]');
+      if (labelG) labelG.removeAttribute('transform');
+      allLabelIds.forEach(function(id) {
+        if (id.indexOf(nid + '.') === 0) {
+          var el = labelMap[id];
+          if (el) el.removeAttribute('transform');
+        }
+      });
+    }
+    nodeOffsets = {};
+    for (var pid in origPortPositions) {
+      portPositions[pid] = { cx: origPortPositions[pid].cx, cy: origPortPositions[pid].cy };
+    }
+    connIndex.forEach(function(c) {
+      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));
+    });
+    fitToView();
+  }
+  document.getElementById('btn-reset').addEventListener('click', resetLayout);
   // ---- Node drag: moveNode ----
   function moveNode(nodeId, dx, dy) {
     if (!nodeOffsets[nodeId]) nodeOffsets[nodeId] = { dx: 0, dy: 0 };
@@ -96512,7 +96590,7 @@ function displayInstalledPackage(pkg) {
 }
 // src/cli/index.ts
-var version2 = true ? "0.10.0" : "0.0.0-dev";
+var version2 = true ? "0.10.1" : "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 CHANGED Viewed

@@ -170,6 +170,21 @@ path[data-source].port-hover { opacity: 1; }
   border-radius: 3px; font-family: 'SF Mono', 'Fira Code', monospace;
   font-size: 12px; background: rgba(255,255,255,0.1);
 }
+/* Studio nudge toast */
+#studio-hint {
+  position: fixed; bottom: 60px; left: 50%;
+  transform: translateX(-50%);
+  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
+  padding: 8px 16px; border-radius: 8px;
+  font-size: 13px; color: ${textMed};
+  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
+  z-index: 20; opacity: 0; transition: opacity 0.4s;
+  pointer-events: none;
+}
+#studio-hint.visible { opacity: 1; pointer-events: auto; }
+#studio-hint a { color: ${brandAccent}; text-decoration: none; font-weight: 600; }
+#studio-hint a:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
@@ -193,6 +208,12 @@ path[data-source].port-hover { opacity: 1; }
       <path d="M1 5h12M1 9h12M5 1v12M9 1v12" opacity="0.4"/>
     </svg>
   </button>
+  <button class="ctrl-btn" id="btn-reset" title="Reset layout" aria-label="Reset layout">
+    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" stroke-width="1.5">
+      <path d="M1.5 2v3.5h3.5"/>
+      <path d="M2.1 8.5a5 5 0 1 0 .9-4L1.5 5.5"/>
+    </svg>
+  </button>
 </div>
 <div id="info-panel">
   <h3 id="info-title"></h3>
@@ -203,6 +224,7 @@ path[data-source].port-hover { opacity: 1; }
   <span>Flow Weaver</span>
 </a>
 <div id="scroll-hint">Use <kbd id="mod-key">Ctrl</kbd> + scroll to zoom</div>
+<div id="studio-hint">Like rearranging? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> saves your layouts.</div>
 <script>
 (function() {
   'use strict';
@@ -215,6 +237,7 @@ path[data-source].port-hover { opacity: 1; }
   var infoTitle = document.getElementById('info-title');
   var infoBody = document.getElementById('info-body');
   var scrollHint = document.getElementById('scroll-hint');
+  var studioHint = document.getElementById('studio-hint');
   // Parse the original viewBox (diagram bounding box)
   var vbParts = '${viewBox}'.split(/\\s+/).map(Number);
@@ -286,6 +309,17 @@ path[data-source].port-hover { opacity: 1; }
   // ---- Pan (drag) + Node drag ----
   var draggedNodeId = null, dragNodeStart = null, didDragNode = false;
+  var dragCount = 0, nudgeIndex = 0, nudgeTimer = null;
+  var nudgeMessages = [
+    'Like rearranging? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> saves your layouts.',
+    'Changes here are temporary. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Try the Studio</a> to keep them.',
+    'Want to collaborate? <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> has real-time sharing.',
+    'Build and deploy from the cloud with <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a>.',
+    'This viewer is read-only. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Build workflows</a> in the Studio.',
+    'Version history, diff viewer, rollbacks. All in <a href="https://flowweaver.ai" target="_blank" rel="noopener">the Studio</a>.',
+    'Debug workflows step by step in <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a>.',
+    'Ship faster. <a href="https://flowweaver.ai" target="_blank" rel="noopener">Flow Weaver Studio</a> runs your workflows in the cloud.'
+  ];
   canvas.addEventListener('pointerdown', function(e) {
     if (e.button !== 0) return;
@@ -344,6 +378,18 @@ path[data-source].port-hover { opacity: 1; }
   });
   function endDrag() {
+    if (didDragNode) {
+      dragCount++;
+      var threshold = nudgeIndex === 0 ? 3 : 5;
+      if (dragCount >= threshold) {
+        dragCount = 0;
+        studioHint.innerHTML = nudgeMessages[nudgeIndex % nudgeMessages.length];
+        nudgeIndex++;
+        studioHint.classList.add('visible');
+        clearTimeout(nudgeTimer);
+        nudgeTimer = setTimeout(function() { studioHint.classList.remove('visible'); }, 5000);
+      }
+    }
     pointerDown = false;
     draggedNodeId = null;
     canvas.classList.remove('dragging');
@@ -438,6 +484,38 @@ path[data-source].port-hover { opacity: 1; }
     connIndex.push({ el: p, src: src, tgt: tgt, srcNode: src.split('.')[0], tgtNode: tgt.split('.')[0] });
   });
+  // Snapshot of original port positions for reset
+  var origPortPositions = {};
+  for (var pid in portPositions) {
+    origPortPositions[pid] = { cx: portPositions[pid].cx, cy: portPositions[pid].cy };
+  }
+  function resetLayout() {
+    for (var nid in nodeOffsets) {
+      var esc = CSS.escape(nid);
+      var nodeG = content.querySelector('.nodes [data-node-id="' + esc + '"]');
+      if (nodeG) nodeG.removeAttribute('transform');
+      var labelG = content.querySelector('[data-label-for="' + esc + '"]');
+      if (labelG) labelG.removeAttribute('transform');
+      allLabelIds.forEach(function(id) {
+        if (id.indexOf(nid + '.') === 0) {
+          var el = labelMap[id];
+          if (el) el.removeAttribute('transform');
+        }
+      });
+    }
+    nodeOffsets = {};
+    for (var pid in origPortPositions) {
+      portPositions[pid] = { cx: origPortPositions[pid].cx, cy: origPortPositions[pid].cy };
+    }
+    connIndex.forEach(function(c) {
+      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));
+    });
+    fitToView();
+  }
+  document.getElementById('btn-reset').addEventListener('click', resetLayout);
   // ---- Node drag: moveNode ----
   function moveNode(nodeId, dx, dy) {
     if (!nodeOffsets[nodeId]) nodeOffsets[nodeId] = { dx: 0, dy: 0 };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",