@synergenius/flow-weaver 0.10.2 → 0.10.4

package/dist/ast/types.d.ts

@@ -459,6 +459,8 @@ export type TConnectionAST = {
     metadata?: TConnectionMetadata;
     /** Pre-computed type compatibility (set during parsing when ts-morph Types are available) */
     typeCompatibility?: TTypeCompatibility;
+    /** Explicit type coercion for this connection (e.g., 'number' wraps value with Number()) */
+    coerce?: TCoerceTargetType;
 };
 /**
  * Port Reference - Identifies a specific port on a node.

package/dist/chevrotain-parser/connect-parser.d.ts

@@ -3,6 +3,7 @@
  *
  * Parser for @connect declarations using Chevrotain.
  */
+import type { TCoerceTargetType } from '../ast/types.js';
 export interface PortReference {
     nodeId: string;
     portName: string;
@@ -11,6 +12,10 @@ export interface PortReference {
 export interface ConnectParseResult {
     source: PortReference;
     target: PortReference;
+    /** Explicit type coercion (from `as <type>` suffix) */
+    coerce?: TCoerceTargetType;
+    /** Set when `as <type>` uses an unrecognized type (cleared after warning is emitted) */
+    invalidCoerceType?: string;
 }
 /**
  * Parse a @connect line and return structured result.

package/dist/chevrotain-parser/connect-parser.js

@@ -4,7 +4,7 @@
  * Parser for @connect declarations using Chevrotain.
  */
 import { CstParser } from 'chevrotain';
-import { JSDocLexer, ConnectTag, Identifier, Arrow, Dot, Colon, allTokens } from './tokens.js';
+import { JSDocLexer, ConnectTag, Identifier, Arrow, Dot, Colon, AsKeyword, allTokens } from './tokens.js';
 // =============================================================================
 // Parser Definition
 // =============================================================================
@@ -13,12 +13,16 @@ class ConnectParser extends CstParser {
         super(allTokens);
         this.performSelfAnalysis();
     }
-    // Entry rule for connect line
+    // Entry rule for connect line: @connect A.port -> B.port [as type]
     connectLine = this.RULE('connectLine', () => {
         this.CONSUME(ConnectTag);
         this.SUBRULE(this.portRef, { LABEL: 'sourceRef' });
         this.CONSUME(Arrow);
         this.SUBRULE2(this.portRef, { LABEL: 'targetRef' });
+        this.OPTION(() => {
+            this.CONSUME(AsKeyword);
+            this.CONSUME(Identifier, { LABEL: 'coerceType' });
+        });
     });
     // node.port or node.port:scope
     portRef = this.RULE('portRef', () => {
@@ -47,7 +51,18 @@ class ConnectVisitor extends BaseVisitor {
     connectLine(ctx) {
         const source = this.visit(ctx.sourceRef);
         const target = this.visit(ctx.targetRef);
-        return { source, target };
+        const result = { source, target };
+        if (ctx.coerceType?.[0]) {
+            const validTypes = new Set(['string', 'number', 'boolean', 'json', 'object']);
+            const raw = ctx.coerceType[0].image;
+            if (validTypes.has(raw)) {
+                result.coerce = raw;
+            }
+            else {
+                result.invalidCoerceType = raw;
+            }
+        }
+        return result;
     }
     portRef(ctx) {
         const nodeId = ctx.nodeId[0].image;
@@ -87,7 +102,12 @@ export function parseConnectLine(input, warnings) {
             `  Expected format: @connect sourceNode.port -> targetNode.port`);
         return null;
     }
-    return visitorInstance.visit(cst);
+    const result = visitorInstance.visit(cst);
+    if (result.invalidCoerceType) {
+        warnings.push(`Invalid coerce type "${result.invalidCoerceType}" in @connect. Valid types: string, number, boolean, json, object`);
+        delete result.invalidCoerceType;
+    }
+    return result;
 }
 /**
  * Get serialized grammar for documentation/diagram generation.