@flowdrop/flowdrop 1.15.0 → 2.0.0-beta.2

package/dist/form/fieldRegistry.js

@@ -18,34 +18,55 @@
  *
  * @example Adding code editor support:
  * ```typescript
- * import { fieldComponentRegistry } from "@flowdrop/flowdrop/form";
- * import { FormCodeEditor, codeEditorFieldMatcher } from "@flowdrop/flowdrop/form/code";
+ * import { registerCodeEditorField } from "@flowdrop/flowdrop/form/code";
  *
- * fieldComponentRegistry.register("code-editor", {
- *   component: FormCodeEditor,
- *   matcher: codeEditorFieldMatcher,
- *   priority: 100
- * });
+ * // Registers the code editor into this instance's field registry.
+ * registerCodeEditorField(fd.fields);
  * ```
  */
-import { BaseRegistry } from '../registry/BaseRegistry.js';
+import { DEV } from 'esm-env';
+import { BaseRegistry } from '../registry/BaseRegistry.svelte.js';
 /**
  * Class-based field component registry.
  * Extends BaseRegistry with priority-based field resolution.
  */
-class FieldComponentRegistry extends BaseRegistry {
+export class FieldComponentRegistry extends BaseRegistry {
     /** Cached ordered keys by priority (highest first), invalidated on mutation */
     orderedKeys = null;
+    /**
+     * @param seed - Optional initial field registrations keyed by type. The
+     *   registry starts empty by default — the built-in light fields are
+     *   resolved inline by FormField/FormFieldLight, and heavy editors are
+     *   registered on demand via `form/code`, `form/markdown`, etc.
+     */
+    constructor(seed) {
+        super();
+        if (seed) {
+            for (const [type, registration] of Object.entries(seed)) {
+                this.register(type, registration);
+            }
+        }
+    }
     /**
      * Register a field component.
-     * Silently overwrites existing registrations (preserves legacy behavior).
+     *
+     * Re-registering an existing type overwrites it — useful for hosts
+     * replacing a built-in field — but warns in dev, since an *accidental*
+     * duplicate registration silently swallowing a field implementation is a
+     * miserable bug to track down.
      *
      * @param type - Unique identifier for this field type
      * @param registration - The field component registration
      */
     register(type, registration) {
+        if (DEV && this.items.has(type)) {
+            // eslint-disable-next-line no-console -- intentional dev diagnostic for accidental duplicate registrations
+            console.warn(`[flowdrop] Field type "${type}" is already registered — overwriting. ` +
+                'If this is intentional (replacing a built-in field), ignore this warning.');
+        }
         this.items.set(type, registration);
         this.orderedKeys = null;
+        this.touch();
         this.notifyListeners();
     }
     /**
@@ -73,6 +94,7 @@ class FieldComponentRegistry extends BaseRegistry {
      * @returns The matching registration or null if no match
      */
     resolveFieldComponent(schema) {
+        this.trackVersion(); // reactive dependency — cached orderedKeys path still tracks mutations
         const keys = this.getOrderedKeys();
         for (const key of keys) {
             const registration = this.items.get(key);
@@ -94,8 +116,6 @@ class FieldComponentRegistry extends BaseRegistry {
         return this.orderedKeys;
     }
 }
-/** Singleton instance of the field component registry */
-export const fieldComponentRegistry = new FieldComponentRegistry();
 // ============================================================================
 // Built-in Field Matchers (for light fields)
 // These are always available and used by the base FormField component

package/dist/form/full.d.ts

@@ -14,16 +14,18 @@
  * // Single import that sets up everything
  * import { SchemaForm, initializeAllFieldTypes } from "@flowdrop/flowdrop/form/full";
  *
- * // Call once at app startup
- * initializeAllFieldTypes();
+ * // Call once at app startup, against an instance's field registry
+ * initializeAllFieldTypes(fd.fields);
  *
  * // Now all field types are available
  * ```
  */
-export { SchemaForm, FormField, FormFieldFull, FormFieldWrapper, FormTextField, FormTextarea, FormNumberField, FormRangeField, FormToggle, FormSelect, FormCheckboxGroup, FormArray, FormFieldset, FormUISchemaRenderer } from './index.js';
+export { default as FormFieldFull } from '../components/form/FormField.svelte';
+export { SchemaForm, FormField, FormFieldWrapper, FormTextField, FormTextarea, FormNumberField, FormRangeField, FormToggle, FormSelect, FormCheckboxGroup, FormArray, FormFieldset, FormUISchemaRenderer } from './index.js';
 export type { FieldSchema, FieldType, FieldFormat, FieldOption, OneOfItem, SchemaFormProps, BaseFieldProps, TextFieldProps, TextareaFieldProps, NumberFieldProps, ToggleFieldProps, RangeFieldProps, SelectFieldProps, CheckboxGroupFieldProps, ArrayFieldProps, FormFieldFactoryProps, FormFieldWrapperProps, FieldComponentProps, FieldMatcher, FieldMatcherRegistration, FieldComponent, FieldComponentRegistration } from './index.js';
 export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, getSchemaOptions } from './index.js';
-export { fieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './index.js';
+export { FieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './index.js';
+import type { FieldComponentRegistry } from './fieldRegistry.js';
 export { FormCodeEditor, FormTemplateEditor } from './code.js';
 export { FormMarkdownEditor } from './markdown.js';
 export { registerCodeEditorField, registerTemplateEditorField, registerAllCodeEditors, isCodeEditorRegistered, isTemplateEditorRegistered, codeEditorFieldMatcher, templateEditorFieldMatcher } from './code.js';
@@ -31,26 +33,29 @@ export { registerMarkdownEditorField, isMarkdownEditorRegistered, markdownEditor
 /**
  * Initialize all form field types including heavy editors
  *
- * Call this once at application startup to enable all field types.
- * This includes:
+ * Call this once at application startup to enable all field types in the
+ * given instance's field registry. This includes:
  * - Code/JSON editor (CodeMirror)
  * - Template editor (CodeMirror with Twig/Liquid syntax)
  * - Markdown editor (CodeMirror 6)
  *
+ * Registration is idempotent per registry — each `register*Field` is a no-op
+ * if its field type is already present (see `FieldComponentRegistry.has`).
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
+ *
  * @example
  * ```typescript
  * import { initializeAllFieldTypes } from "@flowdrop/flowdrop/form/full";
  *
  * // In your app's entry point
- * initializeAllFieldTypes();
+ * initializeAllFieldTypes(fd.fields);
  * ```
  */
-export declare function initializeAllFieldTypes(): void;
+export declare function initializeAllFieldTypes(registry: FieldComponentRegistry): void;
 /**
- * Check if all field types have been initialized
- */
-export declare function areAllFieldTypesInitialized(): boolean;
-/**
- * Reset initialization state (useful for testing)
+ * Check if all heavy field types are registered in the given registry.
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  */
-export declare function resetFieldTypeInitialization(): void;
+export declare function areAllFieldTypesInitialized(registry: FieldComponentRegistry): boolean;

package/dist/form/full.js

@@ -14,19 +14,22 @@
  * // Single import that sets up everything
  * import { SchemaForm, initializeAllFieldTypes } from "@flowdrop/flowdrop/form/full";
  *
- * // Call once at app startup
- * initializeAllFieldTypes();
+ * // Call once at app startup, against an instance's field registry
+ * initializeAllFieldTypes(fd.fields);
  *
  * // Now all field types are available
  * ```
  */
 // Re-export everything from the light form module
+// The "everything statically bundled" FormField variant lives here (this is the
+// heavy entry), not in the light `@flowdrop/flowdrop/form`.
+export { default as FormFieldFull } from '../components/form/FormField.svelte';
 // Components
-export { SchemaForm, FormField, FormFieldFull, FormFieldWrapper, FormTextField, FormTextarea, FormNumberField, FormRangeField, FormToggle, FormSelect, FormCheckboxGroup, FormArray, FormFieldset, FormUISchemaRenderer } from './index.js';
+export { SchemaForm, FormField, FormFieldWrapper, FormTextField, FormTextarea, FormNumberField, FormRangeField, FormToggle, FormSelect, FormCheckboxGroup, FormArray, FormFieldset, FormUISchemaRenderer } from './index.js';
 // Utility functions
 export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, getSchemaOptions } from './index.js';
 // Field Registry
-export { fieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './index.js';
+export { FieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './index.js';
 // Import registration functions
 import { registerCodeEditorField, registerTemplateEditorField } from './code.js';
 import { registerMarkdownEditorField } from './markdown.js';
@@ -36,45 +39,40 @@ export { FormMarkdownEditor } from './markdown.js';
 // Re-export registration functions
 export { registerCodeEditorField, registerTemplateEditorField, registerAllCodeEditors, isCodeEditorRegistered, isTemplateEditorRegistered, codeEditorFieldMatcher, templateEditorFieldMatcher } from './code.js';
 export { registerMarkdownEditorField, isMarkdownEditorRegistered, markdownEditorFieldMatcher } from './markdown.js';
-/**
- * Track if all field types have been initialized
- */
-let allFieldTypesInitialized = false;
 /**
  * Initialize all form field types including heavy editors
  *
- * Call this once at application startup to enable all field types.
- * This includes:
+ * Call this once at application startup to enable all field types in the
+ * given instance's field registry. This includes:
  * - Code/JSON editor (CodeMirror)
  * - Template editor (CodeMirror with Twig/Liquid syntax)
  * - Markdown editor (CodeMirror 6)
  *
+ * Registration is idempotent per registry — each `register*Field` is a no-op
+ * if its field type is already present (see `FieldComponentRegistry.has`).
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
+ *
  * @example
  * ```typescript
  * import { initializeAllFieldTypes } from "@flowdrop/flowdrop/form/full";
  *
  * // In your app's entry point
- * initializeAllFieldTypes();
+ * initializeAllFieldTypes(fd.fields);
  * ```
  */
-export function initializeAllFieldTypes() {
-    if (allFieldTypesInitialized) {
-        return;
-    }
-    registerCodeEditorField();
-    registerTemplateEditorField();
-    registerMarkdownEditorField();
-    allFieldTypesInitialized = true;
+export function initializeAllFieldTypes(registry) {
+    registerCodeEditorField(registry);
+    registerTemplateEditorField(registry);
+    registerMarkdownEditorField(registry);
 }
 /**
- * Check if all field types have been initialized
- */
-export function areAllFieldTypesInitialized() {
-    return allFieldTypesInitialized;
-}
-/**
- * Reset initialization state (useful for testing)
+ * Check if all heavy field types are registered in the given registry.
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  */
-export function resetFieldTypeInitialization() {
-    allFieldTypesInitialized = false;
+export function areAllFieldTypesInitialized(registry) {
+    return (registry.has('code-editor') &&
+        registry.has('template-editor') &&
+        registry.has('markdown-editor'));
 }

package/dist/form/index.d.ts

@@ -59,7 +59,6 @@
  */
 export { default as SchemaForm } from '../components/SchemaForm.svelte';
 export { default as FormField } from '../components/form/FormFieldLight.svelte';
-export { default as FormFieldFull } from '../components/form/FormField.svelte';
 export { default as FormFieldWrapper } from '../components/form/FormFieldWrapper.svelte';
 export { default as FormTextField } from '../components/form/FormTextField.svelte';
 export { default as FormTextarea } from '../components/form/FormTextarea.svelte';
@@ -71,13 +70,13 @@ export { default as FormCheckboxGroup } from '../components/form/FormCheckboxGro
 export { default as FormArray } from '../components/form/FormArray.svelte';
 export { default as FormFieldset } from '../components/form/FormFieldset.svelte';
 export { default as FormUISchemaRenderer } from '../components/form/FormUISchemaRenderer.svelte';
-export type { FieldSchema, FieldType, FieldFormat, FieldOption, OneOfItem, SchemaFormProps, BaseFieldProps, TextFieldProps, TextareaFieldProps, NumberFieldProps, ToggleFieldProps, RangeFieldProps, SelectFieldProps, CheckboxGroupFieldProps, ArrayFieldProps, FormFieldFactoryProps, FormFieldWrapperProps } from '../components/form/types.js';
+export type { FieldSchema, FieldType, FieldFormat, FieldOption, OneOfItem, SchemaFormProps, BaseFieldProps, TextFieldProps, TextareaFieldProps, NumberFieldProps, ToggleFieldProps, RangeFieldProps, SelectFieldProps, CheckboxGroupFieldProps, ArrayFieldProps, FormFieldFactoryProps, FormFieldWrapperProps, AutocompleteConfig } from '../components/form/types.js';
 export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, getSchemaOptions } from '../components/form/types.js';
-export { fieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './fieldRegistry.js';
+export { FieldComponentRegistry, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './fieldRegistry.js';
 export type { FieldComponentProps, FieldMatcher, FieldMatcherRegistration, FieldComponent, FieldComponentRegistration } from './fieldRegistry.js';
 /**
  * Use with Svelte's `getContext` inside custom field components registered
- * via `fieldComponentRegistry` to read sibling form field values.
+ * via `fd.fields` to read sibling form field values.
  *
  * @example
  * ```svelte

package/dist/form/index.js

@@ -66,8 +66,9 @@ export { default as SchemaForm } from '../components/SchemaForm.svelte';
 // ============================================================================
 // Use the light version of FormField that uses the registry for heavy editors
 export { default as FormField } from '../components/form/FormFieldLight.svelte';
-// Also export the original (full) version for users who want everything
-export { default as FormFieldFull } from '../components/form/FormField.svelte';
+// NOTE: `FormFieldFull` — the variant that *statically* bundles every editor
+// (including CodeMirror) — is intentionally NOT exported here; it would pull
+// CodeMirror into this light entry. Import it from `@flowdrop/flowdrop/form/full`.
 export { default as FormFieldWrapper } from '../components/form/FormFieldWrapper.svelte';
 export { default as FormTextField } from '../components/form/FormTextField.svelte';
 export { default as FormTextarea } from '../components/form/FormTextarea.svelte';
@@ -85,8 +86,8 @@ export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, get
 // Field Registry (for dynamic field registration)
 // ============================================================================
 export { 
-// Registry singleton
-fieldComponentRegistry, 
+// Registry class (instances live on `fd.fields`)
+FieldComponentRegistry, 
 // Built-in matchers for custom components
 hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './fieldRegistry.js';
 // ============================================================================
@@ -94,7 +95,7 @@ hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, ra
 // ============================================================================
 /**
  * Use with Svelte's `getContext` inside custom field components registered
- * via `fieldComponentRegistry` to read sibling form field values.
+ * via `fd.fields` to read sibling form field values.
  *
  * @example
  * ```svelte

package/dist/form/markdown.d.ts

@@ -12,7 +12,7 @@
  * import { registerMarkdownEditorField } from "@flowdrop/flowdrop/form/markdown";
  *
  * // Register markdown editor support (call once at app startup)
- * registerMarkdownEditorField();
+ * registerMarkdownEditorField(fd.fields);
  *
  * // Now SchemaForm will render markdown editors for format: "markdown"
  * const schema = {
@@ -23,7 +23,7 @@
  * };
  * ```
  */
-import type { FieldComponent } from './fieldRegistry.js';
+import type { FieldComponent, FieldComponentRegistry } from './fieldRegistry.js';
 import type { FieldSchema } from '../components/form/types.js';
 export { default as FormMarkdownEditor } from '../components/form/FormMarkdownEditor.svelte';
 export type { MarkdownEditorFieldProps } from '../components/form/types.js';
@@ -38,6 +38,7 @@ export declare function markdownEditorFieldMatcher(schema: FieldSchema): boolean
  * Call this function once at application startup to enable
  * markdown editor fields in SchemaForm.
  *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  * @param priority - Priority for field matching (default: 100)
  *
  * @example
@@ -45,25 +46,29 @@ export declare function markdownEditorFieldMatcher(schema: FieldSchema): boolean
  * // In your app's entry point:
  * import { registerMarkdownEditorField } from "@flowdrop/flowdrop/form/markdown";
  *
- * registerMarkdownEditorField();
+ * registerMarkdownEditorField(fd.fields);
  * ```
  */
-export declare function registerMarkdownEditorField(priority?: number): void;
+export declare function registerMarkdownEditorField(registry: FieldComponentRegistry, priority?: number): void;
 /**
  * Synchronously register markdown editor field using the imported component
  *
  * Use this when you've already imported the component and want immediate registration.
  *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
+ * @param component - The pre-imported markdown editor component
  * @param priority - Priority for field matching (default: 100)
  *
  * @example
  * ```typescript
  * import { registerMarkdownEditorFieldWithComponent, FormMarkdownEditor } from "@flowdrop/flowdrop/form/markdown";
- * registerMarkdownEditorFieldWithComponent(FormMarkdownEditor);
+ * registerMarkdownEditorFieldWithComponent(fd.fields, FormMarkdownEditor);
  * ```
  */
-export declare function registerMarkdownEditorFieldWithComponent(component: FieldComponent, priority?: number): void;
+export declare function registerMarkdownEditorFieldWithComponent(registry: FieldComponentRegistry, component: FieldComponent, priority?: number): void;
 /**
- * Check if markdown editor field is registered
+ * Check if markdown editor field is registered in the given registry.
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  */
-export declare function isMarkdownEditorRegistered(): boolean;
+export declare function isMarkdownEditorRegistered(registry: FieldComponentRegistry): boolean;

package/dist/form/markdown.js

@@ -12,7 +12,7 @@
  * import { registerMarkdownEditorField } from "@flowdrop/flowdrop/form/markdown";
  *
  * // Register markdown editor support (call once at app startup)
- * registerMarkdownEditorField();
+ * registerMarkdownEditorField(fd.fields);
  *
  * // Now SchemaForm will render markdown editors for format: "markdown"
  * const schema = {
@@ -23,7 +23,6 @@
  * };
  * ```
  */
-import { fieldComponentRegistry } from './fieldRegistry.js';
 // Re-export the component for direct usage if needed
 export { default as FormMarkdownEditor } from '../components/form/FormMarkdownEditor.svelte';
 /**
@@ -33,20 +32,13 @@ export { default as FormMarkdownEditor } from '../components/form/FormMarkdownEd
 export function markdownEditorFieldMatcher(schema) {
     return schema.format === 'markdown';
 }
-/**
- * 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.
  *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  * @param priority - Priority for field matching (default: 100)
  *
  * @example
@@ -54,21 +46,25 @@ fieldComponentRegistry.onClear(() => {
  * // In your app's entry point:
  * import { registerMarkdownEditorField } from "@flowdrop/flowdrop/form/markdown";
  *
- * registerMarkdownEditorField();
+ * registerMarkdownEditorField(fd.fields);
  * ```
  */
-export function registerMarkdownEditorField(priority = 100) {
-    if (markdownEditorRegistered) {
+export function registerMarkdownEditorField(registry, priority = 100) {
+    if (registry.has('markdown-editor')) {
         return;
     }
     // Dynamic import to ensure proper code splitting
     import('../components/form/FormMarkdownEditor.svelte').then((module) => {
-        fieldComponentRegistry.register('markdown-editor', {
+        // Re-check inside the async callback: two rapid synchronous calls both pass
+        // the guard above before either import resolves, so guard again here.
+        if (registry.has('markdown-editor')) {
+            return;
+        }
+        registry.register('markdown-editor', {
             component: module.default,
             matcher: markdownEditorFieldMatcher,
             priority
         });
-        markdownEditorRegistered = true;
     });
 }
 /**
@@ -76,28 +72,31 @@ export function registerMarkdownEditorField(priority = 100) {
  *
  * Use this when you've already imported the component and want immediate registration.
  *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
+ * @param component - The pre-imported markdown editor component
  * @param priority - Priority for field matching (default: 100)
  *
  * @example
  * ```typescript
  * import { registerMarkdownEditorFieldWithComponent, FormMarkdownEditor } from "@flowdrop/flowdrop/form/markdown";
- * registerMarkdownEditorFieldWithComponent(FormMarkdownEditor);
+ * registerMarkdownEditorFieldWithComponent(fd.fields, FormMarkdownEditor);
  * ```
  */
-export function registerMarkdownEditorFieldWithComponent(component, priority = 100) {
-    if (markdownEditorRegistered) {
+export function registerMarkdownEditorFieldWithComponent(registry, component, priority = 100) {
+    if (registry.has('markdown-editor')) {
         return;
     }
-    fieldComponentRegistry.register('markdown-editor', {
+    registry.register('markdown-editor', {
         component,
         matcher: markdownEditorFieldMatcher,
         priority
     });
-    markdownEditorRegistered = true;
 }
 /**
- * Check if markdown editor field is registered
+ * Check if markdown editor field is registered in the given registry.
+ *
+ * @param registry - The instance's field registry (e.g. `fd.fields`)
  */
-export function isMarkdownEditorRegistered() {
-    return markdownEditorRegistered;
+export function isMarkdownEditorRegistered(registry) {
+    return registry.has('markdown-editor');
 }

package/dist/helpers/proximityConnect.d.ts

@@ -6,6 +6,7 @@
  * compatible port pair and creates a preview/permanent edge.
  */
 import type { WorkflowNode as WorkflowNodeType, WorkflowEdge, NodePort, PortCoordinateMap } from '../types/index.js';
+import type { PortCompatibilityChecker } from '../utils/connections.js';
 /** A candidate proximity edge before it is finalized */
 export interface ProximityEdgeCandidate {
     id: string;
@@ -61,7 +62,7 @@ export declare class ProximityConnectHelper {
      *
      * @returns Array with at most ONE ProximityEdgeCandidate
      */
-    static findCompatibleEdges(draggedNode: WorkflowNodeType, allNodes: WorkflowNodeType[], existingEdges: WorkflowEdge[], minDistance: number): ProximityEdgeCandidate[];
+    static findCompatibleEdges(checker: PortCompatibilityChecker, draggedNode: WorkflowNodeType, allNodes: WorkflowNodeType[], existingEdges: WorkflowEdge[], minDistance: number): ProximityEdgeCandidate[];
     /**
      * Find the single best compatible edge using port-to-port distance.
      *
@@ -77,7 +78,7 @@ export declare class ProximityConnectHelper {
      *
      * @returns Array with at most ONE ProximityEdgeCandidate
      */
-    static findCompatibleEdgesByPortCoordinates(draggedNodeId: string, portCoordinates: PortCoordinateMap, existingEdges: WorkflowEdge[], maxDistance: number): ProximityEdgeCandidate[];
+    static findCompatibleEdgesByPortCoordinates(checker: PortCompatibilityChecker, draggedNodeId: string, portCoordinates: PortCoordinateMap, existingEdges: WorkflowEdge[], maxDistance: number): ProximityEdgeCandidate[];
     /**
      * Convert candidates to temporary (preview) WorkflowEdge objects with dashed styling.
      */

package/dist/helpers/proximityConnect.js

@@ -6,7 +6,6 @@
  * compatible port pair and creates a preview/permanent edge.
  */
 import { dynamicPortToNodePort } from '../types/index.js';
-import { getPortCompatibilityChecker } from '../utils/connections.js';
 import { v4 as uuidv4 } from 'uuid';
 /** CSS class applied to proximity preview edges */
 const PROXIMITY_EDGE_CLASS = 'flowdrop--edge--proximity-preview';
@@ -86,8 +85,7 @@ export class ProximityConnectHelper {
      *
      * @returns Array with at most ONE ProximityEdgeCandidate
      */
-    static findCompatibleEdges(draggedNode, allNodes, existingEdges, minDistance) {
-        const checker = getPortCompatibilityChecker();
+    static findCompatibleEdges(checker, draggedNode, allNodes, existingEdges, minDistance) {
         // Build lookup set for O(1) duplicate checks
         const existingEdgeSet = new Set(existingEdges.map((e) => `${e.source}:${e.sourceHandle}->${e.target}:${e.targetHandle}`));
         // Find the closest node within distance
@@ -198,8 +196,7 @@ export class ProximityConnectHelper {
      *
      * @returns Array with at most ONE ProximityEdgeCandidate
      */
-    static findCompatibleEdgesByPortCoordinates(draggedNodeId, portCoordinates, existingEdges, maxDistance) {
-        const checker = getPortCompatibilityChecker();
+    static findCompatibleEdgesByPortCoordinates(checker, draggedNodeId, portCoordinates, existingEdges, maxDistance) {
         // Build lookup set for O(1) duplicate checks
         const existingEdgeSet = new Set(existingEdges.map((e) => `${e.source}:${e.sourceHandle}->${e.target}:${e.targetHandle}`));
         // Partition ports by owner and direction, group other-node ports by dataType

package/dist/helpers/workflowEditorHelper.d.ts

@@ -3,6 +3,9 @@
  * Contains business logic for workflow operations
  */
 import type { WorkflowNode as WorkflowNodeType, NodeMetadata, Workflow, WorkflowEdge, NodeExecutionInfo } from '../types/index.js';
+import { type FlowDropInstance } from '../stores/instanceContainer.svelte.js';
+import type { ApiContext } from '../stores/apiContext.js';
+import type { AuthProvider } from '../types/auth.js';
 import type { EndpointConfig } from '../config/endpoints.js';
 export { generateNodeId, extractConfigDefaults } from '../utils/nodeIds.js';
 /**
@@ -33,11 +36,11 @@ export declare class NodeOperationsHelper {
     /**
      * Load nodes from API
      */
-    static loadNodesFromApi(providedNodes?: NodeMetadata[]): Promise<NodeMetadata[]>;
+    static loadNodesFromApi(api: ApiContext, providedNodes?: NodeMetadata[]): Promise<NodeMetadata[]>;
     /**
      * Load node execution information for all nodes in the workflow
      */
-    static loadNodeExecutionInfo(workflow: Workflow | null, pipelineId?: string): Promise<Record<string, NodeExecutionInfo>>;
+    static loadNodeExecutionInfo(api: ApiContext, workflow: Workflow | null, pipelineId?: string): Promise<Record<string, NodeExecutionInfo>>;
     /**
      * Create a new node from dropped data
      */
@@ -72,8 +75,13 @@ export declare class WorkflowOperationsHelper {
     static addNode(workflow: Workflow, node: WorkflowNodeType): Workflow;
     /**
      * Save workflow to backend
+     *
+     * @param api - The instance's API context (endpoints + client)
+     * @param workflow - The workflow to save
+     * @param instance - The FlowDrop instance whose store should be synced when
+     *   the server assigns a new ID; defaults to the page-default instance
      */
-    static saveWorkflow(workflow: Workflow | null): Promise<Workflow | null>;
+    static saveWorkflow(api: ApiContext, workflow: Workflow | null, instance?: FlowDropInstance): Promise<Workflow | null>;
     /**
      * Export workflow as JSON file
      */
@@ -127,7 +135,8 @@ export declare class WorkflowOperationsHelper {
  */
 export declare class ConfigurationHelper {
     /**
-     * Configure API endpoints
+     * Configure API endpoints (and optionally the auth provider) on the given
+     * instance's API context.
      */
-    static configureEndpoints(config: EndpointConfig): void;
+    static configureEndpoints(api: ApiContext, config: EndpointConfig, authProvider?: AuthProvider): void;
 }