@comfyorg/comfyui-frontend-types 1.43.1 → 1.43.3

package/index.d.ts

@@ -2,12 +2,10 @@ import { ComfyApiWorkflow } from '../platform/workflow/validation/schemas/workfl
 import { ComfyWorkflowJSON } from '../platform/workflow/validation/schemas/workflowSchema';
 import { ComfyWorkflowJSON as ComfyWorkflowJSON_2 } from '../../validation/schemas/workflowSchema';
 import { Component } from 'vue';
-import { CurvePoint } from '../../../../components/curve/types';
-import { DOMWidget } from '../scripts/domWidget';
-import { DOMWidgetOptions } from '../scripts/domWidget';
+import { CurveData } from '../../../../components/curve/types';
 import { IFuseOptions } from 'fuse.js';
-import { ModelFile as ModelFile_2 } from '../../validation/schemas/workflowSchema';
 import { NodeId as NodeId_2 } from '../platform/workflow/validation/schemas/workflowSchema';
+import { NodeId as NodeId_3 } from '../workflow/validation/schemas/workflowSchema';
 import { objectOutputType } from 'zod';
 import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
@@ -145,6 +143,21 @@ declare interface BaseBottomPanelExtension {
     targetPanel?: 'terminal' | 'shortcuts';
 }
 
+declare interface BaseDOMWidget<V extends object | string = object | string> extends IBaseWidget<V, string, DOMWidgetOptions<V>> {
+    type: string;
+    options: DOMWidgetOptions<V>;
+    value: V;
+    callback?: (value: V) => void;
+    /** The unique ID of the widget. */
+    readonly id: string;
+    /** The node that the widget belongs to. */
+    readonly node: LGraphNode;
+    /** Whether the widget is visible. */
+    isVisible(): boolean;
+    /** The margin of the widget. */
+    margin: number;
+}
+
 declare interface BaseExportedGraph {
     /** Unique graph ID.  Automatically generated if not provided. */
     id: UUID;
@@ -1360,8 +1373,8 @@ export declare class ComfyApp {
      }): void;
      private showMissingNodesError;
      loadGraphData(graphData?: ComfyWorkflowJSON, clean?: boolean, restore_view?: boolean, workflow?: string | null | ComfyWorkflow, options?: {
-         showMissingNodesDialog?: boolean;
-         showMissingModelsDialog?: boolean;
+         showMissingNodes?: boolean;
+         showMissingModels?: boolean;
          checkForRerouteMigration?: boolean;
          openSource?: WorkflowOpenSource;
          deferWarnings?: boolean;
@@ -2084,10 +2097,11 @@ export declare class ComfyApp {
             }, ZodTypeAny, "passthrough">> | undefined;
             'Comfy.ConfirmClear'?: boolean | undefined;
             'Comfy.DevMode'?: boolean | undefined;
+            'Comfy.Appearance.DisableAnimations'?: boolean | undefined;
             'Comfy.UI.TabBarLayout'?: "Default" | "Legacy" | undefined;
-            'Comfy.Workflow.ShowMissingNodesWarning'?: boolean | undefined;
             'Comfy.Workflow.ShowMissingModelsWarning'?: boolean | undefined;
             'Comfy.Workflow.WarnBlueprintOverwrite'?: boolean | undefined;
+            'Comfy.Desktop.CloudNotificationShown'?: boolean | undefined;
             'Comfy.DisableFloatRounding'?: boolean | undefined;
             'Comfy.DisableSliders'?: boolean | undefined;
             'Comfy.DOMClippingEnabled'?: boolean | undefined;
@@ -2095,6 +2109,7 @@ export declare class ComfyApp {
             'Comfy.EnableTooltips'?: boolean | undefined;
             'Comfy.EnableWorkflowViewRestore'?: boolean | undefined;
             'Comfy.FloatRoundingPrecision'?: number | undefined;
+            'Comfy.Graph.AutoPanSpeed'?: number | undefined;
             'Comfy.Graph.CanvasInfo'?: boolean | undefined;
             'Comfy.Graph.CanvasMenu'?: boolean | undefined;
             'Comfy.Graph.CtrlShiftZoom'?: boolean | undefined;
@@ -2180,6 +2195,7 @@ export declare class ComfyApp {
                 commandId: string;
                 targetElementId?: string | undefined;
             }[] | undefined;
+            'Comfy.Keybinding.CurrentPreset'?: string | undefined;
             'Comfy.Extension.Disabled'?: string[] | undefined;
             'Comfy.LinkRenderMode'?: number | undefined;
             'Comfy.Node.AutoSnapLinkToSlot'?: boolean | undefined;
@@ -2212,6 +2228,7 @@ export declare class ComfyApp {
             'Comfy.Canvas.LeftMouseClickBehavior'?: string | undefined;
             'Comfy.Canvas.MouseWheelScroll'?: string | undefined;
             'Comfy.VueNodes.Enabled'?: boolean | undefined;
+            'Comfy.AppBuilder.VueNodeSwitchDismissed'?: boolean | undefined;
             'Comfy.VueNodes.AutoScaleLayout'?: boolean | undefined;
             'Comfy.Assets.UseAssetAPI'?: boolean | undefined;
             'Comfy.Queue.QPOV2'?: boolean | undefined;
@@ -2666,9 +2683,43 @@ export declare class ComfyApp {
      */
     declare function distance(a: Readonly<Point>, b: Readonly<Point>): number;
 
-    export { DOMWidget }
+    /**
+     * A DOM widget that wraps a custom HTML element as a litegraph widget.
+     */
+    export declare interface DOMWidget<T extends HTMLElement, V extends object | string> extends BaseDOMWidget<V> {
+        element: T;
+        /**
+         * @deprecated Legacy property used by some extensions for customtext
+         * (textarea) widgets. Use {@link element} instead as it provides the same
+         * functionality and works for all DOMWidget types.
+         */
+        inputEl?: T;
+    }
 
-    export { DOMWidgetOptions }
+    export declare interface DOMWidgetOptions<V extends object | string> extends IWidgetOptions {
+        /**
+         * Whether to render a placeholder rectangle when zoomed out.
+         */
+        hideOnZoom?: boolean;
+        selectOn?: string[];
+        onHide?: (widget: BaseDOMWidget<V>) => void;
+        getValue?: () => V;
+        setValue?: (value: V) => void;
+        getMinHeight?: () => number;
+        getMaxHeight?: () => number;
+        getHeight?: () => string | number;
+        onDraw?: (widget: BaseDOMWidget<V>) => void;
+        margin?: number;
+        /**
+         * @deprecated Use `afterResize` instead. This callback is a legacy API
+         * that fires before resize happens, but it is no longer supported. Now it
+         * fires after resize happens.
+         * The resize logic has been upstreamed to litegraph in
+         * https://github.com/Comfy-Org/ComfyUI_frontend/pull/2557
+         */
+        beforeResize?: (this: BaseDOMWidget<V>, node: LGraphNode) => void;
+        afterResize?: (this: BaseDOMWidget<V>, node: LGraphNode) => void;
+    }
 
     declare class DragAndScale {
         /**
@@ -3437,9 +3488,9 @@ export declare class ComfyApp {
         height?: number | string;
     }
 
-    declare interface ICurveWidget extends IBaseWidget<CurvePoint[], 'curve'> {
+    declare interface ICurveWidget extends IBaseWidget<CurveData, 'curve'> {
         type: 'curve';
-        value: CurvePoint[];
+        value: CurveData;
     }
 
     /**
@@ -4104,8 +4155,6 @@ export declare class ComfyApp {
         static serialisedSchemaVersion: 1;
         static STATUS_STOPPED: number;
         static STATUS_RUNNING: number;
-        /** Generates a unique string key for a link's connection tuple. */
-        static _linkTupleKey(link: LLink): string;
         /** List of LGraph properties that are manually handled by {@link LGraph.configure}. */
         static readonly ConfigureProperties: Set<string>;
         id: UUID;
@@ -4434,6 +4483,8 @@ export declare class ComfyApp {
          * (origin_id, origin_slot, target_id, target_slot). Keeps the link
          * referenced by input.link and removes orphaned duplicates from
          * output.links and the graph's _links map.
+         *
+         * Three phases: group links by tuple, select the survivor, purge duplicates.
          */
         _removeDuplicateLinks(): void;
         /**
@@ -4645,6 +4696,7 @@ export declare class ComfyApp {
         readonly pointer: CanvasPointer;
         zoom_modify_alpha: boolean;
         zoom_speed: number;
+        auto_pan_speed: number;
         node_title_color: string;
         default_link_color: string;
         default_connection_color: {
@@ -4756,6 +4808,8 @@ export declare class ComfyApp {
         node_capturing_input?: LGraphNode | null;
         highlighted_links: Dictionary<boolean>;
         private _visibleReroutes;
+        private _autoPan;
+        private _ghostPointerHandler;
         dirty_canvas: boolean;
         dirty_bgcanvas: boolean;
         /** A map of nodes that require selective-redraw */
@@ -5030,6 +5084,7 @@ export declare class ComfyApp {
          * @param sticky If `true`, the item is added to the selection - see {@link processSelect}
          */
         private _startDraggingItems;
+        private _startNodeAutoPan;
         /**
          * Handles shared clean up and placement after items have been dragged.
          * @param e The event that completed the drag, e.g. pointerup, pointermove
@@ -5273,7 +5328,9 @@ export declare class ComfyApp {
          * @todo Update to align snapping with boundingRect
          * @todo Shapes
          */
-        drawSnapGuide(ctx: CanvasRenderingContext2D, item: Positionable, shape?: RenderShape): void;
+        drawSnapGuide(ctx: CanvasRenderingContext2D, item: Positionable, shape?: RenderShape, { offsetToSlot }?: {
+            offsetToSlot?: boolean;
+        }): void;
         drawConnections(ctx: CanvasRenderingContext2D): void;
         private getNodeModeAlpha;
         private _renderFloatingLinks;
@@ -5956,6 +6013,14 @@ export declare class ComfyApp {
          * @returns object or null { link: id, name: string, type: string or 0 }
          */
         getInputInfo(slot: number): INodeInputSlot | null;
+        /**
+         * Resolves the output source for cross-graph virtual nodes (e.g. Set/Get),
+         * bypassing {@link getInputLink} when the source lives in a different graph.
+         */
+        resolveVirtualOutput?(slot: number): {
+            node: LGraphNode;
+            slot: number;
+        } | undefined;
         /**
          * Returns the link info in the connection of an input slot
          * @returns object or null
@@ -6099,7 +6164,6 @@ export declare class ComfyApp {
         addCustomWidget<TPlainWidget extends IBaseWidget>(custom_widget: TPlainWidget): TPlainWidget | WidgetTypeMap[TPlainWidget['type']];
         addTitleButton(options: LGraphButtonOptions): LGraphButton;
         onTitleButtonClick(button: LGraphButton, canvas: LGraphCanvas): void;
-        removeWidgetByName(name: string): void;
         removeWidget(widget: IBaseWidget): void;
         ensureWidgetRemoved(widget: IBaseWidget): void;
         move(deltaX: number, deltaY: number): void;
@@ -7483,6 +7547,29 @@ export declare class ComfyApp {
     /** The names of all (optional) methods and functions in T */
     declare type MethodNames<T> = KeysOfType<T, ((...args: unknown[]) => unknown) | undefined>;
 
+    /**
+     * A single (node, widget, model) binding detected by the missing model pipeline.
+     * The same model name may appear multiple times across different nodes.
+     */
+    declare interface MissingModelCandidate {
+        /** Undefined for workflow-level models not tied to a specific node. */
+        nodeId?: NodeId_3;
+        nodeType: string;
+        widgetName: string;
+        isAssetSupported: boolean;
+        name: string;
+        directory?: string;
+        url?: string;
+        hash?: string;
+        hashType?: string;
+        /**
+         * - `true`  — confirmed missing
+         * - `false` — confirmed installed
+         * - `undefined` — pending async verification (asset-supported nodes only)
+         */
+        isMissing: boolean | undefined;
+    }
+
     declare type MissingNodeType = string | {
         type: string;
         nodeId?: string | number;
@@ -7846,10 +7933,7 @@ export declare class ComfyApp {
 
     declare interface PendingWarnings {
         missingNodeTypes?: MissingNodeType[];
-        missingModels?: {
-            missingModels: ModelFile_2[];
-            paths: Record<string, string[]>;
-        };
+        missingModelCandidates?: MissingModelCandidate[];
     }
 
     /**
@@ -8628,6 +8712,16 @@ export declare class ComfyApp {
         getIoNodeOnPos(x: number, y: number): SubgraphInputNode | SubgraphOutputNode | undefined;
         private _configureSubgraph;
         configure(data: (ISerialisedGraph & ExportedSubgraph) | (SerialisableGraph & ExportedSubgraph), keep_old?: boolean): boolean | undefined;
+        /**
+         * Repairs SubgraphInput/Output `linkIds` that reference links removed
+         * by `_removeDuplicateLinks` during `super.configure()`.
+         *
+         * For each stale link ID, finds the surviving link that connects to the
+         * same IO node and slot index, and substitutes it.
+         */
+        private _repairIOSlotLinkIds;
+        private _repairSlotLinkIds;
+        private _findLinkBySlot;
         attachCanvas(canvas: LGraphCanvas): void;
         addInput(name: string, type: string): SubgraphInput;
         addOutput(name: string, type: string): SubgraphOutput;
@@ -8749,8 +8843,8 @@ export declare class ComfyApp {
     declare interface SubgraphInputEventMap extends LGraphEventMap {
         'input-connected': {
             input: INodeInputSlot;
-            widget: IBaseWidget;
-            node: LGraphNode;
+            widget?: IBaseWidget;
+            node?: LGraphNode;
         };
         'input-disconnected': {
             input: SubgraphInput;
@@ -8928,6 +9022,7 @@ export declare class ComfyApp {
         private _buildDisplayNameByViewKey;
         private _makePromotionEntryKey;
         private _makePromotionViewKey;
+        private _serializeEntries;
         private _resolveLegacyEntry;
         /** Manages lifecycle of all subgraph event listeners */
         private _eventAbortController;
@@ -8975,7 +9070,6 @@ export declare class ComfyApp {
         private _clearDomOverrideForView;
         private _removePromotedView;
         removeWidget(widget: IBaseWidget): void;
-        removeWidgetByName(name: string): void;
         ensureWidgetRemoved(widget: IBaseWidget): void;
         onRemoved(): void;
         drawTitleBox(ctx: CanvasRenderingContext2D, { scale, low_quality, title_height, box_size }: DrawTitleBoxOptions): void;
@@ -8986,6 +9080,7 @@ export declare class ComfyApp {
          */
         serialize(): ISerialisedNode;
         clone(): LGraphNode | null;
+        getSlotShape(slot: SubgraphInput, extraInput?: INodeInputSlot): RenderShape | undefined;
     }
 
     /**
@@ -15198,6 +15293,9 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined;
         };
         prompt_id?: string | undefined;
+        exec_info?: {
+            queue_remaining?: number | undefined;
+        } | undefined;
         node_errors?: Record<string | number, {
             class_type: string;
             errors: {
@@ -15210,9 +15308,6 @@ export declare class ComfyApp {
             }[];
             dependent_outputs: any[];
         }> | undefined;
-        exec_info?: {
-            queue_remaining?: number | undefined;
-        } | undefined;
     }, {
         error: string | {
             type: string;
@@ -15223,6 +15318,9 @@ export declare class ComfyApp {
             }, z.ZodTypeAny, "passthrough"> | undefined;
         };
         prompt_id?: string | undefined;
+        exec_info?: {
+            queue_remaining?: number | undefined;
+        } | undefined;
         node_errors?: Record<string | number, {
             class_type: string;
             errors: {
@@ -15235,9 +15333,6 @@ export declare class ComfyApp {
             }[];
             dependent_outputs: any[];
         }> | undefined;
-        exec_info?: {
-            queue_remaining?: number | undefined;
-        } | undefined;
     }>;
 
     /**
@@ -16594,10 +16689,11 @@ export declare class ComfyApp {
         'Comfy.Canvas.BackgroundImage': z.ZodOptional<z.ZodString>;
         'Comfy.ConfirmClear': z.ZodBoolean;
         'Comfy.DevMode': z.ZodBoolean;
+        'Comfy.Appearance.DisableAnimations': z.ZodBoolean;
         'Comfy.UI.TabBarLayout': z.ZodEnum<["Default", "Legacy"]>;
-        'Comfy.Workflow.ShowMissingNodesWarning': z.ZodBoolean;
         'Comfy.Workflow.ShowMissingModelsWarning': z.ZodBoolean;
         'Comfy.Workflow.WarnBlueprintOverwrite': z.ZodBoolean;
+        'Comfy.Desktop.CloudNotificationShown': z.ZodBoolean;
         'Comfy.DisableFloatRounding': z.ZodBoolean;
         'Comfy.DisableSliders': z.ZodBoolean;
         'Comfy.DOMClippingEnabled': z.ZodBoolean;
@@ -16605,6 +16701,7 @@ export declare class ComfyApp {
         'Comfy.EnableTooltips': z.ZodBoolean;
         'Comfy.EnableWorkflowViewRestore': z.ZodBoolean;
         'Comfy.FloatRoundingPrecision': z.ZodNumber;
+        'Comfy.Graph.AutoPanSpeed': z.ZodNumber;
         'Comfy.Graph.CanvasInfo': z.ZodBoolean;
         'Comfy.Graph.CanvasMenu': z.ZodBoolean;
         'Comfy.Graph.CtrlShiftZoom': z.ZodBoolean;
@@ -16760,6 +16857,7 @@ export declare class ComfyApp {
             commandId: string;
             targetElementId?: string | undefined;
         }>, "many">;
+        'Comfy.Keybinding.CurrentPreset': z.ZodString;
         'Comfy.Extension.Disabled': z.ZodArray<z.ZodString, "many">;
         'Comfy.LinkRenderMode': z.ZodNumber;
         'Comfy.Node.AutoSnapLinkToSlot': z.ZodBoolean;
@@ -16792,6 +16890,7 @@ export declare class ComfyApp {
         'Comfy.Canvas.LeftMouseClickBehavior': z.ZodString;
         'Comfy.Canvas.MouseWheelScroll': z.ZodString;
         'Comfy.VueNodes.Enabled': z.ZodBoolean;
+        'Comfy.AppBuilder.VueNodeSwitchDismissed': z.ZodBoolean;
         'Comfy.VueNodes.AutoScaleLayout': z.ZodBoolean;
         'Comfy.Assets.UseAssetAPI': z.ZodBoolean;
         'Comfy.Queue.QPOV2': z.ZodBoolean;
@@ -17219,10 +17318,11 @@ export declare class ComfyApp {
         }, z.ZodTypeAny, "passthrough">>;
         'Comfy.ConfirmClear': boolean;
         'Comfy.DevMode': boolean;
+        'Comfy.Appearance.DisableAnimations': boolean;
         'Comfy.UI.TabBarLayout': "Default" | "Legacy";
-        'Comfy.Workflow.ShowMissingNodesWarning': boolean;
         'Comfy.Workflow.ShowMissingModelsWarning': boolean;
         'Comfy.Workflow.WarnBlueprintOverwrite': boolean;
+        'Comfy.Desktop.CloudNotificationShown': boolean;
         'Comfy.DisableFloatRounding': boolean;
         'Comfy.DisableSliders': boolean;
         'Comfy.DOMClippingEnabled': boolean;
@@ -17230,6 +17330,7 @@ export declare class ComfyApp {
         'Comfy.EnableTooltips': boolean;
         'Comfy.EnableWorkflowViewRestore': boolean;
         'Comfy.FloatRoundingPrecision': number;
+        'Comfy.Graph.AutoPanSpeed': number;
         'Comfy.Graph.CanvasInfo': boolean;
         'Comfy.Graph.CanvasMenu': boolean;
         'Comfy.Graph.CtrlShiftZoom': boolean;
@@ -17315,6 +17416,7 @@ export declare class ComfyApp {
             commandId: string;
             targetElementId?: string | undefined;
         }[];
+        'Comfy.Keybinding.CurrentPreset': string;
         'Comfy.Extension.Disabled': string[];
         'Comfy.LinkRenderMode': number;
         'Comfy.Node.AutoSnapLinkToSlot': boolean;
@@ -17347,6 +17449,7 @@ export declare class ComfyApp {
         'Comfy.Canvas.LeftMouseClickBehavior': string;
         'Comfy.Canvas.MouseWheelScroll': string;
         'Comfy.VueNodes.Enabled': boolean;
+        'Comfy.AppBuilder.VueNodeSwitchDismissed': boolean;
         'Comfy.VueNodes.AutoScaleLayout': boolean;
         'Comfy.Assets.UseAssetAPI': boolean;
         'Comfy.Queue.QPOV2': boolean;
@@ -17771,10 +17874,11 @@ export declare class ComfyApp {
         }, z.ZodTypeAny, "passthrough">>;
         'Comfy.ConfirmClear': boolean;
         'Comfy.DevMode': boolean;
+        'Comfy.Appearance.DisableAnimations': boolean;
         'Comfy.UI.TabBarLayout': "Default" | "Legacy";
-        'Comfy.Workflow.ShowMissingNodesWarning': boolean;
         'Comfy.Workflow.ShowMissingModelsWarning': boolean;
         'Comfy.Workflow.WarnBlueprintOverwrite': boolean;
+        'Comfy.Desktop.CloudNotificationShown': boolean;
         'Comfy.DisableFloatRounding': boolean;
         'Comfy.DisableSliders': boolean;
         'Comfy.DOMClippingEnabled': boolean;
@@ -17782,6 +17886,7 @@ export declare class ComfyApp {
         'Comfy.EnableTooltips': boolean;
         'Comfy.EnableWorkflowViewRestore': boolean;
         'Comfy.FloatRoundingPrecision': number;
+        'Comfy.Graph.AutoPanSpeed': number;
         'Comfy.Graph.CanvasInfo': boolean;
         'Comfy.Graph.CanvasMenu': boolean;
         'Comfy.Graph.CtrlShiftZoom': boolean;
@@ -17867,6 +17972,7 @@ export declare class ComfyApp {
             commandId: string;
             targetElementId?: string | undefined;
         }[];
+        'Comfy.Keybinding.CurrentPreset': string;
         'Comfy.Extension.Disabled': string[];
         'Comfy.LinkRenderMode': number;
         'Comfy.Node.AutoSnapLinkToSlot': boolean;
@@ -17899,6 +18005,7 @@ export declare class ComfyApp {
         'Comfy.Canvas.LeftMouseClickBehavior': string;
         'Comfy.Canvas.MouseWheelScroll': string;
         'Comfy.VueNodes.Enabled': boolean;
+        'Comfy.AppBuilder.VueNodeSwitchDismissed': boolean;
         'Comfy.VueNodes.AutoScaleLayout': boolean;
         'Comfy.Assets.UseAssetAPI': boolean;
         'Comfy.Queue.QPOV2': boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfyorg/comfyui-frontend-types",
-  "version": "1.43.1",
+  "version": "1.43.3",
   "types": "./index.d.ts",
   "files": [
     "index.d.ts"