@comfyorg/comfyui-frontend-types 1.47.3 → 1.47.4

package/index.d.ts

@@ -394,6 +394,27 @@ declare class BooleanWidget extends BaseWidget<IBooleanWidget> implements IBoole
 
 export declare type BottomPanelExtension = VueBottomPanelExtension | CustomBottomPanelExtension;
 
+declare interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    metadata: BoundingBoxMetadata;
+}
+
+declare class BoundingBoxesWidget extends BaseWidget<IBoundingBoxesWidget> implements IBoundingBoxesWidget {
+    type: "boundingboxes";
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+    onClick(_options: WidgetEventOptions): void;
+}
+
+declare interface BoundingBoxMetadata {
+    type: RegionType;
+    text: string;
+    desc: string;
+    palette: string[];
+}
+
 /**
  * Widget for defining bounding box regions.
  * This widget only has a Vue implementation.
@@ -819,6 +840,12 @@ declare interface ColorStop {
     readonly color: readonly [r: number, g: number, b: number];
 }
 
+declare class ColorsWidget extends BaseWidget<IColorsWidget> implements IColorsWidget {
+    type: "colors";
+    drawWidget(ctx: CanvasRenderingContext2D, options: DrawWidgetOptions): void;
+    onClick(_options: WidgetEventOptions): void;
+}
+
 /**
  * Widget for displaying a color picker using native HTML color input
  */
@@ -2630,7 +2657,7 @@ export declare class ComfyApp {
      * @param nodeIds Array of node IDs from root to target
      * @returns A properly formatted NodeExecutionId
      */
-    export declare function createNodeExecutionId(nodeIds: NodeId_2[]): NodeExecutionId;
+    export declare function createNodeExecutionId<const T extends readonly NodeId_2[]>(nodeIds: T & (T extends readonly [] ? never : unknown)): NodeExecutionId;
 
     /**
      * Create a NodeLocatorId from components
@@ -2638,7 +2665,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, localNodeId: NodeId_2): NodeLocatorId;
+    export declare function createNodeLocatorId(subgraphUuid: string | null, localNodeId: NodeId_2): NodeLocatorId;
 
     /** Options for {@link LiteGraphGlobal.createNode}. Shallow-copied onto the new node. */
     declare interface CreateNodeOptions {
@@ -3529,6 +3556,11 @@ export declare class ComfyApp {
         left: LGraphNode;
     }
 
+    declare interface IBoundingBoxesWidget extends IBaseWidget<BoundingBox[], 'boundingboxes'> {
+        type: 'boundingboxes';
+        value: BoundingBox[];
+    }
+
     /** Bounding box widget for defining regions with numeric inputs */
     declare interface IBoundingBoxWidget extends IBaseWidget<Bounds, 'boundingbox'> {
         type: 'boundingbox';
@@ -3567,6 +3599,11 @@ export declare class ComfyApp {
         getColorOption(): ColorOption | null;
     }
 
+    declare interface IColorsWidget extends IBaseWidget<string[], 'colors'> {
+        type: 'colors';
+        value: string[];
+    }
+
     /** Color picker widget for selecting colors */
     declare interface IColorWidget extends IBaseWidget<string, 'color'> {
         type: 'color';
@@ -4169,7 +4206,7 @@ export declare class ComfyApp {
      * Recommend declaration merging any properties that use IWidget (e.g. {@link LGraphNode.widgets}) with a new type alias.
      * @see ICustomWidget
      */
-    declare type IWidget = IBooleanWidget | INumericWidget | IStringWidget | IComboWidget | IStringComboWidget | ICustomWidget | ISliderWidget | IGradientSliderWidget | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget | IImageCropWidget | IBoundingBoxWidget | ICurveWidget | IPainterWidget | IRangeWidget;
+    declare type IWidget = IBooleanWidget | INumericWidget | IStringWidget | IComboWidget | IStringComboWidget | ICustomWidget | ISliderWidget | IGradientSliderWidget | IButtonWidget | IKnobWidget | IFileUploadWidget | IColorWidget | IMarkdownWidget | IImageWidget | ITreeSelectWidget | IMultiSelectWidget | IChartWidget | IGalleriaWidget | IImageCompareWidget | ISelectButtonWidget | ITextareaWidget | IAssetWidget | IImageCropWidget | IBoundingBoxWidget | ICurveWidget | IPainterWidget | IRangeWidget | IBoundingBoxesWidget | IColorsWidget;
 
     declare interface IWidgetAssetOptions extends IWidgetOptions {
         openModal: (widget: IBaseWidget) => void;
@@ -4361,7 +4398,7 @@ export declare class ComfyApp {
         private _state;
         get state(): LGraphState;
         set state(value: LGraphState);
-        readonly events: CustomEventTarget<LGraphEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph">;
+        readonly events: CustomEventTarget<LGraphEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph" | "node:before-removed">;
         readonly _subgraphs: Map<SubgraphId, Subgraph>;
         _nodes: (LGraphNode | SubgraphNode)[];
         _nodes_by_id: Record<NodeId, LGraphNode>;
@@ -4415,13 +4452,16 @@ export declare class ComfyApp {
         onNodeAdded?(node: LGraphNode): void;
         onNodeRemoved?(node: LGraphNode): void;
         onTrigger?: LGraphTriggerHandler;
+        /**
+         * @deprecated Assign a listener to {@link LGraphCanvas.onBeforeChange} instead.
+         * This graph-level hook will be removed in a future version.
+         */
         onBeforeChange?(graph: LGraph, info?: LGraphNode): void;
         onAfterChange?(graph: LGraph, info?: LGraphNode | null): void;
         onConnectionChange?(node: LGraphNode): void;
         on_change?(graph: LGraph): void;
         onSerialize?(data: ISerialisedGraph | SerialisableGraph): void;
         onConfigure?(data: ISerialisedGraph | SerialisableGraph): void;
-        onGetNodeMenuOptions?(options: (IContextMenuValue<unknown> | null)[], node: LGraphNode): void;
         private _input_nodes?;
         /**
          * See {@link LGraph}
@@ -5732,6 +5772,12 @@ export declare class ComfyApp {
             subgraph: Subgraph;
             closingGraph: LGraph | Subgraph;
         };
+        /**
+         * Fires on the owning graph before per-node teardown begins
+         */
+        'node:before-removed': {
+            node: LGraphNode;
+        };
         'node:property:changed': {
             nodeId: NodeId;
             property: string;
@@ -7969,7 +8015,9 @@ export declare class ComfyApp {
      * Format: Colon-separated path of node IDs
      * Example: "123:456:789" (node 789 in subgraph 456 in subgraph 123)
      */
-    export declare type NodeExecutionId = string;
+    export declare type NodeExecutionId = string & {
+        readonly __brand: 'NodeExecutionId';
+    };
 
     declare type NodeId = number | string;
 
@@ -7993,7 +8041,9 @@ export declare class ComfyApp {
      * Unlike execution IDs which change based on the instance path,
      * NodeLocatorId remains the same for all instances of a particular node.
      */
-    export declare type NodeLocatorId = string;
+    export declare type NodeLocatorId = string & {
+        readonly __brand: 'NodeLocatorId';
+    };
 
     declare type NodeProperty = string | number | boolean | object;
 
@@ -8464,6 +8514,8 @@ export declare class ComfyApp {
         /* Excluded from this release type: _drawDebug */
     }
 
+    declare type RegionType = 'obj' | 'text';
+
     declare type RendererType = 'LG' | 'Vue' | 'Vue-corrected';
 
     declare interface RenderLink {
@@ -8968,7 +9020,7 @@ export declare class ComfyApp {
 
     /** A subgraph definition. */
     declare class Subgraph extends LGraph implements BaseLGraph, Serialisable<ExportedSubgraph> {
-        readonly events: CustomEventTarget<SubgraphEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "adding-input" | "adding-output" | "input-added" | "output-added" | "removing-input" | "removing-output" | "inputs-reordered" | "renaming-input" | "renaming-output" | "widget-promoted" | "widget-demoted" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph">;
+        readonly events: CustomEventTarget<SubgraphEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "adding-input" | "adding-output" | "input-added" | "output-added" | "removing-input" | "removing-output" | "inputs-reordered" | "renaming-input" | "renaming-output" | "widget-promoted" | "widget-demoted" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph" | "node:before-removed">;
         /** Limits the number of levels / depth that subgraphs may be nested.  Prevents uncontrolled programmatic nesting. */
         static MAX_NESTED_SUBGRAPHS: number;
         /** The display name of the subgraph. */
@@ -9104,7 +9156,7 @@ export declare class ComfyApp {
      */
     declare class SubgraphInput extends SubgraphSlot {
         parent: SubgraphInputNode;
-        events: CustomEventTarget<SubgraphInputEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph" | "input-connected" | "input-disconnected">;
+        events: CustomEventTarget<SubgraphInputEventMap, "node:property:changed" | "node:slot-errors:changed" | "node:slot-links:changed" | "node:slot-label:changed" | "configuring" | "configured" | "subgraph-created" | "convert-to-subgraph" | "open-subgraph" | "node:before-removed" | "input-connected" | "input-disconnected">;
         /** The linked widget that this slot is connected to. */
         private _widgetRef?;
         get _widget(): IBaseWidget<string | number | boolean | object | undefined, string, IWidgetOptions<unknown>> | undefined;
@@ -9275,6 +9327,7 @@ export declare class ComfyApp {
         readonly isVirtualNode: true;
         graph: GraphOrSubgraph | null;
         get rootGraph(): LGraph;
+        get isDetached(): boolean;
         get displayType(): string;
         isSubgraphNode(): this is SubgraphNode;
         widgets: IBaseWidget[];
@@ -9434,7 +9487,7 @@ export declare class ComfyApp {
         editorAlpha?: number;
     }
 
-    declare type SubscriptionDialogReason = 'subscription_required' | 'out_of_credits' | 'top_up_blocked';
+    declare type SubscriptionDialogReason = 'subscription_required' | 'out_of_credits' | 'top_up_blocked' | 'deep_link';
 
     export declare type SystemStats = z.infer<typeof zSystemStats>;
 
@@ -9822,6 +9875,11 @@ export declare class ComfyApp {
         showLeaveWorkspaceDialog: () => Promise<DialogInstance>;
         showEditWorkspaceDialog: () => Promise<DialogInstance>;
         showRemoveMemberDialog: (memberId: string) => Promise<DialogInstance>;
+        showChangeMemberRoleDialog: (props: {
+            memberId: string;
+            memberName: string;
+            targetRole: WorkspaceRole;
+        }) => Promise<DialogInstance>;
         showRevokeInviteDialog: (inviteId: string) => Promise<DialogInstance>;
         showInviteMemberDialog: () => Promise<DialogInstance>;
         showInviteMemberUpsellDialog: () => Promise<DialogInstance>;
@@ -22232,9 +22290,8 @@ export declare class ComfyApp {
     executionIdToCurrentId: (id: string) => string | undefined;
     nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeExecutionIdToNodeLocatorId: (nodeExecutionId: NodeExecutionId | string) => NodeLocatorId | null;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId | string) => NodeId_4 | null;
-    nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId | string, targetSubgraph?: Subgraph) => NodeExecutionId | null;
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId, targetSubgraph?: Subgraph) => NodeExecutionId | null;
     }, "activeWorkflow" | "isBusy" | "isSyncLoading" | "isSubgraphActive" | "activeSubgraph">, Pick<{
     activeWorkflow: Ref<    {
     isLoaded: true;
@@ -34545,10 +34602,9 @@ export declare class ComfyApp {
     executionIdToCurrentId: (id: string) => string | undefined;
     nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeExecutionIdToNodeLocatorId: (nodeExecutionId: NodeExecutionId | string) => NodeLocatorId | null;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId | string) => NodeId_4 | null;
-    nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId | string, targetSubgraph?: Subgraph) => NodeExecutionId | null;
-    }, "workflows" | "openWorkflows" | "bookmarkedWorkflows" | "persistedWorkflows" | "modifiedWorkflows">, Pick<{
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId, targetSubgraph?: Subgraph) => NodeExecutionId | null;
+    }, "openWorkflows" | "workflows" | "bookmarkedWorkflows" | "persistedWorkflows" | "modifiedWorkflows">, Pick<{
     activeWorkflow: Ref<    {
     isLoaded: true;
     originalContent: string;
@@ -46858,10 +46914,9 @@ export declare class ComfyApp {
     executionIdToCurrentId: (id: string) => string | undefined;
     nodeIdToNodeLocatorId: (nodeId: NodeId_4, subgraph?: Subgraph) => NodeLocatorId;
     nodeToNodeLocatorId: (node: LGraphNode) => NodeLocatorId;
-    nodeExecutionIdToNodeLocatorId: (nodeExecutionId: NodeExecutionId | string) => NodeLocatorId | null;
-    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId | string) => NodeId_4 | null;
-    nodeLocatorIdToNodeExecutionId: (locatorId: NodeLocatorId | string, targetSubgraph?: Subgraph) => NodeExecutionId | null;
-    }, "attachWorkflow" | "isActive" | "openedWorkflowIndexShift" | "getMostRecentWorkflow" | "openWorkflow" | "openWorkflowsInBackground" | "isOpen" | "closeWorkflow" | "createTemporary" | "createNewTemporary" | "renameWorkflow" | "deleteWorkflow" | "saveWorkflow" | "getWorkflowByPath" | "syncWorkflows" | "reorderWorkflows" | "updateActiveGraph" | "executionIdToCurrentId" | "nodeIdToNodeLocatorId" | "nodeToNodeLocatorId" | "nodeExecutionIdToNodeLocatorId" | "nodeLocatorIdToNodeId" | "nodeLocatorIdToNodeExecutionId" | "saveAs" | "loadWorkflows">>;
+    nodeLocatorIdToNodeId: (locatorId: NodeLocatorId) => NodeId_4;
+    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">>;
 
     declare type UUID = string;
 
@@ -46923,6 +46978,8 @@ export declare class ComfyApp {
         curve: CurveWidget;
         painter: PainterWidget;
         range: RangeWidget;
+        boundingboxes: BoundingBoxesWidget;
+        colors: ColorsWidget;
         [key: string]: BaseWidget;
     };
 
@@ -46960,6 +47017,8 @@ export declare class ComfyApp {
         isEssential?: boolean;
     }
 
+    declare type WorkspaceRole = 'owner' | 'member';
+
     declare const zAssetDownloadWsMessage: z.ZodObject<{
         task_id: z.ZodString;
         asset_name: z.ZodString;
@@ -51454,3 +51513,16 @@ export declare class ComfyApp {
     }>;
 
     export { }
+
+
+
+declare module 'axios' {
+  interface AxiosRequestConfig {
+    // Latches a single reactive 401 retry so a replayed request cannot trigger
+    // a second re-mint.
+    __unifiedRetried?: boolean
+    // Exempts a deliberately Firebase-authed request (acceptInvite) from the
+    // unified re-mint.
+    __skipUnifiedRemint?: boolean
+  }
+}

package/package.json

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