@comfyorg/comfyui-frontend-types 1.31.0 → 1.31.2

package/index.d.ts

@@ -1335,15 +1335,15 @@ export declare class ComfyApp {
         /**
          * Allows the extension to add context menu items to canvas right-click menus
          * @param canvas The canvas instance
-         * @returns An array of context menu items to add
+         * @returns An array of context menu items to add (null values represent separators)
          */
-        getCanvasMenuItems?(canvas: LGraphCanvas): IContextMenuValue[];
+        getCanvasMenuItems?(canvas: LGraphCanvas): (IContextMenuValue | null)[];
         /**
          * Allows the extension to add context menu items to node right-click menus
          * @param node The node being right-clicked
-         * @returns An array of context menu items to add
+         * @returns An array of context menu items to add (null values represent separators)
          */
-        getNodeMenuItems?(node: LGraphNode): IContextMenuValue[];
+        getNodeMenuItems?(node: LGraphNode): (IContextMenuValue | null)[];
         /**
          * Allows the extension to add additional handling to the node before it is registered with **LGraph**
          * @param nodeType The node class (not an instance)
@@ -2466,7 +2466,7 @@ export declare class ComfyApp {
         scale?: number;
         node?: LGraphNode;
         autoopen?: boolean;
-        callback?(value?: string | IContextMenuValue<TValue>, options?: unknown, event?: MouseEvent, previous_menu?: ContextMenu<TValue>, extra?: unknown): void | boolean;
+        callback?(value?: string | IContextMenuValue<TValue>, options?: unknown, event?: MouseEvent, previous_menu?: ContextMenu<TValue>, extra?: unknown): void | boolean | Promise<void | boolean>;
     }
 
     declare interface IContextMenuSubmenu<TValue = unknown> extends IContextMenuOptions<TValue> {
@@ -2482,7 +2482,7 @@ export declare class ComfyApp {
         property?: string;
         type?: string;
         slot?: IFoundSlot;
-        callback?(this: ContextMenuDivElement<TValue>, value?: TCallbackValue, options?: unknown, event?: MouseEvent, previous_menu?: ContextMenu<TValue>, extra?: TExtra): void | boolean;
+        callback?(this: ContextMenuDivElement<TValue>, value?: TCallbackValue, options?: unknown, event?: MouseEvent, previous_menu?: ContextMenu<TValue>, extra?: TExtra): void | boolean | Promise<void | boolean>;
     }
 
     declare interface ICreateDefaultNodeOptions extends ICreateNodeOptions {
@@ -3154,7 +3154,9 @@ export declare class ComfyApp {
         get empty(): boolean;
         /** @returns All items on the canvas that can be selected */
         positionableItems(): Generator<LGraphNode | LGraphGroup | Reroute>;
+        private readonly floatingLinksInternal;
         get floatingLinks(): ReadonlyMap<LinkId, LLink>;
+        private readonly reroutesInternal;
         /** All reroutes in this graph. */
         get reroutes(): Map<RerouteId, Reroute>;
         get rootGraph(): LGraph;
@@ -4147,7 +4149,7 @@ export declare class ComfyApp {
         closePanels(): void;
         showShowNodePanel(node: LGraphNode): void;
         checkPanels(): void;
-        getCanvasMenuOptions(): IContextMenuValue<string>[];
+        getCanvasMenuOptions(): IContextMenuValue[];
         getNodeMenuOptions(node: LGraphNode): (IContextMenuValue<INodeSlotContextItem, unknown, unknown> | IContextMenuValue<string, unknown, unknown> | IContextMenuValue<string | null, unknown, unknown> | IContextMenuValue<"round" | "default" | "box" | "card", unknown, unknown> | IContextMenuValue<unknown, LGraphNode, unknown> | null)[];
         /** @deprecated */
         getGroupMenuOptions(group: LGraphGroup): (IContextMenuValue<string, unknown, unknown> | IContextMenuValue<string | null, unknown, unknown> | null)[];
@@ -4198,6 +4200,10 @@ export declare class ComfyApp {
             closingGraph: LGraph;
             fromNode: SubgraphNode;
         };
+        /** Dispatched after a group of items has been converted to a subgraph*/
+        'subgraph-converted': {
+            subgraphNode: SubgraphNode;
+        };
         'litegraph:canvas': {
             subType: 'before-change' | 'after-change';
         } | {
@@ -6725,7 +6731,6 @@ export declare class ComfyApp {
      * and a `WeakRef` to a {@link LinkNetwork} to resolve them.
      */
     declare class Reroute implements Positionable, LinkSegment, Serialisable<SerialisableReroute> {
-        #private;
         readonly id: RerouteId;
         static radius: number;
         /** Maximum distance from reroutes to their bezier curve control points. */
@@ -6734,17 +6739,26 @@ export declare class ComfyApp {
         static slotRadius: number;
         /** Distance from reroute centre to slot centre. */
         static get slotOffset(): number;
+        /** The network this reroute belongs to.  Contains all valid links and reroutes. */
+        private readonly network;
+        private parentIdInternal?;
         get parentId(): RerouteId | undefined;
         /** Ignores attempts to create an infinite loop. @inheritdoc */
         set parentId(value: RerouteId | undefined);
         get parent(): Reroute | undefined;
         /** This property is only defined on the last reroute of a floating reroute chain (closest to input end). */
         floating?: FloatingRerouteSlot;
+        private readonly posInternal;
         /** @inheritdoc */
         get pos(): Point;
         set pos(value: Point);
         /** @inheritdoc */
         get boundingRect(): ReadOnlyRect;
+        /**
+         * Slightly over-sized rectangle, guaranteed to contain the entire surface area for hover detection.
+         * Eliminates most hover positions using an extremely cheap check.
+         */
+        private get hoverArea();
         /** The total number of links & floating links using this reroute */
         get totalLinks(): number;
         /** @inheritdoc */
@@ -6770,6 +6784,13 @@ export declare class ComfyApp {
         _colour?: CanvasColour;
         /** Colour of the first link that rendered this reroute */
         get colour(): CanvasColour;
+        /**
+         * Used to ensure reroute angles are only executed once per frame.
+         * @todo Calculate on change instead.
+         */
+        private lastRenderTime;
+        private readonly inputSlot;
+        private readonly outputSlot;
         get isSlotHovered(): boolean;
         get isInputHovered(): boolean;
         get isOutputHovered(): boolean;
@@ -6889,6 +6910,7 @@ export declare class ComfyApp {
          * @returns `true` if {@link pos} is within the reroute's radius.
          */
         containsPoint(pos: Point): boolean;
+        private contains;
         /** @inheritdoc */
         asSerialisable(): SerialisableReroute;
     }
@@ -7414,6 +7436,7 @@ export declare class ComfyApp {
          * This ensures nested subgraph widget values are preserved when saving.
          */
         serialize(): ISerialisedNode;
+        clone(): LGraphNode | null;
     }
 
     /**

package/package.json

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