@flowdrop/flowdrop 1.14.0 → 2.0.0-beta.1

package/package.json

@@ -3,7 +3,7 @@
   "description": "A drop-in visual workflow editor for any web application. You own the backend. You own the data. You own the orchestration.",
   "license": "MIT",
   "private": false,
-  "version": "1.14.0",
+  "version": "2.0.0-beta.1",
   "author": "Shibin Das (D34dMan)",
   "bugs": {
     "url": "https://github.com/flowdrop-io/flowdrop/issues"
@@ -47,12 +47,12 @@
     "dist",
     "!dist/**/*.test.*",
     "!dist/**/*.spec.*",
-    "!dist/**/*.map"
+    "!dist/**/*.map",
+    "CHANGELOG.md",
+    "MIGRATION-2.0.md"
   ],
   "sideEffects": [
-    "**/*.css",
-    "./dist/styles/base.css",
-    "./dist/editor/index.js"
+    "**/*.css"
   ],
   "svelte": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -269,6 +269,7 @@
   "dependencies": {
     "diff": "^8.0.3",
     "dompurify": "^3.3.1",
+    "esm-env": "^1.2.2",
     "marked": "^16.1.1",
     "svelte-5-french-toast": "^2.0.6",
     "uuid": "^11.1.0"

package/dist/messages/deprecation.d.ts

@@ -1,20 +0,0 @@
-/**
- * One-shot deprecation warning helper for the messages migration.
- *
- * Components that previously accepted per-string label props (e.g.
- * `saveLabel`, `cancelLabel`, `placeholder`, `addLabel`) keep accepting them
- * during the v1.x deprecation window. When a consumer passes one explicitly
- * we emit a single console.warn per (component, prop) pair so the noise is
- * bounded even if the prop is rebound on every render.
- *
- * Production builds skip the warning entirely.
- *
- * Removed in v2.0 along with the props themselves.
- */
-export declare function warnDeprecatedProp(component: string, prop: string, replacement: string): void;
-/**
- * Test-only: clear the warned-once cache so subsequent renders re-emit the
- * warning. Storybook stories and Vitest specs that share a module instance
- * need this to assert the warning fires per case.
- */
-export declare function __resetDeprecationWarningsForTests(): void;

package/dist/messages/deprecation.js

@@ -1,33 +0,0 @@
-/**
- * One-shot deprecation warning helper for the messages migration.
- *
- * Components that previously accepted per-string label props (e.g.
- * `saveLabel`, `cancelLabel`, `placeholder`, `addLabel`) keep accepting them
- * during the v1.x deprecation window. When a consumer passes one explicitly
- * we emit a single console.warn per (component, prop) pair so the noise is
- * bounded even if the prop is rebound on every render.
- *
- * Production builds skip the warning entirely.
- *
- * Removed in v2.0 along with the props themselves.
- */
-const warned = new Set();
-export function warnDeprecatedProp(component, prop, replacement) {
-    if (import.meta.env.PROD)
-        return;
-    const key = `${component}.${prop}`;
-    if (warned.has(key))
-        return;
-    warned.add(key);
-    // eslint-disable-next-line no-console
-    console.warn(`[flowdrop] <${component}> prop \`${prop}\` is deprecated and will be removed in v2.0. ` +
-        `Use \`messages\` on <FlowDrop> instead: ${replacement}`);
-}
-/**
- * Test-only: clear the warned-once cache so subsequent renders re-emit the
- * warning. Storybook stories and Vitest specs that share a module instance
- * need this to assert the warning fires per case.
- */
-export function __resetDeprecationWarningsForTests() {
-    warned.clear();
-}

package/dist/registry/plugin.d.ts

@@ -1,215 +0,0 @@
-/**
- * FlowDrop Plugin System
- * Provides APIs for external libraries to register custom node components.
- *
- * This enables a plugin ecosystem where:
- * - Third-party libraries can provide custom node types
- * - Custom nodes are namespaced to avoid conflicts
- * - Registration is simplified with a clean API
- */
-import { type NodeComponentProps, type NodeComponentCategory, type StatusPosition, type StatusSize } from './nodeComponentRegistry.js';
-import type { Component } from 'svelte';
-/**
- * Plugin configuration for external libraries.
- * Use this to register multiple node types from a library.
- */
-export interface FlowDropPluginConfig {
-    /**
-     * Unique namespace for this plugin.
-     * Used to prefix all node types (e.g., "mylib" -> "mylib:nodename").
-     * Should be lowercase, alphanumeric with optional hyphens.
-     */
-    namespace: string;
-    /** Display name for the plugin (for UI/debugging purposes) */
-    name: string;
-    /** Plugin version (optional, for debugging) */
-    version?: string;
-    /** Description of what this plugin provides */
-    description?: string;
-    /** Node components to register */
-    nodes: PluginNodeDefinition[];
-}
-/**
- * Simplified node definition for plugins.
- * Provides a cleaner API than full NodeComponentRegistration.
- */
-export interface PluginNodeDefinition {
-    /**
-     * Type identifier for this node.
-     * Will be prefixed with the plugin namespace (e.g., "fancy" -> "mylib:fancy").
-     */
-    type: string;
-    /** Display name shown in UI */
-    displayName: string;
-    /** Description of what this node does */
-    description?: string;
-    /** The Svelte component to render */
-    component: Component<NodeComponentProps>;
-    /** Icon in iconify format (e.g., "mdi:star") */
-    icon?: string;
-    /** Category for organizing in UI */
-    category?: NodeComponentCategory;
-    /** Status overlay position */
-    statusPosition?: StatusPosition;
-    /** Status overlay size */
-    statusSize?: StatusSize;
-}
-/**
- * Result of plugin registration.
- * Contains information about what was registered and any errors.
- */
-export interface PluginRegistrationResult {
-    /** Whether all nodes were registered successfully */
-    success: boolean;
-    /** The plugin namespace */
-    namespace: string;
-    /** Array of successfully registered type identifiers (namespaced) */
-    registeredTypes: string[];
-    /** Array of error messages for failed registrations */
-    errors: string[];
-}
-/**
- * Register a FlowDrop plugin with custom node components.
- * All node types are automatically namespaced with the plugin namespace.
- *
- * @param config - Plugin configuration with namespace and node definitions
- * @returns Result object with registered types and any errors
- *
- * @example
- * ```typescript
- * import { registerFlowDropPlugin } from "@flowdrop/lib";
- * import FancyNode from "./FancyNode.svelte";
- * import GlowNode from "./GlowNode.svelte";
- *
- * const result = registerFlowDropPlugin({
- *     namespace: "awesome",
- *     name: "Awesome Nodes",
- *     version: "1.0.0",
- *     nodes: [
- *         {
- *             type: "fancy",
- *             displayName: "Fancy Node",
- *             component: FancyNode,
- *             icon: "mdi:sparkles"
- *         },
- *         {
- *             type: "glow",
- *             displayName: "Glowing Node",
- *             component: GlowNode,
- *             icon: "mdi:lightbulb"
- *         }
- *     ]
- * });
- *
- * // Result:
- * // {
- * //     success: true,
- * //     namespace: "awesome",
- * //     registeredTypes: ["awesome:fancy", "awesome:glow"],
- * //     errors: []
- * // }
- * ```
- */
-export declare function registerFlowDropPlugin(config: FlowDropPluginConfig): PluginRegistrationResult;
-/**
- * Unregister all nodes from a plugin by namespace.
- *
- * @param namespace - The plugin namespace to unregister
- * @returns Array of unregistered type identifiers
- *
- * @example
- * ```typescript
- * const removed = unregisterFlowDropPlugin("awesome");
- * // Returns ["awesome:fancy", "awesome:glow"]
- * ```
- */
-export declare function unregisterFlowDropPlugin(namespace: string): string[];
-/**
- * Check if a namespace is valid.
- * Must be lowercase alphanumeric with optional hyphens.
- *
- * @param namespace - The namespace to validate
- * @returns true if valid
- */
-export declare function isValidNamespace(namespace: string): boolean;
-/**
- * Get all registered plugins (unique namespaces).
- *
- * @returns Array of namespace strings
- */
-export declare function getRegisteredPlugins(): string[];
-/**
- * Get the count of nodes registered by a plugin.
- *
- * @param namespace - The plugin namespace
- * @returns Number of nodes registered by this plugin
- */
-export declare function getPluginNodeCount(namespace: string): number;
-/**
- * Register a single custom node without a full plugin.
- * Useful for project-specific custom nodes.
- *
- * @param type - Type identifier (can be namespaced or plain)
- * @param displayName - Display name for UI
- * @param component - Svelte component
- * @param options - Additional options
- *
- * @example
- * ```typescript
- * import { registerCustomNode } from "@flowdrop/lib";
- * import MyNode from "./MyNode.svelte";
- *
- * registerCustomNode("myproject:special", "Special Node", MyNode, {
- *     icon: "mdi:star",
- *     description: "A special node for my project"
- * });
- * ```
- */
-export declare function registerCustomNode(type: string, displayName: string, component: Component<NodeComponentProps>, options?: {
-    description?: string;
-    icon?: string;
-    category?: NodeComponentCategory;
-    source?: string;
-    statusPosition?: StatusPosition;
-    statusSize?: StatusSize;
-}): void;
-/**
- * Create a plugin builder for a fluent API experience.
- *
- * @param namespace - Plugin namespace
- * @param name - Plugin name
- * @returns Plugin builder with chainable methods
- *
- * @example
- * ```typescript
- * import { createPlugin } from "@flowdrop/lib";
- *
- * createPlugin("awesome", "Awesome Nodes")
- *     .version("1.0.0")
- *     .node("fancy", "Fancy Node", FancyNode)
- *     .node("glow", "Glowing Node", GlowNode, { icon: "mdi:lightbulb" })
- *     .register();
- * ```
- */
-export declare function createPlugin(namespace: string, name: string): {
-    /**
-     * Set plugin version
-     */
-    version(v: string): /*elided*/ any;
-    /**
-     * Set plugin description
-     */
-    description(desc: string): /*elided*/ any;
-    /**
-     * Add a node to the plugin
-     */
-    node(type: string, displayName: string, component: Component<NodeComponentProps>, options?: Partial<Omit<PluginNodeDefinition, "type" | "displayName" | "component">>): /*elided*/ any;
-    /**
-     * Register the plugin
-     */
-    register(): PluginRegistrationResult;
-    /**
-     * Get the config without registering (for testing/inspection)
-     */
-    getConfig(): FlowDropPluginConfig;
-};

package/dist/registry/plugin.js

@@ -1,249 +0,0 @@
-/**
- * FlowDrop Plugin System
- * Provides APIs for external libraries to register custom node components.
- *
- * This enables a plugin ecosystem where:
- * - Third-party libraries can provide custom node types
- * - Custom nodes are namespaced to avoid conflicts
- * - Registration is simplified with a clean API
- */
-import { nodeComponentRegistry, createNamespacedType } from './nodeComponentRegistry.js';
-/**
- * Register a FlowDrop plugin with custom node components.
- * All node types are automatically namespaced with the plugin namespace.
- *
- * @param config - Plugin configuration with namespace and node definitions
- * @returns Result object with registered types and any errors
- *
- * @example
- * ```typescript
- * import { registerFlowDropPlugin } from "@flowdrop/lib";
- * import FancyNode from "./FancyNode.svelte";
- * import GlowNode from "./GlowNode.svelte";
- *
- * const result = registerFlowDropPlugin({
- *     namespace: "awesome",
- *     name: "Awesome Nodes",
- *     version: "1.0.0",
- *     nodes: [
- *         {
- *             type: "fancy",
- *             displayName: "Fancy Node",
- *             component: FancyNode,
- *             icon: "mdi:sparkles"
- *         },
- *         {
- *             type: "glow",
- *             displayName: "Glowing Node",
- *             component: GlowNode,
- *             icon: "mdi:lightbulb"
- *         }
- *     ]
- * });
- *
- * // Result:
- * // {
- * //     success: true,
- * //     namespace: "awesome",
- * //     registeredTypes: ["awesome:fancy", "awesome:glow"],
- * //     errors: []
- * // }
- * ```
- */
-export function registerFlowDropPlugin(config) {
-    const result = {
-        success: true,
-        namespace: config.namespace,
-        registeredTypes: [],
-        errors: []
-    };
-    // Validate namespace
-    if (!isValidNamespace(config.namespace)) {
-        result.success = false;
-        result.errors.push(`Invalid namespace "${config.namespace}". ` +
-            `Namespace must be lowercase alphanumeric with optional hyphens.`);
-        return result;
-    }
-    // Register each node
-    for (const nodeDef of config.nodes) {
-        try {
-            const namespacedType = createNamespacedType(config.namespace, nodeDef.type);
-            const registration = {
-                type: namespacedType,
-                displayName: nodeDef.displayName,
-                description: nodeDef.description,
-                component: nodeDef.component,
-                icon: nodeDef.icon,
-                category: nodeDef.category ?? 'custom',
-                source: config.namespace,
-                statusPosition: nodeDef.statusPosition,
-                statusSize: nodeDef.statusSize
-            };
-            nodeComponentRegistry.register(registration);
-            result.registeredTypes.push(namespacedType);
-        }
-        catch (error) {
-            result.success = false;
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            result.errors.push(`Failed to register ${config.namespace}:${nodeDef.type}: ${errorMessage}`);
-        }
-    }
-    return result;
-}
-/**
- * Unregister all nodes from a plugin by namespace.
- *
- * @param namespace - The plugin namespace to unregister
- * @returns Array of unregistered type identifiers
- *
- * @example
- * ```typescript
- * const removed = unregisterFlowDropPlugin("awesome");
- * // Returns ["awesome:fancy", "awesome:glow"]
- * ```
- */
-export function unregisterFlowDropPlugin(namespace) {
-    const unregistered = [];
-    const types = nodeComponentRegistry.getTypes();
-    for (const type of types) {
-        if (type.startsWith(`${namespace}:`)) {
-            if (nodeComponentRegistry.unregister(type)) {
-                unregistered.push(type);
-            }
-        }
-    }
-    return unregistered;
-}
-/**
- * Check if a namespace is valid.
- * Must be lowercase alphanumeric with optional hyphens.
- *
- * @param namespace - The namespace to validate
- * @returns true if valid
- */
-export function isValidNamespace(namespace) {
-    return /^[a-z][a-z0-9-]*$/.test(namespace);
-}
-/**
- * Get all registered plugins (unique namespaces).
- *
- * @returns Array of namespace strings
- */
-export function getRegisteredPlugins() {
-    const sources = new Set();
-    const registrations = nodeComponentRegistry.getAll();
-    for (const reg of registrations) {
-        if (reg.source && reg.source !== 'flowdrop') {
-            sources.add(reg.source);
-        }
-    }
-    return Array.from(sources);
-}
-/**
- * Get the count of nodes registered by a plugin.
- *
- * @param namespace - The plugin namespace
- * @returns Number of nodes registered by this plugin
- */
-export function getPluginNodeCount(namespace) {
-    return nodeComponentRegistry.getBySource(namespace).length;
-}
-/**
- * Register a single custom node without a full plugin.
- * Useful for project-specific custom nodes.
- *
- * @param type - Type identifier (can be namespaced or plain)
- * @param displayName - Display name for UI
- * @param component - Svelte component
- * @param options - Additional options
- *
- * @example
- * ```typescript
- * import { registerCustomNode } from "@flowdrop/lib";
- * import MyNode from "./MyNode.svelte";
- *
- * registerCustomNode("myproject:special", "Special Node", MyNode, {
- *     icon: "mdi:star",
- *     description: "A special node for my project"
- * });
- * ```
- */
-export function registerCustomNode(type, displayName, component, options = {}) {
-    nodeComponentRegistry.register({
-        type,
-        displayName,
-        component,
-        description: options.description,
-        icon: options.icon,
-        category: options.category ?? 'custom',
-        source: options.source ?? 'custom',
-        statusPosition: options.statusPosition,
-        statusSize: options.statusSize
-    });
-}
-/**
- * Create a plugin builder for a fluent API experience.
- *
- * @param namespace - Plugin namespace
- * @param name - Plugin name
- * @returns Plugin builder with chainable methods
- *
- * @example
- * ```typescript
- * import { createPlugin } from "@flowdrop/lib";
- *
- * createPlugin("awesome", "Awesome Nodes")
- *     .version("1.0.0")
- *     .node("fancy", "Fancy Node", FancyNode)
- *     .node("glow", "Glowing Node", GlowNode, { icon: "mdi:lightbulb" })
- *     .register();
- * ```
- */
-export function createPlugin(namespace, name) {
-    const config = {
-        namespace,
-        name,
-        nodes: []
-    };
-    const builder = {
-        /**
-         * Set plugin version
-         */
-        version(v) {
-            config.version = v;
-            return builder;
-        },
-        /**
-         * Set plugin description
-         */
-        description(desc) {
-            config.description = desc;
-            return builder;
-        },
-        /**
-         * Add a node to the plugin
-         */
-        node(type, displayName, component, options = {}) {
-            config.nodes.push({
-                type,
-                displayName,
-                component,
-                ...options
-            });
-            return builder;
-        },
-        /**
-         * Register the plugin
-         */
-        register() {
-            return registerFlowDropPlugin(config);
-        },
-        /**
-         * Get the config without registering (for testing/inspection)
-         */
-        getConfig() {
-            return { ...config };
-        }
-    };
-    return builder;
-}

package/dist/services/api.d.ts

@@ -1,129 +0,0 @@
-/**
- * Client-side API service for FlowDrop
- * Provides methods to interact with the backend APIs using configurable endpoints
- */
-import type { NodeMetadata, Workflow } from '../types/index.js';
-import type { EndpointConfig } from '../config/endpoints.js';
-/**
- * Set the endpoint configuration at runtime
- */
-export declare function setEndpointConfig(config: EndpointConfig): void;
-/**
- * Get the current endpoint configuration
- */
-export declare function getEndpointConfig(): EndpointConfig | null;
-/**
- * Node API methods
- */
-export declare const nodeApi: {
-    /**
-     * Get all node types with optional filtering
-     */
-    getNodes(options?: {
-        category?: string;
-        search?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<NodeMetadata[]>;
-    /**
-     * Get a specific node type by ID
-     */
-    getNode(id: string): Promise<NodeMetadata>;
-};
-/**
- * Workflow API methods
- */
-export declare const workflowApi: {
-    /**
-     * Get all workflows with optional filtering
-     */
-    getWorkflows(options?: {
-        search?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<Workflow[]>;
-    /**
-     * Get a specific workflow by ID
-     */
-    getWorkflow(id: string): Promise<Workflow>;
-    /**
-     * Create a new workflow
-     */
-    createWorkflow(workflow: Omit<Workflow, "id">): Promise<Workflow>;
-    /**
-     * Update an existing workflow
-     */
-    updateWorkflow(id: string, workflow: Partial<Workflow>): Promise<Workflow>;
-    /**
-     * Delete a workflow
-     */
-    deleteWorkflow(id: string): Promise<void>;
-    /**
-     * Save workflow (create or update).
-     *
-     * A workflow is considered existing when it already has an id (any format —
-     * integer, UUID, slug). Only a missing/empty id means "truly new".
-     *
-     * Note: globalSave.ts bypasses this method and calls createWorkflow /
-     * updateWorkflow directly so it can capture the new/existing decision before
-     * the uuidv4() fallback. This method is kept for external callers.
-     */
-    saveWorkflow(workflow: Workflow): Promise<Workflow>;
-};
-/**
- * Export the API service
- */
-export declare const api: {
-    nodes: {
-        /**
-         * Get all node types with optional filtering
-         */
-        getNodes(options?: {
-            category?: string;
-            search?: string;
-            limit?: number;
-            offset?: number;
-        }): Promise<NodeMetadata[]>;
-        /**
-         * Get a specific node type by ID
-         */
-        getNode(id: string): Promise<NodeMetadata>;
-    };
-    workflows: {
-        /**
-         * Get all workflows with optional filtering
-         */
-        getWorkflows(options?: {
-            search?: string;
-            limit?: number;
-            offset?: number;
-        }): Promise<Workflow[]>;
-        /**
-         * Get a specific workflow by ID
-         */
-        getWorkflow(id: string): Promise<Workflow>;
-        /**
-         * Create a new workflow
-         */
-        createWorkflow(workflow: Omit<Workflow, "id">): Promise<Workflow>;
-        /**
-         * Update an existing workflow
-         */
-        updateWorkflow(id: string, workflow: Partial<Workflow>): Promise<Workflow>;
-        /**
-         * Delete a workflow
-         */
-        deleteWorkflow(id: string): Promise<void>;
-        /**
-         * Save workflow (create or update).
-         *
-         * A workflow is considered existing when it already has an id (any format —
-         * integer, UUID, slug). Only a missing/empty id means "truly new".
-         *
-         * Note: globalSave.ts bypasses this method and calls createWorkflow /
-         * updateWorkflow directly so it can capture the new/existing decision before
-         * the uuidv4() fallback. This method is kept for external callers.
-         */
-        saveWorkflow(workflow: Workflow): Promise<Workflow>;
-    };
-};