@d34dman/flowdrop 0.0.61 → 0.0.63

package/dist/services/variableService.js

@@ -5,6 +5,7 @@
  *
  * @module services/variableService
  */
+import { logger } from '../utils/logger.js';
 /**
  * Converts a JSON Schema property type to a TemplateVariableType.
  *
@@ -430,13 +431,13 @@ export async function getVariableSchema(node, nodes, edges, config, workflowId,
             }
             else if (!config.api.fallbackOnError) {
                 // API failed and fallback is disabled - return empty schema
-                console.error('Failed to fetch variables from API:', apiResult.error);
+                logger.error('Failed to fetch variables from API:', apiResult.error);
                 return { variables: {} };
             }
             // If fallback is enabled (default), continue to schema-based mode below
         }
         catch (error) {
-            console.error('Error fetching variables from API:', error);
+            logger.error('Error fetching variables from API:', error);
             // If fallback is disabled, return empty schema
             if (config.api.fallbackOnError === false) {
                 return { variables: {} };

package/dist/settings/index.d.ts

@@ -21,5 +21,5 @@ 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 { settingsStore, themeSettings, editorSettings, uiSettings, behaviorSettings, apiSettings, syncStatusStore, updateSettings, resetSettings, getSettings, initializeSettings, setSettingsService, syncSettingsToApi, loadSettingsFromApi, onSettingsChange } from '../stores/settingsStore.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

@@ -26,7 +26,7 @@ export { SETTINGS_CATEGORIES, SETTINGS_CATEGORY_LABELS, SETTINGS_CATEGORY_ICONS,
 // ============================================================================
 // Settings Stores
 // ============================================================================
-export { settingsStore, themeSettings, editorSettings, uiSettings, behaviorSettings, apiSettings, syncStatusStore, updateSettings, resetSettings, getSettings, initializeSettings, setSettingsService, syncSettingsToApi, loadSettingsFromApi, onSettingsChange } from '../stores/settingsStore.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';
 // ============================================================================
 // Settings Service
 // ============================================================================

package/dist/stores/{categoriesStore.d.ts → categoriesStore.svelte.d.ts}

@@ -1,14 +1,14 @@
 /**
- * Categories Store for FlowDrop
+ * 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';
 /**
- * Readable store of all category definitions, sorted by weight.
+ * Get all category definitions, sorted by weight.
  */
-export declare const categories: import("svelte/store").Readable<CategoryDefinition[]>;
+export declare function getCategories(): CategoryDefinition[];
 /**
  * Initialize categories with API data, merging with defaults.
  * API categories override defaults by name; custom categories are appended.

package/dist/stores/{categoriesStore.js → categoriesStore.svelte.js}

@@ -1,30 +1,31 @@
 /**
- * Categories Store for FlowDrop
+ * 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 { writable, derived, get } from 'svelte/store';
 import { DEFAULT_CATEGORIES } from '../config/defaultCategories.js';
 /**
- * Internal writable store holding the category definitions.
+ * Internal reactive state holding the category definitions.
  * Initialized with defaults, updated when API data is fetched.
  */
-const categoriesInternal = writable(DEFAULT_CATEGORIES);
+let categoriesState = $state([...DEFAULT_CATEGORIES]);
 /**
  * Derived lookup map: category name → CategoryDefinition
  */
-const categoryMap = derived(categoriesInternal, ($categories) => {
+let categoryMap = $derived((() => {
     const map = new Map();
-    for (const cat of $categories) {
+    for (const cat of categoriesState) {
         map.set(cat.name, cat);
     }
     return map;
-});
+})());
 /**
- * Readable store of all category definitions, sorted by weight.
+ * Get all category definitions, sorted by weight.
  */
-export const categories = derived(categoriesInternal, ($categories) => [...$categories].sort((a, b) => (a.weight ?? 999) - (b.weight ?? 999)));
+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.
@@ -41,14 +42,13 @@ export function initializeCategories(apiCategories) {
             ...cat
         });
     }
-    categoriesInternal.set(Array.from(defaultMap.values()));
+    categoriesState = Array.from(defaultMap.values());
 }
 /**
  * Get the display label for a category.
  */
 export function getCategoryLabel(category) {
-    const map = get(categoryMap);
-    const def = map.get(category);
+    const def = categoryMap.get(category);
     if (def?.label)
         return def.label;
     // Auto-generate: capitalize each word
@@ -61,20 +61,17 @@ export function getCategoryLabel(category) {
  * Get the icon for a category.
  */
 export function getCategoryIcon(category) {
-    const map = get(categoryMap);
-    return map.get(category)?.icon ?? 'mdi:folder';
+    return categoryMap.get(category)?.icon ?? 'mdi:folder';
 }
 /**
  * Get the color token for a category.
  */
 export function getCategoryColor(category) {
-    const map = get(categoryMap);
-    return map.get(category)?.color ?? 'var(--fd-node-slate)';
+    return categoryMap.get(category)?.color ?? 'var(--fd-node-slate)';
 }
 /**
  * Get the full category definition, or undefined if not found.
  */
 export function getCategoryDefinition(category) {
-    const map = get(categoryMap);
-    return map.get(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.d.ts → historyStore.svelte.d.ts}

@@ -1,7 +1,7 @@
 /**
- * History Store for FlowDrop
+ * History Store for FlowDrop (Svelte 5 Runes)
  *
- * Provides reactive Svelte store bindings for the history service.
+ * Provides reactive Svelte 5 rune-based bindings for the history service.
  * Exposes undo/redo state and actions for the workflow editor.
  *
  * @module stores/historyStore
@@ -9,39 +9,42 @@
 import { type HistoryState, type PushOptions } from '../services/historyService.js';
 import type { Workflow } from '../types/index.js';
 /**
- * Internal writable store for history state
+ * 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.
  */
-declare const historyStateStore: import("svelte/store").Writable<HistoryState>;
+export declare function cleanupHistorySubscription(): void;
 /**
- * Reactive history state store
+ * Get the current history state snapshot.
  *
  * Use this for binding to UI elements like undo/redo buttons.
- * Subscribe using Svelte's $ prefix or the subscribe method.
  *
  * @example
  * ```svelte
  * <script>
- *   import { historyStateStore } from "./historyStore.js";
+ *   import { getHistoryState } from "./historyStore.svelte.js";
+ *
+ *   const state = $derived(getHistoryState());
  * </script>
  *
- * <button disabled={!$historyStateStore.canUndo} onclick={historyActions.undo}>
+ * <button disabled={!state.canUndo} onclick={historyActions.undo}>
  *   Undo
  * </button>
  * ```
  */
-export { historyStateStore };
+export declare function getHistoryState(): HistoryState;
 /**
- * Derived store for canUndo state
+ * Convenience getter for canUndo state.
  *
- * Convenience store that directly exposes the canUndo boolean.
+ * @returns Whether undo is currently available
  */
-export declare const canUndo: import("svelte/store").Readable<boolean>;
+export declare function getCanUndo(): boolean;
 /**
- * Derived store for canRedo state
+ * Convenience getter for canRedo state.
  *
- * Convenience store that directly exposes the canRedo boolean.
+ * @returns Whether redo is currently available
  */
-export declare const canRedo: import("svelte/store").Readable<boolean>;
+export declare function getCanRedo(): boolean;
 /**
  * Set the callback for restoring workflow state
  *

package/dist/stores/{historyStore.js → historyStore.svelte.js}

@@ -1,60 +1,79 @@
 /**
- * History Store for FlowDrop
+ * History Store for FlowDrop (Svelte 5 Runes)
  *
- * Provides reactive Svelte store bindings for the history service.
+ * 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 { writable, derived, get } from 'svelte/store';
 import { historyService } from '../services/historyService.js';
 // =========================================================================
-// Reactive State Store
+// Reactive State (Runes)
 // =========================================================================
 /**
- * Internal writable store for history state
+ * Internal reactive state for history, powered by $state.
  */
-const historyStateStore = writable({
+let historyState = $state({
     canUndo: false,
     canRedo: false,
     currentIndex: 0,
     historyLength: 0,
     isInTransaction: false
 });
-// Subscribe to history service changes and update the store
-historyService.subscribe((state) => {
-    historyStateStore.set(state);
+// Subscribe to history service changes and update the rune state.
+// The unsubscribe function is stored so it can be called via
+// cleanupHistorySubscription() when the store is torn down.
+const _unsubscribeHistoryService = historyService.subscribe((state) => {
+    historyState = state;
 });
 /**
- * Reactive history state store
+ * 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 function cleanupHistorySubscription() {
+    _unsubscribeHistoryService();
+}
+// =========================================================================
+// Reactive Getters
+// =========================================================================
+/**
+ * Get the current history state snapshot.
  *
  * Use this for binding to UI elements like undo/redo buttons.
- * Subscribe using Svelte's $ prefix or the subscribe method.
  *
  * @example
  * ```svelte
  * <script>
- *   import { historyStateStore } from "./historyStore.js";
+ *   import { getHistoryState } from "./historyStore.svelte.js";
+ *
+ *   const state = $derived(getHistoryState());
  * </script>
  *
- * <button disabled={!$historyStateStore.canUndo} onclick={historyActions.undo}>
+ * <button disabled={!state.canUndo} onclick={historyActions.undo}>
  *   Undo
  * </button>
  * ```
  */
-export { historyStateStore };
+export function getHistoryState() {
+    return historyState;
+}
 /**
- * Derived store for canUndo state
+ * Convenience getter for canUndo state.
  *
- * Convenience store that directly exposes the canUndo boolean.
+ * @returns Whether undo is currently available
  */
-export const canUndo = derived(historyStateStore, ($state) => $state.canUndo);
+export function getCanUndo() {
+    return historyState.canUndo;
+}
 /**
- * Derived store for canRedo state
+ * Convenience getter for canRedo state.
  *
- * Convenience store that directly exposes the canRedo boolean.
+ * @returns Whether redo is currently available
  */
-export const canRedo = derived(historyStateStore, ($state) => $state.canRedo);
+export function getCanRedo() {
+    return historyState.canRedo;
+}
 // =========================================================================
 // History Actions
 // =========================================================================
@@ -182,7 +201,7 @@ export const historyActions = {
      * @returns The current history state
      */
     getState: () => {
-        return get(historyStateStore);
+        return historyState;
     }
 };
 export { HistoryService, historyService } from '../services/historyService.js';

package/dist/stores/{interruptStore.d.ts → interruptStore.svelte.d.ts}

@@ -1,11 +1,12 @@
 /**
- * Interrupt Store
+ * Interrupt Store (Svelte 5 Runes)
  *
- * Svelte stores for managing interrupt state using a lightweight state machine.
+ * Rune-based reactive state for managing interrupt state using a lightweight state machine.
  * Ensures valid state transitions and prevents deadlocks.
  *
  * @module stores/interruptStore
  */
+import { SvelteMap } from 'svelte/reactivity';
 import type { Interrupt } from '../types/interrupt.js';
 import { type InterruptState, type TransitionResult } from '../types/interruptState.js';
 /**
@@ -16,30 +17,30 @@ export interface InterruptWithState extends Interrupt {
     machineState: InterruptState;
 }
 /**
- * Map of all interrupts by ID
- * Key: interrupt ID, Value: Interrupt object with state
+ * Get the reactive interrupts map.
+ * Use this in components within $derived() for reactivity.
  */
-export declare const interrupts: import("svelte/store").Writable<Map<string, InterruptWithState>>;
+export declare function getInterruptsMap(): SvelteMap<string, InterruptWithState>;
 /**
- * Derived store for pending interrupt IDs
+ * Get pending interrupt IDs (interrupts not in a terminal state)
  */
-export declare const pendingInterruptIds: import("svelte/store").Readable<string[]>;
+export declare function getPendingInterruptIds(): string[];
 /**
- * Derived store for pending interrupts array
+ * Get pending interrupts array (interrupts not in a terminal state)
  */
-export declare const pendingInterrupts: import("svelte/store").Readable<InterruptWithState[]>;
+export declare function getPendingInterrupts(): InterruptWithState[];
 /**
- * Derived store for count of pending interrupts
+ * Get count of pending interrupts
  */
-export declare const pendingInterruptCount: import("svelte/store").Readable<number>;
+export declare function getPendingInterruptCount(): number;
 /**
- * Derived store for resolved interrupts
+ * Get resolved interrupts array
  */
-export declare const resolvedInterrupts: import("svelte/store").Readable<InterruptWithState[]>;
+export declare function getResolvedInterrupts(): InterruptWithState[];
 /**
- * Derived store to check if any interrupt is currently submitting
+ * Check if any interrupt is currently submitting
  */
-export declare const isAnySubmitting: import("svelte/store").Readable<boolean>;
+export declare function getIsAnySubmitting(): boolean;
 /**
  * Interrupt store actions for modifying state
  */