@comfyorg/comfyui-frontend-types 1.42.7 → 1.42.8

package/index.d.ts

@@ -3,8 +3,6 @@ import { ComfyWorkflowJSON } from '../platform/workflow/validation/schemas/workf
 import { ComfyWorkflowJSON as ComfyWorkflowJSON_2 } from '../../validation/schemas/workflowSchema';
 import { Component } from 'vue';
 import { CurveData } from '../../../../components/curve/types';
-import { DOMWidget } from '../scripts/domWidget';
-import { DOMWidgetOptions } from '../scripts/domWidget';
 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';
@@ -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;
@@ -2667,9 +2680,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 {
         /**
@@ -5957,6 +6004,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
@@ -6100,7 +6155,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;
@@ -8629,6 +8683,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;
@@ -8929,6 +8993,7 @@ export declare class ComfyApp {
         private _buildDisplayNameByViewKey;
         private _makePromotionEntryKey;
         private _makePromotionViewKey;
+        private _serializeEntries;
         private _resolveLegacyEntry;
         /** Manages lifecycle of all subgraph event listeners */
         private _eventAbortController;
@@ -8976,7 +9041,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;

package/package.json

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