@comfyorg/comfyui-frontend-types 1.47.6 → 1.47.8

package/index.d.ts

@@ -1785,6 +1785,7 @@ export declare class ComfyApp {
          * This is an experimental API and may be changed or removed in the future.
          */
         onAuthUserLogout?(): Promise<void> | void;
+        onNodeOutputsUpdated?(nodeOutputs: Record<NodeLocatorId, NodeExecutionOutput>): void;
         [key: string]: unknown;
     }
 
@@ -2340,7 +2341,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;
@@ -2728,6 +2728,14 @@ export declare class ComfyApp {
         pt?: DialogPassThroughOptions;
         closeOnEscape?: boolean;
         dismissableMask?: boolean;
+        /**
+         * When `false`, the Reka dialog does not dismiss when focus leaves its
+         * content. Set on container dialogs (e.g. Settings) that host nested dialogs,
+         * where a nested dialog closing can move focus onto an ordinary app element
+         * — a programmatic shift that must not be read as a dismiss. Escape and
+         * outside-pointer dismissal are unaffected. Defaults to `true`.
+         */
+        dismissOnFocusOutside?: boolean;
         unstyled?: boolean;
         headless?: boolean;
         renderer?: DialogRenderer;
@@ -4041,13 +4049,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,7 +4069,7 @@ export declare class ComfyApp {
      */
     declare interface ISerialisedGraph extends BaseExportedGraph {
         last_node_id: SerializedNodeId;
-        last_link_id: LinkId;
+        last_link_id: number;
         nodes: ISerialisedNode[];
         links: SerialisedLLinkArray[];
         floatingLinks?: SerialisableLLink[];
@@ -4261,6 +4271,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;
         /**
@@ -4446,8 +4464,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;
@@ -4687,9 +4705,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
@@ -7106,7 +7124,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 {
@@ -7185,7 +7205,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. */
@@ -8019,6 +8039,8 @@ export declare class ComfyApp {
         readonly __brand: 'NodeExecutionId';
     };
 
+    declare type NodeExecutionOutput = z.infer<typeof zOutputs>;
+
     export declare type NodeId = string & {
         readonly __brand: 'NodeId';
     };
@@ -8227,6 +8249,8 @@ export declare class ComfyApp {
         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[];
@@ -8255,7 +8279,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.
@@ -8600,7 +8624,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;
@@ -8608,6 +8631,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?;
@@ -8784,7 +8808,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));
 
@@ -8857,7 +8883,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[];
@@ -8866,9 +8892,16 @@ 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: SerializedNodeId;
         /** Output slot index */
@@ -8880,19 +8913,19 @@ export declare class ComfyApp {
         /** 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,
+    id: number,
     origin_id: SerializedNodeId,
     origin_slot: number,
     target_id: SerializedNodeId,
@@ -8916,6 +8949,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;
@@ -8928,6 +8962,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> {
@@ -8999,12 +9041,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 {
@@ -9228,7 +9277,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> {
@@ -9493,7 +9542,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>;
 
@@ -9694,6 +9751,8 @@ 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 & {
@@ -9772,6 +9831,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.
@@ -9796,9 +9857,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>;
@@ -9844,6 +9903,7 @@ export declare class ComfyApp {
                     position?: "left" | "top" | "right" | "bottom" | "center" | "topleft" | "topright" | "bottomleft" | "bottomright";
                     closeOnEscape: boolean;
                     dismissableMask: boolean;
+                    dismissOnFocusOutside?: boolean;
                     unstyled?: boolean;
                     headless?: boolean;
                     renderer: "primevue" | "reka";
@@ -48359,6 +48419,161 @@ export declare class ComfyApp {
         id?: string | undefined;
     }>;
 
+    declare const zOutputs: z.ZodObject<{
+        audio: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        video: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        animated: z.ZodOptional<z.ZodArray<z.ZodBoolean, "many">>;
+        text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        audio: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        video: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        animated: z.ZodOptional<z.ZodArray<z.ZodBoolean, "many">>;
+        text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        audio: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        video: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filename: z.ZodOptional<z.ZodString>;
+            subfolder: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["input", "output", "temp"]>>;
+            display_name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }, {
+            type?: "input" | "output" | "temp" | undefined;
+            filename?: string | undefined;
+            display_name?: string | undefined;
+            subfolder?: string | undefined;
+        }>, "many">>;
+        animated: z.ZodOptional<z.ZodArray<z.ZodBoolean, "many">>;
+        text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, z.ZodTypeAny, "passthrough">>;
+
     declare const zPreviewMethod: z.ZodEnum<["default", "none", "auto", "latent2rgb", "taesd"]>;
 
     declare const zProgressStateWsMessage: z.ZodObject<{
@@ -50099,7 +50314,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;
@@ -50644,7 +50858,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;
@@ -51186,7 +51399,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.6",
+  "version": "1.47.8",
   "types": "./index.d.ts",
   "files": [
     "index.d.ts"