@comfyorg/comfyui-frontend-types 1.47.5 → 1.47.7

package/index.d.ts

@@ -19,9 +19,6 @@ import { IFuseOptions } from 'fuse.js';
 import { InputSpec } from '@comfyorg/object-info-parser';
 import { MethodOptions } from 'vue';
 import { ModelFile as ModelFile_2 } from '../workflow/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 { NodeId as NodeId_4 } from '../../validation/schemas/workflowSchema';
 import { objectOutputType } from 'zod';
 import { Raw } from 'vue';
 import { Ref } from 'vue';
@@ -89,7 +86,7 @@ declare type ApiEventTypes = ApiToEventType<ApiCalls>;
 
 /** Handles differing event and API signatures. */
 declare type ApiToEventType<T = ApiCalls> = {
-    [K in keyof T]: K extends 'status' ? StatusWsMessageStatus : K extends 'executing' ? NodeId_2 : T[K];
+    [K in keyof T]: K extends 'status' ? StatusWsMessageStatus : K extends 'executing' ? SerializedNodeId : T[K];
 };
 
 declare type AppMode = 'graph' | 'app' | 'builder:inputs' | 'builder:outputs' | 'builder:arrange';
@@ -805,7 +802,7 @@ declare interface ClipboardPasteResult {
     /** All successfully created items */
     created: Positionable[];
     /** Map: original node IDs to newly created nodes */
-    nodes: Map<NodeId, LGraphNode>;
+    nodes: Map<SerializedNodeId, LGraphNode>;
     /** Map: original link IDs to new link IDs */
     links: Map<LinkId, LLink>;
     /** Map: original reroute IDs to newly created reroutes */
@@ -1283,7 +1280,7 @@ export declare class ComfyApp {
       * The node errors from the previous execution.
       * @deprecated Use app.extensionManager.lastNodeErrors instead
       */
-     get lastNodeErrors(): Record<NodeId_2, NodeError> | null;
+     get lastNodeErrors(): Record<string, NodeError> | null;
      /**
       * The error from the previous execution.
       * @deprecated Use app.extensionManager.lastExecutionError instead
@@ -1294,7 +1291,7 @@ export declare class ComfyApp {
       * TODO: Update to support multiple executing nodes. This getter returns only the first executing node.
       * Consider updating consumers to handle multiple nodes or use executingNodeIds array.
       */
-     get runningNodeId(): NodeId_2 | null;
+     get runningNodeId(): SerializedNodeId | null;
      /**
       * @deprecated Use useWorkspaceStore().shiftDown instead
       */
@@ -2343,7 +2340,6 @@ export declare class ComfyApp {
             '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;
             'Comfy.Queue.ShowRunProgressBar'?: boolean | undefined;
@@ -2655,9 +2651,11 @@ export declare class ComfyApp {
     /**
      * Create a NodeExecutionId from an array of node IDs
      * @param nodeIds Array of node IDs from root to target
-     * @returns A properly formatted NodeExecutionId
+     * @returns A properly formatted NodeExecutionId, or null when any segment is invalid
      */
-    export declare function createNodeExecutionId<const T extends readonly NodeId_2[]>(nodeIds: T & (T extends readonly [] ? never : unknown)): NodeExecutionId;
+    export declare function createNodeExecutionId<const T extends readonly [SerializedNodeId, ...SerializedNodeId[]]>(nodeIds: T): NodeExecutionId;
+
+    export declare function createNodeExecutionId(nodeIds: readonly SerializedNodeId[]): NodeExecutionId | null;
 
     /**
      * Create a NodeLocatorId from components
@@ -2665,7 +2663,7 @@ export declare class ComfyApp {
      * @param localNodeId The local node ID within that subgraph
      * @returns A properly formatted NodeLocatorId
      */
-    export declare function createNodeLocatorId(subgraphUuid: string | null, localNodeId: NodeId_2): NodeLocatorId;
+    export declare function createNodeLocatorId(subgraphUuid: string | null, localNodeId: NodeId): NodeLocatorId;
 
     /** Options for {@link LiteGraphGlobal.createNode}. Shallow-copied onto the new node. */
     declare interface CreateNodeOptions {
@@ -3067,7 +3065,7 @@ export declare class ComfyApp {
         /** The actual node that this DTO wraps. */
         readonly node: LGraphNode | SubgraphNode;
         /** A list of subgraph instance node IDs from the root graph to the containing instance. @see {@link id} */
-        readonly subgraphNodePath: readonly NodeId[];
+        readonly subgraphNodePath: readonly SerializedNodeId[];
         /** A flattened map of all DTOs in this node network. Subgraph instances have been expanded into their inner nodes. */
         readonly nodesByExecutionId: Map<ExecutionId, ExecutableLGraphNode>;
         /** The actual subgraph instance that contains this node, otherwise undefined. */
@@ -3103,7 +3101,7 @@ export declare class ComfyApp {
         /** The actual node that this DTO wraps. */
         node: LGraphNode | SubgraphNode, 
         /** A list of subgraph instance node IDs from the root graph to the containing instance. @see {@link id} */
-        subgraphNodePath: readonly NodeId[], 
+        subgraphNodePath: readonly SerializedNodeId[], 
         /** A flattened map of all DTOs in this node network. Subgraph instances have been expanded into their inner nodes. */
         nodesByExecutionId: Map<ExecutionId, ExecutableLGraphNode>, 
         /** The actual subgraph instance that contains this node, otherwise undefined. */
@@ -3205,7 +3203,7 @@ export declare class ComfyApp {
     }
 
     declare interface ExportedSubgraphIONode {
-        id: NodeId;
+        id: SerializedNodeId;
         bounding: [number, number, number, number];
         pinned?: boolean;
     }
@@ -3213,7 +3211,7 @@ export declare class ComfyApp {
     /** A reference to a node widget shown in the parent graph */
     declare interface ExposedWidget {
         /** The ID of the node (inside the subgraph) that the widget belongs to. */
-        id: NodeId;
+        id: SerializedNodeId;
         /** The name of the widget to show in the parent graph. */
         name: string;
     }
@@ -3230,7 +3228,7 @@ export declare class ComfyApp {
             set: <T = unknown>(id: string, value: T) => void;
         };
         workflow: ReturnType<typeof useWorkflowStore>;
-        lastNodeErrors: Record<NodeId_2, NodeError> | null;
+        lastNodeErrors: Record<string, NodeError> | null;
         lastExecutionError: ExecutionErrorWsMessage | null;
         /**
          * Renders a markdown string to sanitized HTML.
@@ -4042,13 +4040,15 @@ export declare class ComfyApp {
         value: string;
     }
 
-    declare type ISerialisableNodeInput = Omit<INodeInputSlot, 'boundingRect' | 'widget'> & {
+    declare type ISerialisableNodeInput = Omit<INodeInputSlot, 'boundingRect' | 'widget' | 'link' | '_floatingLinks'> & {
+        link?: number | null;
         widget?: {
             name: string;
         };
     };
 
-    declare type ISerialisableNodeOutput = Omit<INodeOutputSlot, 'boundingRect' | '_data'> & {
+    declare type ISerialisableNodeOutput = Omit<INodeOutputSlot, 'boundingRect' | '_data' | 'links' | '_floatingLinks'> & {
+        links?: number[] | null;
         widget?: {
             name: string;
         };
@@ -4059,8 +4059,8 @@ export declare class ComfyApp {
      * Maintained for backwards compat
      */
     declare interface ISerialisedGraph extends BaseExportedGraph {
-        last_node_id: NodeId;
-        last_link_id: LinkId;
+        last_node_id: SerializedNodeId;
+        last_link_id: number;
         nodes: ISerialisedNode[];
         links: SerialisedLLinkArray[];
         floatingLinks?: SerialisableLLink[];
@@ -4082,7 +4082,7 @@ export declare class ComfyApp {
     /** Serialised LGraphNode */
     declare interface ISerialisedNode {
         title?: string;
-        id: NodeId;
+        id: SerializedNodeId;
         type: string;
         pos: Point;
         size: Size;
@@ -4262,6 +4262,14 @@ export declare class ComfyApp {
         socketless?: boolean;
         /** If `true`, the widget will not be rendered by the Vue renderer. */
         canvasOnly?: boolean;
+        /**
+         * If `true`, the widget still renders on the node but is omitted from the
+         * right side panel. Unlike {@link IWidgetOptions.canvasOnly}, the node body
+         * keeps rendering it via the Vue renderer. Used for widgets that hold
+         * non-syncable state (e.g. a Three.js viewport) where a second instance in
+         * the panel would diverge from the one on the node.
+         */
+        hideInPanel?: boolean;
         /** Used as a temporary override for determining the asset type in vue mode*/
         nodeType?: string;
         /**
@@ -4447,8 +4455,8 @@ export declare class ComfyApp {
         get last_node_id(): number;
         set last_node_id(value: number);
         /** @deprecated See {@link state}.{@link LGraphState.lastLinkId lastLinkId} */
-        get last_link_id(): number;
-        set last_link_id(value: number);
+        get last_link_id(): LinkId;
+        set last_link_id(value: LinkId);
         onNodeAdded?(node: LGraphNode): void;
         onNodeRemoved?(node: LGraphNode): void;
         onTrigger?: LGraphTriggerHandler;
@@ -4688,9 +4696,9 @@ export declare class ComfyApp {
          * @param pos Position in graph space
          * @param before The existing link segment (reroute, link) that will be after this reroute,
          * going from the node output to input.
-         * @returns The newly created reroute - typically ignored.
+         * @returns The newly created reroute, or undefined when the segment cannot be resolved.
          */
-        createReroute(pos: Point, before: LinkSegment): Reroute;
+        createReroute(pos: Point, before: LinkSegment): Reroute | undefined;
         /**
          * Removes a reroute from the graph
          * @param id ID of reroute to remove
@@ -5036,7 +5044,7 @@ export declare class ComfyApp {
         dirty_canvas: boolean;
         dirty_bgcanvas: boolean;
         /** A map of nodes that require selective-redraw */
-        dirty_nodes: Map<NodeId, LGraphNode>;
+        dirty_nodes: Map<SerializedNodeId, LGraphNode>;
         dirty_area?: Rect | null;
         /** @deprecated Unused */
         node_in_panel?: LGraphNode | null;
@@ -5703,7 +5711,7 @@ export declare class ComfyApp {
         /** Ghost placement mode has started or ended. */
         'litegraph:ghost-placement': {
             active: boolean;
-            nodeId: NodeId;
+            nodeId: SerializedNodeId;
         };
     }
 
@@ -5725,7 +5733,7 @@ export declare class ComfyApp {
          */
         selectionChanged: boolean;
         /** ID of node currently in ghost placement mode (semi-transparent, following cursor). */
-        ghostNodeId: NodeId | null;
+        ghostNodeId: SerializedNodeId | null;
     }
 
     /** Configuration used by {@link LGraph} `config`. */
@@ -5779,23 +5787,23 @@ export declare class ComfyApp {
             node: LGraphNode;
         };
         'node:property:changed': {
-            nodeId: NodeId;
+            nodeId: SerializedNodeId;
             property: string;
             oldValue: unknown;
             newValue: unknown;
         };
         'node:slot-errors:changed': {
-            nodeId: NodeId;
+            nodeId: SerializedNodeId;
         };
         'node:slot-links:changed': {
-            nodeId: NodeId;
+            nodeId: SerializedNodeId;
             slotType: NodeSlotType;
             slotIndex: number;
             connected: boolean;
             linkId: number;
         };
         'node:slot-label:changed': {
-            nodeId: NodeId;
+            nodeId: SerializedNodeId;
             slotType?: NodeSlotType;
         };
     }
@@ -7107,7 +7115,9 @@ export declare class ComfyApp {
         CENTER = 5
     }
 
-    declare type LinkId = number;
+    export declare type LinkId = number & {
+        readonly __brand: 'LinkId';
+    };
 
     /** The marker in the middle of a link */
     declare enum LinkMarkerShape {
@@ -7186,7 +7196,7 @@ export declare class ComfyApp {
      */
     declare class LiteGraphGlobal {
         SlotShape: typeof SlotShape;
-        SlotDirection: typeof SlotDirection;
+        SlotDirection: typeof SlotDirection_2;
         SlotType: typeof SlotType;
         LabelPosition: typeof LabelPosition;
         /** Used in serialised graphs at one point. */
@@ -7633,7 +7643,7 @@ export declare class ComfyApp {
         get originIsIoNode(): boolean;
         /** `true` if this link is connected to a subgraph output node (the actual target is in a different graph). */
         get targetIsIoNode(): boolean;
-        constructor(id: LinkId, type: ISlotType, origin_id: NodeId, origin_slot: number, target_id: NodeId, target_slot: number, parentId?: RerouteId);
+        constructor(id: LinkId, type: ISlotType, origin_id: SerializedNodeId, origin_slot: number, target_id: SerializedNodeId, target_slot: number, parentId?: RerouteId);
         /** @deprecated Use {@link LLink.create} */
         static createFromArray(data: SerialisedLLinkArray): LLink;
         /**
@@ -7707,14 +7717,14 @@ export declare class ComfyApp {
          * @param outputIndex The array index of the node output
          * @returns `true` if the origin matches, otherwise `false`.
          */
-        hasOrigin(nodeId: NodeId, outputIndex: number): boolean;
+        hasOrigin(nodeId: SerializedNodeId, outputIndex: number): boolean;
         /**
          * Checks if the specified node id and input index are this link's target (input side).
          * @param nodeId ID of the node to check
          * @param inputIndex The array index of the node input
          * @returns `true` if the target matches, otherwise `false`.
          */
-        hasTarget(nodeId: NodeId, inputIndex: number): boolean;
+        hasTarget(nodeId: SerializedNodeId, inputIndex: number): boolean;
         /**
          * Creates a floating link from this link.
          * @param slotType The side of the link that is still connected
@@ -7803,7 +7813,7 @@ export declare class ComfyApp {
      * The same file name may appear multiple times across different nodes.
      */
     declare interface MissingMediaCandidate {
-        nodeId: NodeId_3;
+        nodeId: SerializedNodeId;
         nodeType: string;
         widgetName: string;
         mediaType: MediaType;
@@ -7825,7 +7835,8 @@ export declare class ComfyApp {
      */
     declare interface MissingModelCandidate {
         /** Undefined for workflow-level models not tied to a specific node. */
-        nodeId?: NodeId_3;
+        nodeId?: SerializedNodeId;
+        sourceExecutionId?: NodeExecutionId;
         nodeType: string;
         widgetName: string;
         isAssetSupported: boolean;
@@ -8019,10 +8030,12 @@ export declare class ComfyApp {
         readonly __brand: 'NodeExecutionId';
     };
 
-    declare type NodeId = number | string;
+    export declare type NodeId = string & {
+        readonly __brand: 'NodeId';
+    };
 
     declare interface NodeLike {
-        id: NodeId;
+        id: SerializedNodeId;
         canConnectTo(node: NodeLike, toSlot: INodeInputSlot | SubgraphIO, fromSlot: INodeOutputSlot | SubgraphIO): boolean;
     }
 
@@ -8049,7 +8062,7 @@ export declare class ComfyApp {
 
     declare interface NodePropertyChangedEvent {
         type: 'node:property:changed';
-        nodeId: NodeId;
+        nodeId: SerializedNodeId;
         property: string;
         oldValue: unknown;
         newValue: unknown;
@@ -8065,18 +8078,18 @@ export declare class ComfyApp {
 
     declare interface NodeSlotErrorsChangedEvent {
         type: 'node:slot-errors:changed';
-        nodeId: NodeId;
+        nodeId: SerializedNodeId;
     }
 
     declare interface NodeSlotLabelChangedEvent {
         type: 'node:slot-label:changed';
-        nodeId: NodeId;
+        nodeId: SerializedNodeId;
         slotType?: NodeSlotType;
     }
 
     declare interface NodeSlotLinksChangedEvent {
         type: 'node:slot-links:changed';
-        nodeId: NodeId;
+        nodeId: SerializedNodeId;
         slotType: NodeSlotType;
         slotIndex: number;
         connected: boolean;
@@ -8211,7 +8224,9 @@ export declare class ComfyApp {
      * @param id The NodeExecutionId to parse
      * @returns Array of node IDs from root to target, or null if not an execution ID
      */
-    export declare function parseNodeExecutionId(id: string): NodeId_2[] | null;
+    export declare function parseNodeExecutionId(id: string): NodeId[] | null;
+
+    export declare function parseNodeId(value: unknown): NodeId | null;
 
     /**
      * Parse a NodeLocatorId into its components
@@ -8220,9 +8235,11 @@ export declare class ComfyApp {
      */
     export declare function parseNodeLocatorId(id: string): {
         subgraphUuid: string | null;
-        localNodeId: NodeId_2;
+        localNodeId: NodeId;
     } | null;
 
+    declare type PaymentIntentSource = 'subscription_required' | 'out_of_credits' | 'top_up_blocked' | 'deep_link' | 'subscribe_to_run' | 'subscribe_now_button' | 'upgrade_to_add_credits' | 'settings_billing_panel' | 'avatar_menu_plans' | 'team_members_panel' | 'invite_member_upsell' | 'upload_model_upgrade' | 'team_upgrade_resume';
+
     declare interface PendingWarnings {
         missingNodeTypes?: MissingNodeType[];
         missingModelCandidates?: MissingModelCandidate[];
@@ -8251,7 +8268,7 @@ export declare class ComfyApp {
      * May contain other {@link Positionable} objects.
      */
     declare interface Positionable extends Parent<Positionable>, HasBoundingRect {
-        readonly id: NodeId | RerouteId | number;
+        readonly id: NodeId | RerouteId | GroupId;
         /**
          * Position in graph coordinates. This may be the top-left corner,
          * the centre, or another point depending on concrete type.
@@ -8596,7 +8613,6 @@ export declare class ComfyApp {
      * and a `WeakRef` to a {@link LinkNetwork} to resolve them.
      */
     declare class Reroute implements Positionable, LinkSegment, Serialisable<SerialisableReroute> {
-        readonly id: RerouteId;
         static radius: number;
         /** Maximum distance from reroutes to their bezier curve control points. */
         static maxSplineOffset: number;
@@ -8604,6 +8620,7 @@ export declare class ComfyApp {
         static slotRadius: number;
         /** Distance from reroute centre to slot centre. */
         static get slotOffset(): number;
+        readonly id: RerouteId;
         /** The network this reroute belongs to.  Contains all valid links and reroutes. */
         private readonly network;
         private parentIdInternal?;
@@ -8780,7 +8797,9 @@ export declare class ComfyApp {
         asSerialisable(): SerialisableReroute;
     }
 
-    declare type RerouteId = number;
+    export declare type RerouteId = number & {
+        readonly __brand: 'RerouteId';
+    };
 
     declare type ResolvedConnection = BaseResolvedConnection & ((ResolvedSubgraphInput & ResolvedNormalOutput) | (ResolvedNormalInput & ResolvedSubgraphOutput) | (ResolvedNormalInput & ResolvedNormalOutput));
 
@@ -8853,7 +8872,7 @@ export declare class ComfyApp {
     declare interface SerialisableGraph extends BaseExportedGraph {
         /** Schema version.  @remarks Version bump should add to const union, which is used to narrow type during deserialise. */
         version: 0 | 1;
-        state: LGraphState;
+        state: SerialisableGraphState;
         groups?: ISerialisedGroup[];
         nodes?: ISerialisedNode[];
         links?: SerialisableLLink[];
@@ -8862,40 +8881,49 @@ export declare class ComfyApp {
         extra?: LGraphExtra;
     }
 
+    declare interface SerialisableGraphState {
+        lastGroupId: GroupId;
+        lastNodeId: number;
+        lastLinkId: number;
+        lastRerouteId: number;
+    }
+
     declare interface SerialisableLLink {
         /** Link ID */
-        id: LinkId;
+        id: number;
         /** Output node ID */
-        origin_id: NodeId;
+        origin_id: SerializedNodeId;
         /** Output slot index */
         origin_slot: number;
         /** Input node ID */
-        target_id: NodeId;
+        target_id: SerializedNodeId;
         /** Input slot index */
         target_slot: number;
         /** Data type of the link */
         type: ISlotType;
         /** ID of the last reroute (from input to output) that this link passes through, otherwise `undefined` */
-        parentId?: RerouteId;
+        parentId?: number;
     }
 
     declare interface SerialisableReroute {
-        id: RerouteId;
-        parentId?: RerouteId;
+        id: number;
+        parentId?: number;
         pos: Point;
-        linkIds: LinkId[];
+        linkIds: number[];
         floating?: FloatingRerouteSlot;
     }
 
     declare type SerialisedLLinkArray = [
-    id: LinkId,
-    origin_id: NodeId,
+    id: number,
+    origin_id: SerializedNodeId,
     origin_slot: number,
-    target_id: NodeId,
+    target_id: SerializedNodeId,
     target_slot: number,
     type: ISlotType
     ];
 
+    export declare type SerializedNodeId = number | string;
+
     declare type SettingCustomRenderer = (name: string, setter: (v: unknown) => void, value: unknown, attrs?: Record<string, unknown>) => HTMLElement;
 
     declare type SettingInputType = 'boolean' | 'number' | 'slider' | 'knob' | 'combo' | 'radio' | 'text' | 'image' | 'color' | 'url' | 'hidden' | 'backgroundImage';
@@ -8910,6 +8938,7 @@ export declare class ComfyApp {
         defaultValue: TValue | (() => TValue);
         defaultsByInstallVersion?: Record<`${number}.${number}.${number}`, TValue>;
         onChange?(newValue: TValue, oldValue?: TValue): void;
+        telemetry?: SettingTelemetryOptions;
         category?: string[];
         experimental?: boolean;
         deprecated?: boolean;
@@ -8922,6 +8951,14 @@ export declare class ComfyApp {
 
     export declare type Settings = z.infer<typeof zSettings>;
 
+    declare type SettingTelemetryOptions = {
+        trackChanges: false;
+        includeValues?: never;
+    } | {
+        trackChanges?: true;
+        includeValues?: boolean;
+    };
+
     declare type ShareableAssetsResponse = z.infer<typeof zShareableAssetsResponse>;
 
     declare interface ShowDialogOptions<H extends Component = Component, B extends Component = Component, F extends Component = Component> {
@@ -8993,12 +9030,19 @@ export declare class ComfyApp {
         renderingColor(colorContext: DefaultConnectionColors): CanvasColour;
     }
 
+    export declare type SlotDirection = 'input' | 'output';
+
     /** @see LinkDirection */
-    declare enum SlotDirection {
+    declare enum SlotDirection_2 {
     }
 
-    /** Index of an input or output slot on a node. */
-    declare type SlotIndex = number;
+    export declare type SlotId = string & {
+        readonly __brand: 'SlotId';
+    };
+
+    export declare function slotId(nodeId: NodeId, direction: SlotDirection, index: SlotIndex): SlotId;
+
+    export declare type SlotIndex = number;
 
     /** @see RenderShape */
     declare enum SlotShape {
@@ -9222,7 +9266,7 @@ export declare class ComfyApp {
         /** The data type this slot uses. Unlike nodes, this does not support legacy numeric types. */
         type: string;
         /** Links connected to this slot, or `undefined` if not connected. An output slot should only ever have one link. */
-        linkIds?: LinkId[];
+        linkIds?: number[];
     }
 
     declare abstract class SubgraphIONodeBase<TSlot extends SubgraphInput | SubgraphOutput> implements Positionable, Hoverable, Serialisable<ExportedSubgraphIONode> {
@@ -9384,7 +9428,7 @@ export declare class ComfyApp {
          * @returns The output node if found, otherwise undefined.
          */
         resolveSubgraphOutputLink(slot: number): ResolvedConnection | undefined;
-        getInnerNodes(executableNodes: Map<ExecutionId, ExecutableLGraphNode>, subgraphNodePath?: readonly NodeId[], nodes?: ExecutableLGraphNode[], visited?: Set<SubgraphNode>): ExecutableLGraphNode[];
+        getInnerNodes(executableNodes: Map<ExecutionId, ExecutableLGraphNode>, subgraphNodePath?: readonly SerializedNodeId[], nodes?: ExecutableLGraphNode[], visited?: Set<SubgraphNode>): ExecutableLGraphNode[];
         removeWidget(widget: IBaseWidget): void;
         ensureWidgetRemoved(widget: IBaseWidget): void;
         onRemoved(): void;
@@ -9487,7 +9531,15 @@ export declare class ComfyApp {
         editorAlpha?: number;
     }
 
-    declare type SubscriptionDialogReason = 'subscription_required' | 'out_of_credits' | 'top_up_blocked' | 'deep_link';
+    declare interface SubscriptionDialogOptions {
+        reason?: PaymentIntentSource;
+        /**
+         * Forces the unified pricing dialog to open on a specific plan tab,
+         * overriding the workspace-derived default (e.g. an "Upgrade to Team" CTA
+         * always lands on the team tab even from a personal workspace).
+         */
+        planMode?: 'personal' | 'team';
+    }
 
     export declare type SystemStats = z.infer<typeof zSystemStats>;
 
@@ -9688,6 +9740,14 @@ export declare class ComfyApp {
         connectToRerouteOutput(): void;
     }
 
+    export declare function toLinkId(value: number): LinkId;
+
+    export declare function toNodeId(value: ToNodeIdInput): NodeId;
+
+    declare type ToNodeIdInput = number | (string & {
+        readonly __brand?: never;
+    });
+
     /** Connecting TO an output slot. */
     declare class ToOutputFromIoNodeLink implements RenderLink {
         readonly network: LinkNetwork;
@@ -9760,6 +9820,8 @@ export declare class ComfyApp {
         tooltip?: string;
     }
 
+    export declare function toRerouteId(value: number): RerouteId;
+
     /**
      * Widget for hierarchical tree selection.
      * This widget only has a Vue implementation.
@@ -9784,9 +9846,7 @@ export declare class ComfyApp {
         showApiNodesSignInDialog: (apiNodeNames: string[]) => Promise<boolean>;
         showSignInDialog: () => Promise<boolean>;
         showPublishDialog: () => Promise<void>;
-        showSubscriptionRequiredDialog: (options?: {
-            reason?: SubscriptionDialogReason;
-        }) => Promise<void>;
+        showSubscriptionRequiredDialog: (options?: SubscriptionDialogOptions) => Promise<void>;
         showTopUpCreditsDialog: (options?: {
             isInsufficientCredits?: boolean;
         }) => Promise<DialogInstance | undefined>;
@@ -12258,7 +12318,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -12270,7 +12331,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -16073,7 +16134,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -16085,7 +16147,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -18395,7 +18457,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -18407,7 +18470,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -22210,7 +22273,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -22222,7 +22286,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -22288,9 +22352,9 @@ export declare class ComfyApp {
     activeSubgraph: ShallowRef<Raw<Subgraph> | undefined, Raw<Subgraph> | undefined>;
     updateActiveGraph: () => void;
     executionIdToCurrentId: (id: string) => string | undefined;
-    nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
+    nodeIdToNodeLocatorId: (nodeId: NodeId, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId;
     nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId, targetSubgraph?: Subgraph) => NodeExecutionId | null;
     }, "activeWorkflow" | "isBusy" | "isSyncLoading" | "isSubgraphActive" | "activeSubgraph">, Pick<{
     activeWorkflow: Ref<    {
@@ -24570,7 +24634,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -24582,7 +24647,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -28385,7 +28450,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -28397,7 +28463,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -30707,7 +30773,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -30719,7 +30786,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -34522,7 +34589,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -34534,7 +34602,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -34600,9 +34668,9 @@ export declare class ComfyApp {
     activeSubgraph: ShallowRef<Raw<Subgraph> | undefined, Raw<Subgraph> | undefined>;
     updateActiveGraph: () => void;
     executionIdToCurrentId: (id: string) => string | undefined;
-    nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
+    nodeIdToNodeLocatorId: (nodeId: NodeId, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId;
     nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId, targetSubgraph?: Subgraph) => NodeExecutionId | null;
     }, "openWorkflows" | "workflows" | "bookmarkedWorkflows" | "persistedWorkflows" | "modifiedWorkflows">, Pick<{
     activeWorkflow: Ref<    {
@@ -36882,7 +36950,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -36894,7 +36963,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -40697,7 +40766,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -40709,7 +40779,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -43019,7 +43089,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -43031,7 +43102,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -46834,7 +46905,8 @@ export declare class ComfyApp {
     } | undefined;
     })[] | undefined;
     missingModelCandidates?: {
-    nodeId?: NodeId_4 | undefined;
+    nodeId?: SerializedNodeId | undefined;
+    sourceExecutionId?: NodeExecutionId | undefined;
     nodeType: string;
     widgetName: string;
     isAssetSupported: boolean;
@@ -46846,7 +46918,7 @@ export declare class ComfyApp {
     isMissing: boolean | undefined;
     }[] | undefined;
     missingMediaCandidates?: {
-    nodeId: NodeId_4;
+    nodeId: SerializedNodeId;
     nodeType: string;
     widgetName: string;
     mediaType: MediaType;
@@ -46912,9 +46984,9 @@ export declare class ComfyApp {
     activeSubgraph: ShallowRef<Raw<Subgraph> | undefined, Raw<Subgraph> | undefined>;
     updateActiveGraph: () => void;
     executionIdToCurrentId: (id: string) => string | undefined;
-    nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
+    nodeIdToNodeLocatorId: (nodeId: NodeId, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId;
     nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId, targetSubgraph?: Subgraph) => NodeExecutionId | null;
     }, "attachWorkflow" | "isActive" | "openedWorkflowIndexShift" | "getMostRecentWorkflow" | "openWorkflow" | "openWorkflowsInBackground" | "isOpen" | "closeWorkflow" | "createTemporary" | "createNewTemporary" | "renameWorkflow" | "deleteWorkflow" | "saveWorkflow" | "getWorkflowByPath" | "syncWorkflows" | "reorderWorkflows" | "updateActiveGraph" | "executionIdToCurrentId" | "nodeIdToNodeLocatorId" | "nodeToNodeLocatorId" | "nodeLocatorIdToNodeId" | "nodeLocatorIdToNodeExecutionId" | "saveAs" | "loadWorkflows">>;
 
@@ -50075,7 +50147,6 @@ export declare class ComfyApp {
         '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;
         'Comfy.Queue.ShowRunProgressBar': z.ZodBoolean;
@@ -50620,7 +50691,6 @@ export declare class ComfyApp {
         'Comfy.Canvas.MouseWheelScroll': string;
         'Comfy.VueNodes.Enabled': boolean;
         'Comfy.AppBuilder.VueNodeSwitchDismissed': boolean;
-        'Comfy.VueNodes.AutoScaleLayout': boolean;
         'Comfy.Assets.UseAssetAPI': boolean;
         'Comfy.Queue.QPOV2': boolean;
         'Comfy.Queue.ShowRunProgressBar': boolean;
@@ -51162,7 +51232,6 @@ export declare class ComfyApp {
         'Comfy.Canvas.MouseWheelScroll': string;
         'Comfy.VueNodes.Enabled': boolean;
         'Comfy.AppBuilder.VueNodeSwitchDismissed': boolean;
-        'Comfy.VueNodes.AutoScaleLayout': boolean;
         'Comfy.Assets.UseAssetAPI': boolean;
         'Comfy.Queue.QPOV2': boolean;
         'Comfy.Queue.ShowRunProgressBar': boolean;

package/package.json

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