@angflow/angular 0.0.15 → 0.0.18

package/README.md

@@ -180,6 +180,59 @@ flowService.screenToFlowPosition({ x: event.clientX, y: event.clientY });
 flowService.toObject(); // { nodes, edges, viewport }
 ```
 
+## Floating Edges
+
+Set `edgeMode="floating"` and edges attach wherever the line to the peer node's
+center crosses each node's border — no handle declarations needed:
+
+```html
+<ng-flow [nodes]="nodes" [edges]="edges" edgeMode="floating" />
+```
+
+Works with nodes that declare zero handles, which makes it ideal for
+programmatic / agent-driven graphs. Note: a node with no handles cannot
+originate an interactive drag-connection — declared handles still work for
+starting connections while rendering stays floating. For per-edge control in
+the default mode, set `floating` on individual handles instead:
+`<ng-flow-handle type="source" [floating]="true" />`.
+
+## Auto-Layout
+
+`layoutNodes` is a pure dagre wrapper — feed it your nodes and edges, get back
+a map of top-left positions:
+
+```ts
+import { layoutNodes } from '@angflow/angular/layout'; // needs @dagrejs/dagre installed
+
+const positions = layoutNodes(flow.getNodes(), flow.getEdges(), { direction: 'LR' });
+flow.setNodePositions(positions);
+
+// or in one call:
+flow.applyLayout(layoutNodes, { direction: 'LR' });
+```
+
+Options: `direction` (`'TB' | 'LR' | 'BT' | 'RL'`, default `'TB'`), `nodeSep`
+(default 50), `rankSep` (default 80). Node dimensions resolve from
+`measured` → `width`/`height` → `initialWidth`/`initialHeight` → 150×40. Any
+function with the same shape plugs
+into `applyLayout` (elk, custom grids, …).
+
+## Animations
+
+Turn on `[animate]` and the flow animates node entries (fade + scale) and
+programmatic position changes (smooth tween, edges tracking mid-flight):
+
+```html
+<ng-flow [nodes]="nodes" [edges]="edges" [animate]="true" />
+<!-- or tune the duration: -->
+<ng-flow [animate]="{ duration: 200 }" />
+```
+
+Animated paths: `setNodePositions`, `applyLayout`, and the agent bridge's
+`layout_nodes` tool. Dragging is never animated, a drag cancels any in-flight
+tween on that node, and everything is disabled under `prefers-reduced-motion`.
+Per-call override: `flow.setNodePositions(positions, { animate: false })`.
+
 ## Architecture
 
 - **Signal-based state** — Angular 17+ signals for fine-grained reactivity (no RxJS in the store)

package/dist/base.css

@@ -955,6 +955,24 @@ svg.xy-flow__connectionline {
 }
 
 
+/* Entry animation — applied by the node renderer when [animate] is enabled.
+   Uses the standalone `scale` property so it composes with the inline
+   translate() transform instead of overriding it. */
+.xy-flow__node-enter {
+  animation: xy-flow-node-enter 300ms ease both;
+  transform-origin: 50% 50%;
+}
+
+@keyframes xy-flow-node-enter {
+  from { opacity: 0; scale: 0.92; }
+  to   { opacity: 1; scale: 1; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .xy-flow__node-enter { animation: none; }
+}
+
+
 .xy-flow__node-input,
 .xy-flow__node-default,
 .xy-flow__node-output,

package/dist/esm/lib/agent/agent-bridge.service.d.ts

@@ -1,9 +1,21 @@
 import { InjectionToken } from '@angular/core';
 import type { NgFlowService } from '../services/ng-flow.service';
+import type { AgentLayoutFn } from '../types/node-template';
+import type { AgentHistoryOptions } from './history';
 import type { AgentTransport } from './types';
 import * as i0 from "@angular/core";
 /** Provider token holding the user-supplied transport(s). */
 export declare const AGENT_TRANSPORTS: InjectionToken<AgentTransport[]>;
+/** Provider token for history config. `false` disables history entirely. */
+export declare const AGENT_HISTORY_OPTIONS: InjectionToken<false | AgentHistoryOptions>;
+/** Optional error sink. Receives transport/dispatch failures that the bridge swallows. */
+export declare const AGENT_ON_ERROR: InjectionToken<(err: unknown, ctx: {
+    kind: "transport-start" | "transport-send" | "dispatch";
+    transport?: AgentTransport;
+    method?: string;
+}) => void>;
+/** Optional host-provided layout function backing the `layout_nodes` tool. */
+export declare const AGENT_LAYOUT: InjectionToken<AgentLayoutFn>;
 /**
  * Routes JSON-RPC requests from one or more transports to registered
  * `NgFlowService` instances, and pushes change events back to the agent.
@@ -33,12 +45,22 @@ export declare class AngflowAgentBridge {
     readonly toolSchemas: import("./types").AgentToolSchema[];
     private readonly flows;
     private readonly transports;
+    private readonly history;
     private readonly handlers;
     private readonly injector;
+    private readonly layoutFn;
     private started;
+    private nextInProcessId;
+    private warnedOnBeforeDeleteBypass;
     /** Bumped every time a flow registers/unregisters. Useful for diagnostics. */
     readonly registeredFlows: import("@angular/core").WritableSignal<string[]>;
-    constructor(transports: AgentTransport[] | null);
+    private readonly onError;
+    constructor(transports: AgentTransport[] | null, historyOptions: AgentHistoryOptions | false | null, onError: ((err: unknown, ctx: {
+        kind: 'transport-start' | 'transport-send' | 'dispatch';
+        transport?: AgentTransport;
+        method?: string;
+    }) => void) | null, layoutFn: AgentLayoutFn | null);
+    private reportError;
     /**
      * Register a flow under `id`. The bridge subscribes to its `nodes`,
      * `edges`, and `viewport` signals and emits change events to all
@@ -53,18 +75,21 @@ export declare class AngflowAgentBridge {
     /** Look up a registered flow. */
     getFlow(id: string): NgFlowService | undefined;
     /**
-     * Invoke a tool directly without going through a transport. Useful for
-     * in-process callers (tests, devtools snippets, Angular components that
-     * want to share the same dispatch logic).
+     * Invoke a tool directly without going through a transport. Behaves
+     * identically to a JSON-RPC request: captures a history snapshot, emits
+     * `flow.history` / `flow.state` events, and throws a structured error
+     * (with `code` and `data` attached) on failure.
      */
     callTool(method: string, params?: Record<string, unknown>): Promise<unknown>;
     private start;
     private dispatch;
+    private findFlowId;
+    private emitHistory;
     private emit;
     private resolveFlow;
     private watchFlow;
     private installHandlers;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AngflowAgentBridge, [{ optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AngflowAgentBridge, [{ optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AngflowAgentBridge>;
 }
 //# sourceMappingURL=agent-bridge.service.d.ts.map

package/dist/esm/lib/agent/agent-bridge.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-bridge.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/agent-bridge.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAQf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,SAAS,CAAC;;AAEjB,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,kCAAiE,CAAC;AAiB/F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,kBAAkB;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,WAAW,sCAAsB;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAAS;IAExB,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,mDAAwB;gBAGR,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI;IAO3E;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI;IAarD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAS5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IActF,OAAO,CAAC,KAAK;YAQC,QAAQ;IAkCtB,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,eAAe;yCAvLZ,kBAAkB;6CAAlB,kBAAkB;CAmR9B"}
+{"version":3,"file":"agent-bridge.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/agent-bridge.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAOf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,wBAAwB,CAAC;AAE9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,SAAS,CAAC;;AAEjB,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,kCAAiE,CAAC;AAE/F,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,6CAEjC,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,cAAc,uBACnB,OAAO,OAAO;IAAE,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAC/G,CAAC;AAEzB,8EAA8E;AAC9E,eAAO,MAAM,YAAY,+BAA0D,CAAC;AAiCpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,kBAAkB;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,WAAW,sCAAsB;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,0BAA0B,CAAS;IAE3C,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,mDAAwB;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEf;gBAG+B,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,EAC9B,cAAc,EAAE,mBAAmB,GAAG,KAAK,GAAG,IAAI,EACzD,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,cAAc,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,EACzJ,QAAQ,EAAE,aAAa,GAAG,IAAI;IAWlE,OAAO,CAAC,WAAW;IASnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,IAAI;IAuBrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBtF,OAAO,CAAC,KAAK;YAiBC,QAAQ;IAkGtB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,SAAS;IAgDjB,OAAO,CAAC,eAAe;yCAhUZ,kBAAkB;6CAAlB,kBAAkB;CA20B9B"}