@synergenius/flow-weaver 0.2.0

package/dist/editor-completions/modifierCompletions.js

@@ -0,0 +1,197 @@
+/**
+ * Editor Completions - Bracket Modifier Completions
+ *
+ * Completions for bracket modifiers like [placement:TOP], [order:1], [hidden:true]
+ * These appear on annotation lines inside brackets.
+ */
+/**
+ * Port modifiers - appear on @input, @output, @step lines.
+ */
+const PORT_MODIFIERS = [
+    { name: 'order', detail: 'Port display order', annotations: ['@input', '@output', '@step'] },
+    {
+        name: 'placement',
+        detail: 'Port placement (TOP/BOTTOM)',
+        annotations: ['@input', '@output', '@step'],
+    },
+    { name: 'type', detail: 'Override port data type', annotations: ['@input', '@output', '@step'] },
+    { name: 'hidden', detail: 'Hide port from UI', annotations: ['@input', '@output', '@step'] },
+    {
+        name: 'optional',
+        detail: 'Mark port as optional',
+        annotations: ['@input', '@output', '@step'],
+    },
+    {
+        name: 'label',
+        detail: 'Port display label',
+        annotations: ['@input', '@output', '@step', '@node'],
+    },
+    {
+        name: 'expr',
+        detail: 'Default expression',
+        annotations: ['@input', '@output', '@step', '@node'],
+    },
+    {
+        name: 'minimized',
+        detail: 'Start minimized',
+        annotations: ['@input', '@output', '@step', '@node'],
+    },
+    {
+        name: 'pullExecution',
+        detail: 'Pull execution mode',
+        annotations: ['@input', '@output', '@step', '@node'],
+    },
+];
+/**
+ * Node modifiers - appear on @node lines.
+ */
+const NODE_MODIFIERS = [
+    { name: 'label', detail: 'Node display label', annotations: ['@node'] },
+    { name: 'expr', detail: 'Node expression', annotations: ['@node'] },
+    { name: 'minimized', detail: 'Start minimized', annotations: ['@node'] },
+    { name: 'pullExecution', detail: 'Pull execution mode', annotations: ['@node'] },
+    { name: 'portOrder', detail: 'Port display order', annotations: ['@node'] },
+    { name: 'portLabel', detail: 'Port label override', annotations: ['@node'] },
+    { name: 'size', detail: 'Node size', annotations: ['@node'] },
+];
+const ALL_MODIFIERS = [...PORT_MODIFIERS, ...NODE_MODIFIERS];
+// Deduplicate by name (some appear in both lists)
+const UNIQUE_MODIFIERS = [];
+const seen = new Set();
+for (const mod of ALL_MODIFIERS) {
+    if (!seen.has(mod.name)) {
+        seen.add(mod.name);
+        // Merge annotations from duplicates
+        const allAnnotations = ALL_MODIFIERS.filter((m) => m.name === mod.name).flatMap((m) => m.annotations || []);
+        UNIQUE_MODIFIERS.push({
+            ...mod,
+            annotations: allAnnotations.length > 0 ? [...new Set(allAnnotations)] : null,
+        });
+    }
+}
+// =============================================================================
+// Modifier Value Maps
+// =============================================================================
+const MODIFIER_VALUES = {
+    placement: [
+        {
+            label: 'TOP',
+            detail: 'Place port on top',
+            insertText: 'TOP',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+        {
+            label: 'BOTTOM',
+            detail: 'Place port on bottom',
+            insertText: 'BOTTOM',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+    ],
+    hidden: [
+        {
+            label: 'true',
+            detail: 'Hide port',
+            insertText: 'true',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+        {
+            label: 'false',
+            detail: 'Show port',
+            insertText: 'false',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+    ],
+    optional: [
+        {
+            label: 'true',
+            detail: 'Mark as optional',
+            insertText: 'true',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+        {
+            label: 'false',
+            detail: 'Mark as required',
+            insertText: 'false',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+    ],
+    minimized: [
+        {
+            label: 'true',
+            detail: 'Start minimized',
+            insertText: 'true',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+        {
+            label: 'false',
+            detail: 'Start expanded',
+            insertText: 'false',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+    ],
+    pullExecution: [
+        {
+            label: 'true',
+            detail: 'Enable pull execution',
+            insertText: 'true',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+        {
+            label: 'false',
+            detail: 'Disable pull execution',
+            insertText: 'false',
+            insertTextFormat: 'plain',
+            kind: 'value',
+        },
+    ],
+};
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Get modifier name completions.
+ * Filters by the annotation on the current line if provided.
+ */
+export function getModifierCompletions(lineAnnotation, prefix) {
+    const lowerPrefix = prefix.toLowerCase();
+    return UNIQUE_MODIFIERS.filter((mod) => {
+        // Filter by prefix
+        if (!mod.name.toLowerCase().startsWith(lowerPrefix)) {
+            return false;
+        }
+        // Filter by annotation context if known
+        if (lineAnnotation && mod.annotations) {
+            return mod.annotations.includes(lineAnnotation);
+        }
+        return true;
+    }).map((mod, i) => ({
+        label: mod.name,
+        detail: mod.detail,
+        documentation: mod.documentation,
+        insertText: mod.name + ':',
+        insertTextFormat: 'plain',
+        kind: 'keyword',
+        sortOrder: i,
+    }));
+}
+/**
+ * Get modifier value completions.
+ */
+export function getModifierValueCompletions(modifier, prefix) {
+    const values = MODIFIER_VALUES[modifier];
+    if (!values) {
+        return [];
+    }
+    const lowerPrefix = prefix.toLowerCase();
+    return values.filter((v) => v.label.toLowerCase().startsWith(lowerPrefix));
+}
+//# sourceMappingURL=modifierCompletions.js.map

package/dist/editor-completions/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Editor Completions - Types
+ *
+ * Editor-agnostic types for Flow Weaver autocompletion.
+ * These types are designed to work with any editor (CodeMirror, VS Code, Monaco, etc.)
+ */
+/**
+ * A single completion suggestion.
+ * Editor adapters convert this to their native format.
+ */
+export type FlowWeaverCompletion = {
+    /** Display text for the completion */
+    label: string;
+    /** Short description shown next to label */
+    detail?: string;
+    /** Full documentation (may be markdown) */
+    documentation?: string;
+    /** Text to insert when accepted */
+    insertText: string;
+    /** Whether insertText contains snippet placeholders like ${1:name} */
+    insertTextFormat: 'plain' | 'snippet';
+    /** Category for icon/grouping */
+    kind: CompletionKind;
+    /** Sort order (lower = higher priority) */
+    sortOrder?: number;
+};
+export type CompletionKind = 'annotation' | 'type' | 'nodeType' | 'port' | 'node' | 'keyword' | 'value';
+/**
+ * Workflow context for completions that need AST data.
+ * This is a simplified view of the workflow for completion purposes.
+ */
+export type WorkflowContext = {
+    /** Available node types (name -> simplified node type info) */
+    nodeTypes: Record<string, NodeTypeInfo>;
+    /** Node instances in current workflow */
+    instances?: NodeInstanceInfo[];
+    /** Existing connections in current workflow */
+    connections?: ConnectionInfo[];
+};
+/**
+ * Connection info for completions (extracted from @connect lines).
+ */
+export type ConnectionInfo = {
+    sourceNode: string;
+    sourcePort: string;
+    targetNode: string;
+    targetPort: string;
+};
+/**
+ * Simplified node type info for completions.
+ */
+export type NodeTypeInfo = {
+    name: string;
+    category?: string;
+    description?: string;
+    ports: PortInfo[];
+    /** Source file path (for go-to-definition) */
+    filePath?: string;
+    /** Line number in source file */
+    line?: number;
+};
+/**
+ * Port information for completions.
+ */
+export type PortInfo = {
+    name: string;
+    direction: 'INPUT' | 'OUTPUT';
+    dataType?: string;
+    description?: string;
+};
+/**
+ * Node instance info for completions.
+ */
+export type NodeInstanceInfo = {
+    id: string;
+    nodeType: string;
+};
+/**
+ * Detected completion context from parsing the current line.
+ */
+export type CompletionContext = {
+    /** What type of completion is expected */
+    type: CompletionContextType;
+    /** The current line text */
+    lineText: string;
+    /** Cursor position within the line (0-based) */
+    cursorOffset: number;
+    /** Text being typed (prefix to filter by) */
+    prefix: string;
+    /** For port completions: which node's ports to show */
+    nodeId?: string;
+    /** For port completions: filter by direction */
+    portDirection?: 'input' | 'output';
+    /** Detected block type from scanning preceding lines */
+    blockType?: 'workflow' | 'nodeType' | null;
+    /** For annotationValue context: which annotation we're completing values for */
+    annotation?: string;
+    /** For modifier/modifierValue context: which modifier we're completing */
+    modifier?: string;
+    /** For annotation context: annotations already present in the block */
+    existingAnnotations?: string[];
+};
+export type CompletionContextType = 'annotation' | 'dataType' | 'nodeType' | 'nodeId' | 'port' | 'annotationValue' | 'modifier' | 'modifierValue' | null;
+/**
+ * Result from go-to-definition lookup.
+ */
+export type DefinitionLocation = {
+    /** What kind of symbol was found */
+    type: 'nodeType' | 'workflow' | 'port' | 'node';
+    /** Name of the symbol */
+    name: string;
+    /** File path (if external) */
+    filePath?: string;
+    /** Line number (1-based) */
+    line?: number;
+    /** Column number (1-based) */
+    column?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/editor-completions/types.js

@@ -0,0 +1,8 @@
+/**
+ * Editor Completions - Types
+ *
+ * Editor-agnostic types for Flow Weaver autocompletion.
+ * These types are designed to work with any editor (CodeMirror, VS Code, Monaco, etc.)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/export/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Serverless export orchestrator
+ * Generates deployment-ready handlers for various platforms
+ */
+/**
+ * Supported export targets
+ */
+export type ExportTarget = 'lambda' | 'vercel' | 'cloudflare' | 'inngest';
+/**
+ * Options for exporting a workflow
+ */
+export interface ExportOptions {
+    /** Target platform */
+    target: ExportTarget;
+    /** Input workflow file */
+    input: string;
+    /** Output directory */
+    output: string;
+    /** Specific workflow name (if file has multiple) */
+    workflow?: string;
+    /** Production mode (no debug events) */
+    production?: boolean;
+    /** Bundle workflow into single file (future feature) */
+    bundle?: boolean;
+    /** Dry run - preview without writing files */
+    dryRun?: boolean;
+    /** Export all workflows in file as a single multi-workflow service */
+    multi?: boolean;
+    /** Specific workflow names to export (subset when using multi) */
+    workflows?: string[];
+    /** Include API documentation routes */
+    includeDocs?: boolean;
+    /** Use deep generator with per-node Inngest steps for durability (inngest target only) */
+    durableSteps?: boolean;
+}
+/**
+ * Result of export operation
+ */
+export interface ExportResult {
+    /** Target platform */
+    target: ExportTarget;
+    /** Generated files */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Workflow name */
+    workflow: string;
+    /** Workflow description */
+    description?: string;
+    /** All workflow names (for multi-workflow export) */
+    workflows?: string[];
+    /** OpenAPI spec (if generated) */
+    openApiSpec?: object;
+}
+/**
+ * Export multiple workflows as a single service
+ */
+export declare function exportMultiWorkflow(options: ExportOptions): Promise<ExportResult>;
+/**
+ * Export a workflow for serverless deployment
+ */
+export declare function exportWorkflow(options: ExportOptions): Promise<ExportResult>;
+/**
+ * List supported export targets
+ */
+export declare function getSupportedTargets(): ExportTarget[];
+//# sourceMappingURL=index.d.ts.map