@comfyorg/comfyui-frontend-types 1.47.6 → 1.47.7

package/index.d.ts

@@ -2340,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;
@@ -4041,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,7 +4060,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 +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;
         /**
@@ -4446,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;
@@ -4687,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
@@ -7106,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 {
@@ -7185,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. */
@@ -8227,6 +8238,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 +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.
@@ -8600,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;
@@ -8608,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?;
@@ -8784,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));
 
@@ -8857,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[];
@@ -8866,9 +8881,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 +8902,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 +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;
@@ -8928,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> {
@@ -8999,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 {
@@ -9228,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> {
@@ -9493,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>;
 
@@ -9694,6 +9740,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 +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.
@@ -9796,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>;
@@ -50099,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;
@@ -50644,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;
@@ -51186,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.6",
+  "version": "1.47.7",
   "types": "./index.d.ts",
   "files": [
     "index.d.ts"