flowspec-mcp 5.4.0 → 5.5.1

package/dist/export/yamlExporter.js

@@ -0,0 +1,155 @@
+import { stringify } from 'yaml';
+/**
+ * Exports canvas state to YAML specification optimised for Claude Code.
+ * Adapted from web app — uses plain interfaces instead of @xyflow/svelte types.
+ */
+export function exportToYaml(nodes, edges, projectName = 'Untitled Project', screens = []) {
+    const exportableNodes = nodes.filter((n) => n.type !== 'image' && n.type !== 'screen');
+    const dataPointNodes = exportableNodes.filter((n) => n.type === 'datapoint');
+    const componentNodes = exportableNodes.filter((n) => n.type === 'component');
+    const transformNodes = exportableNodes.filter((n) => n.type === 'transform');
+    const tableNodes = exportableNodes.filter((n) => n.type === 'table');
+    const locationMap = buildLocationMap(dataPointNodes, componentNodes, edges);
+    // Build node label lookup for screen region export
+    const nodeLabelMap = new Map();
+    for (const n of exportableNodes) {
+        const label = n.data.label ?? 'Untitled';
+        nodeLabelMap.set(n.id, { label, type: n.type ?? 'unknown' });
+    }
+    const spec = {
+        version: '1.2.0',
+        metadata: {
+            projectName,
+            exportedAt: new Date().toISOString(),
+            nodeCount: exportableNodes.length,
+            edgeCount: edges.length,
+        },
+        dataPoints: dataPointNodes.map((node) => {
+            const data = node.data;
+            return {
+                id: node.id,
+                label: data.label,
+                type: data.type,
+                source: data.source,
+                sourceDefinition: data.sourceDefinition,
+                constraints: data.constraints,
+                locations: locationMap.get(node.id) ?? [],
+            };
+        }),
+        components: componentNodes.map((node) => {
+            const data = node.data;
+            const result = {
+                id: node.id,
+                label: data.label,
+                displays: data.displays,
+                captures: data.captures,
+            };
+            if (data.wireframeRef) {
+                result.wireframeRef = data.wireframeRef;
+            }
+            return result;
+        }),
+        transforms: transformNodes.map((node) => {
+            const data = node.data;
+            return {
+                id: node.id,
+                type: data.type,
+                description: data.description,
+                inputs: data.inputs,
+                outputs: data.outputs,
+                logic: data.logic,
+            };
+        }),
+        dataFlow: edges.filter((e) => {
+            return e.data?.edgeType !== 'contains';
+        }).map((edge) => {
+            const result = {
+                from: edge.source,
+                to: edge.target,
+                edgeType: edge.data?.edgeType ?? 'flows-to',
+            };
+            if (edge.data?.label) {
+                result.label = edge.data.label;
+            }
+            return result;
+        }),
+    };
+    // Add tables section if table nodes exist
+    if (tableNodes.length > 0) {
+        spec.tables = tableNodes.map((node) => {
+            const data = node.data;
+            const result = {
+                id: node.id,
+                label: data.label,
+                sourceType: data.sourceType,
+                columns: (data.columns ?? []).map((c) => ({ name: c.name, type: c.type })),
+            };
+            if (data.endpoint) {
+                result.endpoint = data.endpoint;
+            }
+            return result;
+        });
+    }
+    // Add screens section if screens exist
+    if (screens.length > 0) {
+        spec.screens = screens.map((sc) => ({
+            id: sc.id,
+            name: sc.name,
+            imageFilename: sc.imageFilename,
+            regions: sc.regions.map((r) => {
+                const region = {
+                    id: r.id,
+                    label: r.label,
+                    position: {
+                        x: Math.round(r.position.x * 10) / 10,
+                        y: Math.round(r.position.y * 10) / 10,
+                    },
+                    size: {
+                        width: Math.round(r.size.width * 10) / 10,
+                        height: Math.round(r.size.height * 10) / 10,
+                    },
+                    elements: r.elementIds.map((eid) => {
+                        const info = nodeLabelMap.get(eid);
+                        return {
+                            nodeId: eid,
+                            nodeLabel: info?.label ?? 'Missing element',
+                            nodeType: info?.type ?? 'unknown',
+                        };
+                    }),
+                };
+                if (r.componentNodeId) {
+                    region.componentNodeId = r.componentNodeId;
+                }
+                return region;
+            }),
+        }));
+    }
+    return stringify(spec, {
+        lineWidth: 120,
+        indent: 2,
+    });
+}
+function buildLocationMap(dataPoints, components, edges) {
+    const map = new Map();
+    for (const dp of dataPoints) {
+        map.set(dp.id, []);
+    }
+    for (const edge of edges) {
+        const sourceIsDataPoint = dataPoints.some((n) => n.id === edge.source);
+        const targetIsComponent = components.some((n) => n.id === edge.target);
+        if (sourceIsDataPoint && targetIsComponent) {
+            const locations = map.get(edge.source) ?? [];
+            locations.push({ component: edge.target, role: 'output' });
+            map.set(edge.source, locations);
+        }
+        const sourceIsComponent = components.some((n) => n.id === edge.source);
+        const targetIsDataPoint = dataPoints.some((n) => n.id === edge.target);
+        if (sourceIsComponent && targetIsDataPoint) {
+            const locations = map.get(edge.target) ?? [];
+            locations.push({ component: edge.source, role: 'input' });
+            map.set(edge.target, locations);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=yamlExporter.js.map

package/dist/export/yamlExporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yamlExporter.js","sourceRoot":"","sources":["../../src/export/yamlExporter.ts"],"names":[],"mappings":"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"}

package/dist/import/yamlImporter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts a validated YAML spec back into FlowSpec canvas nodes and edges.
+ * Ported from src/lib/import/yamlImporter.ts — uses MCP types, no @xyflow deps.
+ * Lenient: uses sensible defaults for missing fields, skips broken edges.
+ */
+import type { CanvasNode, CanvasEdge, Screen } from '../types.js';
+export interface ImportResult {
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+    screens: Screen[];
+    projectName: string;
+    stats: {
+        dataPoints: number;
+        components: number;
+        transforms: number;
+        tables: number;
+        edges: number;
+        skippedEdges: number;
+        skippedNodes: number;
+    };
+}
+export declare function importFromYaml(spec: Record<string, unknown>): ImportResult;

package/dist/import/yamlImporter.js

@@ -0,0 +1,227 @@
+export function importFromYaml(spec) {
+    const metadata = (spec.metadata ?? {});
+    const projectName = metadata.projectName ?? 'Imported Project';
+    const rawDataPoints = spec.dataPoints ?? [];
+    const rawComponents = spec.components ?? [];
+    const rawTransforms = spec.transforms ?? [];
+    const rawDataFlow = spec.dataFlow ?? [];
+    const rawTables = spec.tables ?? [];
+    const nodes = [];
+    const seenIds = new Set();
+    let skippedNodes = 0;
+    // --- DataPoints ---
+    for (const dp of rawDataPoints) {
+        const id = dp.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        nodes.push({
+            id,
+            type: 'datapoint',
+            position: { x: 0, y: 0 },
+            data: {
+                label: dp.label ?? 'Untitled',
+                type: validDataType(dp.type),
+                source: validSource(dp.source),
+                sourceDefinition: dp.sourceDefinition ?? '',
+                constraints: Array.isArray(dp.constraints) ? dp.constraints : []
+            }
+        });
+    }
+    // --- Components ---
+    for (const comp of rawComponents) {
+        const id = comp.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const data = {
+            label: comp.label ?? 'Untitled Component',
+            displays: Array.isArray(comp.displays) ? comp.displays : [],
+            captures: Array.isArray(comp.captures) ? comp.captures : []
+        };
+        if (comp.wireframeRef) {
+            data.wireframeRef = comp.wireframeRef;
+        }
+        nodes.push({ id, type: 'component', position: { x: 0, y: 0 }, data });
+    }
+    // --- Transforms ---
+    for (const tx of rawTransforms) {
+        const id = tx.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const description = tx.description ?? '';
+        const rawLogic = (tx.logic ?? {});
+        nodes.push({
+            id,
+            type: 'transform',
+            position: { x: 0, y: 0 },
+            data: {
+                label: description || 'Untitled Transform',
+                type: validLogicType(tx.type),
+                description,
+                inputs: Array.isArray(tx.inputs) ? tx.inputs : [],
+                outputs: Array.isArray(tx.outputs) ? tx.outputs : [],
+                logic: {
+                    type: validLogicContentType(rawLogic.type),
+                    content: rawLogic.content ?? ''
+                }
+            }
+        });
+    }
+    // --- Tables ---
+    for (const tbl of rawTables) {
+        const id = tbl.id;
+        if (!id || seenIds.has(id)) {
+            skippedNodes++;
+            continue;
+        }
+        seenIds.add(id);
+        const rawColumns = Array.isArray(tbl.columns) ? tbl.columns : [];
+        const columns = rawColumns.map((c) => ({
+            name: c.name ?? '',
+            type: validDataType(c.type)
+        }));
+        nodes.push({
+            id,
+            type: 'table',
+            position: { x: 0, y: 0 },
+            data: {
+                label: tbl.label ?? 'Untitled Table',
+                sourceType: validTableSourceType(tbl.sourceType),
+                columns,
+                endpoint: tbl.endpoint ?? ''
+            }
+        });
+    }
+    // --- Edges (no markerEnd — visual-only, not needed in canvas_state) ---
+    const edges = [];
+    let skippedEdges = 0;
+    for (const flow of rawDataFlow) {
+        const from = flow.from;
+        const to = flow.to;
+        if (!from || !to || !seenIds.has(from) || !seenIds.has(to)) {
+            skippedEdges++;
+            continue;
+        }
+        const edgeData = {
+            edgeType: validEdgeType(flow.edgeType)
+        };
+        if (flow.label) {
+            edgeData.label = flow.label;
+        }
+        edges.push({
+            id: crypto.randomUUID(),
+            source: from,
+            target: to,
+            type: 'typed',
+            data: edgeData
+        });
+    }
+    // --- Screens (import metadata + auto-create screen nodes) ---
+    const screens = [];
+    const rawScreens = spec.screens ?? [];
+    let screenOffsetY = 50;
+    for (const rawSc of rawScreens) {
+        const screenId = rawSc.id ?? crypto.randomUUID();
+        const rawRegions = Array.isArray(rawSc.regions) ? rawSc.regions : [];
+        const regions = rawRegions.map((r) => {
+            const rawElements = Array.isArray(r.elements) ? r.elements : [];
+            return {
+                id: r.id ?? crypto.randomUUID(),
+                label: r.label,
+                position: {
+                    x: (r.position?.x ?? 10),
+                    y: (r.position?.y ?? 10)
+                },
+                size: {
+                    width: (r.size?.width ?? 20),
+                    height: (r.size?.height ?? 15)
+                },
+                elementIds: rawElements
+                    .map((el) => el.nodeId)
+                    .filter((eid) => seenIds.has(eid)),
+                componentNodeId: r.componentNodeId || undefined
+            };
+        });
+        const elementCount = regions.reduce((sum, r) => sum + r.elementIds.length, 0);
+        screens.push({
+            id: screenId,
+            name: rawSc.name ?? 'Imported Screen',
+            imageUrl: '',
+            imageWidth: 1920,
+            imageHeight: 1080,
+            imageFilename: rawSc.imageFilename,
+            regions
+        });
+        // Auto-create screen node on canvas
+        const screenNodeId = crypto.randomUUID();
+        nodes.push({
+            id: screenNodeId,
+            type: 'screen',
+            position: { x: 50, y: screenOffsetY },
+            data: {
+                label: rawSc.name ?? 'Imported Screen',
+                screenId,
+                regionCount: regions.length,
+                elementCount
+            }
+        });
+        screenOffsetY += 160;
+    }
+    return {
+        nodes,
+        edges,
+        screens,
+        projectName,
+        stats: {
+            dataPoints: nodes.filter((n) => n.type === 'datapoint').length,
+            components: nodes.filter((n) => n.type === 'component').length,
+            transforms: nodes.filter((n) => n.type === 'transform').length,
+            tables: nodes.filter((n) => n.type === 'table').length,
+            edges: edges.length,
+            skippedEdges,
+            skippedNodes
+        }
+    };
+}
+// --- Validation helpers with defaults ---
+const VALID_DATA_TYPES = new Set(['string', 'number', 'boolean', 'object', 'array']);
+function validDataType(t) {
+    return t && VALID_DATA_TYPES.has(t) ? t : 'string';
+}
+const VALID_SOURCES = new Set(['captured', 'inferred']);
+function validSource(s) {
+    return s && VALID_SOURCES.has(s) ? s : 'captured';
+}
+const VALID_LOGIC_TYPES = new Set(['formula', 'validation', 'workflow']);
+function validLogicType(t) {
+    return t && VALID_LOGIC_TYPES.has(t) ? t : 'formula';
+}
+const VALID_LOGIC_CONTENT_TYPES = new Set(['formula', 'decision_table', 'steps']);
+function validLogicContentType(t) {
+    return t && VALID_LOGIC_CONTENT_TYPES.has(t)
+        ? t
+        : 'formula';
+}
+const VALID_TABLE_SOURCE_TYPES = new Set(['database', 'api', 'file', 'manual']);
+function validTableSourceType(t) {
+    return t && VALID_TABLE_SOURCE_TYPES.has(t) ? t : 'database';
+}
+const VALID_EDGE_TYPES = new Set([
+    'flows-to',
+    'derives-from',
+    'transforms',
+    'validates',
+    'contains'
+]);
+function validEdgeType(t) {
+    return t && VALID_EDGE_TYPES.has(t) ? t : 'flows-to';
+}
+//# sourceMappingURL=yamlImporter.js.map

package/dist/import/yamlImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yamlImporter.js","sourceRoot":"","sources":["../../src/import/yamlImporter.ts"],"names":[],"mappings":"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"}

package/dist/layout/semanticLayout.d.ts

@@ -0,0 +1,24 @@
+import type { CanvasNode, CanvasEdge } from '../types.js';
+export interface LayoutCommand {
+    nodeIds: string[];
+    targetBounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    arrangement: 'stack' | 'grid' | 'flow' | 'cluster';
+    direction?: 'vertical' | 'horizontal';
+}
+export declare function parseNaturalLanguageLayout(command: string, nodes: CanvasNode[], canvasBounds: {
+    width: number;
+    height: number;
+}): LayoutCommand | {
+    error: string;
+};
+export declare function applySemanticLayout(nodes: CanvasNode[], edges: CanvasEdge[], command: LayoutCommand): Map<string, {
+    x: number;
+    y: number;
+}>;
+export declare const SUPPORTED_COMMANDS: string[];
+export declare const SUPPORTED_REGIONS: string[];