@d34dman/flowdrop 0.0.57 → 0.0.59

package/dist/form/markdown.js

@@ -1,8 +1,8 @@
 /**
  * FlowDrop Form Markdown Editor Module
  *
- * Adds EasyMDE-based markdown editor support to SchemaForm.
- * This module bundles EasyMDE dependencies (~200KB).
+ * Adds CodeMirror 6-based markdown editor support to SchemaForm.
+ * Uses @codemirror/lang-markdown for syntax highlighting and marked for preview.
  *
  * @module form/markdown
  *
@@ -23,7 +23,7 @@
  * };
  * ```
  */
-import { registerFieldComponent } from './fieldRegistry.js';
+import { registerFieldComponent, fieldComponentRegistry } from './fieldRegistry.js';
 // Re-export the component for direct usage if needed
 export { default as FormMarkdownEditor } from '../components/form/FormMarkdownEditor.svelte';
 /**
@@ -37,11 +37,15 @@ export function markdownEditorFieldMatcher(schema) {
  * Track if markdown editor is registered
  */
 let markdownEditorRegistered = false;
+// Sync registration flag with registry.clear() for test isolation
+fieldComponentRegistry.onClear(() => {
+    markdownEditorRegistered = false;
+});
 /**
  * Register the markdown editor field component
  *
  * Call this function once at application startup to enable
- * markdown editor fields in SchemaForm. This loads EasyMDE dependencies.
+ * markdown editor fields in SchemaForm.
  *
  * @param priority - Priority for field matching (default: 100)
  *

package/dist/index.d.ts

@@ -11,7 +11,7 @@
  * - `@d34dman/flowdrop/editor` - WorkflowEditor with @xyflow/svelte
  * - `@d34dman/flowdrop/form` - SchemaForm with basic fields
  * - `@d34dman/flowdrop/form/code` - Code editor support (adds CodeMirror)
- * - `@d34dman/flowdrop/form/markdown` - Markdown editor support (adds EasyMDE)
+ * - `@d34dman/flowdrop/form/markdown` - Markdown editor support (CodeMirror 6)
  * - `@d34dman/flowdrop/display` - MarkdownDisplay (adds marked)
  * - `@d34dman/flowdrop/playground` - Playground for interactive workflow testing
  * - `@d34dman/flowdrop/styles` - CSS styles
@@ -25,7 +25,7 @@
  * ```
  *
  * **Note**: This will bundle ALL dependencies including @xyflow/svelte,
- * CodeMirror, EasyMDE, and marked. For smaller bundles, use sub-modules.
+ * CodeMirror and marked. For smaller bundles, use sub-modules.
  *
  * @module flowdrop
  */

package/dist/index.js

@@ -11,7 +11,7 @@
  * - `@d34dman/flowdrop/editor` - WorkflowEditor with @xyflow/svelte
  * - `@d34dman/flowdrop/form` - SchemaForm with basic fields
  * - `@d34dman/flowdrop/form/code` - Code editor support (adds CodeMirror)
- * - `@d34dman/flowdrop/form/markdown` - Markdown editor support (adds EasyMDE)
+ * - `@d34dman/flowdrop/form/markdown` - Markdown editor support (CodeMirror 6)
  * - `@d34dman/flowdrop/display` - MarkdownDisplay (adds marked)
  * - `@d34dman/flowdrop/playground` - Playground for interactive workflow testing
  * - `@d34dman/flowdrop/styles` - CSS styles
@@ -25,7 +25,7 @@
  * ```
  *
  * **Note**: This will bundle ALL dependencies including @xyflow/svelte,
- * CodeMirror, EasyMDE, and marked. For smaller bundles, use sub-modules.
+ * CodeMirror and marked. For smaller bundles, use sub-modules.
  *
  * @module flowdrop
  */

package/dist/registry/BaseRegistry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Base Registry
+ *
+ * Generic base class for all FlowDrop registries. Provides the shared
+ * mechanics: Map storage, subscribe/notify, onClear callbacks, and size tracking.
+ *
+ * Subclasses define their own `register()` method with domain-appropriate
+ * signatures, using `this.items` and `this.notifyListeners()` directly.
+ *
+ * @example
+ * ```typescript
+ * class MyRegistry extends BaseRegistry<string, MyItem> {
+ *   register(item: MyItem, overwrite = false): void {
+ *     if (this.items.has(item.id) && !overwrite) {
+ *       throw new Error(`Already registered: ${item.id}`);
+ *     }
+ *     this.items.set(item.id, item);
+ *     this.notifyListeners();
+ *   }
+ * }
+ * ```
+ */
+export declare class BaseRegistry<K, V> {
+    /** Internal storage map */
+    protected items: Map<K, V>;
+    /** Change listeners */
+    private listeners;
+    /** Callbacks invoked when the registry is cleared (for resetting flags) */
+    private clearCallbacks;
+    /**
+     * Unregister an item by key.
+     *
+     * @param key - The key to remove
+     * @returns true if the key was found and removed, false otherwise
+     */
+    unregister(key: K): boolean;
+    /**
+     * Get an item by key.
+     *
+     * @param key - The key to look up
+     * @returns The item if found, undefined otherwise
+     */
+    get(key: K): V | undefined;
+    /**
+     * Check if a key is registered.
+     *
+     * @param key - The key to check
+     * @returns true if the key is registered
+     */
+    has(key: K): boolean;
+    /**
+     * Get all registered keys.
+     *
+     * @returns Array of registered keys
+     */
+    getKeys(): K[];
+    /**
+     * Get all registered values.
+     *
+     * @returns Array of all registered items
+     */
+    getAll(): V[];
+    /**
+     * Subscribe to registry changes.
+     * Called whenever items are registered, unregistered, or cleared.
+     *
+     * @param listener - Callback to invoke on changes
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Register a callback invoked when the registry is cleared.
+     * Useful for resetting module-level registration flags in tests.
+     *
+     * @param callback - Function to call on clear
+     * @returns Unsubscribe function
+     */
+    onClear(callback: () => void): () => void;
+    /**
+     * Clear all registrations.
+     * Invokes onClear callbacks first, then notifies listeners.
+     */
+    clear(): void;
+    /**
+     * Get the count of registered items.
+     */
+    get size(): number;
+    /**
+     * Notify all change listeners.
+     */
+    protected notifyListeners(): void;
+}

package/dist/registry/BaseRegistry.js

@@ -0,0 +1,124 @@
+/**
+ * Base Registry
+ *
+ * Generic base class for all FlowDrop registries. Provides the shared
+ * mechanics: Map storage, subscribe/notify, onClear callbacks, and size tracking.
+ *
+ * Subclasses define their own `register()` method with domain-appropriate
+ * signatures, using `this.items` and `this.notifyListeners()` directly.
+ *
+ * @example
+ * ```typescript
+ * class MyRegistry extends BaseRegistry<string, MyItem> {
+ *   register(item: MyItem, overwrite = false): void {
+ *     if (this.items.has(item.id) && !overwrite) {
+ *       throw new Error(`Already registered: ${item.id}`);
+ *     }
+ *     this.items.set(item.id, item);
+ *     this.notifyListeners();
+ *   }
+ * }
+ * ```
+ */
+export class BaseRegistry {
+    /** Internal storage map */
+    items = new Map();
+    /** Change listeners */
+    listeners = new Set();
+    /** Callbacks invoked when the registry is cleared (for resetting flags) */
+    clearCallbacks = new Set();
+    /**
+     * Unregister an item by key.
+     *
+     * @param key - The key to remove
+     * @returns true if the key was found and removed, false otherwise
+     */
+    unregister(key) {
+        const result = this.items.delete(key);
+        if (result) {
+            this.notifyListeners();
+        }
+        return result;
+    }
+    /**
+     * Get an item by key.
+     *
+     * @param key - The key to look up
+     * @returns The item if found, undefined otherwise
+     */
+    get(key) {
+        return this.items.get(key);
+    }
+    /**
+     * Check if a key is registered.
+     *
+     * @param key - The key to check
+     * @returns true if the key is registered
+     */
+    has(key) {
+        return this.items.has(key);
+    }
+    /**
+     * Get all registered keys.
+     *
+     * @returns Array of registered keys
+     */
+    getKeys() {
+        return Array.from(this.items.keys());
+    }
+    /**
+     * Get all registered values.
+     *
+     * @returns Array of all registered items
+     */
+    getAll() {
+        return Array.from(this.items.values());
+    }
+    /**
+     * Subscribe to registry changes.
+     * Called whenever items are registered, unregistered, or cleared.
+     *
+     * @param listener - Callback to invoke on changes
+     * @returns Unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Register a callback invoked when the registry is cleared.
+     * Useful for resetting module-level registration flags in tests.
+     *
+     * @param callback - Function to call on clear
+     * @returns Unsubscribe function
+     */
+    onClear(callback) {
+        this.clearCallbacks.add(callback);
+        return () => this.clearCallbacks.delete(callback);
+    }
+    /**
+     * Clear all registrations.
+     * Invokes onClear callbacks first, then notifies listeners.
+     */
+    clear() {
+        this.items.clear();
+        for (const cb of this.clearCallbacks) {
+            cb();
+        }
+        this.notifyListeners();
+    }
+    /**
+     * Get the count of registered items.
+     */
+    get size() {
+        return this.items.size;
+    }
+    /**
+     * Notify all change listeners.
+     */
+    notifyListeners() {
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+}

package/dist/registry/builtinFormats.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Built-in Workflow Format Registration
+ *
+ * Registers the default FlowDrop and Agent Spec format adapters
+ * with the workflow format registry.
+ *
+ * This module is automatically loaded when imported,
+ * ensuring built-in formats are available without user action.
+ */
+/**
+ * Register all built-in workflow format adapters.
+ * Safe to call multiple times — will only register once.
+ */
+export declare function registerBuiltinFormats(): void;
+/**
+ * Check if built-in formats have been registered.
+ */
+export declare function areBuiltinFormatsRegistered(): boolean;
+/**
+ * Reset the registration state.
+ * Primarily useful for testing.
+ */
+export declare function resetBuiltinFormatRegistration(): void;

package/dist/registry/builtinFormats.js

@@ -0,0 +1,70 @@
+/**
+ * Built-in Workflow Format Registration
+ *
+ * Registers the default FlowDrop and Agent Spec format adapters
+ * with the workflow format registry.
+ *
+ * This module is automatically loaded when imported,
+ * ensuring built-in formats are available without user action.
+ */
+import { workflowFormatRegistry } from './workflowFormatRegistry.js';
+import { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
+import { validateForAgentSpecExport } from '../adapters/agentspec/validator.js';
+/**
+ * Track whether built-in formats have been registered.
+ * Prevents duplicate registration on hot reload.
+ */
+let registered = false;
+/**
+ * Register all built-in workflow format adapters.
+ * Safe to call multiple times — will only register once.
+ */
+export function registerBuiltinFormats() {
+    if (registered)
+        return;
+    // FlowDrop native — passthrough (StandardWorkflow ↔ JSON)
+    const flowdropAdapter = {
+        id: 'flowdrop',
+        name: 'FlowDrop',
+        description: 'FlowDrop native workflow format',
+        version: '1.0.0',
+        // No nodes — FlowDrop nodes are universal (no formats restriction)
+        export: (workflow) => JSON.stringify(workflow, null, 2),
+        import: (data) => JSON.parse(data)
+    };
+    workflowFormatRegistry.register(flowdropAdapter);
+    // Agent Spec — wraps existing AgentSpecAdapter
+    // No bundled nodes — Agent Spec node types are user-provided via
+    // getDefaultAgentSpecNodeTypes() or custom definitions passed to mountFlowDropApp()
+    const agentSpecAdapter = new AgentSpecAdapter();
+    const agentSpecFormatAdapter = {
+        id: 'agentspec',
+        name: 'Agent Spec (Oracle)',
+        description: 'Oracle Open Agent Spec format',
+        version: '1.0.0',
+        export: (workflow) => agentSpecAdapter.exportJSON(workflow),
+        import: (data) => agentSpecAdapter.importJSON(data),
+        validate: (workflow) => validateForAgentSpecExport(workflow)
+    };
+    workflowFormatRegistry.register(agentSpecFormatAdapter);
+    registered = true;
+}
+/**
+ * Check if built-in formats have been registered.
+ */
+export function areBuiltinFormatsRegistered() {
+    return registered;
+}
+/**
+ * Reset the registration state.
+ * Primarily useful for testing.
+ */
+export function resetBuiltinFormatRegistration() {
+    registered = false;
+}
+// Sync registration flag with registry.clear() for test isolation
+workflowFormatRegistry.onClear(() => {
+    registered = false;
+});
+// Auto-register built-in formats when this module is imported
+registerBuiltinFormats();

package/dist/registry/builtinNodes.js

@@ -203,5 +203,9 @@ export const BUILTIN_NODE_TYPES = [
     'terminal',
     'idea'
 ];
+// Sync registration flag with registry.clear() for test isolation
+nodeComponentRegistry.onClear(() => {
+    builtinsRegistered = false;
+});
 // Auto-register built-ins when this module is imported
 registerBuiltinNodes();

package/dist/registry/index.d.ts

@@ -2,6 +2,7 @@
  * Node Component Registry Module
  * Exports all registry-related functionality.
  */
-export { nodeComponentRegistry, createNamespacedType, parseNamespacedType, type NodeComponentProps, type NodeComponentRegistration, type NodeComponentCategory, type StatusPosition, type StatusSize, type NodeRegistrationFilter } from './nodeComponentRegistry.js';
+export { BaseRegistry } from './BaseRegistry.js';
+export { nodeComponentRegistry, createNamespacedType, parseNamespacedType, type NodeComponentProps, type NodeTypeInfo, type NodeComponentRegistration, type NodeComponentCategory, type StatusPosition, type StatusSize, type NodeRegistrationFilter } from './nodeComponentRegistry.js';
 export { BUILTIN_NODE_COMPONENTS, BUILTIN_NODE_TYPES, FLOWDROP_SOURCE, registerBuiltinNodes, areBuiltinsRegistered, resetBuiltinRegistration, resolveBuiltinAlias, isBuiltinType, getBuiltinTypes, type BuiltinNodeType } from './builtinNodes.js';
 export { registerFlowDropPlugin, unregisterFlowDropPlugin, registerCustomNode, createPlugin, isValidNamespace, getRegisteredPlugins, getPluginNodeCount, type FlowDropPluginConfig, type PluginNodeDefinition, type PluginRegistrationResult } from './plugin.js';

package/dist/registry/index.js

@@ -2,6 +2,8 @@
  * Node Component Registry Module
  * Exports all registry-related functionality.
  */
+// Base registry
+export { BaseRegistry } from './BaseRegistry.js';
 // Core registry
 export { nodeComponentRegistry, createNamespacedType, parseNamespacedType } from './nodeComponentRegistry.js';
 // Built-in nodes

package/dist/registry/nodeComponentRegistry.d.ts

@@ -10,6 +10,7 @@
  */
 import type { Component } from 'svelte';
 import type { WorkflowNode } from '../types/index.js';
+import { BaseRegistry } from './BaseRegistry.js';
 /**
  * Props interface that all node components must accept.
  * Any component registered in the registry must be compatible with these props.
@@ -44,18 +45,17 @@ export type StatusSize = 'sm' | 'md' | 'lg';
  */
 export type NodeComponentCategory = 'visual' | 'functional' | 'layout' | 'custom';
 /**
- * Metadata for registered node components.
- * Contains all information needed to use and display a node type.
+ * Framework-agnostic metadata for a node type.
+ * Contains all display/organizational information without any Svelte dependency.
+ * Use this interface when you only need node metadata (e.g., in adapters, headless consumers).
  */
-export interface NodeComponentRegistration {
+export interface NodeTypeInfo {
     /** Unique identifier for this node type (e.g., "simple", "mylib:custom") */
     type: string;
     /** Display name for UI purposes (e.g., "Simple Node") */
     displayName: string;
     /** Description of what this node type is for */
     description?: string;
-    /** The Svelte component to render for this node type */
-    component: Component<NodeComponentProps>;
     /** Icon to show in the node type selector (iconify format) */
     icon?: string;
     /** Category for grouping in UI */
@@ -67,6 +67,14 @@ export interface NodeComponentRegistration {
     /** Default status overlay size for this node type */
     statusSize?: StatusSize;
 }
+/**
+ * Full registration for a node component.
+ * Extends NodeTypeInfo with the Svelte component needed for rendering.
+ */
+export interface NodeComponentRegistration extends NodeTypeInfo {
+    /** The Svelte component to render for this node type */
+    component: Component<NodeComponentProps>;
+}
 /**
  * Options for filtering node registrations
  */
@@ -82,6 +90,8 @@ export interface NodeRegistrationFilter {
  * Central registry for node component types.
  * Allows built-in and third-party components to be registered and resolved.
  *
+ * Extends BaseRegistry for shared mechanics (subscribe, onClear, etc.).
+ *
  * @example
  * ```typescript
  * // Register a custom node
@@ -97,13 +107,11 @@ export interface NodeRegistrationFilter {
  * const component = nodeComponentRegistry.getComponent("myCustomNode");
  * ```
  */
-declare class NodeComponentRegistry {
-    /** Map of type -> registration */
-    private components;
+declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRegistration> {
     /** Default type to use when requested type is not found */
     private defaultType;
-    /** Listeners for registry changes */
-    private listeners;
+    /** Initial default type, restored on clear() */
+    private static readonly INITIAL_DEFAULT_TYPE;
     /**
      * Register a node component type.
      *
@@ -121,6 +129,10 @@ declare class NodeComponentRegistry {
      * });
      * ```
      */
+    /**
+     * Clear all registrations and reset default type.
+     */
+    clear(): void;
     register(registration: NodeComponentRegistration, overwrite?: boolean): void;
     /**
      * Register multiple components at once.
@@ -130,20 +142,6 @@ declare class NodeComponentRegistry {
      * @param overwrite - If true, allows overwriting existing registrations
      */
     registerAll(registrations: NodeComponentRegistration[], overwrite?: boolean): void;
-    /**
-     * Unregister a node component type.
-     *
-     * @param type - The type identifier to remove
-     * @returns true if the type was found and removed, false otherwise
-     */
-    unregister(type: string): boolean;
-    /**
-     * Get a registration by type.
-     *
-     * @param type - The type identifier to look up
-     * @returns The registration if found, undefined otherwise
-     */
-    get(type: string): NodeComponentRegistration | undefined;
     /**
      * Get the component for a type, with fallback to default.
      *
@@ -152,24 +150,18 @@ declare class NodeComponentRegistry {
      */
     getComponent(type: string): Component<NodeComponentProps> | undefined;
     /**
-     * Check if a type is registered.
+     * Get framework-agnostic metadata for a type, without the Svelte component.
      *
-     * @param type - The type identifier to check
-     * @returns true if the type is registered
+     * @param type - The type identifier to look up
+     * @returns The metadata if found, undefined otherwise
      */
-    has(type: string): boolean;
+    getMetadata(type: string): NodeTypeInfo | undefined;
     /**
      * Get all registered type identifiers.
      *
      * @returns Array of registered type strings
      */
     getTypes(): string[];
-    /**
-     * Get all registrations.
-     *
-     * @returns Array of all registered node component metadata
-     */
-    getAll(): NodeComponentRegistration[];
     /**
      * Get registrations filtered by criteria.
      *
@@ -213,18 +205,6 @@ declare class NodeComponentRegistry {
      * @returns The default type identifier
      */
     getDefaultType(): string;
-    /**
-     * Subscribe to registry changes.
-     * Called whenever components are registered or unregistered.
-     *
-     * @param listener - Callback to invoke on changes
-     * @returns Unsubscribe function
-     */
-    subscribe(listener: () => void): () => void;
-    /**
-     * Notify all listeners of a change.
-     */
-    private notifyListeners;
     /**
      * Get oneOf options for config forms.
      * Returns array suitable for JSON Schema oneOf with const/title.
@@ -256,17 +236,6 @@ declare class NodeComponentRegistry {
      * @returns The status size, or default "md"
      */
     getStatusSize(type: string): StatusSize;
-    /**
-     * Clear all registrations.
-     * Primarily useful for testing.
-     */
-    clear(): void;
-    /**
-     * Get the count of registered components.
-     *
-     * @returns Number of registered node types
-     */
-    get size(): number;
 }
 /** Singleton instance of the node component registry */
 export declare const nodeComponentRegistry: NodeComponentRegistry;