@comfyorg/comfyui-frontend-types 1.31.1 → 1.32.1

package/index.d.ts

@@ -1139,10 +1139,11 @@ export declare class ComfyApp {
      loadTemplateData(templateData: any): void;
      private showMissingNodesError;
      private showMissingModelsError;
-     loadGraphData(graphData?: ComfyWorkflowJSON, clean?: boolean, restore_view?: boolean, workflow?: string | null | ComfyWorkflow, { showMissingNodesDialog, showMissingModelsDialog, checkForRerouteMigration }?: {
-         showMissingNodesDialog?: boolean | undefined;
-         showMissingModelsDialog?: boolean | undefined;
-         checkForRerouteMigration?: boolean | undefined;
+     loadGraphData(graphData?: ComfyWorkflowJSON, clean?: boolean, restore_view?: boolean, workflow?: string | null | ComfyWorkflow, options?: {
+         showMissingNodesDialog?: boolean;
+         showMissingModelsDialog?: boolean;
+         checkForRerouteMigration?: boolean;
+         openSource?: WorkflowOpenSource;
      }): Promise<void>;
      graphToPrompt(graph?: LGraph): Promise<{
          workflow: ComfyWorkflowJSON;
@@ -1154,7 +1155,7 @@ export declare class ComfyApp {
       * Loads workflow data from the specified file
       * @param {File} file
       */
-     handleFile(file: File): Promise<void>;
+     handleFile(file: File, openSource?: WorkflowOpenSource): Promise<void>;
      isApiJson(data: unknown): boolean;
      loadApiJson(apiData: ComfyApiWorkflow, fileName: string): void;
      /**
@@ -1335,15 +1336,15 @@ export declare class ComfyApp {
         /**
          * Allows the extension to add context menu items to canvas right-click menus
          * @param canvas The canvas instance
-         * @returns An array of context menu items to add
+         * @returns An array of context menu items to add (null values represent separators)
          */
-        getCanvasMenuItems?(canvas: LGraphCanvas): IContextMenuValue[];
+        getCanvasMenuItems?(canvas: LGraphCanvas): (IContextMenuValue | null)[];
         /**
          * Allows the extension to add context menu items to node right-click menus
          * @param node The node being right-clicked
-         * @returns An array of context menu items to add
+         * @returns An array of context menu items to add (null values represent separators)
          */
-        getNodeMenuItems?(node: LGraphNode): IContextMenuValue[];
+        getNodeMenuItems?(node: LGraphNode): (IContextMenuValue | null)[];
         /**
          * Allows the extension to add additional handling to the node before it is registered with **LGraph**
          * @param nodeType The node class (not an instance)
@@ -4200,6 +4201,10 @@ export declare class ComfyApp {
             closingGraph: LGraph;
             fromNode: SubgraphNode;
         };
+        /** Dispatched after a group of items has been converted to a subgraph*/
+        'subgraph-converted': {
+            subgraphNode: SubgraphNode;
+        };
         'litegraph:canvas': {
             subType: 'before-change' | 'after-change';
         } | {
@@ -7432,6 +7437,7 @@ export declare class ComfyApp {
          * This ensures nested subgraph widget values are preserved when saving.
          */
         serialize(): ISerialisedNode;
+        clone(): LGraphNode | null;
     }
 
     /**
@@ -7908,6 +7914,26 @@ export declare class ComfyApp {
         [key: string]: BaseWidget;
     };
 
+    /**
+     * Workflow import metadata
+     */
+    declare interface WorkflowImportMetadata {
+        missing_node_count: number;
+        missing_node_types: string[];
+        /**
+         * The source of the workflow open/import action
+         */
+        open_source?: 'file_button' | 'file_drop' | 'template' | 'unknown';
+    }
+
+    /**
+     * Workflow open metadata
+     */
+    /**
+     * Enumerated sources for workflow open/import actions.
+     */
+    declare type WorkflowOpenSource = NonNullable<WorkflowImportMetadata['open_source']>;
+
     declare interface WorkflowTemplates {
         moduleName: string;
         templates: TemplateInfo[];

package/package.json

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