@flowdrop/flowdrop 1.0.0

package/dist/services/workflowStorage.js

@@ -0,0 +1,116 @@
+/**
+ * In-memory workflow storage service
+ * This can be replaced with a database implementation later
+ */
+import { v4 as uuidv4 } from 'uuid';
+// In-memory storage
+const workflows = new Map();
+/**
+ * Generate a unique workflow ID using UUID v4
+ */
+function generateWorkflowId() {
+    return uuidv4();
+}
+/**
+ * Save a workflow
+ */
+export async function saveWorkflow(workflow) {
+    const id = generateWorkflowId();
+    const newWorkflow = {
+        ...workflow,
+        id,
+        metadata: {
+            version: '1.0.0',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            ...workflow.metadata
+        }
+    };
+    workflows.set(id, newWorkflow);
+    return newWorkflow;
+}
+/**
+ * Update an existing workflow
+ */
+export async function updateWorkflow(id, workflow) {
+    const existing = workflows.get(id);
+    if (!existing) {
+        return null;
+    }
+    const updatedWorkflow = {
+        ...existing,
+        ...workflow,
+        id, // Ensure ID doesn't change
+        metadata: {
+            version: existing.metadata?.version || '1.0.0',
+            createdAt: existing.metadata?.createdAt || new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            author: workflow.metadata?.author || existing.metadata?.author,
+            tags: workflow.metadata?.tags || existing.metadata?.tags
+        }
+    };
+    workflows.set(id, updatedWorkflow);
+    return updatedWorkflow;
+}
+/**
+ * Get a workflow by ID
+ */
+export async function getWorkflow(id) {
+    return workflows.get(id) || null;
+}
+/**
+ * Get all workflows with optional filtering
+ */
+export async function getWorkflows(options) {
+    let filteredWorkflows = Array.from(workflows.values());
+    // Apply search filter
+    if (options?.search) {
+        const searchLower = options.search.toLowerCase();
+        filteredWorkflows = filteredWorkflows.filter((workflow) => workflow.name.toLowerCase().includes(searchLower) ||
+            workflow.description?.toLowerCase().includes(searchLower) ||
+            workflow.metadata?.tags?.some((tag) => tag.toLowerCase().includes(searchLower)));
+    }
+    // Sort by updated date (newest first)
+    filteredWorkflows.sort((a, b) => new Date(b.metadata?.updatedAt || 0).getTime() -
+        new Date(a.metadata?.updatedAt || 0).getTime());
+    // Apply pagination
+    const offset = options?.offset || 0;
+    const limit = options?.limit || filteredWorkflows.length;
+    return filteredWorkflows.slice(offset, offset + limit);
+}
+/**
+ * Delete a workflow
+ */
+export async function deleteWorkflow(id) {
+    return workflows.delete(id);
+}
+/**
+ * Get workflow count
+ */
+export async function getWorkflowCount() {
+    return workflows.size;
+}
+/**
+ * Initialize with sample workflows (for development)
+ */
+export async function initializeSampleWorkflows() {
+    // Only initialize if no workflows exist
+    if (workflows.size > 0) {
+        return;
+    }
+    // Add a sample workflow
+    const sampleWorkflow = {
+        name: 'Sample Chat Workflow',
+        description: 'A simple workflow demonstrating chat completion',
+        nodes: [],
+        edges: [],
+        metadata: {
+            version: '1.0.0',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            author: 'System',
+            tags: ['sample', 'chat']
+        }
+    };
+    await saveWorkflow(sampleWorkflow);
+}

package/dist/settings/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * FlowDrop Settings Module
+ *
+ * Provides settings stores, services, and components for user-configurable
+ * preferences with hybrid persistence (localStorage + optional API sync).
+ *
+ * Theme stores and functions (theme, resolvedTheme, setTheme, toggleTheme,
+ * cycleTheme, initializeTheme) are exported from `@flowdrop/flowdrop/core`
+ * (sourced from settingsStore).
+ *
+ * @module settings
+ *
+ * @example
+ * ```typescript
+ * import { settingsStore, updateSettings, SettingsPanel } from "@flowdrop/flowdrop/settings";
+ * import { theme, setTheme } from "@flowdrop/flowdrop/core";
+ * ```
+ */
+export { default as ThemeToggle } from '../components/ThemeToggle.svelte';
+export { default as SettingsPanel } from '../components/SettingsPanel.svelte';
+export { default as SettingsModal } from '../components/SettingsModal.svelte';
+export type { ThemeSettings, EditorSettings, UISettings, BehaviorSettings, ApiSettings, FlowDropSettings, SettingsCategory, PartialSettings, DeepPartial, SettingsChangeEvent, SettingsChangeCallback, SyncStatus, SettingsStoreState } from '../types/settings.js';
+export { SETTINGS_CATEGORIES, SETTINGS_CATEGORY_LABELS, SETTINGS_CATEGORY_ICONS, DEFAULT_THEME_SETTINGS, DEFAULT_EDITOR_SETTINGS, DEFAULT_UI_SETTINGS, DEFAULT_BEHAVIOR_SETTINGS, DEFAULT_API_SETTINGS, DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from '../types/settings.js';
+export { getSettings as settingsStore, getThemeSettings as themeSettings, getEditorSettings as editorSettings, getUiSettings as uiSettings, getBehaviorSettings as behaviorSettings, getApiSettings as apiSettings, getSyncStatus as syncStatusStore, updateSettings, resetSettings, getSettings, initializeSettings, setSettingsService, syncSettingsToApi, loadSettingsFromApi, onSettingsChange } from '../stores/settingsStore.svelte.js';
+export { settingsApi, SettingsService, createSettingsService, setSettingsEndpointConfig, getSettingsEndpointConfig } from '../services/settingsService.js';

package/dist/settings/index.js

@@ -0,0 +1,33 @@
+/**
+ * FlowDrop Settings Module
+ *
+ * Provides settings stores, services, and components for user-configurable
+ * preferences with hybrid persistence (localStorage + optional API sync).
+ *
+ * Theme stores and functions (theme, resolvedTheme, setTheme, toggleTheme,
+ * cycleTheme, initializeTheme) are exported from `@flowdrop/flowdrop/core`
+ * (sourced from settingsStore).
+ *
+ * @module settings
+ *
+ * @example
+ * ```typescript
+ * import { settingsStore, updateSettings, SettingsPanel } from "@flowdrop/flowdrop/settings";
+ * import { theme, setTheme } from "@flowdrop/flowdrop/core";
+ * ```
+ */
+// ============================================================================
+// Components
+// ============================================================================
+export { default as ThemeToggle } from '../components/ThemeToggle.svelte';
+export { default as SettingsPanel } from '../components/SettingsPanel.svelte';
+export { default as SettingsModal } from '../components/SettingsModal.svelte';
+export { SETTINGS_CATEGORIES, SETTINGS_CATEGORY_LABELS, SETTINGS_CATEGORY_ICONS, DEFAULT_THEME_SETTINGS, DEFAULT_EDITOR_SETTINGS, DEFAULT_UI_SETTINGS, DEFAULT_BEHAVIOR_SETTINGS, DEFAULT_API_SETTINGS, DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from '../types/settings.js';
+// ============================================================================
+// Settings Stores
+// ============================================================================
+export { getSettings as settingsStore, getThemeSettings as themeSettings, getEditorSettings as editorSettings, getUiSettings as uiSettings, getBehaviorSettings as behaviorSettings, getApiSettings as apiSettings, getSyncStatus as syncStatusStore, updateSettings, resetSettings, getSettings, initializeSettings, setSettingsService, syncSettingsToApi, loadSettingsFromApi, onSettingsChange } from '../stores/settingsStore.svelte.js';
+// ============================================================================
+// Settings Service
+// ============================================================================
+export { settingsApi, SettingsService, createSettingsService, setSettingsEndpointConfig, getSettingsEndpointConfig } from '../services/settingsService.js';

package/dist/stores/categoriesStore.svelte.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Categories Store for FlowDrop (Svelte 5 Runes)
+ *
+ * Manages category definitions with merged defaults and API-provided overrides.
+ * Exposes lookup helpers for icon, color, and label resolution.
+ */
+import type { CategoryDefinition, NodeCategory } from '../types/index.js';
+/**
+ * Get all category definitions, sorted by weight.
+ */
+export declare function getCategories(): CategoryDefinition[];
+/**
+ * Initialize categories with API data, merging with defaults.
+ * API categories override defaults by name; custom categories are appended.
+ */
+export declare function initializeCategories(apiCategories: CategoryDefinition[]): void;
+/**
+ * Get the display label for a category.
+ */
+export declare function getCategoryLabel(category: NodeCategory): string;
+/**
+ * Get the icon for a category.
+ */
+export declare function getCategoryIcon(category: NodeCategory): string;
+/**
+ * Get the color token for a category.
+ */
+export declare function getCategoryColor(category: NodeCategory): string;
+/**
+ * Get the full category definition, or undefined if not found.
+ */
+export declare function getCategoryDefinition(category: NodeCategory): CategoryDefinition | undefined;

package/dist/stores/categoriesStore.svelte.js

@@ -0,0 +1,77 @@
+/**
+ * Categories Store for FlowDrop (Svelte 5 Runes)
+ *
+ * Manages category definitions with merged defaults and API-provided overrides.
+ * Exposes lookup helpers for icon, color, and label resolution.
+ */
+import { DEFAULT_CATEGORIES } from '../config/defaultCategories.js';
+/**
+ * Internal reactive state holding the category definitions.
+ * Initialized with defaults, updated when API data is fetched.
+ */
+let categoriesState = $state([...DEFAULT_CATEGORIES]);
+/**
+ * Derived lookup map: category name → CategoryDefinition
+ */
+let categoryMap = $derived((() => {
+    const map = new Map();
+    for (const cat of categoriesState) {
+        map.set(cat.name, cat);
+    }
+    return map;
+})());
+/**
+ * Get all category definitions, sorted by weight.
+ */
+export function getCategories() {
+    return [...categoriesState].sort((a, b) => (a.weight ?? 999) - (b.weight ?? 999));
+}
+/**
+ * Initialize categories with API data, merging with defaults.
+ * API categories override defaults by name; custom categories are appended.
+ */
+export function initializeCategories(apiCategories) {
+    const defaultMap = new Map();
+    for (const cat of DEFAULT_CATEGORIES) {
+        defaultMap.set(cat.name, cat);
+    }
+    // API categories override defaults by name
+    for (const cat of apiCategories) {
+        defaultMap.set(cat.name, {
+            ...defaultMap.get(cat.name),
+            ...cat
+        });
+    }
+    categoriesState = Array.from(defaultMap.values());
+}
+/**
+ * Get the display label for a category.
+ */
+export function getCategoryLabel(category) {
+    const def = categoryMap.get(category);
+    if (def?.label)
+        return def.label;
+    // Auto-generate: capitalize each word
+    return category
+        .split(/[\s_-]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Get the icon for a category.
+ */
+export function getCategoryIcon(category) {
+    return categoryMap.get(category)?.icon ?? 'mdi:folder';
+}
+/**
+ * Get the color token for a category.
+ */
+export function getCategoryColor(category) {
+    return categoryMap.get(category)?.color ?? 'var(--fd-node-slate)';
+}
+/**
+ * Get the full category definition, or undefined if not found.
+ */
+export function getCategoryDefinition(category) {
+    return categoryMap.get(category);
+}

package/dist/stores/editorStateMachine.svelte.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Editor State Machine for WorkflowEditor (Svelte 5 Runes)
+ *
+ * Centralizes all reactive guard logic into explicit states and transitions.
+ * Replaces scattered boolean flags (isDraggingNode, isRestoringFromHistory,
+ * lastEditorStoreValue identity checks) with a single source of truth.
+ *
+ * @module stores/editorStateMachine
+ */
+export type EditorState = 'uninitialized' | 'loading' | 'idle' | 'dragging' | 'connecting' | 'dropping' | 'restoring' | 'deleting' | 'updating_node';
+export type EditorEvent = 'WORKFLOW_LOADED' | 'LOAD_COMPLETE' | 'START_DRAG' | 'STOP_DRAG' | 'START_CONNECT' | 'CONNECTION_MADE' | 'CONNECTION_CANCELLED' | 'START_DROP' | 'DROP_COMPLETE' | 'DROP_CANCELLED' | 'START_RESTORE' | 'RESTORE_COMPLETE' | 'EXTERNAL_STORE_CHANGE' | 'SYNC_COMPLETE' | 'START_DELETE' | 'DELETE_COMPLETE' | 'START_NODE_UPDATE' | 'UPDATE_COMPLETE' | 'WORKFLOW_SWITCHED' | 'WORKFLOW_CLEARED' | 'RESET';
+/** What operations are permitted in the current state */
+export interface StatePermissions {
+    /** Whether the editor can write to the global workflow store */
+    canWriteToStore: boolean;
+    /** Whether the editor can push to undo/redo history */
+    canPushHistory: boolean;
+    /** Suppress the store → flowNodes/flowEdges sync effect */
+    suppressEffect: boolean;
+}
+export interface EditorStateMachine {
+    /** Current state (reactive via $state) */
+    readonly current: EditorState;
+    /** Current permissions (reactive, derived from current state) */
+    readonly permissions: StatePermissions;
+    /** Attempt a transition. Returns true if the transition was valid. */
+    send(event: EditorEvent): boolean;
+    /** Check if an event is valid from the current state */
+    canSend(event: EditorEvent): boolean;
+    /** Subscribe to state changes (for debugging/logging). Returns unsubscribe function. */
+    onTransition(callback: (from: EditorState, event: EditorEvent, to: EditorState) => void): () => void;
+}
+/**
+ * Create an editor state machine instance.
+ *
+ * Uses Svelte 5 `$state` rune for reactivity so that components can
+ * read `machine.current` and `machine.permissions` inside `$derived`
+ * or `$effect` blocks and react to state changes.
+ *
+ * Each WorkflowEditor component instance should create its own machine.
+ */
+export declare function createEditorStateMachine(initialState?: EditorState): EditorStateMachine;

package/dist/stores/editorStateMachine.svelte.js

@@ -0,0 +1,132 @@
+/**
+ * Editor State Machine for WorkflowEditor (Svelte 5 Runes)
+ *
+ * Centralizes all reactive guard logic into explicit states and transitions.
+ * Replaces scattered boolean flags (isDraggingNode, isRestoringFromHistory,
+ * lastEditorStoreValue identity checks) with a single source of truth.
+ *
+ * @module stores/editorStateMachine
+ */
+import { logger } from '../utils/logger.js';
+const transitions = {
+    uninitialized: {
+        WORKFLOW_LOADED: 'loading'
+    },
+    loading: {
+        LOAD_COMPLETE: 'idle'
+    },
+    idle: {
+        START_DRAG: 'dragging',
+        START_CONNECT: 'connecting',
+        START_DROP: 'dropping',
+        START_RESTORE: 'restoring',
+        EXTERNAL_STORE_CHANGE: 'loading',
+        START_DELETE: 'deleting',
+        START_NODE_UPDATE: 'updating_node',
+        WORKFLOW_SWITCHED: 'loading',
+        WORKFLOW_CLEARED: 'uninitialized'
+    },
+    dragging: {
+        STOP_DRAG: 'idle'
+    },
+    connecting: {
+        CONNECTION_MADE: 'idle',
+        CONNECTION_CANCELLED: 'idle'
+    },
+    dropping: {
+        DROP_COMPLETE: 'idle',
+        DROP_CANCELLED: 'idle'
+    },
+    restoring: {
+        RESTORE_COMPLETE: 'idle'
+    },
+    deleting: {
+        DELETE_COMPLETE: 'idle'
+    },
+    updating_node: {
+        UPDATE_COMPLETE: 'idle'
+    }
+};
+/** Global transitions valid from any state */
+const globalTransitions = {
+    RESET: 'uninitialized',
+    WORKFLOW_CLEARED: 'uninitialized'
+};
+// ---------------------------------------------------------------------------
+// Permissions table
+// ---------------------------------------------------------------------------
+const permissions = {
+    uninitialized: { canWriteToStore: false, canPushHistory: false, suppressEffect: false },
+    loading: { canWriteToStore: false, canPushHistory: false, suppressEffect: false },
+    idle: { canWriteToStore: true, canPushHistory: true, suppressEffect: false },
+    dragging: { canWriteToStore: true, canPushHistory: false, suppressEffect: true },
+    connecting: { canWriteToStore: true, canPushHistory: false, suppressEffect: true },
+    dropping: { canWriteToStore: true, canPushHistory: false, suppressEffect: true },
+    restoring: { canWriteToStore: true, canPushHistory: false, suppressEffect: true },
+    deleting: { canWriteToStore: true, canPushHistory: false, suppressEffect: true },
+    updating_node: { canWriteToStore: true, canPushHistory: false, suppressEffect: true }
+};
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an editor state machine instance.
+ *
+ * Uses Svelte 5 `$state` rune for reactivity so that components can
+ * read `machine.current` and `machine.permissions` inside `$derived`
+ * or `$effect` blocks and react to state changes.
+ *
+ * Each WorkflowEditor component instance should create its own machine.
+ */
+export function createEditorStateMachine(initialState = 'uninitialized') {
+    let _current = $state(initialState);
+    let _permissions = $state(permissions[initialState]);
+    const _listeners = new Set();
+    function send(event) {
+        // Check global transitions first (valid from any state)
+        const globalTarget = globalTransitions[event];
+        if (globalTarget !== undefined) {
+            const from = _current;
+            _current = globalTarget;
+            _permissions = permissions[globalTarget];
+            for (const cb of _listeners)
+                cb(from, event, globalTarget);
+            return true;
+        }
+        // Check state-specific transitions
+        const stateTransitions = transitions[_current];
+        const target = stateTransitions?.[event];
+        if (target === undefined) {
+            logger.warn(`[EditorFSM] Invalid transition: ${_current} + ${event}`);
+            return false;
+        }
+        const from = _current;
+        _current = target;
+        _permissions = permissions[target];
+        for (const cb of _listeners)
+            cb(from, event, target);
+        return true;
+    }
+    function canSend(event) {
+        if (globalTransitions[event] !== undefined)
+            return true;
+        return transitions[_current]?.[event] !== undefined;
+    }
+    function onTransition(callback) {
+        _listeners.add(callback);
+        return () => {
+            _listeners.delete(callback);
+        };
+    }
+    return {
+        get current() {
+            return _current;
+        },
+        get permissions() {
+            return _permissions;
+        },
+        send,
+        canSend,
+        onTransition
+    };
+}

package/dist/stores/historyStore.svelte.d.ts

@@ -0,0 +1,136 @@
+/**
+ * History Store for FlowDrop (Svelte 5 Runes)
+ *
+ * Provides reactive Svelte 5 rune-based bindings for the history service.
+ * Exposes undo/redo state and actions for the workflow editor.
+ *
+ * @module stores/historyStore
+ */
+import { type HistoryState, type PushOptions } from '../services/historyService.js';
+import type { Workflow } from '../types/index.js';
+/**
+ * Clean up the historyService subscription created at module initialisation.
+ * Call this when tearing down the history store (e.g., in tests or on app
+ * unmount) to prevent memory leaks.
+ */
+export declare function cleanupHistorySubscription(): void;
+/**
+ * Get the current history state snapshot.
+ *
+ * Use this for binding to UI elements like undo/redo buttons.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { getHistoryState } from "./historyStore.svelte.js";
+ *
+ *   const state = $derived(getHistoryState());
+ * </script>
+ *
+ * <button disabled={!state.canUndo} onclick={historyActions.undo}>
+ *   Undo
+ * </button>
+ * ```
+ */
+export declare function getHistoryState(): HistoryState;
+/**
+ * Convenience getter for canUndo state.
+ *
+ * @returns Whether undo is currently available
+ */
+export declare function getCanUndo(): boolean;
+/**
+ * Convenience getter for canRedo state.
+ *
+ * @returns Whether redo is currently available
+ */
+export declare function getCanRedo(): boolean;
+/**
+ * Set the callback for restoring workflow state
+ *
+ * This callback is invoked when undo/redo operations return a workflow.
+ * Use this to update the workflow store or other state management.
+ *
+ * @param callback - Function to call with restored workflow
+ */
+export declare function setOnRestoreCallback(callback: ((workflow: Workflow) => void) | null): void;
+/**
+ * History actions for undo/redo operations
+ *
+ * Use these functions to interact with the history service.
+ * They handle the coordination between history and workflow state.
+ */
+export declare const historyActions: {
+    /**
+     * Initialize history with the current workflow
+     *
+     * Call this when loading a new workflow to reset history.
+     *
+     * @param workflow - The initial workflow state
+     */
+    initialize: (workflow: Workflow) => void;
+    /**
+     * Push the current state to history before making changes
+     *
+     * Call this BEFORE modifying the workflow to capture the "before" state.
+     *
+     * @param workflow - The current workflow state (before changes)
+     * @param options - Options for this history entry
+     */
+    pushState: (workflow: Workflow, options?: PushOptions) => void;
+    /**
+     * Undo the last change
+     *
+     * Restores the previous workflow state and invokes the restore callback.
+     *
+     * @returns true if undo was successful, false if at beginning of history
+     */
+    undo: () => boolean;
+    /**
+     * Redo the last undone change
+     *
+     * Restores the next workflow state and invokes the restore callback.
+     *
+     * @returns true if redo was successful, false if at end of history
+     */
+    redo: () => boolean;
+    /**
+     * Start a transaction for grouping multiple changes
+     *
+     * All changes during a transaction are combined into a single undo entry.
+     *
+     * @param workflow - The current workflow state (before changes)
+     * @param description - Description for the combined change
+     */
+    startTransaction: (workflow: Workflow, description?: string) => void;
+    /**
+     * Commit the current transaction
+     */
+    commitTransaction: () => void;
+    /**
+     * Cancel the current transaction without committing
+     */
+    cancelTransaction: () => void;
+    /**
+     * Clear all history
+     *
+     * @param currentWorkflow - If provided, keeps this as the initial state
+     */
+    clear: (currentWorkflow?: Workflow) => void;
+    /**
+     * Check if undo is available
+     */
+    canUndo: () => boolean;
+    /**
+     * Check if redo is available
+     */
+    canRedo: () => boolean;
+    /**
+     * Get the current history state synchronously
+     *
+     * @returns The current history state
+     */
+    getState: () => HistoryState;
+};
+export type { HistoryEntry, HistoryState, PushOptions } from '../services/historyService.js';
+export { HistoryService, historyService } from '../services/historyService.js';