@comfyorg/comfyui-frontend-types 1.44.12 → 1.44.14

package/index.d.ts

@@ -101,7 +101,7 @@ declare class AssetWidget extends BaseWidget<IAssetWidget> implements IAssetWidg
 }
 
 declare interface AuthUserInfo {
-    id: string;
+    id: UserId;
 }
 
 /** Dictionary of calls originating from ComfyUI core */
@@ -756,7 +756,7 @@ declare interface ClipboardPasteResult {
     /** Map: original reroute IDs to newly created reroutes */
     reroutes: Map<RerouteId, Reroute>;
     /** Map: original subgraph IDs to newly created subgraphs */
-    subgraphs: Map<UUID, Subgraph>;
+    subgraphs: Map<SubgraphId, Subgraph>;
 }
 
 declare type Clipspace = {
@@ -1161,7 +1161,7 @@ export declare class ComfyApp {
      /** Whether the root graph has been initialized. Safe to check without triggering error logs. */
      get isGraphReady(): boolean;
      canvas: LGraphCanvas;
-     dragOverNode: LGraphNode | null;
+     dragOverNode: Pick<LGraphNode, 'onDragDrop' | 'id'> | null;
      readonly canvasElRef: ShallowRef<HTMLCanvasElement | undefined, HTMLCanvasElement | undefined>;
      get canvasEl(): HTMLCanvasElement;
      private configuringGraphLevel;
@@ -2143,6 +2143,7 @@ export declare class ComfyApp {
             'Comfy.ModelLibrary.AutoLoadAll'?: boolean | undefined;
             'Comfy.ModelLibrary.NameFormat'?: "title" | "filename" | undefined;
             'Comfy.NodeSearchBoxImpl.NodePreview'?: boolean | undefined;
+            'Comfy.NodeSearchBoxImpl.FollowCursor'?: boolean | undefined;
             'Comfy.NodeSearchBoxImpl'?: "default" | "v1 (legacy)" | "litegraph (legacy)" | undefined;
             'Comfy.NodeSearchBoxImpl.ShowCategory'?: boolean | undefined;
             'Comfy.NodeSearchBoxImpl.ShowIdName'?: boolean | undefined;
@@ -2448,7 +2449,7 @@ export declare class ComfyApp {
     /** Links */
     declare interface ConnectingLink extends IInputOrOutput {
         node: LGraphNode;
-        slot: number;
+        slot: SlotIndex;
         pos: Point;
         direction?: LinkDirection;
         afterRerouteId?: RerouteId;
@@ -2893,7 +2894,7 @@ export declare class ComfyApp {
         /** The graph that this node is a part of. */
         readonly graph: LGraph | Subgraph;
         inputs: {
-            linkId: number | null;
+            linkId: LinkId | null;
             name: string;
             type: ISlotType;
         }[];
@@ -3004,7 +3005,7 @@ export declare class ComfyApp {
          * The ID of the actual subgraph definition.
          * @see {@link ExportedSubgraph.subgraphs}
          */
-        type: UUID;
+        type: SubgraphId;
         /** Custom properties for this subgraph instance */
         properties?: Dictionary<NodeProperty | undefined>;
     }
@@ -3087,7 +3088,7 @@ export declare class ComfyApp {
         readonly fromSlot: INodeOutputSlot | INodeInputSlot;
         readonly fromPos: Point;
         readonly fromDirection: LinkDirection;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         readonly outputNodeId: NodeId;
         readonly outputNode?: LGraphNode;
         readonly outputSlot?: INodeOutputSlot;
@@ -3192,6 +3193,8 @@ export declare class ComfyApp {
     /** Internal; simplifies type definitions. */
     declare type GraphOrSubgraph = LGraph | Subgraph;
 
+    declare type GroupId = number;
+
     declare interface GroupNodeConfigEntry {
         input?: Record<string, {
             name?: string;
@@ -3577,7 +3580,7 @@ export declare class ComfyApp {
     }
 
     declare interface IFoundSlot extends IInputOrOutput {
-        slot: number;
+        slot: SlotIndex;
         link_pos: Point;
     }
 
@@ -3687,7 +3690,7 @@ export declare class ComfyApp {
     declare interface INodeOutputSlot extends INodeSlot {
         links: LinkId[] | null;
         _data?: unknown;
-        slot_index?: number;
+        slot_index?: SlotIndex;
     }
 
     declare interface INodePropertyInfo {
@@ -3876,7 +3879,7 @@ export declare class ComfyApp {
      */
     declare interface ISerialisedGraph extends BaseExportedGraph {
         last_node_id: NodeId;
-        last_link_id: number;
+        last_link_id: LinkId;
         nodes: ISerialisedNode[];
         links: SerialisedLLinkArray[];
         floatingLinks?: SerialisableLLink[];
@@ -3887,7 +3890,7 @@ export declare class ComfyApp {
 
     /** Serialised LGraphGroup */
     declare interface ISerialisedGroup {
-        id: number;
+        id: GroupId;
         title: string;
         bounding: number[];
         color?: string;
@@ -4213,7 +4216,7 @@ export declare class ComfyApp {
         get state(): LGraphState;
         set state(value: LGraphState);
         readonly events: CustomEventTarget<LGraphEventMap, "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph">;
-        readonly _subgraphs: Map<UUID, Subgraph>;
+        readonly _subgraphs: Map<SubgraphId, Subgraph>;
         _nodes: (LGraphNode | SubgraphNode)[];
         _nodes_by_id: Record<NodeId, LGraphNode>;
         _nodes_in_order: LGraphNode[];
@@ -4289,7 +4292,7 @@ export declare class ComfyApp {
          * Removes all nodes from this graph
          */
         clear(): void;
-        get subgraphs(): Map<UUID, Subgraph>;
+        get subgraphs(): Map<SubgraphId, Subgraph>;
         get nodes(): (LGraphNode | SubgraphNode)[];
         get groups(): LGraphGroup[];
         /**
@@ -5615,8 +5618,8 @@ export declare class ComfyApp {
     declare interface LGraphExtra extends Dictionary<unknown> {
         reroutes?: SerialisableReroute[];
         linkExtensions?: {
-            id: number;
-            parentId: number | undefined;
+            id: LinkId;
+            parentId: RerouteId | undefined;
         }[];
         ds?: DragAndScaleState;
         workflowRendererVersion?: RendererType;
@@ -5629,7 +5632,7 @@ export declare class ComfyApp {
         static resizeLength: number;
         static padding: number;
         static defaultColour: string;
-        id: number;
+        id: GroupId;
         color?: string;
         title: string;
         font?: string;
@@ -5643,7 +5646,7 @@ export declare class ComfyApp {
         graph?: LGraph;
         flags: IGraphGroupFlags;
         selected?: boolean;
-        constructor(title?: string, id?: number);
+        constructor(title?: string, id?: GroupId);
         /** @inheritdoc {@link IColorable.setColorOption} */
         setColorOption(colorOption: ColorOption | null): void;
         /** @inheritdoc {@link IColorable.getColorOption} */
@@ -5684,7 +5687,7 @@ export declare class ComfyApp {
          * @param maxDepth Maximum recursion depth for nested groups. Use 1 to skip nested group computation.
          * @param visited Set of already visited group IDs to prevent redundant computation.
          */
-        recomputeInsideNodes(maxDepth?: number, visited?: Set<number>): void;
+        recomputeInsideNodes(maxDepth?: number, visited?: Set<GroupId>): void;
         /**
          * Resizes and moves the group to neatly fit all given {@link objects}.
          * @param objects All objects that should be inside the group
@@ -6036,7 +6039,7 @@ export declare class ComfyApp {
         /**
          * sets the output data type, useful when you want to be able to overwrite the data type
          */
-        setOutputDataType(slot: number, type: ISlotType): void;
+        setOutputDataType(slot: SlotIndex, type: ISlotType): void;
         /**
          * Retrieves the input data (data traveling through the connection) from one slot
          * @param slot
@@ -6049,7 +6052,7 @@ export declare class ComfyApp {
          * @param slot
          * @returns datatype in string format
          */
-        getInputDataType(slot: number): ISlotType | null;
+        getInputDataType(slot: SlotIndex): ISlotType | null;
         /**
          * Retrieves the input data from one slot using its name instead of slot number
          * @param slot_name
@@ -6489,7 +6492,7 @@ export declare class ComfyApp {
          * @param outputSlotIndex Output slot index
          * @returns Position of the output slot
          */
-        getOutputPos(outputSlotIndex: number): Point;
+        getOutputPos(outputSlotIndex: SlotIndex): Point;
         /**
          * Get slot position using layout tree if available, fallback to node's position * Unified implementation used by both LitegraphLinkAdapter and useLinkLayoutSync
          * @param slotIndex The slot index
@@ -6698,10 +6701,10 @@ export declare class ComfyApp {
     }
 
     declare interface LGraphState {
-        lastGroupId: number;
+        lastGroupId: GroupId;
         lastNodeId: number;
-        lastLinkId: number;
-        lastRerouteId: number;
+        lastLinkId: LinkId;
+        lastRerouteId: RerouteId;
     }
 
     declare type LGraphTriggerAction = LGraphTriggerEvent['type'];
@@ -6929,7 +6932,7 @@ export declare class ComfyApp {
         readonly links: Map<LinkId, LLink>;
         readonly reroutes: Map<RerouteId, Reroute>;
         addFloatingLink(link: LLink): LLink;
-        removeReroute(id: number): unknown;
+        removeReroute(id: RerouteId): unknown;
         removeFloatingLink(link: LLink): void;
     }
 
@@ -6979,7 +6982,7 @@ export declare class ComfyApp {
         /** Output node ID */
         readonly origin_id: NodeId | undefined;
         /** Output slot index */
-        readonly origin_slot: number | undefined;
+        readonly origin_slot: SlotIndex | undefined;
     }
 
     declare const LiteGraph_2: LiteGraphGlobal;
@@ -7671,7 +7674,7 @@ export declare class ComfyApp {
         readonly fromSlot: INodeOutputSlot;
         readonly fromPos: Point;
         readonly fromDirection: LinkDirection;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         disconnectOnDrop: boolean;
         readonly disconnectOrigin: Point;
         constructor(network: LinkNetwork, link: LLink, fromReroute?: Reroute, dragDirection?: LinkDirection, startPoint?: Point);
@@ -7713,7 +7716,7 @@ export declare class ComfyApp {
         abstract readonly fromSlot: INodeOutputSlot | INodeInputSlot;
         abstract readonly fromPos: Point;
         abstract readonly fromDirection: LinkDirection;
-        abstract readonly fromSlotIndex: number;
+        abstract readonly fromSlotIndex: SlotIndex;
         readonly outputNodeId: NodeId;
         readonly outputNode: LGraphNode;
         readonly outputSlot: INodeOutputSlot;
@@ -7746,7 +7749,7 @@ export declare class ComfyApp {
         readonly fromSlot: INodeInputSlot;
         readonly fromPos: Point;
         readonly fromDirection: LinkDirection;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         constructor(network: LinkNetwork, link: LLink, fromReroute?: Reroute, dragDirection?: LinkDirection);
         canConnectToInput(): false;
         canConnectToOutput(outputNode: NodeLike, output: INodeOutputSlot | SubgraphIO): boolean;
@@ -8315,7 +8318,7 @@ export declare class ComfyApp {
         /** The slot that the link is being connected from. */
         readonly fromSlot: INodeOutputSlot | INodeInputSlot | SubgraphInput | SubgraphOutput;
         /** The index of the slot that the link is being connected from. */
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         /** The reroute that the link is being connected from. */
         readonly fromReroute?: Reroute;
         /**
@@ -8757,6 +8760,9 @@ export declare class ComfyApp {
     declare enum SlotDirection {
     }
 
+    /** Index of an input or output slot on a node. */
+    declare type SlotIndex = number;
+
     /** @see RenderShape */
     declare enum SlotShape {
         Box = 1,
@@ -8889,6 +8895,12 @@ export declare class ComfyApp {
         };
     }
 
+    /**
+     * Unique identifier for a subgraph definition. Structurally a {@link UUID};
+     * provided as a domain-specific alias for clarity at adoption sites.
+     */
+    declare type SubgraphId = UUID;
+
     /**
      * An input "slot" from a parent graph into a subgraph.
      *
@@ -9073,7 +9085,7 @@ export declare class ComfyApp {
         /** The definition of this subgraph; how its nodes are configured, etc. */
         readonly subgraph: Subgraph;
         inputs: (INodeInputSlot & Partial<ISubgraphInput>)[];
-        readonly type: UUID;
+        readonly type: SubgraphId;
         readonly isVirtualNode: true;
         graph: GraphOrSubgraph | null;
         get rootGraph(): LGraph;
@@ -9431,7 +9443,7 @@ export declare class ComfyApp {
         readonly fromReroute?: Reroute | undefined;
         dragDirection: LinkDirection;
         readonly toType = "input";
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         readonly fromPos: Point;
         fromDirection: LinkDirection;
         readonly existingLink?: LLink;
@@ -9460,7 +9472,7 @@ export declare class ComfyApp {
         dragDirection: LinkDirection;
         readonly toType = "input";
         readonly fromPos: Point;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         fromDirection: LinkDirection;
         constructor(network: LinkNetwork, node: LGraphNode, fromSlot: INodeOutputSlot, fromReroute?: Reroute | undefined, dragDirection?: LinkDirection);
         canConnectToInput(inputNode: NodeLike, input: INodeInputSlot): boolean;
@@ -9486,7 +9498,7 @@ export declare class ComfyApp {
         dragDirection: LinkDirection;
         readonly toType = "output";
         readonly fromPos: Point;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         fromDirection: LinkDirection;
         constructor(network: LinkNetwork, node: SubgraphOutputNode, fromSlot: SubgraphOutput, fromReroute?: Reroute | undefined, dragDirection?: LinkDirection);
         canConnectToInput(): false;
@@ -9509,7 +9521,7 @@ export declare class ComfyApp {
         dragDirection: LinkDirection;
         readonly toType = "output";
         readonly fromPos: Point;
-        readonly fromSlotIndex: number;
+        readonly fromSlotIndex: SlotIndex;
         fromDirection: LinkDirection;
         constructor(network: LinkNetwork, node: LGraphNode, fromSlot: INodeInputSlot, fromReroute?: Reroute | undefined, dragDirection?: LinkDirection);
         canConnectToInput(): false;
@@ -9647,6 +9659,15 @@ export declare class ComfyApp {
         rename(newPath: string): Promise<UserFile>;
     }
 
+    /**
+     * Identifier for an authenticated user.
+     *
+     * Backed by the `id` claim returned from the auth provider, which is always
+     * a string. This alias names that primitive at use sites (auth store,
+     * workspace member APIs) without changing structural typing.
+     */
+    declare type UserId = string;
+
     declare const useWorkflowStore: StoreDefinition<"workflow", Pick<{
     activeWorkflow: Ref<    {
     isLoaded: true;
@@ -53547,6 +53568,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': z.ZodBoolean;
         'Comfy.ModelLibrary.NameFormat': z.ZodEnum<["filename", "title"]>;
         'Comfy.NodeSearchBoxImpl.NodePreview': z.ZodBoolean;
+        'Comfy.NodeSearchBoxImpl.FollowCursor': z.ZodBoolean;
         'Comfy.NodeSearchBoxImpl': z.ZodEnum<["default", "v1 (legacy)", "litegraph (legacy)"]>;
         'Comfy.NodeSearchBoxImpl.ShowCategory': z.ZodBoolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': z.ZodBoolean;
@@ -54155,6 +54177,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': boolean;
         'Comfy.ModelLibrary.NameFormat': "title" | "filename";
         'Comfy.NodeSearchBoxImpl.NodePreview': boolean;
+        'Comfy.NodeSearchBoxImpl.FollowCursor': boolean;
         'Comfy.NodeSearchBoxImpl': "default" | "v1 (legacy)" | "litegraph (legacy)";
         'Comfy.NodeSearchBoxImpl.ShowCategory': boolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': boolean;
@@ -54696,6 +54719,7 @@ export declare class ComfyApp {
         'Comfy.ModelLibrary.AutoLoadAll': boolean;
         'Comfy.ModelLibrary.NameFormat': "title" | "filename";
         'Comfy.NodeSearchBoxImpl.NodePreview': boolean;
+        'Comfy.NodeSearchBoxImpl.FollowCursor': boolean;
         'Comfy.NodeSearchBoxImpl': "default" | "v1 (legacy)" | "litegraph (legacy)";
         'Comfy.NodeSearchBoxImpl.ShowCategory': boolean;
         'Comfy.NodeSearchBoxImpl.ShowIdName': boolean;

package/package.json

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