@d34dman/flowdrop 0.0.44 → 0.0.46

package/dist/stores/historyStore.d.ts

@@ -0,0 +1,133 @@
+/**
+ * History Store for FlowDrop
+ *
+ * Provides reactive Svelte store 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';
+/**
+ * Internal writable store for history state
+ */
+declare const historyStateStore: import("svelte/store").Writable<HistoryState>;
+/**
+ * Reactive history state store
+ *
+ * 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";
+ * </script>
+ *
+ * <button disabled={!$historyStateStore.canUndo} onclick={historyActions.undo}>
+ *   Undo
+ * </button>
+ * ```
+ */
+export { historyStateStore };
+/**
+ * Derived store for canUndo state
+ *
+ * Convenience store that directly exposes the canUndo boolean.
+ */
+export declare const canUndo: import("svelte/store").Readable<boolean>;
+/**
+ * Derived store for canRedo state
+ *
+ * Convenience store that directly exposes the canRedo boolean.
+ */
+export declare const canRedo: import("svelte/store").Readable<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';

package/dist/stores/historyStore.js

@@ -0,0 +1,188 @@
+/**
+ * History Store for FlowDrop
+ *
+ * Provides reactive Svelte store 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
+// =========================================================================
+/**
+ * Internal writable store for history state
+ */
+const historyStateStore = writable({
+    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);
+});
+/**
+ * Reactive history state store
+ *
+ * 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";
+ * </script>
+ *
+ * <button disabled={!$historyStateStore.canUndo} onclick={historyActions.undo}>
+ *   Undo
+ * </button>
+ * ```
+ */
+export { historyStateStore };
+/**
+ * Derived store for canUndo state
+ *
+ * Convenience store that directly exposes the canUndo boolean.
+ */
+export const canUndo = derived(historyStateStore, ($state) => $state.canUndo);
+/**
+ * Derived store for canRedo state
+ *
+ * Convenience store that directly exposes the canRedo boolean.
+ */
+export const canRedo = derived(historyStateStore, ($state) => $state.canRedo);
+// =========================================================================
+// History Actions
+// =========================================================================
+/**
+ * Callback for when workflow state is restored from history
+ *
+ * Set this to handle the restored workflow state (e.g., update the workflow store)
+ */
+let onRestoreCallback = null;
+/**
+ * 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 function setOnRestoreCallback(callback) {
+    onRestoreCallback = callback;
+}
+/**
+ * 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 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) => {
+        historyService.initialize(workflow);
+    },
+    /**
+     * 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, options) => {
+        historyService.push(workflow, options);
+    },
+    /**
+     * 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: () => {
+        const previousState = historyService.undo();
+        if (previousState && onRestoreCallback) {
+            onRestoreCallback(previousState);
+            return true;
+        }
+        return previousState !== null;
+    },
+    /**
+     * 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: () => {
+        const nextState = historyService.redo();
+        if (nextState && onRestoreCallback) {
+            onRestoreCallback(nextState);
+            return true;
+        }
+        return false;
+    },
+    /**
+     * 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, description) => {
+        historyService.startTransaction(workflow, description);
+    },
+    /**
+     * Commit the current transaction
+     */
+    commitTransaction: () => {
+        historyService.commitTransaction();
+    },
+    /**
+     * Cancel the current transaction without committing
+     */
+    cancelTransaction: () => {
+        historyService.cancelTransaction();
+    },
+    /**
+     * Clear all history
+     *
+     * @param currentWorkflow - If provided, keeps this as the initial state
+     */
+    clear: (currentWorkflow) => {
+        historyService.clear(currentWorkflow);
+    },
+    /**
+     * Check if undo is available
+     */
+    canUndo: () => {
+        return historyService.canUndo();
+    },
+    /**
+     * Check if redo is available
+     */
+    canRedo: () => {
+        return historyService.canRedo();
+    },
+    /**
+     * Get the current history state synchronously
+     *
+     * @returns The current history state
+     */
+    getState: () => {
+        return get(historyStateStore);
+    }
+};
+export { HistoryService, historyService } from '../services/historyService.js';

package/dist/stores/settingsStore.d.ts

@@ -9,7 +9,7 @@
  *
  * @module stores/settingsStore
  */
-import type { FlowDropSettings, ThemeSettings, EditorSettings, UISettings, BehaviorSettings, ApiSettings, PartialSettings, SyncStatus, ResolvedTheme, ThemePreference, SettingsChangeCallback, SettingsCategory } from "../types/settings.js";
+import type { FlowDropSettings, ThemeSettings, EditorSettings, UISettings, BehaviorSettings, ApiSettings, PartialSettings, SyncStatus, ResolvedTheme, ThemePreference, SettingsChangeCallback, SettingsCategory } from '../types/settings.js';
 /**
  * Main settings store (read-only access to current settings)
  */

package/dist/stores/settingsStore.js

@@ -9,8 +9,8 @@
  *
  * @module stores/settingsStore
  */
-import { writable, derived, get } from "svelte/store";
-import { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from "../types/settings.js";
+import { writable, derived, get } from 'svelte/store';
+import { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from '../types/settings.js';
 // =========================================================================
 // Internal State
 // =========================================================================
@@ -32,7 +32,7 @@ const changeListeners = new Set();
  * @returns Saved settings or null if not found/invalid
  */
 function loadFromStorage() {
-    if (typeof window === "undefined") {
+    if (typeof window === 'undefined') {
         return null;
     }
     try {
@@ -44,7 +44,7 @@ function loadFromStorage() {
         }
     }
     catch (error) {
-        console.warn("Failed to load settings from localStorage:", error);
+        console.warn('Failed to load settings from localStorage:', error);
     }
     return null;
 }
@@ -54,14 +54,14 @@ function loadFromStorage() {
  * @param settings - Settings to persist
  */
 function saveToStorage(settings) {
-    if (typeof window === "undefined") {
+    if (typeof window === 'undefined') {
         return;
     }
     try {
         localStorage.setItem(SETTINGS_STORAGE_KEY, JSON.stringify(settings));
     }
     catch (error) {
-        console.warn("Failed to save settings to localStorage:", error);
+        console.warn('Failed to save settings to localStorage:', error);
     }
 }
 // =========================================================================
@@ -117,7 +117,7 @@ const initialSettings = loadFromStorage() ?? DEFAULT_SETTINGS;
 const storeState = writable({
     settings: initialSettings,
     initialized: true,
-    syncStatus: "idle",
+    syncStatus: 'idle',
     lastSyncedAt: null,
     syncError: null
 });
@@ -163,26 +163,24 @@ export const apiSettings = derived(settingsStore, ($settings) => $settings.api);
  * System theme preference store
  * Updates when system preference changes
  */
-const systemTheme = writable(typeof window !== "undefined" ? getSystemTheme() : "light");
+const systemTheme = writable(typeof window !== 'undefined' ? getSystemTheme() : 'light');
 /**
  * Get the system's color scheme preference
  */
 function getSystemTheme() {
-    if (typeof window === "undefined") {
-        return "light";
+    if (typeof window === 'undefined') {
+        return 'light';
     }
-    return window.matchMedia("(prefers-color-scheme: dark)").matches
-        ? "dark"
-        : "light";
+    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 // Listen for system theme changes
-if (typeof window !== "undefined") {
-    const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+if (typeof window !== 'undefined') {
+    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
     const handleSystemThemeChange = (event) => {
-        systemTheme.set(event.matches ? "dark" : "light");
+        systemTheme.set(event.matches ? 'dark' : 'light');
     };
     if (mediaQuery.addEventListener) {
-        mediaQuery.addEventListener("change", handleSystemThemeChange);
+        mediaQuery.addEventListener('change', handleSystemThemeChange);
     }
     else {
         // Fallback for older browsers
@@ -198,7 +196,7 @@ export const theme = derived(themeSettings, ($theme) => $theme.preference);
  * Always returns the actual theme being applied ('light' or 'dark')
  */
 export const resolvedTheme = derived([themeSettings, systemTheme], ([$themeSettings, $systemTheme]) => {
-    if ($themeSettings.preference === "auto") {
+    if ($themeSettings.preference === 'auto') {
         return $systemTheme;
     }
     return $themeSettings.preference;
@@ -221,7 +219,7 @@ function notifyChange(category, key, previousValue, newValue) {
             listener(event);
         }
         catch (error) {
-            console.error("Settings change listener error:", error);
+            console.error('Settings change listener error:', error);
         }
     });
 }
@@ -245,7 +243,7 @@ export function updateSettings(partial) {
         // Notify listeners for each changed category
         for (const category of Object.keys(partial)) {
             const partialCategory = partial[category];
-            if (partialCategory && typeof partialCategory === "object") {
+            if (partialCategory && typeof partialCategory === 'object') {
                 for (const key of Object.keys(partialCategory)) {
                     const prevCat = getCategoryAsRecord(previousSettings, category);
                     const newCat = getCategoryAsRecord(newSettings, category);
@@ -308,11 +306,11 @@ export function setTheme(newTheme) {
 export function toggleTheme() {
     const currentTheme = get(theme);
     const currentResolved = get(resolvedTheme);
-    if (currentTheme === "auto") {
-        setTheme(currentResolved === "dark" ? "light" : "dark");
+    if (currentTheme === 'auto') {
+        setTheme(currentResolved === 'dark' ? 'light' : 'dark');
     }
     else {
-        setTheme(currentTheme === "dark" ? "light" : "dark");
+        setTheme(currentTheme === 'dark' ? 'light' : 'dark');
     }
 }
 /**
@@ -321,14 +319,14 @@ export function toggleTheme() {
 export function cycleTheme() {
     const currentTheme = get(theme);
     switch (currentTheme) {
-        case "light":
-            setTheme("dark");
+        case 'light':
+            setTheme('dark');
             break;
-        case "dark":
-            setTheme("auto");
+        case 'dark':
+            setTheme('auto');
             break;
-        case "auto":
-            setTheme("light");
+        case 'auto':
+            setTheme('light');
             break;
     }
 }
@@ -338,10 +336,10 @@ export function cycleTheme() {
  * @param resolved - The resolved theme to apply
  */
 function applyTheme(resolved) {
-    if (typeof document === "undefined") {
+    if (typeof document === 'undefined') {
         return;
     }
-    document.documentElement.setAttribute("data-theme", resolved);
+    document.documentElement.setAttribute('data-theme', resolved);
 }
 /**
  * Initialize the theme system
@@ -373,12 +371,12 @@ export function setSettingsService(service) {
  */
 export async function syncSettingsToApi() {
     if (!settingsService) {
-        console.warn("Settings service not configured for API sync");
+        console.warn('Settings service not configured for API sync');
         return;
     }
     storeState.update((state) => ({
         ...state,
-        syncStatus: "syncing",
+        syncStatus: 'syncing',
         syncError: null
     }));
     try {
@@ -386,16 +384,16 @@ export async function syncSettingsToApi() {
         await settingsService.savePreferences(currentSettings);
         storeState.update((state) => ({
             ...state,
-            syncStatus: "synced",
+            syncStatus: 'synced',
             lastSyncedAt: Date.now(),
             syncError: null
         }));
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Failed to sync settings";
+        const errorMessage = error instanceof Error ? error.message : 'Failed to sync settings';
         storeState.update((state) => ({
             ...state,
-            syncStatus: "error",
+            syncStatus: 'error',
             syncError: errorMessage
         }));
         throw error;
@@ -408,12 +406,12 @@ export async function syncSettingsToApi() {
  */
 export async function loadSettingsFromApi() {
     if (!settingsService) {
-        console.warn("Settings service not configured for API sync");
+        console.warn('Settings service not configured for API sync');
         return;
     }
     storeState.update((state) => ({
         ...state,
-        syncStatus: "syncing",
+        syncStatus: 'syncing',
         syncError: null
     }));
     try {
@@ -422,7 +420,7 @@ export async function loadSettingsFromApi() {
         storeState.update((state) => ({
             ...state,
             settings: mergedSettings,
-            syncStatus: "synced",
+            syncStatus: 'synced',
             lastSyncedAt: Date.now(),
             syncError: null
         }));
@@ -430,10 +428,10 @@ export async function loadSettingsFromApi() {
         saveToStorage(mergedSettings);
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : "Failed to load settings from API";
+        const errorMessage = error instanceof Error ? error.message : 'Failed to load settings from API';
         storeState.update((state) => ({
             ...state,
-            syncStatus: "error",
+            syncStatus: 'error',
             syncError: errorMessage
         }));
         throw error;
@@ -482,7 +480,7 @@ export async function initializeSettings(options) {
         }
         catch {
             // Silently fail - local settings are still available
-            console.warn("Failed to sync settings from API on initialization");
+            console.warn('Failed to sync settings from API on initialization');
         }
     }
 }

package/dist/stores/themeStore.d.ts

@@ -21,9 +21,9 @@
  * @module stores/themeStore
  */
 /** Theme preference options */
-export type ThemePreference = "light" | "dark" | "auto";
+export type ThemePreference = 'light' | 'dark' | 'auto';
 /** Resolved theme (actual applied theme, never 'auto') */
-export type ResolvedTheme = "light" | "dark";
+export type ResolvedTheme = 'light' | 'dark';
 /**
  * User's theme preference store
  * Can be 'light', 'dark', or 'auto'